8.0 KiB
8.0 KiB
WP0 基线、接口与发布路线
日期:2026-11-13(Asia/Shanghai) 状态:实施前核对记录。后续验证结果按测试 ID 写入本目录其他文件。
1. 仓库基线
| 项 | 值 |
|---|---|
| 仓库 | C:\Users\qyh15\三省六部 |
| 分支 | feat/dsbot |
| 基准提交 | 3f20f89(工作树在开工时仅多出交接方案文档) |
| 远端 | origin https://git.qyhhh.top/newbie/dsh-sansheng-liubu.git |
| 根工作区 | workspaces: ["sansheng", "ds-bot"],根 package.json 不是 DSH 插件 |
| 治理包 | sansheng/ = dsh-sansheng-sansheng@0.2.7(本次发布候选) |
| 团队底座 | ds-bot/ = ds-bot@0.3.2-sansheng.7(上游 Fei2411/DS-Bot@84c3cb8 + 本地 M-01–M-06) |
| Node | v24.21.0(DSH 随附 ~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe) |
| 桌面宿主 | DeepSeek Harness 0.2.2-rc.3(resources/runtime/primary-runtime/runtime.json) |
| 基线测试 | node --test --test-isolation=none sansheng/test/*.test.js → 56/56 通过(2026-11-13) |
2. 已安装对象(只读核对,不修改)
读取位置:%USERPROFILE%\.dsh\profiles\desktop。
| 对象 | 已安装版本 | 状态 |
|---|---|---|
dsh-sansheng-liubu-mode |
0.14.0 | 旧十席工作台,仍在 dsh.profile.bundles |
workspace-groups-remote |
1.3.0 | 当前项目树插件,仍在 bundles |
dsh-better-sidebar |
0.32.1 | 右栏页签接入 |
dsh-better-chat |
git 源 | 聊天插件,纳入布局回归观察 |
ds-bot |
本仓库 junction(C:\Users\qyh15\三省六部\ds-bot) |
node_modules 中存在,但 不在 dsh.profile.bundles |
dsh-sansheng-sansheng |
未安装 | 本仓库治理包尚未挂进 desktop profile |
结论:当前桌面运行的是旧十席工作台,不是本仓库新方案。实施只改仓库,不修改 daily profile、node_modules 或代装升级;真实宿主端到端验收需另建测试环境,缺环境时交付候选版本并明确标注。
3. 接口契约(只读核对)
来源:本机插件源码、docs/p0/*.md、archive-manager / workspace-groups-remote 的客户端实现。所有接口均在运行时用 ctx.get(name, false) 或 ctx.<service> 探测,不做私有 DOM 操作。
3.1 工具拦截与观察
| 能力 | 契约 | 用途 |
|---|---|---|
ctx.tools.guard(fn) |
同步;fn(exec) => string | undefined。返回字符串即拒绝,工具体不执行,模型收到 isError:true。根 ctx 注册对 Bot 群 Session 生效。 |
group_goal 门禁 |
ctx.on('tools/execute', (exec, next) => ...) |
包裹工具执行;next() 返回原生结果。 |
派发记录、返工观测 |
exec.agent.id |
执行会话 id。经 DS Bot state.json 反查 chatOwners/groupOwners 得到 Bot 与群。 |
身份判定 |
rt.isBotSession(sessionId) |
DS Bot 运行时判断某会话是否 Bot 会话。ctx.get('dsbot-runtime') 获得(M-01)。 |
区分用户会话 / Bot 会话 / 未知过期身份 |
3.2 项目树(workspace-groups-remote 1.3.0)
- 项目树注册在
sidebar.workspaces;项目 = 宿主 workspace,会话挂在其下。 - 没有第三方可用的"项目行动作"槽位;项目/文件夹行菜单是插件内部实现。
- 宿主的 原生上下文菜单服务
contextMenus.register({ id, target, order, observe, resolve })可用(archive-manager 同款):target: "workspace"的resolve({ workspaceId, path, displayTitle })返回菜单项数组{ id, label, icon, run, disabled, separatorBefore };target: "session"的resolve({ sessionId, displayTitle })同构。该服务在ctx.get('contextMenus')或ctx.contextMenus。 - 当前项目推导:
workspaces.list.getSnapshot().items[]+sessions.list.getSnapshot().byId。当前会话取retainedBy.mainView > 0的唯一会话(旧工作台 0.14.0 已验证的宿主等价事实),再按item.sessionIds.includes(sessionId)得workspaceId。无明确选择时返回 null,不拿第一个项目冒充。
3.3 会话与右栏
| 能力 | 契约 | 用途 |
|---|---|---|
ctx.uiWorkspace.openSession(sessionId) |
打开会话页签;失败时退回 uiWorkspace.selection.set({ sessionId }) |
点击角色打开真实会话 |
ctx.uiWorkspace.startSession(workspaceId) |
在空工作区创建并打开会话(旧工作台使用的宿主动作);不存在时给出可读错误 | 项目树入口在无会话项目上打开工作台 |
ctx.sidebarRightTabs.register({ id, kind, priority, title, keepMounted }) |
注册右栏页签 | 「三省六部」页签 |
ctx.slots.register({ name: 'sidebar.right.pane.tab', key }, Component) |
页签内容 | 三卡与配置 |
ctx.slots.register({ name: 'sidebar.right.pane.tab.title', key }, Component) |
页签标题 | 角标 |
ctx.slots.register({ name: 'conversation.session.header.actions', id, order }, Component) |
会话头按钮 | 「三省」快捷入口 |
ctx.get('sidebarRight') / ctx.get('betterSidebar') |
旧版右栏打开接口;openTabIn(sessionId, kind) / openTab({type}) |
兼容回退,不虚报成功 |
3.4 DS Bot 运行时(团队底座)
- 运行时暴露:
ctx.provide('dsbot-runtime', rt)(M-01),只读状态文件$DSH_HOME/bot/state.json。 - 可复用钩子:
createBot/updateBot/deleteBot/createRoom/updateRoom/deleteRoom/applyModel/updateBot/resolveModel、deliver、goalControl、findBot/findRooms/isAdminOf/isMain/selfOf/isBotSession、roomOf/roomOfSession。 group_goal业务拒绝以普通字符串返回,isError不置位;因此派发结果必须结合目标 revision/id 前后快照判定,不能靠英文错误前缀。- 记忆作用域:
own(每 Bot)、group(每群)、team(所有 Bot 共享)。Team 作用域是跨项目泄漏点,需治理服务按项目拒绝读写。
3.5 治理服务(本仓库新增,供 ds-bot 补丁调用)
sansheng 启动时 ctx.provide('sansheng-governance', api)(若宿主支持):
api = {
version: 3,
projectOfBot(botId) -> { id, name } | undefined,
projectOfRoom(roomId) -> { id, name } | undefined,
checkDelivery({ fromId, toId, roomId }) -> { allow: boolean, reason?: string },
checkMemoryScope({ botId, scope: 'own'|'group'|'team', roomId }) -> { allow: boolean, reason?: string },
}
ds-bot 侧只在服务存在时执行检查;不存在时保持上游行为。补丁写入 ds-bot/PATCHES.md。
4. 数据兼容
sansheng状态文件默认$DSH_HOME/sansheng/state.json。v2 → v3 迁移:保留projects/reviews/dispatches/reworks/events,新增artifacts/leases/seq;旧字段digest继续作为reviewSubjectDigest的别名读取。迁移只补字段,不改写历史记录,不删除旧项目。- 旧十席工作台数据(
dsh-sansheng-liubu-mode)与 DS Bot 的state.json均不迁移、不写入。旧工作台退出方案仅文档说明:升级顺序为先停旧包再启用新包,避免同时注册入口。 - 旧
ds-bot状态文件只读;所有项目绑定保存在sansheng自己的文件。
5. 发布路线
- 仓库分支
feat/dsbot提交 WP0–WP7 变更;按工作包分提交,每个提交附问题、实现、测试与限制。 - 推送至
origin/feat/dsbot;用 Gitea PR 审查合并(不按历史 URL 擅自推送其他仓库)。 - 产出两个可安装包的 tarball:
dsh-sansheng-sansheng-<version>.tgz与ds-bot-<version>.tgz,附docs/verification/证据与升级说明。 - 用户自行决定是否更新日常 desktop profile;本次不代装、不重启用户应用。
6. WP0 退出条件核对
- 唯一实现:
sansheng + ds-bot三角色方案;旧十席工作台仅历史参考。 - 可构建发布包:两个子包均为 ESM,Node 24 可运行,测试命令已确认。
- 项目树入口无公开项目动作 API → 采用宿主原生
contextMenusworkspace/session 菜单 + 右栏页签;不使用私有 DOM。 - 不依赖直接修改宿主才能成立的功能;ds-bot 必要补丁均记录在 PATCHES。
- 旧数据保留策略明确,无自动迁移。