dominds 1.7.0 → 1.7.2

package/dist/docs/dialog-system.zh.md

@@ -2,15 +2,15 @@
 
 英文版：[English](./dialog-system.md)
 
-本文档提供 Dominds 对话系统的详细实现规范，包括核心工具、技术架构、对话管理、内存管理、系统集成以及"向人类提问"(Q4H)机制。
+本文档提供 Dominds 对话系统的详细实现规范，包括核心工具、技术架构、对话管理、内存管理、系统集成以及向人请示（Q4H）机制。
 
 ## 目录
 
 1. [术语](#术语)
 2. [后端驱动架构](#后端驱动架构)
-3. [三类队友 Tellask 分类](#三类队友-tellask-分类)
+3. [三类队友诉请分类](#三类队友诉请分类)
 4. [核心机制](#核心机制)
-5. [Q4H：向人类提问](#q4h向人类提问)
+5. [Q4H：向人请示](#q4h向人请示)
 6. [对话层级与子对话](#对话层级与子对话)
 7. [思维清晰工具](#思维清晰工具)
 8. [提醒管理](#提醒管理)
@@ -28,21 +28,21 @@
 
 本章定义本文档中使用的面向实现的术语。
 关于双语/面向用户的命名约定（主线对话/支线对话；诉请者对话/被诉请者对话），请参阅 [`dominds-terminology.md`](./dominds-terminology.md)。
-关于 Taskdoc 包结构和封装规则，请参阅 [`encapsulated-taskdoc.zh.md`](./encapsulated-taskdoc.zh.md)。
+关于差遣牒任务包结构和封装规则，请参阅 [`encapsulated-taskdoc.zh.md`](./encapsulated-taskdoc.zh.md)。
 
-### 上位对话 (Supdialog)
+### 上位对话
 
-**上位对话** (supdialog，全称 "super dialog") 是层级对话关系中的上位对话。它编排和管理子对话，提供上下文、目标和指导，同时接收来自子对话的结果、问题和升级。上位对话维护整体任务上下文，并决定何时不再需要子对话。
+**上位对话**是层级对话关系中的上位对话。它编排和管理子对话，提供上下文、目标和指导，同时接收来自子对话的结果、问题和升级。上位对话维护整体任务上下文，并决定何时不再需要子对话。
 
 注意：**上位对话**是层级结构里的父对话，并不等同于**诉请者对话**（本次诉请的发起者）。TYPE A（`tellaskBack`）时，诉请者对话就是直接上位对话；TYPE B/C 时，诉请者对话可能是不同的对话。
 
-上位对话可以在子对话执行期间接收来自子对话的 **TellaskBack（回问诉请）**。当子对话需要指导或额外上下文时，它可以用 `tellaskBack({ tellaskContent: "..." })` 回问（TYPE A / `TellaskBack` / 回问诉请），并将响应反馈到子对话上下文。
+上位对话可以在子对话执行期间接收来自子对话的**回问诉请**。当子对话需要指导或额外上下文时，它可以用 `tellaskBack({ tellaskContent: "..." })` 回问，并将响应反馈到子对话上下文。
 
-### 子对话 (Subdialog)
+### 子对话
 
 **子对话** 是由上位对话生成的专门对话，用于处理特定子任务。子对话使用新的上下文操作，专注于定向目标，同时保持与上位对话的通信链接。
 
-**TellaskBack（回问诉请）**：子对话可以在任务执行期间向**诉请者对话**回问澄清。TYPE A 中诉请者对话就是直接上位对话。此机制允许子对话在保持自身上下文和进度的同时提问并接收指导。
+**回问诉请**：子对话可以在任务执行期间向**诉请者对话**回问澄清。TYPE A 中诉请者对话就是直接上位对话。此机制允许子对话在保持自身上下文和进度的同时提问并接收指导。
 
 ### 诉请者对话 / 被诉请者对话（调用角色）
 
@@ -52,13 +52,13 @@
 - TYPE B/C 时，诉请者对话可能是主线对话，也可能是其他支线对话。
 - 回贴会路由到 `assignmentFromSup` 中记录的**当前诉请者对话**。
 
-### 主对话 (Root Dialog)
+### 主对话
 
 **主对话** (也称为 **根对话**) 是对话层级中的顶级对话，没有上位对话关系。它作为任务执行的主要入口点，可以生成多级子对话。这些术语在系统中可互换使用。
 
-### Q4H (向人类提问)
+### 向人请示（Q4H）
 
-**Q4H** 是由对话（主对话或子对话）提出的待处理问题，需要人工输入才能继续。Q4H 被索引在对话的 `q4h.yaml` 文件中（一个索引，不是真理之源），并由 `clear_mind` 操作清除。实际的问题内容存储在对话的对话消息中，其中记录了 `askHuman({ tellaskContent: "..." })` Tellask。
+**Q4H** 是由对话（主对话或子对话）提出的待处理问题，需要人工输入才能继续。Q4H 被索引在对话的 `q4h.yaml` 文件中（一个索引，不是真理之源），并由 `clear_mind` 操作清除。实际的问题内容存储在对话的对话消息中，其中记录了 `askHuman({ tellaskContent: "..." })` 诉请。
 
 ### 子对话索引 (subdlg.yaml)
 
@@ -72,14 +72,14 @@
 
 **子对话注册表** 是根对话作用域的 Map，维护对已注册子对话的持久引用。注册表使用 `agentId!sessionSlug` 作为其键格式。当根完成时，它随根移动到 `done/`，并在根加载时通过扫描 done/ 子对话 YAML 重建。若某个支线对话被宣布卡死，其对应的 TYPE B 注册表条目会被移除，以便后续可用同一 `agentId!sessionSlug` 创建全新的支线对话。
 
-### 队友 Tellask
+### 队友诉请
 
-**队友 Tellask** 是 Dominds 特定的语法，触发与另一个作为子对话的智能体的通信。队友 Tellask 有三种不同模式，具有不同语义（见第 3 节）。
+**队友诉请** 是 Dominds 特定的语法，触发与另一个作为子对话的智能体的通信。队友诉请有三种不同模式，具有不同语义（见第 3 节）。
 
 **诉请块结构**（另见 [`dominds-terminology.md`](./dominds-terminology.md)）：
 
-- **诉请头（Tellask headline）**：诉请块第一行 `tellaskSessionless({ targetAgentId: "<name>", tellaskContent: "..." })`（同一诉请块内，后续以 `tellask* function call` 开头的行会并入诉请头）。
-- **诉请正文（Tellask body）**：由 tellask-special 函数参数 `tellaskContent` 承载的正文载荷。
+- **诉请头**：诉请块第一行 `tellaskSessionless({ targetAgentId: "<name>", tellaskContent: "..." })`（同一诉请块内，后续以 `tellask* function call` 开头的行会并入诉请头）。
+- **诉请正文**：由 tellask-special 函数参数 `tellaskContent` 承载的正文载荷。
 - `sessionSlug` 等结构化指令必须写在诉请头中。
 
 ---
@@ -144,20 +144,20 @@
 
 ---
 
-## 三类队友 Tellask 分类
+## 三类队友诉请分类
 
-本节记录 Dominds 系统中三种不同类型的队友 Tellask，它们的语法、行为和用例。
+本节记录 Dominds 系统中三种不同类型的队友诉请，它们的语法、行为和用例。
 
 ```mermaid
 flowchart TD
   M[LLM 发出 tellaskSessionless({ targetAgentId: "mention", tellaskContent: "..." })] --> Q{这是子对话回问其直接上位对话（TYPE A 的诉请者对话）吗？}
-  Q -- 是 --> A[TYPE A：回问诉请<br/>(`TellaskBack` / 回问诉请)<br/>主要：`tellaskBack({ tellaskContent: "..." })`（无 sessionSlug）]
+  Q -- 是 --> A[TYPE A：回问诉请<br/>主要：`tellaskBack({ tellaskContent: "..." })`（无 sessionSlug）]
   Q -- 否 --> T{是否存在 sessionSlug？}
-  T -- 是 --> B[TYPE B：已注册子对话 Tellask<br/>(`Tellask Session` / 长线诉请)<br/>tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })]
-  T -- 否 --> C[TYPE C：瞬态子对话 Tellask<br/>(`Fresh Tellask` / 一次性诉请)<br/>tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })]
+  T -- 是 --> B[TYPE B：已注册子对话诉请<br/>(长线诉请)<br/>tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })]
+  T -- 否 --> C[TYPE C：瞬态子对话诉请<br/>(一次性诉请)<br/>tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })]
 ```
 
-### TYPE A：回问诉请（Type A / `TellaskBack` / 回问诉请）
+### TYPE A：回问诉请
 
 **主要语法**：`tellaskBack({ tellaskContent: "..." })`（无 `sessionSlug`）— `tellaskBack({ tellaskContent: "..." }) sessionSlug ...` 是**语法错误**
 
@@ -186,10 +186,15 @@ flowchart TD
 **跨对话传递与标记（强制）**：
 
 - 运行时会生成“跨对话传递正文”作为标准载荷；该正文会进入目标智能体上下文，且 UI 必须与其保持一致。
-- 首行标记由运行时按语义自动注入到该传递正文，智能体不应手写：
-  - 回问诉请回贴：`【tellaskBack】`
-  - 常规支线完成回贴：`【最终完成】`
-  - FBR 回贴：`【FBR-直接回复】` 或 `【FBR-仅推理】`
+- 首行标记由运行时按工作语言和语义自动注入到该传递正文，智能体不应手写：
+  - 中文工作语言：
+    - 回问诉请回贴：`【回问诉请】`
+    - 常规支线完成回贴：`【最终完成】`
+    - FBR 回贴：`【FBR-直接回复】` 或 `【FBR-仅推理】`
+  - 英文工作语言：
+    - 回问诉请回贴：`【TellaskBack】`
+    - 常规支线完成回贴：`【Completed】`
+    - FBR 回贴：`【FBR-Direct Reply】` 或 `【FBR-Reasoning Only】`
 - 源对话的模型原始输出（raw）天然保留在源对话持久记录中；跨对话传递不得改写或覆盖该源 raw。
 - 允许将“某对话的模型原文”拼接进运行时模板后，作为传递到另一对话的正文（即模板化传递是规范路径）。
 
@@ -212,17 +217,17 @@ LLM 发出：tellaskSessionless({ targetAgentId: "orchestrator", tellaskContent:
 - sub-001 恢复，Orchestrator 的响应在上下文中
 ```
 
-### TYPE B：已注册子对话 Tellask（Type B / `Tellask Session` / 长线诉请）
+### TYPE B：已注册子对话诉请（长线诉请）
 
 **语法**：`tellask({ targetAgentId: "<anyAgentId>", sessionSlug: "<tellaskSession>", tellaskContent: "..." })`（注意 `sessionSlug` 前的空格）
 
 **扪心自问 (FBR) 语法**：`freshBootsReasoning({ tellaskContent: "..." })`
 
-- `freshBootsReasoning` 是专用函数工具，不是 Tellask 的特殊 target 别名。
+- `freshBootsReasoning` 是专用函数工具，不是诉请的特殊 target 别名。
 - FBR 不接受 `sessionSlug` 或 `mentionList`。
 - FBR 由更严格的“无工具”策略驱动；详见 [`fbr.zh.md`](./fbr.zh.md)。
 
-**Tellask 会话键模式**：`<tellaskSession>` 使用与 `<mention-id>` 相同的标识符模式：`[a-zA-Z][a-zA-Z0-9_-]*`。解析在空白或标点处停止；任何尾随的标题文本在 tellaskSession 解析时被忽略。
+**诉请会话键模式**：`<tellaskSession>` 使用与 `<mention-id>` 相同的标识符模式：`[a-zA-Z][a-zA-Z0-9_-]*`。解析在空白或标点处停止；任何尾随的标题文本在 tellaskSession 解析时被忽略。
 
 **注册表键**：`agentId!sessionSlug`
 
@@ -237,23 +242,23 @@ LLM 发出：tellaskSessionless({ targetAgentId: "orchestrator", tellaskContent:
 
 **当前调用者跟踪（对复用很重要）：**
 
-当已注册的子对话被再次 Tellask（相同的 `agentId!sessionSlug`）时，调用者可能是**不同的对话**（根对话或其他支线对话）。在每次 TYPE B Tellask 时，子对话的元数据都会更新为：
+当已注册的子对话再次收到诉请（相同的 `agentId!sessionSlug`）时，调用者可能是**不同的对话**（根对话或其他支线对话）。在每次 TYPE B 诉请时，子对话的元数据都会更新为：
 
 - **当前调用者对话 ID**（这样响应就会路由回*最新*的调用者）
-- **Tellask 信息**（标题/正文、来源角色、来源成员、callId）
+- **诉请信息**（标题/正文、来源角色、来源成员、callId）
 
-这使得 TYPE B 子对话可以在多个 Tellask 站点复用，而不会丢失正确的响应路由。
+这使得 TYPE B 子对话可以在多个诉请站点复用，而不会丢失正确的响应路由。
 
-**恢复时的 Tellask 上下文**：
+**恢复时的诉请上下文**：
 
-- 在每次 TYPE B Tellask（新的或恢复的）时，父级提供的 `mentionList`/`tellaskContent`
+- 在每次 TYPE B 诉请（新的或恢复的）时，父级提供的 `mentionList`/`tellaskContent`
   在驱动子对话之前作为新用户消息追加到子对话中。
-  这确保子对话在每次 Tellask 时都能收到最新的请求上下文。
-- 系统注入的恢复提示仅用于上下文，**不会被解析**为队友/工具 Tellask。
+  这确保子对话在每次诉请时都能收到最新的请求上下文。
+- 系统注入的恢复提示仅用于上下文，**不会被解析**为队友诉请或工具调用。
 
 **关键特征**：
 
-- 每次 Tellask 都会执行注册表查找
+- 每次诉请都会执行注册表查找
 - 支持**恢复**先前的子对话
 - 已注册的子对话在正常流程中会保留；若支线被宣布卡死，其条目会从注册表移除
 - 注册表是根对话作用域的（子对话无法访问）
@@ -286,7 +291,7 @@ LLM 再次发出：tellask({ targetAgentId: "researcher", sessionSlug: "market-a
 - orchestrator 恢复
 ```
 
-### TYPE C：瞬态子对话 Tellask（Type C / `Fresh Tellask` / 一次性诉请）
+### TYPE C：瞬态子对话诉请（一次性诉请）
 
 **语法**：`tellaskSessionless({ targetAgentId: "<nonSupdialogAgentId>", tellaskContent: "..." })`（无 `sessionSlug`）
 
@@ -309,7 +314,7 @@ LLM 再次发出：tellask({ targetAgentId: "researcher", sessionSlug: "market-a
 **关键特征**：
 
 - **无注册表查找** - 总是创建新的子对话
-- **不注册** - 在 Tellask 之间不持久化
+- **不注册** - 在各次诉请之间不持久化
 - 子对话本身一般是“完整能力”的；但 `freshBootsReasoning({ tellaskContent: "..." })` FBR 是特例：无工具且禁止任何诉请（见 `fbr.zh.md`）。
 - 与 TYPE B 的唯一区别：无注册表查找/恢复能力
 - 用于一次性的、独立的任务
@@ -324,7 +329,7 @@ LLM 发出：@code-reviewer 请审查这个 PR
 结果：
 - orchestrator 挂起
 - 使用 agentId "code-reviewer" 创建新的子对话
-- 驱动 code-reviewer 子对话（它可以进行自己的 Tellask、工具等）
+- 驱动 code-reviewer 子对话（它可以进行自己的诉请、工具等）
 - code-reviewer 完成并返回审查结果
 - orchestrator 恢复，审查结果在上下文中
 
@@ -339,7 +344,7 @@ LLM 再次发出：@code-reviewer 审查这个其他 PR
 
 ### 对比总结
 
-| 方面            | TYPE A：回问诉请 (`TellaskBack`)         | TYPE B：已注册子对话 Tellask (`Tellask Session`)                                         | TYPE C：瞬态子对话 Tellask (`Fresh Tellask`)                                            |
+| 方面            | TYPE A：回问诉请                         | TYPE B：已注册子对话诉请（长线诉请）                                                     | TYPE C：瞬态子对话诉请（一次性诉请）                                                    |
 | --------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
 | **语法**        | `tellaskBack({ tellaskContent: "..." })` | `tellask({ targetAgentId: "<anyAgentId>", sessionSlug: "<id>", tellaskContent: "..." })` | `tellaskSessionless({ targetAgentId: "<nonSupdialogAgentId>", tellaskContent: "..." })` |
 | **sessionSlug** | 不允许                                   | 必须                                                                                     | 不允许                                                                                  |
@@ -348,7 +353,7 @@ LLM 再次发出：@code-reviewer 审查这个其他 PR
 | **注册**        | 不适用                                   | 创建并注册                                                                               | 永不注册                                                                                |
 | **父级行为**    | 子对话挂起                               | 父级挂起                                                                                 | 父级挂起                                                                                |
 | **子对话能力**  | 完整（上位调用、队友、工具）             | 完整（上位调用、队友、工具）                                                             | 完整（上位调用、队友、工具）                                                            |
-| **用例**        | 从父级澄清（`TellaskBack`）              | 恢复持久子任务（`Tellask Session`）                                                      | 一次性独立任务（`Fresh Tellask`）                                                       |
+| **用例**        | 从父级澄清                               | 恢复持久子任务                                                                           | 一次性独立任务                                                                          |
 
 ---
 
@@ -373,17 +378,17 @@ flowchart TD
 
 ### 关键设计原则
 
-1. **Q4H 索引在 `q4h.yaml` 中**：Q4H 问题被索引在 `q4h.yaml` 中（作为索引，不是真理之源），并由思维清晰操作清除。实际的问题内容在对话的对话消息中，其中记录了 `askHuman({ tellaskContent: "..." })` Tellask。它们不会在 `clear_mind` 中存活。
+1. **Q4H 索引在 `q4h.yaml` 中**：Q4H 问题被索引在 `q4h.yaml` 中（作为索引，不是真理之源），并由思维清晰操作清除。实际的问题内容在对话的对话消息中，其中记录了 `askHuman({ tellaskContent: "..." })` 诉请。它们不会在 `clear_mind` 中存活。
 
 2. **层级 Q4H**：层级中的任何对话都可以自行提出 Q4H（根对话或子对话）。问题被索引在提出问题的对话中，而不是向上传递。
 
 3. **子对话 Q4H 自主性**：子对话可以直接提出 Q4H 问题，而不是作为父级的智能体。用户导航到子对话的对话中以内联回答。
 
-4. **UI 将 Q4H 呈现为队友 Tellask**：UI 类似于其他队友 Tellask 处理 Q4H — 具有导航链接到对话对话中的 Tellask 站点。用户使用与常规消息相同的输入文本区域内联回答。
+4. **UI 将 Q4H 呈现为队友诉请**：UI 类似于其他队友诉请处理 Q4H，具有导航链接到对话中的诉请站点。用户使用与常规消息相同的输入文本区域内联回答。
 
-5. **子对话响应供应**：子对话通过持久化将响应写入*当前 Tellask 者*的上下文（不是回调）。对于 TYPE B，每次 Tellask 都会用最新的 Tellask 者 + tellaskInfo 更新子对话的 `assignmentFromSup`，因此响应被路由到最近的 Tellask 者（根或子对话）。这支持分离操作、复用和崩溃恢复。
+5. **子对话响应供应**：子对话通过持久化将响应写入*当前诉请者*的上下文（不是回调）。对于 TYPE B，每次诉请都会用最新的诉请者 + tellaskInfo 更新子对话的 `assignmentFromSup`，因此响应被路由到最近的诉请者（根或子对话）。这支持分离操作、复用和崩溃恢复。
 
-6. **子对话注册表**：已注册的子对话（TYPE B Tellask）在根对话作用域的注册表中跟踪。注册表在 `clear_mind` 操作中持续存在，并在根加载时重建。
+6. **子对话注册表**：已注册的子对话（TYPE B 长线诉请）在根对话作用域的注册表中跟踪。注册表在 `clear_mind` 操作中持续存在，并在根加载时重建。
 
 7. **状态保留契约**：
    - `clear_mind`：清除消息，清除 Q4H 索引，保留提醒，保留注册表
@@ -405,7 +410,7 @@ Q4H（向人类提问）是对话可以暂停执行并请求人工输入的机
 /**
  * HumanQuestion - 索引条目持久化在每个对话的 q4h.yaml 中
  * 注意：这是索引，不是真理之源。实际的 question
- * 内容在对话的对话消息中，其中记录了 askHuman() Tellask
+ * 内容在对话的对话消息中，其中记录了 askHuman() 诉请
  *（通过 askHuman({ tellaskContent: "..." }) 调用）。
  */
 interface HumanQuestion {
@@ -418,7 +423,7 @@ interface HumanQuestion {
 
 **存储位置**：`<dialog-path>/q4h.yaml` - 作为快速查找的索引
 
-**真理之源**：实际的 `askHuman({ tellaskContent: "..." })` Tellask 存储在对话的对话消息中（course JSONL 文件），即提出问题的地方。
+**真理之源**：实际的 `askHuman({ tellaskContent: "..." })` 诉请存储在对话的对话消息中（course JSONL 文件），即提出问题的地方。
 
 ### Q4H 机制流程
 
@@ -458,7 +463,7 @@ askHuman({ tellaskContent: '<问题标题>\n<问题正文内容>' });
 ### Q4H 记录过程
 
 ```typescript
-// 当检测到 askHuman({ tellaskContent: "..." }) 作为队友 Tellask 时
+// 当检测到 askHuman({ tellaskContent: "..." }) 作为队友诉请时
 async function recordQuestionForHuman(
   dlg: Dialog,
   mentionList: string,
@@ -508,8 +513,8 @@ postDialogEvent(dialog, questionsCountUpdateEvt);
 1. 接收 `questions_count_update` 事件
 2. 读取 `q4h.yaml` 获取问题索引条目
 3. 在对话上显示 Q4H 指示器/徽章
-4. 问题链接到对话中它们的 Tellask 站点
-5. 用户点击链接导航到 Tellask 站点，内联回答
+4. 问题链接到对话中它们的诉请站点
+5. 用户点击链接导航到诉请站点，内联回答
 
 ### 用户如何回答 Q4H（智能体拉取模型）
 
@@ -532,7 +537,7 @@ interface DriveDialogByUserAnswerRequest {
 **流程（智能体拉取模型）**：
 
 1. 用户在 UI 中看到 Q4H 指示器/徽章
-2. 用户点击面板/列表中的 Q4H，导航到 `askHuman()` Tellask 站点
+2. 用户点击面板/列表中的 Q4H，导航到 `askHuman()` 诉请站点
 3. 用户在输入文本区域中输入答案（与常规消息相同）
 4. 前端发送 `drive_dialog_by_user_answer` 数据包
 5. 后端根据 q4h.yaml 验证 `questionId`
@@ -710,7 +715,7 @@ async function checkSubdialogRevival(supdialog: Dialog): Promise<void> {
 - **清除所有 Q4H 问题**（关键！）
 - 保留子对话注册表（仅限根对话）
 - 对上位对话没有影响
-- 将注意力重定向到 Taskdoc
+- 将注意力重定向到差遣牒
 - 系统生成的“开启新一程对话”提示已排队，作为新一程的首个 role=user 消息
 - 开启新一程对话
 
@@ -718,12 +723,12 @@ async function checkSubdialogRevival(supdialog: Dialog): Promise<void> {
 
 - 操作仅作用于当前对话
 - 子对话不受父级 `clear_mind` 的影响
-- Taskdoc 保持不变且可访问
+- 差遣牒保持不变且可访问
 - 提醒在清晰操作中提供连续性
 
 ### `change_mind`
 
-**目的**：更新对话树中所有对话引用的共享 Taskdoc 内容（不开启新一程对话）。把 Taskdoc 当作任务的**实时协调公告板**。
+**目的**：更新对话树中所有对话引用的共享差遣牒内容（不开启新一程对话）。把差遣牒当作任务的**实时协调公告板**。
 
 **函数工具参数**：
 
@@ -738,18 +743,18 @@ async function checkSubdialogRevival(supdialog: Dialog): Promise<void> {
 
 **行为**：
 
-- 更新 rtws（运行时工作区）Taskdoc 内容（`*.tsk/` Taskdoc 包中恰好一个章节文件）
-- **不更改 Taskdoc 路径。** `dlg.taskDocPath` 在对话的整个生命周期中是不可变的。
+- 更新 rtws（运行时工作区）差遣牒内容（`*.tsk/` 任务包中恰好一个章节文件）
+- **不更改差遣牒路径。** `dlg.taskDocPath` 在对话的整个生命周期中是不可变的。
 - 更新的文件立即对引用它的所有对话可用
 - **不开启新一程对话。** 如需开启新一程对话，请单独使用 `clear_mind`。
 - 本身不清除消息、提醒、Q4H 或注册表
-- 影响引用相同 Taskdoc 的所有参与智能体（主对话和子对话）
+- 影响引用相同差遣牒的所有参与智能体（主对话和子对话）
 - 关键决策/当前状态/下一步写回 `progress`；硬约束写回 `constraints`（不要只留在对话/提醒项里）。
 
 **实现说明**：
 
-- `change_mind` 仅在根对话中可用（不在子对话中）；子对话必须通过回问诉请（`tellaskBack({ tellaskContent: "..." })`）询问诉请者以更新共享 Taskdoc。
-- 对于 `*.tsk/` Taskdoc 包，Taskdoc 是封装的：通用文件工具不得读取/写入/列出/删除 `*.tsk/` 下的任何内容。请参阅 [`encapsulated-taskdoc.zh.md`](./encapsulated-taskdoc.zh.md)。
+- `change_mind` 仅在根对话中可用（不在子对话中）；子对话必须通过回问诉请（`tellaskBack({ tellaskContent: "..." })`）询问诉请者以更新共享差遣牒。
+- 对于 `*.tsk/` 差遣牒任务包，差遣牒是封装的：通用文件工具不得读取/写入/列出/删除 `*.tsk/` 下的任何内容。请参阅 [`encapsulated-taskdoc.zh.md`](./encapsulated-taskdoc.zh.md)。
 
 ---
 
@@ -781,7 +786,7 @@ async function checkSubdialogRevival(supdialog: Dialog): Promise<void> {
 
 ### 概述
 
-**子对话注册表** 是根对话作用域的数据结构，维护通过 TYPE B（已注册子对话 Tellask / `Tellask Session`）队友 Tellask 创建的已注册子对话的持久引用。
+**子对话注册表** 是根对话作用域的数据结构，维护通过 TYPE B（已注册子对话诉请 / 长线诉请）创建的已注册子对话的持久引用。
 
 ### 关键特征
 
@@ -809,7 +814,7 @@ researcher!market-analysis:
 
 ```mermaid
 flowchart TD
-  Tellask[TYPE B Tellask: tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })] --> Key[计算键：agentId!sessionSlug]
+  Tellask[TYPE B 长线诉请: tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })] --> Key[计算键：agentId!sessionSlug]
   Key --> Lookup{注册表命中？}
   Lookup -- 是 --> Resume[恢复 + 驱动现有子对话]
   Lookup -- 否 --> Create[创建 + 注册 + 驱动新的子对话]
@@ -849,9 +854,9 @@ interface SubdialogRegistry {
   [key: string]: {
     subdialogId: string; // 子对话的 UUID
     agentId: string; // 智能体标识符
-    tellaskSession: string; // Tellask 会话键
+    tellaskSession: string; // 诉请会话键
     createdAt: string; // ISO 时间戳
-    lastAccessed?: string; // ISO 时间戳（在每次 Tellask 时更新）
+    lastAccessed?: string; // ISO 时间戳（在每次诉请时更新）
     locked: boolean; // 互斥锁状态 - 现在有人正在驱动这个吗？
   };
 }
@@ -880,7 +885,7 @@ interface SubdialogRegistry {
 - **清理头脑操作**：`startNewRound(newRoundPrompt)` 方法（清除消息，清除 Q4H，开启新一程对话，为下一轮驱动排队开启提示）
 - **子对话管理**：专门子任务的创建和协调
 - **Q4H 管理**：用于问题跟踪的 `updateQuestions4Human()` 方法
-- **内存访问**：与 Taskdoc 和团队/智能体内存的集成
+- **内存访问**：与差遣牒和团队/智能体内存的集成
 - **注册表管理**（仅限 RootDialog）：子对话的注册和查找
 
 ### 主对话解析
@@ -938,8 +943,8 @@ interface RegistryMethods {
 
 **上下文继承**：新的子对话自动接收：
 
-- 对相同 rtws（运行时工作区）Taskdoc 的引用（推荐：`tasks/feature-auth.tsk/`）；`dlg.taskDocPath` 在对话创建时固定，永不重新分配
-- 诉请者对话 Tellask 上下文（mentionList + tellaskContent）解释其目的
+- 对相同 rtws（运行时工作区）差遣牒的引用（推荐：`tasks/feature-auth.tsk/`）；`dlg.taskDocPath` 在对话创建时固定，永不重新分配
+- 诉请者对话的诉请上下文（mentionList + tellaskContent）解释其目的
 - 访问共享团队内存
 - 访问其智能体的个人内存
 
@@ -947,7 +952,7 @@ interface RegistryMethods {
 
 **导航**：每个子对话都保持对其父级的引用，向上遍历到主对话。
 
-**注册表**：已注册的子对话（TYPE B Tellask）在根对话的注册表中跟踪，并在重启后持久化；若子对话被宣布卡死，其条目会被裁剪，不再参与后续同 slug 复用。
+**注册表**：已注册的子对话（TYPE B 长线诉请）在根对话的注册表中跟踪，并在重启后持久化；若子对话被宣布卡死，其条目会被裁剪，不再参与后续同 slug 复用。
 
 ### Root dialog fork（根对话分叉）
 
@@ -974,7 +979,7 @@ interface RegistryMethods {
 
 **一致性要求**：
 
-- fork 必须保留同一 Taskdoc 引用
+- fork 必须保留同一差遣牒引用
 - fork 后的 root/subdialog 都落到 `running/`，并拥有新的 rootId
 - 前端不得对 sideline dialog 暴露该入口；当前实现仅支持 fork root dialog
 
@@ -1011,17 +1016,17 @@ interface RegistryMethods {
 
 **向上通信**：子对话向诉请者对话通信结果、问题和升级。
 
-- **澄清请求（TYPE A / `TellaskBack`）**：子对话在处理其子任务时可能向诉请者对话 Tellask 以请求澄清。TYPE A 中诉请者对话为直接上位对话。诉请者对话提供指导，子对话在新上下文中继续。
-- **子任务响应**：当子对话产生最终的 "saying" 内容块（没有待处理的 Q4H）时，该消息被视为对**当前调用者**的响应，记录在 `assignmentFromSup` 中（根或另一个子对话）。这使响应与最新的 Tellask 站点保持一致。
+- **澄清请求（TYPE A / 回问诉请）**：子对话在处理其子任务时可能向诉请者对话发起诉请以请求澄清。TYPE A 中诉请者对话为直接上位对话。诉请者对话提供指导，子对话在新上下文中继续。
+- **子任务响应**：当子对话产生最终的 "saying" 内容块（没有待处理的 Q4H）时，该消息被视为对**当前调用者**的响应，记录在 `assignmentFromSup` 中（根或另一个子对话）。这使响应与最新的诉请站点保持一致。
 - **Q4H 升级**：如果子对话有 Q4H，它会暂停。用户可以通过 UI 回答，这只会触发子对话的继续。
-- **已注册的子对话（TYPE B / `Tellask Session`）**：父级可以恢复先前创建的已注册子对话，实现持续的任务继续。
-- **瞬态子对话（TYPE C / `Fresh Tellask`）**：父级可以生成一次性子对话用于不需要持久化的独立任务。
+- **已注册的子对话（TYPE B / 长线诉请）**：父级可以恢复先前创建的已注册子对话，实现持续的任务继续。
+- **瞬态子对话（TYPE C / 一次性诉请）**：父级可以生成一次性子对话用于不需要持久化的独立任务。
 
 **向下通信**：上位对话向子对话提供上下文、目标和指导。
 
 **横向通信**：兄弟子对话通过共享上位对话进行协调。
 
-**广播通信**：主对话（根对话）可以通过 Taskdoc 引用将更改（如 rtws Taskdoc 文件更新）传达给所有对话。
+**广播通信**：主对话（根对话）可以通过差遣牒引用将更改（如 rtws 差遣牒文件更新）传达给所有对话。
 
 ---
 
@@ -1047,7 +1052,7 @@ interface RegistryMethods {
 
 ### 内存同步
 
-**Taskdoc 传播**：对 rtws Taskdoc 文件的更改对引用它的所有对话立即可见。
+**差遣牒传播**：对 rtws 差遣牒文件的更改对引用它的所有对话立即可见。
 
 **内存更新**：团队和智能体内存异步更新，最终在所有对话中保持一致。
 
@@ -1072,7 +1077,7 @@ interface RegistryMethods {
 - `<dialog-root>/subdialogs/<subdialog-id>/dialog.yaml`
 - `<dialog-root>/subdialogs/<subdialog-id>/q4h.yaml` — 每个子对话的 Q4H 索引（被清晰清除）
 
-**Taskdoc 存储**：Taskdoc 是对话通过路径引用的 rtws 产物。Taskdoc 必须是封装的 `*.tsk/` Taskdoc 包。
+**差遣牒存储**：差遣牒是对话通过路径引用的 rtws 产物。差遣牒必须是封装的 `*.tsk/` 任务包。
 
 **内存存储**：团队和智能体内存存储在 rtws 内的专用文件中。
 **注册表存储**：子对话注册表（`registry.yaml`）存储在根对话目录中，并在根完成时移动到 `done/`。
@@ -1110,13 +1115,13 @@ Dominds 内部持久化的消息粒度较细（thinking/saying/tool call/tool re
 
 **上下文感知**：智能体可以完全访问其对话上下文、内存、层级位置、来自子对话的待处理 Q4H，以及（对于根对话）子对话注册表。
 
-**队友 Tellask 能力**：智能体可以调用所有三种类型的队友 Tellask：
+**队友诉请能力**：智能体可以调用所有三种类型的队友诉请：
 
-- TYPE A / `TellaskBack`：向上位对话 Tellask 以请求澄清
-- TYPE B / `Tellask Session`：Tellask/恢复已注册的子对话
-- TYPE C / `Fresh Tellask`：生成瞬态子对话
+- TYPE A / 回问诉请：向上位对话发起诉请以请求澄清
+- TYPE B / 长线诉请：诉请或恢复已注册的子对话
+- TYPE C / 一次性诉请：生成瞬态子对话
 
-**工具访问**：所有思维清晰工具、Q4H 能力和队友 Tellask 工具都可用于智能体进行自主认知管理。
+**工具访问**：所有思维清晰工具、Q4H 能力和队友诉请工具都可用于智能体进行自主认知管理。
 
 ### 对话状态机
 
@@ -1152,11 +1157,11 @@ flowchart TD
   E -- 否 --> I
 ```
 
-### 队友 Tellask 状态转换
+### 队友诉请状态转换
 
 这些图表专注于**控制流**，避免框图对齐，以便在不同的markdown查看器中呈现时保持可读性。
 
-#### TYPE A：回问诉请（`TellaskBack`）（`tellaskBack({ tellaskContent: "..." })`，无 `sessionSlug`）
+#### TYPE A：回问诉请（`tellaskBack({ tellaskContent: "..." })`，无 `sessionSlug`）
 
 ```mermaid
 sequenceDiagram
@@ -1170,7 +1175,7 @@ sequenceDiagram
   Driver-->>Sub: 恢复子对话，响应在上下文中
 ```
 
-#### TYPE B：已注册子对话 Tellask（`Tellask Session`）（`tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })`）
+#### TYPE B：已注册子对话诉请（长线诉请）（`tellask({ targetAgentId: "agentId", sessionSlug: "tellaskSession", tellaskContent: "..." })`）
 
 ```mermaid
 sequenceDiagram
@@ -1198,7 +1203,7 @@ end
 
 ````
 
-#### TYPE C：瞬态子对话 Tellask（`Fresh Tellask`）（`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`，或 `freshBootsReasoning({ tellaskContent: "..." })`）
+#### TYPE C：瞬态子对话诉请（一次性诉请）（`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`，或 `freshBootsReasoning({ tellaskContent: "..." })`）
 
 ```mermaid
 sequenceDiagram
@@ -1217,7 +1222,7 @@ sequenceDiagram
 
 ```mermaid
 flowchart TD
-  A[askHuman({ tellaskContent: "..." }) Tellask 发出] --> B[将 HumanQuestion 条目追加到 q4h.yaml]
+  A[askHuman({ tellaskContent: "..." }) 诉请发出] --> B[将 HumanQuestion 条目追加到 q4h.yaml]
   B --> C[发出 questions_count_update]
   C --> D[UI 显示 Q4H 徽章/列表]
   D --> E{如何清除？}
@@ -1321,7 +1326,7 @@ sequenceDiagram
   Sub-->>Sup: supply response（恢复根对话）
 ```
 
-### 3. 已注册子对话 Tellask（TYPE B / `Tellask Session` / 长线诉请）
+### 3. 已注册子对话诉请（TYPE B / 长线诉请）
 
 ```mermaid
 sequenceDiagram
@@ -1351,7 +1356,7 @@ sequenceDiagram
 | 提醒项   | 保留                            |
 | 注册表   | 保留                            |
 
-`change_mind` 不是清晰度操作；它就地更新差遣牒（Taskdoc）内容，不会清除消息/Q4H/提醒项/注册表。
+`change_mind` 不是清晰度操作；它就地更新差遣牒内容，不会清除消息/Q4H/提醒项/注册表。
 
 ---
 
@@ -1381,7 +1386,7 @@ sequenceDiagram
 
 **健康检查**：定期验证对话层次结构完整性、Q4H 持久化、注册表一致性和内存。
 
-**调试支持**：全面的日志记录和检查工具，用于排查队友 Tellasks、注册表操作和 Q4H 流程。
+**调试支持**：全面的日志记录和检查工具，用于排查队友诉请、注册表操作和 Q4H 流程。
 
 ---
 
@@ -1399,18 +1404,18 @@ Dominds 对话系统为层次化、人在回路的 AI 协作提供了一个强
 | **提醒项**       | 持久化工作内存   | 是           | N/A                                       |
 | **子对话注册表** | 已注册子对话跟踪 | 是           | `declare_subdialog_dead` 时裁剪 dead 条目 |
 
-### 三种队友 Tellask 类型
+### 三种队友诉请类型
 
-| 类型（内部） | 用户可见术语      | 语法                                                                                | 注册表                | 用例             |
-| ------------ | ----------------- | ----------------------------------------------------------------------------------- | --------------------- | ---------------- |
-| TYPE A       | `TellaskBack`     | `tellaskBack({ tellaskContent: "..." })`                                            | 无注册表              | 澄清（询问来源） |
-| TYPE B       | `Tellask Session` | `tellask({ targetAgentId: "agentId", sessionSlug: "<id>", tellaskContent: "..." })` | `agentId!sessionSlug` | 可恢复多轮工作   |
-| TYPE C       | `Fresh Tellask`   | `tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`           | 未注册                | 单次 / 不可恢复  |
+| 类型（内部） | 用户可见术语 | 语法                                                                                | 注册表                | 用例             |
+| ------------ | ------------ | ----------------------------------------------------------------------------------- | --------------------- | ---------------- |
+| TYPE A       | 回问诉请     | `tellaskBack({ tellaskContent: "..." })`                                            | 无注册表              | 澄清（询问来源） |
+| TYPE B       | 长线诉请     | `tellask({ targetAgentId: "agentId", sessionSlug: "<id>", tellaskContent: "..." })` | `agentId!sessionSlug` | 可恢复多轮工作   |
+| TYPE C       | 一次性诉请   | `tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`           | 未注册                | 单次 / 不可恢复  |
 
 ### 类职责
 
-- **根对话**：管理注册表，可以发起所有三种队友 Tellask 类型
-- **子对话**：拥有父对话引用，可以直接发起 TYPE A 和 TYPE C；TYPE B 通过根注册表路由，并在每次 Tellask 时更新调用者上下文
+- **根对话**：管理注册表，可以发起所有三种队友诉请类型
+- **子对话**：拥有父对话引用，可以直接发起 TYPE A 和 TYPE C；TYPE B 通过根注册表路由，并在每次诉请时更新调用者上下文
 
 ### 持久化保证
 

package/dist/docs/encapsulated-taskdoc.md

@@ -143,23 +143,7 @@ The system prompt and any tool documentation shown to agents MUST make the follo
 
 Below is the canonical copy. If you need to rephrase it for UI layout, you MUST preserve the semantics.
 
-#### Canonical copy (zh; semantic baseline)
-
-**Taskdoc 封装与访问限制**
-
-- 任何 `.tsk/` 目录及其子路径（`**/*.tsk/**`）都是封装状态：禁止使用任何通用文件工具读取/写入/列目录（例如 `read_file` / `write_file` / `list_dir` 等）。
-- 更新 Taskdoc 只能使用函数工具 `change_mind`（按章节整段替换；顶层用 `selector`，额外章节用 `category + selector`）。
-- 读取“不会自动注入上下文”的额外章节，只能使用函数工具 `recall_taskdoc({ category, selector })`。
-
-**Taskdoc 自动注入规则（系统提示）**
-
-- 系统提示会把“有效 Taskdoc”自动注入到模型上下文中。
-- 一定会注入顶层三段：`goals.md`、`constraints.md`、`progress.md`（按此顺序）。
-- 可选注入 `bearinmind/`（仅固定白名单，最多 6 个文件）：`contracts.md`、`acceptance.md`、`grants.md`、`runbook.md`、`decisions.md`、`risks.md`。
-- 若存在 `bearinmind/` 注入块，它会以 `## Bear In Mind` 出现在 `## Constraints` 与 `## Progress` 之间，并按以上固定顺序拼接。
-- 除此之外，`.tsk/` 内任何其他目录/文件都不会被自动注入正文（系统只会注入一个“额外章节索引”用于提示；需要时用 `recall_taskdoc` 显式读取）。
-
-#### Reference copy (en; must match zh)
+#### Canonical copy (en; semantic baseline)
 
 **Taskdoc encapsulation & access restrictions**
 
@@ -175,6 +159,10 @@ Below is the canonical copy. If you need to rephrase it for UI layout, you MUST
 - If present, the injected block appears as `## Bear In Mind` between `## Constraints` and `## Progress`, and the files are concatenated in the fixed order above.
 - No other directories/files inside `.tsk/` are auto-injected as body content (only an “extra sections index” may be injected for discoverability; use `recall_taskdoc` when needed).
 
+#### Chinese reference
+
+See [the Chinese doc](./encapsulated-taskdoc.zh.md) for the matching Simplified Chinese copy.
+
 Notes:
 
 - The effective Taskdoc MUST be deterministic (no hidden reformatting beyond the above framing).