# control 对话控制工具手册

## 模板（概述）

### 一句话定位

- <该工具集用途，一句话描述>

### 工具清单

- <列出核心工具，或指向工具章节>

### 30 秒上手

1. <调用 ...>
2. <观察 ...>
3. <下一步 ...>

### 导航

- principles / tools / scenarios / errors

### 与其他工具集的边界

- <何时用本工具集、何时用相邻工具集>

control 是 Dominds 的**对话控制工具集**，用于管理对话状态、提醒、差遣牒，以及跨对话回复收口语义：

- **提醒管理**：提醒分 `dialog` / `task` / `agent` 三个 scope；默认是 `task`，用于同一差遣牒任务下的手头工作；`dialog` 只用于真正对话局部的提醒；`agent` 只用于紧急、短期、全局刺眼提醒
- **差遣牒操作**：追加、替换或删除任务契约章节（goals/constraints/progress）；其中 `progress` 是全队共享、准实时、可扫读的任务公告牌
- **上下文维护**：在不丢关键恢复线索的前提下降低认知负载
- **回复路由**：在支线/回问语境下，区分回问诉请者、发送最终回贴与普通文本的职责边界

## 快速导航

| 主题                          | 描述                                                   |
| ----------------------------- | ------------------------------------------------------ |
| [principles](./principles.md) | 核心概念、提醒生命周期、差遣牒结构、reply 路由心智模型 |
| [tools](./tools.md)           | 使用指导、边界说明与 reply 速查表                      |
| [scenarios](./scenarios.md)   | 常见使用场景与示例（复制即用）                         |
| [errors](./errors.md)         | 错误代码与解决方案                                     |

## 状态

- 状态：已实现
- 主要实现文件：
  - 工具实现：`dominds/main/tools/ctrl.ts`
  - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`

## 核心概念

### 提醒（Reminder）

提醒是临时手头工作提示，用于：

- 标记待处理事项
- 追踪当前下一步/阻塞
- 记录阻塞问题
- 在 `clear_mind` 前承载接续包；若 Dominds 已提醒当前程吃紧/告急，可先带多条粗略提醒项过桥

提醒不用于手工复制 Dominds 会自动维护的系统状态，例如后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等。这些状态以 Dominds 自动维护的提醒、面板和工具输出为准；手工记录很容易过时并造成认知干扰。

scope 规则：

- `dialog`：当前对话手头工作
- `task`：当前差遣牒任务下的手头工作，默认范围
- `agent`：在所有由你主理的后续对话里也应继续看到的紧急、短期、全局刺眼提醒

### 差遣牒

差遣牒是**任务契约**，包含：

- **goals**：任务目标
- **constraints**：约束条件
- **progress**：面向全队同步的准实时任务公告牌 / 当前有效状态快照
