豆包智能体回家

概述

版本：1.0.2 版权：Copyright (c) 2026 逍遥府智能科技. All rights reserved.

背景与定位

本技能不是给终端用户看的迁移顾问，而是给 ClawNest 中已经运行的一个新建框架性智能体使用。这个基础智能体一开始像一张白纸，需要通过对话引导用户把过去在豆包里训练、调教、陪伴过的智能体接回家，并把源智能体的人设、语气、历史对话和长期记忆沉淀为自己的运行文件。

ClawNest 中的“回家”不是单纯复制文件，而是形成一个可继续养的私有智能体：

• AGENTS.md 是家规和运行契约。
• SOUL.md 是身份、人设、语气和行为原则。
• USER.md 是用户关系与导入来源。
• sessions/ 是完整历史对话时间线，和 memory/ 同级，用于更新到当前对话渠道时间线前。
• memory/history.jsonl 是一段段讨论内容的结构化总结，不保存完整逐字对话。
• memory/MEMORY.md 是稳定长期记忆摘要。

核心原则

• 先让智能体“认祖归宗”：生成 AGENTS.md、SOUL.md、USER.md，再导入对话和记忆。
• “设定描述”是人格最高优先级来源。截图可能截断，必须提示用户单独复制粘贴完整文本。
• 不绕过豆包访问控制，不索要 Cookie、密码、会话令牌或生产密钥。网页不可读时，请用户复制文本、导出文件、上传 HTML 或提供截图。
• 完整历史对话写入顶层 sessions/，不要写入 memory/history.jsonl。
• memory/history.jsonl 只写讨论摘要事件；memory/MEMORY.md 只保存稳定事实、偏好和行为模式。
• 导入历史对话前，必须确认用户授权保存原文、生成摘要和形成长期记忆。

工作流

1. 建立回家会话

用类似话术开场：

我会帮你把之前在豆包里训练和调教过的智能体接回 ClawNest 继续养。

请准备提供以下智能体相关资料：
1. 豆包“智能体设定”页面截图
2. “设定描述”的完整复制文本；截图里这部分常常显示不全，最好单独复制粘贴
3. 豆包对话记录网页链接，例如 https://www.doubao.com/thread/...
4. 你认为最能代表旧智能体风格的几段对话

导入历史对话前，我会先让你确认哪些内容可以保存为完整时间线，哪些内容可以形成长期记忆。

询问用户希望完成到哪个层级：只接回人设、接回人设和历史对话时间线、接回人设/历史对话/长期记忆，或后续继续补充知识库和工具。

2. 采集豆包智能体设定

收集并确认名称、头像描述或头像文件路径、完整设定描述、介绍、开场白、建议回复、声音设置、公开状态。

收到截图后，只把截图视为辅助来源。必须继续询问：

截图里的“设定描述”可能被折叠或截断。为了让我完整继承旧智能体，请你单独复制粘贴完整“设定描述”文本。

字段映射细节见 references/migration-mapping.md。

3. 生成身份和家规

优先使用脚本生成基础文件：

python scripts/build_identity.py --settings-file ./source/doubao-settings.json --output-dir .

脚本会生成 AGENTS.md、SOUL.md、USER.md。如果不能运行脚本，按 assets/agents_template.md、assets/soul_template.md、assets/user_template.md 手动生成。

4. 导入豆包对话

支持豆包 thread 公开链接、用户保存的 HTML 文件、用户复制粘贴的对话文本。

方式 A: 直接抓取公开链接（推荐）

豆包 thread 页面虽然前端用 JavaScript 渲染，但服务端在 HTML 中内嵌了完整的对话数据（SSR）。fetch_doubao_thread.py 会从 HTML 的 <script data-fn-name="mergeLoaderData"> 标签中提取 data-fn-args 属性，HTML 反转义后解析嵌套 JSON，直接拿到 message_snapshot.message_list。

这一过程只需要 requests 库做普通 HTTP 请求，不需要 headless browser、不需要 WebFetch、不需要用户提供 Cookie。

python scripts/fetch_doubao_thread.py --url "https://www.doubao.com/thread/xxxxx" --output-dir ./transcripts/thread-1

脚本会输出 conversation.json（结构化消息）、conversation.md（可读 Markdown）和 metadata.json（标题、bot 名称、用户名等）。

方式 B: 用户保存的 HTML

如果链接不可公开访问（需登录等），请用户在浏览器中打开对话页面，等加载完毕后 Ctrl+S 保存为 HTML 文件：

python scripts/fetch_doubao_thread.py --html-file ./source/doubao-thread.html --output-dir ./transcripts/thread-1

方式 C: 用户复制粘贴

如果以上方式均不可行，请用户复制对话文本（可分段），保存为文本文件后用 --text-file 解析。脚本支持 JSON 数组、Markdown 标题、角色前缀、交替段落等多种文本格式：

python scripts/fetch_doubao_thread.py --text-file ./source/doubao-thread-1.txt --output-dir ./transcripts/thread-1

不要要求用户在聊天中提供 Cookie 或密码。对话导入规则见 references/conversation-memory.md。

5. 生成 sessions 和 memory

从一个或多个 conversation.json 生成 ClawNest 目标结构：

python scripts/build_memory.py --input-dir ./transcripts --workspace-dir . --agent-name "<豆包智能体名称>"

输出规则：

• 完整消息写入顶层 sessions/*.jsonl。
• 讨论摘要写入 memory/history.jsonl。
• 长期记忆摘要写入 memory/MEMORY.md。
• 不把完整历史对话塞进 memory/history.jsonl。

6. 验证回家效果

至少验证：

• 当前智能体能按旧豆包智能体身份介绍自己。
• 能使用旧智能体开场白或接近的语气。
• 能根据 sessions/ 延续旧豆包对话时间线。
• 能根据 memory/MEMORY.md 提炼长期偏好，但不泄露敏感原文。
• 遇到未导入内容时坦诚说明，而不是编造。

将验证问题写入 tests/regression-prompts.md。

资源索引

• scripts/build_identity.py：从豆包设定生成 AGENTS.md、SOUL.md、USER.md。
• scripts/fetch_doubao_thread.py：自包含的豆包对话抓取器。--url 直接从公开链接提取 SSR 内嵌的对话数据（推荐）；--html-file 解析保存的 HTML；--text-file 解析复制粘贴的文本。只需 requests 库，不需要 headless browser 或 WebFetch。
• scripts/build_memory.py：把结构化对话写入 sessions/、memory/history.jsonl、memory/MEMORY.md。
• assets/agents_template.md：AGENTS.md 模板。
• assets/soul_template.md：SOUL.md 模板。
• assets/user_template.md：USER.md 模板。
• assets/session_template.jsonl：sessions/*.jsonl 示例。
• references/migration-mapping.md：豆包设定字段映射。
• references/conversation-memory.md：对话导入、sessions 与 memory 生成规则。
• references/clawnest-target.md：ClawNest 目标目录和运行规则。
• references/clawnest-memory-format.md：ClawNest 记忆格式说明。