5.7 KiB
5.7 KiB
P0 证据汇总:DS-Bot 宿主能力与最小接入面
日期:2026-11-10。本文件是 P0 阶段的收尾记录,证据详版见同目录三份文档:
- dsbot-api.md:DS-Bot 宿主 API、工具拦截、记忆、页面与停止能力
- navigation.md:better-sidebar / workspace-groups / 右侧栏扩展点
- compat.md:宿主版本、依赖、安装与回退
1. 来源记录
| 项 | 值 |
|---|---|
| 上游仓库 | Fei2411/DS-Bot |
| 固定基线 commit | 84c3cb86b997aec53281b842fd162f3f6b4ee7be |
| 基线日期 | 2026-11-09T09:56:14Z(npm 发布);当日 main 为 8e0013e0,其 ds-bot 子树与基线逐文件一致 |
| npm 包 | ds-bot@0.3.2(latest) |
| npm integrity | sha512-M+Wn55IOjy8T54JY6OS3RqOuuaKX72B7lRZ7DK/y2DzkGEXXtNGmf4lqKUSVaY+ecWnByFv/a3uWVW0/Zc/1SA== |
| npm shasum | 909d3ee37acd3c3b89163725c040f6840368db53 |
| 许可证 | Apache-2.0(随包 LICENSE / NOTICE 保留) |
| 本机宿主 | DSH 0.2.1-rc.5(Electron 44.7.0,非宿主版本) |
| 上游自测宿主 | 0.2.2-rc.1(README 声明;本机低一个 rc) |
| peerDependencies | @deepseek-ai/cordis、dsh-llm、dsh-scope、dsh-tools、dsh-web,全部 * |
| inject 服务 | 8/8 存在,关键方法签名比对通过(见 compat.md) |
npm 0.3.2 的 tgz 与 GitHub 84c3cb8 源码树的共享文件逐字节一致;GitHub 树只多
开发文件(dev/、test/、src/client/、scripts/ 等),npm files 已排除它们。
因此 npm 0.3.2 就是 84c3cb8,二者可互证。
2. 能力证据表
| 需求 | 现成能力 | 结论 |
|---|---|---|
| 每项目三个独立 Bot | rt.createBot(roster.js:178)建 root Session;updateBot、deleteBot |
原生 + 伴侣插件调用 |
| 项目群、尚书为 admin | rt.createRoom({members, admin})(roster.js:627);admin 才有 Goal 写权限(goals.js:730) |
原生 |
| 直聊与群内隐藏 Session | 每 Bot 私聊 root Session;每群每成员 room.sessions[botId](groups.js:310) |
原生 |
| 每项目模型 | createBot({model}) 固定模型;rt.applyModel 连带群 Session(models.js:250) |
需运行时句柄(M-01) |
| Goal 阶段进度唯一权威 | group_goal 状态机与 room.goal(goals.js) |
原生,不复制状态 |
| 拦截 pass / complete / rework | 根 ctx ctx.tools.guard 同步拒绝,工具体不执行(dsh-tools:3008-3031) |
零补丁 |
| 观察 Goal 动作结果 | ctx.on('tools/execute', (exec, next)) 包住 next() |
零补丁 |
| 真实调用者身份 | exec.agent.id → state.json 的 chatOwners/groupOwners 反查(store.js:488-512) |
只读 state.json |
| 审查记录 / 版本核验 | 无原生能力(room.goal 只有阶段与 evidence) |
自建记录(DSH_HOME/sansheng) |
| 返工预算 | 上游 stage.reworks 按阶段累计,passed 阶段经 revise 保留 |
求和即“按目标累计”,无需自建计数 |
| 群内派工 / 回报 | 群内 @Name 原生唤醒成员;message_bot 群内只写入当前回合(tools.js:155) |
用原生 @,不重复投递 |
| 停止 / 取消 | stop_bot、stopRoomWork、goalControl stop(cancle 会丢排队消息) |
原生 |
| 项目记忆隔离 | 上游弱:Main Bot 可读写任意 Bot 记忆,Bot 可 recall 非 private 记忆(memory.js:406/1129) | 未改上游(M-03);运行时隔离见 P4 |
| 模型不可用不静默回退 | 上游有三级回退(models.js:180-186) | 未改上游(候选 M-05) |
| 页面右侧三卡 | sidebar.right.pane.tab 可挂 React(宿主负责宽度/收起/深色/窄屏) |
P5 方案 A;常驻列需 M-04 |
3. 最小修改范围
| 编号 | 状态 | 内容 | 理由 / 回退 |
|---|---|---|---|
| M-01 | 已实施 | ds-bot/index.js 的 apply 暴露 ctx.provide('dsbot-runtime', rt)(2 行) |
伴侣插件拿不到 rt,无法建 Bot、设模型、读权威目标;npm 包原样保留为回退 |
| M-02 | 已实施 | 从 ds-bot/cordis.patch.yml 移除 ui-settings-general disabled: true,保留宿主原生设置页 |
上游设置壳在没有 Bot 时不渲染,用户会以为设置页被删 |
| M-03 | 暂不需要 | 记忆与召回按项目作用域过滤 | 隔离由「每项目独立 Bot + 独立群 + 角色按绑定重算」覆盖;上游记忆仍跨项目可读(已知边界) |
| M-04 | 暂不需要 | DS Bot 主界面常驻三卡(conversation 组加 cell) | P5 方案 A(右栏页签)已落地且零补丁;只有「切换会话要重开页签」影响使用时才启用 |
修改均记录在 ds-bot/PATCHES.md。除 M-01 / M-02 外,
P1–P3 不需要改动上游:Gates 用 tools.guard,记录用伴侣存储,派工用原生群 @。
4. 待运行验证(需安装 + 重启 DSH)
- bot 模式下 DSH 右栏是否渲染,
sidebar.right.pane.tab是否可见。 - better-sidebar 与 workspace-groups 的条目在 bot 模式下是否仍在。
- DS Bot 是否覆盖
main.conversation包装;keepMounted是否被卸载。 <768px时三卡是否按宿主规则全屏。- 安装/卸载后
bundles与dependencies条数是否按预期回退(38 / 36)。
5. 决策
- 固定基线用发布版
84c3cb8(= npm 0.3.2),不用当日 main。 - P1–P3 零上游补丁完成业务;唯一例外是 M-01 运行时句柄。
- 三省六部自身状态(ProjectBinding / ReviewRecord / GoalPolicy)存
DSH_HOME/sansheng/state.json,原子写、可迁移;不写 DS Bot 的state.json。 group_goal仍是阶段进度唯一权威;记录层只引用它的room.goal.id/revision, 不复制阶段状态。- 页面先走右栏 tab(方案 A),不改 better-sidebar,不 shadow 项目树。