# 文档

README 负责「这是什么、怎么装、能做什么」；这里的四份各自深入一层。

| 文档 | 回答的问题 | 给谁看 |
| --- | --- | --- |
| [为什么做常驻实体](why-bot.md) | 为什么不把上下文做长，而要把它搬到会话外面 | 想判断这个设计值不值得的人 |
| [用户指南](user-guide.md) | 装上之后怎么用：建实例、调记忆、派任务、批审批、配连接 | 使用者 |
| [工具参考](tool-reference.md) | 7 个 `bot_*` 工具的参数、输出、边界 | 写提示词或做集成的人 |
| [架构说明](architecture.md) | store / 执行器 / 记忆分层 / 工作区判定 / 审批闸门怎么分工 | 要改代码或判断可靠性的人 |
| [功能对照](feature-matrix.md) | 对照 2026 主流助理调研：实现了什么、还缺什么 | 评估完整度的人 |

## README 与这些文档的分工

README 只保留**能做决定的长度**：一段定位、一张安装命令、一张功能表、一张工具表、一份限制清单。凡是需要展开论证的（为什么这样设计、为什么不做某个功能、某个边界为什么在那里），都在这里。

**功能对照**那份是机器生成的判据：它逐条到代码里查符号，不凭记忆。改完代码跑一次就能看回归：

```sh
node scripts/audit-against-research.mjs
```