A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
docs/plans:已定的设计
这里收录 DS Bot 已经定下的设计:为什么这样做、已定的行为、不做什么、已知限制。拿不准一个现象是 bug 还是设计如此时,先查这里和 愿景;这里没写的,在 Issue 里问。
设计文档用中文写。
什么时候写
- 大功能:在同一个 Pull Request 里附一份
docs/plans/<日期>-<主题>.md,和代码一起审、一起合。 - 改动已定的设计:先在 Issue 里和维护者确认(带
maintainer标签),合并时同步改对应的文档。 - 修 bug:不用写。
格式
# 标题
- 日期:设计定下的日期(之后的修改在文末「变更」里追加)
- 相关:Issue / PR 编号
## 为什么
要解决的问题,以及当时的取舍。
## 已定的行为
可以验证的规则。写现在的行为,不写过程。
## 不做什么
## 已知限制
## 变更
- 日期:改了什么,对应的 PR。
目录
| 文档 | 内容 |
|---|---|
| DSH 让步总账 | 因 DSH 本身的限制而做的妥协,以及桌面应用之后怎么处理。判断「是 DS Bot 的 bug 还是 DSH 的限制」先看这里 |
| 角色与权限 | 用户、Main Bot、群管理员、普通 Bot 各能做什么;Bot 的权限预设和群的统一权限 |
| 隐私 Bot | 只有用户能开关;其他 Bot 读不到它的文件夹、记忆和会话,外发由用户批准;独立文件夹、删除后的保护和隔离边界 |
| 群聊 | 谁来回答、同时开工与按顺序发言、@ 提及、派活批次、干活中的进度和迟到的回复、审批与全部停止 |
| 群聊 Goal | 管理员先对齐再写 Goal;分阶段派给成员、每阶段带证据验收;每轮带 Goal 账本防跑偏;空闲时自动推进;暂停、纠偏、终止;会话头胶囊和吊舱显示进度与分工 |
| 浏览器、搜索、密钥和连接器 | 每个 Bot 的浏览器和 read_browser、auto 联网搜索、密钥卡和替换规则、GitHub 连接器(已被 2026-11-04 通用连接器取代) |
| 浏览器插件 | 全团队一个浏览器后端,每个 Bot 一份 profile;refs / script / task |
| 电脑操控 | 设置里的总开关和 DSH 提供方;每个 Bot 四档(关 / 只看 / 后台操作 / 可以动前台);按 Bot 记的应用授权;不能碰的应用;应用租约和前台租约;指示器、停止、「电脑」页;接管和交接卡与浏览器共用 |
| 上下文与记忆 | 对话分段、上下文管家(压缩还是换段)、交接包、read_own_chat;记忆的存放、格式、权限、整理和冻结 |
| 记忆撤销与更改记录 | 记忆窗口「更改记录」列出 journal.jsonl 的改动;按记录 id 对单条添加、修改或删除做逆操作撤销 |
| Bot 运行配置 | Agent 预设、每个 Bot 的模型和思考强度、新 Bot 默认模型、工作文件夹、能力(MCP、技能、能力包) |
| 本地 Agent CLI 作为 Bot | 本地 agent CLI 作为模型路由(英文文档):会话映射、工具桥、审批、记忆、会话管理与徽标 |
| 头像库 | 可复用的自定义头像库(bot/avatars/,按内容去重)与单张容错的批量导入 |
| AGENTS.md 维护 | 从项目工作中审阅持久规则;用户批准后才原子写入 |
| 长消息 | state.json 只存开头;超过 2 万字的 Bot 消息转成 DSH 文件;成员和界面怎么读全文 |
| 桌面应用 | 壳、引擎和界面怎么分;锁定的 DSH 版本、独立的数据位置、首次启动和导入、插件怎么兼容 DSH、安装和更新 |
| Linux 桌面包 | AppImage(自更新)加 deb(Debian/Ubuntu 沙箱兜底),同一轮构建产出 |
| Bot 之间派活 | Bot 看得到对方的状态;没读的消息合成一条;派活树:下面的活交回后才往上交,不许发给在等结果的 Bot;不设总量和链长上限 |
| Bot 视图 | Bot 在回答里画视图:固定组件目录的 JSON 蓝图(含图表、输入和本地公式),目录外的放沙箱 html;提问卡回路的泛化 |
| Side chat(侧边对话) | 人顺带问一句:侧栏里的常驻对话,以与会话同构的请求回答、不执行工具、不打断、不进模型可见历史;可追问、可开多条;Bot 之间的 ask_bot 另行提案 |
| 消息布局和宽度 | 气泡 / 平铺两种布局;平铺时 Bot 的话带头像、名字、时间;气泡宽度和平铺正文宽度各用一个滑块,按正文列的百分比调 |
| Windows 上手流程 | 从下载到第一条回复:下载区和信任说明、安装、窗口先出来的启动页、一个位置和推荐盘、启动页上的一键导入、Main Bot 聊天里的模型设置卡(登录或检查过的 key、自动选模型)、修复卡、第一个小时的 Windows 问题、卸载时问一次 |
| 启动窗口 | 启动页的样子和动作:单独的小窗口(待定),Main Bot 的鲸鱼浮在水线上,围着它三段弧的圆环就是三个真实阶段,顺利时没有字,点它会喷水;等待越久越慢,卡片和失败页在同一张纸面上变形,就绪时圆环合上、鲸鱼跳到团队窗口里 Main Bot 的头像上、团队窗口在同一处盖上来 |
| 启动页文案 | 启动页和壳里系统对话框的字:按页面位置分层,每层一条写法规则;text.mjs 一张表、旧键到新键的对照、扫全表的测试 |
| IM | 在微信、飞书、钉钉、企业微信、QQ、Telegram、Discord、Slack 里和 Bot 或群说话:IM 机器人绑一个 Bot,群绑 DS Bot 群;只认配对过的账号;回复和卡片发回聊天软件;只有占着团队锁的 dsh 连接 |
| 手机 App | iOS 和 Android 远程操控电脑上的 Bot 团队:手机不跑 Agent;扫码配对、端到端加密、电脑只往外连;完整功能,高权限操作要解锁手机 |
| Office 文档 | Bot 离线处理 .docx/.pptx/.xlsx:应用带的 payload、office.js 命令行、office 路由换成带 office-tools 的版本 |
| 连接器 | 通用连接器引擎、OAuth、网关、邮箱 |