desirecore · yi-ge · Jul 28, 2026 · Jul 25, 2026 · Jul 25, 2026 · Jul 25, 2026
diff --git a/docs/02-user-guide/05-super-document/01-overview.md b/docs/02-user-guide/05-super-document/01-overview.md
@@ -45,32 +45,30 @@ keywords: [超级文书, Super Document, Diff, 协作写作, AI 写作]
 
 ## 一图看懂超级文书流程
 
+```mermaid
+flowchart TD
+    A[你发起写作任务] --> B[智能体生成或修改内容]
+    B --> C[Diff 视图展示所有变更]
+    C --> D{你逐条审阅}
+    D -->|接受| E[修改生效]
+    D -->|拒绝| F[恢复原文]
+    D -->|编辑| G[手动调整]
+    E --> H[确认后形成新版本]
+    F --> H
+    G --> H
+    H --> I[继续对话，进一步迭代...]
+
+    style C fill:#fff3cd,stroke:#ffc107
+    style H fill:#d4edda,stroke:#28a745
 ```
-你发起写作任务
-    |
-    v
-智能体生成或修改内容
-    |
-    v
-Diff 视图展示所有变更  <-- 红色 = 删除，绿色 = 新增
-    |
-    v
-你逐条审阅
-    |
-    +--> 接受：修改生效
-    +--> 拒绝：恢复原文
-    +--> 编辑：手动调整
-    |
-    v
-确认后形成新版本
-    |
-    v
-继续对话，进一步迭代...
-```
+
+> 💡 **Diff 视图**中，<span style={{color: '#dc3545'}}>红色 = 删除</span>，<span style={{color: '#28a745'}}>绿色 = 新增</span>，让每一处修改一目了然。
 
 每一轮修改都会被记录为一个版本。你可以随时回到任何历史版本，就像代码的 Git 历史一样。
 
 ## 下一步
 
 - [协作写文档](./02-collaborative-writing.md) — 学习如何与智能体一起写文档
 - [Diff 可视化](./03-diff-view.md) — 了解修改对比视图的使用方法
+- [审阅变更](./04-review-changes.md) — 逐条接受、拒绝或编辑 AI 的修改
+- [版本历史](./05-version-history.md) — 回溯任意历史版本，安全回滚
diff --git a/docs/02-user-guide/05-super-document/04-review-changes.md b/docs/02-user-guide/05-super-document/04-review-changes.md
@@ -91,6 +91,47 @@ keywords: [审阅, 接受修改, 拒绝修改, 批量操作, 逐条审阅]
 | 跳转到下一个修改 | `]` |
 | 跳转到上一个修改 | `[` |
 
+## 审阅完成后的操作
+
+当你审阅完所有修改后（进度条显示"8/8 已审阅"），超级文书会：
+
+1. 自动将所有已接受的修改合并到正文
+2. 生成一个新的版本快照
+3. 退出审阅模式，回到正常编辑状态
+
+此时你可以：
+
+- **继续对话迭代** — 在对话框中输入进一步要求，如"第二段语气再正式一些"，智能体会基于当前版本再次修改
+- **手动编辑** — 直接在文档中修改文字，这些修改也会记录在新版本中
+- **结束协作** — 关闭文档，所有版本已自动保存
+
+## 编辑后重新提交审阅
+
+如果你对文档做了手动编辑，想请智能体再审一遍或继续修改：
+
+1. 在对话框中描述你的需求（如"帮我检查全文的逻辑连贯性"）
+2. 智能体会基于**包含你手动修改的最新版本**进行新一轮修改
+3. 新的 Diff 视图只展示本轮新增的变更，不会重复显示已确认的内容
+
+:::tip 三种迭代方式
+| 方式 | 适用场景 | 操作 |
+|------|----------|------|
+| 对话追加要求 | 对整体方向有调整 | 在对话框输入新指令 |
+| 评论反馈 | 针对具体某处修改有意见 | 在审阅时添加评论 |
+| 手动编辑后再提交 | 你想自己先改，再让 AI 润色 | 直接编辑文档后发起新对话 |
+:::
+
+## 审阅策略建议
+
+面对大量修改时，推荐以下审阅策略：
+
+| 场景 | 建议策略 |
+|------|----------|
+| 修改少于 5 处 | 逐条审阅，每处都仔细看 |
+| 修改 5-20 处 | 先拒绝明显不对的，再逐条看剩余 |
+| 修改超过 20 处 | 先快速浏览全貌，对关键段落逐条审，其余批量接受 |
+| 对 AI 修改高度信任 | 直接批量接受，事后通读全文 |
+
 ## 下一步
 
 - [版本历史](./05-version-history.md) — 了解如何查看和管理文档的版本历史

diff --git a/docs/02-user-guide/07-memory/03-view-manage.md b/docs/02-user-guide/07-memory/03-view-manage.md
@@ -36,18 +36,39 @@ keywords: [记忆管理, 查看记忆, 编辑记忆, 删除记忆, 记忆搜索]
 点击"来源会话"链接，可以回到产生这条记忆的原始对话上下文，了解完整的讨论背景。
 :::
 
-## 搜索记忆
+## 搜索与筛选记忆
 
-当记忆条目较多时，你可以使用搜索功能快速定位：
+当记忆条目较多时，你可以通过搜索和筛选快速定位目标记忆。
 
-**自然语言搜索** — 在搜索框中输入你想查找的内容：
+### 自然语言搜索
+
+在搜索框中输入你想查找的内容：
 
 - "关于报告格式的偏好"
 - "项目 Alpha 的决策"
 - "上次讨论的技术方案"
 
 系统会在所有域中进行语义搜索，返回最相关的结果。高置信度的记忆会优先展示。
 
+### 按类型筛选
+
+每条记忆都带有类型标签，你可以按类型快速过滤：
+
+| 类型 | 含义 | 典型内容 |
+|------|------|----------|
+| `fact` | 客观事实 | "用户是产品经理"、"公司使用 React 技术栈" |
+| `preference` | 主观偏好 | "喜欢简洁的文风"、"报告不要超过两页" |
+| `decision` | 已做决策 | "选用 PostgreSQL 作为主数据库" |
+| `commitment` | 承诺事项 | "下周三前提交初稿" |
+| `milestone` | 重要事件 | "v2.0 于 6 月上线" |
+| `lesson` | 经验教训 | "凌晨部署容易出问题" |
+
+### 按域和时间过滤
+
+- **域过滤**：切换到特定域标签页（关系 / 共享 / 核心），只查看该域下的记忆
+- **时间排序**：默认按创建时间倒序，可切换为"最近使用"排序，查看哪些记忆最活跃
+- **固定优先**：开启后，被 Pin 的记忆始终显示在列表顶部
+
 ## 编辑记忆
 
 如果发现某条记忆不够准确，你可以直接编辑：
@@ -75,12 +96,12 @@ keywords: [记忆管理, 查看记忆, 编辑记忆, 删除记忆, 记忆搜索]
 删除记忆后，智能体将无法再引用这条信息。请确认你不再需要它。不过，记忆的历史记录仍保留在版本控制中，技术上可以恢复。
 :::
 
-## 标记重要记忆
+## 标记重要记忆（Pin / Unpin）
 
 对于特别重要的记忆，你可以将其标记为**固定（Pin）**：
 
 1. 找到重要的记忆条目
-2. 点击固定/置顶按钮
+2. 点击固定/置顶按钮（📌 图标）
 3. 该记忆将获得"永不遗忘"保护
 
 被固定的记忆不会因自动遗忘机制而被压缩或清理。适合用于：
@@ -89,6 +110,27 @@ keywords: [记忆管理, 查看记忆, 编辑记忆, 删除记忆, 记忆搜索]
 - 重要的个人偏好
 - 不能遗忘的承诺和约定
 
+**取消固定（Unpin）**：如果某条记忆不再需要最高优先级保护，再次点击 📌 图标即可取消。取消后，该记忆恢复为普通条目，可能在未来被自动压缩。
+
+:::tip Pin 的数量建议
+固定记忆建议控制在 10 条以内。Pin 过多会占用每次对话的上下文预算，反而影响智能体获取新信息的空间。
+:::
+
+## 批量管理
+
+当需要清理大量过时记忆时，可以使用批量操作：
+
+1. 进入记忆列表，开启**多选模式**（列表顶部复选框）
+2. 勾选需要操作的记忆条目
+3. 使用底部操作栏执行：
+   - **批量删除** — 一次性清除多条无用记忆
+   - **批量固定** — 将多条相关记忆同时设为 Pin
+   - **导出** — 将选中记忆导出为 Markdown 文件，便于归档或迁移
+
+:::caution 批量删除需确认
+批量删除会弹出二次确认对话框，显示将要删除的记忆数量和摘要。确认后不可直接撤销（但版本历史中仍保留记录）。
+:::
+
 ## 审阅候选记忆
 
 每次对话结束后，系统可能会生成候选记忆供你审阅：

diff --git a/docs/02-user-guide/07-memory/04-auto-learning.md b/docs/02-user-guide/07-memory/04-auto-learning.md
@@ -55,8 +55,18 @@ DesireCore 的记忆系统不仅能记住，还会自动学习和适度遗忘—
 
 每条记忆会经历以下阶段：
 
-```
-活跃（Active）→ 近期（Recent）→ 归档（Archived）→ 压缩（Compressed）→ 清理（Pruned）
+```mermaid
+flowchart LR
+    A[活跃\nActive] --> B[近期\nRecent]
+    B --> C[归档\nArchived]
+    C --> D[压缩\nCompressed]
+    D --> E[清理\nPruned]
+
+    style A fill:#c8e6c9,stroke:#4caf50,color:#333
+    style B fill:#fff9c4,stroke:#ffc107,color:#333
+    style C fill:#ffe0b2,stroke:#ff9800,color:#333
+    style D fill:#ffccbc,stroke:#ff5722,color:#333
+    style E fill:#ffcdd2,stroke:#f44336,color:#333
 ```
 
 | 阶段 | 说明 | 你能看到什么 |
@@ -83,8 +93,20 @@ Auto Dream 的灵感来自人类的"做梦"机制：在你不使用智能体的
 
 加入 Auto Dream 后，完整的记忆生命周期变为：
 
-```
-活跃（Active）→ 近期（Recent）→ 归档（Archived）→ 💤 Dream → 压缩（Compressed）→ 清理（Pruned）
+```mermaid
+flowchart LR
+    A[活跃\nActive] --> B[近期\nRecent]
+    B --> C[归档\nArchived]
+    C --> D[💤 Dream\n无损遗忘]
+    D --> E[压缩\nCompressed]
+    E --> F[清理\nPruned]
+
+    style A fill:#c8e6c9,stroke:#4caf50,color:#333
+    style B fill:#fff9c4,stroke:#ffc107,color:#333
+    style C fill:#ffe0b2,stroke:#ff9800,color:#333
+    style D fill:#e1bee7,stroke:#9c27b0,color:#333
+    style E fill:#ffccbc,stroke:#ff5722,color:#333
+    style F fill:#ffcdd2,stroke:#f44336,color:#333
 ```
 
 Dream 阶段发生在归档和压缩之间：系统扫描归档记忆中的关联内容，将多条零散记忆合并为一条结构化知识，保留核心语义的同时大幅减少存储。

diff --git a/docs/02-user-guide/09-capabilities/02-builtin-tools.md b/docs/02-user-guide/09-capabilities/02-builtin-tools.md
@@ -141,9 +141,19 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 | 典型场景 | 等待构建完成、轮询部署状态、控制请求频率 |
 
 :::tip Sleep 与 CreateSchedule 的区别
-`Sleep` 是当前会话内的阻塞等待，适合“等几秒后继续检查”。`CreateSchedule` 是后台异步调度，到点后创建新的执行任务，适合提醒、定期检查和独立汇报。
+`Sleep` 是当前会话内的阻塞等待，适合"等几秒后继续检查"。`CreateSchedule` 是后台异步调度，到点后创建新的执行任务，适合提醒、定期检查和独立汇报。
 :::
 
+### TerminalControl — 交互式终端
+
+创建和管理交互式终端会话（PTY），支持持续交互式操作。与 Bash 不同，TerminalControl 可以等待提示符、处理 `(y/n)` 确认、输入密码，适合需要多轮交互的场景。
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 高 |
+| 需要确认 | 是 |
+| 典型场景 | 运行 `npm run dev` 等长驻进程、交互式安装向导、协同终端操作 |
+
 ## 网络类
 
 ### WebFetch — 获取网页
@@ -199,36 +209,6 @@ Web Access 技能启用后，智能体可以使用浏览器标签页访问动态
 | 需要确认 | 取决于权限和任务内容 |
 | 典型场景 | 跨专业分工、并行调研、让 Explore 预设只读分析代码库 |
 
-### spawn_agent — 启动子智能体
-
-启动临时子智能体处理明确的子任务。子智能体拥有独立上下文，适合并行处理独立问题。
-
-| 属性 | 值 |
-|------|-----|
-| 风险等级 | 中 |
-| 需要确认 | 取决于权限和任务内容 |
-| 典型场景 | 并行阅读多个模块、拆分大型问题、隔离探索任务 |
-
-### handoff — 转交会话
-
-将当前会话交给另一个智能体，并携带原因和上下文摘要。
-
-| 属性 | 值 |
-|------|-----|
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 典型场景 | 当前智能体判断另一个专业智能体更适合继续处理 |
-
-### request_help — 请求协助
-
-向另一个持久智能体请求意见或帮助，可选择等待对方回复。
-
-| 属性 | 值 |
-|------|-----|
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 典型场景 | 向领域专家智能体征询建议 |
-
 ### SendMessage — 智能体间发送消息
 
 向另一个智能体发送消息，可携带上下文、意图和等待策略。
@@ -484,3 +464,66 @@ Web Access 技能启用后，智能体可以使用浏览器标签页访问动态
 | 需要确认 | 否 |
 
 执行确定性的高精度数学计算，适合金额、比例、统计和公式校验。
+
+### GenerateDiagram — 生成图表
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+用 draw.io XML 渲染架构图、流程图、UML、思维导图等图表，在对话中直接展示可编辑的图表卡片。适合需要可视化表达结构、流程或关系的场景。
+
+### UnderstandImage — 图像理解
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+给定图片 URL 返回视觉模型对图片内容的描述或回答。当主模型不支持视觉时作为降级方案使用。
+
+### Canvas — 网页窗口操控
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 视操作内容而定 |
+
+操控 Electron 窗口，支持网页展示、JS 执行、截图和 A2UI 消息推送。适合需要渲染网页并与之交互的场景。
+
+### EnterWorktree / ExitWorktree — 隔离工作区
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 是 |
+
+为当前操作创建或重用隔离的 Git linked worktree，让文件修改和命令在独立目录中执行，不影响主工作区。适合需要隔离环境的开发任务。
+
+### MailOperations — 邮件操作
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 视操作内容而定 |
+
+调用本机 Mail Service 的 REST API，支持账户列表、邮件收发/搜索、标签、自动化规则等完整邮件操作。详见 [邮件管理](../email/overview)。
+
+### ManageSchedule — 管理定时调度
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 是 |
+
+创建和管理定时调度任务，支持延迟、定时、周期和 cron 表达式触发。到期后系统创建新会话执行。详见 [定时调度](../08-automation/03-scheduled-tasks.md)。
+
+### RefreshAgentFS — 刷新智能体状态
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+智能体写完 AgentFS 文件后主动调用，触发前端 UI 与工具/技能注册表的即时刷新，避免等待目录监控延迟。
diff --git a/docs/02-user-guide/09-capabilities/06-integrations-overview.md b/docs/02-user-guide/09-capabilities/06-integrations-overview.md
@@ -97,7 +97,7 @@ Computer Use 适合没有开放 API、需要跨多个桌面应用完成的任务
 
 ## 自定义集成
 
-如果现有集成不满足你的需求，DesireCore 提供三种方式来扩展：
+如果现有集成不满足你的需求，DesireCore 提供四种方式来扩展：
 
 1. **自建 MCP 服务** — 按照 MCP 协议规范实现自己的服务端，让智能体调用你的内部 API。参见 [MCP 集成](./mcp-integration)
 2. **创建技能包** — 将多个工具编排成自定义工作流，适合反复执行的复杂任务。参见 [技能包](./skill-packs)

diff --git a/docs/02-user-guide/09-capabilities/07-web-access.md b/docs/02-user-guide/09-capabilities/07-web-access.md
@@ -50,11 +50,28 @@ LocalBookmarks 可以从本机浏览器书签和历史中寻找 URL 线索。它
 
 ## 与 WebFetch / WebSearch 的关系
 
-优先级通常是：
+DesireCore 的联网能力分三层，智能体会按成本从低到高自动选择：
 
-1. `WebSearch` 查找公开信息
-2. `WebFetch` 读取静态网页正文
-3. Web Access 处理动态、登录态或需要操作的页面
+| 层级 | 工具 | 适用场景 | 特点 |
+|------|------|----------|------|
+| 1 | WebSearch | 查找公开信息、新闻、技术文档 | 不打开浏览器，直接返回搜索结果摘要 |
+| 2 | WebFetch | 读取已知 URL 的网页正文 | 智能提取正文、去广告导航，15 分钟缓存 |
+| 3 | Web Access | 动态页面、登录态、SPA、表单操作 | 启动受控浏览器，模拟真实用户操作 |
 
 如果普通抓取足够完成任务，智能体不需要打开浏览器。
 
+## 典型使用场景
+
+| 场景 | 推荐工具 | 说明 |
+|------|----------|------|
+| 查找某个 API 的最新文档 | WebSearch | 公开信息，搜索即可 |
+| 读取一篇博客文章内容 | WebFetch | 静态页面，直接抓取正文 |
+| 登录管理后台查看数据 | Web Access | 需要登录态和页面交互 |
+| 操作 SPA 单页应用 | Web Access | 内容通过 JS 动态渲染 |
+| 填写在线表单并提交 | Web Access | 需要输入和点击操作 |
+| 截取页面当前状态 | Web Access | 需要截图能力 |
+
+:::tip 自动降级
+WebSearch 内部也有降级策略：优先使用 LLM 服务端搜索，不可用时降级到独立搜索 API，最后才启动浏览器子智能体。你无需手动选择，智能体会根据任务自动判断。
+:::
+