fix(agents): 修复文件重命名后遗留的断裂交叉引用

docs/02-user-guide/03-teaching/05-learning-feedback.md

@@ -91,10 +91,54 @@ keywords: [学习反馈, 反馈卡片, 确认学习, 纠正, 知识验证]
 - 来源对话
 - 当前状态（生效中 / 已撤销 / 已修改）
 
+## 学习存储机制
+
+了解学习内容的存储方式，有助于理解反馈卡片各字段的含义：
+
+| 存储位置 | 内容 | 说明 |
+|---------|------|------|
+| `memory/` 目录 | 事实、偏好、经验教训 | 每条记忆一个 `.md` 文件，带类型标签 |
+| `principles.md` | 行为规则和约束 | 经你确认的"必须做 / 绝不做"规则写入此处 |
+| `relationship.md` | 协作契约 | 双方的沟通约定和工作方式 |
+
+当你确认一条学习反馈后，智能体会根据知识类型将其写入对应文件。**撤销操作**则是将该条目标记为无效或从文件中移除。
+
+:::note 记忆 vs 规则
+- **记忆**：智能体"知道"的事实（如"用户喜欢深色模式"），影响回答内容
+- **规则**：智能体"必须遵守"的行为约束（如"绝不在邮件中使用感叹号"），影响行为方式
+:::
+
+## 一次对话中的多条学习
+
+在一次较长的教学对话中，智能体可能同时学到多条内容。此时你会看到多张反馈卡片依次出现：
+
+```
+你："记住三件事：
+    1. 周报用 Markdown 格式
+    2. 发给客户的邮件必须抄送项目经理
+    3. 代码注释用中文"
+
+智能体：[生成 3 张反馈卡片，分别对应格式偏好、邮件规则、注释规范]
+```
+
+你可以逐张确认、修改或撤销，互不影响。
+
+## 有效教学的最佳实践
+
+| 做法 | 效果 |
+|------|------|
+| ✅ 给出具体示例，而非抽象描述 | 智能体理解更准确，反馈卡片质量更高 |
+| ✅ 一次教一个主题 | 避免混淆，每张卡片对应一条清晰知识 |
+| ✅ 确认前仔细阅读"理解内容"字段 | 发现理解偏差的最佳时机 |
+| ✅ 纠正时说明"为什么"和"边界条件" | 智能体能泛化到类似场景 |
+| ❌ 教了就走，不看反馈 | 可能积累错误理解 |
+| ❌ 一次灌输大量不相关规则 | 容易混淆适用范围 |
+
 :::tip 建立定期复审习惯
 建议定期（比如每周）花几分钟检查智能体新学到的内容，确保一切都在正轨上。就像定期跟徒弟沟通一样——越早发现问题，纠正成本越低。
 :::
 
 :::info 下一步
-如果发现智能体学错了某些东西，需要撤销或让它遗忘怎么办？前往 [撤销与遗忘](./06-undo-forget.md) 了解操作方法。
+- 发现智能体学错了？前往 [撤销与遗忘](./06-undo-forget.md) 了解如何回退
+- 想了解教学背后的完整原语体系？回到 [六大原语](./02-six-primitives.md) 复习
 :::

docs/02-user-guide/04-delegation/05-receipts.md

@@ -38,6 +38,76 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯]
 
 ![执行回执示例](/img/user-guide/delegation/receipt-example.svg)
 
+### 基础信息
+
+```
+┌──────────────────────────────────────────────────────┐
+│  📋 执行回执                                           │
+├──────────────────────────────────────────────────────┤
+│                                                        │
+│  回执编号: RCPT-20250315-143022                       │
+│  任务: 审查采购合同 XX-2025-001                        │
+│  执行时间: 2025-03-15 14:30 - 14:35                   │
+│  总耗时: 5 分 12 秒                                    │
+│  状态: ✅ 已完成                                        │
+│                                                        │
+└──────────────────────────────────────────────────────┘
+```
+
+### 输入输出摘要
+
+```
+│  📥 输入                                               │
+│  用户指令: "帮我审查附件中的采购合同"                      │
+│  附件: XX科技采购合同.pdf (128KB)                       │
+│                                                        │
+│  📤 输出                                               │
+│  审查报告已保存至: docs/review-report-XX-2025-001.md   │
+│  发现 2 个风险项，4 个合规项                             │
+│  综合风险等级: 中等                                     │
+```
+
+### 步骤执行明细
+
+```
+│  📝 执行步骤                                           │
+│                                                        │
+│  1. ⚙️ [确定性] 解析合同文件                       ✅ 0.8s  │
+│  2. ⚙️ [确定性] 检查违约金比例                     ✅ 0.2s  │
+│     └─ 15% ≤ 20% → 合规                                │
+│  3. ⚙️ [确定性] 检查付款条件                       ⚠️ 0.2s  │
+│     └─ 15 天 < 30 天 → 风险                             │
+│  4. 🧠 [灵活] 分析进口设备条款                   ⚠️ 1.5min │
+│     └─ 缺少中文说明书条款                                │
+│  5. 🧠 [灵活] 综合风险评估                       ✅ 1.2min │
+│  6. 🚪 [人闸门] 确认后保存报告                   ✅ 3.5s   │
+│     └─ 用户确认: 已批准                                  │
+```
+
+### 依据追溯
+
+```
+│  📚 依据                                               │
+│                                                        │
+│  引用的规则:                                            │
+│  - 违约金标准 (≤20%) — 来自 3 月 1 日的教学             │
+│  - 付款条件标准 (≥30 天) — 来自 3 月 1 日的教学          │
+│  - 进口设备中文说明书 — 来自 3 月 5 日的教学             │
+│                                                        │
+│  引用的示例:                                            │
+│  - 审查报告模板 — 来自 3 月 2 日的教学                   │
+```
+
+### 变更记录
+
+```
+│  📂 文件变更                                            │
+│                                                        │
+│  新建文件: docs/review-report-XX-2025-001.md           │
+│  变更大小: 2.1KB                                       │
+│  [查看文件内容]                                         │
+```
+
 ## 如何查看回执
 
 ### 在对话中查看
