Compare commits

..

71 Commits

Author SHA1 Message Date
QQ 832e265038 Merge pull request 'fix: 稳定朝堂入口、工作区项目识别与项目隔离' (#1) from fix/workbench-entry-project-isolation into master 2026-11-12 21:03:27 +08:00
newbie efc4a32c75 fix: stabilize workbench entry, project identity and session subscriptions 2026-11-12 18:52:15 +08:00
QQ 257c47f78c Import workbench/panel/lib/client.js 2026-11-12 15:42:30 +08:00
QQ 0cd0aea49d Import package.json 2026-11-12 15:41:41 +08:00
QQ 8f158c5028 更新 workbench/panel/lib/client.js 2026-11-12 14:21:56 +08:00
QQ a194838211 更新 package.json 2026-11-12 14:21:51 +08:00
QQ 297a2ee915 更新 CHANGELOG.md 2026-11-12 14:21:46 +08:00
QQ 1d8b496866 更新 workbench/panel/lib/client.js 2026-11-12 14:16:54 +08:00
QQ 3ffa57dbf4 更新 package.json 2026-11-12 14:16:49 +08:00
QQ 14a1f5c68c 更新 CHANGELOG.md 2026-11-12 14:16:47 +08:00
QQ 9855b03555 更新 workbench/panel/test/client.test.mjs 2026-11-12 13:28:55 +08:00
QQ 1aad975955 更新 workbench/panel/package.json 2026-11-12 13:28:51 +08:00
QQ ef7a2f9604 更新 workbench/panel/lib/client.js 2026-11-12 13:28:47 +08:00
QQ 4235f31368 更新 package.json 2026-11-12 13:28:42 +08:00
QQ 4e077fd6f3 更新 CHANGELOG.md 2026-11-12 13:28:38 +08:00
QQ 9fa80ac7d5 Import workbench/panel/package.json 2026-11-12 10:58:44 +08:00
QQ 4feab4d632 Import workbench/panel/index.js 2026-11-12 10:58:39 +08:00
QQ d3ed94d03d Import workbench/panel/cordis.patch.yml 2026-11-12 10:58:36 +08:00
QQ e7fd451227 Import package.json 2026-11-12 10:58:10 +08:00
QQ 2839f9873a Import cordis.patch.yml 2026-11-12 10:57:17 +08:00
QQ e7c63439d6 Import TODO.md 2026-11-12 10:57:13 +08:00
QQ 126f97e808 更新 TODO.md 2026-11-10 23:06:05 +08:00
QQ 935053a9ca 更新 TODO.md 2026-11-10 22:55:06 +08:00
QQ e46fd57599 package.json 2026-11-10 22:37:04 +08:00
QQ 56ec629134 index.js 2026-11-10 22:36:59 +08:00
QQ 2c0f507ba1 cordis.patch.yml 2026-11-10 22:36:56 +08:00
QQ fda101736f CHANGELOG.md 2026-11-10 22:36:52 +08:00
QQ ed31d3c5d7 0.11.0 退役老预设线:workbench/test/memory.test.mjs 2026-11-10 22:25:27 +08:00
QQ 6212092172 0.11.0 退役老预设线:workbench/host/service.mjs 2026-11-10 22:25:23 +08:00
QQ e42896c9c5 0.11.0 退役老预设线:workbench/host/routes.mjs 2026-11-10 22:25:18 +08:00
QQ f15e7d112c 0.11.0 退役老预设线:workbench/core/memory.mjs 2026-11-10 22:25:14 +08:00
QQ d1d0529e0c 0.11.0 退役老预设线:package.json 2026-11-10 22:25:10 +08:00
QQ 7b6e301697 0.11.0 退役老预设线:docs/记忆设计.md 2026-11-10 22:25:07 +08:00
QQ 8c05acf6b4 0.11.0 退役老预设线:README.md 2026-11-10 22:24:31 +08:00
QQ 9c83e19ec4 0.11.0 退役老预设线:CHANGELOG.md 2026-11-10 22:24:22 +08:00
QQ 04fb4f2d8b 0.11.0 退役老预设线:删除 test/policy.test.js 2026-11-10 22:13:37 +08:00
QQ 7a49e4b541 0.11.0 退役老预设线:删除 scripts/preview.mjs 2026-11-10 22:13:30 +08:00
QQ 1139dfd735 0.11.0 退役老预设线:删除 scripts/mode.mjs 2026-11-10 22:13:25 +08:00
QQ 568f1d8e43 0.11.0 退役老预设线:删除 scripts/check-install.mjs 2026-11-10 22:13:21 +08:00
QQ f941429f69 0.11.0 退役老预设线:删除 preset.patch.yml 2026-11-10 22:13:18 +08:00
QQ 834683a7ba 0.11.0 退役老预设线:删除 panel/test/client.test.js 2026-11-10 22:13:05 +08:00
QQ 79f5156c72 0.11.0 退役老预设线:删除 panel/package.json 2026-11-10 22:12:58 +08:00
QQ 99121d7d54 0.11.0 退役老预设线:删除 panel/lib/model.js 2026-11-10 22:12:55 +08:00
QQ c5ee75988e 0.11.0 退役老预设线:删除 panel/lib/client.js 2026-11-10 22:12:50 +08:00
QQ 5fe1d5e4c8 0.11.0 退役老预设线:删除 panel/index.js 2026-11-10 22:12:43 +08:00
QQ a6801c95f3 0.11.0 退役老预设线:删除 panel/cordis.patch.yml 2026-11-10 22:12:38 +08:00
QQ 017a3acb19 0.11.0 退役老预设线:删除 panel/README.md 2026-11-10 22:12:33 +08:00
QQ badcc35c5a 0.11.0 退役老预设线:package.json 2026-11-10 22:12:30 +08:00
QQ 3976930c3d 0.11.0 退役老预设线:删除 locale/zh.json 2026-11-10 22:12:27 +08:00
QQ d23be0a6a2 0.11.0 退役老预设线:删除 locale/en.json 2026-11-10 22:12:23 +08:00
QQ 96f6221891 0.11.0 退役老预设线:index.js 2026-11-10 22:12:20 +08:00
QQ 899fcec590 0.11.0 退役老预设线:TODO.md 2026-11-10 22:12:17 +08:00
QQ 077aeb651d 0.11.0 退役老预设线:README.md 2026-11-10 22:12:13 +08:00
QQ 4400e9dca6 0.11.0 退役老预设线:CHANGELOG.md 2026-11-10 22:12:09 +08:00
QQ bd75d8186e feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:51:06 +08:00
QQ 48478d9e55 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:51:02 +08:00
QQ ade684b6e6 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:51:00 +08:00
QQ 003d52941d feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:46 +08:00
QQ 7e9fc669d6 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:42 +08:00
QQ 585f4cda3b feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:39 +08:00
QQ 05795c4d69 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:35 +08:00
QQ a475b28a0f feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:32 +08:00
QQ 611fd4c3e1 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:25 +08:00
QQ dc4c1abe6f feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:20 +08:00
QQ 0aaf54c471 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:17 +08:00
QQ 96bb4eb682 feat(workbench): 分层记忆——长期记忆+项目记忆,派发注入与成果自动记账(0.10.0) 2026-11-10 21:50:13 +08:00
QQ b9a1fb71fa docs(todo): DS Bot 适配方向已否决,记录实测冲突依据(M-02/M-03) 2026-11-10 21:20:02 +08:00
QQ 6b557f8cf2 feat(policy): 未分类工具默认拦截,问清只读还是改动、登记后才放行(POLICY_VERSION 0.5.0) 2026-11-10 21:09:19 +08:00
QQ 6edacc3065 feat(policy): 未分类工具默认拦截,问清只读还是改动、登记后才放行(POLICY_VERSION 0.5.0) 2026-11-10 21:08:56 +08:00
QQ 646f33589c fix(workbench): Windows 风格 DSH_HOME 在 POSIX 上按 Windows 语义拼账本路径 2026-11-10 21:05:28 +08:00
QQ 6f660ff2b4 fix(workbench): Windows 风格 DSH_HOME 在 POSIX 上按 Windows 语义拼账本路径 2026-11-10 21:05:08 +08:00
209 changed files with 18310 additions and 10703 deletions

9
.gitignore vendored
View File

@ -1,5 +1,8 @@
ds-bot/
.scratch/
.research/
node_modules/
.dsh-test-*/
*.tmp
*.log
.stats.html
review_results.json
# 生图实验残留,不进版本历史;要留下的预览图放 docs/
dsh-image-gen/

264
CHANGELOG.md Normal file
View File

@ -0,0 +1,264 @@
# Changelog
> 版本号以 `package.json` 为准(当前 0.14.0)。更早的 0.6.x 条目沿用旧编号,保留作历史。
## 0.14.0 — 入口生命周期、项目识别、项目隔离与会话订阅
- **入口注册按服务生命周期**:betterSidebar / 原生 sidebarRightTabs 通过 `ctx.inject` 监听,服务晚到或重挂时先清理旧注册再重建,两条路径互斥不重复;原生降级补齐 `guide` 胶囊,第一次进入不再找不到「朝堂」。
- **项目识别不再猜首项目**:当前工作区由 `sessions.list` 的 `mainView` 保留会话与 `workspaces.list` 的会话归属公开推导;`uiWorkspace.currentWorkspaceId` / `selection` 不再是依赖。没有明确项目时只显示项目清单和选择引导,bootstrap 也不再默认返回第一个项目。
- **项目隔离**:所有部门操作继续显式携带 projectId;切换项目会丢弃旧项目迟到响应,避免 A 的席位/任务显示到 B。
- **会话订阅**:follow 地址改为 `{kind:'session', sessionId}`,支持 `{kind:'subagent', parentSessionId, childSessionId, mode}`;同一会话只保留一条流,订阅失败会把对应绑定标成 unavailable(缺少 follow 能力的宿主除外)。
- **移除退役预设**:部门会话不再硬编码 `sansheng-liubu` 预设;显式预设先经宿主 `agentPresets.list()` 校验,不存在时返回明确错误。
- **清理旧安装自检**:`workbench-install.mjs` 只打印迁移说明,不再改 profile;`workbench-preflight.mjs` 改为严格只读、只检查主包入口与 16 条路由,不再要求独立 workbench 包。
## 0.13.2 — 修面板接管主区时与官方入口重复声明槽位
0.13.1 修好 betterSidebar 后,干净档案实测继续往下走又撞到第二个启动失败:面板接管 `main.conversation` 时在 children 里声明 `conversation.header`,而官方会话入口已经声明了同一个槽,宿主的槽注册表拒绝重复声明、同步抛错,面板再次激活失败。改为先按原样注册、被拒时退回不带 children 的注册(槽由官方入口声明、仍然存在,组件里的 renderSlot 照常渲染)。
## 0.13.1 — 修面板在缺 betterSidebar 的宿主上把整个启动页打崩
干净档案实测发现:面板的 `betterSidebarOf` 里有一处未经防护的 `ctx.betterSidebar` 直读——该服务不在面板的 inject 声明里,宿主没有它时 Cordis 直接抛错,面板激活失败并把整个 web 启动打到「Failed to load plugins」页(白屏)。这与面板自己「服务探测缺了也要照常加载」的设计意图相悖。改为只走带 try/catch 的 `readService` 探测:缺服务时按原有降级路径走(警告 + 仍注册 pane 槽),有服务时行为不变。
## 0.13.0 — 朝堂面板并回主包:商店里只剩一条
应需求把面板包 `dsh-sansheng-liubu-workbench`(0.2.0)并回主包 `dsh-sansheng-liubu-mode`,单独安装时不再装两条:
- 根包新增 `dsh.client`(平台与 inject 沿用面板原来的三项)与 exports `./client`,指向 `workbench/panel/lib/client.js`;面板客户端的模块注册 id、CSS id 与 DOM 标记同步改为主包名。
- 面板子包退役:其 package.json 去掉 `dsh` 声明并标 private,不再作为独立 bundle 被组合;`workbench/panel/` 目录保留为面板客户端的源码/产物所在。
- 根包去掉 `private: true`(为发布到自有 Gitea npm 源做准备;git 安装不受影响)。
- 商店索引同步去掉「三省六部 · 朝堂面板」一条,描述改回单条安装。QQ-dsh 捆绑包仍按旧结构 vendored,后续再跟进。
## 0.12.1 — 宿主冲突审计与加固
对现行工作台做了一次完整的宿主接触面审计(patch 槽位、路由、UI 槽位、服务注册、会话 API、文件与定时器),结论:没有 M-02/M-03 式的硬冲突(不占 settings.trigger、不停用宿主设置页、不改搜索提供方、不注册任何服务/工具/命令,路由只用自有前缀)。审计中发现并修掉一处隐患:
- **极简入口防重复启动**:`index.js` 增加全局单例护栏(Symbol.for 注册 + 引用计数)。插件被重复应用时(如 profile 里还留着旧预设段、按会话重复挂载)不再另起一份宿主,避免两份宿主重复注册路由、双写同一本账本;引用全部释放后才真正停掉宿主。
- 根 `cordis.patch.yml` 的注释更新为退役后的现状(此前还指向已删除的 preset.patch.yml)。
审计备忘(不改代码):工作台面板默认接管 `main.conversation` 槽位(priority -1,原生内容透传,有 localStorage 逃生开关);与全局记忆插件(Mnemosyne 系)无名称/文件冲突,但对方的全局注入会叠加到部门会话上,属预期内的软性相互影响。
## 0.12.0 — 第三层记忆:每个部门一份自己的长期记忆
应需求给 0.10.0 的两层记忆补上第三层(设计文档同步升为 v2):
- **新增部门记忆**:`memory/departments/<roleId>.md`,一个席位一份,跟着部门跨项目走;roleId 按十席名单校验,非法 ID 明确报错。
- **召回**:派发摘录变为三段,顺序为部门记忆(主责部门自己那份,上限 2000 字)→ 项目记忆(3000 字)→ 长期记忆(2000 字)。只注入主责部门自己的经验本,别的部门读不到。
- **记账**:新成果落账后,部门记忆里同步记一行「在项目「<项目名>」汇报成果(任务「<标题>」):<摘要>」,带上项目出处;幂等重复汇报不重复记。
- **接口**:`memory/get|put|append` 的 scope 新增 `department`(需带 roleId),路由数量不变(仍 16 条)。
- 新增 5 项测试,全量 175 项通过。
## 0.11.0 — 退役老预设线,只留工作台
按现行方案(`docs/v0.1-实施方案.md`:十席独立会话、身份由项目+席位绑定注入)执行退役。旧方案的 Team/子 agent 模型整体移除:
- **删除**:`preset.patch.yml`、朝堂侧栏 `panel/`(含其客户端与测试)、`scripts/mode.mjs`、`scripts/preview.mjs`、`locale/`、`test/policy.test.js`。
- **根 `index.js` 重写为极简入口**:只在应用根上启动工作台宿主(`createWorkbenchHost`),卸载时停掉;不注册预设、不读 Team 成员身份、不注入角色提示词、不做工具守卫、不提供 /dept-model 命令。
- **随老线退役的能力**:基于成员身份的角色判定、丞相组队流程、工具守卫(含未分类工具拦截)、预设内按部门改模型。工作台的账本、席位绑定、派工对账与分层记忆不受影响——它们本来就走独立会话模型。
- **包名保持 `dsh-sansheng-liubu-mode` 不变**,仅为让既有 bundle 登记继续有效;它不再提供任何模式。升级时请删掉 profile `cordis.patch.yml` 里旧的上朝预设段。
- 单测随之减少:删除的 policy/panel 测试共 55 项,余下全部为工作台测试。
## 0.10.0 — 三省六部有记忆了:长期记忆 + 项目记忆
- 新增分层记忆(设计见 `docs/记忆设计.md`,思路借鉴 DS Bot 的分层记忆,落在原生账本之外):长期记忆一份(跨项目,记用户偏好与长期经验),项目记忆一项目一份(记这个项目发生过什么、结论是什么),都是侧车目录 `memory/` 下的 Markdown 文件,用户可以直接打开看、打开改。
- 隔离按本项目的规矩:项目记忆只认项目 ID、项目之间互不可见,不学 DS Bot 上游「主 Bot 可读全部记忆」的弱隔离。
- 派发时自动注入:dispatchTask 把项目记忆(上限 3000 字)与长期记忆(上限 2000 字)的摘录并进上下文包的 excerpts,部门开工前就能看到;记忆读失败不拦派发。
- 成果自动记账:新成果汇报落账后,往项目记忆追加一行(哪个部门、做了什么),重复汇报不重复记;写失败不影响成果本身。
- 新增三条路由(共 16 条):POST /memory/get、/memory/put、/memory/append;服务层未启用记忆时明确报 INVALID_STATE,不假装。
- 测试新增 6 项(记忆存储、隔离与上限、服务 API、派发注入、自动记账去重),全量 226 项通过;preflight 路由数同步为 16。
## 0.9.2 — 模型设置这次真的会落到部门身上
- 面板原来从 `ctx.remote.commands` 取指令接口,新宿主把服务挂成 `remote.commands`(要写进 inject,用 `ctx.get` 取),所以一直报「没有直接执行指令的接口」;现在按官方挂法取,并在 inject 里声明 `remote.session` / `remote.subagents` / `remote.commands`。
- 宿主返回的是 `{ ok, value: { commandId, result } }`,面板现在先解包再判断 `result.kind`,同步兼容旧的裸返回。
- 保存失败时也会把 busy 放掉:以前宿主一拒绝,两个下拉框就永久变灰点不动。
- 测试 55 项(新增「指令接口挂在 `ctx.get` 上也能静默执行」)。
## 0.9.1 — 三省与六部之间真的空开了
- 上一版只加了三省、六部**组内**卡片的间距;「三省」整组到「六部」整组之间还是贴着的。
- 这次给六部这块加 `margin-top: 16px`,任何侧栏宽度下都留出空隙,不再靠那条细连接线撑门面。
## 0.9.0 — 你也可以直接给部门派活,模型不再绕丞相
- 席位详情里新增「直接派活」:写清要办的事,点「派给礼部」,消息直接进该部门自己的会话——丞相收不到、也不参与。丞相照旧可以自己派活,两条路互不干扰。
- 派活走宿主 `subagents.prompt`(`{ requestId, parentSessionId, childSessionId, mode: "continuable", delivery: "queue" }`),每次带独立 requestId;宿主拒绝时把原因原样显示。
- 改模型不再借丞相的会话:先在部门自己的会话里执行 `/dept-model`,那个会话冷着就退到任一已登记会话——指令只写全局路由表,依然不产生对话消息、不唤醒模型。
- 测试新增 4 项(派活投递、非子会话报错、模型优先用部门会话、失败回退且不发消息),全量 54 项通过。
## 0.8.0 — 换完即存,不再惊动智能体
- 模型和推理等级改成**选完就保存**,去掉「保存模型设置」按钮;脚注直接显示「自动保存 · 当前:…」。
- 保存改走宿主 `commands/execute` 直接执行 `/dept-model`:不投递提示词、不在对话里留消息、不触发模型轮次,丞相不会因此进入大段推理。
- 宿主没有这个接口或指令尚未加载时,只在前端报错(「宿主没有执行这条指令」),不会退化成一条普通消息发给智能体。
- 测试新增两项:确认改模型时**不**调用 `session.prompt`、以及缺接口时的报错;全量 50 项通过。
## 0.7.2 — 三省与六部之间松一点
- 三省(`.sl-grid-3`)与六部(`.sl-grid-6`)的卡片间距从 8–10px 统一到 12px,三个容器断点(含 ≤620px 的两列布局)一起调,窄侧栏下也不再挤在一起。
## 0.7.1 — 十个席位都有模型设置,没召见的也能先选好
- 面板「模型设置」原来只在 `seat.present` 时渲染,没召见的部门连入口都没有。现在绑定的是席位本身:未召见的部门也能选模型,保存时同样下发 `/dept-model <角色> <provider> <model> [推理等级]`,并注明「召见后生效」。
- 未召见的席位读清单时不再传会话 id:直接读全局清单,当前值取面板里固定过的那条;保存后脚注写「该部门还没召见;保存后在召见时生效」。
- 顺带修掉一个由缺席席位暴露的 bug:`activeSeat` 在 `activeChildId` 为空时会撞上「没有会话 id 的缺席席位」(`undefined === undefined`),把标题写成「正在与吏部对话」。现在只有存在子会话时才去找席位。
- 预览脚本新增 `--absent=<角色,...>`,可以直接截「未召见的部门」这一态;演示数据补上全局清单的 `default` 字段,缺席席位才有默认可选模型。
- 测试新增「还没召见的部门也能先选好模型,保存走 /dept-model」;`node --test` 49 项全过。
## 0.7.0 — 每个部门可以单独固定模型
- 部门是子会话(`origin: "subagent"`),宿主的 `session.selectModel` 对它们一律拒绝(`session/agent-busy`,建议走 subagent delivery),所以「在这里选好就生效」原来根本做不到。现在面板改为下发 `/dept-model <部门> <provider> <model> [推理等级]` 指令,由模式插件按角色把模型写进运行时路由表并落盘 `routes.json`,`agent/request` 钩子在下一轮开工时生效。
- 模式插件新增 `parseDeptModelCommand` / `describeDeptRoutes` / `readStoredRoutes` / `writeStoredRoutes`:支持 set、`list`、`clear [部门]`,未知部门与参数不足各自给出可读原因;路由文件按 `DSH_HOME`(缺省 `~/.dsh`)下的 `sansheng-liubu/routes.json` 读写,读不到就当没固定过。
- 面板「模型设置」对部门显示「按部门固定」,选好保存即固定,脚注显示「该部门固定使用此模型」;每个部门的固定值用 `localStorage` 记在面板侧(`sansheng-liubu.route.<角色>`),用于显示当前模型。
- 预览脚本新增 `--seat=<角色>`,可以直接截某个部门的详情;演示数据补了 `localStorage` 与部门子会话地址,工部示例固定为 DeepSeek V4。
- 测试:客户端新增「改模型改由丞相会话下发 /dept-model」「固定路由从面板记录读出来当当前模型」两项;策略侧新增指令解析与路由文件往返用例。`node --test` 48 项全过。
## 0.6.0 — 模型选择真的能用了
- 部门设置里的模型清单原来靠 `modelDirectories.directoryFor(sessionId)` 取该会话的目录,而这个方法只认「本页登记过的会话」,于是每个还没在面板里打开过的部门都读不到模型。现在清单改从宿主的全局目录 `modelDirectories.catalog` 读(`catalog.load()` 一份,所有部门共用),不再依赖会话登记。
- 保存模型改成真正的 RPC:有 `ModelDirectory` 时走 `directory.select(...)`,没有时直接 `remote.session.selectModel({ sessionId, provider, model, reasoningEffort })`。**没在本页打开过的部门也能改模型**,保存后立即生效。
- 「当前模型」读不到该部门自己的选择时,退回全局默认并标明「跟随默认」,不再冒充成别人的选择;界面脚注会说明「该部门会话未在本页打开,选好保存后直接生效」。
- 错误分级:服务缺失 →「当前宿主没有全局模型清单(modelDirectories.catalog)」;清单读取失败 →「读取模型清单失败:<原文>」;6 秒超时 →「读取模型清单超时(显示已知缓存)」;宿主拒绝保存 → 「<code>:<message>」。
- 测试从 4 项模型用例重写为 6 项:服务缺失、清单来自全局且不依赖登记、未登记时保存走 RPC、宿主拒绝原文、清单读取失败保留缓存、正常路径;`node --test` 客户端 35 项全过。
## 0.5.7 — 模型目录读不到时说清是哪一步断了
- 部门设置里的「当前宿主未提供模型目录」不再是一句万能提示。原来 `modelDirectoryOf` 把三种情况都吞成 `undefined`:取不到 `modelDirectories` 服务、`directoryFor` 方法不存在、`directoryFor(sessionId)` 抛异常。现在分别返回 `{ service: false }`、`{ error }`、`{ directory }`。
- 宿主的 `ModelDirectoryResolver.directoryFor` 在该会话没登记时抛 `ui-model-selection: session "<id>" resolved no scope / no binding`。这种情况不再报「宿主未提供模型目录」,而是**借另一个已登记会话的目录把全局模型清单列出来**:列表照常可选看,`current` 留空不冒充别人的选择,保存按钮禁用并写明「进入该部门会话后才能改模型」。其它异常(服务崩溃、超时、快照读取失败)原样带出原文,同时用 `[三省六部]` 前缀在控制台留下会话 id 与原始错误。
- 新增 `sessionsOtherThan`(最近活跃会话 → 任意已登记会话)做兜底;`loadCatalog` 的投影收敛成一个 `project()`,成功/超时/兜底三条路径共用,`unresolved` 随结果返回给界面。
- 新增 4 项测试:服务缺失、会话未登记时兜底且不冒充当前选择(含 `selectModel` 拒绝)、其它异常原样带出、正常路径。`node --test` 43 项、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.6 — 左栏那一行改名「上朝」并置顶
- 按用户要求把左侧栏导航行的标签从「三省六部」改成「上朝」,`order` 从 10 改为 −100,排在「插件」以外所有插件行之前(`插件` 恒列首行,是宿主写死的)。
- 只改呈现,不动行为:点击仍然是停靠右侧栏的 `main` 重定向桩。
- 39 项测试(含新增的「标签是上朝、order 为负」断言)、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.5 — 左栏只留一处入口
- 撤掉 0.5.3 的左侧栏底部入口(`sidebar.footer.action`)与它的 `SanshengRailAction` 组件、8 条 `.sl-rail-*` 样式(`.sl-rail-mark` 保留,重定向桩还在用)。0.5.4 之后左栏同时有导航行和底部一行,是同一功能的两个入口,按用户要求收敛成一个。
- 左栏现在只有「插件 / 定时任务 / 任务看板 / MCP 连接器」那一列里的「三省六部」一行;会话头部的「三省」开关仍是另一处入口(两处都只做停靠,不是两套面板)。
- 删掉 2 条只服务于底部入口的测试,槽位断言回到五个;39 项测试、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.4 — 入口搬进左侧栏导航列
- 用户要的不是底部那一条,而是「插件 / 定时任务 / 任务看板 / MCP 连接器」那一列;那一列只认 `sidebar.panellist`,于是注册一行导航:`id: sansheng-liubu`、`order: 10`、`label: 三省六部`,图标是插件画的 18px 细线「三」字样标(`SanshengNavGlyph`,激活时线宽 1.6)。
- 那一列的点击行为由宿主写死为 `selectPanel(id)`,一定要 `main` 槽,所以同时注册 `main`(`key: sansheng-liubu`)作为**重定向桩**:`SanshengDockRedirect` 挂载后立刻调 `dockToSidebarTab(host)`,停靠右侧栏、清掉旧提示、`selectPanel(null)` 退回原会话;没有会话时只在页面中央写明原因(`.sl-dock-stub`)。它不渲染朝堂、不承载聊天,这是对 0.5.0「两个槽一律不注册」的收敛式修订。
- 底部入口(`sidebar.footer.action`)保留:两处入口等价,共用同一条提示存储。
- 新增 2 条测试:导航行与 `main` 桩的注册(含 `label()` 与 `key`)、`dockToSidebarTab` 成功/失败两条路径(失败时不得 `selectPanel`)。另修了断言写法:`h("svg", props, [children])` 在测试替身里是单层嵌套,要先 `.flat()`。
- 41 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.3 — 左侧栏也有三省六部入口
- 在左侧栏底部(`sidebar.footer.action`,`id: sansheng-liubu:rail`)加了一个常驻入口:只做「把朝堂停靠到当前会话的右侧栏」,与会话头开关共用同一条提示存储,不切整页面板、不新增聊天存储。
- 折叠侧栏时只剩「三省」字标;展开时补上「三省六部 / 收起朝堂」文字,失败原因显示在文字下方(`role="status"`,最多两行,完整文本在 `title` 里),字标转红作为折叠状态下的可见信号。
- 不再用 `sidebar.panellist`:那个槽的点击会走 `selectPanel` 去要 `main` 槽,而 0.5.0 起不再注册 `main`,点进去只会得到空面板。
- 修掉会话头开关的一个连带问题:失败时原来会回退到 `host.togglePanel()`,同样指向不存在的整页面板;现在只写提示。
- 新增 3 条测试:左栏入口的注册与两种宽度下的渲染、无会话时的可见原因、以及「失败时不得 `selectPanel` 到无 `main` 槽的面板」。
- 39 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.2 — 断点跟随侧栏容器,窄栏不再挤压状态说明
- 响应式断点从浏览器视口改为面板容器:`.sl-root` 声明 `container-type:inline-size;container-name:slpanel`,11 处 `@media (max-width: …)` 全部换成 `@container slpanel (max-width: …)`。真实宿主窗口最大化时侧栏仍只有 371px,旧的视口断点一个都不会触发,等于窄栏样式从来没生效过。
- 删掉 `.sl-compact .sl-grid-3,.sl-compact .sl-grid-6` 的强制两列:它优先级高于容器断点,会把单列规则压死。现在列数完全由容器宽度决定。
- 单列阈值落在 330px 容器宽(约 348px 侧栏):360px 及以上保持两列,320px 降为单列。
- 部门配置里的「最近活动」独占一行、最多两行后省略,不再和状态文字挤在同一行被裁断;`panel/lib/client.js:891` 的 `shortText(…, 46)` 保持不变。
- `scripts/preview.mjs` 新增 `--viewport=<像素>`:窗口可比侧栏宽,用来复现「大窗口 + 窄侧栏」的真实宿主形态;新增 371px、320px 两张入库预览图。
- 新增两条回归测试:禁止视口 `@media` 断点且必须保留容器断点;`.sl-detail-status small` 必须独占一行且不得 `white-space:nowrap`。
- 36 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.1 — 清掉侧栏化残留,会话头开关不再静默
- 删除侧栏化后不再渲染的旧样式:独立聊天栏、整页面板壳、`sl-left-nav`、`sl-task-jump` 等 46 个类共约 117 行规则;CSS 由 374 行收到 257 行。
- 删除无调用点的 `SanshengPinRow`、`DockButton`,以及已经没有外部消费方的 `SidebarIcon` 导出;`panel/lib/client.js` 由 1890 行收到 1758 行。
- 会话头部开关在拿不到会话、或宿主没有右侧栏服务时,把失败原因直接显示在开关旁(`role="status"`,完整文本放在 `title`),不再静默回退成整页面板。
- 新增两条回归测试:开关失败提示的渲染与清除;`className` 里出现的每个 `sl-*` 类都必须有对应 CSS 规则,防止样式与组件再次脱节。
- 去掉 `sl-side-pane`、`sl-control-model`、`sl-control-effort` 三个「有类名、无规则」的幽灵类名。
- 34 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.0 — 收进右侧栏,聊天回归 DSH 原生
- 移除整页「三省六部」面板、丞相主对话摘要卡和第二套聊天入口;聊天统一使用 DSH 原生输入框与消息流。
- 朝堂编制与任务流转收进会话右侧栏:顶部「朝堂 / 任务」页签、四张统计卡、组织图与选中部门配置在同一侧栏内滚动。
- 在原生输入框输入 `@` 选择部门后进入其子会话;右侧栏自动选中对应部门,返回丞相时恢复丞相选中。
- 移除 `main`、`sidebar.panellist` 和 `sidebar.panellist.actions` 注册,只在会话头部与右侧栏注入入口,不再占用工作区主视图。
- 侧栏顶部改为紧凑状态行:协作状态、`输入 @ 选择部门` 提示与子会话返回按钮;统计卡可点击切换朝堂/任务。
- 移除 Agent 预设编辑与重复「下旨」输入;部门设置只保留固定职责、模型/推理等级和会话入口。
- 策略插件与面板版本推进到 0.5.0;侧栏结构、槽位注册、@ 导航和自动选中均有回归测试。
## 0.4.2 — 原生 @ 部门成员
- 在 DSH 原生会话输入框注册 `@` 来源,候选为已建立的九个子 Agent 会话;主对话仍使用宿主原有输入框,不新增第二套聊天。
- 选择 `@中书省`、`@工部` 等部门后进入该成员的现有子会话,随后直接在原生输入框发送任务;不会把消息静默转发或改写接收人。
- 进入子会话时右侧朝堂图自动选中对应部门,部门配置同步切换;返回丞相主会话时恢复选中丞相,不再出现“人在工部、面板还选着丞相”的错位。
- 面板主对话区提示改为「输入 @ 可直接找部门成员」;未设官、没有会话的部门不出现在候选中。
- 新增 @ 候选与会话导航回归测试;32 项策略和客户端测试通过。
## 0.4.1 — 重设计朝堂面板
- 按 DSH 原生主题变量重构面板:品牌与朝班状态头、丞相主对话卡、独立任务流转区、右侧统计与部门配置。
- 部门改为边界清楚的实体卡片:蓝灰描边、字徽、名称与中文状态;选中态使用蓝边、浅蓝底和勾选标记。
- 朝堂图固定为「丞相 → 三省 → 六部」:丞相连接三省,尚书省连接整个六部分组;六部两排三列,明确同属一级。
- 左侧增加「主对话 / 任务流转」切换;点击「在办任务」统计卡或对话区入口,可直接切到任务流转。
- 点击「在朝成员」统计卡进入全宽朝堂编制:收起左栏与统计,组织图和部门配置铺满面板;顶栏或地图头部均可返回协作台。
- 设置区移除 Agent 预设输入与重复的「下旨」文本框,只保留固定职责、模型/推理等级和「与某部对话」。
- 新增子 Agent 会话入口:选中部门后直接打开其 DSH 子会话;顶部可返回丞相主会话,不再另造聊天存储。
- 统计保持两列两行;右侧栏、窄屏和紧凑侧栏分别减少列数,卡片状态行不再塞入任务计数。
- 修复空闲状态显示为英文 `idle` 的问题;深色与明亮模式共用结构,颜色均由 DSH 主题变量派生。
- 策略插件与面板版本推进到 0.4.1;当时 31 项策略和客户端测试通过。
## 0.4.0 — 补齐六部
- 角色由七席扩为十席:丞相 + 三省 + 吏、户、礼、兵、刑、工六部;新增 `COURT_ROLES` 作为唯一编制来源。
- 新增 `libu`(吏部)、`hubu`(户部)、`xingbu`(刑部)角色提示词;`libu` 由「礼部」改为「吏部」,礼部改用 `lipu`,避免与吏部拼音重名。
- 按职责重划写入边界:吏部/户部只有 write、edit;礼部、刑部另有命令行;兵部另含远程与 MCP 通道;工部独有 Image-gen 生图。
- 尚书省提示词改为按吏户礼兵刑工分工、只召集真正用到的部门;丞相提示词同步十席组织。
- 面板朝堂图改为「丞相 → 三省 → 六部」三排结构,六部同排直隶尚书省;座位计数与测试同步到十席。
- 版本推进:策略插件 0.4.0,面板 0.4.0。
## 0.3.7 — 上朝改为手动启用
- 包自带的 `cordis.patch.yml` 改为空层(`[]`):装包不再往模式选择器里注册「上朝」,也不再能成为新会话的默认模式。
- 新增 `preset.patch.yml`:想上朝时把它的 `- insert:` 段合并进 profile 的 `cordis.patch.yml`,重启后才会出现该选项。
- 新增 `scripts/mode.mjs`(`npm run mode -- on|off|status`):带标记地写入/撤回那段 insert,可逆且幂等,不会替你选中模式。
- `scripts/check-install.mjs` 改为校验「装包不等于开模式」:包内 patch 必须不含预设行,`preset.patch.yml` 必须能复现同一 preset id,并报告当前是否已启用。
- README 补「启用方式」与 Git 回滚,删除已失效的 backup 目录回滚说明。
## 0.6.2 — 默认进入丞相
- 将尚未加入 Agent Team 的新会话主 Agent 直接映射为丞相(Lead)。
- 使用“上朝”模式后可立即与丞相对话,不再需要手动切换默认 Agent。
- 已加入团队的中书、门下、尚书、工部、礼部和兵部角色映射保持不变。
## 0.6.1 — 交由 dsh-image-gen 执行
- 上朝不再重复注册 `generate_image`,避免与 `dsh-image-gen` 工具冲突。
- 工部获准使用 Image-gen 的 `generate_image`、`generate_images` 和 `edit_image`。
- Provider、凭据、模型、计费与图片保存全部交由 Image-gen 管理。
- 上朝仅保留角色职责、任务准奏和工具权限边界。
## 0.6.0 — 普通百炼生图
- 工部恢复 `generate_image`,使用普通百炼 `/images/generations` 接口。
- 通过 DSH 凭据服务读取 `BAILIAN_API_KEY`,源码不保存密钥。
- 默认 dry-run,真实调用必须显式 `live=true`。
- 固定三模型白名单,无其他图片渠道 fallback。
- 保留其他图片生成和编辑工具的拒绝策略。
## 0.5.1 — 移除上朝生图能力
- 删除 `generate_image` 工具注册、请求构造、参数矩阵、付费开关及网络调用实现。
- 删除 `sansheng-liubu:imagegen` 提示词块和相关可选能力探测。
- 工部恢复为识图、OCR、截图与视觉分析,不提供生图或图片编辑。
- 策略明确拒绝所有图片生成和编辑工具。
- 保留工具审核开放制、执行部门文件工具、管理型工具审批与审计逻辑。
- 删除生图使用文档;mode id 和 preset id 保持不变。
## 0.5.0 — 工具审核开放、六部配笔与千问生图
### 变更范围
- 将管理型工具的一刀切禁令改为审发分离:丞相可调用并记录审计日志;部门须持门下省准奏记录;兵部负责装配、发放、回收、登记和销账,只发不批。
- 兵部、礼部、工部获得 `read`、`write`、`edit`、`bash`、`grep`、`glob` 等执行工具;中书、门下、尚书维持只读工具集。
- 该版本曾向工部加入可选生图能力,已在 0.5.1 移除。
### 历史缺陷防复发
- `sansheng-liubu:role` 使用共享安装引用计数保护,不重复注册。
- 未引入 `sanshengLiubuGeneration` preset service;模式沿用 agent 原生 scope。
- preset 只保留 `sansheng-liubu-policy` 单一引用,未接入 v2、v3 或 v031 陈旧链。

55
README.md Normal file
View File

@ -0,0 +1,55 @@
# 三省六部工作台
给 DeepSeek Harness(DSH)用的多角色工作台:丞相、三省、六部共十席,
每一席都是一个**独立会话**(不是谁的子 agent),身份由程序按
「项目 + 席位」的绑定注入,项目之间互不串扰。
## 它怎么运转
- **账本**:项目、任务、派工、成果都记在一本账本里
(`~/.dsh/sansheng-liubu/workbench.json`),聊天原文不复制,
留在各席位自己的会话里。
- **派工**:在工作台里选项目、选席位、写任务单,程序把材料直接
投递到那个席位的会话;投递以请求号防重复,结果回来自动对账。
- **模型**:每个席位可以单独选模型,存在账本与会话绑定里,
不借别的会话、不靠猜。
- **记忆**:三层 Markdown 记忆,派工时自动带上相关片段——
部门记忆(每个部门一份、跨项目,`memory/departments/<部门>.md`)、
项目记忆(按项目隔离,`memory/projects/<项目>.md`)与长期记忆
(跨项目,`memory/long-term.md`),都是纯文本,可以直接打开改。
设计说明见 `docs/记忆设计.md`。
## 安装与启用
本包只发布一条:`dsh-sansheng-liubu-mode`。朝堂面板已并回主包,**不要**
再单独安装 `dsh-sansheng-liubu-workbench`;旧脚本 `workbench-install.mjs`
现在只打印迁移说明,不会再改任何 profile 文件。
```sh
node scripts/workbench-preflight.mjs # 严格只读自检:入口、bundle 语法、路由、账本可写
```
安装、修复与迁移是独立授权操作;自检不会创建、覆盖或迁移用户文件。
改完安装后要**彻底退出并重启 DSH** 才生效。
## 验证
```sh
npm test # 工作台全量单测
node scripts/workbench-preflight.mjs # 装配与安装状态预检
```
真机验收矩阵在 `docs/v0.1-验收记录.md`,标「待真机」的条目
只能在装了 DSH 的机器上验。
## 0.11.0 退役说明
老预设线已整体退役:不再有「上朝」模式、基于 Team 成员身份的
政策插件(工具守卫、按部门改模型)、朝堂侧栏与组建朝班流程。
根目录 `index.js` 现在只负责在应用根上启动工作台宿主。
升级注意:如果你的 DSH 配置文件 `cordis.patch.yml` 里还留着
以前写入的上朝预设段,请把它删掉再重启;如果 profile 里还登记了
`dsh-sansheng-liubu-workbench`,也一并移除(面板已并回本包)。本包的包名
保持 `dsh-sansheng-liubu-mode` 不变,只是为了既有 bundle 登记继续有效,
它不再提供任何模式。

180
TODO.md Normal file
View File

@ -0,0 +1,180 @@
# 三省六部开发 TODO
更新日期:2026-11-10(模型推荐段于 2026-11-12 实时更新)
当前阶段:角色与面板规划。以下勾选框表示实施是否完成,不表示方案是否确认。除特别注明外均为用户已确认、待实施;创建本文件不代表授权安装技能或修改运行配置。已有实验代码也不代表下面的新方案已实现。
> 2026-11-10:老预设线已退役(0.11.0)——「上朝」模式、Team 政策插件与朝堂侧栏全部移除,仓库只保留工作台一套(十席独立会话)。下文涉及预设/老面板的条目均为历史规划记录,不再执行。
## v0.1 与首次提交
- [ ] 先完成 TODO 规划,再进入 v0.1 实现;当前继续规划,不提前实施。
- [ ] v0.1 实现完成并通过相应验证后,再创建首次 Git 提交。规划阶段和 v0.1 未完成前不提前提交;此前的 Git 初始化不等于首次提交。
## v1.0 优先级与后续 DS Bot 适配(2026-11-07 用户确认;2026-11-10 已否决)
**结论(2026-11-10):不基于 DS Bot 构建,本节的适配计划作废。** 已实测冲突(feat/dsbot 分支):ds-bot 子包与自有侧边栏同装时,`settings.trigger` 槽位重复登记抛错、整个插件被标 failed(ds-bot/PATCHES.md M-03);其上游补丁还会禁用 DSH 原生设置页(M-02);且侧边栏按原生 Team 会话模型工作,与 Bot 会话模型不匹配。三省六部只走原生路线(预设 + 工作台)完成自身 v1.0;DS Bot 仅作参考阅读,不 fork、不迁移运行时。
当前优先顺序:先完成三省六部 v1.0 并验证可用。本节以下条目保留为历史规划,不再执行。
- [ ] 优先完成三省六部自身 v1.0:修复“开新朝堂”阻断问题,验证创建会话、组建成员、下旨、按需派工、结果回传与审核交付的完整链路。
- [ ] v1.0 对齐本文已确认的角色与流程要求:六部职责、用户授权、审发分离、依赖调度、角色模型可配置与权限边界;统一代码版本、README、CHANGELOG 与 TODO 的实际状态。
- [ ] v1.0 验收包含真实 DSH 宿主集成验证与关键失败路径;不能仅凭语法检查、安装检查或 Mock 单测通过宣称可用。
- 已否决(2026-11-10):「v1.0 完成后评估并适配 DS Bot」作废;长期 Bot、主 Bot/群聊管理、分阶段 Goal、分层记忆等机制仅作参考阅读。
- [ ] 适配前核对 DS Bot 的实际接口、宿主版本兼容性、数据与会话隔离、许可证及维护状态,固定验证版本;文档所述能力不等于已经在本机验证。
- [ ] 优先评估配置、角色模板、Skill 或薄插件的复用方式;是否采用其运行时、是否需要 fork,待验证后决定,不把此前助手提出的迁移建议当作用户已确认方案。
- [ ] 适配保留三省六部的用户授权、拟案/审议/调度分工、按需召集与定向修改机制;当前不因借鉴 DS Bot 而替换现有实现或扩大 v1.0 范围。
参考项目:https://github.com/Fei2411/DS-Bot
中文说明:https://github.com/Fei2411/DS-Bot/blob/main/README.zh.md
## 模型推荐方向:仅供选型参考,未确定默认配置
以下角色与模型的搭配均为推荐候选,不代表用户已确认绑定;具体默认模型须后续选定。用户明确偏好尽量不用 Claude。
- [ ] 尽量不用 Claude,不列入默认模型,也不因困难自动切换到 Claude。(2026-11-12 注:全球编程/Agent 榜首仍是 Claude Opus 5.5 / Fable 5.2,按此偏好未列入下表。)
- [ ] 图像理解与图像生成分别配置:礼部模型需能读取截图、图表与页面;需要生成或编辑图片时另用相应工具。
- [ ] 各角色模型保持可手动切换,技能绑定角色而非模型;不把下表推荐当作已定配置。
### 2026-11-12 实时更新:十席推荐(依据 2026-11-05~11 的 SuperCLUE、SWE-bench、Terminal-Bench、ProgramBench、FrontierMath、LMArena 等公开榜单)
通道标记:●=现有通道(DeepSeek 官方 API 按量付费,或 WorkBuddy/Magpie 订阅池,具体版本以 Magpie 实际刷出的模型列表为准);○=需另开通道(OpenAI / Google API,用户目前未接)。Gemini 4 Carbon 虽居多榜第一,但仅向受 vet 的安全从业者开放、无公开 model id,不列入推荐。
| 席位 | 主推 | 备选 | 推理档 | 依据 |
|---|---|---|---|---|
| 丞相 lead | DeepSeek V4.1 Flash (1017) ● | Kimi K3.1 Pro ● | 中 | 快、便宜、1M 上下文,SuperCLUE 国内第二;重要汇报临时切 V4 Pro |
| 中书 zhongshu | GPT-6 Astra ○ | Kimi K3.1 Pro ● | 高 | GPQA 96.0 / HLE 54.8 / ARC-AGI-2 95.0 推理天花板,沿用原 GPT 方向 |
| 尚书 shangshu | Kimi K3.1 Pro ● | Qwen3.8-Max ● | 中高 | 多任务拆解与长程 Agent;ProgramBench 第一、Terminal-Bench 65.7。备选改国产替代(2026-11-12 用户改定,原 GPT-6 Astra):Qwen3.8-Max 擅长复杂 Agent 与长程任务、企业级调度配套,与主推 Kimi 不同家族,可互为故障转移 |
| 门下 menxia | Gemini 4 Argon ○ | Kimi K3.1 Pro ● | 高 | 幻觉控制 83.19 全球断层、事实性第一;与中书/尚书不同家族保独立性;备选 Kimi 为国内幻觉控制第一(原定方向) |
| 吏部 libu | DeepSeek V4.1 Flash (1017) ● | GLM-5.3 ● | 中 | 改 Flash(2026-11-12 用户改定):编制与技能配置多为调研加结构化文案,Flash 够快够用;复杂选型评估切备选 GLM-5.3 |
| 户部 hubu | DeepSeek V4.1 Flash (1017) ● | DeepSeek V4 Pro ● | 高 | 改 Flash:数理与代码计算靠写脚本复算,Flash 便宜量大(FrontierMath 开放权重最强一档);硬核统计与证明切备选 V4 Pro。备选原 GPT-6.1 Sol,按「备选列全国产」替换 |
| 礼部 lipu | Gemini 3.8 Flash ○ | MiMo-V2.6-Flash ● | 中 | 视觉 Arena 第一(1411)、写作性价比之选、1M;备选 MiMo 全模态 MIT 开源、极便宜。未改 DS Flash:礼部必须读截图、图表与页面,DS Flash 主线是文本模型(Vision 变体接入未核实),视觉是硬需求 |
| 兵部 bingbu | DeepSeek V4.1 Flash (1017) ● | Kimi K3.1 Pro ● | 中高 | 改 Flash:调试靠流程技能加代码能力,DeepSWE 77.0 够打,部署脚本属常规活;长程终端任务切备选 Kimi(Terminal-Bench 65.7) |
| 刑部 xingbu | DeepSeek V4.1 Flash (1017) ● | Kimi K3.1 Pro ● | 高 | 本就是 Flash:DeepSWE 77.0 反超 Kimi 与 Opus。备选原 GPT-6.1 Sol,按「备选列全国产」换 Kimi——不同家族、国内幻觉控制第一,复核视角独立 |
| 工部 gongbu | GLM-5.3 ● | DeepSeek V4 Pro ● | 高 | SWE-bench 独立实测 95.4(非 Claude 阵营最高一档)、1M 无损上下文读整仓、重构稳;备选 DeepSeek 算法/后端强。未改 Flash:工部产出是生产代码,换 Flash 会明显降档,保留 GLM-5.3 |
2026-11-12 用户两条改定:①备选列(第三列)全部换国产替代,不留国外备选;②六部执行席能用 DeepSeek Flash 的改 Flash——吏、户、兵、刑四部已改,礼部(视觉硬需求)、工部(生产代码质量)保留原主推。Flash 走 DeepSeek 官方 API 按量付费,不占 WorkBuddy 单模型约 45 次/5 小时的 429 窗口;丞相与三省决策席仍分散在 Flash / GPT / Kimi / Gemini 上。
翰林(后续席位):原定「默认 Flash、重要总结切 Pro」不变,具体化为默认 DeepSeek V4.1 Flash,重要总结切 Kimi K3.1 Pro 或 Gemini 4 Argon。
## 面板与基础接口
- [ ] 从左侧导航打开三省六部页面;主对话在左、成员图在右,复用已安装 better-sidebar 的文件树,不另造文件树。
- [ ] 成员图采用卡片和连线:顶部丞相;中层左中书省、中尚书省、右门下省;吏、户、礼、兵、刑、工六部直属尚书省。
- [ ] 支持成员选择高亮、编辑、折叠;点击部门即可切换其对话并下旨。
- [ ] 图下配置所选成员的 Agent 预设、API、联动模型及推理等级;区分成员运行状态与任务状态。
- [ ] 实施前核实 better-sidebar 扩展接口、DSH 会话导航、直接投递、预设/模型切换及生效时点。
- [ ] 核实成员创建与调度权限;DSH 仅 Lead 可创建团队成员等宿主限制不能靠角色提示词绕过。
## 已确认的整体流程
- [ ] 与丞相沟通后,经用户同意才执行;“仅规划”的限制持续有效。
- [ ] 无方案或方案不明确:中书拟案 → 门下审议(默认一次)→ 用户提出修改意见并确认 → 尚书派工执行。门下准奏不替代用户授权。
- [ ] 首次交付:所需六部执行并自行检查 → 尚书组织完整成品 → 门下统一审核成品 → 交付用户;不逐部门送审。
- [ ] 审核问题只交对应部门修正,不扩大到无关部分。
- [ ] 交付附可编辑源文件位置与“部分 → 主责部门”清单,用户直接点击部门修改,不经丞相查找和转述。
- [ ] 交付后定向修改:用户 → 指定部门 → 只改指定部分 → 直接交回;默认不重新合成、不自动复审、不启动完整版本发布。
- [ ] 局部修改默认更新同一工作文件,进行必要局部检查;版本历史与回退统一使用 Git,不再创建 backup 目录、时间戳备份或多份“最终版”。保留并发冲突保护,PDF 等导出物只做必要重导出。
- [ ] 项目源码、角色配置、技能和规划文档通过 Git 提交记录有意义的变更;按需使用分支或 worktree 隔离并行工作,不为每次小修改建立完整发布流程。历史备份在核对并保全独有内容后再清理,不直接丢弃。
- [ ] 局部修改后标注未重新审核,不阻止交付;用户明确要求时才重新整合或复审。扩大修改范围须先获用户同意。
## 丞相:已确认,待实施
- [ ] 参考 Edict 太子职责,负责接旨分流、转达、三省协调与简短回报。
- [ ] 按语义判断任务,不按字数;普通问答不强制建任务,补充指令关联原任务。
- [ ] 用户指定部门时由程序直接投递原话、附件与范围,不额外调用模型转述;未指定、关键歧义或冲突时才由模型介入。
- [ ] 不擅自改派或扩大授权;成员原始回复即时可见,仅重要交接、阻塞、需用户决定及完成时汇总。
- [ ] API、模型独立配置;暂不内置中书省规划技能。
## 中书省:已确认,待实施
- [ ] 沿用 Edict 公开中书令角色基线,负责方案,不直接执行制作任务。
- [ ] 角色绑定 brainstorming 与 writing-plans 的适用内容,切换 API/模型后保留技能。
- [ ] 明确需求直接形成可执行计划;仅关键不明时澄清,不自动进入实施。
- [ ] 落地前核对上游版本、许可证与 DSH 适配。Edict 演示配置中的 planning 仅有作者本机路径,未取得其技能正文,不宣称已复用。
## 门下省:已确认,待实施
- [ ] 审查方案的可行性、完整性、风险、资源与授权边界;覆盖代码、办公套件、论文及跨文件一致性。
- [ ] 输出审查对象与版本、检查范围、证据、问题位置/影响/建议、未核实项,以及准奏/封驳/待核实结论;不越权修改,修复交执行部门。
- [ ] 按需适配 Builder Check、Code Reviewer 模板与 verification-before-completion 的证据规则;不把模板误称独立技能,不再嵌套派一个审查代理。
- [ ] 核实 Office/Univer 的读取、重算、渲染与 PDF 检查能力;覆盖 Word 结构排版、Excel 数据公式、PPT 图文版式、PDF 导出完整性及跨文件一致性。产生文件的检查优先副本或隔离环境。
- [ ] 核实 qqsci、nature-academic-search、nature-figure、nature-data、nature-response;按学科和期刊适配,覆盖文献创新性、证据结论、方法对照复现、统计、图文补充材料、引用及投稿修回。
- [ ] 无原始数据不声称真实性已验证,无文献核查不声称创新性已验证。
### 审核循环
- [ ] 审核循环上限可配置,默认 1 次;支持保存默认值及单任务覆盖。
- [ ] 一次循环定义为审核当前对象并输出结论;返工后再次审核才计下一次。计划审议和成品审核分别计数。
- [ ] 提前通过立即结束,不为用满次数重复审核;次数用尽不强制准奏。
- [ ] 默认一次后可在原授权内修正,但不自动复审;交付注明审核后修正情况及未解决事项。
- [ ] 上限大于一次时,在剩余次数内重点复核修改及影响;用尽后由用户决定是否追加审核。
## 尚书省:已确认,待实施
### 职责与技能
- [ ] 接收用户批准的方案,负责执行拆分、调度、阻塞协调、首次成品合成与交付;不重复中书规划,不承担门下审查。
- [ ] 专业制作及合成操作按需交执行部门;尚书负责组织完整产出。交付后的局部修改默认不介入。
- [ ] 绑定轻量“执行调度与交付”技能,切换 API/模型后保留;API、模型与推理等级由用户独立设置。
- [ ] Adopt-part:提取 dispatching-parallel-agents 的独立任务判断、聚焦派工及交接方法。
- [ ] Adopt-part:提取 subagent-driven-development 的 batching、preflight 与进度恢复方法;不引入逐任务审核、自动升级模型或上游返工循环。
- [ ] executing-plans 不作为尚书主技能,其自行逐项执行的定位更接近执行部门。
- [ ] 落地前固定上游提交、保留 MIT 版权和许可声明,完成维护与安全核查。部分主技能正文曾截断,采用前补读所需完整内容与引用。
### 任务依赖与并行调度
- [ ] 只调用需要的部门;一个部门能完成的工作不为凑齐六部拆分,同类小任务合并派工。
- [ ] 无相互依赖且写入范围不冲突的任务并行。
- [ ] 需要前项数据、文件或接口结果的任务串行,满足交接条件才启动。
- [ ] 可拆分任务的独立部分提前开展,依赖部分等待;条件满足即启动后续,不等待所有并行任务一起完成。
- [ ] 同一文件存在写入冲突且无可靠隔离合并机制时安排先后;某个部门阻塞只影响依赖该部门的分支。
- [ ] 派工记录:负责人、任务目标、必要材料、前置任务与交接条件、可提前开展部分、允许修改范围、产出位置、完成标准。
- [ ] 使用状态和完成事件推进,避免循环询问进展;保存任务实际结果、负责人和产出,防止重复派发。
- [ ] 维护“部分 → 主责部门”映射,首次交付附成品、源文件、审核计数、审核后修正及未解决事项。
- [ ] 技能负责判断分工依赖;程序检查授权、就绪条件、审核计数、防重复派发与文件冲突。不得把任务说明写完当作已派发或已执行。
## 六部:技能选型已确认,骨架已落地(0.4.0)
各部门采用主要技能入口加按需加载,技能绑定角色,更换 API/模型后保留。以下是选型确认,不代表安装或实测完成;具体工具权限和交接接口实施前核实。
已落地(0.4.0):角色编制扩为十席,六部角色、提示词、写入边界与面板朝堂图已接通;十席与职责断言纳入 `npm test`。以下技能选型条目仍在推进中。
- [x] 角色骨架:`COURT_ROLES` 十席、六部提示词、按职责划分的写入边界、面板三排朝堂图。
- [ ] 吏部负责 Agent 与技能维护:部分采用 Anthropic skill-creator 的技能设计与评估方法,复用 windows-codex-skill-install 的安装发现检查。仅新增或实质改进技能时进行评测,不因普通配置修改启动多代理基准测试,不擅自更换模型或扩权。
- [ ] 户部负责数据与计算:复用 univer-sheet/office-xlsx、office-recalculate,科学绘图按需使用 nature-figure。依据实际数据选择统计方法,不把表格操作等同统计验证,不补造数据。
- [ ] 礼部负责内容与呈现:按任务选用 qqsci、qqwrite、qqppt 及 Word/Slide 能力。保留 PPT 分流和叙事方法,默认采用可编辑文本、图表、形状;整页图片式演示须用户明确接受,实施前核实实际依赖,不把技能旧环境记录当现状。
- [ ] 兵部负责环境运行:部分采用 systematic-debugging 的错误读取、复现、变化检查、假设与最小验证;具体部署按平台适配,部署发布须在授权内。
- [ ] 刑部负责按需专项测试:采用 systematic-debugging 的复现定位及 TDD 的有效测试设计方法,输出问题与证据;不是每项任务必经审批,不重复门下成品审议,不另设无限返工循环。
- [ ] 工部负责开发实现:选型使用 search-first,关键行为与缺陷修复采用适配的 TDD,故障按需加载 systematic-debugging;不把删除已有实现重来、每个低影响改动强制全流程等上游规则原样引入。
- [ ] 六部共享技能不等于重复执行:各部完成必要自检,刑部按风险承担独立专项验证,门下核对已有证据,仅证据不足或变更影响时补查。
- [ ] v0.1 优先复用已有办公、论文和绘图技能,适配排错、测试及技能维护方法,不另引入完整多 Agent 开发框架;统一由尚书调度。
- [ ] 安装前补读所采用技能及引用、固定上游提交、核对许可证和脚本依赖并验证可用性。本轮 systematic-debugging/TDD 主文已完整读取;skill-creator 与部分本地技能只核对相关片段,办公能力尚未逐项实测。
候选来源:
- https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
- https://github.com/obra/superpowers/blob/main/skills/systematic-debugging/SKILL.md
- https://github.com/obra/superpowers/blob/main/skills/test-driven-development/SKILL.md
## 参考来源
本轮技能选型核对日期:2026-11-07。以下是候选和改编依据,链接到可变分支,实施时须固定提交。
- Edict 尚书角色:https://github.com/cft0808/edict/blob/main/agents/shangshu/SOUL.md
- 并行调度:https://github.com/obra/superpowers/blob/main/skills/dispatching-parallel-agents/SKILL.md
- 子代理开发:https://github.com/obra/superpowers/blob/main/skills/subagent-driven-development/SKILL.md
- 同类任务合并:https://github.com/obra/superpowers/blob/main/skills/subagent-driven-development/references/batching.md
- 执行前依赖检查:https://github.com/obra/superpowers/blob/main/skills/subagent-driven-development/references/preflight.md
- 自行执行计划(不作尚书主技能):https://github.com/obra/superpowers/blob/main/skills/executing-plans/SKILL.md
- Superpowers 许可证:https://github.com/obra/superpowers/blob/main/LICENSE
## 后续规划:翰林助理(私人助理席位)
2026-11-10 定下方向,仅规划、未排期,等真机调试与 v1.0 验收走完再议。
- 定位:取意唐翰林学士「天子私人」——编制外的一个私人助理席位,只对用户本人负责,不进十席、不走中书→门下→尚书的正式流程。
- 形态:一个长期跟随用户的独立会话(与现行独立会话方案一致)。
- 职责:备顾问(先查先答)、起草文书、贴身事务(提醒/日程/零碎跟进);可选:各部门成果呈报前的预审。
- 边界:不派工(派工仍由用户经工作台进行)、不审批(审议归门下)。
- 记忆:以长期记忆(用户偏好)为主;助理自身经验的存放方式(独立一份助理记忆,或借用部门记忆层)实施时再定。
- 模型策略(2026-11-10 定):默认 Flash——陪聊高频、长会话滚雪球,速度与成本优先,且陪聊质量主要靠长期记忆与人设稳定;重要总结(长材料、部门成果预审)临时切 Pro,席位可单独选模型,翰林应在碰到这类材料时主动提醒用户切换。

View File

@ -0,0 +1,197 @@
# 三省六部 v1.0 工作台修复方案
日期:2026-11-07
审查基线:`master` / `dd62068`,代码版本 `0.3.1`。
文档性质:实施建议与验收方案;不代表代码已修复或宿主集成已验证。
## 1. 目标与范围
将三省六部做成一个可直接工作的工作台:用户在同一页面完成下达任务、确认方案、查看部门执行、打开交付文件和定向修改。底层继续使用 DSH 会话与 Agent Teams,但由程序管理绑定与生命周期,不要求用户反复手动新建聊天、切换预设或组建朝班。
优先完成三省六部自身 v1.0,再评估 DS Bot 适配。当前不迁移运行时、不 fork DS Bot、不重写 DSH,也不为工作台重新实现已有文件树或通用聊天编辑器。
保留已确认原则:
- 丞相负责分流与协调,中书负责规划,门下负责审议与验收,尚书负责执行调度,六部按专业执行。
- 门下准奏不等于用户授权;执行必须在用户批准范围内。
- 只启动需要的部门,不为凑六部拆任务。
- 用户指定部门时直接投递原话、附件与修改范围。
- 首次交付统一审核;交付后的定向修改默认不重走完整流程。
- 模型由用户配置,技能绑定角色;不硬编码禁止某个模型家族。
## 2. 当前完成情况与阻断原因
已有基础:插件入口、预设、角色提示词、面板入口、部分会话导航与投递、模型路由、工具 guard、任务依赖准入检查。现有 22 个单元测试通过,但没有覆盖开新朝堂的完整路径。
| 问题 | 证据位置 | 影响与处理方向 |
|---|---|---|
| 未定义的投递函数 | `panel/lib/client.js:1074` | `sendPrompt` 不是当前作用域变量,创建会话后触发 `ReferenceError`;提取共用投递函数,所有入口调用同一实现 |
| 依靠新 ID 猜测创建结果 | `panel/lib/client.js:1048–1060` | 可能重复创建或误认并发会话;核实宿主契约,以返回标识或关联事件精确绑定 |
| 错误被吞掉或显示成功 | `panel/lib/client.js:1050,1066–1074` | 用户无法确定是否送达;统一结构化错误与界面状态 |
| 成员创建职责冲突 | `index.js:81`、`panel/lib/client.js:1084` | 尚书不能创建 teammate;尚书提出需求,由 Lead 执行创建 |
| 模型选择被覆盖 | `index.js:215–220` | 界面选择与实际请求不一致;统一配置来源与生效规则 |
| 权限覆盖不完整 | `index.js:132–154` | 未枚举工具默认放行,任务准入不等于授权;建立与宿主配合的权限检查 |
| 角色与文档不一致 | `index.js:54–60`、`TODO.md` | 实现只有工礼兵,未补齐六部;按已确认职责对齐 |
| 版本口径不一致 | `package.json`、`CHANGELOG.md`、`TODO.md` | 无法凭文档判断交付状态;发布时依据实际验证统一 |
以上是源码和已有复现支持的发现。DSH `startSession` 的准确契约尚未核实,不能假定它一定返回 session ID,也不能先编造接口再开发。
## 3. 工作台交互
建议布局:
```text
顶部:项目 / 当前任务 / 总体状态 / 设置
左侧:复用现有文件树 + 任务入口 + 交付入口
中间:所选部门对话、方案与授权卡片、任务输入
右侧:丞相—三省—六部组织图 + 所选角色配置
底部:当前阶段、等待对象、阻塞原因、最近产出
```
工作台打开时应立即展示结构。部门卡片常驻,执行成员按需建立;尚未启动的部门显示“未启动”,不能冒充在线成员。没有任务时显示可用的输入区,不以“组建朝班成功”作为页面可用的前提。
用户点击部门后,在工作台中显示对应对话。若宿主不提供可嵌入对话组件,先验证可用扩展点,再确定替代呈现;不得以自动跳转普通聊天页冒充完成工作台验收。
## 4. 实施阶段
### 阶段 A:核实宿主接口并确定实现边界
先核实以下能力的真实签名、返回值、异步错误和版本兼容性:
1. 工作区定位、会话创建、预设应用、会话读取及订阅。
2. 指定会话投递文本与附件、接收回执、运行中消息的处理语义。
3. 工作台内嵌对话或复用聊天组件的扩展点。
4. Lead 创建成员、成员身份、任务依赖与完成事件。
5. 角色模型/推理等级切换及实际生效时点。
6. better-sidebar 文件树复用及页面注册接口。
7. 宿主权限与人工审批凭证、共享任务元数据能否保存所需字段。
产出一份接口核对表,逐项标注“已验证 / 不支持 / 待验证”。若会话创建只能触发 UI 草稿而不真正建档,应采用宿主支持的服务路径或扩展点,不再使用轮询猜测弥补契约差异。
完成标准:可通过最小实验准确创建并识别一个指定工作区和预设的会话,获得明确的投递结果;确认中间对话区的可实现方式。
### 阶段 B:修复会话连接与错误处理(最高优先级)
- 将投递逻辑提取为有明确作用域的共用函数,供普通下旨、组建指令及工作台调用;不依赖不确定的 `this` 绑定。
- 用明确的创建结果或请求关联事件绑定会话;禁止选取“任意新出现的会话”。
- 对同一创建动作实行 single-flight,运行中禁用重复提交;超时进入“结果待确认”,先对账,不自动再次创建。
- 不吞同步异常、Promise rejection 或投递失败。统一返回 `ok`、`stage`、`sessionId`(已知时)、`errorCode`、用户可读说明和允许的恢复动作。
- 会话创建成功但投递失败时保留绑定,只允许向该会话重试投递;不能返回完整成功,也不自动删除用户会话。
- 消息重试需核对宿主是否支持幂等标识或送达查询。结果不明时提示用户确认,不能盲目重复投递。
- 将普通 `lastAction` 变量改为可订阅状态,及时显示创建、投递、失败和恢复进度。
- 所有按钮路径具备错误捕获和清理逻辑;卸载页面时清理订阅与计时器。
完成标准:单击只产生一个目标会话;并发创建其他会话不误投;投递失败不显示成功;恢复操作不重复建会话。
### 阶段 C:建立工作台状态与持久绑定
建议拆分职责,不直接在大型客户端 bundle 内堆叠新逻辑:
- 宿主适配层:封装经验证的 DSH API。
- 工作台状态层:维护绑定、选择、加载状态和错误。
- 流程层:管理授权、依赖与交接。
- 展示层:组织图、对话、任务、配置和产出视图。
具体文件拆分应先确认现有源码与构建来源;如果客户端是构建产物,修改源文件并重新构建,避免源文件和 bundle 各维护一套逻辑。
建议数据模型:
| 对象 | 必需信息 |
|---|---|
| 工作台绑定 | schemaVersion、workspaceId、工作台实例 ID、Lead sessionId、role→member/session 映射 |
| 任务 | 原始请求、目标部门、计划版本、负责人、依赖、允许范围、状态、产出引用 |
| 授权记录 | 用户动作来源、批准的计划版本与范围、时间、失效/撤销状态 |
| 审核记录 | 计划或成品、对象版本、结论、证据、次数、未解决问题 |
| 交付记录 | 文件引用、可编辑源文件、主责部门、验证状态 |
通过宿主允许的存储服务持久化。以 workspaceId 与工作台实例标识隔离,不用“最新会话”自动覆盖已有绑定。模型输出、角色消息或任务标题不能伪造用户授权。
刷新后核验会话是否仍存在、工作区是否匹配。会话缺失时显示可恢复状态,保留记录;重新绑定应明确展示对象,不能静默绑定其他会话。
成员可用性和任务状态分别展示:成员 inactive 不代表任务完成;任务完成必须有结果记录。
完成标准:刷新、切换项目、重启后恢复正确绑定;同一页面完成部门切换、投递、查看任务与打开产出。
### 阶段 D:统一角色、模型和流程
角色补齐为丞相、三省、吏户礼兵刑工六部。各角色职责以当前 TODO 已确认内容为准,角色 ID 必须唯一,避免吏部与礼部拼音重名。角色元数据集中定义,界面、提示词和策略共用。
创建与派工职责:尚书提出依赖、分工和成员需求;Lead 创建需要的成员;执行部门领取就绪任务。普通问答不强制创建全套任务链。
模型配置:统一用户选择、持久配置和请求路由的来源;明确角色覆盖与默认继承关系。删除与已确认选型冲突的硬编码限制。显示实际 provider/model/推理等级;不可用时报告错误或提供选择,不静默更换模型。
首次交付流程:
```text
接收需求 → 中书拟案 → 门下审议 → 用户确认
→ 尚书按依赖派工 → 所需部门执行与自检
→ 尚书组织完整产出 → 门下审核 → 交付
```
程序应验证:
- 用户确认绑定具体计划版本和范围;计划扩大或实质变化后需重新确认。
- 调度须同时满足用户授权、前置任务完成、负责人及写入范围有效。
- 独立任务可以并行,冲突写入按顺序执行或采用已验证的隔离机制。
- 防止同一任务因重复事件被多次派发;失败只阻塞依赖分支。
- 计划审议与成品审核分别计数,默认各一次;不得自行无限返工。
- 审核后的修正与未复审状态如实记录,不能修正后自动标为审核通过。
- 用户指定部门的局部修改直接投递,默认不重新拟案、合成和发布;扩大范围才重新请求确认。
完成标准:分别跑通单部门任务、并行任务、串行依赖与定向修改,能够说明每次推进依据的授权和完成证据。
### 阶段 E:补齐权限执行与交付
- 明确哪些限制由宿主沙箱、审批系统承担,哪些由插件承担;插件不能绕过宿主权限。
- 按工具能力与副作用检查准入,不把“未在黑名单中”视为只读安全。
- 未知或未分类工具先阻止本次执行并说明所需授权,避免无声放行。
- 文件写入检查真实目标与允许范围;路径归一化和链接处理交给可信文件服务,不能只用字符串前缀判断。
- 命令行与远程执行不能仅凭存在 writeScopes 就视为安全;受宿主沙箱和权限档位约束。无法证明范围约束时不得声称已实现强隔离。
- 用户审批凭证由可信宿主或界面操作产生,不接受模型自行填写的 `humanSigned` 作为真实签字。
- 检查现有 `approval`、`writeScopes` 等字段与宿主任务 schema 的兼容性;不支持时使用经过验证的插件存储映射,不能往宿主塞未支持字段。
- 首次交付附文件、可编辑源文件、主责部门、审核结果、修正情况及未完成项。
完成标准:只读角色写入、未授权执行、越界写入和未知副作用工具不能绕过检查;正常获授权任务能够完成。
### 阶段 F:v1.0 验收与发布
测试分三层:纯逻辑单测、宿主适配集成测试、当前 DSH GUI 人工可见的端到端验收。现有 22 个测试保留,不以数量代替行为覆盖。
| 场景 | 必须看到的结果 |
|---|---|
| 首次打开工作台 | 页面结构可用,可输入任务,未启动部门状态明确 |
| 创建慢、失败、重复点击 | 不重复创建,阶段及恢复动作准确 |
| 同时创建其他会话 | 不误认、不误投、不污染其他对话 |
| 创建成功但消息失败 | 显示部分完成状态,保留准确会话绑定 |
| 刷新或重启 | 恢复原工作台任务与会话;缺失对象明确提示 |
| 用户未确认计划 | 不进入执行 |
| 改模型及推理等级 | 下一次实际请求使用所选配置 |
| 多部门并行和依赖 | 只启动就绪任务,写入冲突受控,无重复派发 |
| 审核不通过或执行失败 | 留下证据,按规则修正或报告阻塞,不假报成功 |
| 打开交付和定向修改 | 可打开源文件并直接联系主责部门,不强制全流程重跑 |
按影响面重建 Web 产物,并在当前实际 DSH GUI 中刷新验证;不能另起一个服务后声称原 GUI 已更新。宿主插件代码变化若需重启,应明确重启后再验证。
通过后统一 package、面板版本、README、CHANGELOG 和 TODO。保留真实恢复历史,将旧规划标明历史状态,不编造过去版本的验收记录。按独立变更使用 Git 记录与回退,不创建时间戳备份。
## 5. 推荐拆分与实施次序
1. **连接层修复**:接口核对、确定性绑定、投递函数、错误状态、回归测试。
2. **工作台基础**:状态存储、刷新恢复、同页对话与部门选择、文件和任务入口。
3. **角色与配置**:补齐六部、集中角色定义、按需创建、模型配置实际生效。
4. **流程与权限**:可信用户授权、依赖与防重、审核次数、权限及范围检查。
5. **交付与验收**:产出映射、定向修改、完整宿主验收、文档与 v1.0 版本对齐。
第 1 项应先独立完成并验证。之后界面与角色配置可在边界明确时并行;涉及同一客户端文件、共享状态结构或接口的改动必须先约定再合并。每一项完成都应提供可复核结果,不先改版本号再补实现。
## 6. DS Bot 后续事项
v1.0 完成后再评估 DS Bot 的长期 Bot、群聊派活、阶段 Goal、分层记忆、独立模型与审批机制。先核对接口、版本、许可证、迁移和维护成本,再决定配置复用、薄插件适配或其他方式。
本方案不承诺 DS Bot 可直接承载现有三省六部,也不把公开文档能力等同本机兼容验证。
参考:https://github.com/Fei2411/DS-Bot/blob/main/README.zh.md
## 7. v1.0 最终完成标准
用户始终留在三省六部工作台中,能完成“下任务 → 确认方案 → 按需执行 → 查看产出 → 指定部门修改”;会话不串线、消息不误投、失败不假报、模型配置真实生效、授权边界可验证、刷新后可恢复,并有当前宿主上的验证证据。

12
cordis.patch.yml Normal file
View File

@ -0,0 +1,12 @@
# 三省六部工作台 · 宿主包补丁层
#
# 一行 insert 把宿主入口(index.js)挂进应用:账本、HTTP 接口、会话
# 装配与三层记忆都在 workbench/host 里。0.11.0–0.12.1 期间本文件是
# 空层([]),以为 bundle 加载会自动带起宿主入口——实际不会:没有
# insert 行,宿主插件根本不被应用,从商店单独安装时工作台后端不
# 启动(接口 404)。0.12.2 起补上这一行,与其它插件包同一装法。
# 老预设线(上朝模式/朝堂侧栏)仍保持退役,本层不恢复任何预设。
- insert:
- id: dsh-sansheng-liubu-mode
name: 'dsh-sansheng-liubu-mode'
config: {}

View File

@ -1,148 +0,0 @@
# DS Bot 与 OpenMausBot:架构拆解总览
分析日期:2026-11-14。分析对象为本地克隆源码,不是在线产品演示。
- DS Bot:提交 `a66cc737`,插件与桌面应用清单版本均为 `0.3.6`。
- OpenMausBot:提交 `a6cd67c78`,清单版本为 `0.1.158`。
- 三省六部新项目从 `v0.0.1` 开始,这是我们自己的版本,不应把下载来的两个上游项目版本强改为 `0.0.1`。
本轮只做源码阅读与架构分析,没有安装依赖、启动应用、验证外部账号或修改上游业务代码。文中“已实现”表示找到源码接线与实现,不代表已在本机实测所有功能。
## 1. 先把几个词分清
| 层 | 大白话 | 举例 |
|---|---|---|
| 前端 | 人看见、点击、输入的界面 | Bot 列表、聊天框、设置、审批卡、电脑画面 |
| 后端 | 收消息、决定交给谁、保存数据和协调执行的服务 | 建 Bot、发群消息、排队、记账、读写历史 |
| Agent 执行引擎 | 真正和模型来回交互、调用工具干活的部分 | DSH 会话循环、Claude/Codex 适配器、API 模型循环 |
| 工具与集成 | Agent 能使用的具体能力 | 文件、浏览器、电脑、邮件、MCP、外部应用 |
| 桌面壳 | 把网页装进桌面窗口,并接入操作系统 | Electron 窗口、更新、托盘、进程管理 |
| 数据层 | 关掉软件之后还保存的东西 | Bot 配置、聊天记录、记忆、任务与运行状态 |
前端显示“正在工作”,不等于前端自己在跑模型;聊天界面、任务调度和模型执行是不同层。
## 2. 两个项目最根本的区别
**DS Bot 是 DSH 之上的 Bot 团队产品层;OpenMausBot 是拥有自己服务端和执行适配层的独立应用。**
| 对比项 | DS Bot | OpenMausBot |
|---|---|---|
| 产品形态 | DSH 插件,另有捆绑固定 DSH 的桌面应用 | 独立应用,网页与桌面共用核心服务 |
| 前端 | 插件版 JavaScript + React 接入 DSH;桌面另有 React 页面;手机为 Expo / React Native | TypeScript + React,独立应用根组件;Vite 构建 |
| 后端 | DSH 插件的宿主模块,使用注入服务 | Node.js + TypeScript,自建 HTTP 服务 |
| 执行核心 | 普通 DSH Session 执行循环;另有本地 Agent 接入模块 | 自己的驱动接口,连接多种 CLI/ACP 引擎及 API 模型 |
| 前后端通信 | `POST api/bot` 发送 endpoint/payload;会话还依赖 DSH 服务 | 自己的 HTTP API 与事件流;部分实时连接另用 WebSocket |
| 桌面 | Electron;启动隔离的 DSH 环境 | Electron;启动自己的服务,并桥接设备与窗口能力 |
| 核心状态 | Bot 团队状态 JSON + DSH 管理的会话;另有索引/记忆/附件 | 配置文件 + SQLite 数据库 + 事件与文件资源 |
| 运行时依赖 | 离不开 DSH 插件服务接口 | 不依赖 DSH;部分能力依赖额外引擎、系统组件或云服务 |
证据入口:[DS Bot 插件装配](../ds-bot/ds-bot/index.js#L55)、[DS Bot 浏览器入口](../ds-bot/ds-bot/src/client/index.js#L61)、[DS Bot 请求封装](../ds-bot/ds-bot/src/client/api.js#L4)、[DS Bot 桌面清单](../ds-bot/app/package.json#L25)、[OpenMausBot 网页入口](../OpenMausBot/src/main.tsx#L1)、[OpenMausBot 后端入口](../OpenMausBot/server/index.ts#L11)、[OpenMausBot 驱动注册](../OpenMausBot/server/drivers/builtIn.ts#L32)。
## 3. DS Bot:从外到内怎么分
```text
用户
→ DS Bot 的 React 界面
→ DSH 界面插槽 / 会话界面 + api/bot 业务请求
→ DS Bot 宿主模块:Bot 名册、群聊、投递、权限、记忆、计划
→ DSH 会话与执行服务
→ 模型、工具和外部集成
桌面版:独立 React 页面 → Bot API / SSE → 带 DS Bot 插件的精简 DSH engine。
手机版:Expo / React Native 页面 → 配对与加密链路 → 同一个 Bot 后端。
```
最外层克隆目录和里面的插件目录都叫 ds-bot,所以存在双层同名目录,这是上游布局。
| 源码区 | 职责 |
|---|---|
| [插件目录](../ds-bot/ds-bot/) | 真正装入 DSH 的功能包 |
| [前端源码](../ds-bot/ds-bot/src/client/) | 团队侧栏、聊天呈现、设置、功能面板 |
| [后端源码](../ds-bot/ds-bot/src/host/) | Bot 生命周期、调度、消息、工具与存储 |
| [共享源码](../ds-bot/ds-bot/src/shared/) | 前后端共用的规则与结构 |
| [桌面应用](../ds-bot/app/) | 安装、窗口、独立 React 页面、固定 DSH engine |
| [桌面前端](../ds-bot/app/ui/src/) | 桌面版独立页面,复用插件组件与样式 |
| [手机应用](../ds-bot/mobile/) | Expo / React Native 原生客户端 |
| [手机链路](../ds-bot/link/) | 配对加密协议与 Relay 中继 |
| [测试](../ds-bot/ds-bot/test/) | 功能与边界测试,不属于运行时界面 |
| [开发环境](../ds-bot/ds-bot/dev/) | 测试用 DSH、模拟模型及开发验证 |
桌面端不是完整 DSH Web 的简单套壳:[桌面页面入口](../ds-bot/app/ui/src/main.js#L1) 有自己的 React 根组件,[engine 配置](../ds-bot/app/engine/cordis.patch.yml#L1) 明确不装 DSH Web 前端,窗口只与 Bot API 交互。
[插件入口](../ds-bot/ds-bot/index.js#L63) 用一个模块列表依次安装功能,各模块通过同一个运行时对象相互调用。它是“一个宿主里很多业务模块”,不能把每个文件理解成独立后端服务。
[前端生成文件](../ds-bot/ds-bot/client.js) 是编译产物。后续改界面应改 [前端源码](../ds-bot/ds-bot/src/client/),再构建,而不是直接改生成文件。
## 4. OpenMausBot:从外到内怎么分
```text
用户
→ React 网页 / Electron 窗口
→ 自有 HTTP API 与实时事件
→ Node 服务:Bot、会话、群聊、权限、调度、持久化
→ 统一驱动接口
→ CLI / ACP / API 模型执行
→ 电脑、浏览器、文件、MCP、外部应用等工具
Electron 还承担桌面启动、系统桥接与本地设备能力。
云端与远程功能在核心聊天之外有额外的服务组件和部署条件。
```
| 源码区 | 职责 |
|---|---|
| [网页前端](../OpenMausBot/src/) | 主应用、界面组件、状态与请求处理 |
| [后端](../OpenMausBot/server/) | 主服务与具体业务能力 |
| [引擎适配](../OpenMausBot/server/drivers/) | 把不同 Agent 引擎统一接到应用 |
| [共享结构](../OpenMausBot/shared/) | 前后端之间的类型、规则和数据约定 |
| [桌面进程](../OpenMausBot/electron/) | 窗口、启动、更新和系统桥接 |
| [脚本](../OpenMausBot/scripts/) | 构建、控制命令与配套工具 |
[主界面装配](../OpenMausBot/src/App.tsx#L19) 直接接入单聊、群聊、活动、文件、电脑、虚拟机、插件、团队图、触发器等面板。[驱动注册](../OpenMausBot/server/drivers/builtIn.ts#L32) 显示它不是只接一个模型:Claude、Codex、多个 ACP Agent 以及 OpenAI-compatible 等模型 API 都走对应适配器。
注意:驱动是“接线转换层”,不是这些第三方引擎本身;存在适配器也不代表本机已安装引擎、已经登录或配置了有效账号。
还要把这些配套项目与核心后端分开看:
| 配套组件 | 职责与边界 |
|---|---|
| [手机伴随服务](../OpenMausBot/companion/package.json#L6) | 让已经配对的手机连接核心服务,不替代核心 Agent 执行 |
| [远程中继](../OpenMausBot/relay/src/server.ts#L15) | 分别接入 host、data、phone 的 WebSocket 连接 |
| [云主机连接器](../OpenMausBot/connector/package.json#L6) | 通过出站连接把用户自己的服务器纳入云端管理 |
| [Cloudflare 控制平面](../OpenMausBot/cloudflare/control-plane/README.md#L3) | 云账号身份、安装归属和托管连接入口;文档明确它不存放本地 Bot、聊天与 SQLite 会话数据 |
| [手机协议包](../OpenMausBot/packages/phone-protocol/) | 手机连接相关的共享协议约定 |
| [文档站](../OpenMausBot/apps/docs/) | 产品文档页面,不是聊天前端 |
## 5. 两者都要沿着这条链理解
以“让两个 Bot 一起分析文件”为例:
1. 前端收集文字、附件和目标 Bot/群聊。
2. 后端检查权限、工作目录和当前会话,接收或排队。
3. 团队模块决定消息发给谁,维护上下文和协作关系。
4. 执行引擎向模型发送输入,再调用读文件等工具。
5. 工具结果回到执行引擎,模型继续分析或给出回答。
6. 后端保存结果、更新状态,前端显示过程和产物。
DS Bot 的第 4 步主要交给 DSH;OpenMausBot 通过自己的驱动体系衔接执行。两边的界面可以长得相似,但底下的会话 ID、事件格式、权限和数据保存方式不同。
DS Bot 也支持本地 Agent,并非只能直接调用模型 API:[本地 Agent 入口](../ds-bot/ds-bot/src/host/local-agents/index.js#L1) 会发现 CLI、注册 DSH 模型适配器,并保存 DSH Session 与 CLI Session 的对应关系。这和 OpenMausBot 的自有驱动体系是两种接入方式。
DS Bot 的 JSON 保存团队状态,不代表所有数据都是 JSON:[聊天搜索索引](../ds-bot/ds-bot/src/host/chat-index.js#L48) 使用 SQLite,真正的 DSH 会话记录另由宿主管理。迁移时不能只搬团队配置文件就认为带走了全部聊天历史。
## 6. 对三省六部 v0.0.1 的直接意义
这部分是基于架构的判断,不是已经确定的实施方案。
- 如果继续在 DSH 内做部门团队,DS Bot 的宿主接入、角色配置、会话管理和消息协作与现有环境更接近。
- 如果做脱离 DSH 的独立产品,OpenMausBot 的自有前后端、驱动接口和桌面管理更值得详细研究。
- 不能把两个项目的文件夹直接拼起来就得到一个完整产品。至少要统一 Bot 身份、会话、任务、权限、事件和存储接口。
- Main Bot/管理员权限不等于三省六部的审核、退回、执行制度;现有角色系统只是基础。
- 一个 Bot 绑定文件夹,也不等于项目之间的配置、上下文、任务、模型与运行操作已经全部隔离。项目隔离仍需逐层设计和验收。
- 电脑控制、云电脑、手机、邮件和外部应用均属于能力层,不能据此推断核心聊天必须启动全部外部服务。
## 7. 详细模块手册
- [DS Bot 分层与功能模块拆解](ds-bot-analysis.md)
- [OpenMausBot 分层与功能模块拆解](openmausbot-analysis.md)
详细手册给出各模块的职责、源码入口、数据与通信链路、运行依赖,以及源码存在和本机实测之间的区别。

View File

@ -1,106 +0,0 @@
# 三省六部 v0.0.1 客户端契约调研
日期:2026-11-14。只读调研;唯一新增文件为本笔记。后续任务曾短暂授权客户端实现,随后根任务改为“第一版方案 + dsh-go 样式预览”;未新增或修改客户端实现。
## 结论
Web 与 dsh-go 必须分开设计。Web 保留项目树与原生 session chat,仅追加入口及右面板;DS Bot 整套前端不可搬用,因为其显式替换 sidebar.workspaces 与多个 conversation 槽。dsh-go 是具有原生组件协议与 engine bridge 的 App;参考文档明确涉及 Android 验收,不能把响应式手机 Web 当作 dsh-go。当前已读原生桥不证明可注册桌面右 sidebar、不证明支持打开另一 session,也不提供 workspaceId。第一版原生样式只能标为概念预览,不能宣称已接线。
## 已读证据与版本
- [DS Bot manifest](../ds-bot/ds-bot/package.json):0.3.6;exports `.` → `./index.js`、`./client` → `./client.js`;`dsh.client.platform = "web"`。
- [DS Bot 测试宿主版本](../ds-bot/ds-bot/dev/harness/package.json):`@deepseek-ai/dsh = 0.2.2-rc.1`。这是参考仓库锁定版本,不是当前宿主运行版本证明。
- [DS Bot 客户端入口](../ds-bot/ds-bot/src/client/index.js):61–63 行 export inject/apply;104–108 行通过 workspaces.list 查询 session 所属 workspace;916–933 行 sidebarRight.openTab;982–985 行 slots 注册;1088 行 sidebar.workspaces 替换。
- [DS Bot transport](../ds-bot/ds-bot/src/client/api.js):8–41 行。
- 原生参考包 `@changfenhuang/dsh-genui` 0.16.0,已读其 [manifest](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/package.json)、[dsh-go 文档](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/docs/dsh-go.md)、[桥接类型](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/src/plugin/dsh-go-types.ts)、[面板实现](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/src/plugin/dsh-go-native.ts)、[只读工具卡投影](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/src/plugin/dsh-go-view.ts)、[原生组件编译器](C:/Users/qyh15/.dsh/profiles/desktop/node_modules/@changfenhuang/dsh-genui/src/plugin/dsh-go-compiler.ts)。仅读取 node_modules 下的包代码和文档,未读取用户配置、凭据。
## Web:已验证使用方式,未把未读签名当成公开保证
参考插件使用 `export const inject = ["sessions", "uiWorkspace", "uiConversation", "slots", "theme", "layout"]` 和 `export function apply(ctx) { ... }`。以下是已读调用,而非完成核对的宿主类型清单:
```js
ctx.slots.inject(name, () => ctx.slots.register({ name, id, order, inject }, Component));
ctx.get("sidebarRight")?.openTab("terminal");
ctx.get("sidebarRightTabs")?.get("terminal");
ctx.sessions.list.getSnapshot();
ctx.sessions.binding(sessionId);
const items = ctx.get("workspaces")?.list?.getSnapshot()?.items ?? [];
const owner = items.find(item => item.sessionIds?.includes(sessionId))?.workspaceId;
```
`sidebar.footer.action` 是参考插件已有的追加型入口用法;`sidebar.workspaces` 是其项目树替换方式,本需求禁止照搬。`sidebarRightTabs.register`、navigation 精确签名、当前 workspace 的 authoritative selection、打开 native chat 的 exact API 尚未由本轮宿主导出类型核实,不能据此写假接口。通过 sessionIds 查所属 workspace 也不能用于无 session 时随机挑第一个项目。
网络传输最小例(与参考插件同结构):
```js
async function request(endpoint, payload, signal) {
const res = await fetch("api/sansheng", {
method: "POST", credentials: "same-origin",
headers: { "content-type": "application/json" },
body: JSON.stringify({ endpoint, payload: payload ?? null }), signal,
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const result = await res.json();
if (!result.ok) throw new Error(result.error?.message ?? "请求失败");
return result.value;
}
```
建议后端成功 `{ok:true,value:view}`,失败 `{ok:false,error:{code,message}}`。根 Agent 已收到此建议。请求必须捕获 projectId + generation/revision,结果到达后核对当前项目;项目变化时 abort/丢弃旧响应。此处是设计约束,未声称已实现。
## dsh-go:真实桥接签名与最小原生示例
GenUI 的类型文件对 Cordis Context 声明 `dshGo: NativeBridge`,但该文件没有独立 package export。不要 import 其内部源码。实际宿主桥是否存在应延迟注入探测:`ctx.inject(["dshGo", "sessions"], native => ...)`。这份接口是已安装公开插件的真实使用证据,不是本轮读取宿主 dshGo SDK 得到的兼容承诺。
```ts
type NativeScope = { sessionId?: string; messageId?: string; callId?: string };
type NativeEvent = { action?: string; value?: unknown; locale: string };
type NativeCaps = { locale: string; components: string[] };
type NativeEffect =
| { type: "refresh"; id?: string }
| { type: "copy" | "toast" | "insert"; text: string }
| { type: "link"; url: string };
interface NativeBridge {
panel(id: string, definition: {
view(scope: NativeScope, caps: NativeCaps): NativeView;
data?(scope: NativeScope, emit: (data: Record<string, unknown>) => void): () => void;
}): () => void;
on(id: string, handler: (scope: NativeScope, event: NativeEvent) =>
NativeEffect[] | Promise<NativeEffect[]>): () => void;
refresh(id: string, scope?: NativeScope): void;
}
```
最小形状示例(仅说明已读 view 节点,不代表完整插件可安装 manifest):
```js
ctx.inject(["dshGo"], native => {
native.effect(() => native.dshGo.panel("sansheng", {
view: (scope, caps) => ({
type: "stack", children: [
{ type: "text", text: "三省六部" },
{ type: "callout", tone: "info", text: scope.sessionId
? "当前对话的十席概览" : "请先从已加载的对话打开" },
{ type: "list", items: [{ title: "尚书省", subtitle: "统筹执行 · 待连接" }] },
],
}),
}));
});
```
实际模块通过 `@deepseek-ai/dsh-session` 的 `appendPluginRecord` / `pluginRecordOf` 持久化状态;这两项缺失时展示要求 DSH 0.2.1-rc.2 或更新版本的提示。这个版本门槛针对该持久原生面板方案,不是所有 dsh-go 功能的最低版本。GenUI 文档说明 manifest 提供 composer shortcut 和 session/chat panel;本轮没有读到对应 manifest 注册定义,不能给出编造的入口注册格式。
## dsh-go 样式预览边界
真实编译器以 `stack/children` 与 `row/children` 布局,文字用 `text` 字段(不是 Web GenUI 的 content);列表 `list.items` 使用 title/subtitle/action;度量 `metric`,键值 `keyValue`,提示 `callout` tone 为 info/good/warn/bad。Web card 在转换中变成 stack,并非独立原生 CSS 卡片。
原生面板可用按钮、单选列表、多选组、switch、tabs、accordion、复制与确认 HTTPS 链接。单个 options 最多 8 项且标签唯一、≤80 字符、不得换行;十席不能塞一个十项 options,应按三省/六部分组或使用 list。模型可做已有选项选择;当前桥不提供自由文本/密码字段,因此不能把备注编辑或自填模型 ID 画成已经可用的原生输入框。
容量:tool card 8 KiB / 40 nodes / depth 6,只读;model fence 整体 JSON 16 KiB;native panel 32 KiB / 120 nodes / depth 8。自由文本、slider、ECharts、SVG/Mermaid、3D、音视频不能保持原交互。SVG 树连线不应当成原生支持;十席层次可由标题、分组 list、stack 体现。
原生 panel scope 无 workspaceId,effect 无 session-navigation。三栏布局、右 sidebar 扩展、当前项目读取及角色点击打开另一原生 session 均需要另外核实宿主/App契约。独立 dsh-go 预览应明确“原生组件概念布局”,不能宣称与 Web 三栏完全一致。局部 bridge 存在也不等于当前客户端就是 dsh-go。
## 调研覆盖限制
给定 `resources/app.asar/dsh` 在普通文件搜索工具中不可作为目录读取;`.dsh/dsh-runtimes` 查到的仅 runtime manifest 与 dependencies。公开 Github main tree 请求为 404,npm 包页面重定向到登录,dsh.so/docs fetch 失败,均未作为接口证据。历史 `832e265` workbench/panel 源输出被截断,因此只将其当历史参考,未把未完整读取部分认定为官方契约。没有运行或安装插件、修改宿主、读取用户 profile 配置、构建或设备验收。

View File

@ -1,279 +0,0 @@
# DS Bot 实际源码架构拆解
> 分析日期:2026-11-14。静态只读审查;未安装依赖、未启动应用、未执行测试或仓库脚本。本文只写入工作区根目录 docs,不修改任何仓库。
> “已实现”指存在已接入的源码,不代表本机运行验证通过。第三方服务是否可用、具体安装包能否启动,不能由本次静态审查保证。
## 1. 先分清两个 ds-bot
工作区是 C:/Users/qyh15/三省六部。外层 [ds-bot](../ds-bot/) 是整个 Git 项目;内层 [ds-bot/ds-bot](../ds-bot/ds-bot/) 是可发布的 DSH 插件包。二者不是两个重复项目。
已先读 [AGENTS.md:7–10](../ds-bot/AGENTS.md#L7),其中明确区分插件与桌面应用;[AGENTS.md:22–28](../ds-bot/AGENTS.md#L22) 要求使用 DSH 公共入口、不修改 DSH、生成文件不手改、不碰用户自有数据。
- [核心插件目录](../ds-bot/ds-bot/):Bot 团队业务、浏览器 UI、工具、存储、外部能力。
- [桌面应用目录](../ds-bot/app/):Electron、自己的 React 页面、精简 DSH engine、安装升级和导入。
- [手机应用目录](../ds-bot/mobile/):React Native / Expo 客户端,并非桌面网页简单缩小。
- [加密链路目录](../ds-bot/link/):手机与电脑通信协议、配对、WebSocket Relay 服务。
- [设计文档目录](../ds-bot/docs/plans/):已定设计与限制,不应一概当成未实现路线图。
**一句话架构:DS Bot 是建立在 DSH 执行引擎之上的长期机器人团队工作台。它自己管理“谁是谁、谁找谁、群里怎么工作、记住什么”,DSH 管真正的 Session、模型请求、工具执行和宿主能力。**
核心插件以 [index.js:55–86](../ds-bot/ds-bot/index.js#L55) 的 Cordis 风格 name / inject / apply 注册;不是一套独立 Express、FastAPI 或 Spring 后端。
## 2. 前端:同一批 Bot 组件,三种承载方式
### 2.1 嵌在 DSH Web / Desktop 的插件页面
框架是 React,普通 JavaScript ESM,广泛使用 createElement 而非必须依赖 JSX;例如 [sidebar.js:1–18](../ds-bot/ds-bot/src/client/sidebar.js#L1) 直接导入 React Hooks、createPortal。
入口为 [src/client/index.js:61–63](../ds-bot/ds-bot/src/client/index.js#L61)。它注入 sessions、uiWorkspace、uiConversation、slots、theme、layout,向 DSH 的既有界面槽位挂组件;[index.js:982–985](../ds-bot/ds-bot/src/client/index.js#L982) 展示具体 slots 注册。
发布入口是生成的 [client.js](../ds-bot/ds-bot/client.js),包的 exports 声明见 [package.json:24–30](../ds-bot/ds-bot/package.json#L24)。构建脚本由 [package.json:45–50](../ds-bot/ds-bot/package.json#L45) 指向 esbuild 构建;实际修改应发生在源码目录。
页面不是只有聊天框。入口导入已经体现这些组成:[index.js:1–32](../ds-bot/ds-bot/src/client/index.js#L1)。
- 侧栏、团队角色和形象:sidebar、characters、mark、themes。
- 聊天内容与输入:cells、composer、questions、widget-cell、at-menu。
- 群聊与工作状态:成员状态、群设置、目标状态及协作消息。
- 设置与管理:模型、Provider、权限、记忆、定时任务、连接器、能力、用量。
- 浏览器、电脑接管、密钥卡、临时问题与侧聊:独立面板结合聊天状态展示。
这些 UI 依赖后端 team view、Session 投影和动作接口;复制组件时必须带上对应数据适配层,不能只拷 CSS 就获得完整应用。
### 2.2 独立桌面页面
桌面有自己的 [app/ui/src/main.js:1–19](../ds-bot/app/ui/src/main.js#L1),导入 React、createRoot 与 App,同时直接复用核心插件的侧栏、设置、主题 CSS 和国际化代码。
技术依赖明确为 React 19.3.0、React DOM 19.3.0、Vite 8.3.4;另用 react-markdown、remark-gfm,见 [app/package.json:74–85](../ds-bot/app/package.json#L74)。这不是 Vue / Next.js 前端。
桌面自己的页面只与 Bot channel 对话:[api.js:1–2](../ds-bot/app/ui/src/api.js#L1) 写明 POST api/bot 与 api/bot/feed。实时事件通过 fetch 流读取 SSE,而非 EventSource,原因是窗口使用自己的 scheme,见 [api.js:16–29](../ds-bot/app/ui/src/api.js#L16)。
### 2.3 手机页面
手机入口由 [mobile/package.json:4](../ds-bot/mobile/package.json#L4) 指向 index.ts,App 的启动分支在 [App.tsx:122–137](../ds-bot/mobile/App.tsx#L122):身份、电脑配对、语言准备好后才进入 Linked 视图。
依赖为 Expo 58、React Native 0.88、React Navigation、SecureStore、相机、图片选择、生物识别等,见 [mobile/package.json:5–34](../ds-bot/mobile/package.json#L5)。这是独立原生客户端,有真实代码,但本次未构建 APK/IPA。
## 3. 后端入口、模块组织与 API
### 3.1 宿主与插件的分工
[index.js:56](../ds-bot/ds-bot/index.js#L56) 要求 llm、tools、systemPrompt、sessionController、sessions、sessionTitle、workspaceRegistry、connection。
[index.js:63–89](../ds-bot/ds-bot/index.js#L63) 按顺序调用各模块 install(rt),把共享函数放在 runtime 对象上。模块之间在运行时经 rt 调用,不是每块单独启动服务。
这是一种“单进程业务模块 + 宿主服务依赖注入”的组合。安装顺序影响监听器和工具顺序,入口 [index.js:58–62](../ds-bot/ds-bot/index.js#L58) 特别说明 privacy 应先拦截、usage 应后计量。
普通文件操作、Shell、Subagent、Web、工作流等执行器大多来自 DSH;精简 engine 的依赖清单 [engine/package.json:26–59](../ds-bot/app/engine/package.json#L26) 可以直接对照。不要把这些全算成 DS Bot 自写的执行引擎。
### 3.2 API 是统一动作通道
[channel.js:844–854](../ds-bot/ds-bot/src/host/channel.js#L844) 通过 ctx.connection.fetch.register 注册 POST route。请求 JSON 中用 endpoint + payload 选择业务动作;响应采用 ok/value 或 ok/error,见 [channel.js:55–58](../ds-bot/ds-bot/src/host/channel.js#L55)。业务错误并不都表现为不同 HTTP 状态。
浏览器认证复用 DSH connection cookie;不是 DS Bot 另建了一套用户登录数据库。
主要接口组与源码位置:
- 团队状态、模型、Provider、思考设置:[channel.js:238–278](../ds-bot/ds-bot/src/host/channel.js#L238)。
- 会话读取、历史、运行统计、用量、群进展:[channel.js:287–330](../ds-bot/ds-bot/src/host/channel.js#L287)。
- 创建修改删除 Bot、Main 身份、头像、群和工作目录:[channel.js:342–417](../ds-bot/ds-bot/src/host/channel.js#L342)。
- 普通 DSH Agent 会话、侧栏分区:[channel.js:420–451](../ds-bot/ds-bot/src/host/channel.js#L420)。
- 审批、停止工作、群目标、关闭交互卡:[channel.js:459–495](../ds-bot/ds-bot/src/host/channel.js#L459)。
- 密钥操作入口从 [channel.js:503](../ds-bot/ds-bot/src/host/channel.js#L503) 开始,其他能力由同一 handler 分流到其模块。
实时推送另走 feed:事件序列化为 SSE,保存触发监听,并支持手机接入用的 tap,见 [feed.js:34–48](../ds-bot/ds-bot/src/host/feed.js#L34)。手机与桌面尽量复用业务视图,而不是各写一份 Bot 后端。
### 3.3 模型可调用的工具
Bot 专属工具放进 teamTools,并按 Bot Session scope 注册,而非全局暴露给所有 DSH 会话,见 [index.js:78–89](../ds-bot/ds-bot/index.js#L78)。
核心工具有 list_bots、message_bot、stop_bot、create_bot、update_bot、list_bot_models,见 [tools.js:80](../ds-bot/ds-bot/src/host/tools.js#L80)、[tools.js:167](../ds-bot/ds-bot/src/host/tools.js#L167)、[tools.js:298–363](../ds-bot/ds-bot/src/host/tools.js#L298)、[tools.js:453](../ds-bot/ds-bot/src/host/tools.js#L453)。
群管理与交互有 create_group、update_group、delete_group、post_to_group、ask_user、show_view,见 [tools.js:496–726](../ds-bot/ds-bot/src/host/tools.js#L496)。还有 group_relay、read_own_chat、read_group_chat,见 [groups.js:1–2](../ds-bot/ds-bot/src/host/groups.js#L1)。
能力管理工具有 list_capabilities、save_capability、delete_capability,见 [tools.js:1129–1185](../ds-bot/ds-bot/src/host/tools.js#L1129)。目标工具 group_goal 位于 [goals.js:670–709](../ds-bot/ds-bot/src/host/goals.js#L670),不是只有文档里的口头流程。
注意:界面有 delete-bot 动作不等于模型拥有 delete_bot 工具;用户层操作与 Bot 工具权限必须分别判断。
## 4. 桌面壳:真正的多进程分工
Electron 主入口是 [app/package.json:12](../ds-bot/app/package.json#L12) 声明的 main.mjs;[main.mjs:8](../ds-bot/app/src/main.mjs#L8) 导入 BrowserWindow、IPC、Tray、WebContentsView 等原生组件。
主进程负责窗口、系统托盘、文件选择、下载、浏览器视图、首次设置、导入和更新;宿主运行在独立子进程。实际 Host 创建见 [main.mjs:573–590](../ds-bot/app/src/main.mjs#L573)。
Host 明确把 DSH_HOME 设为应用数据目录,同时传入工作文件夹、runtime 目录、用户原 DSH 数据位置。其 app profile 不等于用户日常运行的 DSH profile。
[host.mjs:8–43](../ds-bot/app/src/host.mjs#L8) 调用公开 runProfile 入口并加载 layered env、profile 和应用自己的 patch。这里的 patch 是配置组合,不是修改 DSH 安装源码。
[engine/cordis.patch.yml:1–5](../ds-bot/app/engine/cordis.patch.yml#L1) 明确没有 DSH Web 前端:engine 只给 Bot API 提供回环 HTTP 服务、连接和 Session 执行能力。
Host 启动后生成 authenticatedUrl,经 IPC 回主进程,见 [host.mjs:61–72](../ds-bot/app/src/host.mjs#L61)。engine 根路由只做启动 token 换 cookie,授权后返回 204,见 [engine/index.js:7–18](../ds-bot/app/engine/index.js#L7)。
关闭窗口通常只是隐藏,机器人继续在后台工作;真正退出经托盘处理,见 [shell.mjs:1–15](../ds-bot/app/src/shell.mjs#L1)。这也是“长期 Bot”在桌面生命周期上的基础。
## 5. 一条消息到底怎么跑
1. 用户在 React / 手机 / IM 界面发消息;桌面到 Bot API,手机走加密链路,IM 由平台适配器转成内部请求。
2. [channel.js:802–815](../ds-bot/ds-bot/src/host/channel.js#L802) 把 Bot 或旧分段引用解析成当前 Session,准备 capabilities,然后 sessionController.prompt(mode: queue)。
3. DSH 解析 Agent、加载模型和工具,进入常规执行回合。DS Bot 在旁跟踪状态、注入身份/记忆/群目标等上下文。
4. Bot 想找同伴时调用 message_bot;delivery 解析接收方 Agent,[delivery.js:10–14](../ds-bot/ds-bot/src/host/delivery.js#L10) 使用 DSH sessionController,而不是启动一个独立模型服务器。
5. handoffs 保存上下级工作关系,子工作全部归来后把结果送回上层;见 [handoffs.js:1–7](../ds-bot/ds-bot/src/host/handoffs.js#L1)。
6. turns 跟踪运行、失败和回报路由;feed 推 UI;需要长时记忆时由 memory 的审核/写入链处理。
7. 上下文快满时压缩或切新 Session;旧段继续可查,见 [parts.js:1–16](../ds-bot/ds-bot/src/host/parts.js#L1)。Bot 身份不随 Session 换段消失。
群聊有所不同:[groups.js:4–18](../ds-bot/ds-bot/src/host/groups.js#L4) 规定 @ 同时点名的成员可并行开工;普通消息在 admin 模式只到管理员,否则按序发言;忙着做工具工作的成员不会无限卡住一轮。
**所以 Bot 不是一个永不更换的单 Session,群也不是把所有成员塞进一个共享模型上下文。** Bot 私聊、成员在群中的 Session、历史分段是分别管理的。
## 6. 大功能模块手册
### 6.1 身份、角色、团队和普通 Agent
职责:维护 Bot 名字、角色说明、模型、头像、Main 身份、群及成员。关键路径 [roster.js:1–5](../ds-bot/ds-bot/src/host/roster.js#L1),操作工具见前述 tools。
关系:store 持久化身份,folders 选工作路径,permissions 应用权限,parts 管 Session 换代。另有普通 DSH Agent 入口,不属于 Bot、不带团队工具,[agents.js:1–3](../ds-bot/ds-bot/src/host/agents.js#L1)。
Main Bot 表示更高的团队管理权限,可以有多个;它不是预设“六部职责—门下审查—尚书执行”的固定制度。部门称号可用角色说明表达,但严格业务审批链需另建状态机。
### 6.2 私聊协作、交接与去重
职责:消息派送、等待、停止、返还结果、识别正在做什么。关键路径 [delivery.js:1–14](../ds-bot/ds-bot/src/host/delivery.js#L1)、[turns.js:1–16](../ds-bot/ds-bot/src/host/turns.js#L1)、[handoffs.js:1–7](../ds-bot/ds-bot/src/host/handoffs.js#L1)。
requests 给调用方指定 request_id 的请求提供稳定回执与指纹,先记录再发送,未知结果不自动重投,[requests.js:1–13](../ds-bot/ds-bot/src/host/requests.js#L1)。它限制重复派工,不等于任意外部副作用都有全局事务保证。
### 6.3 群聊、目标、工作阶段与审批
职责:管理员/成员调度、并行 @、轮次回报、群消息、任务阶段。groups 与 ledger、turns、goals 相互配合,[groups.js:19–32](../ds-bot/ds-bot/src/host/groups.js#L19)。
group_goal 支持 draft/start/revise/task/pass/rework/complete/pause/resume/stop;只有群管理员或 Main Bot 能修改。pass 和 complete 要求 evidence,见 [goals.js:288–299](../ds-bot/ds-bot/src/host/goals.js#L288)、[goals.js:670–671](../ds-bot/ds-bot/src/host/goals.js#L670)。
这里校验的是目标状态与证据字段,并不自动证明模型提供的证据真实,也不是通用 BPMN 工作流引擎。业务审批应区分“群内工作验收”与“宿主工具权限审批”。
### 6.4 上下文续接、历史搜索
职责:长聊压缩、换段、交接包、历史页。关键路径 [parts.js:1–16](../ds-bot/ds-bot/src/host/parts.js#L1);read_own_chat 可查各段和压缩前消息。
聊天全文索引单独存 SQLite,使用 node:sqlite / FTS5 trigram,见 [chat-index.js:48–110](../ds-bot/ds-bot/src/host/chat-index.js#L48)。它服务历史检索,不是整个应用的唯一数据库。
### 6.5 长期记忆、审核、召回与整理
职责:Bot / 群 / 团队三层 Markdown 记忆,话题索引、修改日志、快照、删除后的归档;工具与后台审核走同一写入路径,[memory.js:1–26](../ds-bot/ds-bot/src/host/memory.js#L1)。
与 Session 的关系:每段首次渲染冻结记忆提示段,保证前缀缓存稳定;换段或 checkpoint 再冻结。群记忆只在群上下文里给成员读取,并非一份任意串用的团队聊天摘要。
召回使用内存词项排名,类似 BM25 参数与词项覆盖度,见 [memory-search.js:1–29](../ds-bot/ds-bot/src/host/memory-search.js#L1)。没有据此把它称为向量数据库、embedding RAG 或外置知识图谱的依据。
### 6.6 工作文件夹、权限与私密 Bot
职责:决定 Session cwd,按 Bot/群保存权限预设,保护私密 Bot 信息。群文件夹优先于成员覆盖、Bot 默认和团队目录,见 [folders.js:1–4](../ds-bot/ds-bot/src/host/folders.js#L1)、[folders.js:23–33](../ds-bot/ds-bot/src/host/folders.js#L23)。
权限来自 DSH permissionPresets;auto review 是 Session 临时模式,不可作为 Bot/群长期预设,见 [permissions.js:1–5](../ds-bot/ds-bot/src/host/permissions.js#L1)、[permissions.js:41–47](../ds-bot/ds-bot/src/host/permissions.js#L41)。
私密 Bot 关闭其他 Bot 的业务读入口并检查文件/Shell 路径,但源码明说 Shell 仍可能访问 OS 账号可读的任意文件,[privacy.js:1–4](../ds-bot/ds-bot/src/host/privacy.js#L1)。因此不是进程、容器或多租户安全隔离。
### 6.7 模型、思考、Provider、用量与诊断
职责:选择每个 Bot 的模型/推理强度,管理 Provider 配置和展示用量、阻塞原因;入口模块装配见 [index.js:7–10](../ds-bot/ds-bot/index.js#L7)、[index.js:40–43](../ds-bot/ds-bot/index.js#L40)。
数据关系:模型列表从 DSH 取,不完全受团队 revision 控制,[channel.js:59–61](../ds-bot/ds-bot/src/host/channel.js#L59)。缺密钥、配额、登录和本地 CLI 错误被 turns 标为需要用户修复的阻塞,[turns.js:14–20](../ds-bot/ds-bot/src/host/turns.js#L14)。
### 6.8 能力库、MCP、技能、学习提案
职责:保存可分配给 Bot 的 MCP、skill 和能力包,按 Session 挂载;保留 connector 名称避免工具前缀冲突,[capabilities.js:5–32](../ds-bot/ds-bot/src/host/capabilities.js#L5)。
learning 对长回合在空闲后做低频审核,提出技能或项目规则卡片,经批准才落地,拒绝的建议会被记住,[learning.js:1–30](../ds-bot/ds-bot/src/host/learning.js#L1)。这已是代码实现,但不意味着可不受约束地自我重写系统。
### 6.9 浏览器、联网搜索、电脑操控
浏览器面板:每 Bot 独立 Electron 存储分区;Host 通过 browser-wait/browser-result 长轮询请求页面读取,见 [browser.js:1–18](../ds-bot/ds-bot/src/host/browser.js#L1)。需要实际承载页面的客户端在线。
自动化:团队选一个浏览器后端,各 Bot 独立 profile,已有 refs/script/task 三种模块,[browser-plugins.js:1–12](../ds-bot/ds-bot/src/host/browser-plugins.js#L1)。
联网搜索是独立 auto provider:优先按当前模型协议和自身凭据尝试原生搜索,失败再公共搜索页回退,[web-search.js:1–24](../ds-bot/ds-bot/web-search.js#L1)。与 Bot 团队代码分离较好,但仍依赖 DSH web seam。
电脑操控挂载 DSH 平台 Provider,DS Bot 补每 Bot 等级、应用同意、应用租约、指示器与人工交接;见 [computer/index.js:1–30](../ds-bot/ds-bot/src/host/computer/index.js#L1)。不能据此假定三个系统实际权限和驱动体验一致。
### 6.10 密钥、通用连接器、邮件
密钥独立保存,通过 DSH_SECRET 环境变量引用;模型请求和工具结果做脱敏,见 [secrets.js:1–4](../ds-bot/ds-bot/src/host/secrets.js#L1)。这是应用级保护,文件 mode 600 不等于静态加密。
连接器模块组合 OAuth、catalog、gateway、mail 与 MCP client,[connectors/index.js:1–17](../ds-bot/ds-bot/src/host/connectors/index.js#L1)。MCP loader 缺失时明确失败,[connectors/index.js:147–148](../ds-bot/ds-bot/src/host/connectors/index.js#L147)。
关系:连接器凭据由 secrets 提供,能力可分配给 Bot,邮件依赖 imapflow/mailparser/nodemailer;不是自带所有 SaaS 的离线替代品。
### 6.11 IM、手机与 Relay
IM 一个平台 Bot 账号绑定一个内部 Bot,平台群可映射 DS Bot 群;统一处理配对、路由、交互卡与发送队列,仅团队锁持有者连接,[im/index.js:1–4](../ds-bot/ds-bot/src/host/im/index.js#L1)。
源码已注册 Telegram、Discord、Slack、QQ、钉钉、企业微信、飞书、微信适配器;其余 UI 列表项可能只是 coming soon,[im/platforms/index.js:1–12](../ds-bot/ds-bot/src/host/im/platforms/index.js#L1)。存在 adapter 不代表本次已验证账号和远端服务。
手机后端负责设备配对、撤销与状态,[phone.js:123–159](../ds-bot/ds-bot/src/host/phone.js#L123)。加密协议依赖 clatterjs 与 noble 系列,[link/package.json:13–18](../ds-bot/link/package.json#L13)。
Relay 是 Node HTTP + WebSocket:healthz、upgrade 路径检查、Gateway 和 DeviceStore,[server.ts:23–43](../ds-bot/link/server/server.ts#L23)。服务入口可配置端口、设备 TTL、连接数等限制,[main.ts:7–16](../ds-bot/link/server/main.ts#L7)。它负责链路转发,不替电脑执行模型回合。
### 6.12 定时、Office、图片头像与更新
定时任务依赖 DSH schedule 服务;会话换段后迁移任务,服务缺失时接口报告不可用,[schedules.js:1–7](../ds-bot/ds-bot/src/host/schedules.js#L1)。因此装上插件不代表自动具备完整调度服务。
Office 注册路由 skill 与 office-tools;CLI 可检查/编辑 docx、pptx、xlsx 包,[office-skills.js:1–14](../ds-bot/ds-bot/src/host/office-skills.js#L1)、[office/cli.js:1–22](../ds-bot/ds-bot/src/office/cli.js#L1)。没有证据把它称作浏览器内完整 Office 协同编辑器。
图片、头像库、更新、DSH 更新、思考显示等均在运行时入口接入,[index.js:30–43](../ds-bot/ds-bot/index.js#L30)。上传暂存由 channel 维护 MIME 白名单与 30 分钟窗口,[channel.js:10–11](../ds-bot/ds-bot/src/host/channel.js#L10)。
### 6.13 本地 Agent CLI
本地 CLI 作为 Bot 执行方式,不只是模型下拉列表别名。引擎有 ACP/stdin-stdout、Codex app-server JSON-RPC、Claude stream-json,[local-agents/engines.js:1–5](../ds-bot/ds-bot/src/host/local-agents/engines.js#L1)。
已有 Claude Code、Codex、OpenCode、Gemini 等命令定义,见 [engines.js:18–22](../ds-bot/ds-bot/src/host/local-agents/engines.js#L18);权限预设要映射到各引擎语义,[engines.js:80–89](../ds-bot/ds-bot/src/host/local-agents/engines.js#L80)。本机必须另有相应 CLI、登录和权限,不能当成仓库随附的模型。
## 7. 数据存放:不是“只有一个 JSON”
默认 Bot 数据根为 DSH_HOME/bot,也可 config.home 覆盖,[index.js:69–77](../ds-bot/ds-bot/index.js#L69)。入口开头“one JSON file”的简述不足以覆盖现在全部存储。
- state.json:Bot/群/Agent/分区/能力/偏好/工作与请求等目录及状态,结构见 [store.js:22–23](../ds-bot/ds-bot/src/host/store.js#L22)。
- state.lock:阻止两个 Host 同时写同一团队;另一窗口只读。锁失败会警告而非神奇获得分布式一致性,[store.js:49–67](../ds-bot/ds-bot/src/host/store.js#L49)。
- ledger/*.jsonl:按会话追加消息和状态记录,先落盘再交付;首次整本读入内存,按 book 串行写,[ledger.js:1–11](../ds-bot/ds-bot/src/host/ledger.js#L1)。
- chat-index.sqlite:聊天历史搜索索引,原始 Session 仍由 DSH sessionPersistence 保存,[chat-index.js:48–110](../ds-bot/ds-bot/src/host/chat-index.js#L48)、[host.mjs:55–58](../ds-bot/app/src/host.mjs#L55)。
- memory/:Markdown 正文、journal、snapshots、summaries、archive、reviewed 游标,[memory.js:6–14](../ds-bot/ds-bot/src/host/memory.js#L6)。
- secrets.json:凭据文件与进程内存,不放进普通团队状态/模型正文,[secrets.js:1–4](../ds-bot/ds-bot/src/host/secrets.js#L1)。
- im/、浏览器 profile、头像、手机配对数据等是功能附属持久数据;不能只备份 state.json 就声称备份完成。
数据规模边界:账本首次整本读入内存,request 身份不随便过期,单团队文件锁与 JSON 状态都偏向个人/本机长期助手。它不是已验证的高并发分布式团队数据库。
## 8. 运行依赖与可用性条件
插件自身要求 DSH 的 Cordis / llm / scope / tools / web peer 服务;实际 peer 版本写 *,[package.json:52–57](../ds-bot/ds-bot/package.json#L52)。不应误解为任何 DSH 版本都保证兼容。
桌面把 DSH 系列包固定在 0.2.2-rc.1,Electron 44.7.0,见 [app/package.json:28–64](../ds-bot/app/package.json#L28)、[app/package.json:75](../ds-bot/app/package.json#L75)。构建与发行还涉及 electron-builder、Vite、pnpm;属于桌面交付依赖。
插件实际运行依赖还包括 MCP client、deep-view、邮件库、playwright-core、图像编解码和 ws,[package.json:72–81](../ds-bot/ds-bot/package.json#L72)。Playwright Core 存在不等于已安装完整浏览器。
模型仍需要有效 Provider 凭据/账户或已登录 CLI;电脑操控需要平台 Provider 和 OS 授权;连接器需要远端服务;手机需要电脑 Host 在线与可达 Relay;定时需 schedule 服务。
Node 必须能满足所用 DSH 包以及 node:sqlite 等 API;本次未执行环境探测,因此不擅自给整个项目一个未经核验的统一 Node 最低版本。
## 9. 哪些是源码实现,哪些是文档规划
[plans/README.md:1–9](../ds-bot/docs/plans/README.md#L1) 明确该目录记录“已定的设计”,大功能设计跟代码在同一 PR。文件名带 plans 不等于功能还没写。
已核实接入的功能:长期身份、多 Main Bot、群聊调度、阶段目标、Markdown 记忆、历史搜索、私密 Bot 业务限制、浏览器、电脑操控、MCP/连接器、学习提案、Office CLI、IM、手机链路、本地 Agent CLI。证据是入口装配 + 对应模块实现,而非 README 宣传语。
文档存在滞后:[vision.md:23](../ds-bot/docs/vision.md#L23) 仍写 self-improvement planned,但 learning 已有“后台审核→提案→用户批准”代码;这仅支持说“有限学习提案已实现”,不支持“全面自我进化”。
同样 [vision.md:28](../ds-bot/docs/vision.md#L28) 写 Cookie 导入 planned,而 [main.mjs:825–845](../ds-bot/app/src/main.mjs#L825) 已有导入分支。应以当前代码描述能力,并保留未运行验证的限定。
IM 的 coming soon 有明确代码边界:只有 adapters 中列出的平台可新增连接。不要把完整平台目录里的每个名字都算已打通。
没有据本次源码得到的能力:固定部门制审核链、跨团队强多租户隔离、任意外部副作用恰好一次、分布式高可用调度、模型结果自动正确性保证。应作为新需求评估,不能从“Main”“workspace”“evidence”这些字段名称推导出来。
## 10. 可复用边界与实际选型建议
**最容易整体复用的是“DSH + DS Bot 插件”组合。** 保留现成 Session、工具、权限和模型服务,开发重点放在角色约束、流程与业务 UI;成本显著小于抽掉 DSH 后重做所有宿主接口。
可以相对独立借鉴/抽取:追加式消息账本与去重设计、记忆格式与词项排名、Office 包处理、加密 Relay、纯 React 展示组件。仍需检查导入依赖、许可证和持久格式,不能称为复制即用。
不适合直接割裂复用:rt 大量互调的群聊/turns/handoffs/parts、依赖 DSH slots 的插件 UI、依赖宿主 Session schema 的历史/权限/模型接口、Electron 原生浏览器与电脑操控。
若用于“多项目、多部门协作平台”,建议保留 Bot 身份与协作机制,但单独定义项目实体、成员/资源授权、产物归属和流程审批状态机;仅改机器人名字、分配文件夹、添加 Main 标记,不会自动补齐这些边界。
源码许可证标注 Apache-2.0,[package.json:23](../ds-bot/ds-bot/package.json#L23);桌面部分明确引用 DSH MIT 代码并要求 NOTICE,[host.mjs:5](../ds-bot/app/src/host.mjs#L5)。复用时应保留相应声明和来源,不把开源许可误当作无义务搬运。
本报告的结论是架构与实现边界,不是安全审计通过、性能测试通过或发布可用性背书。全部源码引用对应本工作区静态版本。

View File

@ -1,84 +0,0 @@
# 三省六部 v0.0.1 宿主公开契约调研
日期:2026-11-14。对象:本机 DSH Desktop runtime 0.2.2-rc.3。只读研究,没有创建、恢复、配置真实会话,没有读取凭据,没有修改宿主/profile/node_modules。唯一写入为本笔记。安装包 ASAR 可由 read 读取,但 glob 无法遍历,声明入口列在 package exports 中、实际声明文件未随安装包提供;因此以下为公开包运行时实现和 DS Bot 调用交叉核实的 JS 调用签名,不冒充完整 TypeScript 声明。原 10–15 次读取预算未守住:ASAR/声明失败探测及重复读取导致超额,此处明确记录。
## 结论
采用一个独立轻量插件,直接使用宿主注入服务。每个项目绑定独立 canonical cwd/workspaceId 和固定十个 roleId → sessionId。不要装载 DS Bot,也不要调用历史 dsbot-runtime;不需要任何群 session。原型可以只做十个普通 root session + 项目配置存储 + 一个动态 systemPrompt section。
尤其不能把 sessionController.create 当恢复;不能调用 sessionController.selectModel 达成“不写 profile”,因为它会后台保存全局默认。无 profile 模型切换是 agent.model.select(selection),前置用 llm 验证路由。不存在已证实的通用 session.configure 或 agents.find 方法;不要从名字猜接口。
## 可直接用的调用契约
下列 C 代表公开包 @deepseek-ai/dsh-api-session-controller 的 lib/index.js;A 代表 @deepseek-ai/dsh-agent 的 lib/index.js;W 代表 @deepseek-ai/dsh-workspace 的 lib/index.js。源码绝对根为 C:/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai/。应用代码只能 import 公开包名字或使用 ctx 服务,不能硬编码此安装路径。
- ctx.workspaceRegistry.get(workspaceId) → Workspace | undefined,同步。W:445。
- ctx.workspaceRegistry.list() → Workspace[],同步、durable registry order。W:454。
- await ctx.workspaceRegistry.resolveByPath(path) → Workspace | undefined,realpath 规范化。W:643。
- await ctx.workspaceRegistry.create(path, title?) → Workspace,目录须存在且为目录,相同 canonical path 重用。W:408,647。
- await workspace.attachSession(sessionId),第一次绑定读取 header.cwd、realpath 后必须等于 workspace.path;不是随意移动会话。W:111–124。workspace.sessionIds 是已有索引过滤后的成员列表。
- await ctx.sessionController.create({sessionId?, workspaceId?, cwd?, agentPreset?}) → {sessionId, agentPreset?}。workspaceId 与 cwd 互斥;使用 workspaceId 时从 workspace.path 得到 cwd。C:724–755,4017。
- await ctx.sessionController.resolveAgent(sessionId) → {agent} | {error},DS Bot 的 delivery.js:10–11 使用此方法;宿主 resolver 会恢复冷会话并按 ID 合并并发 resume,拒绝 subagent 所有的会话。C:175–203。error 必须传播,不能把所有错误当不存在。
- ctx.agents.get(sessionId) → Agent | undefined,只查询活跃内存实例,不恢复;ctx.agents.list() → Agent[]。A:720–728。
- await ctx.agents.create(options)、await ctx.agents.resume(options) 是公开底层工厂入口,但需要正确 preset/setup 生命周期;v0.0.1 优先用 controller,避免手工组成 Agent。A:582–600。
- await ctx.sessionController.rename({sessionId,title}) → {title,seq},内部恢复 Agent 后经 sessionTitle.rename 记录标题。C:792–805。
- await ctx.sessionController.modelCatalog() 返回提供者分组模型、deployment default、isolated provider failures;不要假设模型目录中存在即有可用余额/凭据。C:4044–4049。
- await ctx.llm.resolveCallConfig({provider,model,reasoningEffort?}) 验证路由/effort;controller 用它先校验再 select。C:772。
- agent.model.current() → {provider,model,reasoningEffort?} | undefined;agent.model.select(selection) → void,同步追加 model/selection 事件,相同完整选择不重复追加。A:190–202。
- ctx.systemPrompt.section({name,order,interpolate:false,text: context => string}) → disposer。DS Bot prompt.js:67–72 使用,返回文本按 context.agent.id 查角色;不属于本项目的 session 返回空字符串。插件卸载时释放注册。
### 模型配置最小路线
```js
const resolved = await ctx.sessionController.resolveAgent(sessionId)
if ('error' in resolved) throw resolved.error
const agent = resolved.agent
const selection = { provider, model, ...(reasoningEffort === undefined ? {} : { reasoningEffort }) }
await ctx.llm.resolveCallConfig(selection)
// 再次核对对象仍是此 ID 的活跃 Agent,以及项目映射/版本未发生变化。
if (ctx.agents.get(sessionId) !== agent) throw new Error('Agent changed during configuration')
agent.model.select(selection)
return agent.model.current()
```
select 自身仅记录会话事件,不验证字符串的业务合法性,因此不能省略验证。controller 另外会 requireModel 并检查目录可用性;自建 adapter 应从 modelCatalog 检查 provider/model/effort 后调用 resolveCallConfig。不要调用任何 credentials.get/read,不要为检测可用性发真实模型请求。
## 恢复、去重和生命周期
创建前持久化项目十个 roleId、计划 sessionId 和 provisioning 状态,每角色串行锁(跨进程需持久锁/唯一约束)。然后对计划 ID 查询/resolve;只有明确 session/not-found 才尝试创建。网络/持久层/迁移/preset 错误保留 pending,不生成新 ID。
controller.create 的 request.sessionId 是“空会话复用意图”,不是永久幂等键:内部 claim 可因为已有 turn/start、归档、workspace 不可复用等情况改为 createMinted,并返回另一个随机 ID(C:229, claim 分支,414)。因此调用后必须比较 returned.sessionId 与 plannedId;不一致应记录实际返回 ID 和异常、停止后续创建,不能悄悄覆盖映射或删除记录。workspace attach 失败返回 session/workspace-attach-failed 并附已创建 sessionId(C:744–750),同样须保留并在恢复时修复归属,不能再次创建。
若 session 已存在则核对 header.cwd、root 身份(无 subagent ownership)、预期 workspace 和本地项目/角色映射,随后恢复该 ID。不要用标题匹配身份,不要调用 create 恢复已有聊天。发现用户归档或移走角色会话时提示修复,不自动补造第十一个会话。
新建普通 controller 会话通过 agents.create({sessionId, agentOptions, meta:{cwd,agentPreset?},setup}) 创建(C:423–431),没有 parent/subagent 参数;因此是 root session,不继承某个对话父代理。初始模型从 agentDefaultModel.currentSelection getter 读取(C:433–445),故每角色必须在允许首轮发送前固定自己的 model/selection。
持久角色文字保存在插件项目状态,而不是只存内存 closure。启动先加载映射再注册 prompt section;配置更新后按 sessionId 读取最新版。宿主保留普通会话日志/模型事件;插件保留 roleId、身份、配置版本。禁止 DS Bot 的“上下文满则新 part session”行为,否则固定十个约束被破坏。
## 运行中修改模型
A:137–172 的 projection 保留 lastUsed 与 pending;current 返回 pending ?? lastUsed;request/header 只在匹配时消耗 pending。A:224–237 明确每一步的 route 已固定,并在下一 step 比较模型变化生成提示。因此新选择不会替换已经发出的模型请求;影响后续取样的 step,可能在同一个 turn 内发生。UI 应说明“后续步骤生效”,不能显示为当前请求已切换。
最小产品建议更保守:运行中把配置留作待应用,idle 后验证并 select,再允许下一次发送;避免与图像输入准入及 hosted engine 差异冲突。如支持即时配置,则按会话串行化并复核版本;不要通过 cancel 当前请求实现静默切换。更换 loop engine 的特殊迁移需求未在此次研究完全验证,v0.0.1 可限制为当前可用普通模型路由。
## 权限和项目隔离
独立 root session 并不自动继承当前用户聊天/调用 agent 的权限。DS Bot permissions.js:32–38 明确未设置时保留 DSH 默认;:25–28 通过 ctx.permissionPresets.set(agent.session,name) 设置 session;:17 使用 catalog() 读取 options/defaultPreset;:46 使用 resolve(name) 验证。Auto review 是 session-only,不能作为持久角色权限(:5–6,45)。这些调用是在 DS Bot 源码确认的使用契约,未完整审计 permission-presets 包内部授权实现。
v0.0.1 不替用户升权:不在 provisioning 时写 permission preset;在 UI 清楚展示宿主默认或会话实际权限。若将来允许修改,必须通过宿主正式人类授权入口而不是角色提示词或后台 set 绕过审批。workspace 的 canonical cwd 校验提供归属一致性,不构成安全沙箱;danger-full-access 会话仍可能跨项目读写。要承诺文件级隔离,需另行验证并采用宿主 sandbox/permission 机制。项目业务数据、角色映射、提示词均必须以 projectId/workspaceId/sessionId 校验访问。
## DS Bot 和历史代码能否单独复用
roster.js install(rt) 依赖 state/store、模型、权限、群组、parts、welcome/bootstrap、浏览器 grants 等;它在一个 team workspace 内构建 bot/room,不是独立 session provision 库。agents.js 是 DS Bot 自己的另一类“DSH Agent”记录管理器,依赖 rt.ensureWorkspace/save/index 等,只建普通聊天、并没有持久角色配置。两者不宜直接 import。
models.js 混合 llm 流重试、目录缓存、凭据状态、模型选择同步;:319–327 先 sessionController.selectModel 再恢复默认,仍然会写 profile,且存在异步保存竞争。不能原样复用。可借鉴目录呈现和同 session 序列化设计,但重新写几行独立 adapter。
prompt.js 最小可借鉴点仅 section 注册形式;其 promptFor 依赖 selfOf/botOf 和群组映射,角色正文含 DS Bot 产品语义,不适合直接 install。
历史 Git 233ee76:sansheng/src/provision.js 使用 ctx.get('dsbot-runtime',false)、rt.createBot + rt.createRoom,注释写明三 Bot + 项目群,且提示需要 ctx.provide 基线补丁。这是旧 DS Bot 集成方案,不满足十 root、无群 session、公开原生接口、不改宿主。只保留“项目记录/角色绑定/错误记录”的设计思路,不搬其创建与回滚代码。
## 最小交付建议
一个项目状态 schema(十角色固定枚举、sessionId、模型完整 tuple、instructions、版本、provision status)加一个薄 host adapter 即可。adapter 暴露 project(id)、session(id)、createSession、configureSession、models、onSystemPrompt。project(id) 只代理 workspaceRegistry.get;session(id) 用 resolveAgent;createSession 强校验计划 ID 回执;configureSession 走上文无 profile 路线;models 读 catalog;onSystemPrompt 返回 disposer。
不注册 DS Bot 插件、不引入其前端/浏览器/群、不给角色创建新角色/新会话的工具。UI 首次显式创建,重启仅恢复既有映射。测试用 fake ctx 验证严格十个 ID、创建中断恢复、returned ID mismatch、已存在有历史会话不重建、选择模型不调用 saveSelection、跨项目拒绝。真实宿主验证须另行获授权,本轮未执行。

View File

@ -1,91 +0,0 @@
# 三省六部 v0.1 实施状态
日期:2026-11-14。对应 [第一版方案](v1-plan.md) 第 7 节实施顺序。以下“已实现”指代码就位并通过 fake ctx 单元测试;
真实宿主/桌面 App 的接线验收仍需在获得安装授权后另做,本文不把未核验项说成已完成。
## 进度总览
| 步骤 | 内容 | 状态 |
|---|---|---|
| 1 | 对照 Web / dsh-go 两份样式确认第一版范围 | ✅ 已完成(见 v1-plan、preview) |
| 2 | 项目内身份及十席会话绑定(创建/恢复/失败重试/跨项目隔离) | ✅ fake ctx 测试 + 隔离测试 DSH 真机建席验证 |
| 3 | Web 导航入口 + 右侧工作台 | ✅ 已在隔离测试 DSH 真机验证(见下) |
| 4 | dsh-go 原生面板 | 🟡 源码就位,触摸/返回/会话跳转待真机核验 |
| 5 | 双项目联调、打包发布 | ⬜ 未开始 |
## 包结构(`sansheng/`)
- `index.js`:宿主入口。`inject=[workspaceRegistry, sessionController, agents, llm, systemPrompt, connection]`;注册动态 `systemPrompt.section` 与 `POST /api/sansheng` 路由。
- `src/shared/roles.js`:十席固定定义(id/label/duty/responsibility)与布局分组,Web/原生/宿主三端共用。
- `src/shared/schema.js`:版本 1 项目状态 schema 与严格校验(非法 JSON/错误版本/非十席一律视为损坏)。
- `src/host/store.js`:单 JSON 原子写、串行 mutate、失败回滚、不静默回退。
- `src/host/provision.js`:先持久化计划 sessionId 再创建;已存在按原会话恢复不重建;返回 ID 不一致立即停止后续创建并保留记录;失败保留已完成、重试只补未完成。
- `src/host/model.js`:走 `agent.model.select`(会话级事件),**不调用** `sessionController.selectModel`(不写 profile 全局默认);调用前用 `llm.resolveCallConfig` 校验并复核 Agent 未变。
- `src/host/prompt.js`:仅对十席会话注入本席角色文本,其它会话返回空串。
- `src/host/service.js` / `api.js`:项目视图、启用、配置、模型目录与 HTTP 分发。
- `src/client/`:Web 工作台(纯视图模型 + React 接线 + 传输层 + 白蓝/深色样式)。
- `src/native/`:dsh-go 原生面板(纯视图树 + bridge 接线,容量/只读/无自由文本约束内建)。
## 测试证据
```
cd sansheng && node --test test/*.test.js
# tests 36 pass 36 fail 0
```
覆盖:十席固定与两字名;状态损坏拒绝;创建十席全部绑定;已存在会话不重建;返回 ID 不一致停止;失败重试只补一个;
模型只走 agent.model.select(selectModel 调用次数断言为 0);非法模型拒绝;跨项目会话/模型隔离;重启不重复建会话;
HTTP 处理器端到端;systemPrompt 只注入十席;Web 纯视图模型(十席/未选模型显示“请选择模型”/无 inherit/切换保留草稿);
原生视图树(≤120 节点、≤8 深度、选项≤8、无自由文本控件、选中高亮);宿主项目视图直接喂给 Web 纯视图模型与原生面板的跨端一致性。
## 待真机核验(尚未完成,不能宣称已适配)
- Web:左侧 `sidebar.footer.action` 入口、右侧 `sidebarRight` 标签页注册签名、会话导航 API、当前项目权威来源、`POST api/sansheng` 实际挂载。
- dsh-go:面板入口位置、会话跳转 effect(现有 effect 无 navigation)、由 sessionId 反查项目、原生模型选择持久化、触摸面积与深浅色由宿主渲染。
- 打包:`client.js` 需 `npm run build`(依赖 esbuild devDependency)生成;当前环境未安装 esbuild,故未产出 `client.js`。
## 真实 DSH 真机验收(隔离环境,不触碰日常 DSH)
方式:用本机 dsh CLI 在独立 `DSH_HOME=.dsh-test-b` 新建 `sansheng-test` profile(由 web 模板生成),把插件装入该 profile 的 node_modules,起独立 web 服务(127.0.0.1:5988),无头 Edge 经 CDP 驱动。
结果(截图 `preview/live-01-entry.png`、`live-02-workbench.png`、`live-03-enabled.png`;脚本 `preview/check-live.mjs` 可复现):
- 左侧出现「三省六部」入口(追加型 `sidebar.footer.action`,未替换工作区/项目树)。✅
- 点击后工作台渲染十席,顺序与两字名正确:丞相/中书/尚书/门下/吏部/户部/礼部/兵部/刑部/工部;丞相居中、三省一排、六部两排。✅
- 当前项目 default-workspace 正确识别,显示「10 个角色 · 0 个会话」「启用此项目的十席」。✅
- 点「启用此项目的十席」→ 宿主真实建成 10 个独立 root session:项目 ready、10 席 bound、failed=0、无报错。✅
- 重启 DSH 进程后重开:仍「10 个角色 · 10 个会话」、无「启用」按钮、10 个会话 ID 互不相同 → 持久化与幂等通过,重启不重复建会话。✅
- 入口按用户要求移到“新会话”行右侧(`sidebar.session.action`),不再占底部;每个部门卡片统一为与丞相一致的蓝色边框,三省/六部仅保留文字分组标题。✅
- 新增「全部汇报职责」入口:点开逐条列出十席各自职责与所用模型;冒烟测试连跑 3 轮,每轮十席 10/10 正常汇报、0 console 报错。✅
- 每席模型独立显示:演示中礼部配置为 gemini 3.8flash(本机无该模型路由,仅配置展示、不可真跑),其余九席为 deepseek-v4.1-flash。✅
- 工作台进入真实右侧 dock(`inDock=true`、非浮动面板),无 console 报错。✅
- 点角色(工部)→ 真机切到该席独立会话(提示“已切换到工部会话”),无报错。✅
真机发现并已修复:客户端 bundle 模块 id 原写 `sansheng`,与包名 `dsh-sansheng` 不一致导致重复注册(duplicate factory)使入口未激活;改为 `dsh-sansheng` 后正常。
右侧标签页已按宿主 `sidebarRightTabs.register` 真实契约接通(注册 tab 类型 + 正文/标题 slot,slot key=类型 id),工作台真实进入右侧 dock;此前降级为浮动面板的问题已修复。
仍未验证(不能宣称完成):dsh-go 手机 App 原生面板(第 4 步,需真实客户端/设备);运行中改模型即时生效;双真实项目联调;第 5 步打包发布。
## 实测发现:插件建的会话不进“左侧工作区会话列表”(待修)
用隔离测试 DSH 实测(1440 宽、整页重载、并已对每席 rename 标题):
- 会话确实创建并注册:`DSH_HOME/sessions/<默认工作区路径哈希>/<会话ID>/session.v4.jsonl.zstd`;`storages/workspace.json` 的 `sessionIds` 里十席齐全。
- 但左侧“工作区 / 默认工作区”列表**不显示**这些会话(DOM 中带 `data-session-id` 的元素数 = 0),给会话写标题也无济于事。
- 源码级根因(`@deepseek-ai/dsh-client-ui-workspace`):工作区会话树用 `orderByRecency(sessionIds, summaries)` 渲染,**没有 `summaries[id]` 的会话被直接跳过**;极简 web 侧栏只出现了当前被 retained 的一条(工部),其余 9 个冷会话没有被同步进客户端 session summaries。
- 已尝试并无效:给每席会话 `resolveAgent` 预热 + `rename` 写标题,仍不进该极简侧栏(`data-row-key^=session:` 仍只有 1 条)。这说明是**客户端 session 列表同步**层面的问题,不是简单建会话就能解决。
- 判断:日常桌面版的侧栏更完整(含 better-sidebar 等),很可能能正常列出;极简 web 测试 profile 的侧栏只是“当前会话”。真正验收应到桌面版(C)。
- 另:真实对话内容还需模型;隔离环境无可用模型路由(gemini 不存在,deepseek-v4.1-flash 仅属于当前会话进程)。
## 未改动
未安装到任何 DSH profile,未修改用户日常 DSH、node_modules 或全局默认模型。
## v0.1.2(2026-11-17):旧数据兼容与侧栏入口
- 旧格式 v2/v3 自动迁移到 v1:三角色会话直搬、其余七席 pending、旧业务记录存 legacy、leases 只存档;失败不覆盖原文件;重复加载幂等。
- 错误分型:`state-json` / `state-unsupported` / `state-corrupt` / `state-migrate-failed`,只有可重试错误显示重试。
- 左侧入口从 `sidebar.session.action` 移到 `sidebar.panellist`(order 32,记忆系统与“更多”之间),点击只开右侧工作台,中央聊天不被接管。
- 测试 41 项全通过;`client.js` 已重建。
- 未完成:隔离环境真实界面截图、v0.1.2 发布与市场索引、用户本地安装。

View File

@ -1,372 +0,0 @@
# OpenMausBot 源码架构拆解
> 范围:当前工作区 OpenMausBot 源码快照;分析日期 2026-11-14。
> 方法:先读 AGENTS.md,再沿入口、导入、路由、驱动契约和持久化实现交叉阅读。没有安装依赖、启动服务、执行测试或修改两个仓库。
> “已实现”在本文中指有可追踪的实现代码与接线,不等于本机或所有平台已经运行验证。外部服务是否在线、账号是否有权限,本次均未验证。
## 1. 一句话看懂
OpenMausBot 是一个“让一队 AI 在聊天界面里干活”的本地优先应用。
它不是只包了一层大模型 API:机器人档案、会话、协作交接、审批、电脑控制、浏览器、工具接入和持久化,都是宿主应用自己的工作。
大模型或编码助手只是可替换的执行引擎;Electron 是桌面入口,Node 服务是实际组织工作的中枢。
根包自述为 local-first chat app,版本为 0.1.158,许可证声明 Apache-2.0;桌面入口指向 Electron。
证据:[package.json:1](../OpenMausBot/package.json#L1)、[package.json:15](../OpenMausBot/package.json#L15)。
## 2. 阅读约束与可信度
仓库要求:声称服务或会话改动有效之前,要按验证说明启动隔离 fixture,不能拿用户真实数据验证修改。
本次是只读架构分析,没有修改服务,也没有声称测试通过,所以没有启动这些 fixture。
证据:[AGENTS.md:3](../OpenMausBot/AGENTS.md#L3)。
证据分三层:
- **实现明确**:入口确实导入模块,路由确实调用 handler,契约或存储确实有代码。
- **实现但有外部条件**:例如模型 CLI、Cua、Docker/Podman、Boat、云端控制面需要另行准备。
- **文档/规划**:设计文档只说明作者当时打算怎么做,不直接证明现在做到了什么。
下文没有把预览页面、功能开关、依赖包名或目录存在当作完整可用的证明。
## 3. 总体分层
从使用者视角看,链路是:
src/main.tsx → React 页面/状态层 → HTTP API / SSE
↓
server/index.ts
↓
协调器 / 运行时 / ProviderDriver
↓
模型 API 或外部 CLI、MCP 工具、电脑
↓
SQLite / JSON / JSONL / 文件
这里第一行的入口是 [src/main.tsx](../OpenMausBot/src/main.tsx#L1)。
后端不是 Express/Nest/Fastify:核心直接导入 Node 的 createServer、IncomingMessage、ServerResponse。
证据:[server/index.ts:11](../OpenMausBot/server/index.ts#L11)。
主要目录的分工:
- [src/App.tsx](../OpenMausBot/src/App.tsx#L1):大应用界面组合。
- [src/state/store.tsx](../OpenMausBot/src/state/store.tsx#L1):客户端状态与动作落到后端的桥梁。
- [server/index.ts](../OpenMausBot/server/index.ts#L1):服务装配、会话和运行生命周期、仍有大量内联路由。
- [server/contracts.ts](../OpenMausBot/server/contracts.ts#L1):模型驱动和运行宿主之间的接口。
- [shared/runtime-events.ts](../OpenMausBot/shared/runtime-events.ts#L1):前后端/驱动共同理解的运行事件。
- [electron/main.mjs](../OpenMausBot/electron/main.mjs#L1):桌面窗口与本地能力装配。
- [companion/src/index.ts](../OpenMausBot/companion/src/index.ts#L1):配套设备服务入口。
- [connector/src/agent.ts](../OpenMausBot/connector/src/agent.ts#L1):托管主机到云管理端的连接代理。
- [relay/src/main.ts](../OpenMausBot/relay/src/main.ts#L1):独立网络中继入口。
## 3.1 功能模块速查
| 模块 | 用户看见的功能 | 后端负责的事情与源码入口 |
|---|---|---|
| Bot 与会话 | 建机器人、单聊、历史 | 身份、配置和会话归属:[Store](../OpenMausBot/server/store.ts#L275) |
| 群聊与协作 | 群成员、任务交接、团队活动 | 多 Bot 调用和协调:[coordinator](../OpenMausBot/server/coordinator.ts#L1) |
| 模型引擎 | 选择模型或本地编码助手 | 统一不同引擎的输入、事件和能力:[drivers](../OpenMausBot/server/drivers/builtIn.ts#L32) |
| 记忆 | 查看、维护 Bot 记忆和个人信息 | 记忆文档、变更日志、回退和整理:[记忆路由](../OpenMausBot/server/routes/bot-memory.ts#L5) |
| 自动化 | 定时工作、触发器、等待与继续 | 计划计算、运行记录、失败恢复及暂停:[routines](../OpenMausBot/server/routines.ts#L9) |
| 工具与审批 | 工具执行过程、确认卡片 | MCP 桥接、权限范围、控制代理:[mcp-bridge](../OpenMausBot/server/mcp-bridge.ts#L1) |
| 浏览器 | 实时网页画面与操作 | 浏览器控制、授权观看连接:[browser-viewers](../OpenMausBot/server/routes/browser-viewers.ts#L1) |
| 电脑 | 本机、Local VM、云电脑面板 | 三种不同执行环境,详见第9节 |
| 文件与数据 | 附件、文件视图、表格图表 | 附件归属和数据查询:[数据路由](../OpenMausBot/server/data/routes.ts#L21) |
| 邮件与应用 | 连接邮箱及外部应用 | 邮箱发现、连接校验、发送配置与账户存储:[邮件服务](../OpenMausBot/server/email/service.ts#L1) |
| 页面与技能 | 发布页面、技能和例程 | 独立服务模块:[页面服务](../OpenMausBot/server/pages/service.ts#L1)、[skills](../OpenMausBot/server/skills.ts#L1) |
| 运行记录 | 用量与执行状态 | 运行数据库、用量日志:[runtime store](../OpenMausBot/server/runtime/store.ts#L1)、[usage ledger](../OpenMausBot/server/usage-ledger.ts#L1) |
| 手机与云端配套 | 配对、远程连接、托管主机 | companion、relay、connector、control-plane,详见第13节 |
记忆不等于聊天记录:记忆路由导入独立 memory store、journal、upkeep,能分别管理记忆内容、修改记录和整理状态。团队环境还定义个人记忆层及写权限回调,见 [记忆依赖契约](../OpenMausBot/server/routes/bot-memory.ts#L26)。不能因为存在记忆维护接口,就宣称模型记住的内容一定正确。
## 4. 前端:框架、入口和运行方式
前端是 React 19 + TypeScript + Vite 7。桌面开发依赖 Electron 43。
版本证据:[package.json:132](../OpenMausBot/package.json#L132)、[package.json:166](../OpenMausBot/package.json#L166)、[package.json:175](../OpenMausBot/package.json#L175)。
启动入口先设置主题、字体、聊天宽度、软件渲染与语言,避免首屏先闪出错误样式。
随后才决定当前应该显示主页、配对页、登录页还是完整应用。
证据:[src/main.tsx:22](../OpenMausBot/src/main.tsx#L22)、[src/main.tsx:40](../OpenMausBot/src/main.tsx#L40)。
这里不是简单地无条件渲染 App:/home、/pair、/desktop-viewer 不预先加载大应用块。
其他页面会并行开始加载 App 与读取会话,降低登录后的等待。
证据:[src/main.tsx:30](../OpenMausBot/src/main.tsx#L30)。
界面是否能用,还要经过会话判断:未认证展示配对,团队退出展示离开页,桌面本地主页可接 Electron bridge。
window.ogb 是桌面壳向页面暴露能力的入口,浏览器环境不应假定它存在。
证据:[src/main.tsx:41](../OpenMausBot/src/main.tsx#L41)、[src/main.tsx:52](../OpenMausBot/src/main.tsx#L52)。
Vite 的开发监听明确绑定 IPv4 127.0.0.1,默认 UI 端口 5199,可用 OMB_UI_PORT 改。
这是开发服务器,不应和正式 Node 后端混成一台服务。
证据:[vite.config.ts:79](../OpenMausBot/vite.config.ts#L79)。
客户端状态层负责把群组、机器人任务、项目等用户动作转换成 API 请求,并再分发服务端返回状态。
例如删除群组、更新任务、创建机器人项目分别有真实请求调用。
证据:[src/state/store.tsx:2668](../OpenMausBot/src/state/store.tsx#L2668)、[src/state/store.tsx:2708](../OpenMausBot/src/state/store.tsx#L2708)、[src/state/store.tsx:2723](../OpenMausBot/src/state/store.tsx#L2723)。
## 5. 后端:入口、框架和 API
根脚本把 omb 指向 Node 直接执行的命令入口,dev:server 指向开发引导文件。
开发引导只设开发场景的本地浏览器信任变量,然后动态导入真正的服务入口。
证据:[package.json:33](../OpenMausBot/package.json#L33)、[server/dev-server.ts:1](../OpenMausBot/server/dev-server.ts#L1)。
主服务体积很大:本次读取快照的入口约 15,448 行。
它已经抽出 routes、host、runtime、drivers 等模块,但还不能称为完全解耦的插件内核。
一些路由已走统一分发,其他功能仍在主服务中组合或内联处理。
证据:[server/index.ts:12694](../OpenMausBot/server/index.ts#L12694)。
### HTTP、SSE、WebSocket 分别干什么
HTTP 是“请求一件事并取得结果”:登录、配对、配置变更、查询、提交操作、附件等。
SSE 是“服务器不断告诉页面发生了什么”:聊天与运行状态变化,不需要浏览器不断轮询整段会话。
WebSocket 是适合双向实时或二进制通道的另一层,浏览器画面等实时连接由相应路由拥有;它不是所有聊天 API 的统一底座。
SSE 路径明确为 GET /api/events,响应 content-type 为 text/event-stream,并有心跳、会话存活判断、可见性过滤和背压状态。
证据:[server/index.ts:14627](../OpenMausBot/server/index.ts#L14627)。
WebSocket upgrade 不绕过 HTTP 安全门:它转入同一个请求处理器,通过认证、托管工作区和维护门后才由所属路由完成握手。
握手有 10 秒限制,提前到来的数据有 64 KiB 上限。
证据:[server/routes/upgrades.ts:1](../OpenMausBot/server/routes/upgrades.ts#L1)、[server/routes/upgrades.ts:35](../OpenMausBot/server/routes/upgrades.ts#L35)。
### 已核验的 API 入口例子
- POST /api/auth/pair:浏览器配对入口。[server/index.ts:12577](../OpenMausBot/server/index.ts#L12577)
- POST /api/pair:companion 配对,同一次性凭据窗口、锁定与交换机制。[server/index.ts:12611](../OpenMausBot/server/index.ts#L12611)
- GET /api/auth/session:读取会话。[server/index.ts:12697](../OpenMausBot/server/index.ts#L12697)
- GET /api/health:健康检查的一条入口。[server/index.ts:12659](../OpenMausBot/server/index.ts#L12659)
- GET /api/events:状态事件流。[server/index.ts:14627](../OpenMausBot/server/index.ts#L14627)
- GET /api/internal/agents、GET /api/internal/assignment-status、POST /api/internal/coordinate-bots:内部协作白名单。[server/index.ts:1652](../OpenMausBot/server/index.ts#L1652)
- POST /api/internal/computer/mcp:云电脑工具接口,受 turn 级能力凭据保护。[server/cloud-computer-tools.ts:1](../OpenMausBot/server/cloud-computer-tools.ts#L1)
- /api/bots/:botId/data:机器人数据模块路由族,并验证图表类型、字段和分页等参数。[server/data/routes.ts:21](../OpenMausBot/server/data/routes.ts#L21)
这是一份代表性接口地图,不是把 15,000 行入口及全部路由穷尽导出的 OpenAPI 文档。
internal 不代表不鉴权,也不代表可给外部集成任意调用。
## 6. 模型引擎:真正的可替换边界
ProviderDriver 是“某种引擎怎样接进来”的公共契约,驱动把自己的模型/会话行为翻译成宿主统一理解的形式。
会话能力声明包含队列、审批等差异,因此相同界面不代表每种引擎功能完全相同。
证据:[server/contracts.ts:247](../OpenMausBot/server/contracts.ts#L247)、[server/contracts.ts:593](../OpenMausBot/server/contracts.ts#L593)。
当前 built-in 注册数组共有 29 项,按实际符号列出如下:
GrokDriver、GrokAgentDriver、GeminiAgentDriver、KimiAgentDriver、DroidAgentDriver、CursorAgentDriver、OpenCodeDriver、QwenAgentDriver、HermesAgentDriver、ClineAgentDriver、CopilotAgentDriver、CommandCodeAgentDriver、KiroAgentDriver、OmpAgentDriver、CustomAcpDriver、PiDriver、OpenAICompatDriver、ClaudeDriver、CodexDriver、AntigravityDriver、MinimaxDriver、MistralDriver、CerebrasDriver、GroqDriver、GreenferenceDriver、ModelgoDriver、MetaDriver、MuseCodeDriver、DeepSeekAgentDriver。
唯一支持列表依据是实际导入和注册,不是 README 的营销名单。
证据:[server/drivers/builtIn.ts:1](../OpenMausBot/server/drivers/builtIn.ts#L1)、[server/drivers/builtIn.ts:32](../OpenMausBot/server/drivers/builtIn.ts#L32)。
其中大量 AgentDriver 从 acp 子目录接入;OpenAICompat、Claude、Codex 等有独立实现。
这意味着兼容层既有“直接接 API”的路线,也有“驾驭外部代理/CLI”的路线,不能一概当成 OpenAI Chat Completions。
所需 CLI、账号、订阅、API key、模型可用地区由各驱动决定。
驱动错误模型明确区分 missing_cli、invalid_credentials、inactive_subscription、insufficient_funds、quota_or_region_restriction、upstream_outage 等。
源码自己就承认这些是会阻断运行的外部条件。
证据:[server/contracts.ts:19](../OpenMausBot/server/contracts.ts#L19)。
## 7. 机器人、会话、多机器人协作
机器人不是一个独立微服务;它更像宿主里的长期档案和配置,关联多条会话与执行状态。
聊天记录、运行会话和机器人档案要分开理解:删一个 UI 卡片,不等于所有底层引擎文件都消失。
协调器负责交接、派工、查询进度,把多个 bot 的工作组织成可恢复的过程。
主入口引入 createCoordinator、ComposedTurn、CoordinateBotsCall、HandoffOptions、HostTurnResult 等显式契约。
证据:[server/index.ts:27](../OpenMausBot/server/index.ts#L27)、[server/coordinator.ts:1](../OpenMausBot/server/coordinator.ts#L1)。
运行协调层另有 RuntimeStore 与 Runtime,保存停止记录、交接与工作状态。
因此 UI 看见的“正在做/等待用户/被停止”,不能只用一个 Promise 的 resolved/rejected 表示。
证据:[server/runtime-coordinator.ts:143](../OpenMausBot/server/runtime-coordinator.ts#L143)。
群聊还有独立的上下文与会话处理:房间 transcript、room sessions、room context tracker 都在服务装配时接入。
证据:[server/index.ts:20](../OpenMausBot/server/index.ts#L20)。
人与机器人交互不是只有一条纯文本回复;问题卡、等待用户、恢复卡片、MCP 登录卡等有专门宿主模块。
证据:[server/index.ts:28](../OpenMausBot/server/index.ts#L28)。
## 8. 工具系统与审批边界
工具来源包含内建宿主能力、电脑能力、MCP 进程、连接的应用和不同模型引擎自身的工具。
MCP bridge 可以派生子进程,并增加控制授权、工具 schema 规范化、活动探测与 saved-steps journal。
证据:[server/mcp-bridge.ts:1](../OpenMausBot/server/mcp-bridge.ts#L1)。
因此“调用一个工具”不等于模型直接获得所有宿主权限。
电脑连接可以包装成 gatedLocalComputer:真实命令和参数留在环境变量里,调用先经过控制代理,携带 CONTROL_URL 和 CONTROL_TOKEN。
证据:[server/local-computer.ts:28](../OpenMausBot/server/local-computer.ts#L28)。
云电脑凭据更明确留在服务端,模型拿的是 turn-scoped capability 对应的工具入口。
工具包括远程命令、截图、复制文件、后台命令状态等,和普通模型文本生成是不同能力。
证据:[server/cloud-computer-tools.ts:1](../OpenMausBot/server/cloud-computer-tools.ts#L1)。
可复用的是这些契约和门禁设计;不能只复制工具 handler、丢掉运行上下文与授权代理。
## 9. 桌面壳、真实电脑、Local VM、Cloud Computer
### Electron 壳
Electron 主进程是桌面程序入口,负责窗口和桌面能力组合;React 仍是渲染界面,Node 服务仍是业务中心。
浏览器模式没有天然的本机桌面权限;需要本地壳或配套连接,不能因为网页能打开就认为能控制电脑。
证据:[package.json:18](../OpenMausBot/package.json#L18)、[src/main.tsx:41](../OpenMausBot/src/main.tsx#L41)。
### Your Computer / 本机桌面
本地电脑连接契约明确包含 darwin、linux、win32 三个平台。
macOS/Windows 使用 legacy descriptor 分支;Linux 另有严格的驱动文件身份核验及必要工具清单。
证据:[server/local-computer.ts:6](../OpenMausBot/server/local-computer.ts#L6)、[server/local-computer.ts:19](../OpenMausBot/server/local-computer.ts#L19)、[server/local-computer.ts:68](../OpenMausBot/server/local-computer.ts#L68)。
所以“只支持 macOS”不符合当前这份接口源码;但“三个平台接口存在”也不证明权限弹窗、辅助组件和各平台桌面会话全部已准备好。
本次不运行探测,无法据此宣布当前 Windows 机器可控制。
### Local VM
源码自己说明:这是 Cua-backed Local VM,OMB 负责 sandbox 边界,桌面自动化由容器中的 cua-driver mcp 负责。
它不是 OpenMausBot 自己写的 CPU 虚拟机或全套远程桌面协议栈。
证据:[server/container-computer.ts:1](../OpenMausBot/server/container-computer.ts#L1)。
实现包含 Docker/Podman 运行时适配、容器启动/停止/删除、共享与按 bot 分隔的 target、工作区挂载和 viewer 端口。
共享 target 默认宿主 viewer 端口 6080,容器 viewer 端口 6901;per-bot target 使用受控身份生成。
证据:[server/container-computer.ts:71](../OpenMausBot/server/container-computer.ts#L71)、[server/container-computer.ts:91](../OpenMausBot/server/container-computer.ts#L91)。
Windows 分支专门处理 Podman Machine 的 WSL 挂载路径翻译,说明平台适配存在实际限制,不能把 Linux 命令原样搬到 Windows。
证据:[server/container-computer.ts:729](../OpenMausBot/server/container-computer.ts#L729)。
### Cloud Computer
云电脑通过 Boat 适配器执行命令、截图和文件操作,仍由本地/托管宿主保存凭据并安排授权。
远端桌面可用性、资源、计费与网络属于外部依赖,仓库有调用代码不等于附送可用云资源。
证据:[server/cloud-computer-tools.ts:3](../OpenMausBot/server/cloud-computer-tools.ts#L3)。
## 10. 浏览器、文件、数据和页面
浏览器能力不是聊天消息的一种格式,它有独立浏览器控制与实时 viewer 路由。
viewer 模块与统一 upgrade 门协作,避免把实时观看口变成免认证旁路。
证据:[server/routes/browser-viewers.ts:1](../OpenMausBot/server/routes/browser-viewers.ts#L1)、[server/routes/upgrades.ts:1](../OpenMausBot/server/routes/upgrades.ts#L1)。
数据模块以 bot 为所属边界,可产生表格和图表卡;schema 列出 bar、line、area、scatter、histogram、pie、heatmap 等图表类型。
字段、聚合函数、limit、bins 都有限制,不是任意输入都无条件交给渲染层。
证据:[server/data/routes.ts:21](../OpenMausBot/server/data/routes.ts#L21)。
文件与附件是独立资源,会话只引用它们;主服务检查附件是否仍被聊天或机器人头像使用。
证据:[server/index.ts:12099](../OpenMausBot/server/index.ts#L12099)。
页面、skills、routines 等模块各有独立实现,但本次没有穷尽每个操作分支:可确认是实际源码模块,不对所有子功能作运行保证。
阅读起点:[server/pages/service.ts](../OpenMausBot/server/pages/service.ts#L1)、[server/skills.ts](../OpenMausBot/server/skills.ts#L1)、[server/routines.ts](../OpenMausBot/server/routines.ts#L1)。
## 11. 自动化、连接应用、语音与安全存储
自动化不是前端定时刷新:服务装配接入 bot automations、WaitManager、wait host 和 waits routes,用会话上下文管理等待与继续。
证据:[server/index.ts:486](../OpenMausBot/server/index.ts#L486)。
应用接入分多类:团队连接、cloud connected apps、聊天内应用;主服务分别建立对应 host 和 routes。
这些属于与外部应用账户和权限相连的子系统,不能把“配置了连接”当成“所有 bot 都可使用”。
证据:[server/index.ts:24](../OpenMausBot/server/index.ts#L24)、[server/index.ts:467](../OpenMausBot/server/index.ts#L467)。
仓库也有 tts、meetings、phones、vault 等实际子模块。
本报告不以目录存在推断会议服务、手机或语音供应商当前可用;这些应在部署时按对应路由、账户和设备逐项验证。
## 12. 数据到底存在哪里
默认数据根目录是用户数据 home 下的 .openmausbot,可用 OMB_DATA_DIR 覆盖。
还保留从旧 .opengrokbot 目录迁移的逻辑,并创建 events、native 子目录。
证据:[server/config.ts:695](../OpenMausBot/server/config.ts#L695)。
config.json 是持久配置,读取时经过 schema/解析与文件缓存;机器人与群组档案由 store 管理 JSON 文件。
证据:[server/config.ts:568](../OpenMausBot/server/config.ts#L568)、[server/config.ts:712](../OpenMausBot/server/config.ts#L712)、[server/store.ts:178](../OpenMausBot/server/store.ts#L178)。
消息有 SQLite 数据层,运行协调器另有 RuntimeStore:聊天历史和执行状态不能当作同一张表。
这类嵌入式存储适合本地单服务,不需要用户先装 PostgreSQL,但备份需要覆盖多个文件。
证据:[server/message-db.ts:1](../OpenMausBot/server/message-db.ts#L1)、[server/runtime/store.ts:1](../OpenMausBot/server/runtime/store.ts#L1)。
用量、决策等追加日志采用 JSONL,适合逐条记录与按月维护;它们不是消息数据库的替代品。
证据:[server/usage-ledger.ts:1](../OpenMausBot/server/usage-ledger.ts#L1)、[server/decision-log.ts:1](../OpenMausBot/server/decision-log.ts#L1)。
外部 Claude/Codex 引擎还有自己的原生会话文件,删除/清理逻辑显式认识它们的 JSONL 布局。
证据:[server/host/delete-leftovers.ts:24](../OpenMausBot/server/host/delete-leftovers.ts#L24)。
不要把整个系统想成“复制一个 JSON 就迁移完了”:至少要考虑配置、档案、消息库、运行状态、附件、原生引擎目录及秘密材料。
恢复工作区时,代码还要求先解除团队电脑分配,防止恢复后的团队名字意外获得旧桌面权限。
证据:[server/index.ts:12684](../OpenMausBot/server/index.ts#L12684)。
## 13. 配套服务不是主程序的别名
### Companion
companion 有独立 Node 入口和运行脚本,主服务给它提供专用配对入口。
它是配套设备接入路线,不是把全部主服务复制到一个手机网页。
证据:[package.json:33](../OpenMausBot/package.json#L33)、[companion/src/index.ts:1](../OpenMausBot/companion/src/index.ts#L1)、[server/index.ts:12611](../OpenMausBot/server/index.ts#L12611)。
### Connector
connector 的明确用途是:让用户自己的服务器承载一个 Cloud home,通过一条主动向外的连接受管理。
两端先证明密钥,管理员任务对这台机器签名,回复重发直到确认,home 请求通过 yamux streams 复用。
证据:[connector/package.json:5](../OpenMausBot/connector/package.json#L5)、[connector/src/agent.ts:1](../OpenMausBot/connector/src/agent.ts#L1)。
因此它是部署与控制代理,不是普通大模型驱动,更不能默认当成无需鉴权的远程 shell。
未获团队 Owner 接受时,任务范围只允许 status 和 host-health 两个读操作。
证据:[connector/src/agent.ts:27](../OpenMausBot/connector/src/agent.ts#L27)。
### Relay 与 Cloudflare control-plane
relay 是独立运行服务:读取环境配置后 startRelay,具备自己的退出与关闭逻辑。
它负责连接转发,不拥有主聊天产品全部状态。
证据:[relay/src/main.ts:1](../OpenMausBot/relay/src/main.ts#L1)、[relay/src/server.ts:1](../OpenMausBot/relay/src/server.ts#L1)。
Cloudflare control-plane 是另一个云部署面,有独立入口;不能把它的云基础设施依赖算成离线本地聊天的硬性前提。
阅读起点:[cloudflare/control-plane/src/index.ts](../OpenMausBot/cloudflare/control-plane/src/index.ts#L1)。
## 14. 一次实际工作在架构上如何走
1. 页面先选择入口与验证会话,才进入完整 App。
2. 用户动作进入客户端 store,被翻译成后端 HTTP 请求。
3. 服务处理认证、可见范围与维护门,再派给路由或会话逻辑。
4. 宿主组合机器人配置、上下文、协调状态,交给所选 ProviderDriver。
5. 驱动运行模型/CLI;工具请求按 scope、审批与电脑控制边界处理。
6. 结果与状态写入对应持久层,通过 SSE 推给有权看到的页面。
7. 如需看实时桌面/浏览器,则另建受认证的 viewer/WebSocket 通道。
对应证据:[src/main.tsx:40](../OpenMausBot/src/main.tsx#L40)、[src/state/store.tsx:2708](../OpenMausBot/src/state/store.tsx#L2708)、[server/index.ts:12694](../OpenMausBot/server/index.ts#L12694)、[server/contracts.ts:593](../OpenMausBot/server/contracts.ts#L593)、[server/local-computer.ts:28](../OpenMausBot/server/local-computer.ts#L28)、[server/index.ts:14627](../OpenMausBot/server/index.ts#L14627)。
## 15. 运行依赖和限制
核心开发环境要求 Node >=24、pnpm 10.33.0,代码使用 ESM 和 Node 的 TypeScript stripping 入口。
证据:[package.json:17](../OpenMausBot/package.json#L17)、[package.json:33](../OpenMausBot/package.json#L33)。
普通网页前端依赖 React/Vite;桌面版另需 Electron;实时远程桌面前端使用 noVNC 包,后端有 ws 与 zod。
证据:[package.json:108](../OpenMausBot/package.json#L108)、[package.json:149](../OpenMausBot/package.json#L149)。
可选能力需要额外条件:所选模型的 CLI/账号/API;本机桌面驱动与系统授权;Docker/Podman 和 Cua 镜像;Boat 云资源;连接应用账户;companion 设备与 relay/控制面部署。
没用到的功能不应被当作所有用户的必装依赖。
主服务集中装配很多功能,重用单个模块时容易碰到配置、全局 store、授权和事件上下文耦合。
SQLite/文件存储、原生 CLI session 和桌面平台适配,也限制了“随便放进无状态 serverless 就能运行”的设想。
代码存在并不保证数据迁移与并发恢复无缺陷;本次禁止运行,不能声称性能、故障恢复、跨平台打包或全部驱动已经验证。
## 16. 已实现与规划,怎样不看错
已实现的强证据包括:真正的 React 启动分支、Node HTTP 入口、SSE route、WebSocket gate、内建驱动注册、容器 target、带控制凭据的工具代理、connector 的签名通道。
这些都有上面的实际代码引用,不依赖文档标题。
配置中的 feature flag 只是可选开关。例如 agentsToolBridge 默认不打开;savedSteps 默认开启;usbPhoneTakeover 和 cloudComputerAutoReplace 还各有默认或覆盖规则。
不能把这些布尔字段的存在等同于所有引擎、设备和平台都支持该能力。
证据:[server/config.ts:247](../OpenMausBot/server/config.ts#L247)。
仓库的 control-plane roadmap 是规划文本;读它只能知道规划拆分,不能用它覆盖当前实现事实。
当前 connector/relay/control-plane 已有代码,也不能反过来证明 roadmap 的每项验收都完成了。
证据:[控制面路线图:1](../OpenMausBot/docs/superpowers/plans/2026-08-31-00-control-plane-roadmap.md#L1)。
## 17. 可复用边界:什么值得拿,什么不能生搬
最适合先研究的是 shared 事件结构、ProviderDriver 契约、路由上下文和 HTTP/SSE 组合。这些把不同引擎变成统一产品行为。
复制前必须一起理解 session、approval、tool scope、能力声明,否则表面接上模型,行为仍可能不兼容。
电脑部分可复用授权门、运行时适配和 target 身份设计,但实际桌面能力来自 Cua/Boat/平台助手。
拿走容器管理代码不等于拿走全部桌面自动化,也不等于获得外部服务使用权。
多机器人协调有参考价值,但它和持久运行状态、房间上下文、等待用户卡片和停止语义相连;不宜只摘一个 coordinate 函数。
客户端 UI 也依赖统一 wire 事件、会话和 store,不能直接视为可插拔聊天组件库。
connector/relay 应作为独立服务研究,维持签名、认证、限额和重连机制;不要当作聊天后端的几个可复制路由。
许可证需同时检查主仓库声明和 third_party 归属,Apache-2.0 的根声明不是替所有 vendored 组件做了许可证保证。
证据:[package.json:15](../OpenMausBot/package.json#L15)、[server/contracts.ts:1](../OpenMausBot/server/contracts.ts#L1)。
## 18. 最终摘要
它的主干是 React 界面 + Node 原生 HTTP 服务 + 多引擎驱动,Electron 提供桌面壳与本地能力。
真正复杂的地方在于让机器人长期工作:多人可见性、协调交接、审批等待、工具和电脑授权、多个持久层,以及故障后的继续/停止语义。
Local VM 是容器化 Cua 桌面;Cloud Computer 是远程适配;Your Computer 是平台本机连接,三者不能混为一谈。
复用时优先拿契约和边界设计,再按目标功能带走依赖链;不要把整个项目当成轻量聊天 UI,也不要把文档规划或注册项当成已经实测成功。

171
docs/panel-design.md Normal file
View File

@ -0,0 +1,171 @@
# 三省六部面板设计方案
日期:2026-11-08
状态:已落地到 0.5.1 面板;实现位于 `panel/lib/client.js`。
## 1. 目标与范围
让每个部门拥有明确、易识别、可点击的卡片边界,贴合 DSH 原生主题。朝堂编制与任务流转统一收进会话右侧栏,聊天复用 DSH 原生输入框和消息流,不再维护整页面板或第二套对话摘要。本轮不新增聊天引擎,不修改角色策略、权限或调度机制。
用户要求:每轮设计调整附一张新生成的预览图。版本历史使用 Git,不建立时间戳备份或多个最终版。
## 2. 预览依据
0.5.6 的预览图由 `scripts/preview.mjs` 生成:脚本用 vm 加载**真实的** `panel/lib/client.js`,用会重渲染的 hooks 替身跑真实组件树,把结果序列化成 HTML,再用 headless Chrome 截图。因此它是真实 CSS + 真实 DOM 的渲染结果,不是生成式模拟图。
440px 明亮主题:
![右侧栏 440px 明亮主题](preview/panel-sidebar-440-light.png)
371px(当前宿主实测的侧栏宽度;最近活动独占一行):
![右侧栏 371px](preview/panel-sidebar-371-light.png)
360px 窄栏(检查不裁切):
![右侧栏 360px 窄栏](preview/panel-sidebar-360-light.png)
320px 极窄栏(三省与六部降为单列):
![右侧栏 320px 单列](preview/panel-sidebar-320-light.png)
440px 深色主题:
![右侧栏 440px 深色主题](preview/panel-sidebar-440-dark.png)
任务页:
![任务页](preview/panel-sidebar-tasks-440.png)
左侧栏导航行的观感(展开/折叠/激活态,以及 main 重定向桩的两种文案):
![左侧栏导航行](preview/panel-nav-entry.png)
重新生成的方式写在 `docs/panel-handoff.md` 顶部。截图只覆盖组件在给定容器宽度下的表现,**不覆盖**宿主槽位宽度、滚动容器与真实主题变量注入;最终验收仍需在 DSH Host 中截图确认。统计数字 10 / 3 / 4 是测试替身给的示例数据,不得硬编码为真实数据。
## 3. 面板结构
面板只存在于会话右侧栏。从上到下:状态行 → 朝堂/任务页签 → 统计区 → 丞相 → 三省 → 六部分组 → 当前部门配置。
入口有两个,行为完全等价,都只做「把朝堂停靠到当前会话的右侧栏」:**会话头部的「三省」开关**,和**左侧栏导航列里的一行「上朝」**(`sidebar.panellist`,`order: -100` 置顶,细线「三」字样标;折叠侧栏时只剩图标)。左栏只保留这一处入口——0.5.5 撤掉了曾经并存的底部入口,避免同一功能出现两行。点导航行时宿主会要 `main` 槽,那里放的是重定向桩:停靠右侧栏后立刻退回原会话,没有会话时就地写明原因,不渲染面板内容、也不提供第二套聊天。
- 状态行:协作状态、`输入 @ 选择部门` 提示;在子会话中显示“返回丞相”。
- 页签:朝堂与任务二选一;点击统计卡也可切换,切换不改变当前选中的部门。
- 统计区:在朝成员、运行中、在办任务、已完成,右侧栏固定两列两行。
- 丞相:居中单卡,连接中书省、尚书省、门下省。
- 三省:从左到右为中书省、尚书省、门下省。
- 六部:放入带“六部 · 尚书省调度”标题的浅底色容器,仅由尚书省连接到整个组。
- 六部第一排:吏部、户部、礼部;第二排:兵部、刑部、工部。
- 两排只是视觉换行,不能用连线暗示吏部管理兵部、户部管理刑部等关系。
- 配置区:显示所选部门名称、固定职责、模型、推理等级、保存设置按钮与“与该部门对话”入口。移除重复指令输入框及“Agent 预设”输入与应用按钮;消息在对应原生会话发送,部门角色由系统配置。
十席清单:丞相、中书省、尚书省、门下省、吏部、户部、礼部、兵部、刑部、工部。
## 4. 部门卡片规范
| 项目 | 规划值或行为 |
| --- | --- |
| 底色 | 独立实色表面,与工作区背景明确分离 |
| 常态边框 | 1px 清晰蓝灰实线;不得仅靠阴影区分 |
| 圆角 | 10–12px |
| 内边距 | 10–12px |
| 卡片间距 | 10–12px |
| 建议最小宽度 | 104px;不足时减少列数 |
| 建议最小高度 | 80–88px,由内容撑高,不裁切 |
| 字徽 | 28–32px 淡蓝底字徽,准确使用丞/中/尚/门/吏/户/礼/兵/刑/工 |
| 名称 | 13–14px,中等至粗体,完整可读 |
| 状态 | 11–12px,状态点与文字并存 |
| 点击范围 | 整张卡片,不只部门名称 |
名称和状态是卡片主要信息。长模型名、最近消息和配置细节集中到下方详情区,避免卡片成为密集文本块。尺寸是实现起点,应在真实侧栏宽度下验证。
## 5. 状态与交互
- 常态:白色或主题表面底色、清晰边框、轻微阴影。
- 悬停:边框略加深,底色轻微变化,不改变卡片尺寸。
- 选中:蓝色描边、浅蓝底、右上角勾选标记;通过内描边或等宽边框避免布局跳动。
- 键盘焦点:独立可见焦点环;使用原生按钮语义和选中状态属性。
- 运行中:绿色状态点 + “运行中”;待命:中性状态点 + “待命”。
- 失败:红色状态点 + “失败”,不把整卡大面积涂红。
- 未设官:虚线边框 + “未设官”;可查看职责,但不能对不存在的会话发送指令。
- 右侧栏提供「朝堂 / 任务」页签;点击「在朝成员」或「在办任务」统计卡分别切到对应页,切换不丢失当前选择。
- 聊天不在侧栏内重复实现;主会话与部门子会话都使用 DSH 原生消息流和输入框。
- 点击卡片只切换配置对象;“与该部门对话”负责跳转,避免误触导航。
- 发送期间按钮显示进度并防止重复提交;错误在当前配置区域说明。
## 6. 主题与层次
复用 DSH 的背景、表面、文字、边框和强调色变量。蓝色回退为 #4D6BFE;明亮模式的视觉参考为浅灰工作区、白色卡片和浅蓝选中底色。
深色模式保持同一结构,使用宿主深色表面与边框;不得保留刺眼白卡。状态同时使用文字和颜色,正文对比度以至少 4.5:1 为目标,可交互边界与焦点以至少 3:1 为目标。连接线比部门卡片边框更弱,但仍可辨认。
六部分组底色比工作区略深或略偏蓝,组内每个部门仍保持独立边框。配置区使用独立卡片,“与该部门对话”为主要入口,“保存模型设置”为次要按钮;消息发送按钮只存在于对应会话输入区。
## 7. 空间与响应式
按面板实际容器宽度适配,不能只依赖整个浏览器窗口宽度。
- 实现方式:`.sl-root` 声明 `container-type:inline-size;container-name:slpanel`,所有断点写成 `@container slpanel (max-width: …)`;`panel/lib/client.js` 里不得再出现视口 `@media (max-width: …)` 断点,`panel/test/client.test.js` 有回归测试守着这条。
- 1180px / 980px:整页与双栏形态的切换;侧栏形态下这两档不会生效。
- 620px 及以下:统计两列两行;三省与六部降为两列,卡片保持 104px 以上的可读宽度。
- 330px 及以下:三省与六部降为单列;组织层级用分组标题表达,不再强行绘制横线。
- 极窄宽度:使用单列卡片和分组标签,隐藏无法准确表达关系的树形横线,保留组织语义。
- 统计卡建议每张高64–72px,避免占据过多首屏空间。
- 采用自然纵向滚动,不固定过小高度导致文字截断;表单窄屏改为上下排列。
- 部门配置里的「最近活动」独占一行,最多两行后省略;不得与状态文字排在同一行互相挤压。
- 不直接按1024px生成图等比缩小;在320、360、371、400、440、480px容器中检查实际可读性。
## 8. 数据与实现边界
继续使用现有成员和任务投影生成统计,运行状态与任务状态分别计算。选择部门后配置区同步切换,复用已有会话导航、模型和指令发送逻辑。底层预设与部门角色配置保留,由系统管理;移除面向普通用户的手动预设切换入口,不因此删除底层角色初始化。
后续授权实现后,主要修改 panel/lib/client.js 中的卡片、组织分组和样式;必要的纯布局逻辑可放入 panel/lib/model.js。行为变化才补对应回归测试,不以字符串断言代替视觉验证。此方案不要求引入新的UI库,也不要求修改后端权限。
## 9. 部门设置与子 Agent 对话
本节取代上一轮设置卡中“发送任务”输入框的设计。用户指出给丞相下任务本来就在主会话,真正需要明确的是如何与子 Agent 对话。右侧栏里对应的是底部的「正在丞相主会话 / 与某部对话」按钮,见第 2 节的真实渲染图。
### 对话路径
- 给丞相下任务:在丞相主会话的原生输入框发送。
- 与部门聊天:选中部门卡片 → 点击“与工部对话”等具体入口 → 打开该成员现有的可继续子会话。
- 快捷入口:在 DSH 原生输入框输入 `@` → 选择已设官部门 → 直接进入该部门子会话,在同一个原生输入框继续输入并发送。候选只包含已有会话的部门;选择动作本身就是导航,不把当前会话中的普通文字静默改投给其他 Agent。
- 选中同步:进入某部门子会话时,右侧朝堂图自动选中该部门并切换配置区;返回丞相主会话时恢复选中丞相。切换只跟随实际会话,不按普通文本猜测接收人。
- 子会话显示历史消息、当前接收部门和原生消息输入框,支持继续追问与补充;不另造一套聊天存储或发送机制。
- 顶部提供“返回丞相主会话”,明确父子关系。原有“打开会话”入口改用具体接收方文案,降低歧义。
- 点击卡片仅选择部门;真正进入会话必须通过明确入口,避免误触跳转。
- 未设官或没有可继续会话时,入口不可用并解释原因;不能静默创建重复成员或将消息转发给其他角色。
- 子会话消息与主会话分别保存。不要暗示私聊内容会自动同步给丞相;如后续需要汇报功能,应单独规划明确的转发动作。
- 直接对话不改变部门权限、分工与审批边界。
### 设置卡
1. 身份:字徽、部门名称、职责摘要;固定职责应由实际角色绑定支持。
2. 模型:模型下拉、模型支持的推理等级、单一“保存模型设置”按钮;未修改时禁用,成功或失败有明确反馈。同名模型才补充友好的提供商名称。
3. 对话入口:“与工部对话”或“返回丞相主会话”。已处于该成员会话时显示“正在对话”,避免重复导航。
移除设置卡里的“下旨给丞相”、任务输入框、“下旨”或“发送任务”按钮;移除 Agent 预设输入、应用按钮和加载提示。内部标识可放入默认折叠的只读高级信息。底层预设仍由系统管理,旧会话角色不匹配时明确提示,不静默改写。
宽屏模型与推理等级并排,窄栏上下排列。预览图中的模型与推理等级只是示意,真实选项严格由模型能力目录决定。图中遗漏的统计区、卡片字徽和状态仍以其他章节为准,本图重点表示对话位置。
专项验收:设置区无重复消息输入框;子会话能查看历史并继续发送;实际接收方与会话标题一致;返回主会话不丢失历史;未设官入口正确禁用;不自动同步私聊或绕过既有权限。
## 10. 后续实施顺序
1. 建立卡片表面、边框、间距与状态样式。
2. 整理丞相、三省、六部分组与连接线。
3. 压缩统计区,梳理部门配置区。
4. 验证宿主明亮/深色主题和真实窄栏宽度。
5. 运行现有回归测试,检查会话跳转、模型选择和发送指令。
6. 获取真实界面截图,与设计图比对后再宣告视觉验收。
## 11. 验收标准
- 十席完整、无重复,吏部和礼部文字正确。
- 未选中的部门也有清晰边框,不能看起来只是浮动文字。
- 选中、运行、失败、未设官和键盘焦点可以区分。
- 六部全部属于尚书省,不产生错误的上下级连线。
- 统计使用实时投影,图片中的示例数字不会进入逻辑。
- 窄栏没有横向溢出,名称与状态不被裁切。
- 明亮与深色均可读,配置功能与会话入口保持可用。
- 真实界面视觉检查和必要回归测试都通过;生成模拟图不能替代实际截图验收。

239
docs/panel-handoff.md Normal file
View File

@ -0,0 +1,239 @@
# 三省六部面板:换环境开发交接方案
日期:2026-11-08
当前版本:`0.5.6`
状态:侧栏化改造、残留清理、容器断点与左侧栏入口均已实现并通过 39 项本地测试;尚未在真实 DSH Host 里做最终视觉验收。
![右侧栏 440px 明亮主题](preview/panel-sidebar-440-light.png)
> 这张图由 `scripts/preview.mjs` 渲染真实组件树 + 真实 CSS,再用 headless Chrome 截图(440 CSS px × 2 DPR),不是 DSH Host 的运行截图,也不是 AI 生图。同一脚本还产出宿主实测宽度 371px、窄栏 360px、极窄单列 320px、深色主题与任务页:
![371px 实测侧栏宽度](preview/panel-sidebar-371-light.png)
![360px 窄栏](preview/panel-sidebar-360-light.png)
![320px 单列](preview/panel-sidebar-320-light.png)
![440px 深色主题](preview/panel-sidebar-440-dark.png)
![任务页](preview/panel-sidebar-tasks-440.png)
左侧栏导航行(静态标记 + 真实 CSS,不是宿主截图):
![左侧栏入口](preview/panel-rail-entry.png)
重新生成(需要放开沙箱,Chrome 无头模式要建 mojo 命名管道):
```bash
node scripts/preview.mjs --width=440 --view=court --theme=light --name=panel-sidebar-440-light --out=docs/preview
node scripts/preview.mjs --width=371 --view=court --theme=light --name=panel-sidebar-371-light --out=docs/preview
node scripts/preview.mjs --width=360 --view=court --theme=light --name=panel-sidebar-360-light --out=docs/preview
node scripts/preview.mjs --width=320 --view=court --theme=light --name=panel-sidebar-320-light --out=docs/preview
node scripts/preview.mjs --width=440 --view=court --theme=dark --name=panel-sidebar-440-dark --out=docs/preview
node scripts/preview.mjs --width=440 --view=tasks --theme=light --name=panel-sidebar-tasks-440 --out=docs/preview
```
复现「大窗口 + 窄侧栏」(真实宿主形态):加 `--viewport=1200 --width=371`,页面按 1200px 窗口渲染、侧栏仍为 371px。
只想要中间 HTML、不调 Chrome 时加 `--html-only`。最终验收仍然必须在真实会话右侧栏里完成。
## 1. 一句话目标
不要再维护一套整页面板或第二套聊天界面。聊天全部使用 DSH 原生输入框;三省六部的朝堂编制、任务流转和部门配置只停留在会话右侧栏,并通过 `@` 直接进入部门子会话。
## 2. 已经完成的部分
- 十席角色:丞相、中书省、尚书省、门下省、吏部、户部、礼部、兵部、刑部、工部。
- 朝堂图为「丞相 → 三省 → 六部」,六部两排三列,同属尚书省调度。
- 部门为实体卡片:字徽、边框、状态点和中文状态;选中态有蓝边、浅底和勾选标记。
- 插件注册会话头部入口、左侧栏导航行(`sidebar.panellist`)、`main` 重定向桩与右侧栏页签;`sidebar.panellist.actions` 仍不注册。
- 右侧栏包含「朝堂 / 任务」页签、2×2 统计卡、朝堂图、部门配置和任务列表。
- DSH 原生输入框注册 `@` 来源,列出已有会话的部门;选中后进入该部门子会话。
- 进入部门子会话时自动选中对应部门;返回丞相主会话时恢复选中丞相。
- 移除 Agent 预设编辑、重复的「下旨」输入框和独立聊天摘要。
- 复用 DSH 主题变量,支持明亮、深色与窄侧栏布局。
- 0.5.6 左栏那一行改名「上朝」(`label: () => "上朝"`),`order` 从 10 改成 −100,排在「插件」之外的所有插件行之前(置顶)。
- 0.5.5 撤掉了 0.5.3 的左侧栏底部入口(`sidebar.footer.action`):用户看到左栏里同时出现导航行和底部一行,明确要求只保留导航列那一行。左栏入口从两个收敛成一个。
- 0.5.4 把入口放进左侧栏导航列(`插件 / 定时任务 / 任务看板 / MCP 连接器` 那一列):注册 `sidebar.panellist` 一行(细线「三」字样标 + 标签),点击后走宿主的 `selectPanel(id)`。
- 因为那一列的点击一定要 `main` 槽,所以同时注册 `main`(`key: PANEL_ID`)作为**重定向桩**:进去立刻把朝堂停靠到当前会话右侧栏并 `selectPanel(null)` 退回原会话;没有会话时只在页面中央写明原因。它不渲染面板、不承载聊天。
- ~~0.5.3 在左侧栏底部加了一个常驻入口~~:0.5.5 已撤掉,见上条。
- 0.5.3 去掉了会话头开关失败时对 `host.togglePanel()` 的回退:0.5.0 起没有 `main` 槽,那个调用只会把主区域切到一个不存在的面板上。
- 0.5.2 把响应式断点从浏览器视口改到面板容器:`.sl-root` 声明 `container-type:inline-size;container-name:slpanel`,11 处 `@media (max-width: …)` 全部改为 `@container slpanel (max-width: …)`。真实宿主窗口最大化时侧栏仍只有 371px,原来的视口断点一个都不会触发。
- 部门配置里的「最近活动」独占一行(最多两行后省略),不再和状态文字挤在同一行被裁断;单列阈值落在 330px 容器宽(360px 及以上仍两列)。
- `scripts/preview.mjs` 新增 `--viewport`,可以渲染「大窗口 + 窄侧栏」的真实宿主形态。
- 0.5.1 清掉侧栏化残留:46 个不再渲染的 `sl-*` 类、无调用点的 `SanshengPinRow`/`DockButton`/`SidebarIcon`,以及三个无规则的幽灵类名。
- 会话头部开关在拿不到会话时把原因显示在开关旁,不再静默回退;CSS 与组件的一致性由测试兜住。
- 版本更新到 `0.5.6`;`CHANGELOG.md`、`panel/README.md`、`docs/panel-design.md` 已同步。
## 3. 当前验证结果
在 `C:\Users\qyh15\三省六部` 执行:
```powershell
$node = 'C:\Users\qyh15\AppData\Local\Programs\DeepSeek Harness\DeepSeek Harness.exe'
$env:ELECTRON_RUN_AS_NODE = '1'
& $node --check panel/lib/client.js
& $node --test --test-isolation=none test/policy.test.js panel/test/client.test.js
& $node scripts/check-install.mjs
```
结果:
- 语法检查通过。
- **39 项测试全部通过**。
- `scripts/check-install.mjs` 通过:panel 以 link 方式安装,client bundle 已注册。
- `modeEnabled: false` 只表示「上朝」模式尚未启用,不表示面板不可用。
- 清理前后做了像素级 A/B:用同一份 `scripts/preview.mjs`、同一组参数,分别渲染 0.5.0 快照(`.scratch/preview-baseline/client.snapshot.js`)与 0.5.1 的 `panel/lib/client.js`,五组(440/400/360 明亮、440 任务页、440 深色)截图的 sha256 **逐字节相同**,证明删掉的 CSS 与组件确实不在渲染路径上。
- 体积变化:内联 CSS 40,963 → 28,346 字符(−30.8%),HTML 52,261 → 39,596 字节(−24.2%)。
尚未完成:真实 DSH Host 的视觉截图验收。当前只有 Chromium 对真实组件树的渲染图。
## 4. 代码地图
| 文件 | 作用 | 当前注意点 |
| --- | --- | --- |
| `panel/lib/client.js` | 前端全部实现:CSS、React 组件、DSH 槽位、@ 来源、宿主适配 | 约 1890 行,单文件自包含 bundle;修改后必须跑 `--check` |
| `panel/lib/model.js` | 十席定义、布局、状态、模型切换等纯逻辑 | 与 client 内自包含常量需要同步 |
| `panel/index.js` | 策略侧 formation/decree 提示词 | 与前端职责保持一致 |
| `index.js` | Agent Preset 策略、角色工具权限 | 不得随意放宽写入/命令权限 |
| `panel/test/client.test.js` | 面板结构与行为测试 | 使用最小 React 替身,`useState` 不自动更新 |
| `test/policy.test.js` | 策略与权限测试 | 与客户端测试合计 39 项 |
| `scripts/check-install.mjs` | 安装一致性检查 | 已改为校验右侧栏注册、拒绝旧的 main/panellist |
| `scripts/preview.mjs` | 零依赖预览生成器:vm 加载真实 bundle → 渲染真实组件树 → HTML → headless Chrome 截图 | 需放开沙箱跑 Chrome;`--html-only` 只出 HTML |
| `docs/panel-design.md` | 设计依据与验收标准 | 已更新到侧栏结构 |
| `CHANGELOG.md` | 版本变更 | 顶部已切到 `0.5.x` 线 |
### 前端关键位置
- `SanshengPanel`:右侧栏主组件,状态含 `sidebarView`、`selectedRole`、`activeChildId`。
- `SeatCard`:部门实体卡片。
- `courtStats`:四张统计卡的数据投影。
- `seatMentionOptions` / `createSeatMentionSource` / `registerSeatMentions`:原生 `@` 来源。
- `childRoleOf`:由子会话 id 反查部门角色,用于自动选中。
- `openSeatConversation` / `returnToLead`:进入部门会话与返回丞相。
- `apply`:注册五个原生槽位:
- `conversation.session.header.actions`(会话头开关)
- `sidebar.panellist`(左侧栏导航列的一行,标签「上朝」、`order: -100` 置顶;图标是插件提供的细线「三」字样标)
- `main`(只作重定向桩:停靠右侧栏后退回原会话,不渲染面板)
- `sidebar.right.pane.tab`
- `sidebar.right.pane.tab.title`
- `dockToSidebarTab(host)`:导航行点击后的实际动作(成功清提示并 `selectPanel(null)`,失败只写提示),导出在 `__test` 里供测试直接驱动。
## 5. 不可破坏的决策
1. **不恢复整页面板**。左栏只保留**一个**入口——导航列那一行;不要再加底部入口、页脚按钮或第二处重复入口(0.5.5 就是撤掉这类重复)。`sidebar.panellist` 只用于「左侧栏导航列的一行」,`main` 只用于「点进去立刻退回会话」的重定向桩:两者都不得渲染朝堂内容、不得承载聊天、不得出现第二套输入框。用户 0.5.4 明确要求入口出现在导航列,这是对 0.5.0「两个槽一律不注册」的收敛式修订——范围限定在「纯跳转」,不是把整页面板请回来。
2. **不造第二套聊天存储**。消息只在 DSH 原生会话里发送与保存。
3. **不静默改投消息**。普通 `@` 文本不能自动把当前会话消息转发给别的 Agent;进入哪个会话,消息就发给谁。
4. **@ 只列已有会话的部门**。未设官、无子会话的部门不能伪造入口。
5. **权限不因界面变化而放宽**。这只是客户端面板调整,不修改 `index.js` 的工具边界。
6. **版本历史只用 Git**。不要创建 `backup/`、时间戳副本或“最终版”目录。
## 6. 换环境后的推进顺序
### 第 1 步:带走代码,而不是复制一堆副本
当前工作树有未提交改动。换环境前先在原环境提交一次,或生成 Git bundle:
```powershell
cd C:\Users\qyh15\三省六部
git add -A
git commit -m "feat(panel): move court into sidebar and use native chat mentions"
```
如果目标环境不能直接访问原磁盘:
```powershell
git bundle create sansheng-liubu-0.5.0.bundle --all
```
到新环境:
```powershell
git clone sansheng-liubu-0.5.0.bundle 三省六部
```
不要手工拷贝整个工作区,也不要把 `node_modules`、`.chrome-preview` 或临时 HTML 带过去。
### 第 2 步:确认宿主与安装方式
新环境先确认:
- DSH 版本支持 `sidebar.right.pane.tab` 与 `inputTriggers.registerSource`。
- profile 的 `dsh.profile.bundles` 含 `dsh-sansheng-liubu-panel`。
- panel 以 `link:` 或可编辑的开发方式安装,避免每次改代码都重新打包。
- 如需「上朝」模式,再执行 `node scripts/mode.mjs on`;面板本身不需要先开模式。
### 第 3 步:真实宿主验收
重启 **DSH Host**,不是只刷新浏览器。然后:
1. 打开一个会话,确认右侧栏出现「三省六部」页签。
2. 检查「朝堂 / 任务」切换;点击「在朝成员」「在办任务」统计卡。
3. 在原生输入框输入 `@`,确认只出现已有会话的部门。
4. 选择 `@工部`,确认进入工部子会话,右侧栏自动选中工部。
5. 在工部会话发送一句话,确认消息进入工部而不是丞相会话。
6. 点击「返回丞相」,确认回到父会话且选中恢复丞相。
7. 在 360、400、440、480px 侧栏宽度下检查:无横向滚动、卡片名称和状态不被裁切。
8. 切换 DSH 明亮/深色主题,确认没有刺眼白卡或不可读状态。
### 第 4 步:处理剩余技术债
这些不阻塞功能,但建议在下一个环境完成:
- ~~删除已不再渲染的旧 CSS~~:0.5.1 已删除 46 个死类、约 117 行规则(CSS 374 → 257 行)。
- ~~删除未引用的 `SanshengPinRow`、`DockButton` 包装~~:两者与 `SidebarIcon` 导出均已删除(确认外部无消费方)。
- ~~检查会话头部开关在“当前没有会话”时的反馈~~:0.5.1 已把失败原因显示在开关旁(`role="status"`),并有回归测试。
- 视真实宿主表现,决定是否保留 `remote.agentPresets` 注入;高级信息仍读取只读预设,不要贸然删除底层能力。
- 为真实右侧栏补一张宿主截图,替换/补充 `panel-preview-sidebar.png` 作为验收证据。
## 7. 可直接粘贴给新环境 Agent 的交接提示
```text
你在 C:\Users\qyh15\三省六部 继续一个 DSH Web 客户端插件项目(dsh-sansheng-liubu-panel,当前 0.5.6)。
用户目标:三省六部面板只存在于会话右侧栏;聊天必须复用 DSH 原生输入框;在原生输入框用 @ 选择部门后进入该部门子会话,并自动选中右侧对应部门;不要再恢复整页面板或第二套聊天。
先读:
- docs/panel-handoff.md
- docs/panel-design.md
- panel/lib/client.js 中 SanshengPanel、createSeatMentionSource、apply
- panel/test/client.test.js
- scripts/check-install.mjs
当前状态:侧栏化、残留清理、容器断点与左侧栏入口(含导航行)都已实现,39 项测试通过,check-install 通过,工作树可能尚未提交。不要创建备份目录。
请先:
1. 运行现有测试和 check-install,确认基线;
2. 在真实 DSH Host 重启后验收右侧栏、@ 导航、自动选中、返回丞相;
3. 修复真实宿主暴露的问题,并补回归测试;
4. ~~清理不再渲染的旧 CSS/组件~~(0.5.1 已完成,后续只需保持);
5. 更新 CHANGELOG、README 和设计文档,保持 0.5.x;
6. 用 Git 提交,不要建时间戳副本。
硬约束:
- 不注册 sidebar.panellist.actions;main 与 sidebar.panellist 只允许作「导航行 + 重定向桩」;
- 不新增聊天存储,不静默把消息转发给其他 Agent;
- @ 候选只含已有会话的部门;
- 不改变 index.js 的角色工具权限边界;
- 每个设计调整附一张新的实际预览图。
```
## 8. 验收标准
- [ ] 右侧栏可打开,朝堂与任务可切换。
- [ ] 十席完整,六部同属尚书省,无错误上下级连线。
- [ ] 部门卡片在窄栏仍清晰,名称与状态不裁切。
- [ ] `@` 只列已有会话的部门,选择后进入正确子会话。
- [ ] 进入子会话自动选中对应部门,返回后恢复丞相。
- [ ] 原生输入框发送的消息不会误投给其他 Agent。
- [ ] 明亮/深色主题都可读,焦点与选中状态可见。
- [ ] 39 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
- [ ] 有真实 DSH Host 截图作为最终视觉证据。
## 9. 已知风险
- 静态预览能按任意容器宽度渲染,但**不能**证明宿主实际给出的侧栏宽度、滚动容器和槽位渲染完全一致;必须实机验收。宿主实测侧栏宽度为 371px,已作为预览图之一(`panel-sidebar-371-light.png`)。
- 断点已改为容器查询,但容器是 `.sl-root`:若宿主把面板塞进更窄的固定宽外壳,实际生效宽度以内层容器为准。修改布局时先用 `--viewport=1200 --width=371` 复现真实形态,不要只看预览页宽度。
- `better-sidebar` 与宿主自带 `sidebarRight` 两条注册路径都要验证;只测其中一条不够。
- 测试用的最小 React 替身不会执行真实点击,交互问题需要宿主手测或补更真实的组件测试。
- 若新环境 DSH 版本没有 `inputTriggers`,`@` 入口应静默不可用,但其余侧栏功能不能因此崩溃。

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 174 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 160 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 165 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 162 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 107 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 97 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB

View File

@ -1,48 +0,0 @@
# 三省六部项目规划
## 已确定范围
- 本 session 按用户最新澄清交付第一版方案及 Web / dsh-go 样式预览,暂不接入真实宿主或业务后端。具体范围与验收见 [第一版方案](v1-plan.md),原生样式见 [dsh-go 交互预览](../preview/dsh-go.html)。
- 使用 DS Bot 的 Bot 团队业务及身份、角色、团队、普通 Agent 机制作为基础。
- 上游前端全部不采用,前端自行设计开发;要求适配 dsh-go,具体接口待核验。
- OpenMausBot 不再纳入方案。
- 每个项目固定10个 Bot、10个独立 session:丞相、三省、六部一一对应。各项目的会话、模型配置、上下文、任务与运行操作相互隔离。
## 从旧代码沿用的职责
来源:Git 提交 `832e265` 的 `workbench/core/roles.mjs` 中 SEATS 的 duty、responsibility 字段。以下职责与说明逐字沿用;全部角色显示名称统一为两字:丞相、中书、门下、尚书、吏部、户部、礼部、兵部、刑部、工部。丞相作为十席的配套定义一并列出。
清空前最后版本 `233ee76` 的 `sansheng/src/roles.js` 和 `sansheng/src/texts.js` 已缩为丞相、尚书、工部三角色,故不用于本次恢复完整十席职责。历史前端有另一套简短标签,此处以核心角色定义为准。
| 角色 | 职责(原文) | 说明(原文) |
|---|---|---|
| 丞相 | 接需求、分流、协调、汇报 | 面向用户承接想法:判断是否需要开工、必要时派给具体部门,并把各部门结果汇总成对用户的一次交付。 |
| 中书 | 调查、澄清、规划 | 先把问题问清、把材料看全,再给出可执行的方案与验收标准草案,不直接产出最终交付物。 |
| 尚书 | 分工建议、组织交付 | 把已经明确的方案拆成部门分工并组织交付;六部直属于尚书这一同级分组,六部之间不是上下级。 |
| 门下 | 审议与整体审核 | 对方案和交付做独立审议,指出风险与不达标处。首版没有门下审核的任务必须如实标注“未审核”。 |
| 吏部 | 角色和技能配置建议 | 对角色、技能与编制给出建议;职责不含绕过用户授权去改权限或其他项目设置。 |
| 户部 | 数据、表格、计算 | 处理数据、表格与计算,结论应可复算。 |
| 礼部 | 文档、内容、呈现 | 负责文档、内容与呈现形式,产出可编辑的源文件。 |
| 兵部 | 环境、调试、部署 | 负责环境、调试与部署;部署/发布等外部副作用仍服从用户授权与宿主审批。 |
| 刑部 | 测试与风险检查 | 做测试与风险检查,给出可追溯的检查结果,而不是一句“已通过”。 |
| 工部 | 代码实现与工程产出 | 负责代码实现与工程产出,交付可编辑源文件与真实检查结果。 |
## 本次沿用边界
本次搬入的是职责定义,不恢复旧代码、旧前端或旧会话初始化方式。旧文件的布局坐标、派工权限开关和首版初始化策略,不随职责自动成为新方案要求。
吏部的“编制建议”服从当前每项目固定10个Bot的硬要求,不表示允许自行增加或删除席位。
职责之外的派工权限、审核是否必须经过、退回及重试规则,留待后续规划;不从职位名称推导额外制度。
## 前端布局(2026-11-14 最新要求)
- 左侧导航增加“三省六部”入口;其下工作区、项目树、会话列表与其他现有区域保持当前行为,不纳入此次重设计。
- 中间直接复用 DSH 原生会话框。角色切换应导航到当前项目对应的独立 session,不重建聊天引擎。
- 右侧 sidebar 建立工作台,包含十席角色切换和角色配置,配置默认折叠。
- 工作台样式可复用旧代码:白蓝配色,丞相居中、三省三列、六部两排,支持深色与宽度调整。历史样式参考提交 `832e265` 的 `workbench/panel/lib/client.js`,不恢复其旧业务接线。
- dsh-go 仍是正式适配要求;本次窄屏预览只验证布局,不代表完成 dsh-go 的接口对接。
交互预览:[打开前端原型](../preview/index.html)。截图:[浅色](../preview/desktop-light.png)、[角色配置](../preview/role-config.png)、[深色](../preview/desktop-dark.png)、[窄屏工作台](../preview/mobile-workbench.png)。
原型中的左栏与中间会话仅为宿主布局示意;未提供截图的原有工作区区域明确占位,不虚构项目或会话。演示输入不调用模型,配置只存本浏览器,未创建十个真实 session,也未修改用户的日常 DSH 配置。正式集成时需要核验入口、sidebar 和会话导航公开接口。

View File

@ -1,20 +0,0 @@
# 十席职责汇报(本会话模型实跑)
日期:2026-11-15。方式:以三省六部十席各自身份,用本会话所用模型分别独立跑一次(10 次独立角色调用),
每席第一人称汇报自己的职责。下方为各席原话。
> 说明:这是用本会话的模型做的角色演练;隔离测试 DSH 本身未配置模型,插件内那十个会话因此仍为空。
> 二者不混淆:会话与绑定是插件真实能力,下面是同一模型分别“扮”十席得到的汇报。
| 部门 | 汇报(原话) |
|---|---|
| 丞相 | 我是丞相,负责面向用户承接想法:判断这件事是否需要开工,需要时把活派给具体部门,最后把各部门的结果汇总成一次交付给您。我不亲自下场做各部门的具体执行,也不越过它们去替部门定方案、改产物;我的边界是判断、分派与汇总。 |
| 中书 | 我是中书。我负责先把问题问清、把材料看全,再给出可执行的方案与验收标准草案,理清目标、约束和路径,供后续环节推进。我不直接产出最终交付物,也不越界替其他环节把活干完或替用户拍板。 |
| 尚书 | 我是尚书。我的职责是把已经明确的方案拆解为部门分工,并组织六部完成交付。我不参与方案的决策与改动,也不介入六部内部的执行细节;六部直属于尚书这个同级分组,六部之间是并列关系,并非上下级。 |
| 门下 | 我是门下。我负责对方案和交付做独立审议,逐项指出风险与不达标之处,并坚持:首版未经门下审核的任务必须如实标注“未审核”。我不参与具体方案设计与实施执行,也不替代任何一部做决策或背书。 |
| 吏部 | 我是吏部,负责就角色设置、技能配备与编制安排提出建议。我只做建议、不代为决策,也明确不绕过用户授权去改动权限或任何其他项目设置。 |
| 户部 | 我是户部,负责本项目中的数据、表格与计算工作,凡经我手的账目、口径与结论都须可复算、可追溯。我只做分内的数算与核对,不出方案、不定调子。 |
| 礼部 | 我是礼部,在本项目中负责文档、内容与呈现形式,并产出可编辑的源文件。我不参与非文档类事务的决策与执行。 |
| 兵部 | 我是兵部,专司环境、调试与部署一类事务。部署、发布这类会对外产生副作用的操作,我一律服从用户授权与宿主审批。 |
| 刑部 | 我是刑部,负责本项目的测试与风险检查,给出可追溯、可复核的检查结果,而不是一句“已通过”就交差。 |
| 工部 | 我是工部,负责代码实现与工程产出,交付可编辑的源文件和真实的检查结果。需求定夺、方案裁决与最终验收不在我的职责内。 |

77
docs/v0.1-使用说明.md Normal file
View File

@ -0,0 +1,77 @@
# 三省六部工作台 v0.1 · 使用说明
装好并重启 DSH 之后,右侧多一栏「三省六部」。它是**贴着当前项目**的一本工作台账:谁在办、办到哪、交了什么,都在这里。中间仍然是原生聊天,没有第二个输入框。
## 1. 先接通,再派工
十席(丞相 / 中书 / 尚书 / 门下 / 吏户礼兵刑工)一开始都是「未接通」——只是编制,还没有会话。
1. **朝堂**页点卡片右下角的「接通」。宿主会给这一席建一个独立会话,并把卡片状态变成「空闲」。
2. 卡片本身是可点的:点已接通的卡片,中央区会切到那一席的会话。
3. 接通后,这一席才收得到派工。
「接通」做的事:建会话(或复用已有会话)→ 把会话号写进账本绑定 → 打开它。换绑不自动发生,需要显式重接,避免把两个部门串到同一个会话上。
## 2. 派一条任务
**任务**页 → 「新建」→ 填标题、目标、主责部门 → 「存为草稿」。
草稿不会自己跑,因为服务端不允许把任务直接塞进一个还没接通的部门。接下来:
- 部门已接通:在任务行上点 **「派工」**,任务会被投递到那一席的会话里,卡片变「正在运行」。
- 部门没接通:先回朝堂接通,再回来点「派工」。
- 派错了或不想跑了:点 **「取消」**。取消只改台账状态,不会删除已经发生的对话。
同一条任务重复点「派工」不会派出两份——幂等键按任务号生成,第二次会返回第一次那条记录。
## 3. 部门怎么回话
部门在自己的会话里干活,完成后回一段带前缀的契约行(宿主解析,不需要你手抄):
```
【三省六部】{"action":"reportTaskResult","taskId":"…","report":{"summary":"…","checks":[…],"artifactRefs":[…]}}
```
收到并校验通过后,任务变「已完成」,成果进「成果」页。判定是三件事都要成立:**运行结束、报告合格、成果核验通过**。缺一件就停在「需人处理」,等你说下一步。
## 4. 成果与修订
**成果**页每行是一份交付物:
- 灰色「· 位置未核验」:只登记了路径,还没确认文件在不在。
- 红色虚线「· 文件已失效」:登记过,但磁盘上找不到了。记录还在,可以重新登记,或让主责部门补一份。
- 「第 N 版 · 修订自上一版」:这是某份成果的修订版,原始版本仍然可查。
点开一行 → 「找主责部门修改」→ 写清楚要改什么 → 「存为草稿」或「直接派工」。这会**只**给原主责部门开一条修订任务,不重跑三省。
## 5. 模型
部门模型由根插件按角色覆写,走的是 `/dept-model` 命令,不在右栏里改(右栏只显示当前生效的模型):
```
/dept-model 工部 magpie workbuddy/deepseek-v4.1-flash 高
/dept-model list
/dept-model clear 工部
```
右栏卡片上的模型行就是它当前会用的那个;显示「跟随宿主」表示没有单独设。
## 6. 栏宽与键盘
- 拖分隔条,或在分隔条上按方向键(±16px,Shift ±64px,Home/End 到两端),宽度记在 `localStorage['sansheng.workbench.railWidth']`,范围 340–600。
- 卡片是 `role="button"`,Tab 可到,Enter / 空格打开会话。
## 7. 项目隔离
每个项目一本账:席位绑定、部门配置、任务、成果、事件都按项目分桶。切项目会重新取一次 `bootstrap`,看不到别的项目的东西。同一个目录被登记成两个项目会明确报冲突(要共用请显式传 `allowSharedRoot`)。
## 8. 出问题怎么办
| 现象 | 处理 |
| --- | --- |
| 中央区白屏或样式崩了 | 控制台执行 `localStorage['sansheng.workbench.main']='off'`,刷新。接管被整个跳过,原生聊天照旧 |
| 右栏不出现 | `node scripts/workbench-preflight.mjs` 看 5 项自检;再确认重启是**彻底退出**而不是关窗口 |
| 派工后一直「已备好」 | 宿主没接上会话层:重启获取一次;右栏会提示「已记入台账,但暂时没有真的发出」 |
| 完全不想用了 | 从 profile 移除 `dsh-sansheng-liubu-mode` 后重启(独立 workbench 包已退役) |
账本在 `%USERPROFILE%\.dsh\sansheng-liubu\workbench.json`。它是唯一事实来源,删掉等于清空工作台;Git 回退代码不会回退它。

376
docs/v0.1-实施方案.md Normal file
View File

@ -0,0 +1,376 @@
# 三省六部独立工作台 v0.1 实施方案
日期:2026-11-09
用途:交给执行者的实施与验收依据。当前只完成方案编写,未实现、安装或迁移。
版本含义:v0.1 是新架构的首个里程碑,不代表把现有 0.9.2 软件包直接降级为 0.1.0。
## 1. 执行摘要与约束优先级
要交付的是 DSH 内的独立工作台:左侧直接使用 better-workspace-group 现有项目树,中间显示所选部门的真实会话,右侧显示可调宽的部门树、模型配置以及任务与工作成果。每个项目的每个部门有独立 session;程序定向传递必要上下文,模型承担专业判断。多个项目可以同时运行,配置、会话、结果和停止操作互不串线。
用户已经确定的硬要求:
1. 独立主页面,不依附于某个普通聊天或丞相 Team;不要求 spawn_teammate 才能找到部门。
2. 复用现有项目树,不新建项目列表,不恢复顶部项目标签。分组不是项目。
3. 项目隔离从首版实现,服务侧检查归属,不能只过滤前端列表。
4. 右侧树状方块:丞相顶端居中;下一排中书、尚书、门下;尚书连接六部这一同级分组。六部两排展示,不能画成上下级。
5. 每个部门独立改模型,修改只影响当前项目当前部门;运行中的请求保持原配置。
6. 中央聊天优先保留空间,右栏可拖动、收起、恢复;白蓝浅色、跟随宿主的深色模式,紧凑字体。
7. 工作成果由 Agent 产生,用户在聊天中提供材料;成果区没有要求用户上传交付物的流程。
8. 使用 Git 管理版本。不创建 backup、时间戳副本或“最终版2”代替版本历史。
本文的字段、模块名和开发顺序是实施设计,不是已存在的 DSH API。与宿主真实接口有冲突时,先写明证据和适配方案;不得把虚构调用当成已验证能力。需求冲突按“用户最新指示 → 本文首版范围与已确认视觉要求 → 总体规划 → 历史资料”处理。
相关资料: [总体规划](../V1.0-工作台修复方案.md)、[视觉要求与预览](panel-design.md)、[待办](../TODO.md)、[交接入口](panel-handoff.md)。旧 Team/侧栏规则不具有新架构约束力。
## 2. v0.1 范围与完成定义
本方案建议:开发中先以丞相、工部两席跑通闭环,最终 v0.1 扩展到全部十席的独立会话与相同基础能力。两席闭环不能冒充十席完成。其余部门未接通时明确标注“尚未接通”,不能显示待命或可执行。
### 2.1 必须交付
| 能力 | 首版要求 |
|---|---|
| 页面入口 | “上朝”进入独立工作台,同页聊天,无需父会话 |
| 项目入口 | 真实接入现有项目树选择和稳定工作区 ID |
| 十席 | 丞相、三省、六部均可按需创建独立会话、直聊、恢复历史 |
| 配置 | 每席保存明确 provider/model/受支持 effort;实际运行可核对 |
| 基础交接 | 创建任务单、定向发送上下文与材料、回执、执行结果、回传 |
| 用户直聊 | 只发当前部门;切换部门保留各自草稿 |
| 成果 | 文件引用、主责部门、来源任务、真实检查、局部修改入口 |
| 运行控制 | 会话串行投递,跨项目可并行,取消准确指向运行 |
| 可靠性 | 幂等、失败/未知状态、刷新恢复、宿主重启后的对账 |
| 隔离 | 会话、配置、材料、记忆、权限、任务及文件边界验证 |
| 视觉 | 已确认三栏、调宽、居中、浅深色、手机抽屉、键盘可用 |
| 验收 | 单元/集成测试及真实 DSH GUI 双项目端到端证据 |
### 2.2 后续版本再做
完整自动化的“中书规划 → 门下审议 → 尚书派工 → 六部执行 → 成品审核”引擎、多层任务 DAG、自动重规划、无限层级子任务、自建技能市场、跨项目共享、自动迁移旧 Team、自动压缩换 session、成本统计仪表盘和进度百分比均不属于 v0.1。
首版可以由用户或丞相选择需要的部门,以单任务、单主责执行和结果回传构成闭环;不同部门的独立任务可并行,但同目录写冲突必须协调。不要为了自动化朝廷流程阻塞基础聊天和项目隔离。不要把十席常驻展示理解为进入页面就启动十次模型请求。
### 2.3 两条必须演示的业务路径
路径 A:用户在项目 A 找丞相提出明确工程任务 → 丞相通过受控交接操作提交工部任务单 → 程序创建/定位工部独立会话并发送必要材料 → 工部执行和检查 → 结构化报告登记结果与源文件 → 丞相收到定向结果并汇报。此时项目 B 同时运行独立任务,配置和消息保持隔离。
路径 B:用户在成果区点击“找主责部门修改” → 工部会话得到用户指定修改、成果版本及来源任务 → 修改原工作文件 → 新增修订记录和检查结果。无需重新启动整套三省流程。普通问答不强制生成任务。
## 3. 第一阶段必须核实的宿主能力
执行者先只读核实实际安装版本和源码;当前仓库中的调用痕迹只是调查线索。不得凭接口名字假设权限、返回值、完成语义或跨项目安全性。
建立 [宿主能力记录](host-capabilities.md)(实施时创建),每项填写:宿主/插件版本、源码路径与行号、调用签名、返回值、错误语义、最小验证、结论、需改动的仓库。状态只能是“已验证 / 需要扩展 / 未确认 / 不支持”。
| 项目 | 要取得的证据 | 阻塞条件 |
|---|---|---|
| 主页面扩展 | 可注册独立页面、导航、卸载行为 | 只能渲染旧聊天 sidebar |
| 项目树 | 插件真实标识、稳定 workspace ID、选择事件、初始选择、重命名/移动/删除行为 | 只能读取 DOM 文本或依赖名称猜测 |
| 内嵌聊天 | 组件生命周期、传入 session ID、原生历史/附件/输入/审批能力 | 只能跳去外部聊天页 |
| 独立 session | 创建参数、准确 ID、工作目录、角色配置、创建幂等/可查询性 | 只能扫描“最新会话”猜 ID |
| 消息投递 | 指定 session、文本、附件、消息 ID、接收回执 | 只能把文本塞进当前输入框 |
| 运行关联 | hostRunId 与消息/dispatch 的关联、终态、取消、重启查询 | 只有通用 idle 状态且无可追溯终态 |
| 模型目录 | provider/model ID、effort 枚举、可用状态、实际请求配置 | 只能改全局默认或无法核对生效 |
| 配置/工具权限 | 会话独立配置、技能绑定、宿主审批和写入边界 | 角色提示词承担实际权限控制 |
| 材料/记忆 | 附件授权引用、检索范围、全局记忆注入的开关与作用域 | 无法阻止其他项目材料自动进入 |
| 存储 | 宿主允许的位置、原子更新/事务、版本、事件恢复 | 仅浏览器 localStorage 保存任务账 |
| 主题/构建 | 宿主主题令牌、真实客户端构建和加载方式 | 改源码但当前 GUI 未加载 |
项目树可能只提供 workspaceId,没有另一个 projectId。此时在插件中生成稳定 projectId,并与 hostWorkspaceId 建唯一绑定;不要强迫宿主增加同义标识。若宿主原生 ID 足够稳定,也可使用该 ID 作为内部项目键,须记录决定。绝不能用目录名、树行号或显示名称作主键。
若缺少核心能力,交付最小宿主扩展提案和可复现证据。先完成不依赖该能力的纯逻辑、测试和视图工作;明确阻塞集成部分,不以假数据宣布完成。若需要修改本仓库外的宿主或第三方插件,说明具体仓库与变更边界,由该处适用权限控制;不要直接改安装包内的 app.asar 当成可维护实现。
DS Bot 仅为页面组织参考。当前没有核实其真实上游地址、版本或许可证。需要借用代码时先核实并记录授权;不为寻找参考引入第二套会话运行时。
## 4. 分层与复用策略
建议分为四层:工作台 UI → 项目服务/任务服务 → 会话及宿主适配层 → DSH 原生能力。任务调度必须在可持续运行的服务侧,关闭页面不会停止派发和结果处理。UI 订阅投影,不承担唯一调度者职责。
| 模块(建议名称) | 职责 |
|---|---|
| WorkspaceAdapter | 承接现有树选择、稳定 ID、生命周期 |
| SessionAdapter | 创建/查询 session、投递、运行查询/取消、原生聊天接入 |
| ModelAdapter | 目录、参数校验、明确配置快照与实际生效核对 |
| ProjectService | 项目和部门绑定、归属校验、并发版本更新 |
| ContextBuilder | 按任务构建最小上下文包、校验材料及版本 |
| DispatchService | 持久队列、幂等、单会话串行、公平并发 |
| ResultService | 校验报告、关联运行、成果登记和回传 |
| Reconciler | 启动对账、断线恢复、未知状态核查 |
| WorkbenchView | 三栏、树、会话容器、任务与成果、设置 |
这些是内部职责边界,不要求为了形式拆成十个软件包。先用本仓库技术栈,优先已有依赖;新增依赖需说明必要性。
现有[策略入口](../index.js)可参考角色职责,但必须拆除以 membership 决定身份的默认逻辑,否则所有独立会话可能都变成丞相。[旧客户端](../panel/lib/client.js)可参考主题、模型选择与注册方式,但不复用父会话/Team 投影作为状态源。[旧桥接入口](../panel/index.js)中的组建提示词不能作为新会话创建流程。[纯逻辑模块](../panel/lib/model.js)的角色定义需核对后复用。
先看 git status/diff,保护执行者开始前已有改动。不要整文件覆盖未理解的用户修改,不自动迁移旧 session。旧功能如需保留,用明确模式边界区分;新工作台不能误执行旧 Team 注入。
## 5. 身份与数据模型
以下是逻辑字段建议,不指定数据库产品。聊天正文继续由 DSH 保存;插件仅存业务账、引用和必要交接快照。所有服务入口必须从可信宿主上下文确定调用身份,再验证传入 ID;模型填写的 projectId 不能成为授权依据。
### 5.1 角色标识
| roleId | 中文 | 首版职责 |
|---|---|---|
| lead | 丞相 | 接需求、分流、协调、汇报 |
| zhongshu | 中书省 | 调查、澄清、规划 |
| shangshu | 尚书省 | 分工建议、组织交付 |
| menxia | 门下省 | 审议与整体审核 |
| libu | 吏部 | 角色和技能配置建议 |
| hubu | 户部 | 数据、表格、计算 |
| lipu | 礼部 | 文档、内容、呈现 |
| bingbu | 兵部 | 环境、调试、部署 |
| xingbu | 刑部 | 测试与风险检查 |
| gongbu | 工部 | 代码实现与工程产出 |
核对现有标识后建立显式兼容映射,尤其吏部与礼部不可混用。修改中文显示名不改变 roleId。吏部的职责不赋予它绕过用户授权修改权限或其他项目设置的权力。
### 5.2 核心记录
| 实体 | 必要字段 |
|---|---|
| Project | id、hostWorkspaceId、displayNameCache、canonicalRoot、status、schemaVersion、revision、timestamps |
| DepartmentBinding | projectId、roleId、currentSessionId(nullable)、bindingGeneration、historySessionRefs、creationRequestId、revision |
| DepartmentConfig | projectId、roleId、providerId、modelId、reasoningEffort(nullable)、rolePromptVersion、skillRefs、permissionRef、configRevision |
| Task | id、projectId、title、objective、acceptance、ownerRoleId、sourceRoleId、originMessageRef、scope、status、activeAttemptId、revision |
| Dispatch | id、projectId、taskId、attemptId、sourceSessionId、targetSessionId、bindingGeneration、contextPacketId、idempotencyKey、status、hostMessageId、timestamps |
| Attempt | id、projectId、taskId、dispatchId、sessionId、hostRunId、effectiveConfigSnapshot、state、error、startedAt、endedAt |
| ContextPacket | id、projectId、taskId、version、相关原始消息引用及必要摘录、objective、constraints、authorizationRefs、materialRefs、scope、expectedOutputs、returnTarget |
| Result | id、projectId、taskId、attemptId、reportVersion、summary、artifactRefs、checks、remainingItems、blockedReason、sourceMessageRef |
| Artifact | id、projectId、taskId、ownerRoleId、fileRef、displayName、mediaType、versionOrHash、verification、sourceResultId |
| AuthorizationRef | id、projectId、sourceHumanEvent、scope、planVersion、hostApprovalRef、status |
| Outbox/EventInbox | eventId/idempotencyKey、projectId、相关实体、处理状态、序号/游标、时间戳 |
授权记录只引用真实人类授权或宿主批准;摘要不能凭空制造批准。模型产生的“用户已同意”只是一段待核实文本。
约束:
- (projectId, roleId) 当前绑定唯一;非空 currentSessionId 不得绑定到多个项目或部门。
- task、dispatch、attempt、result、artifact 的 projectId 必须一致,跨项目引用拒绝。
- targetSessionId 在派发时固定并保存 bindingGeneration;换绑不能把旧消息自动送进新会话。
- 主键使用稳定随机 ID;名称/路径作为属性。目录解析后的规范路径用于冲突检查,不作唯一身份。
- 任务与 outbox 在同一事务内持久化;没有事务能力时实现可恢复日志并验证崩溃窗口。
- 配置用 revision/CAS 防止多个标签页互相覆盖,不能单靠浏览器锁。
- 凭据由宿主管理,只存凭据引用;不得把 token 写进上下文、任务账或日志。
### 5.3 页面本地状态
selectedRole、panelWidth、panelCollapsed 等可按“宿主用户/实例 + projectId”保存到本地。草稿还需 roleId 和 session/bindingGeneration;切换项目不能覆盖另一部门草稿。只作为 UI 恢复数据,不能取代持久任务账。宿主已有草稿管理时优先复用,不保存第二份相互竞争的草稿。
## 6. 会话创建、配置与模型切换
1. 项目首次进入时创建项目业务记录和十席配置初值,不自动发模型请求。
2. 首次明确开始聊天或收到授权派工时,按需创建该部门 session。
3. 服务获取 projectId+roleId 创建锁,读取已有绑定;已有可用会话直接使用。
4. 带 creationRequestId 调用经验证的宿主创建能力,保存准确返回 ID 和绑定。超时先查证,不能直接再建。
5. 若创建成功但绑定保存失败,保留恢复记录,按 requestId 查回并补绑定。宿主若无对应查询,显示“创建结果待核实”,要求明确恢复,不扫描最新会话猜归属。
6. 独立会话的角色身份由可信 projectId+roleId 绑定注入,不能依赖 Team membership 或让模型自报角色。
7. session 被删除或不可访问时标记 unavailable,保留旧引用。提供显式新建接续会话,必要摘要与材料经过选择后传入,旧历史不删除。
新项目初始化时把宿主默认配置解析成明确值快照;以后全局默认变化不追改已初始化项目。所有模型选项来自真实目录,不写死预览中的模型或 effort。
保存模型设置只更新该部门 desired configRevision。一次运行在真正开始前固定 effectiveConfigSnapshot;已经开始的运行不变,等待队列尚未开始的运行使用最新合法配置,并记录版本。UI 分别显示“本次运行使用”和“下次运行使用”,不混用。
切模型不清历史、不改角色、技能或权限。新模型不支持旧 effort 时,表单要求选有效值或默认值,不透传非法枚举。目录失效/额度不足时明确失败,不静默回退其他模型。若宿主只能通过换 session 改模型,必须先形成适配设计并解决历史延续,不能偷偷丢弃会话来满足表面切换。
首版技能/权限可以使用明确的角色初值与只读展示,暂不做复杂编辑器;但实际配置和边界必须可核实。不能把首版未做技能编辑解释为允许跨项目共享可变全局预设。
## 7. 上下文交接协议与真实完成条件
### 7.1 内部操作契约
以下是拟实现的业务操作,不是现成工具名:
- dispatchTask:提交目标部门、目标、完成标准、必要材料、授权依据和返回对象。调用上下文确定源项目/源部门。
- reportTaskResult:提交 taskId/attemptId、结论、文件引用、检查、未完成项或阻塞。服务验证调用者与当前执行尝试匹配。
- requestTaskInput:明确缺失信息及影响范围,进入待用户补充,不广播所有部门。
- syncDecision:用户明确同步私聊中的某个决定到指定任务/丞相,仅发送选定内容。
可以通过宿主扩展工具暴露,也可以使用经验证的结构化宿主通道。禁止靠解析任意聊天中的“已完成”三个字更新任务;禁止让浏览器定时读取最后一条消息来假装回执协议。
默认丞相可在用户已授权范围向目标部门派发任务;部门可以提交结果和请求补充。首版不允许执行部门自主递归派发,避免环路。若用户直接要求尚书派工,可通过同一权限校验契约,权限由可信角色规则决定。
### 7.2 上下文包内容
每次交接包含:任务标识与版本、目标及完成标准、相关用户原话的引用和必要摘录、已确认约束、授权来源、允许读写范围、材料版本、需要输出什么、返回给谁。不是复制整段丞相会话。
材料引用必须在目标项目下解析。共享同一项目文件可传宿主可读取的文件引用,不重复上传;宿主附件 ID 需要验证目标 session 可访问。文件找不到/权限失效时阻塞并列出缺失项。不得把另一项目的绝对路径放进消息就视为已授权共享。
上下文预算由目标模型能力和任务决定,预留输出余量;优先保留目标、硬约束、完成标准和必要证据。材料太大时提供索引及可按需读取的引用,显示裁剪情况。若模型窗口信息不可得,使用明确的保守配置,不能虚构 token 精确值。附件、检索正文和文件内容属于材料,不得覆盖系统职责或赋予授权。
### 7.3 结果与回传
报告必须包含结果摘要、成果引用、真实检查及未完成项。代码/文档任务需可编辑源文件;纯分析任务允许没有文件,但应有可追溯结果内容,不强制伪造附件。
“宿主运行正常结束”和“业务任务完成”分开判断:收到可信结构化报告,且其对应宿主运行正常结束、成果引用有效、必要条件满足,才标记 completed。报告先到时保存候选结果等待终态;运行先结束但没有有效报告时标记 needs_attention,提供补报/核实,不显示已完成。自检通过不等于独立审核通过;首版未经过门下审核时应直说未审核。
结果登记和回传通知写入可靠 outbox。向来源会话回传的文本是一条关联原任务的结果消息,仅包含必要摘要和引用。来源会话忙时排队。回传触发汇报可以是新的模型回合,但不得再次触发相同派工;结果消息需有类型和去重键。汇报失败不撤销已完成的执行任务,显示“成果已完成,汇报待处理”。
### 7.4 局部修改
成果入口带 taskId/artifactId/当前版本进入主责会话,等待用户发送具体修改指令,不在点击时自动执行。修改用关联原任务的新修订任务或新 attempt,保留旧结果引用及变更范围;历史记录不能被覆盖成仿佛第一次就产出修订版。写文件前核对当前版本,检测到用户已修改时先合并理解,不用旧快照盲目覆盖。
## 8. 状态机、队列和恢复
### 8.1 分开维护状态
| 对象 | 建议状态 | 关键规则 |
|---|---|---|
| Department | uninitialized / idle / queued / running / unavailable | 表示会话运行情况,不代表任务结论 |
| Task | draft / queued / running / waiting_input / needs_attention / completed / failed / cancelled | 未解决项不得自动完成 |
| Dispatch | prepared / sending / accepted / unknown / rejected | 发出不等于接收;超时可能 unknown |
| Attempt | queued / running / succeeded / failed / cancel_requested / cancelled / unknown | 取消请求不等于已取消 |
draft 校验通过且授权有效后可入队;accepted 等待实际运行开始;收到运行关联后进入 running。waiting_input 仅恢复原任务所需输入,不能顺便扩大范围。failed/取消任务重试创建新 attempt,不覆盖历史。unknown 必须先对账,不能自动当失败重试。
每个 session 同时只有一个活动执行,用户直聊与系统派工经统一协调。若原生聊天绕过插件队列,适配层必须接入宿主原生队列或共享忙碌检查/原子调度;两套各自独立的“串行队列”不能防竞态。运行中补充消息仅在宿主确有 steer 能力时提供,否则明确排队下一轮,不猜测语义。
跨项目队列独立,受共享并发额度约束时公平调度,展示排队原因。A 等待输入不得长期占住可释放的全局执行槽。项目切换、面板收起、浏览器关闭只影响 UI,不发送停止请求。
### 8.2 故障处理要求
| 场景 | 必须行为 |
|---|---|
| 重复点击派工 | 相同幂等键返回同一 dispatch,不能两次执行 |
| 发送超时但可能已接收 | 标记 unknown,按请求/消息 ID 查询,查不清就待核实 |
| 重复完成事件 | 以 eventId/attemptId 去重,只登记一次结果和回传 |
| 乱序事件 | 使用宿主序列或校验当前状态;终态不被迟到 running 覆盖 |
| 页面切到 B,A 返回 | 更新 A 的数据投影,不写 B 的聊天/成果 |
| 配置并发保存 | CAS 冲突后读回,提示并重应用,不静默覆盖 |
| 绑定替换后旧运行结束 | 结果归旧 attempt,不能误标新会话已完成 |
| 点停止 | 指向该 project/task/hostRunId;等待宿主取消回执 |
| 取消和成功竞争 | 以宿主真实终态和事件证据定结果,不丢成功文件 |
| 用户刷新 | 重新读取业务账并订阅/补拉事件,不重新派工 |
| 宿主重启 | 获取调度所有权,查询非终态尝试,补结果/回执,再恢复安全队列 |
| 两个浏览器窗口 | 服务端锁/租约防止重复消费;UI 不是调度主节点 |
| 模型不可用 | 保留任务及错误,配置修复后显式重试 |
| 文件已删除 | 成果标记不可用,保留来源,不显示可打开成功 |
不要承诺外部副作用 exactly-once。宿主若不支持投递幂等,只能做到本地去重与未知状态保守核对;不可判定的窗口应留给明确恢复操作。
## 9. 项目、文件、记忆与授权隔离
所有读写服务校验“调用者可访问项目 + 目标资源属于该项目 + 操作被授权”。伪造 projectId、sessionId、taskId、artifactId、hostRunId 均应拒绝。订阅流、缓存及草稿也必须带项目键,不能使用单个全局 activeSession 变量处理回调。
文件边界需要真实规范化路径,处理 Windows 大小写、相对路径、父目录与 junction/符号链接。不要假设 workspace-write 自动阻止链接逃逸。使用宿主经验证的文件访问策略;若无法保证,明确限制受支持布局并阻止不安全的自动写入。
首版默认独立项目目录。检测到两个项目相同或重叠可写目录、指向同一实际目标的链接时,提示冲突并阻止声称独立的并行写任务;优先要求使用分离目录/独立 worktree。若增加显式串行共享模式,必须明确它不提供完全文件隔离,并按解析后的资源范围加锁。相同项目不同部门也需声明写范围,重叠写任务串行;只读任务可并行。
宿主可能默认注入全局记忆或检索其他工作区。执行者必须核对并限制部门 session 的项目记忆来源;不能只在 ContextBuilder 过滤材料却保留另一条全局自动注入路径。无法隔离的可选记忆功能先关闭并记录限制。用户偏好类全局信息与其他项目业务内容区分,不能借“全局记忆”名义带入项目机密。
外部服务、端口、终端和环境变量不是 session 天然隔离资源。工具工作目录固定在目标项目,运行参数不能跟 UI 当前选择漂移。部署/发布/发消息等操作服从用户明确授权及宿主审批;跨 session 交接不得把普通文字当成宿主批准凭据。原授权覆盖的常规操作持续执行,不为每次派工重复要求用户确认。
## 10. 页面与交互施工规范
视觉依据为[已确认设计](panel-design.md),浅色[概念图](../dsh-image-gen/image-5eef6f14.png)和深色[概念图](../dsh-image-gen/image-ef9e9758.png)仅表达布局与配色。无需再设计一套页面;生成图字体、宽度和虚构模型不是像素规范。
### 10.1 布局
- 左:复用现有项目树及其宽度管理。其缺失时提示安装/接入问题,不悄悄生成替代树。
- 中:紧凑项目/部门标题、真实原生会话和输入框。标题及输入提示明确当前接收部门。
- 右:同一区域“部门 / 任务与成果”页签。默认展示部门树,模型设置在右区展开或受控浮层,避免增加第四列。
- 树使用稳定三列对齐布局:丞相跨三列居中;中书/尚书/门下各一列;尚书下接六部组,六部按吏/户/礼、兵/刑/工两行排列。
- 连线根据布局自适应,六部连接到同一分组,不画成吏部下辖兵部。树结构是职责展示,不是 session 父子关系。
初始尺寸建议作为调试起点:右栏约 400 CSS px,允许约 340–600 px;中央聊天尽量不少于 560 px。最终取宿主现有密度及真实可用区域校准,不按屏幕物理像素直接换算。中央与右栏不足以容纳最小尺寸时切抽屉/折叠,禁止负宽度或缩小全部文字硬塞。右栏上限同时受剩余容器宽度约束。
分隔条支持拖动、键盘方向键、可见焦点及恢复默认;使用合适 separator 语义并说明当前宽度。按项目记宽度/折叠,手机使用独立布局。缩小后仅限制当前渲染值,避免覆盖用户大屏偏好。
### 10.2 方块与模型设置
卡片主体打开会话;模型按钮只打开设置,阻止事件冒泡且有独立焦点。十席都需模型入口。卡片状态来源真实业务投影,没有运行过显示“未开始”,不是“运行中”。模型长名截断可查看全名,provider 不用猜。
保存时显示“仅当前项目的此部门生效”。运行中同时显示当前模型与待生效模型。错误应有具体原因和恢复入口,不静默重置下拉框。模型目录空时禁用保存并解释。
### 10.3 任务与成果
任务列表显示主责部门、状态、更新时间;详情展示目标、交接材料、尝试、失败原因、检查和成果。不要显示无来源完成百分比。成果显示源文件、主责部门、检查状态、打开和局部修改操作。上传入口只属于聊天材料输入。
“同步决定”必须显示接收任务/部门和将同步的内容;普通私聊不会自动广播。系统回传是有来源的任务消息,与用户原话分开标识。
### 10.4 主题、手机和空状态
尽量复用宿主语义颜色令牌。浅色白/浅蓝灰/蓝强调;深色深蓝灰/灰白文字/柔和蓝强调。覆盖输入框、下拉、弹层、连线、滚动条、焦点、禁用、错误、选中。状态不仅依靠颜色。
手机通过现有项目树入口和右侧部门抽屉切换,中央对话优先;模型设置、任务详情可全宽展示。不能把桌面树整体等比缩到难以点击。选择部门后关闭抽屉并回到该部门对话。主题切换和开关抽屉不能重建 session 或清空草稿。
必须覆盖:未选项目、插件缺失、未初始化、创建中、绑定失效、模型不可用、排队、投递未知、等待输入、任务失败、没有成果。错误文字说明发生在哪个项目/部门,不要求用户猜测。
每次改变已确认布局都附新预览供核对;实施阶段优先使用真实宿主截图。沿用现有视觉要求不需要为了交方案重复生成概念图。
## 11. 分阶段执行清单与出口
| 阶段 | 工作 | 交付与进入下一阶段条件 |
|---|---|---|
| P0 基线 | 读当前代码、Git 改动、宿主接口与项目插件 | 能力记录及阻塞表;不把推测记成支持 |
| P1 数据基础 | 项目绑定、十席角色、配置、持久化、归属校验 | 双项目配置隔离、唯一约束、事务恢复测试通过 |
| P2 两席闭环 | 丞相/工部独立 session、结构化交接、运行/结果关联 | 不开 Team 完成真实任务及回传,未知投递不重复 |
| P3 十席接入 | 同一机制扩展其他八席、角色提示与权限核对 | 十席直聊/模型配置真实可用,不自动全员启动 |
| P4 工作台 | 项目树、原生聊天、右侧树、设置、任务成果、调宽主题手机 | 同页可用,布局符合确认图和文字要求 |
| P5 恢复隔离 | 取消、重复/乱序、重启、共享目录、记忆和附件 | 双项目并发及故障矩阵通过 |
| P6 验收交付 | 当前 GUI 实测、构建、文档、版本与已知问题 | 提交证据、测试命令、限制及回退说明 |
UI 静态布局可与 P1–P3 并行,但真实集成依赖已验证接口。自动化任务链留到后续,不借 P3 扩展首版范围。每阶段用小 Git 提交保留可检查差异;提交只包含本任务变更。提交和发布是两件事,不自动推送、发布或重装宿主。
如多人实施:数据/调度、宿主适配、UI、验收可分工;明确文件写范围和契约负责人,接口变动先同步。不要同时修改整个旧客户端再靠最后合并猜结果。
## 12. 验收矩阵
下面每项需要记录实际结果与证据。“已写代码”不等于通过。Mock 测试只能证明插件逻辑,不能证明宿主接入。
| ID | 操作 | 预期 |
|---|---|---|
| A01 | 无普通聊天时打开上朝 | 独立页面可进入,不要求 Team |
| A02 | 从现有树切 A/B,重命名/移动项目 | 使用稳定绑定;名称变化不换 session |
| A03 | 点击分组节点 | 不创建项目或十席会话 |
| A04 | 双击首次启动同部门 | 唯一 session 或明确待核实,不重复创建 |
| A05 | 十席分别发送短消息 | 输入接收方、历史、实际 session 一致 |
| A06 | A 工部改模型,B 工部用另一模型 | 配置与实际请求分别正确,全局默认不变 |
| A07 | 运行中切模型 | 本次保持原模型,下一次使用新配置 |
| A08 | 模型不支持旧 effort/目录失效 | 校验错误可见,无静默替换 |
| A09 | 丞相带文件交接工部 | 材料可读、引用可追溯、不复制无关历史 |
| A10 | 正常完成任务 | 有效报告+运行终态+成果核验后完成,回传一次 |
| A11 | 仅变 idle 或输出“已完成” | 不据此标记业务完成 |
| A12 | 重复投递/重复完成/乱序事件 | 不重复执行、不重复成果、不倒退终态 |
| A13 | 发送已接收但回执超时 | unknown 对账,不自动重发 |
| A14 | 用户直聊与派工同时到达 | 同 session 串行,忙碌行为明确 |
| A15 | A/B 同时运行,停止 A | B 继续;停止准确对应 A run |
| A16 | A 运行时切到 B,A 迟到回调 | A 结果只归 A,不改变 B 当前输入 |
| A17 | 刷新、关闭重开、重启宿主 | 绑定/配置/任务恢复,无重复派工 |
| A18 | 伪造其他项目 session/task/artifact/run ID | 服务侧拒绝并返回可辨错误 |
| A19 | B 尝试检索 A 材料/记忆 | 不自动进入 B 上下文 |
| A20 | 相同目录/父子目录/junction 指同一目标 | 冲突被识别并处理,不宣称完全隔离 |
| A21 | 两窗口同时改设置/消费队列 | CAS 和服务调度防覆盖、防重复 |
| A22 | 主责部门局部修改成果 | 保留来源/版本,仅改要求部分,无全链重跑 |
| A23 | 用户删除 session 或成果文件 | 显示失效,保留历史与明确恢复入口 |
| A24 | 2560×1440 浅/深色、拖动右栏 | 聊天优先、丞相居中、三省/六部连线正确 |
| A25 | 缩窄及约 390 CSS px 手机宽度 | 抽屉可用,无横向挤压,模型和任务可操作 |
| A26 | 切主题/项目/部门并恢复 | 草稿、绑定和配置保留,各归所属 |
| A27 | 键盘选卡片、模型按钮、分隔条、弹层 | 焦点明确、行为独立、关闭后焦点合理恢复 |
| A28 | 原生聊天审批、附件、流式回复 | 在工作台同页可用,不因嵌入绕过审批 |
测试层级:纯逻辑测状态转换/归属/幂等/上下文过滤;服务集成测事务/队列/恢复和宿主适配契约;真实宿主测 UI、实际模型、双项目、附件及权限。已有测试中有效的通用行为保留,侧栏专属与 Team 前提断言按新设计重写,不为绿色结果删除全部旧测试。
日志仅记录必要的 projectId/roleId/taskId/attemptId/dispatchId/sessionId/hostRunId、事件类型、耗时及错误码;错误中避免完整私聊、材料正文或凭据。每个失败应能从任务详情定位到关联记录。
## 13. 构建、安装与最终交付
执行者需先核实实际宿主加载的是哪个包/构建产物。当前 GUI 是 DSH 提供的页面;启动另一台开发服务器不能证明当前 GUI 已更新。若涉及客户端插件 HMR,只有同一实现 checkout 的相关 watcher 正在构建时才能承诺自动更新;其他修改按真实构建方式构建、刷新并验证。
不要修改源文件后直接报告“页面已更新”。交付说明列出宿主版本、插件版本、实际 URL、构建命令、产物路径、刷新/重启要求,以及在当前页面取得的截图。宿主扩展未安装时,明确哪些能力仍未验证。
软件包版本与新架构里程碑分开处理:先核对根包、面板包、策略常量及安装记录的现有差异,使用适合现有发布链的下一版本;未经决定不要把 0.9.2 降级到 0.1.0。文档可继续叫“新架构 v0.1”。
执行者最终提交:
1. 源码与明确 Git 提交/差异,列清保留的原有未提交改动。
2. 宿主能力记录:已验证接口、需要的宿主/插件扩展和版本。
3. 数据结构/迁移说明、内部契约、角色和权限配置说明。
4. 测试命令、结果、A01–A28 验收记录;未通过项不得写完成。
5. 真实浅色、深色、调宽、手机和双项目运行证据。
6. 用户使用说明:首次开始、切部门、改模型、派工、成果修改、未知状态恢复。
7. 已知限制与回退方法。Git 回退代码不自动回退业务数据;采用兼容 schema 或显式迁移策略,回退不删除 DSH 历史会话。
## 14. 可直接交给执行者的任务说明
> 请按本方案实现三省六部独立工作台新架构 v0.1。先检查 Git 现有改动及真实 DSH/项目树接口,输出能力证据,再按 P0–P6 推进。最终十席均须具有独立会话与项目内模型配置;先以丞相和工部验证真实交接闭环。左侧复用 better-workspace-group,中间嵌入真实会话,右侧做已确认部门树、模型设置、任务与工作成果;支持调宽、白蓝浅色和宿主深色、手机抽屉。项目 A/B 必须可同时运行且配置、上下文、任务、结果和取消严格隔离。程序负责可靠投递、回执、结构化结果和重启恢复,不用 Team 父子关系重建旧方案,不另建聊天数据库,不猜宿主 API。复杂自动审批/DAG 留到后续。接口缺失先提交最小适配证据和明确阻塞,不用假数据冒充集成完成。保护已有改动,使用 Git,不建备份副本。按照验收矩阵提供真实证据,未验证内容如实标注;涉及额外仓库写入、安装或发布时遵守对应授权边界。

View File

@ -0,0 +1,679 @@
# v0.1 宿主能力核实记录(P0 交付物)
> 本文是《[v0.1 实施方案](v0.1-实施方案.md)》§3「能力核实」的实做记录。原则:**只写读过的代码**,没有代码依据的一律标「未核实」,并写明是「需要动态验证」还是「代码里没有」。
>
> 阅读本文前请先知道一件事:**本轮核实只做到「类型层」**。没有任何一条结论来自在真实 DSH 里跑一遍(见 §0.3)。
---
## 0. 核实环境与方法
### 0.1 版本
| 项 | 值 |
| --- | --- |
| DSH 宿主包版本 | **0.2.0-rc.1**(`node_modules/@deepseek-ai/*` 全员 0.2.0-rc.1) |
| 类型定义来源 | `C:\Users\qyh15\Documents\dsh-workspaces-goups-new\dsh-workspace-groups\node_modules\@deepseek-ai\` |
| 本插件版本 | `dsh-sansheng-liubu-mode` **0.9.2**(`package.json`),面板子包 `dsh-sansheng-liubu-panel` 0.9.2 |
| 旧客户端参考 | [panel/lib/client.js](../panel/lib/client.js)(2107 行,仓库内唯一在真实宿主里跑过的客户端代码) |
| 宿主 Web GUI | `http://127.0.0.1:8457` |
| 系统 | Windows |
### 0.2 方法
1. 通读 `docs/v0.1-实施方案.md` 全文,抽出 §3 要求核实的 12 项与 §4/§6/§8 的接口需求。
2. 逐包读 `.d.ts`(签名)与 `lib/types/commands.js`、`agent.js` 等实现文件(语义),记录**文件路径 + 行号**。
3. 对照旧插件已跑通的调用点,标注哪些是「运行时已跑过」。
4. 读不到的包(如 `@deepseek-ai/dsh-client-ui-layout`)明确写「未核实」,不做推测性补全。
### 0.3 验证档位的定义(本文全篇使用)
| 档位 | 含义 |
| --- | --- |
| **类型层已核实** | 有 `.d.ts` 或实现源码为据,签名与语义可引用行号。(**允许据此写代码**) |
| **运行时已跑过** | 旧插件在真实宿主里实际调用过并通过(有代码调用点为据;本轮多数只能间接证明)。 |
| **未验证** | 分两种:**需动态验证**(类型存在,但行为/边界要靠实测确认);**代码里没有**(读遍本机宿主包找不到该能力)。 |
### 0.4 本轮**没有**做的事(重要)
- **没有**在真实宿主里做 P0 最小验证(§3 要求的「最小验证」全部待做)。
- **没有**运行任何 Host 侧 RPC,也没有在浏览器里打开插槽快照。
- 旧插件的 `panel/test/client.test.js` 本轮用仓库自带 node 跑过一遍:44 项全过(`node --test --test-isolation=none panel/test/client.test.js`)——但这是**对 mock 上下文**的单测,**不构成宿主兼容性证据**。
- 结论:**当前所有能力最多只能给到「类型层已核实」**。§12 验收矩阵里的真实宿主证据仍需按 §0.5 的核对清单去取。
### 0.5 拿到「运行时已跑过」的最小动作(P0 收尾 TODO)
| 目标 | 具体动作 |
| --- | --- |
| 槽归属 | 浏览器控制台执行 `ctx.slots.snapshot()`(`SlotRegistry.snapshot`,registry.d.ts:180),导出 `main` / `main.conversation` / `sidebar.workspaces` 三个节点的 `occupants`(谁注册、priority) |
| 会话创建幂等 | 对同一 `sessionId` 连调两次 `sessionController.create({sessionId, cwd})`,第二次应返回同一 id 且不新建;再换 cwd 调一次,应抛 `session/conflict` |
| prompt 幂等 | 同一 `requestId` 连发两次,第二次应立即 `{accepted:true}` 且日志里只有一条 `user/message` |
| cancel 真语义 | 发一条长任务 → `cancel()` → 观察 `running` 何时变 false、inbox 里排队的消息是否仍在 |
| 归档拒绝 | 会话 running 时 `archiveSession` 应抛 `workspace/session-active` |
| 断线重连 | 拔网/重启宿主,观察客户端 follow 流是否自愈、`sessionListMetadata` 是否重建 |
---
## 1. 速查总表
| # | 能力 | 档位 | 一句话结论 |
| --- | --- | --- | --- |
| 1 | 会话创建(显式 sessionId 幂等 adopt) | 类型层已核实 | 只有显式给 `sessionId` 才有幂等语义;cwd/preset 冲突抛错,不会静默合并 |
| 2 | 投递 prompt(requestId / queue / steer) | 类型层已核实 | `requestId` 幂等真实存在;`mode` 语义明确;客户端 `prompt()` 默认不带 requestId,必须自己传 |
| 3 | 取消 | 类型层已核实 | 同步返回、只对 attached agent 有效、保留 inbox;`accepted:true` ≠ 已取消 |
| 4 | 模型目录与选择 | 类型层已核实 | `modelCatalog` 有;`selectModel` **会连带改全局默认**,必须插件侧覆写 |
| 5 | 会话列表与投影 | 类型层已核实 | list 不用 resume agent;投影键名固定三个 |
| 6 | follow 事件流 | 类型层已核实 | 快照 + 无缺口事件帧;断线重连由客户端 session 层负责(细节未验证) |
| 7 | Workspace 列表与视图 | 类型层已核实 | `WorkspaceView` 有 canonical path + sessionIds;host id 不复用 |
| 8 | 项目树槽位归属 | 类型层已核实(归属)/ 未验证(实际占位) | `sidebar.workspaces` 是 single/root,由 ui-workspace 声明、workspace-groups 插件以 priority -1 shadow |
| 9 | 中央主区槽位归属 | **未核实** | `main` 槽的 SlotMap 声明在 `dsh-client-ui-layout`,本机没有该包 |
| 10 | `'conversation.content'` 工厂可复用性 | 类型层已核实 | 是 SlotFactory,可被再次实例化;但嵌套实例的 scope/绑定行为未验证 |
| 11 | slot register / registerFactory / renderFactorySlot | 类型层已核实(语义)/ 未验证(冲突抛错实测) | priority 最低者胜;同 cell 同 priority 注册**抛错**;`root` 槽禁止注册 |
| 12 | 插件 client 注入声明 | 类型层已核实 | 两种 inject 并存且含义不同:`package.json dsh.client.inject` 填包名,`exports.inject` 填服务短名 |
---
## 2. 会话与投递能力
### 2.1 会话创建(含显式 sessionId 幂等 adopt)
**签名(Host 侧)**
```ts
// node_modules/@deepseek-ai/dsh-api-session-controller/lib/types/index.d.ts:93
create(request: SessionCreateRequest): Promise<SessionCreateValue>;
```
```ts
// lib/types/types.d.ts:279-289
interface SessionCreateRequest {
workspaceId?: WorkspaceId;
cwd?: string;
sessionId?: SessionId;
agentPreset?: string;
}
interface SessionCreateValue {
sessionId: SessionId;
agentPreset?: string;
}
```
**实现语义**(`lib/types/commands.js`)
| 行为 | 证据 |
| --- | --- |
| `workspaceId` 与 `cwd` 同时给 → 抛 `gateway/bad-request`("session.create accepts workspaceId or cwd, not both") | commands.js:107-110 |
| 未给 `sessionId` 时由宿主随机生成:`request.sessionId ?? brandString(\`session-${randomUUID()}\`)` | commands.js:111 |
| 给 `workspaceId` 但查不到 → 抛 `workspace/not-found` | commands.js:113-120 |
| 解析 cwd:`workspace?.path ?? request.cwd ?? defaultCwd`,并在调用前 `mkdir(cwd, {recursive:true})` | commands.js:121-124;agent.js:475 |
| **只有显式传了 `sessionId` 才做 adopt 校验**:`ensureSession(sessionId, cwd, request.sessionId !== undefined, agentPreset)` | commands.js:124 |
| adopt 校验:cwd 不同 → `ApiSessionCwdConflict` → `session/conflict`;preset 不同 → `ApiSessionPresetConflict` → `agent-preset/conflict` | agent.js:470-474 |
| adopt 命中(同 cwd 同 preset)→ 直接返回同一个 sessionId,不新建 | agent.js:454-512 |
| session 建成后 `workspace.attachSession(sessionId)`,失败抛 `session/workspace-attach-failed`——**此时 session 已创建**,调用方必须能对账 | commands.js:129-136 |
| JSDoc 原文:"Create or idempotently adopt one ordinary Session" | index.d.ts:88-93 |
**我们的用法**:`ProjectService` 用 `projectId + roleId` 生成或查出稳定 `sessionId`(形如 `session-sansheng-<projectHash>-<roleId>`),带 `cwd = workspace.path` 与 `agentPreset` 调 `create`。同一请求重放是安全的(幂等 adopt);cwd/preset 不一致时报错,由 Reconciler 处理而不是自动重建。
**档位**:**类型层已核实**。幂等仅来自「显式 sessionId + cwd/preset 一致」,`creationRequestId` **不参与** create 的幂等(`SessionCreateRequest` 里没有这个字段,types.d.ts:279-284)。
**未验证**:真实宿主上第二次同参 create 是否真的返回同 id(需动态验证)。
**客户端等价物**(`ctx.sessions`,浏览器侧)
```ts
// lib/types/client/contract/sessions.d.ts:80-84
create(opts?: { workspaceId?: WorkspaceId; cwd?: string; sessionId?: SessionId }): Promise<SessionId>;
```
```ts
// lib/types/client/contract/sessions.d.ts:54-63
class SessionCreateError extends Error {
rpcError: RemoteFailure;
requestedSessionId?: SessionId;
name = 'SessionCreateError';
}
```
`requestedSessionId` 让「创建失败但宿主可能已经建了」变成可对账状态——这正是实施方案 §6.5 要的「按 requestId 查回」的现有替代物。**档位:类型层已核实;未验证(需动态验证宿主是否真的回填该字段)**。
---
### 2.2 投递 prompt(requestId、mode queue/steer)
**签名(Host 侧)**
```ts
// lib/types/index.d.ts:163
prompt(request: SessionPromptRequest, signal: AbortSignal): Promise<SessionPromptValue>;
```
```ts
// lib/types/types.d.ts:319-331
interface SessionPromptRequest {
requestId: SessionRequestId;
sessionId: SessionId;
mode: 'queue' | 'steer';
content: readonly PromptContentPart[];
clientTimeZone?: string;
}
type PromptContentPart =
| { type: 'text'; text: string }
| { type: 'image'; mediaType: string; data: string; name?: string }
| { type: 'file'; receiptId: string };
interface SessionPromptValue { accepted: true }
// :78-89, :329-331
```
**requestId 幂等是真的**(`lib/types/commands.js:290-352`):
- `if (hasPromptRequest(agent, request.requestId)) return { accepted: true }`(:301-302)——**重复投递直接吞掉,不报错**。
- `hasPromptRequest` 扫 `inbox.nextTurn` / `inbox.nextStep`,以及 `session.snapshotEvents()` 里 `user/message` 的 `source.rpcId`(:547-561)。这意味着**跨重启也幂等**(历史事件里留了 rpcId)。
- 空内容 → `gateway/bad-request`;`clientTimeZone` 非法 → `session/invalid-time-zone`。
- `mode === 'steer'` 走 `agent.steer(message)`,否则 `agent.followup(message)`(:327-330)。
- 其它异常统一折叠为 `session/agent-busy { reason }`(:347)——**错误码粒度很粗,不能靠它区分具体原因**。
**客户端签名(浏览器侧)**
```ts
// lib/types/client/contract/session.d.ts:82-84
prompt(content: PromptContentPart[], mode: 'queue' | 'steer', signal?: AbortSignal, requestId?: SessionRequestId)
: Promise<RemoteResult<{ accepted: true }>>;
```
注意 **`requestId` 是第 4 个可选参数**——旧插件 `panel/lib/client.js:1148-1165` 的 `deliverPrompt` 只传了前两个参数,**没有 requestId**,所以旧插件路径不具备幂等性。v0.1 必须显式传。
**`RemoteResult` 的形状**(`@deepseek-ai/dsh-typert-protocol/lib/types/types.d.ts:67-73`):
```ts
type RemoteResult<T> = { ok: true; value: T } | { ok: false; error: RemoteFailure };
```
**我们的用法**:`DispatchService` 每条派工生成一个 `requestId`(与 `dispatchId` 一一对应并落库),投递失败重试用同一个 `requestId`。`mode` 首版固定 `'queue'`;`'steer'` 只在确认宿主行为后启用。
**档位**:**类型层已核实**(Host 幂等)/**运行时已跑过**(旧插件确实用 `binding.session.prompt([...], "queue")` 成功投递,未带 requestId)。
**未验证**:客户端第 4 参数 `requestId` 是否被正确透传到 Host(需动态验证)。
**客户端补充**:`beginSubmission(input): SubmissionHandle`(session.d.ts:73)返回 `{ requestId, abandon() }`,是官方的「先登记 echo 再发」路径;`SubmissionHandle.requestId` 的类型注释明确「pass it to prompt」。
---
### 2.3 取消
```ts
// lib/types/index.d.ts:181 (注意:同步返回,不是 Promise)
cancel(request: SessionCancelRequest): SessionCancelValue;
// lib/types/types.d.ts:353-359
interface SessionCancelRequest { sessionId: SessionId }
interface SessionCancelValue { accepted: true }
```
实现(`lib/types/commands.js:468-478`):
- **只对已 attach 的 live agent 生效**,否则抛 `session/not-found`("session ... not found (not attached)")。
- 调用 `agent.cancel({ kind: 'user' }, { keepInbox: true })`——**保留 inbox**,排队消息不会被清掉。
- JSDoc(index.d.ts:177-181):"Cancel one active Agent turn **without dropping its pending inbox** ... acknowledgement that cancellation was **requested**"。
客户端等价物:`ISession.cancel(): Promise<RemoteResult<{accepted:true}>>`(session.d.ts:108-110)。JSDoc 补一句关键语义:**"Pending queued work remains and resumes in FIFO order after the Host reaches cancellation quiescence"**——即取消后排队任务会**继续跑**。
**我们的用法**:`Attempt` 状态机保留 `cancel_requested` 与 `cancelled` 两个态(正好对应实施方案 §8);`cancel()` 返回只推进到 `cancel_requested`,终态必须靠 `follow` 事件或 `running` 投影落到 false 才能确认。
**档位**:**类型层已核实**。**未验证**:真实宿主上从 `cancel()` 到 `running=false` 的时延与事件序列(需动态验证)。
---
## 3. 模型能力
### 3.1 模型目录
```ts
// lib/types/index.d.ts:109
modelCatalog(): Promise<ModelCatalog>;
// lib/types/types.d.ts:141-147
interface ModelCatalog {
default: ModelSelection;
routableProviders: readonly string[];
groups: readonly ModelProviderGroup[];
failures: readonly ModelCatalogFailure[];
}
interface ModelCatalogModel { // :110-127
id: string; name: string; description?: string;
reasoning?: { efforts: readonly { id: string; name: string; description?: string }[]; defaultEffort?: string };
}
interface ModelProviderGroup { id: string; name: string; models: readonly ModelCatalogModel[] } // :129-133
interface ModelCatalogFailure { id: string; name: string; message: string } // :135-139
```
**要点**:
- `reasoning.efforts` 是**每个模型自己的枚举**,`defaultEffort` 可能不存在 → 实施方案 §6「不支持旧 effort 不透传非法枚举」有直接依据。
- `failures` 是**隔离的 provider 失败**,不是整体失败——UI 应当「部分可用」而不是一有 failure 就整页报错。
- Host JSDoc:"Describe every currently routable model"(index.d.ts:105-109)。
- **客户端侧没有 `modelCatalog`**:`ISessions` / `ISession`(client/contract/*.d.ts)里搜不到该名字。旧插件只能走 `ctx.modelDirectories`(一个非本仓库的第三方服务)或 `ctx.remote.session.selectModel`。→ **v0.1 的模型目录必须从 Host 侧取**。
**档位**:**类型层已核实**(Host 签名与形状)。**未验证**:真实宿主返回的 efforts 枚举内容(需动态验证)。
### 3.2 模型选择
```ts
// lib/types/index.d.ts:99
selectModel(request: SessionSelectModelRequest): Promise<SessionSelectModelValue>;
// lib/types/types.d.ts:91-95, :291-297
interface ModelSelection { provider: string; model: string; reasoningEffort?: string }
interface SessionSelectModelRequest extends ModelSelection { sessionId: SessionId }
interface SessionSelectModelValue { selected: ModelSelection }
```
实现(`lib/types/commands.js:145-175`):
1. 先 `resolveAgent`(**会 resume 会话**);
2. 模型不在目录里 → 抛 `session/model-unavailable { provider, model }`;
3. `llm.resolveCallConfig` 归一化(这让返回的 `selected` 可能与请求不同,例如补默认 effort);
4. `agents.selectForNextRequest(selected)`;
5. **后台** `agentDefaultModel.saveSelection(selected)` —— **会把这个选择写成全局默认**,失败只 warn。
JSDoc(index.d.ts:94-99):"Select one Session-local model after explicitly resuming the Session; **save the default in the background**"。
> **这是 v0.1 最容易踩的坑**:`selectModel` 不是「只改这个会话」,它顺带改全局默认。所以「本项目本部门固定模型」必须由插件在**每次派发前**显式 `selectModel` 覆写,并自己持久化 desired 配置;不能指望宿主记住。
相关投影:
```ts
// lib/types/types.d.ts:104-109
interface ModelSelectionProjection { lastUsed: ModelSelection | null; next: ModelSelection | null }
```
投影键名固定三个(`lib/types/types.d.ts:11-27`):`sessionListMetadata`、`imageLimits`、`modelSelection`。这正是实施方案 §6「UI 分别显示『本次运行使用』和『下次运行使用』」的现成数据源(`lastUsed` / `next`)。
**档位**:**类型层已核实**。
**运行时已跑过(间接)**:旧插件 `panel/lib/client.js:1534-1560` 走 `remote.session.selectModel({sessionId, provider, model, reasoningEffort?})` 返回 `{ok, error:{code,message}}`,说明该 RPC 在真实宿主里存在且可调。
---
## 4. 会话列表、投影与事件流
### 4.1 列表
```ts
// lib/types/index.d.ts:80
list(_request: SessionListRequest, signal: AbortSignal): Promise<SessionListValue>;
// lib/types/types.d.ts:159-170
interface SessionSummary {
agentAvailable: boolean; sessionId: SessionId; updatedAt: number; running: boolean; blank: boolean;
parentSessionId?: SessionId; origin?: 'subagent'; cwd?: string; projections?: SessionProjectionHints;
}
```
- Host JSDoc:**"without resuming an Agent ... ordered by activity"**(index.d.ts:75-80)——列会话不会把 agent 拉起来,可放心高频调用。
- `SessionProjectionHints { kind: 'cached'|'sequenced'; asOfSeq; values }`(:51-64):**行内投影是可能过期的 partial 视图**,不能当权威值。
客户端:`SessionListState { ids; byId; phase; projectionsBySession }`(client/service.d.ts:43-52),旧插件就是读 `sessions.list.getSnapshot()` 的 `{ids, byId}`(client.js:635-760、1813)。
**档位**:**类型层已核实**+**运行时已跑过**(旧插件读列表快照驱动面板)。
### 4.2 投影
```ts
// lib/types/index.d.ts:203
projections(request: SessionProjectionsRequest, signal: AbortSignal): Promise<SessionProjectionsValue>;
```
JSDoc:"Read all registered projections **without activating an Agent** ... **null when the Session does not exist**"(index.d.ts:198-203)。
客户端:`ISessions.refreshProjections(sessionId): Promise<void>`(sessions.d.ts:92 附近)与 `ISession.projections.faceOf(key): ObservableSnapshot<unknown>`(session.d.ts:55)。
> `faceOf(key: string)` 的参数是**裸 string**,不是联合类型——拼错键名不会有编译错误,只会拿到 `undefined` 快照。v0.1 应把这几个键名收敛成常量。
**档位**:**类型层已核实**。**未验证**:真实宿主上 cold session 的 projections 是否真返回 null vs 空对象(需动态验证)。
### 4.3 follow 事件流
```ts
// lib/types/index.d.ts:196
follow(request: SessionFollowRequest, signal: AbortSignal): AsyncIterable<SessionFollowFrame>;
// lib/types/types.d.ts:459-463, :516-527
interface SessionFollowRequest extends Pick<SessionPageRequest, 'maxMessages' | 'turnWindow'> {
address: SessionAddress; assistantStream?: true;
}
type SessionFollowFrame =
| { type: 'snapshot'; header: SessionWireHeader; cursor: number; records; hasMore: boolean;
projections: SessionProjectionBaseline; assistantStream?: ... }
| { type: 'event'; event: SessionWireEvent }
| { type: 'assistant-stream'; frame: ... };
```
Host JSDoc(index.d.ts:190-196):"complete opening snapshot followed by **gap-free durable event frames** and optional cursorless assistant-stream frames"。
- 首帧必然是 `snapshot`(带 `cursor` 与 `projections` 基线),后续是 `event`;**assistant-stream 帧是无游标的**(不可作为状态依据)。
- `SessionAddress` 支持子会话:`{kind:'subagent'; parentSessionId; childSessionId; mode:'one-shot'|'continuable'|'unknown'}`(:386-394)。v0.1 十席走**普通会话**(`{kind:'session'}`),不用 subagent 地址,这是与旧方案的关键区别。
**断线重连**(未验证的主要部分):客户端 session 层是"reconnecting"设计——
- `lib/types/client/index.d.ts:35`:"Install Client Session state and its **reconnecting** control stream";
- `sessions/manager.d.ts:258-263` `handleConnected()`:"Repair one re-established Host-event generation with queryable baselines ... Opened Session follow streams resume independently through API Gateway";
- `transport.d.ts` 有 `carrierFailed?: (error: RemoteStreamCarrierError) => void` 钩子(可重试断流)与 `failed`(终态失败)。
**档位**:**类型层已核实**(帧结构与"gap-free"承诺)。
**未验证**:断线后事件是否真的零丢失、重连窗口多长、`cursor` 从哪一层续(**需动态验证**——这是 P0 必测项之一,直接决定 `Reconciler` 要不要做全量对账)。
---
## 5. Workspace 能力
```ts
// node_modules/@deepseek-ai/dsh-api-workspace-controller/lib/types/types.d.ts:13-25
interface WorkspaceView {
workspaceId: WorkspaceId;
path: string; // canonical
title: string;
sessionIds: readonly SessionId[];
createdAt: string;
updatedAt: string;
}
// lib/types/client/model.d.ts:9-18
interface WorkspaceSnapshot {
items: readonly WorkspaceView[];
archivedSessionIds: ...; pinnedSessionIds: ...;
state: 'idle' | 'loading' | 'error';
phase: 'pending' | 'ready';
error: RemoteFailure | null;
}
```
Host 方法(`lib/types/index.d.ts`):`create(request)` :42("Create or **idempotently resolve** one Workspace over an existing directory")、`initializeDefault(signal)` :51、`rename` :57、`delete` :63("Remove one Workspace **registration** while retaining files and Sessions")、`insertBefore` :69、`insertSessionBefore` :75、`archiveSession(request)` :81、`unarchiveSession` :87、`pinSession` :93、`unpinSession` :99、`follow(signal)` :105。
客户端:`ctx.workspaces: IWorkspaces`(`lib/types/client/index.d.ts:16-20`),`list: WorkspaceSource`(`getSnapshot()` / `subscribe()`),`archiveSession(sessionId, options?: { stopActivity?: boolean })`(client/service.d.ts:80-82)。
**关键限制**:
| 限制 | 证据 |
| --- | --- |
| **有运行中工作时拒绝归档**,抛 `workspace/session-active { sessionId, activity }`,除非 `stopActivity: true` | types.d.ts:36-44;commands.js:120-127 |
| 归档**不能当 stop 用**:`stopActivity: true` 才会顺带停 | 同上 |
| workspace id **永不复用**(延迟数据不会复活已删行) | client/model.d.ts:55 |
| `delete` 只删注册,**不删文件、不删会话** | index.d.ts:63 |
**我们的用法**:`WorkspaceAdapter` 只做「读 → 投影」,**不让插件去创建/删除 workspace**(那是 workspace-groups 插件的领地,见 §6.1)。项目 `projectId` 由插件生成并绑定 `hostWorkspaceId`;宿主 workspace 的 `path` 作 canonical 键,**绝不用目录名/树行号/显示名做主键**(实施方案 §3 要求)。
**档位**:**类型层已核实**。**未验证**:归档被拒时 `activity` 数组的具体内容(需动态验证)。
---
## 6. 槽位(Slot)能力
### 6.1 项目树槽位归属:`sidebar.workspaces`
```ts
// node_modules/@deepseek-ai/dsh-client-ui-sidebar/lib/types/client/contract/slots.d.ts:57-61
'sidebar.workspaces': { kind: 'single'; scope: 'root'; owner: SidebarSectionOwnerProps };
// :54-55 JSDoc: "Declared by this package's 'sidebar' entry (declaring is claiming);
// ui-workspace registers the browser."
```
- 该槽是 **single / root**,`owner` 为 `SidebarSectionOwnerProps { wide: boolean; expandSidebar: () => void }`(:113-118)。
- ui-sidebar 声明它(声明即占用),ui-workspace 往里注册 `WorkspaceBrowser`(整个浏览区域,见 ui-workspace `contract/slots.d.ts` 头部注释 1-40 行)。
- **workspace-groups 插件(better 工作组)以 `priority: -1` shadow 官方浏览器**——旧仓库文档 `DEVELOPMENT.md`(dsh-workspace-groups)第 17 行原文:"客户端入口:向 `sidebar.workspaces` 槽注册(priority -1,shadow 官方浏览器)"。
**结论**:v0.1 左栏**不需要、也不应该**再往 `sidebar.workspaces` 注册;直接复用 workspace-groups 已占据的那棵树。若将来要改树的行内容,正确入口是它声明的子槽(`sidebar.workspaces.session.menu.item`、`sidebar.workspaces.session.row.action`、`sidebar.session.row.leading/hover`,见 ui-workspace `contract/slots.d.ts:122-191`),这些是 **list** 槽,additive、按 `order` 插队。
**档位**:归属 = **类型层已核实**;「priority -1 真的胜出」= **运行时已跑过**(workspace-groups 是在跑的插件,其 DEVELOPMENT.md 明示该策略)但**本机未实测**其 occupancy。
**未核实**:workspace-groups 当前版本的 priority 是否仍为 -1(该仓库 0.1.2 后可能改过)——需看它 `src/client/index.ts` 或 `ctx.slots.snapshot()`。
### 6.2 中央主区槽位归属:`main` / `main.conversation`
**`main.conversation`**(已核实):
```ts
// node_modules/@deepseek-ai/dsh-client-ui-conversation/lib/types/client/contract/slots.d.ts:122-125
'main.conversation': { kind: 'single'; scope: 'session-maybe' };
// JSDoc: "Conversation shell beneath its root-scoped main-panel entry"
```
**`main`**(**未核实**):
- 该槽的 `SlotMap` 声明来自 `MainPanelId`(`@deepseek-ai/dsh-client-ui-layout/client`,被 ui-sidebar 在 `contract/slots.d.ts:14` 引用)。
- **本机没有 `@deepseek-ai/dsh-client-ui-layout` 包**(两份 `node_modules` 与全盘 `find` 均未命中)→ **无法读到 `main` 的 SlotMap 声明、kind、owner 类型**。
- 间接证据:`SidebarPanelMetadata { id: MainPanelId; order: number; label: string }`,JSDoc "List id and **matching main panel key**"(ui-sidebar slots.d.ts:101-108)→ `sidebar.panellist` 的 list `id` 就是 `main` 槽的 keyed `key`。旧插件正是这样用的(`panel/lib/client.js:2023-2027`,`key: PANEL_ID`)。
- 旧插件还依赖一个**未在类型里出现**的 `layout` 服务:`ctx.get("layout")` 回退 `ctx.layout`,再调 `selectPanel(panelId | null)`(client.js:1100-1108、1411-1415)。**这是运行时探测出来的**,没有 `.d.ts` 依据,v0.1 不应把它当公共 API。
**档位**:`main.conversation` = **类型层已核实**;`main` = **未核实(代码里没有:本机缺包)**。
**未验证**:`main` 是否 keyed、key 空间是否等于 MainPanelId、`selectPanel(null)` 回默认面板的行为(**需动态验证**)。
### 6.3 `'conversation.content'` 工厂可复用性
```ts
// ui-conversation contract/slots.d.ts:282-326
declare module '...ui-slots' {
interface SlotFactoryMap {
'conversation.content': {
scope: 'session-maybe';
props: ConversationContentInputProps;
children: {
'conversation.session': { kind: 'single'; scope: 'session' };
'conversation.composer': { kind: 'chain'; scope: 'session' };
'conversation.composer.bar': { kind: 'single'; scope: 'session-maybe' };
'conversation.input.dock': { kind: 'list'; scope: 'session' };
'conversation.hero.brand.mark': { kind: 'single'; scope: 'root' };
'conversation.hero.workspace': { kind: 'single'; scope: 'root' };
'conversation.hero.agentPreset': { kind: 'single'; scope: 'session-maybe' };
};
inject: ConversationInjected;
locale: 'conversation';
slots: { views: { scope: 'session' }; widthControls: { scope: 'root'; props: ... } };
};
}
}
// :509-513
interface ConversationContentInputProps { variant: 'main' | 'embedded'; phase: 'settling' | 'hero' | 'active'; hero: boolean }
```
JSDoc(:281):"**Reusable Conversation content instantiated by presentation hosts**"。
**含义**:这是 **SlotFactory**(不是普通 slot)——`registerFactory` 注册的是**定义**,`renderFactorySlot(name, props, options)` 实例化**occurrence**,每次 occurrence 独立(`store` 若为 factory 则每 occurrence 一份,见 ui-slots index.d.ts:505 附近注释)。
**可复用性结论**:
- ✅ **能**:任何拿到 `renderFactorySlot` 的组件都可以 `props.renderFactorySlot('conversation.content', { variant: 'embedded', phase: 'active', hero: false }, { fallback })` 渲染一份"真·原生对话"。
- ⚠️ **但**:`scope: 'session-maybe'` 说明它需要会话上下文。**在哪个 scope 下实例化、是否会自动获得 `SessionProvider`、与本项目 `sessionId` 如何对齐——本机类型只能证明这套 API 存在,不能证明"在右栏里嵌一个别的项目的会话"能工作**。→ **未验证(需动态验证)**。
- 实施方案 §4/§7 要求的「中间显示所选部门的真实会话」最稳的走法仍是:**让真会话占据 `main.conversation`**(宿主本来就这么渲染),插件只做「切换哪个 sessionId 被选中」,而不是自己再造一个 conversation。
**档位**:**类型层已核实**(声明完整可引用);**未验证**(嵌到非主区位置的可行性)。
### 6.4 slot register / registerFactory / renderFactorySlot 语义
```ts
// node_modules/@deepseek-ai/dsh-client-ui-slots/lib/types/index.d.ts
type SlotKind = 'single' | 'list' | 'keyed' | 'chain'; // :83
type SlotScope = 'root' | 'session-maybe' | 'session'; // :85
type SlotComponent<P> = (props: P) => ReactNode; // :343
```
**`register`**(两个重载,`SlotCore.register` @ :789-804;`SlotRegistry.register` 复用同一签名 @ registry.d.ts:85):
| 语义 | 证据 |
| --- | --- |
| 返回**幂等 disposer**;disposer 会**递归折叠**它声明的子槽 | :777-788 |
| 注册未声明的 slot → 抛错 | :789-804 及 load-time 校验段 |
| 同一 declarer 重复声明同一 child key → 抛错 | 同上 |
| 同一 store handle 跨不同 scope 挂载 → 抛错 | 同上 |
| keyed 缺 `key` / list 缺 `id` / chain 缺 `select` → 各自抛错 | 同上 |
| **shadowing**:同 cell(single=整槽、keyed=同 key、list=同 id)按 `priority` **升序**共存,最低者渲染;ties 保留注册顺序 | :769-776 |
| **在已占用 cell 的同 priority 再注册 → 抛错并点名 occupant** | :769-776;`KindOptions` 注释复述 "same key/id/cell + same priority throws" @ :560-584 |
| 声明了 `children` 就必须消费 `renderSlot`(或仅 chain 时 `renderSlotChain`),否则**编译期**报 `'children declared but the component consumes no renderSlot'` | `RendersCheck` :591-596 |
**`registerFactory`**:
```ts
// ui-slots index.d.ts:532-534
interface RegisterFactory {
<F>(options: RegisterFactoryOptions<F>, component: SlotComponent<FactoryComponentPropsOf<F>>): () => void;
}
// RegisterFactoryOptions @ :522-526
{ name: F; scope: FactoryDefOf<F>['scope'] } & children? & store? & inject? & locale? & slots?
```
有**类型级**碰撞检查:`FactoryCollisionCheck`(inject/input/local props 重叠 → 编译失败,:508-513)、`FactoryChildrenCheck`(子槽定义必须与 SlotMap 相符,:514-521)。
**`renderFactorySlot`**:
```ts
// ui-slots index.d.ts:395-404
type RenderFactorySlot = <F>(name: F, props: FactoryInputPropsOf<F>, options?: {
slots?: Partial<{ [N in local]: FactoryLocalComponent<F, N> }>;
fallback?: ReactNode;
}) => ReactNode;
interface PropsRenderFactories { renderFactorySlot: RenderFactorySlot }
```
"**每个 renderer 创建的组件都拿到 `renderFactorySlot`**"(原注释:Factory rendering capability supplied to **every** renderer-created Component)→ 插件组件里直接 `props.renderFactorySlot(...)` 即可,无需自己 import 任何东西。
相关但**禁止**的:`SlotRegistry.renderSlot(key, owner)` **运行时强制 `key === 'root'`**(registry.d.ts:150-158)。除 root 之外,任何槽都只能通过组件 props 的 `renderSlot` 渲染。
**`root` 槽禁止注册**——原注释(registry.d.ts:16-38)值得整段引用:
> "**DO NOT register here.** This is a single slot, so a second entry does not sit beside the frame — it shadows it, and a dynamically registered entry is assigned a lower priority than the shipped one, which makes it the winner: **the page would render your component alone, with every seat the frame declares gone.** For a surface of your own that floats over the whole app, register into `shell.overlay` instead (a list slot: additive, and click-through until your entry opts into pointer events)."
root 被 ui-layout 的 `AppFrame` 占据,AppFrame 在其内部声明 `sidebar` / `conversation` / `details` / `shell.overlay` 四个座位。
**`ctx.slots.inject(key, cb)`**(registry.d.ts:96-111)是**不依赖 apply 顺序**的正确姿势:槽已声明则同步跑 cb,否则等声明方 register 提交后跑;折叠时 dispose,再声明会重跑。旧插件全部用它(client.js:2006-2072),**这是对的,v0.1 继续用**。
**档位**:语义 = **类型层已核实**(文档注释极详细,逐条有行号)。
**运行时已跑过**:`register` + `inject` 组合(旧插件 5 处注册在真实宿主可用)。
**未验证**:priority 冲突抛错的**实测**表现(类型注释明说会抛,但没跑过);`registerFactory` 在本仓库跑过(旧插件没用到 factory)。
---
## 7. 插件客户端装载与注入
### 7.1 两种 inject,别混
| 声明位置 | 内容 | 语义 | 证据 |
| --- | --- | --- | --- |
| `package.json` → `dsh.client.inject` | **包名**(`@deepseek-ai/...`) | **informational**:只影响加载/预取顺序,**从不决定 apply 顺序** | ui-workspace `client/index.d.ts:24-31` 注释原文:"activation order ... is NOT constrained: `dsh.client.inject` edges are **informational (loading/prefetch metadata, never apply sequencing)**" |
| 客户端模块 → `exports.inject` | **cordis 服务短名**(`slots` / `sessions` / `uiWorkspace`…) | **强制**:apply 前这些服务必须就绪,缺了插件会被 **park**(不激活) | 旧插件 client.js:2073;client.js:1990 注释:"better-sidebar 是可选的,没装时不要写进 inject,否则插件会被 park" |
官方包的写法可对照(`package.json` 的 `dsh` 块):
```jsonc
// node_modules/@deepseek-ai/dsh-client-ui-workspace/package.json
"dsh": { "client": { "inject": ["@deepseek-ai/dsh-api-remotes", "@deepseek-ai/dsh-api-session-controller", ...], "platform": "web" } }
// node_modules/@deepseek-ai/dsh-client-ui-renderer/package.json
"dsh": { "client": { "platform": "web", "immediately": true } }
// node_modules/@deepseek-ai/dsh-api-session-controller/package.json
"dsh": { "client": { "external": ["@deepseek-ai/dsh-api-gateway/client"], "inject": [...], "platform": "web" } }
```
### 7.2 仓库现状
| 文件 | 现状 | 结论 |
| --- | --- | --- |
| `C:\Users\qyh15\三省六部\package.json` | `dsh` 块只有 `manifestVersion: 1` 与 `bundle.patch`,**没有 `client`** | 根包是「模式策略层」,不带客户端 |
| [panel/package.json](../panel/package.json) | **有** `dsh.client = { platform: "web", inject: [...] }`,含 `@deepseek-ai/dsh-client-ui-model-selection` 等 6 个包名 | 客户端在 panel 子包里 |
| [panel/cordis.patch.yml](../panel/cordis.patch.yml) | `insert: [{ id: sansheng-agent-panel, name: dsh-sansheng-liubu-panel }]` | 把 panel 作为一个 bundle 插进 cordis |
| [panel/lib/client.js](../panel/lib/client.js):2073 | `exports.inject = ["slots","sessions","uiWorkspace","uiConversation","modelDirectories","remote","remote.agentPresets","remote.session","remote.subagents","remote.commands","sidebarRightTabs","sidebarRight"]` | 短名服务列表 |
### 7.3 客户端 bundle 的加载契约
```js
// panel/lib/client.js:1-6
window.__ModuleLoader__.load({
id: "dsh-sansheng-liubu-panel",
factory: (require) => { /* ... */ return module.exports },
});
```
- `require` 只对**共享模块表**里的模块生效;表外的 `@deepseek-ai/*` 必须内联。
- 共享表(官方式)见 `C:\Users\qyh15\Documents\dsh-workspaces-goups-new\dsh-workspace-groups\tsdown.config.ts:48-64`:`react`、`react/jsx-runtime`、`react-dom`、`react-dom/client`、`@deepseek-ai/cordis`、`@deepseek-ai/dsh-client-ui-slots`、`@deepseek-ai/dsh-client-ui-primitives`、`@deepseek-ai/dsh-client-store`(旧名 `dsh-client-runtime/client` 兼容)。
- 该仓库的纯净门约束(`DEVELOPMENT.md` §4.1):"任何其它 `@deepseek-ai/*` 值导入都会让构建失败"。**类型导入(`import type`)会被擦除,不受限**。
**档位**:装载契约 = **运行时已跑过**(旧插件 bundle 在真实宿主加载成功);`dsh.client.inject` 是 informational = **类型层已核实**(官方包注释原文)。
**未验证**:`immediately` 字段对自己插件的影响(代码里只有 renderer 用,**需动态验证**)。
---
## 8. 已知限制与未验证点
### 8.1 明确不能用 / 不要做
| # | 限制 | 依据 |
| --- | --- | --- |
| L1 | **`root` 槽不能注册**:会 shadow AppFrame,导致整页只剩你的组件 | registry.d.ts:16-38 原文 |
| L2 | 除 `root` 外**不能用 `slots.renderSlot(key)`** 渲染,运行时强制 `key === 'root'` | registry.d.ts:150-158 |
| L3 | **同 cell 同 priority 注册会抛错**(single/同 key/同 id 均算),并点名 occupant | ui-slots :769-776 |
| L4 | `main` 槽的声明读不到(本机无 `dsh-client-ui-layout`),**不能假设**它 keyed 或 key 空间 | §6.2 |
| L5 | `selectModel` **会改全局默认** | commands.js:145-175 |
| L6 | `cancel` **不取消排队消息**,取消后 FIFO 继续 | commands.js:468-478;session.d.ts:104-110 |
| L7 | 有活动时 `archiveSession` 拒绝(`workspace/session-active`),`stopActivity:true` 才停 | types.d.ts:36-44 |
| L8 | `delete` workspace **不删会话、不删文件** | index.d.ts:63 |
| L9 | `projections.faceOf(key)` 的 key 是裸 string,拼错不报错 | session.d.ts:55 |
| L10 | 把可选插件(如 better-sidebar)写进 `exports.inject` 会让插件被 **park** | client.js:1990 注释 |
| L11 | 客户端 `prompt()` 的 `requestId` 是第 4 个可选参数,**不传就没有幂等**(旧插件就没传) | session.d.ts:82-84;client.js:1148-1165 |
### 8.2 未验证点(分级)
| # | 项 | 类型 | 要做什么 |
| --- | --- | --- | --- |
| U1 | `main` 槽 kind/owner/keyed 语义 | **代码里没有**(缺包) | 装 `dsh-client-ui-layout` 或读其源码;运行时 `ctx.slots.snapshot('main')` |
| U2 | 三处 slot 的**实际占位者**(谁 priority 多少) | 需动态验证 | `ctx.slots.snapshot()` 导出 |
| U3 | workspace-groups 当前是否仍 priority -1 shadow `sidebar.workspaces` | 需动态验证 | 看其 `src/client/index.ts` 或快照 |
| U4 | 显式 `sessionId` 二次 create 真返回同 id | 需动态验证 | 连调两次比对 |
| U5 | 客户端 `prompt` 第 4 参 requestId 是否透传到 Host | 需动态验证 | 同 requestId 发两次看事件数 |
| U6 | `cancel()` → `running=false` 的时延与事件序列 | 需动态验证 | 长任务实测 |
| U7 | **宿主重启后客户端重建**:插槽是否重新注册、apply 是否重跑、浏览器本地状态(旧插件用 localStorage)是否还在 | 需动态验证(**v0.1 关键**) | 重启 DSH,看插件是否 park、绑定是否丢 |
| U8 | **follow 事件流断线重连**:是否零丢失、cursor 续点在哪层 | 需动态验证(**v0.1 关键**) | 断网/重启期间制造事件,重连后核对 |
| U9 | `'conversation.content'` 在非主区位置实例化是否可用 | 需动态验证 | 先做个最小 occurrence |
| U10 | `SessionCreateError.requestedSessionId` 是否真被回填 | 需动态验证 | 制造一次创建失败 |
| U11 | `modelCatalog` 的 efforts 枚举实际内容、`failures` 触发条件 | 需动态验证 | 打真实宿主 |
| U12 | 归档被拒时 `activity` 数组的成员结构 | 需动态验证 | 运行中归档一次 |
| U13 | 两窗口同会话并发投递的行为(租约/互斥) | 需动态验证(实施方案 §8 故障矩阵要求) | 两窗口同时派工 |
| U14 | `dsh.client.immediately` 对本插件的影响 | 需动态验证 | 加字段对比加载时机 |
### 8.3 与实施方案 §3 十二项的对账
| §3 项 | 本文对应 | 当前档位 |
| --- | --- | --- |
| 主页面扩展 | §6.2、§6.4 | 部分未核实(`main` 缺包) |
| 项目树 | §6.1 | 归属已核实,优先级待验证 |
| 内嵌聊天 | §6.3 | 类型层已核实,嵌入可用性未验证 |
| 独立 session | §2.1 | 类型层已核实 |
| 消息投递 | §2.2 | 类型层已核实 |
| 运行关联(hostRunId、终态、取消、重启查询) | §2.2、§2.3、§4.3 | 取消与终态语义已核实;**重启查询未核实** |
| 模型目录 | §3.1、§3.2 | 类型层已核实(Host 侧) |
| 配置/工具权限 | — | **本文未覆盖**(属 index.js 宿主策略层,需另开一节核实 `evaluateToolPolicy` 的宿主约束) |
| 材料/记忆 | — | **本文未覆盖**(未查记忆注入路径) |
| 存储(原子/事务/版本/事件恢复) | — | **本文未覆盖**(§4.1 提到 Host 用 `folded prefix`,插件侧存储方案尚未定) |
| 主题/构建 | §7.3(构建) | 构建契约已核实;主题未核实 |
---
## 9. 对 v0.1 实现的影响
1. **会话创建一律显式传 `sessionId`,别靠 `startSession` + 轮询。** `create({sessionId, cwd, agentPreset})` 天然幂等 adopt,冲突会明确报 `session/conflict` / `agent-preset/conflict`;而旧插件的 `uiWorkspace.startSession()` + `waitNew(15×200ms)`(client.js:1646-1680)是靠"轮询列表找新 id"猜归属,正是实施方案 §6.5 明令禁止的做法。`sessionId` 由 `projectId + roleId` 稳定派生,落库后永不变。
2. **调度必须放 Host 侧,浏览器只订阅。** 依据有二:`sessionController`、`workspaceController` 都是 Host 服务(`TypertRemoteService`,index.d.ts:17-19/20-23),Host 侧能直接 `create`/`prompt`/`follow`/`control`,不需要浏览器在场;而客户端离开页面时 `SessionReference.release()` 会拆掉本地 scope(sessions.d.ts:22-30)。→ `DispatchService`/`Reconciler` 写在 `index.js`(Host apply)里,插件 client 只做 `WorkbenchView`。
3. **幂等键用 `requestId`(Host 侧真幂等),不要自造去重表。** `hasPromptRequest` 会扫 inbox 与历史 `user/message` 的 `rpcId`,**跨重启**仍然生效(commands.js:301-302、547-561)。本项目只需要保证「同一个 dispatch 重试时复用同一个 requestId」。注意走客户端 `binding.session.prompt(...)` 时必须补第 4 参,否则等于没有幂等。
4. **模型配置是"每次派发前覆写",不是"设一次就记住"。** `selectModel` 会后台 `saveSelection` 改全局默认。所以:读 `modelCatalog()` 校验 desired → 每次派发前显式 `selectModel` → 用返回值 `selected` 记成 `effectiveConfigSnapshot`(可能被归一化)→ 失败就明确报错,**不静默换模型**(对应实施方案 §6 三条要求)。UI 的"本次/下次"直接用 `modelSelection` 投影的 `lastUsed` / `next`。
5. **`cancel` 只能到 `cancel_requested`;`inbox` 不会被清。** 要真停,得先 `cancel` 再把排队项逐条 `updateQueue(itemId, {kind:'remove'})`(`QueueAction`,types.d.ts:149-157);而 `updateQueue` 在 `target === 'next-turn'` 且 agent 仍 `running` 时支持 steer,否则抛 `session/steer-unavailable`(commands.js:435-436)。Attempt 状态机的 `cancel_requested → cancelled` 必须由 follow 事件确认,不能凭 `accepted:true`。
6. **左栏不要再注册 `sidebar.workspaces`。** 它是 single/root,已由 ui-workspace 声明、workspace-groups 占据。需要行内动作时只往 `sidebar.workspaces.session.menu.item` / `sidebar.workspaces.session.row.action` 这类 **list** 槽插(additive、按 order),这样不会和别人的 priority 撞(同 cell 同 priority 会抛错)。
7. **中间对话让真会话占 `main.conversation`,不要自己造 conversation。** `'conversation.content'` 是工厂、确实可复用,但 `scope: 'session-maybe'` 的绑定行为本机无法核实。最稳的是沿用旧插件的做法:`ctx.uiWorkspace.openSession(sessionId)` 让原生会话占据主区(client.js:1441-1460),插件只决定"选中哪个 session";需要额外信息就在 `conversation.session.header.actions`(list,旧插件已用 order 40)等已有座位上加,而不是覆盖整块。
8. **P0 收尾必须补 §0.5 那六项动态验证,尤其是 U7(宿主重启)与 U8(断线重连)。** 实施方案 §8 的「重启对账」「重复事件」「两窗口租约」全都依赖这两个行为;如果实测发现 follow 不能零丢失,`Reconciler` 就必须从"增量补偿"升级为"定期全量对账 + 状态机兜底",这会显著改变 §4 的分层预算。在此之前,任何"已通过"的结论都应写成"类型层已核实"。
---
## 附:本文引用的文件清单
| 简称 | 绝对路径 |
| --- | --- |
| ui-slots | `...\@deepseek-ai\dsh-client-ui-slots\lib\types\index.d.ts` |
| ui-renderer | `...\@deepseek-ai\dsh-client-ui-renderer\lib\types\client\registry.d.ts` / `client\index.d.ts` |
| ui-conversation | `...\@deepseek-ai\dsh-client-ui-conversation\lib\types\client\contract\slots.d.ts` |
| ui-sidebar | `...\@deepseek-ai\dsh-client-ui-sidebar\lib\types\client\contract\slots.d.ts` |
| ui-workspace | `...\@deepseek-ai\dsh-client-ui-workspace\lib\types\client\contract\slots.d.ts` / `navigation.d.ts` / `index.d.ts` |
| session-controller | `...\@deepseek-ai\dsh-api-session-controller\lib\types\index.d.ts` / `types.d.ts` / `commands.js` / `agent.js` / `client\contract\*.d.ts` |
| workspace-controller | `...\@deepseek-ai\dsh-api-workspace-controller\lib\types\index.d.ts` / `types.d.ts` / `client\model.d.ts` / `client\service.d.ts` |
| typert-protocol | `...\.pnpm\@deepseek-ai+dsh-typert-pro_ced96565a0ecf302a2ee4e627ca2288b\node_modules\@deepseek-ai\dsh-typert-protocol\lib\types\types.d.ts`、`remote-error.d.ts` |
其中 `...` = `C:\Users\qyh15\Documents\dsh-workspaces-goups-new\dsh-workspace-groups\node_modules\@deepseek-ai`。

View File

@ -0,0 +1,222 @@
# 三省六部工作台 · 新架构 v0.1 · 接线与契约
本文记录 v0.1 已经落地的部分:**数据层、Host 服务层、HTTP 接口、宿主接线**。
它回答三个问题:装了什么、界面能用哪些接口、哪些地方还没验证。实施方案本身见
`docs/v0.1-实施方案.md`,宿主能力的原始取证见 `docs/v0.1-宿主能力记录.md`。
> 版本口径:包版本仍是 0.9.2,**不降级**;"v0.1" 指新架构的第一版,不是包版本号。
## 1. 分层与文件
```
DSH 宿主
└─ index.js 政策插件(prompt / 工具策略 / 模型路由)+ 工作台挂载
└─ workbench/host/… Host 服务:账本、派发、对账、HTTP
└─ workbench/core/… 纯逻辑:ID、编制、状态机、账本、任务判定
workbench/panel/… 浏览器端(右栏部门树 + 任务/成果)
```
### workbench/core —— 纯逻辑,零依赖,可单独测
| 文件 | 行数 | 职责 | 关键导出 |
| --- | --- | --- | --- |
| `workbench/core/ids.mjs` | 81 | 稳定随机 ID、前缀与归属校验 | `newId` / `createIdFactory` / `isIdOf` / `ID_PREFIXES` |
| `workbench/core/roles.mjs` | 192 | 十席编制、布局分组、派发许可 | `ROLE_IDS` / `ROLES` / `layoutGroups` / `canDispatch` / `initialSeats` |
| `workbench/core/states.mjs` | 138 | 四套状态机(部门/任务/派发/尝试) | `STATE_MACHINES` / `canTransition` / `isTerminal` / `assertTransition` |
| `workbench/core/store.mjs` | 1012 | 账本:单写者、事务提交、CAS、引用完整性 | `WorkbenchStore` / `defaultStorePath` / `StoreError` |
| `workbench/core/tasks.mjs` | 436 | 任务状态推进与完成判定 | `createTask` / `beginAttempt` / `decide` / `evaluateCompletion` |
**账本约束(store 强制,不靠调用方自觉)**
- 一个账本文件只有一个写者;`mutate()` 内所有变更同事务提交,失败整批回滚。
- `(projectId, roleId)` 绑定唯一;同一个 `sessionId` 不能同时绑两个部门/项目
(`SESSION_CONFLICT`,带 `heldBy:{projectId,roleId}`);换绑必须显式
`allowReplace`,且 `bindingGeneration` 每次换绑 +1。
- 跨项目引用一律拒绝(`CROSS_PROJECT`);实体的 `projectId` 不可改。
- 配置写入走 CAS:`saveConfig(projectId, roleId, desired, expectedRevision)`,
期望版本不符返回冲突,避免两个标签页互相覆盖。
- 事件日志是**只读游标**:按 `seq` 追加,`listPendingEvents` 过滤未投递未处理的,
`markEventDelivered` 只写 `deliveredAt` 不物理删除。同一 `since` 重放返回同一批事件。
### workbench/host —— 服务层
| 文件 | 行数 | 职责 |
| --- | --- | --- |
| `workbench/host/paths.mjs` | 118 | 侧车目录、原子写、损坏隔离 |
| `workbench/host/service.mjs` | 1293 | 业务服务:项目/席位/绑定/配置/任务/派发/成果,`ServiceError` 翻译,事件化 |
| `workbench/host/contract.mjs` | 144 | 内部契约行解析(四动作)与模板 |
| `workbench/host/session-adapter.mjs` | 282 | 会话适配:创建/查证/投递/取消/模型/摘要 |
| `workbench/host/dispatch-service.mjs` | 207 | 派发:prepared → sending → accepted/rejected/unknown |
| `workbench/host/reconciler.mjs` | 181 | 对账:运行状态与账本对账,超时/重启/取消收口 |
| `workbench/host/routes.mjs` | 414 | HTTP 路由(11 条) |
| `workbench/host/workbench-host.mjs` | 188 | 会话层外壳:会话、派发、对账、契约入库 |
| `workbench/host/index.mjs` | 188 | 唯一 Host 入口:账本 + 外壳 + 路由装配,供 `index.js` 调用 |
### 账本位置
`%DSH_HOME%/sansheng-liubu/workbench.json`(`DSH_HOME` 缺省为 `~/.dsh`;
测试或临时实例可用 `DSH_SANSHENG_WORKBENCH_FILE` 覆盖)。
损坏处理:读不出来就把文件改名成同目录的 `.corrupt-<时间戳>` 隔离,**再**退回内存账本,
并把原因记进 `warnings`;不会静默清空。
## 2. HTTP 接口
前缀 `/sansheng/workbench`,全部同源。响应外层统一:
```json
{ "ok": true, "value": { } }
{ "ok": false, "error": { "code": "INVALID_STATE", "message": "…", "details": { } } }
```
| 方法 | 路径 | 请求体 / 查询 | 说明 |
| --- | --- | --- | --- |
| GET | `/bootstrap` | `?projectId=` | 一次取全:`{projects, projectId, project, seats, layout, tasks, artifacts, results, eventSeq}` |
| POST | `/project` | `hostWorkspaceId`, `displayNameCache?`, `canonicalRoot?` | 登记主机工作区↔项目;重复登记返回既有项目,不重建席位 |
| POST | `/bind` | `projectId`, `roleId`, `sessionId`, `allowReplace?` | 把某个会话绑成某部门;换绑需 `allowReplace` |
| POST | `/config` | `projectId`, `roleId`, `provider`, `model`, `reasoningEffort?`, `expectedRevision?` | 部门模型,CAS 写入;只影响该项目该部门 |
| POST | `/task` | `projectId`, `title`, `objective?`, `acceptance?`, `constraints?`, `scope?`, `ownerRoleId?`, `sourceRoleId?`, `originMessageRef?`, `returnTarget?`, `status?` | 建任务;`status:'queued'` 要求主责部门已接通 |
| POST | `/task/cancel` | `projectId`, `taskId`, `reason?` | 取消任务(终态不可再改) |
| POST | `/connect` | `projectId`, `roleId`, `sessionId?`, `agentPreset?` | 由 Host 建/定位部门会话并绑定;宿主没有会话能力时返回 `INVALID_STATE` |
| POST | `/dispatch` | `projectId`, `taskId`, `idempotencyKey`, `sourceRoleId?`, `targetRoleId`, `targetSessionId?`, `bindingGeneration?`, `packet?`, `sourceSessionId?`, `mode?`, `roleName?` | 派发任务单;有会话层时真投递,没有就只落账 `prepared`(UI 必须显示尚未接通) |
| POST | `/ingest` | `projectId`, `roleId`, `text` | 解析 Agent 输出里的契约行并落账(四动作) |
| POST | `/result` | `projectId`, `taskId`, `attemptId?`, `report?`, `runTerminal?`, `artifactRefs?`, `checks?`, `remainingItems?`, `blockedReason?`, `sourceMessageRef?`, `reportVersion?` | 登记结构化报告 / 运行终态;重复登记按 `attemptId+reportVersion` 与 `sourceMessageRef` 去重 |
| POST | `/artifact` | `projectId`, `taskId`, `displayName`, `mediaType?`, `fileRef?`, `versionOrHash?`, `verification?`, `sourceResultId?`, `revisesArtifactId?` | 直接登记成果(契约行 `registerArtifact` 之外的入口);带 `revisesArtifactId` 时版本号自动 +1 |
| POST | `/artifact/revision` | `projectId`, `artifactId`, `instruction`, `ownerRoleId?`, `status?` | 找主责部门改一份成果:只开一条修订任务,不重跑全链 |
| GET | `/events` | `?projectId=&since=` | 长轮询(默认 25s,内部 1s 轮询账本)增量事件;`since` 之后的才算新 |
错误码:`INVALID_INPUT` / `INVALID_ROLE` / `NOT_FOUND` / `CROSS_PROJECT` /
`CONFIG_CONFLICT` / `SESSION_CONFLICT` / `DUPLICATE_PROJECT` / `INVALID_STATE` /
`DISPATCH_INVALID` / `ATTEMPT_MISMATCH` / `REPORT_INVALID` / `INTERNAL`。
## 3. 内部契约行(Agent 怎么"上报")
Agent 不靠聊天里的"已完成"三个字更新任务,而是输出一行以 `【三省六部】` 开头的 JSON:
```
【三省六部】{"action":"dispatchTask","targetRoleId":"gongbu","title":"…","objective":"…"}
【三省六部】{"action":"reportTaskResult","taskId":"tsk_…","summary":"…","checks":["…"],"artifactRefs":["art_…"]}
【三省六部】{"action":"requestTaskInput","taskId":"tsk_…","question":"…"}
【三省六部】{"action":"syncDecision","taskId":"tsk_…","decision":"approved"}
```
- 解析:`parseContractLines(text)` 逐行匹配,坏 JSON / 未知 action 进 `invalid`,**不抛**。
- 入库:`ingestAgentOutput({projectId, roleId, text})`,四条动作各自落账。
- 模板:`describeContract()` 生成给 Agent 看的说明(已注入部门 system prompt)。
## 4. 会话与派发
### 创建(幂等)
宿主 `sessionController.create({sessionId, workspaceId|cwd, agentPreset})`:
`sessionId` 是**唯一**的幂等来源(同 id 同 cwd 同 preset → 返回同会话;
cwd 不同 `session/conflict`;preset 不同 `agent-preset/conflict`)。
`SessionCreateRequest` 里没有 `creationRequestId` —— 实施方案里那一步在宿主不存在,
我们改成"先写账本再建会话,失败留恢复记录"。
### 投递
`prompt({requestId, sessionId, mode:'queue'|'steer', content:[{text}]})`,
`requestId` 用 `attempt.id`(客户端铸造):宿主按它去重,跨重启仍有效。
所有异常在宿主侧折叠成 `session/agent-busy`,因此**投递超时只能判 `unknown`**,
再由 `Reconciler.verifyUnknown` 查证后收口,不能直接判成功或失败。
### 取消
`cancel({sessionId})` 同步返回 `accepted:true`,但**只对已挂载的 agent 生效**、
`keepInbox:true`(排队消息会继续跑)。所以:
- 账本只推进到 `cancel_requested`;
- 要真停还得 `updateQueue({sessionId, itemId, action:'remove'})`;
- 对账看到"跑停了"才写 `cancelled`。
### 模型
- 客户端面没有 `modelCatalog()`,必须从 Host 取。
- `selectModel()` 会连带把选择存成全局默认,所以**每次派发前覆写**,
并把实际用的 provider/model/effort 记进 `effectiveConfigSnapshot`。
- 部门配置变更只改 `desired`(CAS),不动历史;运行中的请求保持原配置。
- 模型不支持旧的 reasoningEffort 时要求重选,不透传非法枚举,不静默回退。
## 5. 完成判定
宿主"运行正常结束"≠ 业务完成。`completed` 需要三件事同时成立:
1. 运行终态是成功(`runTerminal:'succeeded'`);
2. 有可信的结构化报告(`summary` + `checks`),且与任务验收项对得上;
3. 成果引用(`artifactRefs`)能查到实体。
只满足 1 → `needs_attention`(等人补报告);只满足 2、1 未到 → 先登记、候终态;
用户可以主动停 → 记 `cancelled`,不算"成功但没报告"。
## 6. 项目隔离
- 账本是**单一文件**,但所有实体都带 `projectId`,服务层每次读写都校验归属;
- 绑定表主键是 `(projectId, roleId)`,不同项目可以各有自己的工部会话;
- 会话在宿主侧是全局唯一的,所以"同一会话不能再绑别的部门/项目"由账本强制;
- 配置、任务、派发、成果、事件全部按项目分片;切项目必须整树重取,
不允许把上一个项目的 seats/tasks 混进来。
## 7. 宿主接线(index.js)
```js
import { createWorkbenchHost } from './workbench/host/index.mjs'
```
- `apply()` 里在建完政策之后 `acquireWorkbench(ctx, presetId, log)`;
返回的 disposer 末尾 `releaseWorkbench(entry)`。
- 按**账本路径**引用计数:同一份账本只有一个写者;`apply()` 被多个 agent 调用时
不会重复建 store,最后一个卸载时才 `dispose()`。
- 用 `ctx.root ?? ctx` 创建:工作台属于整个应用,不随单个 agent 销毁消失。
- 整体包 try/catch:工作台起不来只打日志,政策插件(prompt/工具策略)照常工作。
- 没有真实宿主服务(单测里的 mock ctx)时直接跳过,不写真实账本、不起计时器。
日志前缀 `[sansheng-liubu:workbench]`。
### 晚到的服务怎么办
`apply()` 跑的那一刻,宿主不保证 `webServer` 与 `sessionController` 都已经装好,
所以两样都按「先试一次、没到就等它到」处理:
| 依赖 | 当场没有时 | 补挂方式 | 补挂后 |
|---|---|---|---|
| `webServer` | 路由不注册,`warnings` 记一条 | `ctx.inject(['webServer'], …)` 再注册一次 | 13 条接口可用 |
| `sessionController` | 会话层为空,`hasSessions=false`,派发只落账 | `ctx.inject(['sessionController'], …)` → `shell.attachSessions(controller)` | 可以接通部门、真投递 |
两条补挂都**只做一次且幂等**:已经挂上就不再换(`attachSessions` 第二次调用返回 `true`
但保留原实例)。这样用户不必为了「接通部门」专门多重启一次 DSH。
派发钩子是恒挂的:`shell.hasSessions===true` 走真投递,否则退回 `service.dispatchTask`
只写 `prepared`——**任何时候都不会把「没接通」显示成「已发送」**。
`createWorkbenchHost(ctx, { store })` 支持注入账本(测试与嵌入场景):注入了就用它,
不碰磁盘、不做损坏隔离,避免单测写到 `%DSH_HOME%` 下的真账本。
## 8. 尚未验证 / 已知限制
来自 `docs/v0.1-宿主能力记录.md` §8.2,按影响排序:
| 编号 | 未验证项 | 影响 | 现在的处置 |
| --- | --- | --- | --- |
| U7 | 宿主重启后客户端会话重建 | 重启后账本里的 `targetSessionId` 是否还能打开 | `connectDepartment` 先 `inspectSession`,失效才重建 |
| U8 | `follow` 断线重连是否零丢失 | 对账能否只依赖事件流 | 对账**不**只靠 follow,另有定时 `reconcileOnce` |
| U4 | 二次 `create` 真返回同 id | 幂等是否成立 | 已按"显式 sessionId"实现,验证后无需改代码 |
| U5 | 客户端是否透传 `requestId` | 投递幂等 | 派发走 Host 侧 `sessionController.prompt`,不依赖客户端 |
| U9 | `conversation.content` 能否在非主区实例化 | 全页工作台中间栏 | 先走"主区接管 + 复用原生 `renderFactorySlot`"路线 |
| U1 | `main` 槽的 SlotMap 声明 | 老面板的 `main` 重定向桩 | 与 v0.1 无关,保持现状 |
限制:
- 账本单文件、单写者:同一个 `%DSH_HOME%` 下只能跑一个 DSH 实例写它
(双开会被"同一账本只有一个写者"挡住,而不是写坏)。
- 事件长轮询最长 25 秒,页面隐藏时暂停,恢复时按 `since` 续读,不重放已读。
- 成果只存引用与摘要,不存文件本体。
## 9. 验证
```bash
export PATH="/c/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/runtime/primary-runtime/dependencies/node/bin:$PATH"
node --test --test-isolation=none test/policy.test.js workbench/test/*.test.mjs panel/test/client.test.js
```
当前:**182 passed / 0 failed**(core 60、host 16、service 22、routes 29、policy 11、panel 44)。

134
docs/v0.1-验收记录.md Normal file
View File

@ -0,0 +1,134 @@
# 三省六部独立工作台 v0.1 · 验收记录
对应 `docs/v0.1-实施方案.md` 的 A01–A28 验收矩阵。**本文只记录跑过的东西**:
"已验"必须能指出具体测试名或具体产物;跑不了的写"待真机",不写"完成"。
- 记录时间:2026-11-10
- 代码位置:`C:\Users\qyh15\三省六部\workbench\`(`core/` 数据层、`host/` 宿主服务与路由、`panel/` 前端 bundle)
- 测试基线:`node --test --test-isolation=none test/policy.test.js workbench/test/*.test.mjs workbench/panel/test/client.test.mjs panel/test/client.test.js` → **200 tests / 200 pass / 0 fail**
测试命令(node 不在 PATH,必须先加运行时目录):
```bash
export PATH="/c/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/runtime/primary-runtime/dependencies/node/bin:$PATH"
node --test --test-isolation=none test/policy.test.js workbench/test/*.test.mjs workbench/panel/test/client.test.mjs panel/test/client.test.js
```
---
## 1. 逐项结论
状态口径:
- **已验(单测)**:有对应的自动化测试,跑得过。
- **已验(预览)**:有真 Chrome 渲染的产物(`docs/preview/`),但还没在真实 DSH 页面里跑过。
- **待真机**:逻辑在、测试覆盖不到,必须在重启后的 DSH 里点一遍。
- **未做**:本轮没实现。
| 项 | 判定标准 | 现状 | 证据 / 缺口 |
|---|---|---|---|
| A01 | 无普通聊天时打开上朝,不要求 Team | 待真机 | 前端 `main.conversation` 以 `priority:-1` 接管;需重启后确认独立进入 |
| A02 | 切 A/B、重命名/移动项目不换 session | 已验(单测) | `registerProject 同一工作区只建一个项目`;绑定只用 `hostWorkspaceId` 与 `bindingGeneration`,名称变更不触碰绑定 |
| A03 | 点分组节点不创建项目或十席会话 | 已验(单测) | `layoutGroups renders three tiers without inventing parent links`;`initial seats describe configuration rows without creating sessions` |
| A04 | 双击首次启动同部门只建一个 session | 已验(单测)+ 待真机 | `会话适配:缺 sessionId 时按 workspace 建会话且不重复建`;`绑定:同一会话被别处持有 → SESSION_CONFLICT`。真机二次点击要复验(U4) |
| A05 | 十席分别发短消息,输入/历史/实际 session 一致 | 已验(真实 bundle + 真实路由,伪宿主会话) | `--live` 模式把**真实 panel bundle** 打到**真实 Host 路由**上:新建任务存草稿 → 点「派工」→ `POST /dispatch` 200 且 `dispatch.status=accepted`,任务行变「工部 · 执行中」,伪 controller 收到 743 字符任务单(`docs/preview/v01-live-tasks-400-light.png`)。装配层测试另有完整闭环(契约回执 → Result → completed)。真宿主的十席输入/历史一致性仍需重启后逐个看 |
| A06 | A 工部改模型,B 工部用另一模型,全局默认不变 | 已验(单测)+ 待真机 | 配置按 `projectId+roleId` 存、`saveDepartmentConfig` CAS;**派发时默认不再调 `selectModel`**(部门模型由政策插件在 `agent/request` 上按角色覆写,再调一次会让宿主把全局默认存成本部门的),模型快照仍记在 `attempt.effectiveConfigSnapshot`。真机待看 `modelSelection` 投影 |
| A07 | 运行中改模型,本次仍用原模型 | 已验(单测) | `首次派发:固定模型快照 → prompt 用 attemptId 作幂等键`:`effectiveConfigSnapshot` 在派发时冻结 |
| A08 | 模型不支持旧 effort / 目录失效,校验错误可见 | 已验(单测) | `会话适配:prompt 必须带 requestId,错误分类可区分可重试与必失败` 覆盖 `model_unavailable`;不静默替换 |
| A09 | 丞相带文件交接工部,材料可读、引用可追溯 | 已验(单测,附件级已通) | `A09 交接材料:附件引用原样进 packet,成果引用带版本,文本里可读`:`{attachmentId}` 保留 name/mime/size,`{artifactId}` 自动补 `revision` 与成果显示名;`buildDispatchText` 渲染成 `成果 预算表 art_x(第 1 版)`、`附件 att_abc(预算.xlsx · application/vnd.ms-excel · 2048 字节)`;缺 ID / 未知 ID 报 `INVALID_INPUT` / `NOT_FOUND`。真机"从聊天里带附件"仍需重启后确认 |
| A10 | 正常完成:有效报告+终态+成果核验 | 已验(单测) | `完成判定分支一:报告+终态成功+成果有效 → completed` |
| A11 | 仅变 idle 或输出"已完成"不标记完成 | 已验(单测) | `对账:运行结束但无报告 → needs_attention`;`契约解析只认四动作`(正文里的"已完成"不进状态机) |
| A12 | 重复投递/重复完成/乱序事件不重复、不倒退 | 已验(单测 + 真实路由) | `重复点击同一幂等键:不重复投递`;`结果去重:同 (attemptId, reportVersion) 与同 sourceMessageRef 只登记一次`;`isRegressingEvent` 拒绝倒退终态;`--live` 场景 cancel:派工 accepted 后 `POST /task/cancel` 200,`task.status=cancelled`、`applied=true`,界面按钮消失并发绿条(`docs/preview/v01-live-cancel-400-light.png`) |
| A13 | 回执超时 → unknown 对账,不自动重发 | 已验(单测) | `投递超时:dispatch 记 unknown,不自动重发` + `verifyUnknown` |
| A14 | 用户直聊与派工同时到达,同 session 串行 | 已验(单测)+ 待真机 | 错误分类 `busy`;真实串行由宿主 inbox 保证,需真机观察 |
| A15 | A/B 同时跑,停止 A,B 继续 | 已验(单测)+ 待真机 | `cancelTask:业务落 cancelled,运行中的尝试只到 cancel_requested`;取消带 `attemptId`,不会误停 B |
| A16 | A 运行时切到 B,A 迟到回调不改 B | 已验(单测) | `对账` 全按 `attemptId` 判定;`宿主重启后查不到会话时不猜` |
| A17 | 刷新/关闭重开/重启宿主后绑定配置任务恢复 | 已验(单测,账本重开) | `A17 宿主重启:账本重开后项目/绑定/配置/任务/派发都还在,换绑代号不回退`:同一 `workbench.json` 新建 store + `load()` 后项目/绑定/配置(`config.model`、`configRevision`)/任务/幂等键全部还原,重复派发返回 `duplicate:true` 且同 `dispatch.id`;`events` 游标可重放。**U7 宿主重启后客户端重建仍需真机** |
| A18 | 伪造其他项目 session/task/artifact/run ID 被拒 | 已验(单测) | `项目隔离` 四条:`CROSS_PROJECT` / `NOT_FOUND` 且不泄露归属 |
| A19 | B 不自动获得 A 的材料/记忆 | 已验(单测,材料侧) | `A09/A19 跨项目成果引用被拒`:B 项目引用 A 的 `artifactId` → `CROSS_PROJECT`,`details` 不含 A 的归属;B 的 packet 只装本任务材料(无跨项目串带)。**记忆隔离属宿主能力,仍需真机** |
| A20 | 相同目录/父子目录识别为冲突,不宣称完全隔离 | 已验(单测) | `A20 同目录/父子目录登记成另一个项目时明确报冲突`:`DUPLICATE_PROJECT` + `relation: same/nested` + `allowSharedRoot` 显式放行 |
| A21 | 两窗口同时改设置/消费队列不覆盖 | 已验(单测) | `saveDepartmentConfig 走 CAS:旧 revision 冲突并带回当前值`;事件日志为只读游标,多标签页不互相偷事件 |
| A22 | 主责部门局部修改成果,保留来源/版本,不重跑全链 | 已验(单测 + 真实路由/真实 bundle) | `--live` 场景 revise:真实 `POST /artifact/revision` 200,返回 `kind:revision`、`scope.kind:artifact-revision`、`artifactRevision:1`,界面自动切任务页并显示带「修订」标签的新任务(`docs/preview/v01-live-revise-400-light.png`)。单测另验「只开一条修订任务、不重跑三省」
| A23 | 删除 session 或成果文件后显示失效并保留历史 | 已验(单测 + 真实路由/真实 bundle) | `--live` 场景 missing:`fileRef` 指向不存在文件时 `existence=missing`,界面显示虚线淡红卡 +「· 文件已失效」,账本记录保留(`docs/preview/v01-live-missing-400-light.png`)。注意 `verification.status` 仍为 `verified` —— 那是「结果被核验过」,与「文件现在还在不在」是两个维度,不去改写它
| A24 | 2560×1440 浅/深色、拖宽右栏 | 已验(预览) | `docs/preview/v01-workbench-rail-400-light.png` / `-dark.png`(800×1220,真 Chrome 渲染真实 bundle);拖宽逻辑 340–600 + `sansheng.workbench.railWidth` |
| A25 | 约 390 CSS px 手机宽度抽屉可用 | 已验(预览) | `docs/preview/v01-workbench-rail-390-light.png` / `-dark.png`(780×1220):三列卡片不再折行,「未接通」保持一行、模型名省略号;抽屉本身在真机里才展开(待真机) |
| A26 | 切主题/项目/部门后草稿、绑定、配置各归所属 | 已验(单测,数据归属)+ 待真机界面 | `A26 切项目后草稿、绑定、配置各归所属`:两个项目各自 `gongbu` 配置不同模型、绑不同会话、各存一条 draft 任务;`bootstrap(A)/(B)` 的席位配置、`binding.currentSessionId`、任务标题互不串带。界面切换时草稿保留仍需真机点一遍 |
| A27 | 键盘选卡片/模型按钮/分隔条/弹层,焦点可恢复 | 已验(单测)+ 待真机遍历 | 卡片 `role="button"` + `tabIndex` + Enter/Space;分隔条 `role="separator"` + `tabIndex` + `aria-valuenow/min/max`,方向键 ±16、Shift ±64、Home/End 到两端,未知键返回 `null` 不拦截默认行为(`A27 分隔条键盘` 单测)。宿主内真实 Tab 顺序与焦点恢复仍需重启后手测 |
| A28 | 原生聊天审批、附件、流式在工作台同页可用 | 待真机 | 结构上复用 `renderFactorySlot('conversation.content')`,不重造聊天;需真机确认没绕过审批 |
小计:**已验 22 项**(A02 A03 A04 A05 A06 A07 A08 A09 A10 A11 A12 A13 A15 A16 A17 A18 A19 A20 A21 A22 A23 A26 A27 的单测/装配层部分,A24 A25 的预览部分)、**待真机 4 项**(A01 A14 A28 + A04/A24/A25/A26 的真机部分)、**未做 0 项**。
> 说明:A06 之所以仍标"部分",是判定标准要求"全局默认模型不被改动",而这一点只能在真实宿主里
> 观察 `modelSelection` 投影才能坐实;代码侧已确认每次派发前覆写 `selectModel` 并记录
> `effectiveConfigSnapshot`,派发结束后不写回全局。A01/A05/A14/A25–A28 同理,都需要重启 DSH 后补证据。
---
## 2. 本轮新增/改动(相对上一版)
| 文件 | 改动 |
|---|---|
| `workbench/core/store.mjs` | `REFERENCES.artifacts` 增 `revisesArtifactId`(跨项目修订一律拒绝);`recordArtifact` 落 `revisesArtifactId / revision / revisionOfTaskId` |
| `workbench/host/service.mjs` | 新增 `normalizeRoot` + `rootConflict`(A20);`registerProject` 冲突即拒、`allowSharedRoot` 显式放行;新增 `requestArtifactRevision`(A22);`registerArtifact` 支持修订链与版本递增;新增 `artifactView`(A23,`fileExists` 可注入);`dispatchTask` 对修订任务自动补 `materialRefs`;`EVENT_OPS` 增 `requestArtifactRevision` |
| `workbench/host/routes.mjs` | 新增 `POST /sansheng/workbench/artifact/revision`(端点 11 → 12) |
| `workbench/host/index.mjs` / `workbench-host.mjs` | 把宿主 `existsSync` 注入 service(A23 真机可用),测试可替换 |
| `workbench/test/service.test.mjs` | 新增 3 条:A20 冲突、A22 修订链、A23 失效投影 |
| `workbench/test/routes.test.mjs` | 路由数 11 → 12 |
| `workbench/panel/lib/client.js` | 成果区补「文件已失效/位置未核验」标记、修订按钮与内联表单、任务「修订」标签 |
### 本轮(A09/A17/A19 补齐)
| 文件 | 改动 |
|---|---|
| `workbench/host/session-adapter.mjs` | 新增 `describeMaterialRef(ref)` 并用于 `buildDispatchText`:成果写成「成果 预算表 art_x(第 1 版)」,附件写成「附件 att_abc(预算.xlsx · application/vnd.ms-excel · 2048 字节)」,字符串材料原样 |
| `workbench/host/service.mjs` | 新增 `normalizeMaterialRefs(value, project)`:`{artifactId}` 校验同项目并自动补 `revision`/`title`(标题取 `artifact.displayName`),`{attachmentId}` 保留 name/mime/size,字符串放行,未知/缺 ID 报 `NOT_FOUND`/`INVALID_INPUT`;`dispatchTask` 的材料走它而不是裸数组 |
| `workbench/test/acceptance-extra.test.mjs` | 新增 3 例:A09 材料可读、A09/A19 跨项目材料被拒且不泄露归属、A17 账本重开后全量还原 |
| `workbench/test/service.test.mjs` | A22 断言补齐 `title`(材料引用现在带可读名) |
测试数:206 → **209**(全绿)。
---
## 3. 复现步骤(真机部分)
1. 确认主包已安装(朝堂面板已并回 `dsh-sansheng-liubu-mode`,不再有独立 workbench 包):
```bash
node scripts/workbench-preflight.mjs # 期望 5/5 通过:入口、bundle 语法、16 条路由、账本可写
```
> `workbench-preflight.mjs` 是严格只读自检:不装、不改配置、不创建文件,只回答「重启后会不会白屏 / 路由起不起得来」。
> 安装、修复与迁移是另外的显式操作;旧 `workbench-install.mjs` 现在只打印迁移说明。
2. **彻底退出 DSH 再启动**(托盘退出,不是关窗口);只对新会话生效。
3. 打开任意项目会话,右侧应出现「朝堂 / 任务 / 成果」。
4. 依次验:接通一个部门 → 派一条任务 → 完成 → 在成果区点「找主责部门修改」。
5. 白屏逃生:控制台 `localStorage['sansheng.workbench.main']='off'` 后刷新,接管会被跳过。
6. 完全回退:从 profile 移除 `dsh-sansheng-liubu-mode` 后重启(旧独立 workbench 包已退役,不要安装)。
---
## 4. 已知限制(不含未验证项)
- **L1** 账本损坏时改名隔离(`<file>.corrupt-<时间戳>`),以空账本启动;不做自动修复。
- **L2** 成果只记引用,不复制文件;文件被删后靠 `existence:'missing'` 显示,历史不移除。
- **L3** 目录冲突只做字符串级归一(大小写、分隔符、末尾斜杠),**不解析 junction/短路径真实目标**;命中即报,不宣称隔离。
- **L4** `selectModel` 在宿主侧会连带改全局默认模型,所以派发前一律覆写并快照,不依赖全局默认。
- **L5** `cancel` 不撤回已排队的消息,取消后 FIFO 可能继续跑;因此取消只到 `cancel_requested`,等对账收口。
- **L6** 事件是只读游标 + 可重放,不做"读一次就消失"的队列;两个标签页会看到同一批事件。
- **L7** 400px 栏宽下模型名仍可能截断(三列每列约 112px),完整值在 `title` 里。
## 5. 未验证清单(必须在真机补)
- U7:宿主重启后客户端能否重建并重新读取账本(决定刷新语义)。
- U8:`follow` 断线重连是否零丢失(决定对账预算)。
- U4:二次 `create` 是否真返回同一个 sessionId。
- U5:客户端 `prompt` 的 `requestId` 是否真的透传到服务端幂等表。
- U9:`conversation.content` 工厂嵌入非主区时是否仍工作(当前只接管 `main.conversation`,不涉及)。
- A06 全局默认模型是否被改动、A09 附件级引用、A25 手机抽屉、A27 键盘遍历。
---
## 6. 回退
代码回退用 Git,不建备份副本。注意:**回退代码不会自动回退业务数据**,
`%USERPROFILE%\.dsh\sansheng-liubu\workbench.json` 仍在;schema 变化要写显式迁移,不静默丢弃旧账本。

View File

@ -1,93 +0,0 @@
# 三省六部第一版方案
状态:2026-11-14 设计稿,供确认功能与交互。最新要求是“做出第一版的方案,还有 dsh-go 的样式也做给我看看”。当前交付为方案及可点击样式预览,不代表已经安装插件、创建真实会话或完成原生适配。
## 1. 第一版要解决什么
用户在现有 DSH 项目里打开“三省六部”,就能找到固定的十个角色,切到对应会话,并单独配置该角色。Web 与 dsh-go 面向同一个项目和同一套会话,不各建一套团队。普通项目和普通会话保持原来的使用方式。
第一版做到“选项目 → 打开工作台 → 启用十席 → 选角色 → 在原生会话里工作”。启用团队只建立身份和会话,不同时启动十个模型任务。复杂派工、审核门禁和自动流程留到下一版。
## 2. 已固定的边界
- 采用 DS Bot 的长期 Bot 身份、角色配置和独立会话思路;不整体安装其客户端,也不接管设置入口。
- 每项目固定十个 Bot / 十个角色主会话:丞相、中书、尚书、门下、吏部、户部、礼部、兵部、刑部、工部。没有增删编制入口。
- 角色职责全文沿用 [项目规划](project-plan.md) 中从旧代码恢复的版本;卡片只显示短摘要,详情展开后显示全文。
- 配置和上下文按项目隔离。相同角色在不同项目里使用不同 session,模型设置也分别保存。
- 中间直接使用宿主原生会话。输入、附件、历史、流式输出、停止和审批仍由宿主管理。
- 左侧只加入口,不替换工作区、项目树、会话列表、设置或其他宿主组件。
- OpenMausBot 不进入本版。
## 3. Web 交互
入口放在现有左侧功能导航中,名称“三省六部”。点击后展开右侧工作台,并保持当前项目;若没有选项目,只提示“先从左侧选择一个项目”,不猜测或自动创建项目。
工作台顶部显示当前项目和十席数量。主体采用已确认的白蓝卡片:丞相顶部居中,三省一排,六部两排;选中角色以蓝色描边。右栏支持收起和调宽,跟随宿主深浅色。
首次进入尚未启用的项目时,显示“启用此项目的十席”按钮,说明会建立十个独立会话且不会自动运行。启用途中显示实际进度;失败保留已完成绑定,重试只继续未完成项,不从头重复创建。
已启用时,点击角色直接切换原生会话;再次点击当前角色不新建会话。默认只显示角色卡和职责摘要,“角色配置”折叠为一行。展开后可选择宿主已配置的模型、支持的思考强度以及填写角色补充说明。保存只影响当前项目当前角色,不改变宿主默认模型或其他角色。每个角色是独立 session,模型由该 session 独立保存;界面不设“跟随宿主模型”选项。尚未选择时显示“请选择模型”,选择后显示实际模型名称。若新建会话时用宿主默认模型初始化,也只是一次性取值并保存为具体选择,不能随宿主或其他会话之后的改动自动变化。
未保存配置切换角色时要明确提示或保留草稿,不能悄悄丢失。运行中的角色可查看配置;第一版建议等本轮结束后再保存模型变更,避免用户误以为当前请求已换模型。
预览:[Web 三栏交互稿](../preview/index.html)。其中聊天与原工作区为布局示意,不是已嵌入的宿主组件。
## 4. dsh-go 样式和交互
这是单独的原生风格设计,不把 Web 的三列整体缩小塞进手机。
### 4.1 原生会话页
默认展示现有原生聊天。顶部显示当前角色和当前项目,提供“工作台”入口。原有工作区入口和导航继续使用宿主方式,不再造一棵项目树。点击工作台进入原生会话面板;返回会话时保留输入和滚动位置。
### 4.2 工作台面板
面板占用手机的可用宽度,采用紧凑十席卡片,仍然保留丞相、三省、六部结构。角色名称全部两字,按钮触摸面积至少 44px。点击角色选中相应会话,面板下方明确显示“进入丞相会话”等按钮;进入后收起工作台。角色详情和配置入口留在卡片下方,不把整屏变成表单。
### 4.3 角色配置页
顶部显示当前项目和角色;职责以可折叠文字展示。模型通过原生单选列表选择,实际候选来自宿主已配置目录,不让用户在手机上输入 provider/model 字符串。保存后反馈明确,不触发模型运行。
已查到的原生面板协议支持按钮、单选、开关、tabs、accordion,但不提供自由文本输入。因此第一版把角色补充说明作为只读详情,提示“请在 Web 端编辑”;不在原生样式里画一个无法兑现的文本编辑器。若后续核验到宿主独立文本编辑接口,再增加编辑能力。
窄屏按会话、工作台、配置分屏;宽屏布局如何利用更多空间,以 dsh-go 实机接口为准。本次不承诺原生左导航能加入口,也不把 GenUI 的聊天快捷入口误当成全局导航注册。
预览:[dsh-go 原生风格交互稿](../preview/dsh-go.html)。可切深浅色、选角色、进入演示会话并选择模型。图中宿主导航外壳是样式提案,模型名称为示例;没有假装已拿到 App 的真实截图。
## 5. 第一版功能范围
| 功能 | 第一版安排 | 验收要点 |
| --- | --- | --- |
| 十席身份及角色职责 | 包含 | 名称固定;职责全文与旧代码一致 |
| 项目内十个独立主会话 | 包含 | 重开不重复建会话;项目切换不串线 |
| 原生会话复用 | 包含 | 不注册主聊天替换槽,不自写聊天引擎 |
| 角色切换、职责查看 | 两端包含 | 始终落到当前项目对应 session |
| 模型和思考强度选择 | 两端规划包含 | 只显示可用选项,不改宿主默认;原生 API 接通后验收 |
| 角色补充说明编辑 | Web 包含;dsh-go 先只读 | 原生无自由文本控件时不伪造可编辑功能 |
| 浅色、深色及收起面板 | 包含 | 不污染其他插件样式 |
| 权限/审批/运行控制 | 复用宿主 | 角色称号不提升权限,不重复实现审批 |
| 自动派工、审核门禁、返工流程 | 留后续 | 先规划规则,不从官职名称推导强制流程 |
| 群聊、额外团队会话、任务大屏 | 留后续 | 第一版不额外生成第十一个团队主会话 |
| 文件安全隔离 | 遵从宿主权限 | 项目数据隔离不等于沙箱隔离,不做过度承诺 |
## 6. 接入方案及已核实事项
独立插件分为“角色与绑定服务、Web 工作台、dsh-go 原生面板”。二者读取同一项目状态,原生会话负责实际执行。不会通过读取 DS Bot 的私有状态文件来冒充兼容,也不依赖 DS Bot 前端。
宿主已有公开 workspaceRegistry、sessionController 和 systemPrompt.section。模型选择可以通过原生 Agent 的会话级 model.select 记录为会话事件;controller.selectModel 会额外改变默认模型,不能直接拿来实现项目内设置。具体证据见 [宿主契约调研](host-contract-research.md)。
会话创建不能简单当作永久幂等操作。需要先持久化计划会话 ID,先检查是否已存在,再创建缺失项;任何返回 ID 不一致或工作区附着失败,都应保留待核对记录,不能静默重试生成更多会话。
dsh-go 已有原生插件面板桥接证据,来自本机 GenUI 插件说明及实现。原生面板需要现有 dshGo bridge;GenUI 的持久状态实现另需 DSH 0.2.1-rc.2 或更新的 session-state API,这不是整个 dsh-go 的最低版本声明。原生作用域只已证实含 sessionId/messageId/callId,没有 workspaceId;需由会话反查项目。已核实的 effect 不包含会话跳转,详见 [客户端契约调研](client-contract-research.md)。本地引擎有覆盖描述,SSH/relay 场景仍取决于对应 bridge;没有桥接时显示不支持,不私自换成 WebView、补丁 App 或自动降级创建另一套 session。角色导航到指定 session 的原生 effect、插件入口位置仍需正式开发时核验。
## 7. 实现顺序与验收
1. 对照这两份样式确认第一版范围;当前交付到此。
2. 实现项目内身份及十席会话绑定,先在隔离测试目录验证创建、恢复、失败重试和跨项目隔离。
3. 接 Web 导航和右侧工作台,确认原项目树、普通会话、设置入口均未被接管。
4. 接 dsh-go 原生面板,做真实设备触摸、返回、滚动、模型选择和目标会话导航验收;本地/SSH/relay 分开报告支持情况。
5. 两个项目同时开启,分别修改工部模型;重启后确认十席不重复、配置和会话不交叉,再打包发布。
必须单独检查过期操作:切换项目后才回来的请求结果不能覆盖新项目;旧面板按钮携带的项目/session/revision 不匹配时应拒绝并要求刷新。会话被用户删除时明确标成缺失,不能把另一个普通会话绑上来。
当前没有安装/发布可用插件。仓库中早期角色/存储试写为探索文件,不作为第一版实现完成的证据;现有宿主、真实模型、用户 profile 和会话都未改动。

46
docs/记忆设计.md Normal file
View File

@ -0,0 +1,46 @@
# 三省六部记忆设计(v2,0.12.0)
思路借鉴 DS Bot 的分层记忆(Bot 记忆 + 群记忆),但落在原生架构上、
按本项目一贯的隔离与记账规矩实现。不基于 DS Bot 构建(见 TODO.md 的否决记录)。
## 三层
| 层 | 文件 | 记什么 | 谁能读 |
|---|---|---|---|
| 部门记忆 | `~/.dsh/sansheng-liubu/memory/departments/<roleId>.md` | 这个部门自己摸出的经验,跟着部门跨项目 | 仅派给该部门的任务 |
| 项目记忆 | `~/.dsh/sansheng-liubu/memory/projects/<projectId>.md` | 这个项目发生过什么、结论是什么 | 仅本项目的派发 |
| 长期记忆 | `~/.dsh/sansheng-liubu/memory/long-term.md` | 用户偏好、长期有效的经验 | 所有项目的派发 |
项目之间互不可见。DS Bot 上游「Main Bot 可读写任意 Bot 记忆」的弱隔离
(归档分支 docs/p0 的 M-03 边界记录)不学。
## 怎么读(召回)
派发(dispatchTask)时,服务层把三层记忆的摘录并进上下文包的 excerpts:
部门记忆在前(主责部门自己那份,上限 2000 字)、项目记忆居中(上限 3000 字)、
长期记忆在后(上限 2000 字),超长截断并注明。
部门记忆只注入主责部门自己的那一份,别的部门的经验本不外借。
摘录随上下文包落账,事后可查「当时到底把哪段记忆发给了部门」。
记忆读失败不拦派发——记忆是参考资料,不是业务前置条件。
## 怎么写
1. **成果自动记账**:新成果汇报落账后记两行——项目记忆里一行
「<部门> 汇报成果(任务「<标题>」):<摘要>」,主责部门自己的部门记忆里
一行「在项目「<项目名>」汇报成果(任务「<标题>」):<摘要>」,都带日期小节。
重复汇报(幂等命中)不重复记;写失败不影响成果本身。
2. **接口读写**:POST `/sansheng/workbench/memory/get|put|append`
(scope = long-term | project | department;project 需带 projectId 且项目
必须存在,department 需带合法的 roleId)。
3. **手工编辑**:文件就是 Markdown,用户可直接打开改;程序写走
临时文件 + rename,不写半截。
## 上限与整理
单个记忆文件上限 64K 字符:写满会明确报错,要求先整理再写——
记忆要短而精,不是聊天记录的倾倒场。聊天正文仍由 DSH 会话保存,账本与记忆都不复制。
## 本版没做(后续)
- 工作台面板里的记忆查看/编辑界面(先用接口与文件)。
- 由模型自动提炼记忆(把流水账总结成条目)——v1 只有确定性记账,不引入额外模型调用。

13
icon.svg Normal file
View File

@ -0,0 +1,13 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="三省六部">
<defs>
<linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#9b6b2f"/>
<stop offset="1" stop-color="#5f351b"/>
</linearGradient>
</defs>
<rect x="10" y="14" width="108" height="100" rx="18" fill="url(#g)"/>
<path d="M31 45h66M39 61h50M47 77h34" fill="none" stroke="#f7e5b7" stroke-width="7" stroke-linecap="round"/>
<circle cx="31" cy="94" r="7" fill="#f7e5b7"/>
<circle cx="64" cy="94" r="7" fill="#f7e5b7"/>
<circle cx="97" cy="94" r="7" fill="#f7e5b7"/>
</svg>

After

Width:  |  Height:  |  Size: 626 B

59
index.js Normal file
View File

@ -0,0 +1,59 @@
// 三省六部工作台 · 宿主入口。
//
// 0.11.0 起老预设线退役:不再有「上朝」模式、Team 政策插件与朝堂侧栏。
// 本入口只做一件事——在应用根上把工作台宿主拉起来(账本、HTTP 接口、
// 会话装配、记忆都在 workbench/host 里),插件卸载时把它停掉。
// 工作台宿主自身对缺失能力一律降级并给出 warnings,所以这里不预检、
// 不抛错:工作台起不来不该拖垮整个应用。
//
// 防重复启动:宿主只该有一份。若本插件被重复应用(例如旧预设段还留在
// profile 里、按会话重复挂载),后来的应用只增加引用计数,不再另起一份
// 宿主——两份宿主会重复注册路由、双写同一本账本。用 Symbol.for 注册到
// globalThis,是为了连「包被复制成两份、模块身份不同」的情况也拦得住。
import { createWorkbenchHost } from './workbench/host/index.mjs'
export const name = 'sansheng-liubu-workbench-host'
const BOOT_KEY = Symbol.for('sansheng-liubu.workbench-host')
function release(entry) {
entry.refs -= 1
if (entry.refs > 0) return
if (globalThis[BOOT_KEY] === entry) delete globalThis[BOOT_KEY]
try {
entry.host.dispose()
} catch {
// 卸载失败不影响插件卸载;下次启动仍会从同一个账本继续。
}
}
export function apply(ctx) {
if (ctx === null || ctx === undefined) return undefined
const existing = globalThis[BOOT_KEY]
if (existing !== undefined) {
existing.refs += 1
return () => release(existing)
}
let host = null
try {
host = createWorkbenchHost(ctx?.root ?? ctx, {})
} catch (error) {
try {
ctx?.logger?.info?.(`[sansheng-liubo] 工作台启动失败:${error?.message ?? error}`)
} catch {
// 日志失败不能影响应用启动。
}
return undefined
}
for (const warning of host.warnings ?? []) {
try {
ctx?.logger?.info?.(`[sansheng-liubo] ${warning}`)
} catch {
// 同上。
}
}
const entry = { host, refs: 1 }
globalThis[BOOT_KEY] = entry
return () => release(entry)
}

42
package.json Normal file
View File

@ -0,0 +1,42 @@
{
"name": "dsh-sansheng-liubu-mode",
"version": "0.14.0",
"description": "三省六部工作台:十席独立会话、项目账本、派工与分层记忆",
"type": "module",
"main": "./index.js",
"exports": {
".": "./index.js",
"./package.json": "./package.json",
"./client": "./workbench/panel/lib/client.js"
},
"files": [
"index.js",
"cordis.patch.yml",
"icon.svg",
"README.md",
"CHANGELOG.md",
"scripts",
"workbench"
],
"icon": "./icon.svg",
"dsh": {
"manifestVersion": 1,
"bundle": {
"patch": "./cordis.patch.yml"
},
"client": {
"platform": "web",
"inject": [
"@deepseek-ai/dsh-api-session-controller",
"@deepseek-ai/dsh-client-ui-workspace",
"@deepseek-ai/dsh-client-ui-primitives"
]
}
},
"scripts": {
"test": "node --test --test-isolation=none workbench/test/*.test.mjs workbench/panel/test/client.test.mjs",
"workbench:preflight": "node scripts/workbench-preflight.mjs",
"preview:workbench": "node scripts/preview-workbench.mjs"
},
"license": "MIT"
}

View File

@ -1,37 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-border-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await sleep(600)
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2500)
out.seats = await ev("(() => [...document.querySelectorAll('.ssw-seat')].slice(0,4).map(el => { const cs=getComputedStyle(el); return { text:(el.innerText||'').replace(/\\s+/g,' ').slice(0,20), pressed:el.getAttribute('aria-pressed'), borderWidth:cs.borderTopWidth, borderStyle:cs.borderTopStyle, borderColor:cs.borderTopColor, background:cs.backgroundColor } }))()")
out.withBorder = await ev("(() => [...document.querySelectorAll('.ssw-seat')].filter(el => parseFloat(getComputedStyle(el).borderTopWidth) > 0).length)()")
out.total = await ev("document.querySelectorAll('.ssw-seat').length")
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,38 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-click-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const out = {}
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
const before = await ev("document.querySelector('.ssw-current-name')?.innerText")
await ev("(() => { const b=[...document.querySelectorAll('.ssw-seat')].find(x=>x.innerText.includes('工部')); if(b){b.click(); return true} return false })()")
await sleep(500)
const afterClick = await ev("({ name: document.querySelector('.ssw-current-name')?.innerText, selected: document.querySelector('.ssw-seat[aria-pressed=true] .ssw-role-name')?.innerText, page: document.title })")
out.before = before; out.afterClick = afterClick
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,30 +0,0 @@
import {spawn} from 'node:child_process';
import {mkdtemp,writeFile,rm} from 'node:fs/promises';
import {tmpdir} from 'node:os';
import {join,dirname} from 'node:path';
import {fileURLToPath,pathToFileURL} from 'node:url';
const dir=dirname(fileURLToPath(import.meta.url));const profile=await mkdtemp(join(tmpdir(),'sansheng-preview-'));let browser,ws;const checks=[];const errors=[];
try{
browser=spawn('C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir='+profile,'about:blank'],{stdio:['ignore','ignore','pipe']});
const endpoint=await new Promise((resolve,reject)=>{let log='';const timer=setTimeout(()=>reject(Error('Browser startup timeout')),20000);browser.stderr.on('data',b=>{log+=b;const m=log.match(/DevTools listening on (.+)/);if(m){clearTimeout(timer);resolve(m[1].trim())}});browser.on('error',reject);browser.on('exit',code=>{if(!log.includes('DevTools listening'))reject(Error('Browser exited '+code))})});
ws=new WebSocket(endpoint);await new Promise((resolve,reject)=>{ws.onopen=resolve;ws.onerror=reject});let n=0;const pending=new Map();ws.onmessage=e=>{const m=JSON.parse(e.data);if(m.id){const p=pending.get(m.id);pending.delete(m.id);if(m.error)p.reject(Error(JSON.stringify(m.error)));else p.resolve(m.result)}else if(m.method==='Runtime.exceptionThrown')errors.push(m.params.exceptionDetails.text)};
const cdp=(method,params={},sessionId)=>new Promise((resolve,reject)=>{const id=++n;pending.set(id,{resolve,reject});ws.send(JSON.stringify({id,method,params,...(sessionId?{sessionId}:{})}))});
const {targetId}=await cdp('Target.createTarget',{url:'about:blank'});const {sessionId}=await cdp('Target.attachToTarget',{targetId,flatten:true});const call=(m,p={})=>cdp(m,p,sessionId);await call('Page.enable');await call('Runtime.enable');
const evaluate=async expression=>{const r=await call('Runtime.evaluate',{expression,returnByValue:true,awaitPromise:true});if(r.exceptionDetails)throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text);return r.result.value};
const waitReady=async()=>{for(let i=0;i<100;i++){if(await evaluate('document.querySelectorAll(".role").length===10'))return;await new Promise(r=>setTimeout(r,60))}throw Error('Page not ready')};
const check=async(name,code)=>{if(!await evaluate(code))throw Error('FAIL '+name);checks.push(name)};
const shot=async name=>{const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false});await writeFile(join(dir,name),Buffer.from(r.data,'base64'))};
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:1100,deviceScaleFactor:1,mobile:false});await call('Page.navigate',{url:pathToFileURL(join(dir,'dsh-go.html')).href});await waitReady();
await check('Ten fixed two-character native role buttons','document.querySelectorAll(".role").length===10&&[...document.querySelectorAll(".role-name")].every(x=>x.textContent.length===2)');
await check('Unset and legacy inherited models require explicit choice','(()=>{saved.lead="跟随宿主模型";screens.forEach((_,i)=>render(i));document.querySelector("#phone-2 [data-action=save]").click();const blocked=!saved.gongbu;document.querySelector("#phone-2 [data-action=models]").click();const ok=blocked&&model("lead")===""&&document.querySelector("#phone-2 [data-confirm]").disabled&&document.querySelectorAll("#phone-2 [data-model]").length===2;document.querySelector("#phone-2 .sheet-bg").remove();delete saved.lead;return ok})()');
await check('Selected role opens corresponding demo conversation','(()=>{document.querySelector("#phone-1 [data-role=gongbu]").click();document.querySelector("#phone-1 .panel-footer button").click();const ok=document.querySelector("#phone-1 .header-title").textContent==="工部";document.querySelector("#phone-1 [data-action=workbench]").click();return ok})()');
await check('Model chooser changes only selected role','(()=>{document.querySelector("#phone-2 [data-action=models]").click();document.querySelectorAll("#phone-2 [data-model]")[1].click();document.querySelector("#phone-2 [data-confirm]").click();document.querySelector("#phone-2 [data-action=save]").click();return model("gongbu")===models[1]&&model("lead")===""})()');
await call('Page.reload');await waitReady();await check('Demo model persists across reload','model("gongbu")===models[1]');
await check('Role explanation expands without native text editor','(()=>{document.querySelector("#phone-2 [data-action=details]").click();return document.querySelector("#phone-2 .details").textContent.includes("Web")&&!document.querySelector("#phone-2 textarea")&&!document.querySelector("#phone-2 input")})()');
await evaluate('localStorage.removeItem("sansheng-go-design:v1");saved={gongbu:models[1]};screens.forEach((_,i)=>render(i))');await shot('dsh-go-light.png');
await evaluate('document.getElementById("theme").click()');await check('Native-style dark theme switches','document.documentElement.dataset.theme==="dark"');await shot('dsh-go-dark.png');
await evaluate('document.getElementById("theme").click();document.querySelector("#phone-2 [data-action=models]").click()');await shot('dsh-go-models.png');
await call('Emulation.setDeviceMetricsOverride',{width:390,height:1000,deviceScaleFactor:1,mobile:true});await check('Narrow preview contains gallery without body overflow','document.documentElement.scrollWidth<=390');await shot('dsh-go-narrow.png');
if(errors.length)throw Error(errors.join(';'));console.log(JSON.stringify({passed:checks.length,checks,consoleErrors:errors,screenshots:['dsh-go-light.png','dsh-go-dark.png','dsh-go-models.png','dsh-go-narrow.png']}));
await cdp('Browser.close').catch(()=>{});
}finally{ws?.close();browser?.kill();await new Promise(r=>setTimeout(r,500));await rm(profile,{recursive:true,force:true,maxRetries:5,retryDelay:300}).catch(()=>{})}

View File

@ -1,3 +0,0 @@
#!/usr/bin/env bash
set -euo pipefail
'/c/Users/qyh15/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe' preview/check-dsh-go.mjs

View File

@ -1,43 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-enable-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const out = {}
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=90000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(300) } return false }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
await ev("(() => { const b=[...document.querySelectorAll('.ssw-seat')].find(x=>x.innerText.includes('工部')); if(b)b.click(); return !!b })()")
await sleep(400)
out.before = await ev("({ name: document.querySelector('.ssw-current-name')?.innerText, button: document.querySelector('.ssw-current-actions button')?.innerText })")
await ev("(() => { const b=document.querySelector('.ssw-current-actions button'); if(b)b.click(); return !!b })()")
await waitFor("(() => { const b=document.querySelector('.ssw-current-actions button'); return b && b.innerText.includes('开始对话') })", 120000)
await sleep(1500)
out.afterEnable = await ev("({ name: document.querySelector('.ssw-current-name')?.innerText, button: document.querySelector('.ssw-current-actions button')?.innerText, count: document.querySelector('.ssw-count')?.innerText })")
await ev("(() => { const b=document.querySelector('.ssw-current-actions button'); if(b)b.click(); return !!b })()")
await sleep(3500)
out.afterOpen = await ev("({ name: document.querySelector('.ssw-current-name')?.innerText ?? null, title: document.title })")
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,181 +0,0 @@
// 真机检查:无头 Edge 打开独立测试 DSH,确认入口出现、点击后工作台渲染十席。
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
if (!url) { console.error('usage: check-live.mjs <url>'); process.exit(2) }
const EDGE = process.env.EDGE ?? 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'sansheng-live-'))
const errors = []
const result = { url, entry: null, workbench: null, consoleErrors: errors }
let browser, ws
const sleep = ms => new Promise(r => setTimeout(r, ms))
async function main() {
browser = spawn(EDGE, ['--headless=new', '--disable-gpu', '--no-first-run', '--no-default-browser-check', '--remote-debugging-port=0', '--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore', 'ignore', 'pipe'] })
const endpoint = await new Promise((resolve, reject) => {
let log = ''
const timer = setTimeout(() => reject(new Error('browser startup timeout')), 20000)
browser.stderr.on('data', b => { log += b; const m = log.match(/DevTools listening on (.+)/); if (m) { clearTimeout(timer); resolve(m[1].trim()) } })
browser.on('error', reject)
})
ws = new WebSocket(endpoint)
await new Promise((resolve, reject) => { ws.onopen = resolve; ws.onerror = reject })
let n = 0
const pending = new Map()
ws.onmessage = e => {
const m = JSON.parse(e.data)
if (m.id) { const p = pending.get(m.id); pending.delete(m.id); if (m.error) p.reject(Error(JSON.stringify(m.error))); else p.resolve(m.result) }
else if (m.method === 'Runtime.exceptionThrown') errors.push('exception: ' + (m.params.exceptionDetails.exception?.description || m.params.exceptionDetails.text))
else if (m.method === 'Runtime.consoleAPICalled' && ['error', 'warning'].includes(m.params.type)) {
const text = (m.params.args || []).map(a => a.value ?? a.description ?? '').join(' ')
if (/sansheng|error|failed|did not activate|duplicate/i.test(text)) errors.push(m.params.type + ': ' + text.slice(0, 400))
}
}
const cdp = (method, params = {}, sessionId) => new Promise((resolve, reject) => { const id = ++n; pending.set(id, { resolve, reject }); ws.send(JSON.stringify({ id, method, params, ...(sessionId ? { sessionId } : {}) })) })
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call = (m, p = {}) => cdp(m, p, sessionId)
await call('Page.enable'); await call('Runtime.enable')
const evaluate = async expression => {
const r = await call('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: true })
if (r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description || r.exceptionDetails.text)
return r.result.value
}
const waitFor = async (expr, timeout = 45000, step = 250) => { const end = Date.now() + timeout; while (Date.now() < end) { try { if (await evaluate(expr)) return true } catch {} await sleep(step) } return false }
const shot = async name => { const r = await call('Page.captureScreenshot', { format: 'png', captureBeyondViewport: false }); await writeFile(join(dir, name), Buffer.from(r.data, 'base64')) }
await call('Emulation.setDeviceMetricsOverride', { width: 1440, height: 900, deviceScaleFactor: 1, mobile: false })
await call('Page.navigate', { url })
await waitFor("document.readyState === 'complete'", 30000)
// 关掉 DSH 自身“预览版说明”首启弹层,避免遮挡截图
try { await evaluate("(() => { const b = [...document.querySelectorAll('button')].find(x => (x.innerText || '').trim() === '继续'); if (b) { b.click(); return true } return false })()") } catch {}
await sleep(500)
try { await call('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 }); await call('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 }) } catch {}
await sleep(800)
const foundEntry = await waitFor("!!document.querySelector('.ssw-entry')", 60000)
result.entry = await evaluate(`(() => ({ found: !!document.querySelector('.ssw-entry'), text: document.querySelector('.ssw-entry')?.innerText?.trim() ?? null, title: document.title }))()`)
await shot('live-01-entry.png')
if (foundEntry) {
await evaluate("document.querySelector('.ssw-entry').click(); true")
const foundRoot = await waitFor("!!(document.querySelector('.ssw-root') || document.querySelector('.ssw-float'))", 15000)
await sleep(3000)
result.workbench = await evaluate(`(() => {
const root = document.querySelector('.ssw-root') || document.querySelector('.ssw-float')
const seats = document.querySelectorAll('.ssw-seat')
return {
found: !!root,
rootClass: root ? root.className : null,
headTitle: document.querySelector('.ssw-head-title')?.innerText?.trim() ?? null,
seatCount: seats.length,
seatNames: Array.from(seats).map(s => s.querySelector('.ssw-role-name')?.innerText?.trim()).filter(Boolean),
countLabel: document.querySelector('.ssw-count')?.innerText?.trim() ?? null,
enableText: document.querySelector('.ssw-enable .ssw-primary')?.innerText?.trim() ?? null,
currentName: document.querySelector('.ssw-current-name')?.innerText?.trim() ?? null,
error: document.querySelector('.ssw-error')?.innerText?.trim() ?? null,
empty: document.querySelector('.ssw-empty')?.innerText?.replace(/\\s+/g, ' ').trim() ?? null,
loading: !!document.querySelector('.ssw-loading'),
floating: !!document.querySelector('.ssw-float'),
inDock: !!(document.querySelector('.ssw-root') && document.querySelector('.ssw-root').closest('[data-sidebar-right-session]')),
dockTabLabels: Array.from(document.querySelectorAll('[data-sidebar-right-tab]')).map(x => x.innerText.trim()).filter(Boolean),
rootText: root ? root.innerText.replace(/\\s+/g, ' ').trim().slice(0, 700) : null,
}
})()`)
await shot('live-02-workbench.png')
if (process.argv.includes('--report')) {
const toggled = await evaluate("(() => { const b = document.querySelector('.ssw-report-toggle'); if (!b) return false; b.click(); return true })()")
await sleep(700)
result.report = await evaluate(`(() => ({
toggled: ${toggled},
count: document.querySelectorAll('.ssw-report-item').length,
items: Array.from(document.querySelectorAll('.ssw-report-item')).map(el => ({
seat: el.getAttribute('data-seat'),
name: el.querySelector('strong')?.innerText?.trim() ?? null,
model: el.querySelector('.ssw-report-model')?.innerText?.trim() ?? null,
text: el.querySelector('.ssw-report-text')?.innerText?.trim() ?? null,
})),
}))()`)
await shot('live-05-report.png')
try {
await evaluate("(() => { const el = document.querySelector('.ssw-report-item[data-seat=lipu]'); if (el) { el.scrollIntoView({ block: 'center' }); return true } return false })()")
await sleep(500)
await shot('live-06-report-lipu.png')
} catch {}
}
const oi = process.argv.indexOf('--open')
if (oi >= 0) {
const seatId = process.argv[oi + 1]
const order = { lead: 0, zhongshu: 1, shangshu: 2, menxia: 3, libu: 4, hubu: 5, lipu: 6, bingbu: 7, xingbu: 8, gongbu: 9 }
const idx = order[seatId]
if (idx !== undefined) {
const clicked = await evaluate(`(() => { const s = document.querySelectorAll('.ssw-seat'); if (s[${idx}]) { s[${idx}].click(); return true } return false })()`)
const noticeEarly = await evaluate("document.querySelector('.ssw-notice')?.innerText?.trim() ?? null")
await sleep(1800)
result.open = await evaluate(`(() => ({
mainText: (document.querySelector('main')?.innerText || '').replace(/\\s+/g, ' ').trim().slice(0, 320),
composer: (document.querySelector('.composer')?.innerText || '').replace(/\\s+/g, ' ').trim().slice(0, 120),
title: document.title,
}))()`)
result.open.seatId = seatId
result.open.clicked = clicked
result.open.noticeEarly = noticeEarly
await shot('live-07-' + seatId + '-session.png')
}
}
if (process.argv.includes('--each')) {
result.each = []
const n = await evaluate("document.querySelectorAll('.ssw-seat').length")
for (let i = 0; i < n; i++) {
await evaluate(`(() => { const s = document.querySelectorAll('.ssw-seat'); if (s[${i}]) s[${i}].click(); return true })()`)
await sleep(1200)
const info = await evaluate(`(() => ({
name: document.querySelector('.ssw-current-name')?.innerText?.trim() ?? null,
notice: document.querySelector('.ssw-notice')?.innerText?.trim() ?? null,
selected: document.querySelector('.ssw-seat[aria-pressed=true] .ssw-role-name')?.innerText?.trim() ?? null,
}))()`)
await shot('seat-' + String(i + 1).padStart(2, '0') + '.png')
result.each.push({ i: i + 1, ...info })
}
}
if (process.argv.includes('--seat')) {
const clicked = await evaluate("(() => { const s = document.querySelectorAll('.ssw-seat'); if (s.length >= 10) { s[9].click(); return true } return false })()")
await sleep(1500)
result.seatNav = await evaluate(`(() => ({
clicked: ${clicked},
notice: document.querySelector('.ssw-notice')?.innerText?.trim() ?? null,
currentName: document.querySelector('.ssw-current-name')?.innerText?.trim() ?? null,
}))()`)
await shot('live-04-seat.png')
}
if (process.argv.includes('--enable') && await evaluate("!!document.querySelector('.ssw-enable .ssw-primary')")) {
await evaluate("document.querySelector('.ssw-enable .ssw-primary').click(); true")
const done = await waitFor("(() => { const c = document.querySelector('.ssw-count'); return c && /10 个会话/.test(c.innerText) })()", 60000)
await sleep(1500)
result.enable = await evaluate(`(() => ({
done: !!done_placeholder,
count: document.querySelector('.ssw-count')?.innerText?.trim() ?? null,
bound: document.querySelectorAll('.ssw-dot[data-status=bound]').length,
failed: document.querySelectorAll('.ssw-dot[data-status=failed]').length,
error: document.querySelector('.ssw-error')?.innerText?.trim() ?? null,
notice: document.querySelector('.ssw-notice')?.innerText?.trim() ?? null,
}))()`.replace('done_placeholder', String(done)))
await shot('live-03-enabled.png')
}
}
result.pass = !!(result.entry?.found && result.workbench?.found && (result.workbench?.seatCount === 10 || result.workbench?.enableText)
&& (!process.argv.includes('--report') || (result.report?.count === 10 && result.report.items.every(it => it.name && it.text)))
&& (!process.argv.includes('--each') || result.each?.length === 10))
}
try { await main() } catch (error) { result.fatal = String(error?.stack ?? error) } finally { try { ws?.close() } catch {}; try { browser?.kill() } catch {} }
console.log(JSON.stringify(result, null, 2))

View File

@ -1,41 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-nav-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const out = {}
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=60000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(300) } return false }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
await ev("(() => { const b=[...document.querySelectorAll('.ssw-seat')].find(x=>x.innerText.includes('工部')); if(b)b.click(); return !!b })()")
await sleep(400)
out.selectedBefore = await ev("document.querySelector('.ssw-current-name')?.innerText")
await ev("(() => { const b=document.querySelector('.ssw-current-actions button'); if(b)b.click(); return !!b })()")
await sleep(3000)
out.titleAfter = await ev("document.title")
out.selectedAfter = await ev("document.querySelector('.ssw-current-name')?.innerText ?? null")
out.tab = await ev("(() => { const t=[...document.querySelectorAll('[role=tab]')].find(x=>(x.innerText||'').includes('三省六部')); return t ? t.getAttribute('aria-selected') : null })()")
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,33 +0,0 @@
import {spawn} from 'node:child_process';
import {mkdtemp,writeFile,rm} from 'node:fs/promises';
import {tmpdir} from 'node:os';
import {join,dirname} from 'node:path';
import {fileURLToPath,pathToFileURL} from 'node:url';
const dir=dirname(fileURLToPath(import.meta.url));const profile=await mkdtemp(join(tmpdir(),'sansheng-preview-'));let browser,ws;const checks=[];const errors=[];
try{
browser=spawn('C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir='+profile,'about:blank'],{stdio:['ignore','ignore','pipe']});
const endpoint=await new Promise((resolve,reject)=>{let log='';const timer=setTimeout(()=>reject(Error('Browser startup timeout')),20000);browser.stderr.on('data',b=>{log+=b;const m=log.match(/DevTools listening on (.+)/);if(m){clearTimeout(timer);resolve(m[1].trim())}});browser.on('error',reject);browser.on('exit',code=>{if(!log.includes('DevTools listening'))reject(Error('Browser exited '+code))})});
ws=new WebSocket(endpoint);await new Promise((resolve,reject)=>{ws.onopen=resolve;ws.onerror=reject});let n=0;const pending=new Map();ws.onmessage=e=>{const m=JSON.parse(e.data);if(m.id){const p=pending.get(m.id);pending.delete(m.id);if(m.error)p.reject(Error(JSON.stringify(m.error)));else p.resolve(m.result)}else if(m.method==='Runtime.exceptionThrown')errors.push(m.params.exceptionDetails.text)};
const cdp=(method,params={},sessionId)=>new Promise((resolve,reject)=>{const id=++n;pending.set(id,{resolve,reject});ws.send(JSON.stringify({id,method,params,...(sessionId?{sessionId}:{})}))});
const {targetId}=await cdp('Target.createTarget',{url:'about:blank'});const {sessionId}=await cdp('Target.attachToTarget',{targetId,flatten:true});const call=(m,p={})=>cdp(m,p,sessionId);await call('Page.enable');await call('Runtime.enable');
const evaluate=async expression=>{const r=await call('Runtime.evaluate',{expression,returnByValue:true,awaitPromise:true});if(r.exceptionDetails)throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text);return r.result.value};
const waitReady=async()=>{for(let i=0;i<100;i++){if(await evaluate('document.querySelectorAll(".role").length===10'))return;await new Promise(r=>setTimeout(r,60))}throw Error('Page not ready')};
const check=async(name,code)=>{if(!await evaluate(code))throw Error('FAIL '+name);checks.push(name)};
const shot=async name=>{const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false});await writeFile(join(dir,name),Buffer.from(r.data,'base64'))};
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false});await call('Page.navigate',{url:pathToFileURL(join(dir,'index.html')).href});await waitReady();
await check('Ten fixed two-character roles','document.querySelectorAll(".role").length===10 && [...document.querySelectorAll(".role-name")].every(x=>x.textContent.length===2)');
await check('Unselected role cannot silently save a default model','(()=>{document.getElementById("config-body").dispatchEvent(new Event("submit",{cancelable:true}));return !configs.lead&&document.getElementById("composer-model").textContent==="请选择模型"&&!document.querySelector("option[value=inherit]")})()');
await check('Role switches conversation and preserves draft','(()=>{document.getElementById("message").value="draft-lead";document.querySelector("[data-role=gongbu]").click();const ok=document.getElementById("chat-name").textContent==="工部" && document.getElementById("message").value==="";document.querySelector("[data-role=lead]").click();return ok&&document.getElementById("message").value==="draft-lead"})()');
await check('Role configuration is isolated','(()=>{document.querySelector("[data-role=gongbu]").click();document.getElementById("config-toggle").click();document.getElementById("model").value="custom";document.getElementById("model").dispatchEvent(new Event("change"));document.getElementById("custom-model").value="demo-model";document.getElementById("role-note").value="只处理工程任务";document.getElementById("config-body").requestSubmit();document.querySelector("[data-role=lead]").click();return document.getElementById("model").value===""&&document.getElementById("role-note").value===""})()');
await call('Page.reload');await waitReady();await check('Configuration persists after reload','(()=>{document.querySelector("[data-role=gongbu]").click();return document.getElementById("custom-model").value==="demo-model"&&document.getElementById("role-note").value==="只处理工程任务"})()');
await check('Demo messages remain text and separate by role','(()=>{document.getElementById("message").value="<img src=x onerror=alert(1)>";document.getElementById("composer").requestSubmit();const ok=!document.querySelector(".message img")&&document.querySelector(".message").textContent.includes("<img");document.querySelector("[data-role=lead]").click();return ok&&!document.querySelector(".message")})()');
await check('Sidebar closes and entry reopens it','(()=>{document.getElementById("close-panel").click();const ok=document.getElementById("app").classList.contains("workbench-hidden");document.getElementById("entry").click();return ok&&!document.getElementById("app").classList.contains("workbench-hidden")})()');
await check('Keyboard sidebar resizing','(()=>{const r=document.getElementById("resize");r.dispatchEvent(new KeyboardEvent("keydown",{key:"ArrowLeft",bubbles:true}));return r.getAttribute("aria-valuenow")==="384"})()');
await evaluate('chats.gongbu=[];drafts.lead="";renderChat()');
await evaluate('document.documentElement.style.setProperty("--rail-width","374px");document.documentElement.dataset.theme="light";document.getElementById("toast").hidden=true;document.getElementById("config-body").hidden=true;document.getElementById("config-toggle").setAttribute("aria-expanded","false")');await shot('desktop-light.png');
await evaluate('document.querySelector("[data-role=gongbu]").click();document.getElementById("config-toggle").click();document.getElementById("toast").hidden=true');await call('Emulation.setDeviceMetricsOverride',{width:1440,height:1140,deviceScaleFactor:1,mobile:false});await shot('role-config.png');await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false});
await evaluate('document.querySelector("[data-role=lead]").click();document.getElementById("config-toggle").click();document.documentElement.dataset.theme="dark";document.getElementById("workbench").scrollTop=0');await shot('desktop-dark.png');
await call('Emulation.setDeviceMetricsOverride',{width:390,height:844,deviceScaleFactor:1,mobile:true});await evaluate('document.documentElement.dataset.theme="light";document.getElementById("close-panel").click()');await check('Narrow chat has no horizontal overflow','document.documentElement.scrollWidth<=390');await shot('mobile-chat.png');await evaluate('document.getElementById("panel-toggle").click()');await check('Narrow workbench remains visible without overflow','document.documentElement.scrollWidth<=390&&document.getElementById("workbench").getBoundingClientRect().right<=391');await shot('mobile-workbench.png');
if(errors.length)throw Error(errors.join(';'));console.log(JSON.stringify({passed:checks.length,checks,consoleErrors:errors,screenshots:['desktop-light.png','role-config.png','desktop-dark.png','mobile-chat.png','mobile-workbench.png']}));
await cdp('Browser.close').catch(()=>{});
}finally{ws?.close();browser?.kill();await new Promise(r=>setTimeout(r,500));await rm(profile,{recursive:true,force:true,maxRetries:5,retryDelay:300}).catch(()=>{})}

View File

@ -1,3 +0,0 @@
#!/usr/bin/env bash
set -euo pipefail
'/c/Users/qyh15/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe' preview/check-preview.mjs

View File

@ -1,72 +0,0 @@
// v0.1.2 验收:左侧导航位置 + 点击进入右侧工作台(隔离测试 DSH)。
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
if (!url) { console.error('usage: check-v012.mjs <url>'); process.exit(2) }
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v012-'))
const errors = []
const result = { url, nav: null, workbench: null, consoleErrors: errors }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new', '--disable-gpu', '--no-first-run', '--no-default-browser-check', '--remote-debugging-port=0', '--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore', 'ignore', 'pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log = ''; const t = setTimeout(() => reject(Error('browser timeout')), 20000); browser.stderr.on('data', b => { log += b; const m = log.match(/DevTools listening on (.+)/); if (m) { clearTimeout(t); resolve(m[1].trim()) } }); browser.on('error', reject) })
ws = new WebSocket(endpoint)
await new Promise((res, rej) => { ws.onopen = res; ws.onerror = rej })
let n = 0; const pending = new Map()
ws.onmessage = e => { const m = JSON.parse(e.data); if (m.id) { const p = pending.get(m.id); pending.delete(m.id); m.error ? p.reject(Error(JSON.stringify(m.error))) : p.resolve(m.result) } else if (m.method === 'Runtime.exceptionThrown') errors.push('exception: ' + (m.params.exceptionDetails.exception?.description || m.params.exceptionDetails.text)) }
const cdp = (method, params = {}, sid) => new Promise((res, rej) => { const id = ++n; pending.set(id, { resolve: res, reject: rej }); ws.send(JSON.stringify({ id, method, params, ...(sid ? { sessionId: sid } : {}) })) })
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call = (m, p = {}) => cdp(m, p, sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async expr => { const r = await call('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true }); if (r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description || r.exceptionDetails.text); return r.result.value }
const waitFor = async (expr, timeout = 45000) => { const end = Date.now() + timeout; while (Date.now() < end) { try { if (await ev(expr)) return true } catch {} await sleep(250) } return false }
const shot = async name => { const r = await call('Page.captureScreenshot', { format: 'png', captureBeyondViewport: false }); await writeFile(join(dir, name), Buffer.from(r.data, 'base64')) }
await call('Emulation.setDeviceMetricsOverride', { width: 1440, height: 900, deviceScaleFactor: 1, mobile: false })
await call('Page.navigate', { url })
await waitFor("document.readyState === 'complete'", 30000)
try { await ev("(() => { const b = [...document.querySelectorAll('button')].find(x => (x.innerText || '').trim() === '继续'); if (b) b.click(); return !!b })()") } catch {}
await sleep(600)
try { await call('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 }); await call('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 }) } catch {}
const found = await waitFor("!!document.querySelector('.ssw-nav-hit')", 60000)
result.nav = await ev(`(() => {
const hit = document.querySelector('.ssw-nav-hit')
const rowText = hit ? (hit.closest('button, [role=button], a, li')?.innerText || hit.parentElement?.innerText || '').replace(/\\s+/g, ' ').trim() : null
const labels = [...document.querySelectorAll('button, a, [role=button], li')]
.map(el => (el.innerText || '').replace(/\\s+/g, ' ').trim())
.filter(t => t && t.length <= 12)
const uniq = [...new Set(labels)]
const idx = name => uniq.indexOf(name)
return { found: !!hit, rowText, navLabels: uniq, sanshengIndex: idx('三省六部'), memoryIndex: idx('记忆系统'), moreIndex: idx('更多'), newSessionCount: (document.body.innerText.match(/新会话/g) || []).length }
})()`)
await shot('v012-entry.png')
if (found) {
await ev("document.querySelector('.ssw-nav-hit').click(); true")
const rootFound = await waitFor("!!document.querySelector('.ssw-root')", 20000)
await sleep(3500)
result.workbench = await ev(`(() => {
const root = document.querySelector('.ssw-root')
const main = document.querySelector('main')
return {
found: !!root,
rootClass: root ? root.className : null,
seatCount: document.querySelectorAll('.ssw-seat').length,
seatNames: [...document.querySelectorAll('.ssw-seat .ssw-role-name')].map(e => e.innerText.trim()),
countLabel: document.querySelector('.ssw-count')?.innerText?.trim() ?? null,
floating: !!document.querySelector('.ssw-float'),
empty: document.querySelector('.ssw-empty')?.innerText?.replace(/\\s+/g, ' ').trim() ?? null,
error: document.querySelector('.ssw-error')?.innerText?.trim() ?? null,
mainText: (main?.innerText || '').replace(/\\s+/g, ' ').trim().slice(0, 180),
}
})()`)
await shot('v012-workbench.png')
}
} catch (e) { result.fatal = String(e?.stack ?? e) } finally { try { ws?.close() } catch {} ; try { browser?.kill() } catch {} }
console.log(JSON.stringify(result, null, 2))

View File

@ -1,49 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v013-'))
const out = { consoleErrors: [] }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} else if(m.method==='Runtime.exceptionThrown'){ out.consoleErrors.push('exception: '+(m.params.exceptionDetails.exception?.description||m.params.exceptionDetails.text)) } else if(m.method==='Runtime.consoleAPICalled' && ['error','warning'].includes(m.params.type)){ const t=(m.params.args||[]).map(a=>a.value??a.description??'').join(' '); if(/sansheng|sidebar/i.test(t)) out.consoleErrors.push(m.params.type+': '+t.slice(0,300)) } }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await sleep(700)
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
out.collapseButtons = await ev("(() => [...document.querySelectorAll('button')].map(b=>b.getAttribute('aria-label')||b.getAttribute('title')||'').filter(t=>/收起|展开|collapse|expand|侧栏|sidebar/i.test(t)).slice(0,12))()")
out.rootBefore = await ev("!!document.querySelector('.ssw-root')")
if (process.argv.includes('--collapsed')) {
out.collapseClicked = await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.getAttribute('aria-label')||'')==='收起右侧边栏'); if(!b) return false; b.click(); return true })()")
await sleep(900)
out.rootBeforeCollapsed = await ev("!!document.querySelector('.ssw-root')")
}
await ev("document.querySelector('.ssw-nav-hit').click(); true")
const opened = await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2500)
out.opened = opened
out.tabCount = await ev("[...document.querySelectorAll('[data-sidebar-right-tab]')].filter(e=>(e.innerText||'').includes('三省六部')).length")
out.seatCount = await ev("document.querySelectorAll('.ssw-seat').length")
out.rootText = await ev("(document.querySelector('.ssw-root')?.innerText||'').replace(/\s+/g,' ').slice(0,160)")
await shot('v013-workbench.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,46 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v015-'))
const out = { consoleErrors: [] }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} else if(m.method==='Runtime.exceptionThrown'){ out.consoleErrors.push((m.params.exceptionDetails.exception?.description||m.params.exceptionDetails.text||'').slice(0,200)) } }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await sleep(700)
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
if (process.argv.includes('--row')) await ev("(() => { const hit=document.querySelector('.ssw-nav-hit'); const row=hit?.closest('button, [role=button], li, a'); (row||hit)?.click(); return !!row })()")
else await ev("document.querySelector('.ssw-nav-hit').click(); true")
const opened = await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(3000)
out.opened = opened
out.inlineBar = await ev("!!document.querySelector('.ssw-inline-bar')")
out.tabCount = await ev("[...document.querySelectorAll('[data-sidebar-right-tab]')].filter(e=>(e.innerText||'').includes('三省六部')).length")
out.rootRect = await ev("(() => { const r=document.querySelector('.ssw-root'); if(!r) return null; const b=r.getBoundingClientRect(); return { left:Math.round(b.left), width:Math.round(b.width), win:window.innerWidth } })()")
out.composer = await ev("(() => { const els=[...document.querySelectorAll('textarea, [contenteditable=true], .composer, [data-placeholder]')]; return els.map(e=>(e.getAttribute('placeholder')||e.className||e.tagName).toString().slice(0,40)).slice(0,5) })()")
out.mainText = await ev("(() => (document.querySelector('main')?.innerText||'').replace(/\\s+/g,' ').trim().slice(0,120))()")
out.startButtons = await ev("(() => [...document.querySelectorAll('.ssw-current-actions button')].map(b=>b.innerText.trim()))()")
await shot('v015-layout.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,57 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v020-'))
const out = { consoleErrors: [] }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} else if(m.method==='Runtime.exceptionThrown'){ out.consoleErrors.push((m.params.exceptionDetails.exception?.description||m.params.exceptionDetails.text||'').slice(0,160)) } }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const openWorkbench = async () => {
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
return await waitFor("!!document.querySelector('.ssw-root')",20000)
}
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
out.opened = await openWorkbench()
await sleep(2500)
out.tabs = await ev("(() => [...document.querySelectorAll('.ssw-tab')].map(b=>({ text:(b.innerText||'').replace(/\\s+/g,' ').trim(), active:b.getAttribute('aria-selected') })))()")
// 通过同源 API 造一条任务和一条成果(选十席都绑定的项目)
out.seeded = await ev("(async () => { const call=async(endpoint,payload)=>{const r=await fetch('api/sansheng',{method:'POST',credentials:'same-origin',headers:{'content-type':'application/json'},body:JSON.stringify({endpoint,payload})}); return (await r.json())}; const list=await call('list',null); let best=null; for(const p of (list.value?.projects||[])){ const view=await call('project',{projectId:p.id}); if(view.ok && view.value.project.seats.filter(s=>s.status==='bound').length===10){ best={id:p.id,name:p.name}; break } } if(!best) best=(list.value?.projects||[])[0]; if(!best) return {error:'no project'}; const t=await call('taskCreate',{projectId:best.id,title:'整理需求',goal:'写清楚验收标准',ownerSeatId:'zhongshu'}); const a=await call('artifactAdd',{projectId:best.id,title:'需求说明.pdf',path:'D:/out/需求说明.pdf',summary:'首版交付'}); return { project:best, task:t.ok, artifact:a.ok } })()")
await call('Page.reload',{})
await waitFor("document.readyState === 'complete'",30000)
await sleep(1200)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await openWorkbench()
await sleep(2500)
out.tabsAfter = await ev("(() => [...document.querySelectorAll('.ssw-tab')].map(b=>(b.innerText||'').replace(/\\s+/g,' ').trim()))()")
await ev("(() => { const b=[...document.querySelectorAll('.ssw-tab')].find(x=>(x.innerText||'').includes('任务')); if(b) b.click(); return !!b })()")
await sleep(800)
out.taskRows = await ev("(() => [...document.querySelectorAll('[data-task]')].map(el=>(el.innerText||'').replace(/\\s+/g,' ').trim().slice(0,80)))()")
await shot('v020-tasks.png')
await ev("(() => { const b=[...document.querySelectorAll('.ssw-tab')].find(x=>(x.innerText||'').includes('成果')); if(b) b.click(); return !!b })()")
await sleep(800)
out.artifactRows = await ev("(() => [...document.querySelectorAll('[data-artifact]')].map(el=>(el.innerText||'').replace(/\\s+/g,' ').trim().slice(0,80)))()")
await shot('v020-artifacts.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,45 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v021-'))
const out = { consoleErrors: [] }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} else if(m.method==='Runtime.exceptionThrown'){ out.consoleErrors.push((m.params.exceptionDetails.exception?.description||m.params.exceptionDetails.text||'').slice(0,160)) } }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2500)
const measure = async () => ev("(() => { const root=document.querySelector('.ssw-root'); const court=document.querySelector('.ssw-court'); const six=document.querySelector('.ssw-six'); const duty=document.querySelector('.ssw-role-duty'); const tab=document.querySelector('.ssw-tab.is-active'); return { rootW: Math.round(root.getBoundingClientRect().width), courtCols: getComputedStyle(court).gridTemplateColumns, sixCols: getComputedStyle(six).gridTemplateColumns, dutyDisplay: duty ? getComputedStyle(duty).display : null, tabBorder: getComputedStyle(tab).borderBottomColor, detailName: document.querySelector('.ssw-detail-name')?.innerText ?? null, button: document.querySelector('.ssw-detail-actions button')?.innerText ?? null, seats: document.querySelectorAll('.ssw-seat').length } })()")
await ev("document.querySelector('.ssw-root').style.width='980px'")
await sleep(600)
out.wide = await measure()
await shot('v021-wide.png')
await ev("document.querySelector('.ssw-root').style.width='330px'")
await sleep(600)
out.narrow = await measure()
await shot('v021-narrow.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,46 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v021b-'))
const out = { consoleErrors: [] }
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} else if(m.method==='Runtime.exceptionThrown'){ out.consoleErrors.push((m.params.exceptionDetails.exception?.description||'').slice(0,140)) } }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const measure = async () => ev("(() => ({ rootW: Math.round(document.querySelector('.ssw-root').getBoundingClientRect().width), courtCols: getComputedStyle(document.querySelector('.ssw-court')).gridTemplateColumns, sixCols: getComputedStyle(document.querySelector('.ssw-six')).gridTemplateColumns, duty: getComputedStyle(document.querySelector('.ssw-role-duty')).display, detail: !!document.querySelector('.ssw-detail') }))()")
const setPaneWidth = async (w) => { const expr = "(() => { const root=document.querySelector('.ssw-root'); let el=root; let cell=null; for(let i=0;i<8&&el;i++){ if(/tabCell|tabHost_123xe_164|pane_123xe_211/.test((el.className||'').toString())) cell=el; el=el.parentElement } const target=cell||root.parentElement; target.style.flex='0 0 " + w + "px'; target.style.width='" + w + "px'; return true })()"; return ev(expr) }
await call('Emulation.setDeviceMetricsOverride',{width:1560,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
out.default = await measure()
await shot('v021-default.png')
await setPaneWidth(1000); await sleep(700)
out.wide = await measure()
await shot('v021-wide.png')
await setPaneWidth(330); await sleep(700)
out.narrow = await measure()
await shot('v021-narrow.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,40 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v024-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const setPane = async (w) => ev("(() => { const root=document.querySelector('.ssw-root'); let el=root; let cell=null; for(let i=0;i<8&&el;i++){ if(/tabCell|tabHost_123xe_164|pane_123xe_211/.test((el.className||'').toString())) cell=el; el=el.parentElement } const t=cell||root.parentElement; t.style.flex='0 0 "+w+"px'; t.style.width='"+w+"px'; return true })()")
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
out.removed = await ev("(() => ({ enableBlocks: document.querySelectorAll('.ssw-enable').length, hasCurrentLabel: (document.body.innerText||'').includes('当前项目'), hasAllDuties: (document.body.innerText||'').includes('全部汇报职责'), projectTitle: document.querySelector('.ssw-project-title')?.innerText ?? null }))()")
await setPane(520); await sleep(700); out.w520 = await ev("getComputedStyle(document.querySelector('.ssw-court')).gridTemplateColumns"); await shot('v024-520.png')
await setPane(800); await sleep(700); out.w800 = await ev("getComputedStyle(document.querySelector('.ssw-court')).gridTemplateColumns"); await shot('v024-800.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,42 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v025-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
out.api = { skipped: true }
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
out.ui = await ev("(() => ({ hasBulkEnable: (document.body.innerText||'').includes('启用此项目的十席'), detailButton: document.querySelector('.ssw-detail-actions button')?.innerText ?? null }))()")
out.configOpened = await ev("(() => { const b=document.querySelector('.ssw-config-toggle'); if(!b) return false; b.click(); return true })()")
await sleep(600)
out.configLabel = await ev("(() => { const labels=[...document.querySelectorAll('.ssw-config .ssw-label')].map(e=>e.innerText.trim()); const note=document.querySelector('.ssw-config .ssw-scope-note')?.innerText ?? null; return { labels, note } })()")
await shot('v025-config.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,43 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v025b-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=60000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(300) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
out.before = await ev("(() => ({ button: document.querySelector('.ssw-detail-actions button')?.innerText ?? null, count: document.querySelector('.ssw-count')?.innerText ?? null, bulk: (document.body.innerText||'').includes('启用此项目的十席') }))()")
await shot('v025-unbound.png')
await ev("(() => { const b=document.querySelector('.ssw-detail-actions button'); if(b) b.click(); return !!b })()")
await waitFor("(() => { const b=document.querySelector('.ssw-detail-actions button'); return b && b.innerText.includes('开始对话') })()", 90000)
await sleep(1500)
out.after = await ev("(() => ({ button: document.querySelector('.ssw-detail-actions button')?.innerText ?? null, count: document.querySelector('.ssw-count')?.innerText ?? null, bound: document.querySelectorAll('.ssw-dot[data-status=bound]').length }))()")
await shot('v025-one-seat.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,40 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v030-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const setPane = async (w) => ev("(() => { const root=document.querySelector('.ssw-root'); let el=root; let cell=null; for(let i=0;i<8&&el;i++){ if(/tabCell|tabHost_123xe_164|pane_123xe_211/.test((el.className||'').toString())) cell=el; el=el.parentElement } const t=cell||root.parentElement; t.style.flex='0 0 "+w+"px'; t.style.width='"+w+"px'; return true })()")
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
const measure = async () => ev("(() => { const tabs=getComputedStyle(document.querySelector('.ssw-tabs')); const tree=document.querySelector('.ssw-tree'); const cur=document.querySelector('.ssw-current'); return { tabsRadius: tabs.borderRadius, tabsBg: tabs.backgroundColor, treeW: Math.round(tree.getBoundingClientRect().width), currentW: Math.round(cur.getBoundingClientRect().width), hasCourt: !!document.querySelector('.ssw-court'), hasIcon: !!document.querySelector('.ssw-seat svg'), leadW: Math.round(document.querySelector('.ssw-lead .ssw-seat').getBoundingClientRect().width), sixCols: getComputedStyle(document.querySelector('.ssw-six')).gridTemplateColumns } })()")
await setPane(720); await sleep(700); out.w720 = await measure(); await shot('v030-wide.png')
await setPane(360); await sleep(700); out.w360 = await measure(); await shot('v030-narrow.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,40 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-v031n-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const setPane = async (w) => ev("(() => { const root=document.querySelector('.ssw-root'); let el=root; let cell=null; for(let i=0;i<8&&el;i++){ if(/tabCell|tabHost_123xe_164|pane_123xe_211/.test((el.className||'').toString())) cell=el; el=el.parentElement } const t=cell||root.parentElement; t.style.flex='0 0 "+w+"px'; t.style.width='"+w+"px'; return true })()")
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
const measure = async () => ev("(() => { const duty=document.querySelector('.ssw-role-duty'); const seats=[...document.querySelectorAll('.ssw-seat')]; const overflow=seats.some(s=>s.scrollWidth>s.clientWidth+1); return { rootW: Math.round(document.querySelector('.ssw-root').getBoundingClientRect().width), duty: duty?getComputedStyle(duty).display:null, cardH: Math.round(seats[0].getBoundingClientRect().height), overflow } })()")
await setPane(303); await sleep(700); out.w303 = await measure(); await shot('v031-narrow303.png')
await setPane(360); await sleep(700); out.w360 = await measure(); await shot('v031-narrow360.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,43 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-consensus-'))
const out = {}
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
const shot = async name => { const r=await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false}); await writeFile(join(dir,name),Buffer.from(r.data,'base64')) }
const setPane = async (w) => ev("(() => { const root=document.querySelector('.ssw-root'); let el=root; let cell=null; for(let i=0;i<8&&el;i++){ if(/tabCell|tabHost_123xe_164|pane_123xe_211/.test((el.className||'').toString())) cell=el; el=el.parentElement } const t=cell||root.parentElement; t.style.flex='0 0 "+w+"px'; t.style.width='"+w+"px'; return true })()")
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2200)
await setPane(700); await sleep(600)
out.api = await ev("(async () => { const call=async(e,p)=>{const r=await fetch('api/sansheng',{method:'POST',credentials:'same-origin',headers:{'content-type':'application/json'},body:JSON.stringify({endpoint:e,payload:p})}); return await r.json()}; const list=await call('list',{}); const id=list.value.projects[0].id; const m=await call('memoryUpdate',{projectId:id,expectedRevision:0,goal:'做一个可验收的交付',constraints:['不能改线上数据'],acceptance:['回归测试通过']}); return { id, memory: m } })()")
await ev("(() => { const b=[...document.querySelectorAll('.ssw-config-toggle')].find(x=>x.innerText.includes('项目共识')); if(b) b.click(); return !!b })()")
await ev("document.querySelector('.ssw-root').scrollTop = 100000")
await sleep(700)
await shot('v040-memory.png')
} catch(e) { out.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2).slice(0, 2500))

Binary file not shown.

Before

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

File diff suppressed because one or more lines are too long

View File

@ -1,7 +0,0 @@
import fs from 'node:fs'
const text = fs.readFileSync(process.argv[2], 'utf8')
console.log('LEN', text.length)
for (const key of process.argv.slice(3)) {
let i = -1, n = 0
while ((i = text.indexOf(key, i + 1)) >= 0 && n < 2) { console.log('\n### ' + key + ' @' + i); console.log(text.slice(Math.max(0,i-200), i+260)); n++ }
}

View File

@ -1,36 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-dump-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const out = {}
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir='+profile,'about:blank'], { stdio:['ignore','ignore','pipe'] })
const ep = await new Promise((res,rej)=>{let l='';const t=setTimeout(()=>rej(Error('timeout')),20000);browser.stderr.on('data',b=>{l+=b;const m=l.match(/DevTools listening on (.+)/);if(m){clearTimeout(t);res(m[1].trim())}});browser.on('error',rej)})
ws = new WebSocket(ep); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0;const pend=new Map();ws.onmessage=e=>{const m=JSON.parse(e.data);if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)}}
const cdp=(me,pa={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method:me,params:pa,...(sid?{sessionId:sid}:{})}))})
const {targetId}=await cdp('Target.createTarget',{url:'about:blank'});const {sessionId}=await cdp('Target.attachToTarget',{targetId,flatten:true});const call=(me,pa={})=>cdp(me,pa,sessionId)
await call('Page.enable');await call('Runtime.enable')
const ev=async x=>{const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true});if(r.exceptionDetails)throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text);return r.result.value}
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
for(let i=0;i<80;i++){if(await ev("document.readyState==='complete'"))break;await sleep(200)}
try{await ev("(()=>{const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续');if(b)b.click();return !!b})()")}catch{}
await sleep(500)
try{await call('Input.dispatchKeyEvent',{type:'keyDown',key:'Escape',code:'Escape',windowsVirtualKeyCode:27});await call('Input.dispatchKeyEvent',{type:'keyUp',key:'Escape',code:'Escape',windowsVirtualKeyCode:27})}catch{}
await sleep(2500)
out.info = await ev(`(() => {
const rows = [...document.querySelectorAll('[data-row-key]')].map(e => ({ k: e.getAttribute('data-row-key'), title: (e.innerText||'').replace(/\\s+/g,' ').trim().slice(0,40) }))
return {
totalRows: rows.length,
workspaceRows: rows.filter(r => r.k.startsWith('workspace:')),
sessionRows: rows.filter(r => r.k.startsWith('session:')),
}
})()`)
} catch(e){ out.fatal = String(e?.stack??e) } finally { try{ws?.close()}catch{};try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

View File

@ -1,11 +0,0 @@
import fs from 'node:fs'
const url = process.argv[2]
const first = await fetch(url, { redirect: 'manual' })
const setCookie = first.headers.getSetCookie ? first.headers.getSetCookie() : [first.headers.get('set-cookie')].filter(Boolean)
const cookie = setCookie.map(c => c.split(';')[0]).join('; ')
const base = new URL(url)
const state = JSON.parse(fs.readFileSync('C:/Users/qyh15/.dsh-test-b/sansheng/state.json', 'utf8'))
const pid = Object.keys(state.projects)[0]
const res = await fetch(base.origin + '/api/sansheng', { method: 'POST', headers: { 'content-type': 'application/json', cookie }, body: JSON.stringify({ endpoint: 'enable', payload: { projectId: pid } }) })
const text = await res.text()
console.log('status', res.status, text.slice(0, 500))

View File

@ -1,40 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-more-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const out = { steps: [] }
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir='+profile,'about:blank'], { stdio:['ignore','ignore','pipe'] })
const ep = await new Promise((res,rej)=>{let l='';const t=setTimeout(()=>rej(Error('timeout')),20000);browser.stderr.on('data',b=>{l+=b;const m=l.match(/DevTools listening on (.+)/);if(m){clearTimeout(t);res(m[1].trim())}});browser.on('error',rej)})
ws = new WebSocket(ep); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0;const pend=new Map();ws.onmessage=e=>{const m=JSON.parse(e.data);if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)}}
const cdp=(me,pa={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method:me,params:pa,...(sid?{sessionId:sid}:{})}))})
const {targetId}=await cdp('Target.createTarget',{url:'about:blank'});const {sessionId}=await cdp('Target.attachToTarget',{targetId,flatten:true});const call=(me,pa={})=>cdp(me,pa,sessionId)
await call('Page.enable');await call('Runtime.enable')
const ev=async x=>{const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true});if(r.exceptionDetails)throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text);return r.result.value}
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
for(let i=0;i<80;i++){if(await ev("document.readyState==='complete'"))break;await sleep(200)}
try{await ev("(()=>{const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续');if(b)b.click();return !!b})()")}catch{}
await sleep(2500)
const dump = `(() => {
const rows = [...document.querySelectorAll('[data-row-key^=\"session:\"]')].map(e=>({k:e.getAttribute('data-row-key'),t:(e.innerText||'').replace(/\\s+/g,' ').trim().slice(0,30)}))
const dlg = [...document.querySelectorAll('[role=dialog],[role=menu]')].map(e=>(e.innerText||'').replace(/\\s+/g,' ').trim().slice(0,160)).filter(Boolean)
return { sessionRowCount: rows.length, rows, dialogs: dlg.slice(0,4) }
})()`
out.steps.push({ step: 'initial', ...(await ev(dump)) })
const moreCount = await ev("[...document.querySelectorAll('button')].filter(b=>(b.innerText||'').trim()==='更多').length")
for (let i=0;i<moreCount;i++) {
await ev(`(() => { const bs=[...document.querySelectorAll('button')].filter(b=>(b.innerText||'').trim()==='更多'); if(bs[${i}]) bs[${i}].click(); return true })()`)
await sleep(700)
out.steps.push({ step: 'click-more-' + i, ...(await ev(dump)) })
try{await call('Input.dispatchKeyEvent',{type:'keyDown',key:'Escape',code:'Escape',windowsVirtualKeyCode:27});await call('Input.dispatchKeyEvent',{type:'keyUp',key:'Escape',code:'Escape',windowsVirtualKeyCode:27})}catch{}
await sleep(300)
}
} catch(e){ out.fatal=String(e?.stack??e) } finally { try{ws?.close()}catch{};try{browser?.kill()}catch{} }
console.log(JSON.stringify(out, null, 2))

File diff suppressed because one or more lines are too long

View File

@ -1,45 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join, dirname } from 'node:path'
import { fileURLToPath } from 'node:url'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const dir = dirname(fileURLToPath(import.meta.url))
const profile = await mkdtemp(join(tmpdir(), 'ss-sidebar-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
const result = {}
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir='+profile,'about:blank'], { stdio:['ignore','ignore','pipe'] })
const endpoint = await new Promise((res, rej) => { let log=''; const t=setTimeout(()=>rej(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);res(m[1].trim())} }); browser.on('error',rej) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget',{url:'about:blank'})
const { sessionId } = await cdp('Target.attachToTarget',{targetId,flatten:true})
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async expr => { const r = await call('Runtime.evaluate',{expression:expr,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
for(let i=0;i<80;i++){ if(await ev("document.readyState==='complete'")) break; await sleep(200) }
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await sleep(500)
try { await call('Input.dispatchKeyEvent',{type:'keyDown',key:'Escape',code:'Escape',windowsVirtualKeyCode:27}); await call('Input.dispatchKeyEvent',{type:'keyUp',key:'Escape',code:'Escape',windowsVirtualKeyCode:27}) } catch {}
await sleep(3000)
result.dom = await ev(`(() => {
const ses = [...document.querySelectorAll('[data-session-id]')]
const bodyText = (document.body.innerText||'').replace(/\\s+/g,' ').trim()
return {
bodySnippet: bodyText.slice(0, 1100),
sessionAttrCount: ses.length,
sessionIds: ses.map(e => e.getAttribute('data-session-id')).slice(0, 20),
hasNewSessionWord: (bodyText.match(/新会话/g)||[]).length,
}
})()`)
const shot = await call('Page.captureScreenshot',{format:'png',captureBeyondViewport:false})
await writeFile(join(dir,'live-08-sidebar.png'), Buffer.from(shot.data,'base64'))
} catch (e) { result.fatal = String(e?.stack ?? e) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }
console.log(JSON.stringify(result, null, 2))

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 96 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 37 KiB

View File

@ -1,27 +0,0 @@
from PIL import Image, ImageDraw, ImageFont
seats = [("丞相","e35483b1"),("中书","4e278758"),("尚书","2e65d691"),("门下","78223c4a"),("吏部","cf800860"),
("户部","82262be8"),("礼部","1f2aeec7"),("兵部","2ce3587b"),("刑部","57f94de8"),("工部","857831f9")]
crop = (772, 0, 1440, 900)
tw, th = 300, 397
cols, rows, pad, labelh = 5, 2, 10, 24
tiles = []
for i in range(1, 11):
im = Image.open(f"preview/seat-{i:02d}.png").convert("RGB").crop(crop).resize((tw, th))
tiles.append(im)
W = cols * tw + (cols + 1) * pad
H = rows * (th + labelh) + (rows + 1) * pad
canvas = Image.new("RGB", (W, H), "white")
d = ImageDraw.Draw(canvas)
try:
font = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 15)
except Exception:
font = ImageFont.load_default()
for idx, (name, sid) in enumerate(seats):
r, c = idx // cols, idx % cols
x = pad + c * (tw + pad)
y = pad + r * (th + labelh + pad)
canvas.paste(tiles[idx], (x, y))
d.rectangle([x, y + th, x + tw, y + th + labelh], fill="#eef4ff")
d.text((x + 6, y + th + 4), f"{name} {sid}", fill="#1f2a3a", font=font)
canvas.save("preview/seats-contact.png")
print("saved", canvas.size)

View File

@ -1,33 +0,0 @@
import { spawn } from 'node:child_process'
import { mkdtemp } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
const url = process.argv[2]
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
const profile = await mkdtemp(join(tmpdir(), 'ss-probe-'))
const sleep = ms => new Promise(r => setTimeout(r, ms))
let browser, ws
try {
browser = spawn(EDGE, ['--headless=new','--disable-gpu','--no-first-run','--no-default-browser-check','--remote-debugging-port=0','--user-data-dir=' + profile, 'about:blank'], { stdio: ['ignore','ignore','pipe'] })
const endpoint = await new Promise((resolve, reject) => { let log=''; const t=setTimeout(()=>reject(Error('timeout')),20000); browser.stderr.on('data', b=>{ log+=b; const m=log.match(/DevTools listening on (.+)/); if(m){clearTimeout(t);resolve(m[1].trim())} }); browser.on('error',reject) })
ws = new WebSocket(endpoint); await new Promise((r,j)=>{ws.onopen=r;ws.onerror=j})
let n=0; const pend=new Map()
ws.onmessage = e => { const m=JSON.parse(e.data); if(m.id){const p=pend.get(m.id);pend.delete(m.id);m.error?p.reject(Error(JSON.stringify(m.error))):p.resolve(m.result)} }
const cdp=(method,params={},sid)=>new Promise((res,rej)=>{const id=++n;pend.set(id,{resolve:res,reject:rej});ws.send(JSON.stringify({id,method,params,...(sid?{sessionId:sid}:{})}))})
const { targetId } = await cdp('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp('Target.attachToTarget', { targetId, flatten: true })
const call=(m,p={})=>cdp(m,p,sessionId)
await call('Page.enable'); await call('Runtime.enable')
const ev = async x => { const r=await call('Runtime.evaluate',{expression:x,returnByValue:true,awaitPromise:true}); if(r.exceptionDetails) throw Error(r.exceptionDetails.exception?.description||r.exceptionDetails.text); return r.result.value }
const waitFor = async (x,t=45000)=>{ const end=Date.now()+t; while(Date.now()<end){ try{ if(await ev(x)) return true }catch{} await sleep(250) } return false }
await call('Emulation.setDeviceMetricsOverride',{width:1440,height:900,deviceScaleFactor:1,mobile:false})
await call('Page.navigate',{url})
await waitFor("document.readyState === 'complete'",30000)
try { await ev("(() => { const b=[...document.querySelectorAll('button')].find(x=>(x.innerText||'').trim()==='继续'); if(b)b.click(); return !!b })()") } catch {}
await waitFor("!!document.querySelector('.ssw-nav-hit')",60000)
await ev("document.querySelector('.ssw-nav-hit').click(); true")
await waitFor("!!document.querySelector('.ssw-root')",20000)
await sleep(2000)
const info = await ev("(() => { const root=document.querySelector('.ssw-root'); const chain=[]; let el=root; for(let i=0;i<8&&el;i++){ const cs=getComputedStyle(el); chain.push({ tag:el.tagName, cls:(el.className||'').toString().slice(0,60), w:Math.round(el.getBoundingClientRect().width), pos:cs.position, display:cs.display }); el=el.parentElement } return { chain, courtCols:getComputedStyle(document.querySelector('.ssw-court')).gridTemplateColumns } })()")
console.log(JSON.stringify(info, null, 2))
} catch(e) { console.log('FATAL', String(e?.stack ?? e)) } finally { try{ws?.close()}catch{}; try{browser?.kill()}catch{} }

Binary file not shown.

Before

Width:  |  Height:  |  Size: 92 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Some files were not shown because too many files have changed in this diff Show More