Skip to content

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Add the Bot runtime design to docs/plans

Fei2411dbf8998de9ae
diff --git a/docs/plans/2026-10-10-bot-runtime.md b/docs/plans/2026-10-10-bot-runtime.md
new file mode 100644
index 00000000..1c4c26eb
--- /dev/null
+++ b/docs/plans/2026-10-10-bot-runtime.md
@@ -0,0 +1,76 @@
+# Bot 运行配置:预设、模型、思考强度、工作文件夹、能力
+
+- 日期:2026-10-10 定预设和能力包,之后陆续补充
+- 相关:#99(思考强度)、#159(换模型不生效)、#208、#209(工作文件夹)
+- 代码:`ds-bot/src/host/roster.js`、`models.js`、`folders.js`、`capabilities.js`、`permissions.js`,建 Bot 表单在 `src/client/bot-draft.js`
+
+权限预设(只读 / 工作区内修改 / 完全权限)和群的统一权限见[角色与权限](2026-10-07-roles-and-permissions.md),这里不重复。
+
+## 为什么
+
+每个 Bot 是一个独立工作的身份,它跑在什么 harness 上、用哪个模型、在哪个文件夹干活,都应该属于这个 Bot 自己,不随用户在 DSH 里的其他设置变化。否则用户在 DSH 里换了「新任务默认」或默认模型,整个团队就跟着变了。
+
+同时 DSH 的标准 harness 已经足够好,没必要预置一堆分工 Bot 或改造 harness。专门的能力(写代码、做调研)做成可以叠加到任何 Bot 上的能力包。
+
+## 已定的行为
+
+### Agent 预设
+
+- 只有一个 Bot 预设:DS Bot 的 Bot 内核加 DSH 的标准 harness(`standard`),不改造。
+- 这个预设归 DS Bot 所有:新建的 Bot 会话、群会话和对话分段都显式用 `standard`,**不跟随**用户在 DSH 里设的「新任务默认」。DSH 里没有可用的 `standard` 时,才交给 DSH 决定。
+- Bot 的工具只挂在 Bot 的作用域里,不出现在普通 DSH 会话中。
+- 以前在 PTC 预设下建的群会话只能调用 `run_code`,DS Bot 为它们单独处理群的接力;新的群会话都用标准预设(#37、#168)。
+
+### 模型
+
+- 每个 Bot 有**自己的一个模型**,建 Bot 时确定,之后只在 Bot 设置里改,或者由 Main Bot 改。DSH 默认模型以后再变,已有的 Bot 不受影响。
+- 选择保存在 Bot 的 Session 上。DSH 的 `selectModel` 会顺手把选择写成 profile 的默认模型,所以 DS Bot 每次选完都把用户原来的默认写回去。选择一次只做一个,并等写回完成。
+- 新 Bot 的模型从哪里来:
+ - 建 Bot 表单:预选 DSH 的默认模型(还在服务中时),否则选列表里的第一个。用户可以改。
+ - Main Bot 用 `create_bot` 且没有指定模型:用创建者自己的模型(还在服务中时)。
+ - 团队的**第一个 Main Bot** 没有模型,等用户在它的聊天里选好再打招呼。
+- 一个 Bot 的模型不再被服务时:先回到它上次实际用过的模型,再回到 DSH 默认。
+- 后注册的提供方:等它注册后再给对应的 Bot 选模型,打招呼也等模型可用,不会报「no adapter registered」。
+- 模型列表可能在 DSH 设置里悄悄变化,所以选择器打开前会重新取一次。
+
+### 思考强度
+
+- 每个 Bot 可以设一个思考强度,在建 Bot 表单和 Bot 详情里设。
+- 只有当前模型提供的强度才会发出去;模型没有这一档就用模型自己的默认。提供方不认识的强度会被直接拒绝,所以绝不硬发。
+- 换模型、新开一段都保留这个设置。
+
+### 工作文件夹
+
+- 一个 Bot 在哪里干活:群设了文件夹,群里的成员都用群的;否则用 Bot 自己的;都没设就用团队工作区。
+- Session 的文件夹在创建时就固定了,所以改文件夹会让对话换到新的一段(见[上下文与记忆](2026-10-09-context-and-memory.md))。
+- 不能设成 DSH 或团队存数据的文件夹,也不能设成包含它们的文件夹:能写那里的 Bot 就能改自己的权限或整个团队。
+- 设到团队工作区以外,等于扩大了 Bot 能写的范围。所以如果 Bot 要给「写入受文件夹限制」的 Bot 设这样的文件夹,要先请用户批准。
+- 保存的是真实路径,和 Session 的 cwd 显示一致。
+- Bot 可以按用户的一句话给自己设文件夹(`update_bot`),规则同上。
+
+### 能力
+
+- 设置 → Capabilities 是团队共享的列表,有三种:MCP 服务、技能、能力包(若干 MCP 和技能的组合)。
+- 能力只能**做加法**:加工具、技能、MCP、提示词段。只能有一个取值的设置(工具的呈现方式、persona、压缩引擎)不放进能力包,它们属于 Bot 级设置。
+- 给一个 Bot 启用后,从它下一条消息开始生效,也适用于它参与的群聊。
+- Bot 添加的本地 MCP 命令要用户批准后才能运行。有其他 Bot 在用的能力,只有用户或 Main Bot 能改、能删;不是 Main Bot 的创建者不能改写 Main Bot 在用的能力。
+- MCP 配置里需要的密钥写成 `$DSH_SECRET_<名字>`,值从密钥库取,不写进配置。
+- 名字只用小写字母、数字和单个连字符,最长 32 个字符;`github` 留给内置的 GitHub 连接器。
+
+## 不做什么
+
+- 不预置分工 Bot(写手、程序员……)。只有一个默认 Bot,分工由用户和 Main Bot 来建。
+- 不改造 DSH 的标准 harness。
+- 不让 Bot 跟随用户在 DSH 里的「新任务默认」预设或默认模型。
+
+## 已知限制
+
+- **新 Bot 可能落到没配好密钥的模型上**:DSH 不告诉插件哪个提供方已经配好了凭据,「在模型列表里」不等于「能用」。建 Bot 表单预选 DSH 默认,而 DS Bot 每次都会把默认写回原值,所以这个默认可能一直停在出厂值。新 Bot 的第一次回复就可能报缺少凭据。怎么根治待维护者定(方向:只自动选有证据能用的模型,没有证据就问用户;凭据失败时回到选模型,而不是报错)。
+- `create_bot` 和 `update_bot` 还不能设思考强度,只能在界面上设(#99)。
+- DSH 0.2.1-alpha 上,工作文件夹被删或改名后,消息会被吞掉、不会退回团队工作区(#209)。
+- 能力包「coding」「research」的具体组成还没定。
+
+## 变更
+
+- 2026-10-10:Bot 预设归 DS Bot 所有;不预置分工 Bot;能力包只做加法。
+- 2026-10-14:新的 Bot 会话、群会话和分段显式用 `standard`,修好 PTC 预设下群聊不接力(#37)。
diff --git a/docs/plans/README.md b/docs/plans/README.md
index 84f18f11..5f59be57 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -39,3 +39,4 @@
| [DSH 让步总账](2026-10-13-dsh-concessions.md) | 因 DSH 本身的限制而做的妥协,以及桌面应用之后怎么处理。判断「是 DS Bot 的 bug 还是 DSH 的限制」先看这里 |
| [角色与权限](2026-10-07-roles-and-permissions.md) | 用户、Main Bot、群管理员、普通 Bot 各能做什么;Bot 的权限预设和群的统一权限 |
| [群聊](2026-10-07-group-chat.md) | 谁来回答、按顺序发言、@ 提及、轮数上限、干活中的进度和迟到的回复、审批 |
+| [Bot 运行配置](2026-10-10-bot-runtime.md) | Agent 预设、每个 Bot 的模型和思考强度、工作文件夹、能力(MCP、技能、能力包) |