@@ -82,7 +152,7 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯]
 
 ## 通过回执追溯和恢复
 
-如果你对执行结果不满意，先用回执确认影响范围，再使用 Rewind / Checkpoint 恢复到合适状态。较新的 DesireCore 会优先基于检查点恢复，而不是依赖单个步骤的手工回滚。
+如果你对执行结果不满意，可以基于回执进行回滚。DesireCore 支持多种粒度的回滚，并且较新版本会优先基于检查点恢复，而不是依赖单个步骤的手工回滚。
 
 | 回滚级别 | 含义 | 适用场景 |
 |---------|------|---------|

docs/02-user-guide/06-agents/04-edit-persona.md

@@ -20,7 +20,7 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置]
 | **禁区** | 什么不该做 | "不要使用模板腔，不要回避给结论" |
 | **不确定处理** | 拿不准时怎么办 | "说明不确定点并给验证路径" |
 
-`persona.md` 是 **Agent 层提示词**的一部分。运行时还会叠加当前用户的全局提示词和智能体所属团队的团队提示词；你可以在 **资源管理器 → 提示词中心**中集中编辑并预览最终组合。详见[提示词中心与三层提示词](./11-prompt-center.md)。
+`persona.md` 是 **Agent 层提示词**的一部分。运行时还会叠加当前用户的全局提示词和智能体所属团队的团队提示词；你可以在 **资源管理器 → 提示词中心**中集中编辑并预览最终组合。详见[提示词中心与三层提示词](./12-prompt-center.md)。
 
 :::info 人格 vs 行为准则
 **人格设定**定义的是"怎么做"——语气、风格、回答方式。**行为准则**（Principles）定义的是"做什么和不做什么"——规则、边界、优先级。两者互补但不重叠。
@@ -103,5 +103,5 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置]
 ## 下一步
 
 - [编辑行为准则](./05-edit-principles.md) — 为智能体设定行为边界
-- [提示词中心与三层提示词](./11-prompt-center.md) — 管理全局、团队和 Agent 提示词
+- [提示词中心与三层提示词](./12-prompt-center.md) — 管理全局、团队和 Agent 提示词
 - [创建自定义智能体](./03-create-agent.md) — 回顾创建流程

docs/02-user-guide/06-agents/05-edit-principles.md

@@ -95,4 +95,4 @@ L2 保存较长的解释、例外、示例和操作细节，默认不注入，
 
 - [文件资源管理器](./06-agent-files.md) — 浏览智能体的文件结构
 - [编辑人格设定](./04-edit-persona.md) — 调整智能体的语气和风格
-- [提示词中心与三层提示词](./11-prompt-center.md) — 理解全局、团队和 Agent 的组合顺序
+- [提示词中心与三层提示词](./12-prompt-center.md) — 理解全局、团队和 Agent 的组合顺序

docs/02-user-guide/06-agents/07-skills-management.md

@@ -63,8 +63,6 @@ DesireCore 会从多个来源发现技能：
 
 安装 Skill 时可以选择安装目标：全局、指定智能体，或项目级目录。全局市场技能安装后会写入全局技能目录，所有智能体都能发现；绑定到智能体的技能会写入对应智能体仓库；项目级 Skill 只在对应工作目录下生效，适合把团队规范、项目脚本和本地模板随项目一起维护。
 
-### 移除技能
-
 ### 本地导入
 
 技能管理中的 **导入技能** 支持三种本地格式：

docs/02-user-guide/06-agents/08-version-control.md

@@ -134,11 +134,11 @@ DesireCore 中的每个智能体都是一个 Git 仓库。你对智能体的每
 
 除了发布单个智能体，DesireCore 还支持克隆智能体和团队级版本管理：
 
-- [Clone 与同步](./clone-and-sync) — 复制智能体，选择是否复制私有数据，并处理后续同步
-- [团队版本管理](./team-version-control) — 团队远程托管、fork、release 和市场分发
+- [Clone 与同步](./09-clone-and-sync.md) — 复制智能体，选择是否复制私有数据，并处理后续同步
+- [团队版本管理](./10-team-version-management.md) — 团队远程托管、fork、release 和市场分发
 
 ## 下一步
 
-- [团队版本管理](./09-team-version-management.md) — 把整支智能体团队当作一个整体进行版本管理
+- [团队版本管理](./10-team-version-management.md) — 把整支智能体团队当作一个整体进行版本管理
 - [智能体类型](./01-agent-types.md) — 回顾智能体的类型和定位
 - [创建自定义智能体](./03-create-agent.md) — 创建你自己的智能体

docs/02-user-guide/06-agents/09-clone-and-sync.md

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