Clone 与同步
生效版本
v10.0.179+（长期指令 instructions.md）。
Clone 用于基于现有智能体创建一个新副本。它适合做实验、为不同项目准备变体，或把市场智能体调整成自己的版本。
何时需要克隆
| 场景 | 说明 |
|---|---|
| 实验性改造 | 想大幅修改某智能体的人格或技能，但不确定效果，先克隆一个"试验田" |
| 项目变体 | 同一个基础智能体需要适配不同项目（如不同客户的审查标准） |
| 市场智能体本地化 | 从市场安装了智能体，想深度定制而不受远端更新干扰 |
| 团队协作模板 | 创建一个标准化的团队智能体模板，成员各自克隆后按需调整 |
克隆操作步骤
- 打开 资源管理器 → 智能体列表
- 右键目标智能体（或点击
⋯菜单），选择 克隆 - 在弹出的对话框中设置：
- 新名称：为克隆体取一个易区分的名字
- 远程关系（仅当源智能体有远程来源时）：
- 保留远程：后续可继续接收更新
- Fork：创建独立分支，与原远程解耦
- 纯本地：完全断开远程关联
- 私有数据选项（见下节）
- 点击 确认克隆，系统创建新的智能体 ID 并完成复制
注意
核心 DesireCore 智能体（系统调度器）不允许被克隆，以避免破坏主控入口。如果菜单中克隆选项为灰色，说明该智能体受保护。
长期指令跟随智能体本体
可选 instructions.md 与人格、原则等定义文件一起随智能体克隆、导入导出和版本更新，不属于“私有数据选项”。它应只保存 Agent 自身的长期职责与交付要求；用户、团队或项目专属内容保留在对应作用范围，避免通过共享智能体把这些内容带给其他人。
更新前可以查看长期指令的 diff，决定如何合并本地与上游要求。使用这类内容包前，应满足包声明的最低客户端版本。格式与归属见文件格式说明。
私有数据选项
克隆时可以选择是否复制当前用户与该智能体之间的私有数据：
| 数据类型 | 说明 | 建议 |
|---|---|---|
| 记忆（memory/） | 智能体在对话中学到的事实、偏好、经验 | 自用分身可保留，分享给他人时不勾选 |
| 偏好（preferences/） | 用户个性化设置 | 视情况保留 |
| 关系契约（relationship.md） | 你与智能体的协作约定 | 通常需要重新建立，不建议复制 |
| 本地资源文件 | 工作目录中的文件 | 大型项目建议不复制，节省空间 |
经验法则：给自己创建分身 → 可保留记忆和偏好；给别人或团队准备模板 → 不复制私有数据。
同步更新
克隆后的智能体如果仍保留远程来源（即选择了"保留远程"），可以继续接收上游更新：
- 打开智能体详情页，在 来源 区域查看远程仓库地址
- 点击 检查更新，系统会获取当前可更新的远端版本，并与本地比较
- 如果有新内容，会显示变更文件列表和差异摘要
- 点击 合并更新，系统执行 Git 合并
更新策略
- 定义更新（人格、原则、长期指令、技能）：查看差异，确认是否需要保留本地调整
- 新增技能/工具：合并后检查新增内容及依赖要求
- 删除或重命名：需要手动确认，系统不会静默删除你本地已有的文件
检查更新后显示暂停怎么办
市场智能体的内容若来自发布者仓库，会同步到市场当前审核通过的版本。若显示「更新已暂停」，查看原因，按提示恢复目录访问或升级客户端后重试。暂停不表示没有更新。
冲突处理
当本地和远端都修改了同一个文件时，DesireCore 会阻止直接覆盖，并提供冲突解决对话框：
- 查看冲突文件列表 — 标红的文件表示双方都有修改
- 打开 Diff 视图 — 左右对比本地版本和远端版本的差异
- 选择解决策略：
- 保留本地：丢弃远端更改，使用你的版本
- 使用远端：接受上游更新，覆盖本地修改
- 手动编辑：在编辑器中逐行决定保留哪些内容
- 保留两者：将远端内容追加为新文件（如
persona-remote.md）
- 解决所有冲突后点击 完成合并，系统自动提交
长期改造建议
如果你长期大幅改造市场智能体，建议 fork 成自己的远程仓库。这样：
- 上游更新不会自动推送，由你主动选择何时同步
- 冲突范围更可控，因为你清楚自己改了什么
- 其他团队成员可以基于你的 fork 创建各自版本
常见问题
| 问题 | 解决方案 |
|---|---|
| 克隆后智能体表现和原来不一样 | 检查是否遗漏了私有数据（记忆、偏好），或新 ID 导致关系数据未迁移 |
| 同步时提示"无法合并" | 通常因为本地有未提交的修改，先在智能体文件页面手动提交或暂存 |
| 想恢复克隆前的状态 | 克隆不会修改原智能体，原智能体始终不受影响 |
| 克隆体能加入团队吗 | 可以。克隆后是独立智能体，可以像任何其他智能体一样加入团队 |