diff --git a/.gitignore b/.gitignore index 985eba3..b65a936 100644 --- a/.gitignore +++ b/.gitignore @@ -1,8 +1,5 @@ -.scratch/ -.research/ +ds-bot/ node_modules/ +.dsh-test-*/ +*.tmp *.log -.stats.html -review_results.json -# 生图实验残留,不进版本历史;要留下的预览图放 docs/ -dsh-image-gen/ diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index ff8166c..0000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,200 +0,0 @@ -# Changelog - -> 版本号以 `package.json` 为准(当前 0.9.2)。更早的 0.6.x 条目沿用旧编号,保留作历史。 - -## 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 <角色> [推理等级]`,并注明「召见后生效」。 -- 未召见的席位读清单时不再传会话 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 <部门> [推理等级]` 指令,由模式插件按角色把模型写进运行时路由表并落盘 `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 秒超时 →「读取模型清单超时(显示已知缓存)」;宿主拒绝保存 → 「:」。 -- 测试从 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 "" 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 陈旧链。 diff --git a/README.md b/README.md deleted file mode 100644 index 97bdaf3..0000000 --- a/README.md +++ /dev/null @@ -1,78 +0,0 @@ -# 「上朝」DSH 多 Agent 模式 - -面向 DeepSeek Harness Web GUI 的 Agent Preset,mode id 保持 `sansheng-liubu`。 - -**本插件默认不开启。** 装上它不会往 DSH 的模式选择器里塞「上朝」,也不会成为新会话的默认模式。只有你按下面步骤显式启用、并在新建会话时主动选中「上朝」,这套流程才开始运行。 - -启用之后,尚未加入 Agent Team 的默认主 Agent 会自动担任丞相(Lead),你可以直接与丞相对话,其余部门由丞相按流程创建。 - -## 启用方式(选了才生效) - -```powershell -node scripts/mode.mjs status # 现在开没开 -node scripts/mode.mjs on # 让「上朝」出现在模式选择器里 -node scripts/mode.mjs off # 彻底移除这个选项 -``` - -`on` 只是把 [preset.patch.yml](preset.patch.yml) 里那段 insert 写入 `~/.dsh/profiles/desktop/cordis.patch.yml`(带标记,可原样撤回),**不会**替你选中它。执行后彻底重启 DSH,新建会话时在模式选择器里主动选「上朝」,这套流程才启动;不选就一直是普通模式。 - -`off` 把那段 insert 整段删掉,文件回到原样;已存在的会话仍保留它自己的模式记录,不会被切成别的模式。 - -包自带的 [cordis.patch.yml](cordis.patch.yml) 是空层(`[]`),这是刻意的——装包本身不产生任何行为。想手工合并也可以,规则同上:顶层保持数组,删掉 `[]` 再接那段 insert。 - -若重启后模式选择器里看不到「上朝」,把 `dsh-sansheng-liubu-mode` 也加进 `~/.dsh/profiles/desktop/package.json` 的 `dsh.profile.bundles` 再重启——预设按包名解析那支策略插件,个别部署要求它显式列出。这条不影响「默认关闭」:加进 bundles 只是让插件可加载,策略仍只在会话 preset 为 `sansheng-liubu` 时才生效。 - -## 部门职责 - -- `lead`(丞相):统筹、决策、组队与管理型工具;调用须留痕。 -- `zhongshu`(中书省):调查与规划,只读。 -- `menxia`(门下省):准奏、封驳、验收与查账,只读。 -- `shangshu`(尚书省):任务依赖和分工调度,只读。 -- `libu`(吏部):Agent 与技能维护、成员编制与角色配置;只动技能、角色与配置文档,不开命令行。 -- `hubu`(户部):数据、表格与计算;依据真实数据给出可复算的结论,不补造数据。 -- `lipu`(礼部):文档、汇报、文案润色与可视化产出。 -- `bingbu`(兵部):环境运行、调试与部署,以及工具装配、发放、回收、登记、销账;只发不批。 -- `xingbu`(刑部):按风险开展的专项测试与独立验证;只跑不部署,不替代门下审议。 -- `gongbu`(工部/图像司):编码与工程实现;识图、OCR、截图与视觉分析;通过 `dsh-image-gen` 执行生图、批量生图和图片编辑。 - -执行部门常备 `read`、`write`、`edit`、`bash`、`grep`、`glob` 等工具;规划/审议部门保持只读。 - -## Image-gen 接管 - -上朝插件不再自行注册图片工具或读取图片 Provider 凭据,而是复用已安装的 `dsh-image-gen`: - -- `generate_image`:单张生图; -- `generate_images`:批量生图; -- `edit_image`:参考图与连续编辑。 - -三项工具只允许工部在已准奏且处于执行中的任务里调用。Provider、模型、API Key、Base URL、订阅登录、计费和结果保存均由 Image-gen 配置管理。`image_generate` 与 `codex_image_generate` 继续被上朝策略拒绝。 - -请在“插件 → 已安装 → dsh-image-gen”中配置并测试 Provider。修改插件配置或本模式后需彻底重启 DSH。 - -## 工具审核则例 - -1. 部门申请工具须写明用途、范围、期限;门下准奏后由兵部发放,限期使用,到期回收销账。 -2. 只读工具由门下专决;写入须注明 writeScopes;涉费、删除、全局配置须人工签字。 -3. `task_board_*`、`automation_*` 归丞相执掌并留痕;部门调用管理型工具须持门下准奏记录。 -4. 门下验收查账;越界者下次从严;工具不得转借。 - -## 验证 - -```powershell -node --check index.js -node --test --test-isolation=none test/policy.test.js panel/test/client.test.js -node scripts/check-install.mjs -``` - -`check-install.mjs` 会确认三件事:包自带 patch 是空层(不注册预设)、`preset.patch.yml` 能复现出同一个 preset id、以及你的 profile 当前到底有没有启用「上朝」(输出里的 `modeEnabled`)。 - -## 回滚 - -版本历史统一走 Git,不建备份目录、不留时间戳副本: - -```powershell -git log --oneline # 找目标提交 -git revert # 或 git reset --hard -``` - -回滚后重启 DSH。mode id 与 preset id 不变。 diff --git a/TODO.md b/TODO.md deleted file mode 100644 index 12307fc..0000000 --- a/TODO.md +++ /dev/null @@ -1,148 +0,0 @@ -# 三省六部开发 TODO - -更新日期:2026-11-07 - -当前阶段:角色与面板规划。以下勾选框表示实施是否完成,不表示方案是否确认。除特别注明外均为用户已确认、待实施;创建本文件不代表授权安装技能或修改运行配置。已有实验代码也不代表下面的新方案已实现。 - -## v0.1 与首次提交 - -- [ ] 先完成 TODO 规划,再进入 v0.1 实现;当前继续规划,不提前实施。 -- [ ] v0.1 实现完成并通过相应验证后,再创建首次 Git 提交。规划阶段和 v0.1 未完成前不提前提交;此前的 Git 初始化不等于首次提交。 - -## v1.0 优先级与后续 DS Bot 适配(2026-11-07 用户确认) - -当前优先顺序:先完成三省六部 v1.0 并验证可用,再开展 DS Bot 适配。本节更新版本推进顺序;上文 v0.1 与首次提交条目保留为历史规划,不代表当前仓库尚无实现或提交。本次仅记录待办,不代表 v1.0 或适配已经完成。 - -- [ ] 优先完成三省六部自身 v1.0:修复“开新朝堂”阻断问题,验证创建会话、组建成员、下旨、按需派工、结果回传与审核交付的完整链路。 -- [ ] v1.0 对齐本文已确认的角色与流程要求:六部职责、用户授权、审发分离、依赖调度、角色模型可配置与权限边界;统一代码版本、README、CHANGELOG 与 TODO 的实际状态。 -- [ ] v1.0 验收包含真实 DSH 宿主集成验证与关键失败路径;不能仅凭语法检查、安装检查或 Mock 单测通过宣称可用。 -- [ ] 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。 -- [ ] 中书省优先 GPT 系列,具体型号依据实际可用 API、规划质量与工具调用能力选择。 -- [ ] 门下省优先 Kimi 系列,具体型号依据审核能力和实际通道选择;需检查页面图像时核实图片输入支持。 -- [ ] 礼部优先支持图像输入的 Flash 模型,用户提出 MiMo Flash 或其他视觉 Flash 作为候选。不能仅凭 Flash 名称假定支持图像,接入前验证具体型号、API 图片传递和页面理解能力。 -- [ ] 图像理解与图像生成分别配置:礼部模型需能读取截图、图表与页面;需要生成或编辑图片时另用相应工具。 -- [ ] 各角色模型保持可手动切换,技能绑定角色而非模型;其余部门具体默认模型待确认,不把此前助手推荐当作已定配置。 - -## 面板与基础接口 - -- [ ] 从左侧导航打开三省六部页面;主对话在左、成员图在右,复用已安装 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 diff --git a/V1.0-工作台修复方案.md b/V1.0-工作台修复方案.md deleted file mode 100644 index 4c7fada..0000000 --- a/V1.0-工作台修复方案.md +++ /dev/null @@ -1,197 +0,0 @@ -# 三省六部 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 最终完成标准 - -用户始终留在三省六部工作台中,能完成“下任务 → 确认方案 → 按需执行 → 查看产出 → 指定部门修改”;会话不串线、消息不误投、失败不假报、模型配置真实生效、授权边界可验证、刷新后可恢复,并有当前宿主上的验证证据。 diff --git a/cordis.patch.yml b/cordis.patch.yml deleted file mode 100644 index e8329eb..0000000 --- a/cordis.patch.yml +++ /dev/null @@ -1,8 +0,0 @@ -# 三省六部模式:默认不注册任何东西。 -# -# 装上本包不会往 DSH 的模式选择器里塞「上朝」,也不会成为新会话的默认模式—— -# 想上朝时,把 preset.patch.yml 里的 insert 合并进 -# ~/.dsh/profiles/desktop/cordis.patch.yml -# 再彻底重启 DSH,新会话才能在模式选择器里看到并选择「上朝」。 -# 想退出:删掉那段 insert,重启即可;已存在的会话仍保留它自己的模式记录。 -[] diff --git a/docs/architecture-overview.md b/docs/architecture-overview.md new file mode 100644 index 0000000..b0169e9 --- /dev/null +++ b/docs/architecture-overview.md @@ -0,0 +1,148 @@ +# 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) + +详细手册给出各模块的职责、源码入口、数据与通信链路、运行依赖,以及源码存在和本机实测之间的区别。 diff --git a/docs/client-contract-research.md b/docs/client-contract-research.md new file mode 100644 index 0000000..2461943 --- /dev/null +++ b/docs/client-contract-research.md @@ -0,0 +1,106 @@ +# 三省六部 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) => void): () => void; + }): () => void; + on(id: string, handler: (scope: NativeScope, event: NativeEvent) => + NativeEffect[] | Promise): () => 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 配置、构建或设备验收。 diff --git a/docs/ds-bot-analysis.md b/docs/ds-bot-analysis.md new file mode 100644 index 0000000..ce7ce32 --- /dev/null +++ b/docs/ds-bot-analysis.md @@ -0,0 +1,279 @@ +# 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)。复用时应保留相应声明和来源,不把开源许可误当作无义务搬运。 + +本报告的结论是架构与实现边界,不是安全审计通过、性能测试通过或发布可用性背书。全部源码引用对应本工作区静态版本。 diff --git a/docs/host-contract-research.md b/docs/host-contract-research.md new file mode 100644 index 0000000..7f0a99b --- /dev/null +++ b/docs/host-contract-research.md @@ -0,0 +1,84 @@ +# 三省六部 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、跨项目拒绝。真实宿主验证须另行获授权,本轮未执行。 diff --git a/docs/implementation-status.md b/docs/implementation-status.md new file mode 100644 index 0000000..a6066fd --- /dev/null +++ b/docs/implementation-status.md @@ -0,0 +1,83 @@ +# 三省六部 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 或全局默认模型。 diff --git a/docs/openmausbot-analysis.md b/docs/openmausbot-analysis.md new file mode 100644 index 0000000..7001c9a --- /dev/null +++ b/docs/openmausbot-analysis.md @@ -0,0 +1,372 @@ +# 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,也不要把文档规划或注册项当成已经实测成功。 diff --git a/docs/panel-design.md b/docs/panel-design.md deleted file mode 100644 index d4c2c00..0000000 --- a/docs/panel-design.md +++ /dev/null @@ -1,171 +0,0 @@ -# 三省六部面板设计方案 - -日期: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. 验收标准 - -- 十席完整、无重复,吏部和礼部文字正确。 -- 未选中的部门也有清晰边框,不能看起来只是浮动文字。 -- 选中、运行、失败、未设官和键盘焦点可以区分。 -- 六部全部属于尚书省,不产生错误的上下级连线。 -- 统计使用实时投影,图片中的示例数字不会进入逻辑。 -- 窄栏没有横向溢出,名称与状态不被裁切。 -- 明亮与深色均可读,配置功能与会话入口保持可用。 -- 真实界面视觉检查和必要回归测试都通过;生成模拟图不能替代实际截图验收。 diff --git a/docs/panel-handoff.md b/docs/panel-handoff.md deleted file mode 100644 index ad884b4..0000000 --- a/docs/panel-handoff.md +++ /dev/null @@ -1,239 +0,0 @@ -# 三省六部面板:换环境开发交接方案 - -日期: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`,`@` 入口应静默不可用,但其余侧栏功能不能因此崩溃。 diff --git a/docs/preview/panel-nav-entry.png b/docs/preview/panel-nav-entry.png deleted file mode 100644 index 1939c24..0000000 Binary files a/docs/preview/panel-nav-entry.png and /dev/null differ diff --git a/docs/preview/panel-rail-entry.png b/docs/preview/panel-rail-entry.png deleted file mode 100644 index 2b39c9f..0000000 Binary files a/docs/preview/panel-rail-entry.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-320-light.png b/docs/preview/panel-sidebar-320-light.png deleted file mode 100644 index b8ffd89..0000000 Binary files a/docs/preview/panel-sidebar-320-light.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-360-light.png b/docs/preview/panel-sidebar-360-light.png deleted file mode 100644 index 6742e7c..0000000 Binary files a/docs/preview/panel-sidebar-360-light.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-371-light.png b/docs/preview/panel-sidebar-371-light.png deleted file mode 100644 index 62f02a9..0000000 Binary files a/docs/preview/panel-sidebar-371-light.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-440-dark.png b/docs/preview/panel-sidebar-440-dark.png deleted file mode 100644 index 9332f79..0000000 Binary files a/docs/preview/panel-sidebar-440-dark.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-440-light.png b/docs/preview/panel-sidebar-440-light.png deleted file mode 100644 index b7f163f..0000000 Binary files a/docs/preview/panel-sidebar-440-light.png and /dev/null differ diff --git a/docs/preview/panel-sidebar-tasks-440.png b/docs/preview/panel-sidebar-tasks-440.png deleted file mode 100644 index 24e9bb5..0000000 Binary files a/docs/preview/panel-sidebar-tasks-440.png and /dev/null differ diff --git a/docs/preview/v01-live-cancel-400-light.png b/docs/preview/v01-live-cancel-400-light.png deleted file mode 100644 index 0f0d9cf..0000000 Binary files a/docs/preview/v01-live-cancel-400-light.png and /dev/null differ diff --git a/docs/preview/v01-live-court-400-light.png b/docs/preview/v01-live-court-400-light.png deleted file mode 100644 index 027f485..0000000 Binary files a/docs/preview/v01-live-court-400-light.png and /dev/null differ diff --git a/docs/preview/v01-live-missing-400-light.png b/docs/preview/v01-live-missing-400-light.png deleted file mode 100644 index ea9035b..0000000 Binary files a/docs/preview/v01-live-missing-400-light.png and /dev/null differ diff --git a/docs/preview/v01-live-revise-400-light.png b/docs/preview/v01-live-revise-400-light.png deleted file mode 100644 index 253f92f..0000000 Binary files a/docs/preview/v01-live-revise-400-light.png and /dev/null differ diff --git a/docs/preview/v01-live-tasks-400-light.png b/docs/preview/v01-live-tasks-400-light.png deleted file mode 100644 index adfb92b..0000000 Binary files a/docs/preview/v01-live-tasks-400-light.png and /dev/null differ diff --git a/docs/preview/v01-nodes-400-dark.png b/docs/preview/v01-nodes-400-dark.png deleted file mode 100644 index fe0be2e..0000000 Binary files a/docs/preview/v01-nodes-400-dark.png and /dev/null differ diff --git a/docs/preview/v01-nodes-400-light.png b/docs/preview/v01-nodes-400-light.png deleted file mode 100644 index cbca6df..0000000 Binary files a/docs/preview/v01-nodes-400-light.png and /dev/null differ diff --git a/docs/preview/v01-workbench-rail-390-dark.png b/docs/preview/v01-workbench-rail-390-dark.png deleted file mode 100644 index 2065e6c..0000000 Binary files a/docs/preview/v01-workbench-rail-390-dark.png and /dev/null differ diff --git a/docs/preview/v01-workbench-rail-390-light.png b/docs/preview/v01-workbench-rail-390-light.png deleted file mode 100644 index b400e54..0000000 Binary files a/docs/preview/v01-workbench-rail-390-light.png and /dev/null differ diff --git a/docs/preview/v01-workbench-rail-400-dark.png b/docs/preview/v01-workbench-rail-400-dark.png deleted file mode 100644 index 2cb73aa..0000000 Binary files a/docs/preview/v01-workbench-rail-400-dark.png and /dev/null differ diff --git a/docs/preview/v01-workbench-rail-400-light.png b/docs/preview/v01-workbench-rail-400-light.png deleted file mode 100644 index 6ba9822..0000000 Binary files a/docs/preview/v01-workbench-rail-400-light.png and /dev/null differ diff --git a/docs/project-plan.md b/docs/project-plan.md new file mode 100644 index 0000000..9a3b0c6 --- /dev/null +++ b/docs/project-plan.md @@ -0,0 +1,48 @@ +# 三省六部项目规划 + +## 已确定范围 + +- 本 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 和会话导航公开接口。 diff --git a/docs/role-reports.md b/docs/role-reports.md new file mode 100644 index 0000000..fc69b4a --- /dev/null +++ b/docs/role-reports.md @@ -0,0 +1,20 @@ +# 十席职责汇报(本会话模型实跑) + +日期:2026-11-15。方式:以三省六部十席各自身份,用本会话所用模型分别独立跑一次(10 次独立角色调用), +每席第一人称汇报自己的职责。下方为各席原话。 + +> 说明:这是用本会话的模型做的角色演练;隔离测试 DSH 本身未配置模型,插件内那十个会话因此仍为空。 +> 二者不混淆:会话与绑定是插件真实能力,下面是同一模型分别“扮”十席得到的汇报。 + +| 部门 | 汇报(原话) | +|---|---| +| 丞相 | 我是丞相,负责面向用户承接想法:判断这件事是否需要开工,需要时把活派给具体部门,最后把各部门的结果汇总成一次交付给您。我不亲自下场做各部门的具体执行,也不越过它们去替部门定方案、改产物;我的边界是判断、分派与汇总。 | +| 中书 | 我是中书。我负责先把问题问清、把材料看全,再给出可执行的方案与验收标准草案,理清目标、约束和路径,供后续环节推进。我不直接产出最终交付物,也不越界替其他环节把活干完或替用户拍板。 | +| 尚书 | 我是尚书。我的职责是把已经明确的方案拆解为部门分工,并组织六部完成交付。我不参与方案的决策与改动,也不介入六部内部的执行细节;六部直属于尚书这个同级分组,六部之间是并列关系,并非上下级。 | +| 门下 | 我是门下。我负责对方案和交付做独立审议,逐项指出风险与不达标之处,并坚持:首版未经门下审核的任务必须如实标注“未审核”。我不参与具体方案设计与实施执行,也不替代任何一部做决策或背书。 | +| 吏部 | 我是吏部,负责就角色设置、技能配备与编制安排提出建议。我只做建议、不代为决策,也明确不绕过用户授权去改动权限或任何其他项目设置。 | +| 户部 | 我是户部,负责本项目中的数据、表格与计算工作,凡经我手的账目、口径与结论都须可复算、可追溯。我只做分内的数算与核对,不出方案、不定调子。 | +| 礼部 | 我是礼部,在本项目中负责文档、内容与呈现形式,并产出可编辑的源文件。我不参与非文档类事务的决策与执行。 | +| 兵部 | 我是兵部,专司环境、调试与部署一类事务。部署、发布这类会对外产生副作用的操作,我一律服从用户授权与宿主审批。 | +| 刑部 | 我是刑部,负责本项目的测试与风险检查,给出可追溯、可复核的检查结果,而不是一句“已通过”就交差。 | +| 工部 | 我是工部,负责代码实现与工程产出,交付可编辑的源文件和真实的检查结果。需求定夺、方案裁决与最终验收不在我的职责内。 | diff --git a/docs/v0.1-使用说明.md b/docs/v0.1-使用说明.md deleted file mode 100644 index f9b59b9..0000000 --- a/docs/v0.1-使用说明.md +++ /dev/null @@ -1,77 +0,0 @@ -# 三省六部工作台 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` 看 7 项自检;再确认重启是**彻底退出**而不是关窗口 | -| 派工后一直「已备好」 | 宿主没接上会话层:重启获取一次;右栏会提示「已记入台账,但暂时没有真的发出」 | -| 完全不想用了 | `node scripts/workbench-install.mjs off` 再重启 | - -账本在 `%USERPROFILE%\.dsh\sansheng-liubu\workbench.json`。它是唯一事实来源,删掉等于清空工作台;Git 回退代码不会回退它。 diff --git a/docs/v0.1-实施方案.md b/docs/v0.1-实施方案.md deleted file mode 100644 index f173a86..0000000 --- a/docs/v0.1-实施方案.md +++ /dev/null @@ -1,376 +0,0 @@ -# 三省六部独立工作台 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,不建备份副本。按照验收矩阵提供真实证据,未验证内容如实标注;涉及额外仓库写入、安装或发布时遵守对应授权边界。 diff --git a/docs/v0.1-宿主能力记录.md b/docs/v0.1-宿主能力记录.md deleted file mode 100644 index 7baef9a..0000000 --- a/docs/v0.1-宿主能力记录.md +++ /dev/null @@ -1,679 +0,0 @@ -# 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; -``` - -```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--`),带 `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; -``` - -```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; -``` - -```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>; -``` - -注意 **`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 = { 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>`(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; -// 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; -// 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; -// 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; -``` - -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`(sessions.d.ts:92 附近)与 `ISession.projections.faceOf(key): ObservableSnapshot`(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; -// lib/types/types.d.ts:459-463, :516-527 -interface SessionFollowRequest extends Pick { - 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

= (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 { - (options: RegisterFactoryOptions, component: SlotComponent>): () => void; -} -// RegisterFactoryOptions @ :522-526 -{ name: F; scope: FactoryDefOf['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 = (name: F, props: FactoryInputPropsOf, options?: { - slots?: Partial<{ [N in local]: FactoryLocalComponent }>; - 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`。 diff --git a/docs/v0.1-接线与契约.md b/docs/v0.1-接线与契约.md deleted file mode 100644 index b77ff20..0000000 --- a/docs/v0.1-接线与契约.md +++ /dev/null @@ -1,222 +0,0 @@ -# 三省六部工作台 · 新架构 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)。 diff --git a/docs/v0.1-验收记录.md b/docs/v0.1-验收记录.md deleted file mode 100644 index 01318c3..0000000 --- a/docs/v0.1-验收记录.md +++ /dev/null @@ -1,136 +0,0 @@ -# 三省六部独立工作台 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. 安装前端 bundle(已执行过一次,幂等): - -```bash -node scripts/workbench-install.mjs on # 写进 profile 的 dependencies + dsh.profile.bundles + node_modules junction -node scripts/workbench-install.mjs status # 期望 installed=true, targetExists=true -node scripts/workbench-preflight.mjs # 期望 7/7 通过:链接、入口、bundle 语法、12 条路由、账本可写 -``` - -> `workbench-preflight.mjs` 是只读自检:不装、不改配置,只回答「重启后会不会白屏 / 路由起不起得来」。 -> 它会真的创建 `%DSH_HOME%\sansheng-liubu` 目录(插件运行时本来也会建),除此之外不写任何东西。 - -2. **彻底退出 DSH 再启动**(托盘退出,不是关窗口);只对新会话生效。 -3. 打开任意项目会话,右侧应出现「朝堂 / 任务 / 成果」。 -4. 依次验:接通一个部门 → 派一条任务 → 完成 → 在成果区点「找主责部门修改」。 -5. 白屏逃生:控制台 `localStorage['sansheng.workbench.main']='off'` 后刷新,接管会被跳过。 -6. 完全回退:`node scripts/workbench-install.mjs off` 再重启。 - ---- - -## 4. 已知限制(不含未验证项) - -- **L1** 账本损坏时改名隔离(`.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 变化要写显式迁移,不静默丢弃旧账本。 diff --git a/docs/v1-plan.md b/docs/v1-plan.md new file mode 100644 index 0000000..7f6b9b8 --- /dev/null +++ b/docs/v1-plan.md @@ -0,0 +1,93 @@ +# 三省六部第一版方案 + +状态: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 和会话都未改动。 diff --git a/icon.svg b/icon.svg deleted file mode 100644 index 2131061..0000000 --- a/icon.svg +++ /dev/null @@ -1,13 +0,0 @@ - - - - - - - - - - - - - diff --git a/index.js b/index.js deleted file mode 100644 index 132f2b6..0000000 --- a/index.js +++ /dev/null @@ -1,455 +0,0 @@ -import fs from 'node:fs' -import os from 'node:os' -import path from 'node:path' -import { createWorkbenchHost, resolveStorePath } from './workbench/host/index.mjs' - -const PRESET_ID = 'sansheng-liubu' -export const POLICY_VERSION = '0.4.0' - -/** - * 默认不强制任何 provider/model:宿主未必注册了这些适配器,强行指定会让整轮请求 - * 以 NO_ADAPTER 失败(例如 "no adapter registered for provider xiaomi")。 - * 角色模型改由面板里的「联动模型」按当前宿主目录选择,或在 preset 配置里显式给 routes。 - */ -export const DEFAULT_ROUTES = Object.freeze({}) - -/** 三省六部:丞相 1 + 三省 3 + 六部 6 = 10 席;六部为吏、户、礼、兵、刑、工。 */ -export const COURT_ROLES = Object.freeze([ - 'lead', 'zhongshu', 'menxia', 'shangshu', - 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu', -]) -const KNOWN_ROLES = new Set(['zhongshu', 'menxia', 'shangshu', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu']) -const READ_ONLY_ROLES = new Set(['lead', 'zhongshu', 'menxia', 'shangshu', 'minister']) -const EXECUTION_ROLES = new Set(['libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu']) -const IMAGE_TOOLS = new Set(['generate_image', 'generate_images', 'edit_image']) -const FORBIDDEN_IMAGE_TOOLS = new Set(['image_generate', 'codex_image_generate']) -export const READ_ONLY_TOOLSET = Object.freeze(['read', 'grep', 'glob']) -export const EXECUTION_TOOLSET = Object.freeze(['read', 'write', 'edit', 'bash', 'pwsh', 'grep', 'glob']) - -const MANAGEMENT_TOOL_PREFIXES = Object.freeze(['task_board_', 'automation_']) -const OTHER_MANAGEMENT_TOOLS = new Set(['create_skill', 'plugin_manager']) -const HUMAN_SIGNATURE_TOOLS = new Set([ - 'create_skill', 'plugin_manager', 'remote_ssh_delete', 'automation_delete', -]) -const MUTATING_TOOLS = new Set([ - 'write', 'edit', 'pwsh', 'bash', - 'remote_ssh_write', 'remote_ssh_mkdir', 'remote_ssh_exec', - 'ws_mcp_call', ...IMAGE_TOOLS, -]) - -/** - * 六部各自可改什么,按职责划线,不互相借用: - * - 吏部:技能与角色文件(.md/.json/.yml 等),不开命令行,避免改代码或环境。 - * - 户部:数据文件(xlsx/csv/parquet 等);重算与渲染交 Office/Univer 工具,故不开命令行。 - * - 礼部:文档、汇报与截图等材料产出。 - * - 兵部:跑命令、定位问题,另含远程与 MCP 通道。 - * - 刑部:测试与专项验证,只跑不部署;远程命令会绕过风险分级,因此不给。 - * - 工部:代码实现,含 Image-gen 生图。 - */ -const ROLE_ALLOWED_MUTATIONS = Object.freeze({ - libu: new Set(['write', 'edit']), - hubu: new Set(['write', 'edit']), - lipu: new Set(['write', 'edit', 'pwsh', 'bash']), - bingbu: new Set([ - 'write', 'edit', 'pwsh', 'bash', - 'remote_ssh_write', 'remote_ssh_mkdir', 'remote_ssh_exec', 'ws_mcp_call', - ]), - xingbu: new Set(['write', 'edit', 'pwsh', 'bash']), - gongbu: new Set(['write', 'edit', 'pwsh', 'bash', ...IMAGE_TOOLS]), -}) - -const TOOL_GOVERNANCE = `## 工具开放审核则例 -一、凡部门需用工具,须奏明用途、范围、期限,经门下省审核,准奏后由兵部发放,限期使用,到期收回销账。 -二、只读之具,门下可专决;改易文件者,须注明写入范围;涉费、删除、全局配置者,须人工签字。 -三、兵部掌武库:工具装配、发放、回收、登记,只发不批;管理型工具(task_board_*、automation_*)与付费开关归丞相执掌,用时留痕;执行部门常备文件读写、命令行、测试之具。 -四、门下验收查账,越界者下次从严;所授之具不得转借。` - -const LEAD_PROMPT = `# 三省六部模式:丞相 - -你是本会话的丞相,也是 Agent Team Lead。你直接面向用户,负责定策、组队、监督制度执行与最终回奏;不要亲自修改文件。 - -## 固定组织(三省六部十席) -- zhongshu(中书省):调查现状、澄清需求、起草方案,只读。 -- menxia(门下省):独立审议、准奏或封驳,并在执行后验收,只读。 -- shangshu(尚书省):把批准方案转成任务依赖、按吏户礼兵刑工六部分工,只读。 -- libu(吏部):Agent 与技能维护,只动技能、角色与配置文档。 -- hubu(户部):数据、表格与计算,负责真实数据与可复算的结论。 -- lipu(礼部):文档、汇报与可视化产出。 -- bingbu(兵部):环境运行、调试与部署,掌工具装配、发放、回收、登记与销账,只发不批。 -- xingbu(刑部):按风险做专项测试与独立验证,只跑不部署。 -- gongbu(工部):编码与工程实现,负责落盘改动、构建与安装脚本。 - -## 强制流程 -1. 对实质性任务,先创建 zhongshu、menxia、shangshu;成员名必须完全使用上述英文 id。 -2. 在共享任务板建立“中书拟案”→“门下审议”→“尚书派工”→执行任务→“尚书合成”→“门下审核”的依赖链。 -3. 中书提交可执行方案和验收标准;门下只能输出准奏或封驳,封驳必须给出阻塞问题;审议默认一轮。 -4. 门下准奏前不得进入执行。准奏后先向用户回奏「方案 + 审议结论 + 拟派分工」,取得用户明确确认(“准奏”“开始”“可以”等)后,才让尚书派工;六部成员(libu、hubu、lipu、bingbu、xingbu、gongbu)只有 Lead 能创建,且只召集本任务真正用到的部门,不得为凑齐六部而拆分。 -5. 每个执行部门必须先领取自己的 in_progress 任务;写入范围写进 writeScopes,依赖必须全部完成;执行完先自检再上缴。 -6. 六部完成后由尚书合成一份整体结果,再交门下按验收标准审核;审核失败时,执行部门修复一次,再次失败则如实报告并请求用户决定。 -7. 回复用户前必须等待所有必需成员完成,最终使用“丞相回奏”格式汇总方案、审议、执行、验证和风险;若只有部分成果通过,必须附「部分 → 主责部门」清单,写清哪一部门未交付及原因。 - -${TOOL_GOVERNANCE} - -禁止调用 GPT 模型或 codex_image_generate。` - -const ROLE_PROMPTS = Object.freeze({ - zhongshu: `# 中书省职责 -你负责调查、规划和任务拆解。只读,不得修改文件或运行有副作用的命令。先读取实际项目与约束,再产出:目标、非目标、任务 DAG、writeScopes、风险和验收标准。将结果发送给丞相与门下省。收到封驳后只针对阻塞问题修订。\n\n${TOOL_GOVERNANCE}`, - menxia: `# 门下省职责 -你是独立审核者,只读,不得替中书改方案或替执行部门实施。审议必须给出 verdict=approve|reject、blockingIssues、risks、acceptanceCriteria。存在阻塞问题必须封驳;准奏时完成“门下审议”任务。执行后查验工具发放、使用、回收与销账记录,并依据验收标准检查证据;验收对象是尚书合成的整体结果,六部须先自检再上缴。\n\n${TOOL_GOVERNANCE}`, - shangshu: `# 尚书省职责 -你只负责调度设计,不直接写文件,也不能创建 teammate。把门下批准的方案转成共享任务、依赖、负责人建议和互不重叠的 writeScopes;按吏户礼兵刑工的职责分工,通知丞相创建本任务真正需要的六部成员。跟踪状态、汇总异常,并在所需部门完成或部分完成后合成一份整体结果(含未完成项与主责部门)交门下审核。只调用必要的部门:一个部门能完成的不要拆给多个部门,同类小任务合并派工。\n\n${TOOL_GOVERNANCE}`, - libu: `# 吏部职责 -你负责 Agent 与技能维护:技能设计与评估、角色配置与成员编制文档。可用的写入工具限于此范围,不写业务代码、不跑命令行、不改数据。仅当新增或实质改进技能时才安排评测,普通配置修改不启动多代理基准测试;不擅自更换模型或扩大权限。实施前领取自己的任务并确认 blocker 已完成,仅改声明的 writeScopes,完成后提交改动清单与自检结果。\n\n常备工具:write、edit、read、grep、glob。\n\n${TOOL_GOVERNANCE}`, - hubu: `# 户部职责 -你负责数据与计算:表格、数据文件、统计与可复算的结论。可用的写入工具只用于数据文件;读取、重算与渲染交宿主提供的 Office / Univer 工具,不跑命令行。依据实际数据选择统计方法,不把表格操作等同于统计验证,不补造数据;无法核实时如实标注未核实。实施前领取自己的任务并确认 blocker 已完成,完成后提交数据来源、口径与复算方式。\n\n常备工具:write、edit、read、grep、glob。\n\n${TOOL_GOVERNANCE}`, - lipu: `# 礼部职责 -你负责文档、汇报、文案润色与可视化产出,包括 README、变更记录与演示材料。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。完成后向丞相和门下提交成稿与自检结果。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`, - bingbu: `# 兵部职责 -你负责环境运行、调试与部署,并掌武库:工具装配、发放、回收、登记、销账,只发不批。实施前读取任务、领取任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。先复现再定位,运行适用命令与测试,报告复现步骤、根因、修复文件、测试结果、工具台账和剩余风险。部署发布须在授权范围内。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`, - xingbu: `# 刑部职责 -你负责按风险开展的专项测试与独立验证,不承担门下成品审议,也不部署。采用复现定位与有效测试设计:给出问题位置、证据与影响,不越权修改他部成果;修复由主责部门完成。不是每项任务都必经你手,只在风险需要时受派。实施前领取自己的任务并确认 blocker 已完成;仅修改声明的 writeScopes(测试代码与报告)。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`, - gongbu: `# 工部职责 -你负责代码实现、构建、安装脚本与文件落地。实施前领取自己的任务并确认所有 blocker 已完成;仅修改声明的 writeScopes。先读后改,改完运行适用的构建或测试命令,报告修改文件、执行结果和剩余风险。\n\n常备工具:${EXECUTION_TOOLSET.join('、')}。\n\n${TOOL_GOVERNANCE}`, - minister: `# 执行成员职责 -你是三省六部团队中的临时成员。服从丞相调度,先领取任务并尊重依赖与 writeScopes;不要绕过门下审核。\n\n${TOOL_GOVERNANCE}`, -}) - -export function roleFromMembership(membership) { - // A normal newly-created preset session has no Agent Team membership yet. - // Treat that primary/default agent as the Chancellor so users converse with - // the Lead immediately, before the Chancellor creates the remaining court. - if (!membership) return 'lead' - if (membership.role === 'lead') return 'lead' - const name = String(membership.name || '').trim().toLowerCase() - return KNOWN_ROLES.has(name) ? name : 'minister' -} - -export function routeForRole(role, routes = DEFAULT_ROUTES) { - if (!routes) return undefined - return routes[role] ?? routes.minister -} - -export function toolsetForRole(role) { - return EXECUTION_ROLES.has(role) ? [...EXECUTION_TOOLSET] : [...READ_ONLY_TOOLSET] -} - -function hasExecutableAssignment(role, tasks) { - const byId = new Map(tasks.map(task => [task.id, task])) - return tasks.some(task => task.status === 'in_progress' && task.ownerName === role && - (task.blockedBy ?? []).every(id => byId.get(id)?.status === 'completed')) -} - -function managementApproval(role, toolName, tasks, now = Date.now()) { - return tasks.find(task => { - const approval = task?.approval - if (task.status !== 'in_progress' || task.ownerName !== role || !approval) return false - if (approval.reviewer !== 'menxia' || approval.verdict !== 'approve') return false - if (!approval.purpose || !approval.scope || !approval.expiresAt) return false - if (Date.parse(approval.expiresAt) <= now) return false - return Array.isArray(approval.tools) && approval.tools.some(entry => entry === toolName || - (entry.endsWith('*') && toolName.startsWith(entry.slice(0, -1)))) - }) -} - -function isManagementTool(toolName) { - return OTHER_MANAGEMENT_TOOLS.has(toolName) || MANAGEMENT_TOOL_PREFIXES.some(prefix => toolName.startsWith(prefix)) -} - -export function evaluateToolPolicy(role, toolName, tasks = [], options = {}) { - const audit = typeof options.audit === 'function' ? options.audit : () => {} - if (FORBIDDEN_IMAGE_TOOLS.has(toolName)) return `上朝模式只允许使用 Image-gen 工具,不得调用 ${toolName}。` - const destructiveBoardAction = toolName === 'task_board_manage' && options.args?.action === 'delete' - if ((HUMAN_SIGNATURE_TOOLS.has(toolName) || destructiveBoardAction) && options.humanSigned !== true) { - return `${toolName} 涉及删除或全局配置,须先取得人工签字。` - } - if (isManagementTool(toolName)) { - if (role === 'lead') { - audit({ action: 'management-tool', role, toolName, decision: 'allow', authority: 'chancellor' }) - return undefined - } - const approval = managementApproval(role, toolName, tasks, options.now) - if (!approval) return `${role} 调用管理型工具 ${toolName} 前须提交用途、范围、期限,并取得门下省准奏记录。` - audit({ action: 'management-tool', role, toolName, decision: 'allow', approvalId: approval.id }) - return undefined - } - if (!MUTATING_TOOLS.has(toolName)) return undefined - if (READ_ONLY_ROLES.has(role)) return `${role} 是只读规划、审核或调度角色,不得调用写入型工具 ${toolName}。` - if (!EXECUTION_ROLES.has(role)) return `${role} 不是获准的执行部门,不能调用 ${toolName}。` - if (!ROLE_ALLOWED_MUTATIONS[role]?.has(toolName)) return `${toolName} 不属于 ${role} 的职责范围。` - if (!hasExecutableAssignment(role, tasks)) return `${role} 尚未准奏:请先领取一个 in_progress 且所有 blocker 已完成的共享任务。` - return undefined -} - -function rolePrompt(role) { return role === 'lead' ? LEAD_PROMPT : ROLE_PROMPTS[role] ?? ROLE_PROMPTS.minister } - -function normalizeRoutes(routes = {}) { - const merged = { ...DEFAULT_ROUTES } - for (const [role, route] of Object.entries(routes)) { - if (!route || typeof route !== 'object') continue - if (typeof route.provider !== 'string' || typeof route.model !== 'string') continue - merged[role] = { provider: route.provider, model: route.model, - ...(typeof route.reasoningEffort === 'string' ? { reasoningEffort: route.reasoningEffort } : {}) } - } - return merged -} - -/** - * 面板上的「部门模型」走这条指令:宿主的 session.selectModel 会拒绝子会话 - * (`session.header.origin === "subagent"` → session/agent-busy),所以部门模型 - * 只能由本插件在 agent/request 时改,面板则用 /dept-model 把选择下发过来。 - */ -export const DEPT_MODEL_COMMAND = 'dept-model' -export const DEPT_MODEL_USAGE = '<部门> [推理等级] | list | clear [部门]' - -export function routesFilePath(env = process.env) { - const home = typeof env.DSH_HOME === 'string' && env.DSH_HOME.trim() ? env.DSH_HOME.trim() : path.join(os.homedir(), '.dsh') - return path.join(home, 'sansheng-liubu', 'routes.json') -} - -export function readStoredRoutes(file) { - try { - const parsed = JSON.parse(fs.readFileSync(file, 'utf8')) - return normalizeRoutes(parsed && typeof parsed === 'object' ? parsed : {}) - } catch (error) { return {} } -} - -export function writeStoredRoutes(file, routes) { - try { - fs.mkdirSync(path.dirname(file), { recursive: true }) - fs.writeFileSync(file, JSON.stringify(routes, null, 2) + '\n', 'utf8') - return true - } catch (error) { return false } -} - -export function parseDeptModelCommand(rawInput) { - const tokens = String(rawInput === undefined || rawInput === null ? '' : rawInput).trim().split(/\s+/).filter(Boolean) - if (tokens.length === 0 || tokens[0].toLowerCase() === 'list') return { action: 'list' } - const head = tokens[0].toLowerCase() - if (head === 'clear' || head === 'reset') { - const role = (tokens[1] || '').toLowerCase() - if (role && !COURT_ROLES.includes(role)) return { action: 'error', reason: `未知部门:${tokens[1]}` } - return { action: 'clear', role: role || undefined } - } - if (!COURT_ROLES.includes(head)) return { action: 'error', reason: `未知部门:${tokens[0]}(可用:${COURT_ROLES.join('、')})` } - if (tokens.length < 3) return { action: 'error', reason: `用法:/${DEPT_MODEL_COMMAND} ${DEPT_MODEL_USAGE}` } - const reasoningEffort = tokens[3] - return { - action: 'set', - role: head, - route: { provider: tokens[1], model: tokens[2], ...(reasoningEffort ? { reasoningEffort } : {}) }, - } -} - -export function describeDeptRoutes(routes = {}) { - const entries = Object.entries(routes).filter(([, route]) => route && route.provider && route.model) - if (entries.length === 0) return `十席目前都跟随宿主默认模型;用 /${DEPT_MODEL_COMMAND} ${DEPT_MODEL_USAGE} 逐个固定。` - return '部门固定模型:' + entries - .map(([role, route]) => `${role}=${route.provider}/${route.model}${route.reasoningEffort ? '·' + route.reasoningEffort : ''}`) - .join(';') -} - -function registerDeptModelCommand(ctx, handler) { - if (!ctx.commands || typeof ctx.commands.register !== 'function') return () => {} - try { - const dispose = ctx.effect(function* () { - yield ctx.commands.register({ - name: DEPT_MODEL_COMMAND, - description: '固定某个部门的模型(面板「模型设置」用)', - input: { hint: DEPT_MODEL_USAGE }, - handler: invocation => handler(invocation && invocation.rawInput), - }) - }, `sansheng-liubu: /${DEPT_MODEL_COMMAND}`) - return typeof dispose === 'function' ? dispose : () => {} - } catch (error) { - ctx.logger?.warn?.(`[sansheng-liubu] 注册 /${DEPT_MODEL_COMMAND} 失败:${error && error.message ? error.message : error}`) - return () => {} - } -} - -const INSTALLATIONS = globalThis[Symbol.for('dsh.sansheng-liubu.installations')] ??= - new WeakMap() - -/** - * 工作台是“整台机器一份”,不是“每个 agent 一份”:同一份账本只能有一个写者。 - * 但本插件的 apply 可能被多次调用(每个组合了「上朝」预设的 agent 各一次), - * 所以按账本路径引用计数:最后一个卸载时才真的 dispose,中途不重复建 store。 - */ -const WORKBENCH = globalThis[Symbol.for('dsh.sansheng-liubu.workbench')] ??= new Map() - -/** - * 只有真的跑在宿主里才建工作台:单测用 mock ctx 调 apply() 时不该往 - * %DSH_HOME% 写账本、也不该起对账计时器。cordis 的 Context 一定有 get()。 - */ -function hostSurfaceAvailable(ctx) { - if (!ctx) return false - if (typeof ctx.get === 'function') return true - return Boolean(ctx.webServer || ctx.sessionController || ctx.remote) -} - -function acquireWorkbench(ctx, presetId, log) { - if (!hostSurfaceAvailable(ctx)) return null - let file = null - try { - file = resolveStorePath(process.env) - } catch { - // 拿不到路径就退回内存账本,不能因为一个路径算不出来就让政策插件加载失败。 - file = null - } - const key = file ?? '(memory)' - const existing = WORKBENCH.get(key) - if (existing) { - existing.refs += 1 - return existing - } - const entry = { refs: 1, host: null, key } - try { - // 挂在 root 上:工作台属于整个应用,不该随某个 agent 的销毁一起消失。 - entry.host = createWorkbenchHost(ctx?.root ?? ctx, { presetId }) - for (const warning of entry.host.warnings ?? []) log?.(warning) - log?.(`账本 ${entry.host.file};接口${entry.host.registered ? '已注册' : '未注册'};` - + `会话层${entry.host.hasSessions ? '可用' : '不可用(派发只落账)'}`) - } catch (error) { - log?.(`工作台启动失败:${error?.message ?? error}`) - entry.host = null - } - WORKBENCH.set(key, entry) - return entry -} - -function releaseWorkbench(entry) { - if (!entry || entry !== WORKBENCH.get(entry.key)) return - entry.refs -= 1 - if (entry.refs > 0) return - WORKBENCH.delete(entry.key) - try { - entry.host?.dispose?.() - } catch { - // 卸载失败不影响插件卸载;下次启动仍会从同一个账本继续。 - } -} - -export const name = 'sansheng-liubu-mode' -export const inject = ['agents', 'agentTeams', 'agentPresets', 'systemPrompt', 'tools', 'commands'] - -export function apply(ctx, config = {}) { - const presetId = typeof config.presetId === 'string' ? config.presetId : PRESET_ID - const routeFile = routesFilePath() - const routes = normalizeRoutes({ ...readStoredRoutes(routeFile), ...(config.routes || {}) }) - const owned = new Map() - const audit = entry => ctx.logger?.info?.(`[sansheng-liubu:audit] ${JSON.stringify({ at: new Date().toISOString(), ...entry })}`) - - // 工作台:账本 + 部门会话 + HTTP 接口。整体失败只记日志,不能让政策插件加载不了—— - // 「上朝」的 prompt/工具策略是刚需,工作台是增量能力。 - const logWorkbench = message => { - try { - ctx.logger?.info?.(`[sansheng-liubu:workbench] ${message}`) - } catch { - /* 日志失败不影响业务 */ - } - } - const workbench = acquireWorkbench(ctx, presetId, logWorkbench) - - const persist = () => { - if (writeStoredRoutes(routeFile, routes)) return - ctx.logger?.warn?.(`[sansheng-liubu] 路由表写入失败:${routeFile}`) - } - - const runDeptModel = rawInput => { - const parsed = parseDeptModelCommand(rawInput) - if (parsed.action === 'error') return { kind: 'error', text: parsed.reason } - if (parsed.action === 'list') return { kind: 'success', text: describeDeptRoutes(routes) } - if (parsed.action === 'clear') { - if (parsed.role) delete routes[parsed.role] - else for (const role of Object.keys(routes)) delete routes[role] - persist() - return { - kind: 'success', - text: parsed.role ? `${parsed.role} 已恢复跟随宿主默认模型。` : '十席都已恢复跟随宿主默认模型。', - } - } - routes[parsed.role] = parsed.route - persist() - const effort = parsed.route.reasoningEffort ? `(推理等级 ${parsed.route.reasoningEffort})` : '' - return { - kind: 'success', - text: `${parsed.role} 已固定为 ${parsed.route.provider}/${parsed.route.model}${effort},该部门下一轮开工即生效。`, - } - } - const disposeCommand = registerDeptModelCommand(ctx, runDeptModel) - - const uninstall = agent => { - const release = owned.get(agent) - if (!release) return - owned.delete(agent) - release() - } - - const install = agent => { - if (owned.has(agent)) return - if (ctx.agentPresets.composedPreset(agent.ctx) !== presetId) return - const membership = ctx.agentTeams.tryMembership(agent) - const role = roleFromMembership(membership) - if (!role) return - - const existing = INSTALLATIONS.get(agent) - if (existing) { - existing.refs += 1 - owned.set(agent, () => { - existing.refs -= 1 - if (existing.refs === 0) { existing.dispose(); INSTALLATIONS.delete(agent) } - }) - return - } - - const scoped = agent.ctx - const dispose = scoped.effect(() => { - const disposers = [] - try { - disposers.push(scoped.systemPrompt.section({ - name: 'sansheng-liubu:role', - order: scoped.systemPrompt.getSectionOrder('TEAM_POLICY') + 1, - text: rolePrompt(role), - })) - disposers.push(scoped.on('agent/request', async (_payload, next) => { - const resolved = await next() - const route = routeForRole(role, routes) - if (!route) return resolved - const { reasoningEffort: _oldEffort, ...base } = resolved - return { ...base, provider: route.provider, model: route.model, - ...(route.reasoningEffort ? { reasoningEffort: route.reasoningEffort } : {}) } - }, { prepend: true })) - disposers.push(scoped.tools.guard(execution => { - const tasks = ctx.agentTeams.listTasks(agent) - return evaluateToolPolicy(role, execution.name, tasks, { - audit, - humanSigned: execution?.approval?.humanSigned === true || execution?.humanSigned === true, - args: execution?.args, - }) - })) - } catch (error) { - for (const cleanup of disposers.reverse()) cleanup() - throw error - } - return () => { for (const cleanup of disposers.reverse()) cleanup() } - }) - const shared = { refs: 1, dispose } - INSTALLATIONS.set(agent, shared) - owned.set(agent, () => { - shared.refs -= 1 - if (shared.refs === 0) { shared.dispose(); INSTALLATIONS.delete(agent) } - }) - } - - for (const agent of ctx.agents.list()) install(agent) - const disposeCreated = ctx.on('agent/created', ({ agent }) => install(agent)) - const disposeDisposed = ctx.on('agent/disposed', ({ agent }) => uninstall(agent)) - - return () => { - disposeCommand() - disposeCreated() - disposeDisposed() - for (const agent of [...owned.keys()]) uninstall(agent) - releaseWorkbench(workbench) - } -} diff --git a/locale/en.json b/locale/en.json deleted file mode 100644 index 3717007..0000000 --- a/locale/en.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "meta": { - "title": "Imperial Court", - "description": "A Chancellor-led multi-agent mode for planning, review, dispatch, visual work, writing, and coding." - } -} diff --git a/locale/zh.json b/locale/zh.json deleted file mode 100644 index f88f078..0000000 --- a/locale/zh.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "meta": { - "title": "上朝", - "description": "丞相统筹的多 Agent 协作模式,提供规划、审核、调度、图像、写作和代码能力。" - } -} diff --git a/package.json b/package.json deleted file mode 100644 index 893b315..0000000 --- a/package.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "name": "dsh-sansheng-liubu-mode", - "version": "0.9.2", - "private": true, - "description": "上朝:丞相统筹的三省六部多 Agent 模式", - "type": "module", - "main": "./index.js", - "exports": { - ".": "./index.js", - "./package.json": "./package.json", - "./locale/*.json": "./locale/*.json" - }, - "files": [ - "index.js", - "cordis.patch.yml", - "preset.patch.yml", - "icon.svg", - "locale/*.json", - "README.md", - "CHANGELOG.md", - "panel/**", - "panel/test", - "scripts", - "locale" - ], - "icon": "./icon.svg", - "dsh": { - "manifestVersion": 1, - "bundle": { - "patch": "./cordis.patch.yml" - } - }, - "scripts": { - "test": "node --test --test-isolation=none test/policy.test.js panel/test/client.test.js", - "check:install": "node scripts/check-install.mjs", - "mode": "node scripts/mode.mjs", - "preview": "node scripts/preview.mjs" - }, - "license": "MIT" -} diff --git a/panel/README.md b/panel/README.md deleted file mode 100644 index 6a34123..0000000 --- a/panel/README.md +++ /dev/null @@ -1,39 +0,0 @@ -# dsh-sansheng-liubu-panel - -三省六部 Agent Team 的 DSH Web 客户端面板。它是独立插件包,避免与 `dsh-sansheng-liubu-mode` 的预设宿主插件重复加载。 - -## 功能 - -- 在会话头部显示当前团队成员数。 -- 朝堂编制与任务流转收进会话右侧栏,用「朝堂 / 任务」页签切换;不再占用工作区主视图。 -- 右侧栏顶部提供协作状态、`输入 @ 选择部门` 提示和子会话返回按钮;四个统计卡固定在侧栏内,可点击切换朝堂或任务。 -- 朝堂图按丞相、三省、六部分层展示;选中部门后在侧栏下方配置模型、推理等级或进入其会话。 -- 在 DSH 原生会话输入框输入 `@`,可直接选择已设官的部门并进入其子会话发送任务;不另造聊天框,也不会静默改写接收人。 -- 进入部门子会话后侧栏自动选中对应部门;返回丞相主会话时恢复丞相选中。 -- 复用 DSH 主题变量,支持明亮、深色和窄侧栏布局。 - -面板只读 `agentTeam` 投影并复用现有 `uiWorkspace.openSession`,不创建 Agent、不调用工具、不改变权限边界。 - -## 安装 - -在 DSH profile 的 `package.json` 中加入: - -```json -"dependencies": { - "dsh-sansheng-liubu-panel": "link:C:/Users/qyh15/三省六部/panel" -}, -"dsh": { - "profile": { - "bundles": ["dsh-sansheng-liubu-panel"] - } -} -``` - -安装后需要重启 DSH Host,再刷新 Web 页面。客户端 bundle 会在页面启动时由 `dsh-client-modules` 组合;只刷新页面不会让 Host 重新扫描新插件。 - -## 验证 - -```bash -node --test --test-isolation=none panel/test/client.test.js -node ../scripts/check-install.mjs -``` diff --git a/panel/cordis.patch.yml b/panel/cordis.patch.yml deleted file mode 100644 index fb6d3eb..0000000 --- a/panel/cordis.patch.yml +++ /dev/null @@ -1,4 +0,0 @@ -# 三省六部 Agent 面板:只加载 Web 客户端 bundle,不参与 Agent 策略。 -- insert: - - id: sansheng-agent-panel - name: dsh-sansheng-liubu-panel diff --git a/panel/index.js b/panel/index.js deleted file mode 100644 index 56ab657..0000000 --- a/panel/index.js +++ /dev/null @@ -1,32 +0,0 @@ -// 三省六部:Host 侧桥接。 -// -// 浏览器不能直接创建 Agent(Agent Teams 只有 Lead 通过模型工具才能组建), -// 所以“组建朝班”走一条受控路径:面板把请求写进当前会话的草稿并通知用户发送, -// 或者(在有该能力时)直接投递一条预置指令给丞相会话。 -// -// 这里同时导出可测试的纯函数,供 panel/test 直接调用,不依赖 cordis 运行时。 - -export const PRESET_ID = 'sansheng-liubu' - -/** 组建朝班的指令:丞相据此创建三省,再由尚书创建六部。 */ -export function formationPrompt(roles = ['zhongshu', 'menxia', 'shangshu']) { - const names = roles.join('、') - return [ - '【上朝】请按三省六部流程组建朝班:', - `1. 立即创建 ${names} 三个部门成员(spawn_teammate),角色名必须与上述名称完全一致。`, - '2. 在共享任务板上建立:中书拟案 → 门下审议 → 尚书派工 的任务链,写清各自的 writeScopes。', - '3. 门下准奏后,由尚书按职责分派:吏部(Agent 与技能维护)、户部(数据与计算)、礼部(内容与呈现)、兵部(环境运行与部署)、刑部(按风险专项测试)、工部(开发实现);只召集本任务真正用到的部门,角色名为 libu/hubu/lipu/bingbu/xingbu/gongbu。', - '4. 每个阶段完成后向我汇报,得到我确认再进入下一阶段。', - ].join('\n') -} - -/** 下旨文本:面板里选部门 + 输入指令时使用。 */ -export function decreePrompt(role, text) { - const body = String(text ?? '').trim() - if (body === '') return '' - return `【丞相下旨 · ${role}】\n${body}` -} - -export function apply() { - // 面板完全在浏览器侧运行;Host 侧不需要注册服务,保留空实现让 Loader 能正常加载。 -} diff --git a/panel/lib/client.js b/panel/lib/client.js deleted file mode 100644 index 120e890..0000000 --- a/panel/lib/client.js +++ /dev/null @@ -1,2095 +0,0 @@ -window.__ModuleLoader__.load({ - id: "dsh-sansheng-liubu-panel", - factory: (require) => { - var module = { exports: {} }; - var exports = module.exports; - Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" }); - - const React = require("react"); - const h = React.createElement; - - // #region 常量与纯函数(与 lib/model.js 保持一致,客户端 bundle 需自包含) - const PANEL_ID = "sansheng-liubu"; - const SANSENG_TAB_ID = PANEL_ID + "-tab"; - const SANSENG_TAB_KIND = "sansheng"; - - const ROLE_IDS = ["lead", "zhongshu", "menxia", "shangshu", "libu", "hubu", "lipu", "bingbu", "xingbu", "gongbu"]; - const ROLE_LABELS = { - lead: "丞相", - zhongshu: "中书省", - menxia: "门下省", - shangshu: "尚书省", - libu: "吏部", - hubu: "户部", - lipu: "礼部", - bingbu: "兵部", - xingbu: "刑部", - gongbu: "工部", - }; - const ROLE_MARKS = { - lead: "丞", - zhongshu: "中", - menxia: "门", - shangshu: "尚", - libu: "吏", - hubu: "户", - lipu: "礼", - bingbu: "兵", - xingbu: "刑", - gongbu: "工", - }; - const ROLE_DUTIES = { - lead: "统筹全局、向用户汇报、最终交付", - zhongshu: "拟案规划,拆解任务与验收标准", - menxia: "审议准奏与交付验收,可否决", - shangshu: "派工调度,合成各部门成果", - libu: "Agent 与技能维护、成员编制", - hubu: "数据、表格与计算,可复算结论", - lipu: "文档、汇报与可视化产出", - bingbu: "环境运行、调试与部署,掌武库", - xingbu: "按风险的专项测试与独立验证", - gongbu: "编码与工程实现", - }; - const ROW_OF = { - lead: 0, zhongshu: 1, shangshu: 1, menxia: 1, - libu: 2, hubu: 2, lipu: 2, bingbu: 2, xingbu: 2, gongbu: 2, - }; - const COLUMN_OF = { - zhongshu: 0, shangshu: 1, menxia: 2, - libu: 0, hubu: 1, lipu: 2, bingbu: 3, xingbu: 4, gongbu: 5, - }; - const STATUS_LABELS = { - running: "运行中", - idle: "空闲", - inactive: "空闲", - provisioning: "创建中", - failed: "失败", - absent: "未设官", - }; - const TASK_LABELS = { pending: "待办", in_progress: "执行中", completed: "已完成" }; - const EFFORT_LABELS = { minimal: "极低", low: "低", medium: "中", high: "高", max: "最高", xhigh: "极高" }; - - function roleLabel(role) { - return ROLE_LABELS[role] || "成员"; - } - - function roleMark(role) { - return ROLE_MARKS[role] || "员"; - } - - function modelLabel(model) { - if (typeof model === "string") return model; - if (!model || typeof model !== "object") return ""; - if (typeof model.name === "string") return model.name; - if (typeof model.model === "string") return model.model; - if (typeof model.id === "string") return model.id; - return ""; - } - - function effortLabel(effort) { - if (typeof effort !== "string") return ""; - return EFFORT_LABELS[effort] || effort; - } - - function shortText(value, limit) { - const text = String(value === undefined || value === null ? "" : value).replace(/\s+/g, " ").trim(); - const max = limit || 120; - return text.length <= max ? text : text.slice(0, max - 1) + "…"; - } - - function arrangeRoster(team) { - const members = Array.isArray(team && team.members) ? team.members : []; - const byRole = new Map(); - for (const member of members) { - if (member && typeof member.name === "string") byRole.set(member.name, member); - } - return ROLE_IDS.map((role) => { - const member = byRole.get(role); - return { - role, - label: ROLE_LABELS[role], - mark: ROLE_MARKS[role], - duty: ROLE_DUTIES[role], - row: ROW_OF[role], - column: COLUMN_OF[role], - id: member && member.id, - member, - present: member !== undefined, - }; - }); - } - - /** 朝堂总览四数:在朝、运行中、在办、已完成;图与侧栏统计共用同一份投影。 */ - function courtStats(seats, buckets, isRunning) { - let present = 0; - let runningCount = 0; - for (const entry of Array.isArray(seats) ? seats : []) { - if (!entry.present) continue; - present += 1; - if (isRunning(entry) === true) runningCount += 1; - } - return [ - { key: "members", label: "在朝成员", value: present, mark: "员" }, - { key: "running", label: "正在运行", value: runningCount, mark: "运" }, - { key: "pending", label: "在办任务", value: (buckets && buckets.in_progress ? buckets.in_progress.length : 0) + (buckets && buckets.pending ? buckets.pending.length : 0), mark: "办" }, - { key: "done", label: "已完成", value: (buckets && buckets.completed ? buckets.completed.length : 0), mark: "成" }, - ]; - } - - /** 当前正在查看的子会话对应哪一席;找不到时保持现有选择。 */ - function childRoleOf(seats, childSessionId) { - if (!childSessionId) return undefined; - const match = (Array.isArray(seats) ? seats : []).find((seat) => seat && seat.id === childSessionId); - return match ? match.role : undefined; - } - - /** 原生输入框里的 @ 候选:只列有会话的部门;丞相主会话由当前输入框承载。 */ - function seatMentionOptions(seats) { - return (Array.isArray(seats) ? seats : []) - .filter((seat) => seat && seat.role !== "lead" && typeof seat.id === "string" && seat.id.length > 0) - .map((seat) => ({ - name: seat.label, - value: seat.id, - label: seat.label, - description: seat.duty + " · 选择后进入该部门会话", - })); - } - - function memberStatus(member, running, summaryRunning) { - if (member === undefined || member === null) return "absent"; - if (member.phase === "failed") return "failed"; - if (member.phase === "provisioning") return "provisioning"; - return running === true || summaryRunning === true ? "running" : "idle"; - } - - function bucketsOf(tasks) { - const buckets = { pending: [], in_progress: [], completed: [] }; - for (const task of Array.isArray(tasks) ? tasks : []) { - const key = task && task.status; - if (key === "pending" || key === "in_progress" || key === "completed") buckets[key].push(task); - else buckets.pending.push(task); - } - return buckets; - } - - /** 归属某部门的任务;ownerName 可能是角色 id 也可能是中文名。 */ - function tasksOfRole(tasks, role) { - const list = Array.isArray(tasks) ? tasks : Array.isArray(tasks && tasks.tasks) ? tasks.tasks : []; - return list.filter((task) => task && (task.ownerName === role || task.ownerName === roleLabel(role))); - } - - function statusSummary(seat, team, running, summaryRunning) { - const status = memberStatus(seat && seat.member, running, summaryRunning); - const owned = seat ? tasksOfRole(team, seat.role) : []; - const buckets = bucketsOf(owned); - return { - status, - statusLabel: STATUS_LABELS[status] || status, - owned, - runningCount: buckets.in_progress.length, - pendingCount: buckets.pending.length, - completedCount: buckets.completed.length, - }; - } - - function modelOptions(catalog) { - const options = []; - const groups = Array.isArray(catalog && catalog.groups) ? catalog.groups : []; - for (const group of groups) { - const provider = group && (group.id || group.provider); - const models = Array.isArray(group && group.models) ? group.models : []; - for (const model of models) { - if (!provider || !model || !model.id) continue; - const efforts = Array.isArray(model.reasoning && model.reasoning.efforts) - ? model.reasoning.efforts.map((effort) => ({ id: effort.id, name: effort.name || effortLabel(effort.id) })) - : []; - options.push({ - provider, - model: model.id, - rowId: provider + "/" + model.id, - label: model.name || model.id, - efforts, - defaultEffort: model.reasoning && model.reasoning.defaultEffort, - }); - } - } - return options; - } - - function findModelOption(options, current) { - if (!current || !current.provider || !current.model) return undefined; - return options.find((option) => option.provider === current.provider && option.model === current.model); - } - - /** 部门模型指令:宿主拒绝给子会话直接改模型,改由丞相会话下发到模式插件。 */ - const DEPT_MODEL_COMMAND = "dept-model"; - - function seatRouteKey(role) { - return "sansheng-liubu.route." + role; - } - - /** 面板记住每个部门的固定模型(宿主插件另存一份在 routes.json)。 */ - function readSeatRoute(role) { - try { - const store = globalThis.localStorage; - if (!store || typeof store.getItem !== "function") return undefined; - const raw = store.getItem(seatRouteKey(role)); - if (!raw) return undefined; - const parsed = JSON.parse(raw); - if (!parsed || typeof parsed.provider !== "string" || typeof parsed.model !== "string") return undefined; - return { - provider: parsed.provider, - model: parsed.model, - ...(typeof parsed.reasoningEffort === "string" && parsed.reasoningEffort ? { reasoningEffort: parsed.reasoningEffort } : {}), - }; - } catch (error) { return undefined; } - } - - function writeSeatRoute(role, route) { - try { - const store = globalThis.localStorage; - if (store && typeof store.setItem === "function") store.setItem(seatRouteKey(role), JSON.stringify(route)); - } catch (error) { /* 记不住就只影响下次刷新,不报错 */ } - } - - function modelSwitchPlan(current, next, addressesSubagent) { - if (!next || !next.provider || !next.model) return { ok: false, reason: "未选择模型" }; - const effort = next.reasoningEffort === undefined ? undefined : next.reasoningEffort; - if (current && current.provider === next.provider && current.model === next.model && (current.reasoningEffort || undefined) === effort) { - return { ok: false, reason: "与当前设置相同" }; - } - const payload = { provider: next.provider, model: next.model }; - if (effort !== undefined) payload.reasoningEffort = effort; - // 部门是子会话:宿主不给它们单独改模型,改走模式插件的 /dept-model 路由。 - return { ok: true, payload, via: addressesSubagent === true ? "command" : "session" }; - } - - function decreeText(role, text, team) { - const body = String(text === undefined || text === null ? "" : text).trim(); - if (body === "") return ""; - const active = (Array.isArray(team && team.tasks) ? team.tasks : []) - .filter((task) => task && task.status === "in_progress") - .map((task) => task.subject || task.title || task.id) - .filter(Boolean); - const context = active.length > 0 ? "\n(当前在办:" + active.join(";") + ")" : ""; - return "【丞相下旨 · " + roleLabel(role) + "】\n" + body + context; - } - - /** 从 TextBlock 数组里拼出纯文本(Chat 的 content/root 结构在不同节点上略有差异)。 */ - function textOfBlocks(blocks) { - if (!Array.isArray(blocks)) return ""; - return blocks - .filter((block) => block && (block.kind === "text" || block.type === "text")) - .map((block) => block.text) - .filter((text) => typeof text === "string") - .join("\n") - .trim(); - } - - /** 按 anchorSeq 排序后取最近一条用户输入与最近一条助手文本。 */ - function lastExchange(nodes) { - const list = (Array.isArray(nodes) ? nodes : []).filter(Boolean); - const ordered = list.slice().sort((left, right) => { - const a = Number(left.anchorSeq ?? 0); - const b = Number(right.anchorSeq ?? 0); - return a === b ? 0 : a < b ? -1 : 1; - }); - let lastUser = ""; - let lastAssistant = ""; - for (const node of ordered) { - const data = node.data || {}; - if (node.kind === "user") { - const text = textOfBlocks(data.content); - if (text !== "") lastUser = shortText(text, 180); - } else if (node.kind === "assistant" || node.kind === "assistant-step") { - const text = textOfBlocks(data.blocks) || textOfBlocks(data.root && data.root.blocks) || (typeof data.root === "string" ? data.root : ""); - if (text !== "") lastAssistant = shortText(text, 220); - } - } - return { lastUser, lastAssistant }; - } - // #endregion - - /** 由 apply() 建立,向 main 槽条目传递 uiWorkspace(root 槽拿不到会话级服务)。 */ - let WorkspaceContext = null; - - // #region 样式 - const css = ` -.sl-toggle{appearance:none;border:0;background:0 0;color:var(--dsw-alias-label-tertiary,#8a8f98);font:inherit;font-size:12px;display:inline-flex;align-items:center;gap:6px;padding:3px 7px;border-radius:6px;cursor:pointer;min-height:28px} -.sl-toggle:hover,.sl-toggle:focus-visible{color:var(--dsw-alias-label-primary,#1f2329);background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.08))} -.sl-toggle.active{color:var(--dsw-alias-label-primary,#1f2329);background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.12))} -.sl-toggle-mark{font-size:10px;letter-spacing:.06em;padding:1px 4px;border-radius:4px;border:1px solid currentColor;opacity:.8} -.sl-toggle-wrap{display:inline-flex;align-items:center;gap:6px;min-width:0} -.sl-toggle-notice{max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:11px;line-height:16px;color:var(--dsw-alias-state-error-primary,#dc2626)} -.sl-rail-mark{flex:none;font-size:10px;letter-spacing:.06em;padding:1px 4px;border-radius:4px;border:1px solid currentColor;opacity:.85} -.sl-dock-stub{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;gap:10px;padding:24px;color:var(--dsw-alias-label-secondary,#5b616b);font-size:13px;line-height:20px;text-align:center} -.sl-dock-stub-text{max-width:min(460px,80%);overflow-wrap:anywhere} -.sl-root{display:flex;flex-direction:column;height:100%;min-height:0;background:var(--dsw-alias-bg-layer-1,#fff);color:var(--dsw-alias-label-primary,#1f2329);font-size:13px;line-height:20px} -.sl-crash{display:flex;flex-direction:column;gap:8px;margin:24px;padding:18px 20px;border:1px solid #e5484d;border-radius:10px;background:#fff5f5;color:#8b1a1d;font-size:13px;line-height:20px;white-space:normal} -.sl-crash strong{font-size:14px} -.sl-crash pre{margin:0;padding:10px 12px;border-radius:6px;background:rgba(127,127,127,.08);font-size:12px;line-height:18px;white-space:pre-wrap;word-break:break-all;overflow:auto;max-height:240px} -.sl-crash p{margin:0;color:var(--dsw-alias-label-tertiary,#8a8f98);font-size:12px} -.sl-btn{appearance:none;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.24));background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.06));color:inherit;font:inherit;font-size:12px;padding:3px 10px;border-radius:7px;cursor:pointer} -.sl-btn:hover{background:var(--dsw-alias-bg-layer-3,rgba(127,127,127,.12))} -.sl-btn[disabled]{opacity:.5;cursor:default} -.sl-btn.primary{background:var(--dsw-alias-state-business-primary,#3b82f6);border-color:transparent;color:#fff} -.sl-body{flex:1;min-height:0;display:flex} -.sl-right{width:392px;min-width:300px;max-width:46%;display:flex;flex-direction:column;min-height:0;overflow-y:auto} -@container slpanel (max-width:980px){.sl-body{flex-direction:column}.sl-right{width:auto;max-width:none;border-top:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.14))}} -.sl-map{padding:12px 16px 16px;flex:none} -.sl-stats{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:8px;padding:14px 16px 0;flex:none} -.sl-stat{display:flex;align-items:center;gap:7px;padding:8px 9px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.2));border-radius:10px;background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.05));min-width:0} -.sl-stat-mark{flex:none;width:20px;height:20px;border-radius:6px;display:inline-flex;align-items:center;justify-content:center;font-size:11px;font-weight:600;background:var(--dsw-alias-bg-layer-3,rgba(127,127,127,.14));color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-stat-running .sl-stat-mark{background:color-mix(in srgb,#22c55e 18%,transparent);color:#16a34a} -.sl-stat-done .sl-stat-mark{background:color-mix(in srgb,var(--dsw-alias-state-business-primary,#3b82f6) 16%,transparent);color:var(--dsw-alias-state-business-primary,#3b82f6)} -.sl-stat-body{display:flex;flex-direction:column;min-width:0;line-height:1.15} -.sl-stat-body b{font-size:17px;font-weight:600;font-variant-numeric:tabular-nums;letter-spacing:.01em} -.sl-stat-body small{font-size:10px;color:var(--dsw-alias-label-tertiary,#8a8f98);white-space:nowrap;overflow:hidden;text-overflow:ellipsis} -@container slpanel (max-width:980px){.sl-stats{padding:12px 14px 0}} -.sl-node{position:relative;display:flex;flex-direction:column;gap:2px;padding:8px 9px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.2));border-radius:10px;background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.05));cursor:pointer;text-align:left;color:inherit;font:inherit;min-width:0;transition:border-color .12s,box-shadow .12s,transform .12s} -.sl-node:hover{transform:translateY(-1px);border-color:var(--dsw-alias-border-l3,rgba(127,127,127,.4))} -.sl-node[aria-selected="true"]{border-color:color-mix(in srgb,var(--dsw-alias-state-business-primary,#3b82f6) 55%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--dsw-alias-state-business-primary,#3b82f6) 28%,transparent)} -.sl-node.is-absent{opacity:.62;border-style:dashed} -.sl-node-top{display:flex;align-items:center;gap:6px;min-width:0} -.sl-mark{flex:none;width:20px;height:20px;border-radius:6px;display:inline-flex;align-items:center;justify-content:center;font-size:11px;font-weight:600;background:var(--dsw-alias-bg-layer-3,rgba(127,127,127,.14));color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-node[aria-selected="true"] .sl-mark{background:color-mix(in srgb,var(--dsw-alias-state-business-primary,#3b82f6) 18%,transparent);color:var(--dsw-alias-state-business-primary,#3b82f6)} -.sl-name{font-weight:600;font-size:12px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis} -.sl-dot{width:6px;height:6px;border-radius:50%;flex:none;background:var(--dsw-alias-label-tertiary,#9ca3af)} -.sl-dot.running{background:#22c55e;box-shadow:0 0 0 2px color-mix(in srgb,#22c55e 20%,transparent)} -.sl-dot.warning{background:#f59e0b} -.sl-dot.error{background:#ef4444} -.sl-dot.absent{background:transparent;border:1px solid var(--dsw-alias-label-tertiary,#9ca3af)} -.sl-detail{flex:none;border-top:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.14));padding:12px 16px 16px;display:flex;flex-direction:column;gap:8px} -.sl-detail-head{display:flex;align-items:center;gap:8px} -.sl-detail-head strong{font-size:13px} -.sl-detail-head small{color:var(--dsw-alias-label-tertiary,#8a8f98);font-size:11px} -.sl-hint{color:var(--dsw-alias-label-tertiary,#8a8f98);font-size:11px;line-height:17px} -.sl-error{color:var(--dsw-alias-state-error-primary,#dc2626);font-size:11px;line-height:17px} -.sl-ok{color:#15803d;font-size:11px;line-height:17px} -.sl-section-title{display:flex;align-items:center;gap:8px;padding:10px 16px 4px;font-size:11px;font-weight:600;letter-spacing:.04em;color:var(--dsw-alias-label-tertiary,#8a8f98);text-transform:uppercase} -.sl-section-title span{margin-left:auto;font-weight:500;text-transform:none;letter-spacing:0} -.sl-tash{list-style:none;margin:0;padding:0 16px 10px;display:flex;flex-direction:column;gap:4px} -.sl-tash li{display:flex;align-items:center;gap:6px;font-size:11px;line-height:17px;color:var(--dsw-alias-label-secondary,#5b616b);min-width:0} -.sl-tash li b{font-weight:500;color:var(--dsw-alias-label-primary,#1f2329);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0;flex:1} -.sl-tash li em{font-style:normal;color:var(--dsw-alias-label-tertiary,#8a8f98);flex:none} -.sl-tab-title{display:flex;align-items:center;gap:6px;min-width:0} -.sl-tab-mark{width:18px;height:18px;border-radius:5px;display:inline-flex;align-items:center;justify-content:center;font-size:9px;font-weight:600;background:var(--dsw-alias-bg-layer-3,rgba(127,127,127,.14));color:var(--dsw-alias-label-secondary,#5b616b)} - -/* 2026 court workspace: quiet DSH surfaces, clear hierarchy, one blue accent. */ -.sl-root{container-type:inline-size;container-name:slpanel;--sl-accent:var(--dsw-alias-state-business-primary,#4d6bfe);--sl-card:var(--dsw-alias-bg-layer-1,#fff);--sl-page:var(--dsw-alias-bg-layer-2,#f5f6f8);--sl-line:var(--dsw-alias-border-l1,rgba(127,127,127,.14));background:var(--sl-page);font-size:13px} -.sl-section-kicker{font-size:9px;line-height:14px;letter-spacing:.13em;color:var(--dsw-alias-label-tertiary,#8a8f98);font-weight:600} -.sl-state-dot{width:6px;height:6px;border-radius:50%;background:#22c55e;box-shadow:0 0 0 3px color-mix(in srgb,#22c55e 12%,transparent)} -.sl-body{display:grid;grid-template-columns:minmax(0,1fr) 440px;gap:16px;padding:16px;overflow:hidden;background:var(--sl-page)} -.sl-right{width:auto;min-width:0;max-width:none;gap:12px;padding:0;overflow-y:auto;overflow-x:hidden;border:0} -.sl-task-panel,.sl-map,.sl-detail{background:var(--sl-card);border:1px solid var(--sl-line);border-radius:14px;box-shadow:0 1px 2px rgba(15,23,42,.025)} -.sl-btn{min-height:32px;padding:5px 13px;border-radius:8px;border-color:var(--sl-line);background:var(--sl-card);font-weight:500} -.sl-btn.primary{background:var(--sl-accent);box-shadow:0 3px 8px color-mix(in srgb,var(--sl-accent) 16%,transparent)} -.sl-btn.primary:hover{background:color-mix(in srgb,var(--sl-accent) 88%,#172554)} -.sl-task-panel{flex:1;min-height:180px;padding:16px 18px} -.sl-section-title{padding:0 0 12px;gap:12px} -.sl-section-heading{display:flex;flex-direction:column} -.sl-section-heading h2,.sl-map-head h2{margin:0;font-size:14px;line-height:20px;font-weight:600} -.sl-section-title .sl-section-count{margin-left:auto;padding:3px 8px;border-radius:6px;background:var(--sl-page);font-size:10px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-tash{padding:0;gap:6px} -.sl-tash li{padding:10px 11px;border:1px solid transparent;border-radius:9px;background:var(--sl-page);gap:10px} -.sl-tash li:hover{border-color:color-mix(in srgb,var(--sl-accent) 20%,transparent)} -.sl-task-state{width:18px;display:flex;justify-content:center;flex:none} -.sl-task-copy{display:flex;flex-direction:column;min-width:0;flex:1} -.sl-task-copy small{font-size:10px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-tash li .sl-task-owner{padding:2px 7px;border-radius:5px;background:var(--sl-card);color:var(--dsw-alias-label-secondary,#5b616b);font-size:10px} -.sl-task-empty{min-height:108px;display:flex;align-items:center;justify-content:center;gap:12px;border:1px dashed var(--sl-line);border-radius:10px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-empty-mark{width:30px;height:30px;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;background:color-mix(in srgb,#22c55e 9%,transparent);color:#16a34a} -.sl-task-empty strong{font-size:12px;font-weight:500;color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-task-empty p{margin:2px 0 0;font-size:10px} -.sl-stats{grid-template-columns:repeat(4,minmax(0,1fr));gap:8px;padding:0} -.sl-stat{position:relative;display:block;padding:12px 11px 11px;border-radius:12px;background:var(--sl-card);border-color:var(--sl-line);box-shadow:0 1px 2px rgba(15,23,42,.025)} -.sl-stat-mark{position:absolute;right:9px;top:9px;width:20px;height:20px;background:var(--sl-page);font-size:10px} -.sl-stat-body{gap:1px} -.sl-stat-body b{font-size:22px;line-height:27px;letter-spacing:-.02em} -.sl-stat-body small{font-size:10px} -.sl-stat-members .sl-stat-mark{background:color-mix(in srgb,var(--sl-accent) 10%,transparent);color:var(--sl-accent)} -.sl-stat-pending .sl-stat-mark{background:color-mix(in srgb,#f59e0b 12%,transparent);color:#d97706} -.sl-map{padding:14px;border-radius:14px} -.sl-map-head{display:flex;align-items:flex-end;justify-content:space-between;gap:10px;margin-bottom:12px} -.sl-map-head>span{font-size:9px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-tier-label{display:flex;align-items:center;justify-content:space-between;margin:0 1px 6px;font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-tier-label small{font-size:9px} -.sl-node:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 65%,transparent);outline-offset:2px} -.sl-node{border-color:var(--sl-line);border-radius:10px;background:var(--sl-card);box-shadow:none;transition:border-color .15s,box-shadow .15s,transform .15s,background .15s} -.sl-node:hover{transform:translateY(-1px);border-color:color-mix(in srgb,var(--sl-accent) 35%,transparent);box-shadow:0 4px 12px rgba(15,23,42,.05)} -.sl-node[aria-selected="true"]{border-color:color-mix(in srgb,var(--sl-accent) 55%,transparent);background:color-mix(in srgb,var(--sl-accent) 4%,var(--sl-card));box-shadow:0 0 0 2px color-mix(in srgb,var(--sl-accent) 9%,transparent)} -.sl-node.is-absent{opacity:.55;background:var(--sl-page)} -.sl-node-top{gap:6px} -.sl-mark{background:var(--sl-page);color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-node[aria-selected="true"] .sl-mark{background:color-mix(in srgb,var(--sl-accent) 12%,transparent);color:var(--sl-accent)} -.sl-name{font-size:11px} -.sl-detail{border:1px solid var(--sl-line);border-radius:14px;padding:15px;gap:11px;margin-bottom:2px} -.sl-detail-head{gap:10px;padding-bottom:10px;border-bottom:1px solid var(--sl-line)} -.sl-detail-mark{width:34px;height:34px;border-radius:10px;display:inline-flex;align-items:center;justify-content:center;background:color-mix(in srgb,var(--sl-accent) 10%,transparent);color:var(--sl-accent);font-size:14px;font-weight:650;flex:none} -.sl-detail-title{display:flex;flex-direction:column;min-width:0} -.sl-detail-head strong{font-size:13px;line-height:19px} -.sl-detail-head small{font-size:10px;line-height:15px} -.sl-detail-head .sl-btn{font-size:10px;min-height:28px;padding:3px 8px} -.sl-hint{font-size:10px;line-height:16px} -.sl-root ::-webkit-scrollbar{width:6px;height:6px} -.sl-root ::-webkit-scrollbar-thumb{background:var(--dsw-alias-border-l3,rgba(127,127,127,.3));border-radius:10px} -.sl-root ::-webkit-scrollbar-track{background:transparent} -@container slpanel (max-width:1180px){.sl-body{grid-template-columns:minmax(0,1fr) 400px;gap:12px;padding:12px}} -@container slpanel (max-width:980px){.sl-body{display:flex;flex-direction:column;overflow-y:auto}.sl-right{width:auto;max-width:none;overflow:visible;border:0}.sl-task-panel{min-height:150px}.sl-stats{padding:0}.sl-detail{margin-bottom:0}} -@container slpanel (max-width:620px){.sl-body{padding:9px;gap:10px}.sl-task-panel,.sl-map,.sl-detail{border-radius:11px}.sl-stats{grid-template-columns:repeat(2,minmax(0,1fr))}.sl-map-head>span{display:none}} - -.sl-compact{padding:0} -.sl-compact .sl-body{display:flex;flex-direction:column;padding:0;gap:0;overflow:hidden} -.sl-compact .sl-right{width:auto;max-width:none;min-width:0;border-top:0;flex:1;overflow-y:auto} -.sl-compact .sl-stats{grid-template-columns:repeat(2,minmax(0,1fr))} - -/* 2026-11 redesign: department cards are the primary surface. */ -.sl-root{--sl-node-border:color-mix(in srgb,var(--sl-accent) 17%,var(--sl-line));--sl-soft-accent:color-mix(in srgb,var(--sl-accent) 7%,var(--sl-card))} -.sl-stats{grid-template-columns:repeat(2,minmax(0,1fr));gap:10px} -.sl-stat{display:flex;align-items:center;gap:8px;min-height:68px;padding:11px 12px} -.sl-stat-mark{position:static;inset:auto;margin-left:auto;width:26px;height:26px;border-radius:8px;font-size:11px} -.sl-stat-body b{font-size:24px;line-height:29px} -.sl-stat-body small{font-size:10px;line-height:15px} -.sl-map{padding:15px 14px 14px} -.sl-map-head{align-items:center;margin-bottom:8px} -.sl-map-head .sl-section-kicker{display:block;margin-bottom:1px} -.sl-map-head>span{white-space:nowrap} -.sl-tier{margin-top:8px} -.sl-grid{display:grid;gap:10px;min-width:0} -.sl-grid-1{grid-template-columns:minmax(0,1fr)} -.sl-grid-1 .sl-node{width:min(232px,100%);margin:0 auto} -.sl-grid-3,.sl-grid-6{grid-template-columns:repeat(3,minmax(0,1fr));gap:12px} -.sl-connector-tri{position:relative;height:19px;margin:0 4px} -.sl-connector-tri:before{content:"";position:absolute;left:16.667%;right:16.667%;top:7px;height:1px;background:color-mix(in srgb,var(--sl-accent) 22%,var(--sl-line))} -.sl-connector-tri:after{content:"";position:absolute;left:50%;top:0;width:1px;height:8px;background:color-mix(in srgb,var(--sl-accent) 22%,var(--sl-line))} -.sl-connector-tri span{position:absolute;top:7px;bottom:0;width:1px;background:color-mix(in srgb,var(--sl-accent) 22%,var(--sl-line))} -.sl-connector-tri span:nth-child(1){left:16.667%} -.sl-connector-tri span:nth-child(2){left:50%} -.sl-connector-tri span:nth-child(3){left:83.333%} -.sl-stem{width:1px;height:15px;margin:0 auto;background:color-mix(in srgb,var(--sl-accent) 22%,var(--sl-line))} -.sl-ministry-group{margin-top:16px;padding:10px;border:1px solid color-mix(in srgb,var(--sl-accent) 11%,var(--sl-line));border-radius:14px;background:color-mix(in srgb,var(--sl-accent) 3%,var(--sl-page))} -.sl-group-head{display:flex;align-items:flex-start;justify-content:space-between;gap:8px;margin:0 2px 9px} -.sl-group-title{display:block;font-size:11px;line-height:16px;font-weight:600;color:var(--dsw-alias-label-primary,#1f2329)} -.sl-group-head small{display:block;margin-top:1px;font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-group-count{flex:none;padding:2px 7px;border-radius:5px;background:var(--sl-card);border:1px solid var(--sl-line);font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-ministry-group .sl-node{background:var(--sl-card)} -.sl-node{min-height:80px;align-items:stretch;justify-content:center;gap:7px;padding:11px 11px 10px;border:1px solid var(--sl-node-border);border-radius:12px;background:var(--sl-card);box-shadow:0 1px 2px rgba(15,23,42,.035)} -.sl-node:hover{transform:translateY(-1px);border-color:color-mix(in srgb,var(--sl-accent) 42%,var(--sl-line));box-shadow:0 6px 18px rgba(15,23,42,.07)} -.sl-node:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 68%,transparent);outline-offset:2px} -.sl-node[aria-pressed="true"],.sl-node.is-selected{border-color:var(--sl-accent);background:var(--sl-soft-accent);box-shadow:inset 0 0 0 1px var(--sl-accent),0 6px 18px color-mix(in srgb,var(--sl-accent) 12%,transparent)} -.sl-node.is-absent{border-style:dashed;background:var(--sl-page);opacity:.64} -.sl-node.status-failed{border-color:color-mix(in srgb,#ef4444 38%,var(--sl-line))} -.sl-node-check{position:absolute;right:7px;top:7px;width:17px;height:17px;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;background:var(--sl-accent);color:#fff;font-size:10px;line-height:17px;font-weight:700} -.sl-node-top{gap:7px;padding-right:12px} -.sl-mark{flex:none;width:28px;height:28px;border-radius:8px;background:color-mix(in srgb,var(--sl-accent) 8%,var(--sl-page));color:color-mix(in srgb,var(--sl-accent) 76%,#1f2329);font-size:12px;font-weight:650} -.sl-node[aria-pressed="true"] .sl-mark{background:var(--sl-accent);color:#fff} -.sl-name{font-size:13px;line-height:19px;font-weight:650;letter-spacing:.01em} -.sl-node-status{display:flex;align-items:center;gap:5px;min-width:0;padding-left:35px;font-size:10px;line-height:15px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-detail{padding:15px;gap:12px} -.sl-detail-head{padding-bottom:11px} -.sl-detail-title{flex:1} -.sl-detail-head strong{font-size:15px;line-height:21px} -.sl-detail-title small{display:block;margin-top:1px;line-height:15px} -.sl-detail-chip{flex:none;padding:2px 7px;border-radius:5px;background:var(--sl-page);border:1px solid var(--sl-line);font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-detail-status{display:flex;align-items:center;flex-wrap:wrap;gap:6px;min-width:0;padding:0 1px;font-size:10px;line-height:16px;color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-detail-status small{flex:1 1 100%;margin:0;min-width:0;overflow:hidden;color:var(--dsw-alias-label-tertiary,#8a8f98);display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;line-clamp:2;white-space:normal;overflow-wrap:anywhere} -.sl-setting-block{display:flex;flex-direction:column;gap:9px;padding:11px;border:1px solid var(--sl-line);border-radius:11px;background:var(--sl-page)} -.sl-setting-head{display:flex;align-items:center;justify-content:space-between;gap:8px} -.sl-setting-head h3{margin:0;font-size:12px;line-height:18px;font-weight:600} -.sl-setting-head small{font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-model-grid{display:grid;grid-template-columns:minmax(0,1fr) 104px;gap:8px} -.sl-control{display:flex;flex-direction:column;gap:5px;min-width:0} -.sl-control>span{font-size:9px;line-height:14px;font-weight:500;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-control select{width:100%;min-width:0;min-height:34px;padding:6px 8px;border:1px solid var(--sl-line);border-radius:8px;background:var(--sl-card);color:inherit;font:inherit;font-size:11px;outline:none} -.sl-control select:focus-visible{border-color:color-mix(in srgb,var(--sl-accent) 55%,transparent);box-shadow:0 0 0 2px color-mix(in srgb,var(--sl-accent) 8%,transparent)} -.sl-control select:disabled{opacity:.58} -.sl-model-foot{display:flex;align-items:center;gap:8px;min-width:0} -.sl-model-foot .sl-btn{flex:none;min-height:30px;font-size:10px;padding:4px 9px} -.sl-model-foot small{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-model-foot small.is-dirty{color:#b45309} -.sl-link-button{appearance:none;align-self:flex-start;border:0;background:none;padding:0;color:var(--sl-accent);font:inherit;font-size:10px;line-height:16px;cursor:pointer} -.sl-conversation-block{display:flex;flex-direction:column;gap:7px} -.sl-delegate-block{display:flex;flex-direction:column;gap:8px;padding-top:2px} -.sl-delegate-block textarea{width:100%;box-sizing:border-box;resize:vertical;min-height:54px;border:1px solid var(--sl-line);border-radius:9px;background:var(--sl-card);color:inherit;font:inherit;font-size:11px;line-height:17px;padding:7px 9px} -.sl-delegate-block textarea::placeholder{color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-conversation-action{width:100%;min-height:40px;display:flex;align-items:center;justify-content:space-between;gap:10px;padding:0 13px;border:1px solid transparent;border-radius:10px;background:var(--sl-accent);color:#fff;font:inherit;font-size:12px;line-height:18px;font-weight:600;cursor:pointer;box-shadow:0 4px 12px color-mix(in srgb,var(--sl-accent) 18%,transparent)} -.sl-conversation-action:hover{background:color-mix(in srgb,var(--sl-accent) 88%,#172554)} -.sl-conversation-action:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 60%,transparent);outline-offset:2px} -.sl-conversation-action:disabled{background:var(--sl-page);color:var(--dsw-alias-label-tertiary,#8a8f98);border-color:var(--sl-line);box-shadow:none;cursor:default} -.sl-conversation-arrow{font-size:13px;opacity:.82} -.sl-conversation-hint{margin:0;font-size:10px;line-height:16px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-advanced{border-top:1px solid var(--sl-line);padding-top:9px} -.sl-advanced summary{display:flex;align-items:center;justify-content:space-between;list-style:none;cursor:pointer;font-size:10px;line-height:16px;font-weight:500;color:var(--dsw-alias-label-secondary,#5b616b)} -.sl-advanced summary::-webkit-details-marker{display:none} -.sl-advanced summary:after{content:"+";font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-advanced[open] summary:after{content:"−"} -.sl-advanced-list{margin:8px 0 0;display:grid;gap:5px;font-size:9px;line-height:15px} -.sl-advanced-list div{display:flex;gap:8px;min-width:0} -.sl-advanced-list dt{flex:none;width:58px;color:var(--dsw-alias-label-tertiary,#8a8f98)} -.sl-advanced-list dd{margin:0;min-width:0;word-break:break-all;color:var(--dsw-alias-label-secondary,#5b616b)} -@container slpanel (max-width:1180px){.sl-grid-6{gap:12px}.sl-node{min-height:76px;padding:10px}} -@container slpanel (max-width:980px){.sl-grid-3,.sl-grid-6{grid-template-columns:repeat(3,minmax(0,1fr));gap:12px}} -@container slpanel (max-width:620px){.sl-stats{grid-template-columns:repeat(2,minmax(0,1fr))}.sl-grid-3,.sl-grid-6{grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.sl-connector-tri,.sl-stem{display:none}.sl-grid-1 .sl-node{width:100%}.sl-map{padding:13px 11px}.sl-detail{padding:13px}.sl-model-grid{grid-template-columns:minmax(0,1fr) 94px}} -@container slpanel (max-width:330px){.sl-grid-3,.sl-grid-6{grid-template-columns:1fr}} -.sl-compact .sl-stats{grid-template-columns:repeat(2,minmax(0,1fr))} -.sl-compact .sl-connector-tri,.sl-compact .sl-stem{display:none} -.sl-compact .sl-grid-1 .sl-node{width:100%} -button.sl-stat{appearance:none;width:100%;border:1px solid var(--sl-line);color:inherit;font:inherit;text-align:left;cursor:pointer} -.sl-stat-pending:hover{border-color:color-mix(in srgb,var(--sl-accent) 34%,var(--sl-line));background:color-mix(in srgb,var(--sl-accent) 3%,var(--sl-card))} -.sl-stat-pending:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 60%,transparent);outline-offset:2px} -button.sl-stat-members:hover{border-color:color-mix(in srgb,var(--sl-accent) 34%,var(--sl-line));background:color-mix(in srgb,var(--sl-accent) 3%,var(--sl-card))} -button.sl-stat-members:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 60%,transparent);outline-offset:2px} -.sl-body.is-court{grid-template-columns:minmax(0,1fr)} -.sl-body.is-court .sl-right{width:100%;max-width:1100px;margin:0 auto} -.sl-body.is-court .sl-stats{display:none} -.sl-body.is-court .sl-map{padding:20px 18px 18px} -.sl-body.is-court .sl-detail{padding:18px} -.sl-map-meta{display:flex;align-items:center;gap:9px;flex:none} -.sl-map-meta>span{font-size:9px;line-height:14px;color:var(--dsw-alias-label-tertiary,#8a8f98);white-space:nowrap} -@container slpanel (max-width:980px){.sl-body.is-court .sl-right{max-width:none}.sl-body.is-court .sl-map{padding:15px 13px}} - -/* 右侧栏形态:聊天留给 DSH 原生会话,面板只承载朝堂与任务。 */ -.sl-sidebar{background:transparent} -.sl-side-meta{display:flex;align-items:center;gap:7px;flex:none;min-width:0;padding:11px 3px 8px} -.sl-side-state{display:inline-flex;align-items:center;gap:6px;flex:none;padding:2px 7px;border:1px solid var(--sl-line);border-radius:999px;background:var(--sl-card);font-size:10px;line-height:15px;color:var(--dsw-alias-label-tertiary,#8a8f98);white-space:nowrap} -.sl-side-state.is-child{color:var(--sl-accent);border-color:color-mix(in srgb,var(--sl-accent) 22%,transparent);background:color-mix(in srgb,var(--sl-accent) 7%,transparent)} -.sl-side-state .sl-state-dot{width:6px;height:6px;border-radius:50%;background:#21a36a;box-shadow:0 0 0 3px color-mix(in srgb,#21a36a 12%,transparent)} -.sl-side-state.is-child .sl-state-dot{background:var(--sl-accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--sl-accent) 12%,transparent)} -.sl-side-hint{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;text-align:right;font-size:9px;line-height:14px;color:var(--dsw-alias-label-caption,#9aa0a6)} -.sl-side-return{appearance:none;flex:none;padding:3px 7px;border:1px solid var(--sl-line);border-radius:6px;background:var(--sl-card);color:var(--sl-accent);font:inherit;font-size:9px;line-height:14px;cursor:pointer} -.sl-side-return:hover{background:color-mix(in srgb,var(--sl-accent) 7%,var(--sl-card))} -.sl-side-return:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 55%,transparent);outline-offset:1px} -.sl-body-sidebar{display:flex;min-height:0;padding:0 2px 10px;overflow:hidden;background:transparent} -.sl-body-sidebar .sl-right{flex:1;width:auto;min-width:0;max-width:none;gap:10px;padding:0 1px 0 0;overflow-y:auto;overflow-x:hidden} -.sl-side-tabs{position:sticky;top:0;z-index:5;display:flex;align-items:center;gap:3px;flex:none;padding:3px;border:1px solid var(--sl-line);border-radius:10px;background:color-mix(in srgb,var(--sl-card) 94%,transparent);box-shadow:0 2px 8px rgba(15,23,42,.04);backdrop-filter:blur(8px)} -.sl-side-tab{appearance:none;flex:1;display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:30px;padding:4px 10px;border:0;border-radius:7px;background:transparent;color:var(--dsw-alias-label-secondary,#5b616b);font:inherit;font-size:11px;line-height:16px;font-weight:500;cursor:pointer} -.sl-side-tab:hover{background:var(--sl-page);color:var(--dsw-alias-label-primary,#1f2329)} -.sl-side-tab.is-active{background:var(--sl-soft-accent,color-mix(in srgb,var(--sl-accent) 9%,var(--sl-card)));color:var(--sl-accent);font-weight:600;box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--sl-accent) 16%,transparent)} -.sl-side-tab:focus-visible{outline:2px solid color-mix(in srgb,var(--sl-accent) 60%,transparent);outline-offset:1px} -.sl-side-tab-count{min-width:17px;padding:0 5px;border-radius:5px;background:color-mix(in srgb,var(--sl-accent) 9%,var(--sl-page));color:var(--sl-accent);font-size:9px;line-height:15px;text-align:center;font-variant-numeric:tabular-nums} -.sl-sidebar .sl-stats{grid-template-columns:repeat(2,minmax(0,1fr));padding:0;gap:8px} -.sl-sidebar .sl-stat{padding:9px 10px;border-radius:11px;background:var(--sl-card);box-shadow:0 1px 2px rgba(15,23,42,.02)} -.sl-sidebar .sl-stat-body b{font-size:18px} -.sl-side-court{display:flex;flex-direction:column;gap:10px;min-width:0} -.sl-sidebar .sl-map{padding:14px 13px 15px;border-radius:14px} -.sl-sidebar .sl-detail{padding:14px;border-radius:14px;gap:10px} -.sl-sidebar .sl-conversation-action{min-height:36px} -.sl-side-tasks{flex:none;min-height:0;padding:15px 14px;border-radius:14px} -.sl-sidebar .sl-task-panel .sl-section-title{padding-bottom:10px} -@container slpanel (max-width:420px){.sl-sidebar .sl-map{padding:12px 10px}.sl-sidebar .sl-detail{padding:12px}.sl-side-tabs{position:static}} -`; - const cssId = "dsh-sansheng-liubu-panel/panel.css"; - if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(cssId) + "]") === null) { - const tag = document.createElement("style"); - tag.dataset.plugin = "dsh-sansheng-liubu-panel"; - tag.dataset.pluginCss = cssId; - tag.textContent = css; - document.head.appendChild(tag); - } - // #endregion - - // #region 小部件 - function Dot(props) { - const status = props.status || "inactive"; - const tone = status === "running" ? "running" : status === "failed" ? "error" : status === "provisioning" ? "warning" : status === "absent" ? "absent" : ""; - return h("span", { className: "sl-dot" + (tone ? " " + tone : ""), "aria-hidden": "true" }); - } - - function SeatCard(props) { - const { seat, selected, onSelect, status } = props; - const cls = ["sl-node", "status-" + status]; - if (!seat.present) cls.push("is-absent"); - if (selected) cls.push("is-selected"); - return h("button", { - type: "button", - className: cls.join(" "), - "aria-pressed": selected ? "true" : "false", - "aria-label": seat.label + "," + (STATUS_LABELS[status] || status), - "data-role": seat.role, - title: seat.duty, - onClick: () => onSelect(seat.role), - children: [ - selected ? h("span", { className: "sl-node-check", "aria-hidden": "true", children: "✓" }) : null, - h("span", { className: "sl-node-top" }, [ - h("span", { className: "sl-mark", "aria-hidden": "true", children: seat.mark }), - h("span", { className: "sl-name", children: seat.label }), - ]), - h("span", { className: "sl-node-status" }, [ - h(Dot, { status }), - h("span", { children: STATUS_LABELS[status] || status }), - ]), - ], - }); - } - // #endregion - - // #region 主面板 - function SanshengPanel(props) { - const host = props.host; - const tabSessionId = props.sessionId; - const compact = props.compact === true; - // 直接订阅宿主服务层 store,不调用 slot 注入的会话级 hook(root 级 main 槽下不可用)。 - const sessions = useStoreSnapshot(host.sessionsStore, EMPTY_SESSIONS) || EMPTY_SESSIONS; - const statuses = useStoreSnapshot(host.statusStore, undefined); - const activePanelId = useStoreSnapshot(host.panelStore, {}).activePanelId; - const projections = sessions.projectionsBySession || {}; - - // main 面板是 root 级槽:拿不到会话级 props,用户正在看哪个会话只能从 - // uiWorkspace 的选中记录(持久化在 dsh.sessions.current)读。 - const selection = useWorkspaceSelection(); - const pickedId = host.getSelectedSession ? host.getSelectedSession() : undefined; - const focusedSessionId = tabSessionId || pickedId || selection.sessionId; - const activeAddress = selection.subagentAddress || (focusedSessionId ? subagentAddressOf(sessions, focusedSessionId) : undefined); - const leadSessionId = (activeAddress && activeAddress.parentSessionId) || focusedSessionId; - const team = leadSessionId && projections[leadSessionId] - ? projections[leadSessionId].values.agentTeam - : undefined; - const seats = React.useMemo(() => arrangeRoster(team), [team]); - const buckets = React.useMemo(() => bucketsOf(team && team.tasks), [team]); - - const [selectedRole, setSelectedRole] = React.useState("lead"); - const [sidebarView, setSidebarView] = React.useState("court"); - const seat = seats.find((entry) => entry.role === selectedRole) || seats[0]; - - const runningOf = (id) => { - if (!id) return undefined; - const fromStatus = statuses && typeof statuses.get === "function" ? statuses.get(id) : undefined; - if (fromStatus && typeof fromStatus.running === "boolean") return fromStatus.running; - const fromList = sessions.byId[id]; - return fromList ? fromList.running : undefined; - }; - - const seatState = (entry) => { - const status = memberStatus(entry.member, runningOf(entry.id), undefined); - const owned = tasksOfRole(team, entry.role); - const ownBuckets = bucketsOf(owned); - const running = status === "running"; - const recent = entry.id ? host.recentText(entry.id) : ""; - const model = entry.id ? host.memberModel(entry.id) : ""; - const lastText = recent ? recent : (owned.length > 0 ? owned[owned.length - 1].subject || "" : ""); - return { - status, - counts: { - runningCount: ownBuckets.in_progress.length, - pendingCount: ownBuckets.pending.length, - completedCount: ownBuckets.completed.length, - }, - lastText: shortText(lastText, 40), - model, - running, - }; - }; - - const stats = React.useMemo( - () => courtStats(seats, buckets, (entry) => memberStatus(entry.member, runningOf(entry.id), undefined) === "running"), - [seats, buckets, sessions, statuses], - ); - - const openTaskCount = buckets.in_progress.length + buckets.pending.length; - const showTasks = () => setSidebarView("tasks"); - const showCourt = () => setSidebarView("court"); - const seatInfo = seat ? seatState(seat) : { status: "absent", counts: {}, lastText: "", model: "" }; - - // —— 图下配置区 —— - const [catalog, setCatalog] = React.useState({ status: "idle", options: [], error: null, current: undefined, subagent: false }); - const [draftModel, setDraftModel] = React.useState(""); - const [draftEffort, setDraftEffort] = React.useState(""); - const [notice, setNotice] = React.useState(null); - const [busy, setBusy] = React.useState(false); - const [catalogRetry, setCatalogRetry] = React.useState(0); - const [delegationText, setDelegationText] = React.useState(""); - const [delegating, setDelegating] = React.useState(false); - - const targetId = seat && seat.id ? seat.id : seat && seat.role === "lead" ? leadSessionId : undefined; - - React.useEffect(() => { - if (catalog.status === "loading") return undefined; - if (!targetId && !(seat && seat.role)) { setCatalog({ status: "idle", options: [], error: null, current: undefined, subagent: false }); return undefined; } - let alive = true; - setCatalog((prev) => ({ ...prev, status: "loading", error: null })); - host.loadCatalog(targetId, seat && seat.role).then((result) => { - if (!alive) return; - setCatalog({ status: "ready", options: result.options, current: result.current, error: result.error, subagent: result.subagent, fixed: result.fixed === true, unresolved: result.unresolved === true, inherited: result.inherited === true }); - setDraftModel(result.current ? result.current.provider + "/" + result.current.model : ""); - setDraftEffort((result.current && result.current.reasoningEffort) || ""); - }, (error) => { - if (alive) setCatalog({ status: "error", options: [], error: String(error && error.message || error), current: undefined, subagent: false }); - }); - return () => { alive = false; }; - }, [targetId, seat && seat.role, catalogRetry]); - - const presetForSeat = seat && seat.id && sessions.byId[seat.id] && sessions.byId[seat.id].projectionValues - ? sessions.byId[seat.id].projectionValues.agentPreset - : undefined; - - const chosenOption = catalog.options.find((option) => option.rowId === draftModel); - const currentModelValue = catalog.current ? catalog.current.provider + "/" + catalog.current.model : ""; - const currentEffortValue = (catalog.current && catalog.current.reasoningEffort) || ""; - const modelDirty = draftModel !== currentModelValue || draftEffort !== currentEffortValue; - - const applySelection = (option, effort) => { - if (!option || !seat) return; - const plan = modelSwitchPlan(catalog.current, { - provider: option.provider, - model: option.model, - reasoningEffort: effort || undefined, - }, catalog.subagent || !seat.id); - if (!plan.ok) return; - setBusy(true); - setNotice(null); - const request = plan.via === "command" - ? host.routeModel(seat.role, plan.payload, seat.id) - : host.selectModel(seat.id, plan.payload); - const finish = (result) => { - setBusy(false); - if (result && result.ok) { - if (plan.via === "command") writeSeatRoute(seat.role, plan.payload); - setCatalog((prev) => ({ ...prev, current: plan.payload, fixed: plan.via === "command" ? true : prev.fixed })); - } else { - setNotice({ kind: "error", text: (result && result.error) || "宿主没有接受这次选择" }); - } - }; - request.then(finish, (error) => finish({ ok: false, error: String((error && error.message) || error) })); - }; - const activeChildId = activeAddress && activeAddress.childSessionId - ? activeAddress.childSessionId - : focusedSessionId !== leadSessionId ? focusedSessionId : undefined; - const activeSeat = activeChildId ? seats.find((entry) => entry.id === activeChildId) : undefined; - const previousChildRef = React.useRef(null); - React.useEffect(() => { - const previousChild = previousChildRef.current; - previousChildRef.current = activeChildId || null; - if (activeChildId) { - const role = childRoleOf(seats, activeChildId); - if (role) setSelectedRole(role); - return; - } - if (previousChild) setSelectedRole("lead"); - }, [activeChildId, seats]); - const onTargetConversation = Boolean(targetId && focusedSessionId === targetId); - const conversationLabel = seat && seat.role === "lead" - ? "返回丞相主会话" - : "与" + (seat ? seat.label : "该部门") + "对话"; - const conversationHint = seat && seat.role === "lead" - ? "回到统一受理需求的主会话;部门对话不会自动转呈丞相。" - : "进入该部门自己的 DSH 会话;消息不会自动同步给丞相。"; - - const sendDelegation = () => { - const body = delegationText.trim(); - if (body === "" || !seat || !seat.id) return; - setDelegating(true); - setNotice(null); - host.dispatchToSeat(seat.id, body).then((result) => { - setDelegating(false); - if (result.ok) { setDelegationText(""); setNotice({ kind: "ok", text: "已派给" + seat.label }); } - else setNotice({ kind: "error", text: result.error }); - }); - }; - - const openSeatConversation = () => { - if (!targetId) { - setNotice({ kind: "error", text: "该部门还没有可进入的会话,请先让丞相组建朝班。" }); - return; - } - if (!host.openSession(targetId)) { - setNotice({ kind: "error", text: "打开部门会话失败,请稍后重试。" }); - } - }; - - const returnToLead = () => { - const target = leadSessionId || (seat && seat.role === "lead" ? seat.id : undefined); - if (!target || !host.openSession(target)) { - setNotice({ kind: "error", text: "还没有丞相主会话,请先打开主对话。" }); - } - }; - - const seatOf = (role) => seats.find((entry) => entry.role === role); - const renderSeat = (role) => { - const entry = seatOf(role); - if (!entry) return null; - const info = seatState(entry); - return h(SeatCard, { - key: entry.role, - seat: entry, - selected: entry.role === selectedRole, - status: info.status, - onSelect: (nextRole) => { setSelectedRole(nextRole); setNotice(null); }, - }); - }; - - return h("div", { className: (compact ? "sl-root sl-compact " : "sl-root ") + "sl-sidebar", "data-sansheng-panel": "true", "data-sansheng-compact": compact ? "1" : "0", "data-sansheng-sidebar": "1" }, [ - h("div", { className: "sl-side-meta" }, [ - h("span", { className: "sl-side-state" + (activeChildId ? " is-child" : "") }, [ - h("span", { className: "sl-state-dot", "aria-hidden": "true" }), - team === undefined - ? "等待组建朝班" - : activeSeat - ? "正在与" + activeSeat.label + "对话" - : "朝班协作中", - ]), - h("span", { className: "sl-side-hint", children: "输入 @ 选择部门" }), - activeChildId - ? h("button", { - type: "button", - className: "sl-side-return", - onClick: returnToLead, - children: "返回丞相", - }) - : null, - ]), - h("div", { className: "sl-body sl-body-sidebar" }, [ - h("div", { className: "sl-right" }, [ - h("div", { className: "sl-side-tabs", role: "tablist", "aria-label": "朝堂视图" }, [ - h("button", { - type: "button", - role: "tab", - className: "sl-side-tab" + (sidebarView === "court" ? " is-active" : ""), - "aria-selected": sidebarView === "court", - "data-side-tab": "court", - onClick: showCourt, - children: "朝堂", - }), - h("button", { - type: "button", - role: "tab", - className: "sl-side-tab" + (sidebarView === "tasks" ? " is-active" : ""), - "aria-selected": sidebarView === "tasks", - "data-side-tab": "tasks", - onClick: showTasks, - children: ["任务", h("span", { className: "sl-side-tab-count", children: openTaskCount })], - }), - ]), - h("div", { className: "sl-stats", "data-sansheng-stats": "1" }, stats.map((stat) => - h(stat.key === "pending" || stat.key === "members" ? "button" : "div", { - key: stat.key, - type: stat.key === "pending" || stat.key === "members" ? "button" : undefined, - onClick: stat.key === "pending" ? showTasks : stat.key === "members" ? showCourt : undefined, - title: stat.key === "pending" ? "查看任务流转" : stat.key === "members" ? "查看朝堂编制" : undefined, - className: "sl-stat sl-stat-" + stat.key, - }, [ - h("span", { className: "sl-stat-mark", "aria-hidden": "true", children: stat.mark }), - h("span", { className: "sl-stat-body" }, [ - h("b", { children: String(stat.value).padStart(2, "0") }), - h("small", { children: stat.label }), - ]), - ]))), - sidebarView === "court" - ? h("div", { className: "sl-side-court" }, [ - h("div", { className: "sl-map" }, [ - h("div", { className: "sl-map-head" }, [ - h("div", {}, [ - h("span", { className: "sl-section-kicker", children: "组织编制" }), - h("h2", { children: "朝堂编制" }), - ]), - h("div", { className: "sl-map-meta" }, [ - h("span", { children: "十席 · 按需召集" }), - ]), - ]), - h("div", { className: "sl-tier" }, [ - h("div", { className: "sl-tier-label" }, [ - h("span", { children: "丞相" }), - h("small", { children: "统筹 · 分派 · 交付" }), - ]), - h("div", { className: "sl-grid sl-grid-1", "data-tier": "lead" }, renderSeat("lead")), - ]), - h("div", { className: "sl-connector-tri", "aria-hidden": "true" }, [ - h("span", { key: "zhongshu" }), - h("span", { key: "shangshu" }), - h("span", { key: "menxia" }), - ]), - h("div", { className: "sl-tier" }, [ - h("div", { className: "sl-tier-label" }, [ - h("span", { children: "三省" }), - h("small", { children: "拟案 · 执行 · 审议" }), - ]), - h("div", { className: "sl-grid sl-grid-3", "data-tier": "provinces" }, [ - renderSeat("zhongshu"), - renderSeat("shangshu"), - renderSeat("menxia"), - ]), - ]), - h("div", { className: "sl-stem", "aria-hidden": "true" }), - h("section", { className: "sl-ministry-group", "data-ministry-group": "1" }, [ - h("div", { className: "sl-group-head" }, [ - h("div", {}, [ - h("span", { className: "sl-group-title", children: "六部 · 尚书省调度" }), - h("small", { children: "两排同属一级,按需召集" }), - ]), - h("span", { className: "sl-group-count", children: "6 席" }), - ]), - h("div", { className: "sl-grid sl-grid-6", "data-tier": "ministries" }, [ - renderSeat("libu"), - renderSeat("hubu"), - renderSeat("lipu"), - renderSeat("bingbu"), - renderSeat("xingbu"), - renderSeat("gongbu"), - ]), - ]), - ]), - h("section", { className: "sl-detail", "data-selected-role": seat ? seat.role : "none" }, [ - h("div", { className: "sl-detail-head" }, [ - h("span", { className: "sl-detail-mark", "aria-hidden": "true", children: seat ? seat.mark : "员" }), - h("div", { className: "sl-detail-title" }, [ - h("strong", { children: seat ? seat.label : "成员" }), - h("small", { children: seat ? seat.duty : "" }), - ]), - h("span", { className: "sl-detail-chip", children: "固定职责" }), - ]), - h("div", { className: "sl-detail-status" }, [ - h(Dot, { status: seatInfo.status }), - h("span", { children: STATUS_LABELS[seatInfo.status] || seatInfo.status }), - seatInfo.lastText ? h("small", { children: shortText(seatInfo.lastText, 46) }) : null, - ]), - seat && !seat.present ? h("div", { className: "sl-hint", children: "该部门尚未设立。让丞相按流程组建后再进入会话。" }) : null, - seat ? h("div", { className: "sl-setting-block" }, [ - h("div", { className: "sl-setting-head" }, [ - h("h3", { children: "模型设置" }), - h("small", { children: catalog.subagent ? (seat.present ? "按部门固定" : "召见后生效") : "只影响该部门" }), - ]), - catalog.subagent ? h("div", { className: "sl-hint", children: seat.present ? "部门是子会话,宿主不允许事后单独改;这里选好后由模式把它固定下来,下一轮开工即用。" : "该部门还没召见。这里选好的模型由模式记下来,召见时直接按它开工。" }) : null, - h(React.Fragment, null, [ - h("div", { className: "sl-model-grid" }, [ - h("label", { className: "sl-control" }, [ - h("span", { children: "模型" }), - h("select", { - value: draftModel, - disabled: catalog.status === "loading" || busy, - "aria-label": "部门模型", - onChange: (event) => { - const value = event.target.value; - const option = catalog.options.find((entry) => entry.rowId === value); - const effort = option && option.defaultEffort ? option.defaultEffort : ""; - setDraftModel(value); - setDraftEffort(effort); - applySelection(option, effort); - }, - children: [ - h("option", { value: "", children: catalog.status === "loading" ? "读取中…" : "选择模型" }), - ...catalog.options.map((option) => h("option", { key: option.rowId, value: option.rowId, children: option.label })), - ], - }), - ]), - h("label", { className: "sl-control" }, [ - h("span", { children: "推理等级" }), - h("select", { - value: draftEffort, - disabled: catalog.status === "loading" || busy || !chosenOption, - "aria-label": "部门推理等级", - onChange: (event) => { - const value = event.target.value; - setDraftEffort(value); - applySelection(chosenOption, value); - }, - children: [ - h("option", { value: "", children: "默认" }), - ...(chosenOption ? chosenOption.efforts : []).map((effort) => h("option", { key: effort.id, value: effort.id, children: effort.name })), - ], - }), - ]), - ]), - h("div", { className: "sl-model-foot" }, [ - h("small", { - className: notice && notice.kind === "error" ? "is-dirty" : "", - children: busy || modelDirty - ? "自动保存中…" - : notice && notice.kind === "error" - ? "保存失败,换一次再试" - : catalog.fixed - ? "自动保存 · 该部门固定使用此模型" - : !seat.present - ? "自动保存 · 召见时按此模型开工" - : catalog.inherited - ? "自动保存 · 当前跟随默认(" + modelLabel(catalog.current) + ")" - : "自动保存 · 当前:" + (catalog.current ? modelLabel(catalog.current) : "未设置"), - }), - ]), - ]), - catalog.error ? h("div", { className: "sl-error", children: catalog.error }) : null, - catalog.error ? h("button", { - type: "button", - className: "sl-link-button", - onClick: () => setCatalogRetry((value) => value + 1), - children: "重试读取模型", - }) : null, - ]) : null, - h("div", { className: "sl-conversation-block" }, [ - h("button", { - type: "button", - className: "sl-conversation-action", - disabled: !targetId || onTargetConversation, - "data-conversation-target": seat ? seat.role : "", - onClick: openSeatConversation, - children: [ - h("span", { children: onTargetConversation ? (seat && seat.role === "lead" ? "正在丞相主会话" : "正在此部门会话") : conversationLabel }), - h("span", { className: "sl-conversation-arrow", "aria-hidden": "true", children: "↗" }), - ], - }), - h("p", { className: "sl-conversation-hint", children: onTargetConversation ? "你当前就在这个会话中。" : conversationHint }), - seat && seat.id && seat.role !== "lead" ? h("div", { className: "sl-delegate-block" }, [ - h("label", { className: "sl-control" }, [ - h("span", { children: "直接派活" }), - h("textarea", { - rows: 2, - "aria-label": "直接派活给" + seat.label, - placeholder: "不经过丞相,直接交给" + seat.label + "办", - value: delegationText, - onChange: (event) => setDelegationText(event.target.value), - }), - ]), - h("div", { className: "sl-model-foot" }, [ - h("button", { - type: "button", - className: "sl-btn primary", - disabled: delegating || delegationText.trim() === "", - onClick: sendDelegation, - children: delegating ? "派发中…" : "派给" + seat.label, - }), - h("small", { children: "直接进该部门会话,丞相收不到这条" }), - ]), - ]) : null, - ]), - h("details", { className: "sl-advanced" }, [ - h("summary", { children: "高级信息" }), - h("dl", { className: "sl-advanced-list" }, [ - h("div", {}, [h("dt", { children: "角色标识" }), h("dd", { children: seat ? seat.role : "未选择" })]), - h("div", {}, [h("dt", { children: "Agent 预设" }), h("dd", { children: typeof presetForSeat === "string" && presetForSeat ? presetForSeat : "由宿主管理" })]), - h("div", {}, [h("dt", { children: "会话" }), h("dd", { children: targetId || "尚未建立" })]), - ]), - ]), - notice ? h("div", { className: notice.kind === "ok" ? "sl-ok" : "sl-error", role: "status", children: notice.text }) : null, - ]), - ]) - : h("section", { className: "sl-task-panel sl-side-tasks", "data-side-tasks": "1" }, [ - h("div", { className: "sl-section-title" }, [ - h("div", { className: "sl-section-heading" }, [ - h("span", { className: "sl-section-kicker", children: "任务队列" }), - h("h2", { children: "任务流转" }), - ]), - h("span", { className: "sl-section-count", children: "执行 " + buckets.in_progress.length + " · 待办 " + buckets.pending.length }), - ]), - h("ul", { className: "sl-tash" }, buckets.in_progress.concat(buckets.pending).slice(0, 8).map((task) => h("li", { key: task.id, title: task.description || "" }, [ - h("span", { className: "sl-task-state" }, [h(Dot, { status: task.status === "in_progress" ? "running" : "provisioning" })]), - h("div", { className: "sl-task-copy" }, [ - h("b", { children: task.subject || task.title || task.id }), - h("small", { children: task.status === "in_progress" ? "正在执行" : "等待受理" }), - ]), - h("em", { className: "sl-task-owner", children: roleLabel(task.ownerName) }), - ]))), - buckets.in_progress.length + buckets.pending.length === 0 - ? h("div", { className: "sl-task-empty" }, [ - h("span", { className: "sl-empty-mark", "aria-hidden": "true", children: "✓" }), - h("div", {}, [h("strong", { children: "当前没有待办任务" }), h("p", { children: "新任务受理后,会在这里显示执行进度与负责部门。" })]), - ]) - : null, - ]), - ]), - ]), - ]); - } - // #endregion - // #region 宿主适配 - function createHost(ctx) { - const sessions = ctx.sessions; - const conversations = new WeakMap(); - let selectedSessionId; - let lastAction = "尚未操作"; - const note = (text) => { lastAction = text; try { console.log("[三省六部] " + text); } catch (error) { /* 忽略 */ } }; - - /** layout 服务用可选查找:直接读 ctx.layout 会命中 inject 声明守卫。 */ - const layoutService = () => { - try { - if (typeof ctx.get === "function") { - const service = ctx.get("layout"); - if (service) return service; - } - } catch (error) { /* 退回直接读 */ } - try { return ctx.layout; } catch (error) { return undefined; } - }; - const panelStore = (() => { - const service = layoutService(); - return service && service.panelInfo ? service.panelInfo : undefined; - })(); - const sessionsStore = sessions && sessions.list; - const statusStore = (() => { - const candidates = []; - if (sessions && sessions.statuses) candidates.push(sessions.statuses); - try { - if (typeof ctx.get === "function") { - const service = ctx.get("sessionStatus"); - if (service) candidates.push(service); - } - } catch (error) { /* 忽略:拿不到时由 byId.running 兜底 */ } - return candidates.find((item) => item && typeof item.getSnapshot === "function" && typeof item.subscribe === "function"); - })(); - - /** 当前中央面板 id:null 表示正在看会话本体。 */ - const currentPanelId = () => { - if (!panelStore || typeof panelStore.getSnapshot !== "function") return null; - try { - const info = panelStore.getSnapshot(); - return info ? info.activePanelId : null; - } catch (error) { return null; } - }; - - const bindingOf = (sessionId) => { - try { return sessions.binding(sessionId); } catch (error) { return undefined; } - }; - - const courtState = { pending: false }; - const selectionSnapshot = () => { - try { - const store = ctx.uiWorkspace && ctx.uiWorkspace.selection; - return store && typeof store.getSnapshot === "function" ? (store.getSnapshot() || {}) : {}; - } catch (error) { return {}; } - }; - - /** 唯一的投递实现:所有入口都走这里,返回结构化结果而不是抛异常。 */ - const deliverPrompt = (sessionId, text) => { - if (!sessionId) return Promise.resolve({ ok: false, stage: "deliver", errorCode: "no-session", error: "没有可投递的会话" }); - const binding = bindingOf(sessionId); - if (!binding || !binding.session || typeof binding.session.prompt !== "function") { - return Promise.resolve({ ok: false, stage: "deliver", sessionId: sessionId, errorCode: "no-session", error: "该会话还没有可用的对话通道" }); - } - let pending; - try { - pending = binding.session.prompt.call(binding.session, [{ type: "text", text: text }], "queue"); - } catch (error) { - return Promise.resolve({ ok: false, stage: "deliver", sessionId: sessionId, errorCode: "deliver-threw", error: "投递时出错:" + String((error && error.message) || error) }); - } - return Promise.resolve(pending).then((result) => { - if (result && result.ok === false) { - return { ok: false, stage: "deliver", sessionId: sessionId, errorCode: "rejected", error: "宿主拒绝了这条消息:" + (result.error && result.error.message ? result.error.message : "原因未知") }; - } - return { ok: true, stage: "delivered", sessionId: sessionId, text: text }; - }, (error) => ({ ok: false, stage: "deliver", sessionId: sessionId, errorCode: "deliver-failed", error: "投递失败:" + String((error && error.message) || error) })); - }; - - /** 会话的对话快照(uiConversation 绑定按会话缓存,重复创建会丢掉已归并的节点)。 */ - const conversationOf = (sessionId) => { - let service; - try { service = ctx.uiConversation; } catch (error) { return undefined; } - if (!service) return undefined; - const binding = bindingOf(sessionId); - if (!binding) return undefined; - let target = conversations.get(binding); - if (target === undefined) { - try { - const conversation = service.binding(binding); - target = conversation && conversation.target ? conversation.target("chat") : undefined; - } catch (error) { - target = undefined; - } - conversations.set(binding, target); - } - return target; - }; - - /** 取会话最近一条助手/用户文本:chat 快照的 nodes 是按 key 索引的只读集合。 */ - const recentOf = (sessionId) => { - const target = conversationOf(sessionId); - if (!target) return ""; - let snapshot; - try { snapshot = target.getSnapshot(); } catch (error) { return ""; } - const nodes = snapshot && snapshot.nodes; - if (!nodes || typeof nodes.values !== "function") return ""; - const exchange = lastExchange(Array.from(nodes.values())); - return exchange.lastAssistant || exchange.lastUser; - }; - - /** 没有选中记录时,退回最近活跃的那个会话(整页版常用)。 */ - const newestSessionId = () => { - try { - const list = sessionsStore && typeof sessionsStore.getSnapshot === "function" ? sessionsStore.getSnapshot() : undefined; - const byId = list && list.byId ? list.byId : {}; - let best; - for (const key of Object.keys(byId)) { - const item = byId[key]; - if (!item || item.blank === true) continue; - const at = typeof item.updatedAt === "number" ? item.updatedAt : Date.parse(item.updatedAt || ""); - const score = Number.isFinite(at) ? at : 0; - if (!best || score > best.score) best = { id: item.id || key, score }; - } - return best ? best.id : undefined; - } catch (error) { return undefined; } - }; - - /** 主视图当前选中的会话:以 uiWorkspace 的选中记录为准(面板是 root 级槽)。 */ - const currentSession = () => { - try { - const saved = ctx.uiWorkspace && ctx.uiWorkspace.selection ? ctx.uiWorkspace.selection.getSnapshot() : undefined; - if (saved && saved.subagentAddress) return saved.subagentAddress.childSessionId; - if (saved && saved.sessionId) return saved.sessionId; - } catch (error) { /* 忽略:退回面板传入的选中 */ } - return selectedSessionId || newestSessionId(); - }; - - const presetsRemote = () => { - try { - const remote = ctx.remote; - if (!remote) return undefined; - const presets = remote.agentPresets; - return presets && typeof presets.list === "function" ? presets : undefined; - } catch (error) { return undefined; } - }; - - /** - * 取模型目录服务与某会话的目录。三种结果必须分开,否则 «宿主没有这个服务» 会被 - * 当成 «这个会话读不到目录»:{ service: false } 没有服务;{ error } 有服务但解析 - * 不到该会话;{ directory } 成功。 - */ - const modelDirectoryOf = (sessionId) => { - let service; - try { - service = ctx.modelDirectories || (typeof ctx.get === "function" ? ctx.get("modelDirectories") : undefined); - } catch (error) { - return { error: "读取模型目录服务失败:" + String((error && error.message) || error) }; - } - if (!service || typeof service.directoryFor !== "function") return { service: false }; - try { - return { directory: service.directoryFor(sessionId) }; - } catch (error) { - return { error: String((error && error.message) || error) }; - } - }; - - /** 全局模型清单(宿主一代一份):不依赖任何会话,是模型选择最稳的数据源。 */ - const modelCatalogOf = () => { - let service; - try { - service = ctx.modelDirectories || (typeof ctx.get === "function" ? ctx.get("modelDirectories") : undefined); - } catch (error) { - return { error: "读取模型目录服务失败:" + String((error && error.message) || error) }; - } - if (!service || typeof service.directoryFor !== "function") return { service: false }; - const catalog = service.catalog; - if (!catalog || typeof catalog.load !== "function" || !catalog.store || typeof catalog.store.getSnapshot !== "function") { - return { error: "当前宿主没有全局模型清单(modelDirectories.catalog)" }; - } - return { catalog }; - }; - /** 取宿主挂出来的 remote 子服务:先问 ctx.get,再退回 ctx.remote 的属性。 */ - const remoteService = (name, key) => { - try { - const service = typeof ctx.get === "function" ? ctx.get(name) : undefined; - if (service) return service; - } catch (error) { /* 宿主没挂这个服务 */ } - try { - const remote = ctx.remote; - return remote && remote[key]; - } catch (error) { return undefined; } - }; - - /** 会话 RPC 面:改模型只认 sessionId,不需要该会话在本页登记。 */ - const remoteSession = () => { - const session = remoteService("remote.session", "session"); - return session && typeof session.selectModel === "function" ? session : undefined; - }; - - /** 改模型时按这个顺序找执行者:部门自己 > 其它会话 > 丞相(只当执行上下文,不投递消息)。 */ - const routeCandidates = (preferredSessionId) => { - const lead = currentSession(); - const list = []; - if (preferredSessionId) list.push(preferredSessionId); - try { - const snapshot = sessions.list && typeof sessions.list.getSnapshot === "function" ? sessions.list.getSnapshot() : undefined; - const ids = (snapshot && snapshot.ids) || []; - for (const id of ids) if (id !== preferredSessionId && id !== lead) list.push(id); - } catch (error) { /* 忽略 */ } - if (lead && list.indexOf(lead) < 0) list.push(lead); - return list; - }; - - /** 子会话投递面:用户直接派活给某个部门,绕开丞相。 */ - const remoteSubagents = () => { - const subagents = remoteService("remote.subagents", "subagents"); - return subagents && typeof subagents.prompt === "function" ? subagents : undefined; - }; - - /** 子会话地址:谁把我召来的。 */ - const subagentAddressOf = (sessionId) => { - if (!sessionId || !sessions || typeof sessions.subagentAddress !== "function") return undefined; - try { return sessions.subagentAddress(sessionId); } catch (error) { return undefined; } - }; - - const mintRequestId = () => { - try { - if (globalThis.crypto && typeof globalThis.crypto.randomUUID === "function") return globalThis.crypto.randomUUID(); - } catch (error) { /* 忽略 */ } - return "req-" + Date.now().toString(36) + "-" + Math.random().toString(16).slice(2); - }; - - /** 指令 RPC 面:直接执行斜杠指令,不经过模型,也不进对话。 */ - const remoteCommands = () => { - const commands = remoteService("remote.commands", "commands"); - return commands && typeof commands.execute === "function" ? commands : undefined; - }; - - const sidebarNav = () => { - const candidates = []; - try { if (typeof ctx.get === "function") candidates.push(ctx.get("sidebarRight")); } catch (error) { /* 忽略 */ } - try { candidates.push(ctx.sidebarRight); } catch (error) { /* 忽略 */ } - return candidates.find((item) => item && (typeof item.openTabIn === "function" || typeof item.openTab === "function")); - }; - - const openSanshengTab = (sessionId) => { - const nav = sidebarNav(); - const target = sessionId || currentSession(); - if (!target) { - return { ok: false, error: "当前还没有打开任何会话,右侧栏页签是会话级的;先新建或打开一个会话再停靠。" }; - } - try { - const service = layoutService(); - if (service && typeof service.selectPanel === "function") service.selectPanel(null); - } catch (error) { /* 忽略:右栏可能已经可见 */ } - - const better = betterSidebarOf(ctx); - if (better && typeof better.openTab === "function") { - try { - better.openTab({ type: SANSENG_TAB_ID }, { sessionId: target }); - return { ok: true, text: "朝堂已停靠到右侧栏" }; - } catch (error) { /* 落到宿主原生右侧栏 */ } - } - - let opened = false; - const attempt = (left) => { - try { - if (nav && typeof nav.openTabIn === "function") nav.openTabIn(target, SANSENG_TAB_KIND); - else if (nav && typeof nav.openTab === "function") nav.openTab(SANSENG_TAB_KIND); - opened = true; - } catch (error) { - opened = false; - } - if (opened || left <= 0) return; - setTimeout(() => attempt(left - 1), 60); - }; - if (nav) attempt(8); - if (!nav) return { ok: false, error: "当前宿主没有右侧栏服务(sidebarRight),无法停靠到侧栏;整页形式仍可使用。" }; - return { ok: true, text: "朝堂已停靠到右侧栏" }; - }; - - // 会话头开关的失败原因:挂在 host 上,跨重渲染保留,成功后清空。 - let toggleNotice = null; - const toggleNoticeListeners = new Set(); - const setToggleNotice = (text) => { - const next = text ? String(text) : null; - if (next === toggleNotice) return; - toggleNotice = next; - for (const listener of Array.from(toggleNoticeListeners)) { - try { listener(); } catch (error) { /* 忽略:订阅方异常不影响开关 */ } - } - }; - const toggleNoticeStore = { - getSnapshot: () => toggleNotice, - subscribe(listener) { - if (typeof listener !== "function") return () => {}; - toggleNoticeListeners.add(listener); - return () => { toggleNoticeListeners.delete(listener); }; - }, - }; - - return { - sessionsStore, - statusStore, - panelStore, - getSelectedSession: currentSession, - setToggleNotice, - toggleNoticeStore, - setSelected(sessionId) { - selectedSessionId = sessionId; - }, - currentPanelId, - selectPanel(panelId) { - const service = layoutService(); - if (!service || typeof service.selectPanel !== "function") return false; - try { service.selectPanel(panelId); return true; } catch (error) { return false; } - }, - togglePanel() { - return this.selectPanel(currentPanelId() === PANEL_ID ? null : PANEL_ID); - }, - openSanshengTab, - memberModel(sessionId) { - const binding = bindingOf(sessionId); - if (!binding) return ""; - try { - const face = binding.session.projections.faceOf("modelSelection"); - const snapshot = face.getSnapshot(); - return modelLabel(snapshot && snapshot.next ? snapshot.next.model || snapshot.next : snapshot); - } catch (error) { return ""; } - }, - recentText(sessionId) { - if (!sessionId) return ""; - try { return recentOf(sessionId); } catch (error) { return ""; } - }, - /** 点「打开主对话」=开一个新对话:建好朝堂会话后把中央切到它,用户可以直接说话。 */ - openConversation() { - return this.openCourtSession({ formation: false }); - }, - /** 只跳到已有对话(不新建)。 */ - focusConversation() { - const target = currentSession(); - if (!target) return { ok: false, stage: "focus", errorCode: "no-session", error: "当前还没有任何会话,可以先点「打开主对话」开一个。" }; - try { ctx.uiWorkspace.openSession(target); } catch (error) { - return { ok: false, stage: "focus", errorCode: "open-failed", error: "打开会话失败:" + String((error && error.message) || error) }; - } - const service = layoutService(); - if (service && typeof service.selectPanel === "function") { - try { service.selectPanel(null); } catch (error) { /* 忽略 */ } - } - return { ok: true, stage: "focus", sessionId: target }; - }, - openSession(sessionId) { - let summary; - try { summary = sessions.list.getSnapshot().byId[sessionId]; } catch (error) { summary = undefined; } - const address = summary && summary.subagent && summary.subagent.address; - const parent = address && address.parentSessionId; - try { - if (parent && parent !== sessionId) { - ctx.uiWorkspace.openSession({ parentSessionId: parent, childSessionId: sessionId, mode: "continuable" }); - } else { - ctx.uiWorkspace.openSession(sessionId); - } - } catch (error) { - return false; - } - const service = layoutService(); - if (service && typeof service.selectPanel === "function") { - try { service.selectPanel(null); } catch (error) { /* 忽略 */ } - } - return true; - }, - loadPresets() { - const remote = presetsRemote(); - if (!remote) return Promise.resolve({ options: [], error: "当前宿主未提供 Agent 预设接口" }); - const chain = Promise.resolve() - .then(() => remote.list()) - .then((result) => { - if (!result || !result.ok) return { options: [], error: result && result.error ? result.error.message : "读取预设失败" }; - const presets = result.value && Array.isArray(result.value.presets) ? result.value.presets : []; - return { options: presets.map((preset) => ({ id: preset.id, name: preset.name || preset.id })), error: null }; - }, (error) => ({ options: [], error: "读取预设失败:" + String(error && error.message || error) })); - return withDeadline(chain, 6000, (error) => ({ - options: [], - error: error ? "读取预设失败:" + String(error && error.message || error) : "读取预设超时:宿主 6 秒没有响应", - })); - }, - loadCatalog(sessionId, role) { - const subagentOf = (id) => (typeof sessions.subagentAddress === "function" ? sessions.subagentAddress(id) !== undefined : false); - // 还没召见的部门没有会话:清单照样给,当前值取面板里固定过的那条。 - const isSubagent = sessionId ? subagentOf(sessionId) : true; - const fixed = isSubagent && role ? readSeatRoute(role) : undefined; - // 模型清单是全局的:宿主同时只维护一份,任何会话都能读到;会话只决定「当前选的是哪个」。 - const global = modelCatalogOf(); - if (global.service === false) { - return Promise.resolve({ options: [], current: undefined, inherited: false, error: "当前宿主没有模型目录服务(modelDirectories)", subagent: false, unresolved: false }); - } - if (!global.catalog) { - return Promise.resolve({ options: [], current: undefined, inherited: false, error: global.error, subagent: isSubagent, unresolved: false }); - } - const catalog = global.catalog; - const resolved = sessionId ? modelDirectoryOf(sessionId) : { service: true, directory: undefined }; - const directory = resolved.directory; - /** 该会话自己的当前模型;没在本页登记时为 undefined。 */ - const ownCurrent = () => { - if (!directory) return undefined; - try { - const snapshot = directory.store.getSnapshot(); - return snapshot && snapshot.current ? snapshot.current : undefined; - } catch (error) { return undefined; } - }; - const directoryError = () => { - if (!directory) return null; - try { return directory.store.getSnapshot().error || null; } catch (error) { return null; } - }; - const shape = (extra) => { - let value; - try { value = catalog.store.getSnapshot().value; } catch (error) { value = null; } - const own = ownCurrent(); - const fallback = value && value.default ? value.default : undefined; - return { - options: modelOptions(value), - current: fixed || own || fallback, - inherited: fixed ? false : own ? false : Boolean(fallback), - fixed: Boolean(fixed), - error: (extra && extra.error) || directoryError() || null, - subagent: isSubagent, - unresolved: Boolean(extra && extra.unresolved), - }; - }; - const cached = (message) => shape({ error: message, unresolved: !directory }); - const chain = Promise.resolve() - .then(() => catalog.load()) - .then(() => shape({ unresolved: !directory }), (error) => cached("读取模型清单失败:" + String((error && error.message) || error))); - return withDeadline(chain, 6000, () => cached("读取模型清单超时(显示已知缓存)")); - }, - selectModel(sessionId, payload) { - const resolved = modelDirectoryOf(sessionId); - if (resolved.service === false) return Promise.resolve({ ok: false, error: "当前宿主没有模型目录服务(modelDirectories)" }); - const directory = resolved.directory; - if (directory) { - return Promise.resolve() - .then(() => directory.select(payload)) - .then(() => { - const snapshot = directory.store.getSnapshot(); - return snapshot.error ? { ok: false, error: snapshot.error } : { ok: true }; - }, (error) => ({ ok: false, error: String((error && error.message) || error) })); - } - // 该部门会话没在本页登记时拿不到目录,但「改模型」是宿主 RPC,只认 sessionId。 - const remote = remoteSession(); - if (!remote) { - return Promise.resolve({ ok: false, error: "当前宿主没有保存模型的接口(remote.session.selectModel)" }); - } - const request = { sessionId, provider: payload.provider, model: payload.model }; - if (payload.reasoningEffort !== undefined) request.reasoningEffort = payload.reasoningEffort; - return Promise.resolve() - .then(() => remote.selectModel(request)) - .then((result) => { - if (result && result.ok) return { ok: true }; - const failure = result && result.error; - const detail = failure - ? (failure.code ? failure.code + ":" + failure.message : String(failure.message || failure)) - : "保存模型失败"; - return { ok: false, error: detail }; - }, (error) => ({ ok: false, error: String((error && error.message) || error) })); - }, - /** 子会话不能直接改模型,改由丞相会话把指令下发给模式插件。 */ - /** 子会话不能直接改模型:用 commands/execute 直接跑指令,全程不碰模型。 */ - routeModel(role, payload, preferredSessionId) { - const commands = remoteCommands(); - if (!commands) return Promise.resolve({ ok: false, error: "当前宿主没有直接执行指令的接口(remote.commands.execute)" }); - const line = "/" + DEPT_MODEL_COMMAND + " " + role + " " + payload.provider + " " + payload.model + - (payload.reasoningEffort ? " " + payload.reasoningEffort : ""); - // 先在部门自己的会话里执行;它冷着或被回收时再退到别的会话(指令只写全局路由表,不碰任何对话)。 - const candidates = routeCandidates(preferredSessionId); - const attempt = (index, lastError) => { - if (index >= candidates.length) return Promise.resolve({ ok: false, error: lastError || "没有可执行这条指令的会话" }); - const agent = candidates[index]; - return Promise.resolve() - .then(() => commands.execute(agent, line, [])) - .then((result) => { - if (result && result.ok === false) { - const failure = result.error; - const detail = failure - ? (failure.code ? failure.code + ":" + failure.message : String(failure.message || failure)) - : "宿主拒绝了这条指令"; - return attempt(index + 1, detail); - } - const value = result && result.value !== undefined ? result.value : result; - const outcome = value && value.result !== undefined ? value.result : value; - if (outcome && outcome.kind === "success") return { ok: true, text: line, agent: agent }; - const detail = outcome && outcome.kind === "error" ? outcome.text : undefined; - return attempt(index + 1, detail || "宿主没有执行这条指令(可能还没有重启)"); - }, (error) => attempt(index + 1, String((error && error.message) || error))); - }; - return attempt(0, undefined); - }, - selectPreset(sessionId, presetId) { - const remote = presetsRemote(); - if (!remote || typeof remote.select !== "function") return Promise.resolve({ ok: false, error: "当前宿主未提供 Agent 预设接口" }); - return Promise.resolve() - .then(() => remote.select(sessionId, presetId)) - .then((result) => (result && result.ok ? { ok: true } : { ok: false, error: result && result.error ? result.error.message : "应用预设失败" }), - (error) => ({ ok: false, error: String(error && error.message || error) })); - }, - refresh(sessionId) { - const binding = bindingOf(sessionId); - if (binding && binding.session && binding.session.projections && typeof binding.session.projections.faceOf === "function") { - try { binding.session.projections.faceOf("agentPreset").getSnapshot(); } catch (error) { /* 忽略 */ } - } - if (typeof sessions.refreshProjections === "function") { - try { sessions.refreshProjections(sessionId).catch(() => {}); } catch (error) { /* 忽略 */ } - } - }, - getLastAction() { return lastAction; }, - /** 用户直接派活:走 subagent 投递,丞相完全不知道这条。 */ - dispatchToSeat(sessionId, text) { - const body = String(text === undefined || text === null ? "" : text).trim(); - if (body === "") return Promise.resolve({ ok: false, error: "先说清要派什么活" }); - if (!sessionId) return Promise.resolve({ ok: false, error: "该部门还没有会话,先让丞相组建朝班" }); - const remote = remoteSubagents(); - if (!remote) return Promise.resolve({ ok: false, error: "当前宿主没有子会话投递接口(remote.subagents.prompt)" }); - const address = subagentAddressOf(sessionId); - if (!address || !address.parentSessionId) return Promise.resolve({ ok: false, error: "这个会话不是子会话,直接在它自己的对话里说就行" }); - return Promise.resolve() - .then(() => remote.prompt({ - requestId: mintRequestId(), - parentSessionId: address.parentSessionId, - childSessionId: sessionId, - mode: "continuable", - delivery: "queue", - content: [{ type: "text", text: body }], - })) - .then((result) => (result && result.messageId ? { ok: true, messageId: result.messageId } : { ok: false, error: "投递失败" }), - (error) => ({ ok: false, error: String((error && error.message) || error) })); - }, - sendPrompt(sessionId, text) { - return deliverPrompt(sessionId, text); - }, - startFormation() { - const lead = currentSession(); - if (!lead) return Promise.resolve({ ok: false, stage: "deliver", errorCode: "no-session", error: "没有可用会话" }); - return deliverPrompt(lead, FORMATION_PROMPT).then((result) => (result.ok ? { ok: true, text: "已请丞相组建朝班" } : result)); - }, - - /** 新开一个独立朝堂会话:绝不把旨意或组建指令写进用户当前正在聊的对话。 */ - /** 新开一个独立朝堂会话:绝不把旨意或组建指令写进用户当前正在聊的对话。 */ - openCourtSession(options) { - const withFormation = !options || options.formation !== false; - if (courtState.pending) return Promise.resolve({ ok: false, stage: "create", errorCode: "busy", error: "正在创建朝堂会话,请稍候再点" }); - const snapshot = sessionsStore && typeof sessionsStore.getSnapshot === "function" ? sessionsStore.getSnapshot() : undefined; - const before = new Set(Object.keys((snapshot && snapshot.byId) || {})); - const beforeCount = before.size; - const beforeSelection = (selectionSnapshot() || {}).sessionId; - const ref = currentSession(); - let workspaceId; - try { workspaceId = ctx.uiWorkspace && ctx.uiWorkspace.currentWorkspaceId; } catch (error) { /* 忽略 */ } - if (!workspaceId && ref && snapshot && snapshot.byId && snapshot.byId[ref]) workspaceId = snapshot.byId[ref].workspaceId; - if (!workspaceId && snapshot && snapshot.ids && snapshot.ids.length) { - const first = snapshot.byId[snapshot.ids[0]]; - if (first && first.workspaceId) workspaceId = first.workspaceId; - } - const request = (ws) => { - note("请求新建会话,工作区=" + String(ws || "自动") + ",现有会话 " + beforeCount + " 个"); - try { return ctx.uiWorkspace.startSession(ws, { agentPreset: "sansheng-liubu" }); } catch (error) { - console.warn("[三省六部] 新建会话失败:", error); - return undefined; - } - }; - const waitNew = (left) => { - let now; - try { now = sessionsStore && typeof sessionsStore.getSnapshot === "function" ? sessionsStore.getSnapshot() : undefined; } catch (error) { now = undefined; } - const ids = (now && now.ids) || []; - for (const id of ids) if (!before.has(id)) return Promise.resolve(id); - const current = (selectionSnapshot() || {}).sessionId; - if (current && current !== beforeSelection && !before.has(current) && now && now.byId && now.byId[current]) return Promise.resolve(current); - if (left <= 0) return Promise.resolve(undefined); - return new Promise((resolve) => setTimeout(() => resolve(waitNew(left - 1)), 200)); - }; - const settle = (result) => { - courtState.pending = false; - note("开新朝堂:" + String((result && (result.text || result.error)) || result)); - return result; - }; - courtState.pending = true; - request(workspaceId); - return waitNew(15) - .then((first) => (first ? first : Promise.resolve().then(() => { request(undefined); return waitNew(30); }))) - .then((sessionId) => { - if (!sessionId) { - console.warn("[三省六部] 新会话未创建", { workspaceId: workspaceId, beforeCount: beforeCount }); - return settle({ ok: false, stage: "create", errorCode: "create-timeout", error: "宿主没有创建出新会话(工作区:" + String(workspaceId || "未识别") + ",原有会话 " + beforeCount + " 个)。可用左侧「新会话」手动建一个,并在顶部选「上朝」预设。" }); - } - selectedSessionId = sessionId; - try { ctx.uiWorkspace.openSession(sessionId); } catch (error) { /* 忽略 */ } - const service = layoutService(); - if (service && typeof service.selectPanel === "function") { - try { service.selectPanel(null); } catch (error) { /* 忽略 */ } - } - const shortId = sessionId.slice(0, 8); - if (!withFormation) { - return settle({ ok: true, stage: "created", sessionId: sessionId, text: "已开启新对话(" + shortId + "),可以直接说话" }); - } - return deliverPrompt(sessionId, FORMATION_PROMPT).then((sent) => { - const short = shortId; - if (!sent.ok) { - return settle({ ok: false, stage: "deliver", sessionId: sessionId, errorCode: sent.errorCode, error: "已新开朝堂会话(" + short + "),但组建指令没送达:" + sent.error }); - } - return settle({ ok: true, stage: "delivered", sessionId: sessionId, text: "已新开独立朝堂会话(" + short + "),丞相开始组建朝班" }); - }); - }) - .catch((error) => settle({ ok: false, stage: "create", errorCode: "unexpected", error: "创建朝堂会话时出错:" + String((error && error.message) || error) })); - }, - }; - } - - const FORMATION_PROMPT = [ - "【上朝】按三省六部流程组建朝班:", - "1. 立即创建 zhongshu(中书省)、menxia(门下省)、shangshu(尚书省)三个成员。", - "2. 在共享任务板建立“中书拟案 → 门下审议 → 尚书派工”依赖链,写清各任务 writeScopes。", - "3. 门下准奏后由尚书按职责分派:吏部(Agent 与技能维护)、户部(数据与计算)、礼部(内容与呈现)、兵部(环境运行与部署)、刑部(按风险专项测试)、工部(开发实现);只召集本任务真正用到的部门。", - "4. 每阶段完成后向我汇报,我确认后再进入下一阶段。", - ].join("\n"); - - - const EMPTY_SESSIONS = { byId: {}, projectionsBySession: {}, ids: [], phase: "ready" }; - - /** 给可能永远不 settle 的宿主 Promise 加超时,超时后走 fallback,避免界面卡在「读取中」。 */ - function withDeadline(promise, ms, fallback) { - return new Promise((resolve) => { - let settled = false; - const timer = setTimeout(() => { - if (settled) return; - settled = true; - try { resolve(fallback()); } catch (error) { resolve(undefined); } - }, ms); - Promise.resolve(promise).then((value) => { - if (settled) return; - settled = true; - clearTimeout(timer); - resolve(value); - }, (error) => { - if (settled) return; - settled = true; - clearTimeout(timer); - try { resolve(fallback(error)); } catch (inner) { resolve(undefined); } - }); - }); - } - - /** - * 订阅宿主 store 的快照。main 是 root 级槽,自带的会话级 hook 在 root 作用域下不可靠, - * 面板改为直接订阅服务层 store:数据与会话页同源,且不依赖 slot 注入的 hook。 - * 用 useState + useEffect + subscribe,而不是 useSyncExternalStore: - * 宿主 store 的 getSnapshot 不保证每次返回同一引用,避免无限重渲染。 - */ - function useStoreSnapshot(store, fallback) { - const read = () => { - if (!store || typeof store.getSnapshot !== "function") return fallback; - try { return store.getSnapshot() || fallback; } catch (error) { return fallback; } - }; - const [snapshot, setSnapshot] = React.useState(read); - React.useEffect(() => { - if (!store || typeof store.subscribe !== "function") return undefined; - try { return store.subscribe(() => setSnapshot(read())); } catch (error) { return undefined; } - }, [store]); - return snapshot; - } - - /** 面板级错误兜底:任何渲染异常都显示成可见的诊断块,而不是让宿主隔离成空白。 */ - class PanelBoundary extends React.Component { - constructor(props) { - super(props); - this.state = { error: null }; - } - static getDerivedStateFromError(error) { - return { error }; - } - componentDidCatch(error) { - if (typeof console !== "undefined" && typeof console.error === "function") { - console.error("[三省六部] 面板渲染失败:", error); - } - } - render() { - const error = this.state.error; - if (!error) return this.props.children; - const message = error && error.message ? error.message : String(error); - return h("div", { className: "sl-crash", role: "alert" }, [ - h("strong", { children: "三省六部面板渲染失败" }), - h("pre", { children: message }), - h("p", { children: "请把上面这段信息发给开发者;界面其余部分不受影响。" }), - ]); - } - } - - /** 主视图选中记录:uiWorkspace 把 {sessionId, subagentAddress} 持久化在 dsh.sessions.current。 */ - function useWorkspaceSelection() { - const workspace = React.useContext(WorkspaceContext); - const read = () => { - if (!workspace || !workspace.selection) return {}; - try { return workspace.selection.getSnapshot() || {}; } catch (error) { return {}; } - }; - const [selection, setSelection] = React.useState(read); - React.useEffect(() => { - if (!workspace || !workspace.selection || typeof workspace.selection.subscribe !== "function") return undefined; - try { return workspace.selection.subscribe(() => setSelection(read())); } catch (error) { return undefined; } - }, [workspace]); - return selection; - } - - /** 会话若自身就是被寻址的子代理,返回它的地址;否则 undefined。 */ - function subagentAddressOf(sessions, sessionId) { - const summary = sessions.byId ? sessions.byId[sessionId] : undefined; - const direct = summary && summary.subagent && summary.subagent.address; - if (direct) return direct; - const bySession = sessions.projectionsBySession || {}; - for (const parentId of Object.keys(bySession)) { - const parent = bySession[parentId]; - const list = parent && parent.values ? parent.values.subagentCatalog : undefined; - if (Array.isArray(list) && list.some((entry) => entry && entry.id === sessionId)) { - return { parentSessionId: parentId, childSessionId: sessionId }; - } - } - return undefined; - } - - // #region 次要入口(会话头开关 / 侧栏置顶行 / 右侧栏页签) - /** - * 会话头入口。openSanshengTab() 失败(没有会话、宿主没有右侧栏服务)时, - * 0.5.0 会静默回退成 togglePanel(),用户点一下什么也看不到;这里把原因渲染出来, - * 并把失败原因挂在 host 的 toggleNoticeStore 上,跨重渲染保留。 - */ - function SanshengToggle(props) { - const host = props.host; - const info = useStoreSnapshot(host && host.panelStore, {}) || {}; - const notice = useStoreSnapshot(host && host.toggleNoticeStore, null); - const open = info.activePanelId === PANEL_ID; - return h("span", { className: "sl-toggle-wrap" }, [ - h("button", { - key: "btn", - type: "button", - className: "sl-toggle" + (open ? " active" : ""), - "data-sansheng-toggle": open ? "open" : "closed", - title: "三省六部:把朝堂停靠到右侧栏,主对话留在中央", - onClick: () => { - // 失败时只把原因显示在开关旁:0.5.0 起没有整页面板可回退, - // 再调 togglePanel() 只会把主区域切到一个不存在的面板上。 - const result = host.openSanshengTab(); - host.setToggleNotice(result && result.ok === false ? result.error : null); - }, - }, [ - h("span", { key: "mark", className: "sl-toggle-mark", children: "三省" }), - h("span", { key: "label", children: open ? "收起朝堂" : "三省六部" }), - ]), - notice ? h("span", { - key: "notice", - className: "sl-toggle-notice", - role: "status", - title: notice, - children: notice, - }) : null, - ]); - } - - - /** 左栏导航列的图标:细线「三」字样标,和宿主其它线性图标同一观感。 */ - function SanshengNavGlyph(props) { - const size = Number(props.size) || 18; - const active = props.active === true; - const bar = (key, y) => h("path", { key, d: "M6 " + y + "h6", stroke: "currentColor", strokeWidth: 1.2, strokeLinecap: "round" }); - return h("svg", { - width: size, - height: size, - viewBox: "0 0 18 18", - fill: "none", - "aria-hidden": "true", - "data-sansheng-glyph": active ? "active" : "idle", - }, [ - h("rect", { key: "box", x: 2.3, y: 2.3, width: 13.4, height: 13.4, rx: 4.2, stroke: "currentColor", strokeWidth: active ? 1.6 : 1.3, opacity: active ? 1 : 0.9 }), - bar("bar-a", 6.4), - bar("bar-b", 9), - bar("bar-c", 11.6), - ]); - } - - /** - * 把朝堂停靠到当前会话的右侧栏,然后把主区域退回原会话。 - * 抽成普通函数是为了让测试能直接驱动真实的成功/失败分支(测试替身不执行 useEffect)。 - * 成功返回 null;失败返回原因文本,并写进开关旁的提示存储。 - */ - function dockToSidebarTab(host) { - const result = host.openSanshengTab(); - if (result && result.ok) { - host.setToggleNotice(null); - host.selectPanel(null); - return null; - } - const reason = result && result.error ? result.error : "当前无法停靠到右侧栏。"; - host.setToggleNotice(reason); - return reason; - } - - /** - * 「插件」那一列点击后的落点。那一列的行只由 sidebar.panellist 驱动,点击写死走 - * selectPanel(id) → 向宿主索取 main 槽;这里给 main 一个重定向桩:有会话就立刻停靠到 - * 右侧栏并退回原会话,没有会话就把原因写在页面上。它不是第二套面板,也不承载聊天。 - */ - function SanshengDockRedirect(props) { - const host = props.host; - const [reason, setReason] = React.useState(null); - React.useEffect(() => { - const failure = dockToSidebarTab(host); - if (failure) setReason(failure); - }, []); - return h("div", { className: "sl-dock-stub", "data-sansheng-dock": "1" }, [ - h("span", { key: "mark", className: "sl-rail-mark", "aria-hidden": "true", children: "三省" }), - h("span", { key: "text", className: "sl-dock-stub-text", children: reason || "正在把朝堂停靠到右侧栏…" }), - ]); - } - - - function SanshengTabTitle() { - return h("div", { className: "sl-tab-title", "data-sansheng-tab-title": "1" }, [ - h("span", { key: "mark", className: "sl-tab-mark", children: "三省" }), - h("span", { key: "label", children: "朝堂" }), - ]); - } - - function SanshengTabBody(props) { - const host = props.host; - const sessionId = props.sessionId; - React.useEffect(() => { - if (sessionId && host.setSelected) host.setSelected(sessionId); - }, [sessionId]); - return h(PanelBoundary, null, h(SanshengPanel, { ...props, host, compact: true })); - } - - - /** 在原生 composer 注册 @ 部门入口;选择后进入对应子会话,消息仍由宿主输入框发送。 */ - function createSeatMentionSource(ctx, host) { - const candidates = (session, options) => { - try { - const list = ctx.sessions.list.getSnapshot(); - let sessionId = session && session.sessionId; - if (!sessionId && ctx.uiWorkspace && ctx.uiWorkspace.selection) { - sessionId = ctx.uiWorkspace.selection.getSnapshot().sessionId; - } - let address; - try { address = ctx.sessions.subagentAddress(sessionId); } catch (error) { address = undefined; } - if (!address) address = subagentAddressOf(list, sessionId); - const leadId = (address && address.parentSessionId) || sessionId; - const team = leadId && list.projectionsBySession && list.projectionsBySession[leadId] - ? list.projectionsBySession[leadId].values.agentTeam - : undefined; - const query = String((options && options.query) || "").trim(); - return Promise.resolve(seatMentionOptions(arrangeRoster(team)).filter((item) => - query.length === 0 || item.label.indexOf(query) >= 0 || item.description.indexOf(query) >= 0)); - } catch (error) { - return Promise.resolve([]); - } - }; - return { - trigger: "@", - name: "sansheng", - showGroupTitle: false, - candidates, - onPick({ candidate }) { - const sessionId = candidate && candidate.value; - if (typeof sessionId === "string" && sessionId.length > 0) { - Promise.resolve().then(() => { - try { host.openSession(sessionId); } catch (error) { /* 宿主导航失败时保留当前会话 */ } - }); - } - return { text: "" }; - }, - codec: { - clipboardText: (ref) => (ref && ref.label) || "", - serialize: (ref) => Promise.resolve((ref && ref.label) || ""), - }, - }; - } - - function registerSeatMentions(ctx, host) { - let triggers; - try { triggers = typeof ctx.get === "function" ? ctx.get("inputTriggers") : undefined; } catch (error) { triggers = undefined; } - if (!triggers || typeof triggers.registerSource !== "function") return; - ctx.effect(() => triggers.registerSource(createSeatMentionSource(ctx, host)), "三省六部: @ 部门成员"); - } - - /** better-sidebar 是可选的:没装时不要写进 inject,否则插件会被 park。 */ - function betterSidebarOf(ctx) { - const candidates = []; - try { if (typeof ctx.get === "function") candidates.push(ctx.get("betterSidebar")); } catch (error) { /* 忽略 */ } - try { candidates.push(ctx.betterSidebar); } catch (error) { /* 忽略 */ } - return candidates.find((item) => item && typeof item.registerTab === "function"); - } - // #endregion - - function apply(ctx) { - // 会话与输入框全部复用 DSH 原生界面;插件只向右侧栏注册朝堂页签。 - WorkspaceContext = React.createContext(undefined); - const workspace = ctx.uiWorkspace; - const host = createHost(ctx); - registerSeatMentions(ctx, host); - - ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({ - name: "conversation.session.header.actions", - id: PANEL_ID + ":toggle", - order: 40, - }, (props) => h(SanshengToggle, { ...props, host }))); - - // 左侧栏导航列(插件 / 定时任务 / 任务看板 那一列):用户要求入口在那里。 - // 那一列的行全部来自 sidebar.panellist,点击写死走 selectPanel(id) 再向宿主索取 main 槽, - // 所以同时注册一个 main 重定向桩:点进去立刻停靠到右侧栏并退回原会话,不留空白主区域。 - ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({ - name: "sidebar.panellist", - id: PANEL_ID, - // 用户要求置顶并改叫「上朝」:order 取负值,排在「插件」以外的所有插件行之前。 - order: -100, - label: () => "上朝", - }, (props) => h(SanshengNavGlyph, props))); - - ctx.slots.inject("main", () => ctx.slots.register({ - name: "main", - key: PANEL_ID, - }, (props) => h(SanshengDockRedirect, { ...props, host }))); - - // 右侧栏回退:宿主自带 sidebarRight(better-sidebar 存在时不注册,避免两处同名页签)。 - const better = betterSidebarOf(ctx); - if (better) { - ctx.effect(() => better.registerTab({ - id: SANSENG_TAB_ID, - title: "三省六部", - description: "朝堂成员图、任务与配置;对话本体留在中央", - order: 5, - single: true, - component: (props) => h(PanelBoundary, null, h(SanshengPanel, { - host, - sessionId: props && props.scope ? props.scope.sessionId : undefined, - compact: true, - })), - }), "三省六部: better-sidebar 页签"); - } else { - try { - ctx.effect(() => { - try { - return ctx.sidebarRightTabs.register({ - id: SANSENG_TAB_ID, - kind: SANSENG_TAB_KIND, - priority: "builtin", - title: () => "三省六部", - }); - } catch (error) { - if (typeof console !== "undefined" && console.warn) console.warn("[三省六部] 右侧栏 tab 类型注册失败:", error); - return () => {}; - } - }, "三省六部: 右侧栏 tab 类型"); - } catch (error) { /* 老宿主没有该服务:会话头部入口和侧栏插槽仍可用 */ } - } - - ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({ - name: "sidebar.right.pane.tab", - key: SANSENG_TAB_ID, - }, (props) => h(SanshengTabBody, { ...props, host }))); - - ctx.slots.inject("sidebar.right.pane.tab.title", () => ctx.slots.register({ - name: "sidebar.right.pane.tab.title", - key: SANSENG_TAB_ID, - }, () => h(SanshengTabTitle, null))); - } - - exports.apply = apply; - exports.inject = ["slots", "sessions", "uiWorkspace", "uiConversation", "modelDirectories", "remote", "remote.agentPresets", "remote.session", "remote.subagents", "remote.commands", "sidebarRightTabs", "sidebarRight"]; - exports.SanshengPanel = SanshengPanel; - exports.PANEL_ID = PANEL_ID; - exports.SANSENG_TAB_ID = SANSENG_TAB_ID; - exports.SANSENG_TAB_KIND = SANSENG_TAB_KIND; - exports.createHost = createHost; - exports.__test = { - PANEL_ID, - SANSENG_TAB_ID, - SANSENG_TAB_KIND, - ROLE_IDS, - roleLabel, - roleMark, - modelLabel, - effortLabel, - arrangeRoster, - courtStats, - memberStatus, - tasksOfRole, - statusSummary, - modelOptions, - findModelOption, - modelSwitchPlan, - decreeText, - lastExchange, - shortText, - bucketsOf, - seatMentionOptions, - childRoleOf, - createSeatMentionSource, - dockToSidebarTab, - }; - return module.exports; - }, -}); diff --git a/panel/lib/model.js b/panel/lib/model.js deleted file mode 100644 index 3fee34f..0000000 --- a/panel/lib/model.js +++ /dev/null @@ -1,260 +0,0 @@ -// 三省六部:纯逻辑层(不依赖 React / DOM),便于在 node --test 中直接验证。 -// 这些函数只做数据投影与协议拼装:成员编排、状态归并、下旨文本、模型目录展开。 - -export const ROLE_IDS = Object.freeze(['lead', 'zhongshu', 'menxia', 'shangshu', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu']) - -export const ROLE_LABELS = Object.freeze({ - lead: '丞相', - zhongshu: '中书省', - menxia: '门下省', - shangshu: '尚书省', - libu: '吏部', - hubu: '户部', - lipu: '礼部', - bingbu: '兵部', - xingbu: '刑部', - gongbu: '工部', -}) - -export const ROLE_MARKS = Object.freeze({ - lead: '丞', - zhongshu: '中', - menxia: '门', - shangshu: '尚', - libu: '吏', - hubu: '户', - lipu: '礼', - bingbu: '兵', - xingbu: '刑', - gongbu: '工', -}) - -export const ROLE_DUTIES = Object.freeze({ - lead: '统筹全局,向用户汇报,最终交付', - zhongshu: '拟案规划,拆解任务与验收标准', - menxia: '审议准奏与交付验收,可否决', - shangshu: '派工调度,合成各部门成果', - libu: 'Agent 与技能维护、成员编制', - hubu: '数据、表格与计算,可复算结论', - lipu: '文档、汇报与可视化产出', - bingbu: '环境运行、调试与部署,掌武库', - xingbu: '按风险的专项测试与独立验证', - gongbu: '编码与工程实现', -}) - -/** 朝堂图布局:丞相居中在顶,三省为中层(左中书、中尚书、右门下),六部直隶尚书。 */ -export const LAYOUT = Object.freeze({ - lead: { row: 0, column: 'lead' }, - zhongshu: { row: 1, column: 'zhongshu' }, - shangshu: { row: 1, column: 'shangshu' }, - menxia: { row: 1, column: 'menxia' }, - libu: { row: 2, column: 'one' }, - hubu: { row: 2, column: 'two' }, - lipu: { row: 2, column: 'three' }, - bingbu: { row: 2, column: 'four' }, - xingbu: { row: 2, column: 'five' }, - gongbu: { row: 2, column: 'six' }, -}) - -export const STATUS_LABELS = Object.freeze({ - running: '运行中', - inactive: '空闲', - provisioning: '创建中', - failed: '失败', - absent: '未设官', -}) - -export const TASK_STATUS_LABELS = Object.freeze({ - pending: '待办', - in_progress: '执行中', - completed: '已完成', -}) - -/** 把 agentTeam 投影按官职编排成固定十席,缺员以 absent 占位,保证图结构稳定。 */ -export function arrangeRoster(team) { - const members = Array.isArray(team?.members) ? team.members : [] - const byRole = new Map() - for (const member of members) { - if (member?.name === undefined) continue - byRole.set(member.name, member) - } - return ROLE_IDS.map((role) => { - const member = byRole.get(role) - return { - role, - label: ROLE_LABELS[role], - mark: ROLE_MARKS[role], - duty: ROLE_DUTIES[role], - layout: LAYOUT[role], - id: member?.id, - member, - present: member !== undefined, - } - }) -} - -/** 运行状态(会话是否在跑)与任务状态(共享任务)必须分开表达,不能互相覆盖。 */ -export function memberStatus(member, running, summaryRunning) { - if (member === undefined) return 'absent' - if (member.phase !== undefined && member.phase !== 'active') return member.phase - return running === true || summaryRunning === true ? 'running' : 'inactive' -} - -export function roleLabel(role) { - return ROLE_LABELS[role] ?? '成员' -} - -export function roleMark(role) { - return ROLE_MARKS[role] ?? '员' -} - -export function modelLabel(model) { - if (typeof model === 'string') return model - if (!model || typeof model !== 'object') return '' - if (typeof model.name === 'string') return model.name - if (typeof model.model === 'string') return model.model - if (typeof model.id === 'string') return model.id - return '' -} - -export function effortLabel(effort) { - if (typeof effort !== 'string') return '' - const table = { minimal: '极低', low: '低', medium: '中', high: '高', max: '最高', xhigh: '极高' } - return table[effort] ?? effort -} - -export function taskBuckets(team) { - const tasks = Array.isArray(team?.tasks) ? team.tasks : [] - const buckets = { pending: [], in_progress: [], completed: [] } - for (const task of tasks) { - const key = task?.status - if (key === 'pending' || key === 'in_progress' || key === 'completed') buckets[key].push(task) - else buckets.pending.push(task) - } - return buckets -} - -export function tasksOfRole(team, role) { - const tasks = Array.isArray(team?.tasks) ? team.tasks : [] - return tasks.filter((task) => task?.ownerName === role || task?.ownerName === roleLabel(role)) -} - -/** 所选成员的运行状态 + 任务状态摘要,供图下配置区展示。 */ -export function statusSummary(seat, team, running, summaryRunning) { - const status = memberStatus(seat?.member, running, summaryRunning) - const owned = seat?.role === undefined ? [] : tasksOfRole(team, seat.role) - const buckets = taskBuckets({ tasks: owned }) - return { - status, - statusLabel: STATUS_LABELS[status] ?? status, - owned, - runningCount: buckets.in_progress.length, - pendingCount: buckets.pending.length, - completedCount: buckets.completed.length, - } -} - -/** 模型目录展开成扁平选项:每组 id 即 provider,行 id 为 provider/model。 */ -export function modelOptions(catalog) { - const options = [] - const groups = Array.isArray(catalog?.groups) ? catalog.groups : [] - for (const group of groups) { - const provider = group?.id ?? group?.provider - for (const model of Array.isArray(group?.models) ? group.models : []) { - if (!provider || !model?.id) continue - const efforts = Array.isArray(model.reasoning?.efforts) - ? model.reasoning.efforts.map((effort) => ({ id: effort.id, name: effort.name ?? effortLabel(effort.id) })) - : [] - options.push({ - provider, - model: model.id, - rowId: `${provider}/${model.id}`, - label: model.name ?? model.id, - efforts, - defaultEffort: model.reasoning?.defaultEffort, - }) - } - } - return options -} - -export function findModelOption(options, current) { - if (!current?.provider || !current?.model) return undefined - return options.find((option) => option.provider === current.provider && option.model === current.model) -} - -/** - * 下旨文本:把用户输入包装成明确的“切到某部门执行”指令,并附带当前朝堂上下文。 - * 部门会话是受控子会话,直接投递文本仍受角色提示词约束。 - */ -export function decreeText(role, text, team) { - const body = String(text ?? '').trim() - if (body === '') return '' - const buckets = taskBuckets(team) - const active = buckets.in_progress.map((task) => task.subject ?? task.title ?? task.id).filter(Boolean) - const head = `【丞相下旨 · ${roleLabel(role)}】` - const context = active.length > 0 ? `\n当前在办:${active.join(';')}` : '' - return `${head}\n${body}${context}` -} - -/** 交付物“部分 → 主责部门”清单:把共享任务按负责人归组成部门小结。 */ -export function deliverySummary(team) { - const tasks = Array.isArray(team?.tasks) ? team.tasks : [] - const byRole = new Map() - for (const task of tasks) { - const owner = task?.ownerName ?? 'lead' - const key = ROLE_IDS.includes(owner) ? owner : 'lead' - if (!byRole.has(key)) byRole.set(key, []) - byRole.get(key).push(task) - } - return ROLE_IDS.filter((role) => byRole.has(role)).map((role) => ({ - role, - label: ROLE_LABELS[role], - tasks: byRole.get(role), - completed: byRole.get(role).filter((task) => task?.status === 'completed').length, - })) -} - -export function shortText(value, limit = 120) { - const text = String(value ?? '').replace(/\s+/g, ' ').trim() - return text.length <= limit ? text : `${text.slice(0, limit - 1)}…` -} - -/** 从 chat 快照里取最后一条用户指令与最后一条助手文本,用于卡片上的“最近动静”。 */ -export function lastExchange(snapshot) { - if (!snapshot || typeof snapshot !== 'object') return { lastUser: '', lastAssistant: '' } - const nodes = [] - const values = typeof snapshot.nodes?.values === 'function' ? snapshot.nodes.values() : [] - for (const key of Array.isArray(values) ? values : Array.from(values ?? [])) { - const node = typeof snapshot.nodes?.get === 'function' ? snapshot.nodes.get(key) : undefined - if (node !== undefined) nodes.push(node) - } - let lastUser = '' - let lastAssistant = '' - for (const node of nodes) { - if (node.kind === 'user') { - const text = (Array.isArray(node.data?.content) ? node.data.content : []) - .filter((block) => block?.type === 'text') - .map((block) => block.text) - .join('\n') - if (text.trim() !== '') lastUser = shortText(text, 160) - } else if (node.kind === 'assistant-step') { - const text = (Array.isArray(node.data?.blocks) ? node.data.blocks : []) - .filter((block) => block?.kind === 'text') - .map((block) => block.text) - .join('\n') - if (text.trim() !== '') lastAssistant = shortText(text, 200) - } - } - return { lastUser, lastAssistant } -} - -/** 校验一次模型切换请求;子代理会话不允许改模型,返回原因便于提示。 */ -export function modelSwitchPlan(current, next, addressesSubagent) { - if (addressesSubagent === true) return { ok: false, reason: '子会话不能单独更换模型,请在丞相会话或新建会话时设置' } - if (!next?.provider || !next?.model) return { ok: false, reason: '未选择模型' } - const same = current?.provider === next.provider && current?.model === next.model - const effort = next.reasoningEffort ?? undefined - if (same && (current?.reasoningEffort ?? undefined) === effort) return { ok: false, reason: '与当前设置相同' } - return { ok: true, payload: { provider: next.provider, model: next.model, ...(effort === undefined ? {} : { reasoningEffort: effort }) } } -} diff --git a/panel/package.json b/panel/package.json deleted file mode 100644 index dcbe417..0000000 --- a/panel/package.json +++ /dev/null @@ -1,44 +0,0 @@ -{ - "name": "dsh-sansheng-liubu-panel", - "version": "0.9.2", - "private": true, - "description": "三省六部 Agent 面板:在 DSH Web GUI 中常驻显示并切换团队 Agent", - "type": "module", - "main": "./index.js", - "exports": { - ".": "./index.js", - "./client": "./lib/client.js", - "./package.json": "./package.json" - }, - "files": [ - "index.js", - "cordis.patch.yml", - "lib/client.js", - "README.md", - "panel/test", - "scripts", - "icon.svg", - "locale" - ], - "dsh": { - "manifestVersion": 1, - "bundle": { - "patch": "./cordis.patch.yml" - }, - "client": { - "platform": "web", - "inject": [ - "@deepseek-ai/dsh-api-session-controller", - "@deepseek-ai/dsh-client-locale", - "@deepseek-ai/dsh-client-ui-conversation", - "@deepseek-ai/dsh-client-ui-primitives", - "@deepseek-ai/dsh-client-ui-workspace", - "@deepseek-ai/dsh-client-ui-model-selection" - ] - } - }, - "peerDependencies": { - "@deepseek-ai/cordis": "~4.0.5" - }, - "license": "MIT" -} diff --git a/panel/test/client.test.js b/panel/test/client.test.js deleted file mode 100644 index f9479ea..0000000 --- a/panel/test/client.test.js +++ /dev/null @@ -1,1121 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { readFileSync } from 'node:fs' -import { fileURLToPath } from 'node:url' -import { dirname, join } from 'node:path' -import vm from 'node:vm' - -const here = dirname(fileURLToPath(import.meta.url)) -const source = readFileSync(join(here, '..', 'lib', 'client.js'), 'utf8') - -/** 用最小 React 替身加载客户端 bundle:只实现面板实际用到的钩子。 */ -function loadPlugin() { - let loaded - let styleCount = 0 - const React = { - createElement: (type, props, ...children) => ({ type, props: props ?? {}, children }), - createContext: (value) => ({ Provider: 'provider', value }), - Component: class { constructor(props) { this.props = props; this.state = {} } }, - useContext: () => undefined, - Fragment: 'fragment', - useState: (initial) => [typeof initial === 'function' ? initial() : initial, () => {}], - useRef: () => ({ current: null }), - useEffect: () => {}, - useCallback: (fn) => fn, - useMemo: (fn) => fn(), - } - const ReactDOM = { createPortal: (node) => node } - let cssText = '' - const document = { - getElementById: () => null, - querySelector: () => null, - createElement: () => { - const tag = { dataset: {}, appendChild() {}, setAttribute() {} } - let text = '' - Object.defineProperty(tag, 'textContent', { - get: () => text, - set: (value) => { text = String(value); cssText = text }, - }) - return tag - }, - head: { appendChild() { styleCount += 1 } }, - addEventListener() {}, - removeEventListener() {}, - body: {}, - } - const window = { - __ModuleLoader__: { - load(options) { - loaded = options - const module = { exports: options.factory((name) => { - if (name === 'react') return React - if (name === 'react-dom') return ReactDOM - if (name === 'react/jsx-runtime') return { jsx: () => null, jsxs: () => null, Fragment: 'fragment' } - throw new Error('unexpected require: ' + name) - }) } - loaded.exports = module.exports - }, - }, - } - const storage = new Map() - const localStorage = { - getItem: (key) => (storage.has(key) ? storage.get(key) : null), - setItem: (key, value) => { storage.set(key, String(value)) }, - removeItem: (key) => { storage.delete(key) }, - } - vm.runInNewContext(source, { window, document, console, URL, Map, Set, WeakMap, Promise, setTimeout, clearTimeout, localStorage }, { filename: 'client.js' }) - return { loaded, exports: loaded.exports, styleCount: () => styleCount, css: () => cssText, storage } -} - -/** 全局模型清单的样板值:宿主一代只给一份,任何会话读到的都是它。 */ -const CATALOG_VALUE = { - default: { provider: 'deepseek', model: 'deepseek-chat' }, - failures: [], - groups: [ - { - id: 'deepseek', - name: 'DeepSeek', - models: [ - { id: 'deepseek-chat', name: 'DeepSeek Chat' }, - { id: 'deepseek-reasoner', name: 'DeepSeek Reasoner', reasoning: { defaultEffort: 'high', efforts: [{ id: 'high', name: '高' }] } }, - ], - }, - ], -} - -/** 模拟宿主 ctx:只实现面板调用到的服务面。 */ -function mockContext(prompts = []) { const registrations = [] - const injected = [] - const selections = [] - const tabTypes = [] - const openTabs = [] - let selection = { sessionId: 'lead-1' } - const sessionIds = ['lead-1'] - const sessionById = { 'lead-1': { id: 'lead-1', updatedAt: 1 } } - const sessionList = { - getSnapshot: () => ({ ids: sessionIds.slice(), byId: sessionById, projectionsBySession: {} }), - subscribe: () => () => {}, - } - const addSession = (id, workspaceId) => { - sessionIds.push(id) - sessionById[id] = { id, workspaceId, updatedAt: Date.now() } - return id - } - const selectionStore = { - getSnapshot: () => selection, - subscribe: () => () => {}, - set: (next) => { selection = next; selections.push(next) }, - } - let startSessionImpl - const ctx = { - effect(callback) { const dispose = callback(); return typeof dispose === 'function' ? dispose : () => {} }, - sessions: { - list: sessionList, - binding(sessionId) { - return { session: { prompt: async (parts, mode) => { prompts.push({ sessionId, parts, mode }); return { ok: true } } } } - }, - subagentAddress: () => undefined, - refreshProjections: async () => {}, - }, - uiWorkspace: { - selection: selectionStore, - currentWorkspaceId: 'test-workspace', - startSession(workspaceId, options) { if (startSessionImpl) startSessionImpl(workspaceId, options) }, - openSession(target) { selections.push(target) }, - }, - uiConversation: { binding: () => ({ target: () => ({ getSnapshot: () => undefined }) }) }, - modelDirectories: { - catalog: { - load: async () => CATALOG_VALUE, - store: { getSnapshot: () => ({ value: CATALOG_VALUE, status: 'ready', error: null }) }, - }, - directoryFor: () => ({ - load: async () => {}, - select: async () => ({ ok: true }), - store: { getSnapshot: () => ({ current: { provider: 'p', model: 'm' }, groups: [], failures: [], status: 'ready', error: null }) }, - }), - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - commands: { execute: async () => ({ ok: true, value: { commandId: 'cmd-1', result: { kind: 'success' } } }) }, - subagents: { prompt: async () => ({ messageId: 'msg-1' }) }, - }, - layout: { selectPanel(id) { selections.push(id) } }, - get(name) { - if (name === 'remote.commands') return ctx.remote.commands - if (name === 'remote.session') return ctx.remote.session - if (name === 'remote.subagents') return ctx.remote.subagents - return undefined - }, - sidebarRightTabs: { register(descriptor) { tabTypes.push(descriptor); return () => {} } }, - sidebarRight: { - openTab(kind, options) { openTabs.push({ sessionId: undefined, kind, options }) }, - openTabIn(sessionId, kind, options) { openTabs.push({ sessionId, kind, options }) }, - }, - slots: { - register(options, component) { - registrations.push({ options, component }) - return () => {} - }, - inject(slotName, callback) { - injected.push(slotName) - return callback() - }, - }, - } - return { - ctx, - registrations, - injected, - selections, - tabTypes, - openTabs, - prompts, - addSession, - setStartSession(fn) { startSessionImpl = fn }, - portal: { getSnapshot: () => ({}), subscribe: () => () => {} }, - } -} - -test('registers one web client bundle entry', () => { - const { loaded } = loadPlugin() - assert.equal(loaded.id, 'dsh-sansheng-liubu-panel') -}) - -test('exports the panel and the seat mention helpers', () => { - const { exports } = loadPlugin() - assert.equal(typeof exports.apply, 'function') - assert.equal(exports.PANEL_ID, 'sansheng-liubu') - assert.equal(typeof exports.SanshengPanel, 'function') - assert.equal(JSON.stringify(exports.inject), JSON.stringify(['slots', 'sessions', 'uiWorkspace', 'uiConversation', 'modelDirectories', 'remote', 'remote.agentPresets', 'remote.session', 'remote.subagents', 'remote.commands', 'sidebarRightTabs', 'sidebarRight'])) -}) - -test('registers the left nav row, one rail entry, the native header action and right sidebar tabs', () => { - const { exports } = loadPlugin() - const { ctx, registrations, injected } = mockContext() - exports.apply(ctx) - assert.deepEqual(injected, ['conversation.session.header.actions', 'sidebar.panellist', 'main', 'sidebar.right.pane.tab', 'sidebar.right.pane.tab.title']) - assert.equal(typeof exports.createHost(ctx).sendPrompt, 'function') - const toggle = registrations.find((entry) => entry.options.name === 'conversation.session.header.actions') - assert.ok(toggle, '会话头保留打开朝堂侧栏的入口') - assert.equal(toggle.options.id, 'sansheng-liubu:toggle') - const nav = registrations.find((entry) => entry.options.name === 'sidebar.panellist') - assert.ok(nav, '左侧栏导航列也有入口') - assert.equal(nav.options.id, 'sansheng-liubu') - assert.equal(nav.options.label(), '上朝', '用户要求这行叫「上朝」') - assert.ok(nav.options.order < 0, '要排在其它插件行之前(置顶)') - assert.ok(Number.isFinite(nav.options.order), '导航列要给出排序,才能稳定落在固定位置') - const stub = registrations.find((entry) => entry.options.name === 'main') - assert.ok(stub, '那一列的点击会索取 main 槽,必须有落点') - assert.equal(stub.options.key, 'sansheng-liubu', 'main 用 key 与侧栏行对齐,不是再开一套面板') - const tab = registrations.find((entry) => entry.options.name === 'sidebar.right.pane.tab') - assert.ok(tab, '右侧栏注册朝堂页签') - assert.equal(tab.options.key, 'sansheng-liubu-tab') -}) - -test('左栏导航图标的「三」字样标按激活状态换描边', () => { - const { exports } = loadPlugin() - const { ctx, registrations } = mockContext() - exports.apply(ctx) - const nav = registrations.find((entry) => entry.options.name === 'sidebar.panellist') - // 注册项返回 h(SanshengNavGlyph, props),再调用一次才是真正的 svg 节点。 - const glyphOf = (props) => { - const wrapper = nav.component(props) - return wrapper.type(wrapper.props) - } - const idle = glyphOf({ size: 18, active: false }) - const active = glyphOf({ size: 18, active: true }) - assert.equal(idle.type, 'svg') - assert.equal(idle.props.width, 18) - assert.equal(idle.props['data-sansheng-glyph'], 'idle') - assert.equal(active.props['data-sansheng-glyph'], 'active') - // 替身的 createElement 把可变参数放进 children,数组实参会成为单层嵌套,这里拉平。 - const kids = (idle.children || []).flat() - assert.equal(kids.length, 4, '外框 + 三横') - const activeKids = (active.children || []).flat() - assert.ok(activeKids[0].props.strokeWidth > kids[0].props.strokeWidth, '激活态加粗') -}) - -test('导航列点击后把朝堂停靠到右侧栏,再退回原会话', () => { - const { exports } = loadPlugin() - const { dockToSidebarTab } = exports.__test - const calls = [] - const okHost = { - openSanshengTab: () => ({ ok: true }), - setToggleNotice: (value) => calls.push(['notice', value]), - selectPanel: (id) => calls.push(['selectPanel', id]), - } - assert.equal(dockToSidebarTab(okHost), null) - assert.deepEqual(calls, [['notice', null], ['selectPanel', null]], '成功后清掉提示并退出 main 槽') - - calls.length = 0 - const failHost = { - openSanshengTab: () => ({ ok: false, error: '当前还没有打开任何会话' }), - setToggleNotice: (value) => calls.push(['notice', value]), - selectPanel: (id) => calls.push(['selectPanel', id]), - } - assert.equal(dockToSidebarTab(failHost), '当前还没有打开任何会话') - assert.deepEqual(calls, [['notice', '当前还没有打开任何会话']], '失败时只写提示,不能把人留在一个不存在的面板上') -}) - - -test('summarizes the court into four sidebar stats', () => { - const { exports } = loadPlugin() - const { arrangeRoster, courtStats } = exports.__test - const seats = arrangeRoster({ - members: [ - { id: 'lead-1', name: 'lead', phase: 'active' }, - { id: 'z-1', name: 'zhongshu', phase: 'active' }, - { id: 'g-1', name: 'gongbu', phase: 'provisioning' }, - ], - tasks: [], - }) - const buckets = { - pending: [{ id: 'p1' }, { id: 'p2' }], - in_progress: [{ id: 'r1' }], - completed: [{ id: 'c1' }, { id: 'c2' }, { id: 'c3' }], - } - const running = new Set(['lead-1', 'z-1', 'g-1']) - const stats = Array.from(courtStats(seats, buckets, (entry) => running.has(entry.id))) - assert.deepEqual(Array.from(stats, (stat) => stat.label), ['在朝成员', '正在运行', '在办任务', '已完成']) - assert.deepEqual(Array.from(stats, (stat) => stat.value), [3, 3, 3, 3], '在办任务包含执行中与待办任务') - assert.deepEqual(Array.from(stats, (stat) => stat.key), ['members', 'running', 'pending', 'done']) - assert.deepEqual(Array.from(courtStats(undefined, undefined, () => true), (stat) => stat.value), [0, 0, 0, 0]) -}) - -test('lays the roster out as 丞相 / 三省 / 六部', () => { - const { exports } = loadPlugin() - const { arrangeRoster } = exports.__test - const seats = arrangeRoster({ - members: [ - { id: 'lead-1', name: 'lead', phase: 'active' }, - { id: 'z-1', name: 'zhongshu', phase: 'active' }, - { id: 'g-1', name: 'gongbu', phase: 'provisioning' }, - ], - tasks: [], - }) - assert.equal(seats.length, 10) - const byRole = Object.fromEntries(seats.map((seat) => [seat.role, seat])) - assert.equal(byRole.lead.row, 0) - assert.equal(byRole.zhongshu.row, 1) - assert.equal(byRole.shangshu.row, 1) - assert.equal(byRole.menxia.row, 1) - assert.equal(byRole.zhongshu.column, 0) - assert.equal(byRole.shangshu.column, 1) - assert.equal(byRole.menxia.column, 2) - assert.equal(byRole.gongbu.row, 2) - assert.equal(byRole.gongbu.present, true) - assert.equal(byRole.gongbu.id, 'g-1') - assert.equal(byRole.libu.present, false, '未设官的部门仍占位') - assert.equal(byRole.zhongshu.label, '中书省') - assert.deepEqual( - ['libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu'].map((role) => byRole[role].label), - ['吏部', '户部', '礼部', '兵部', '刑部', '工部'], - ) - assert.deepEqual( - ['libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu'].map((role) => byRole[role].row), - [2, 2, 2, 2, 2, 2], - '六部直属尚书省,同在第 2 排', - ) -}) - -test('exposes department sessions as native @ mention candidates', async () => { - const { exports } = loadPlugin() - const { arrangeRoster, seatMentionOptions, childRoleOf } = exports.__test - const seats = arrangeRoster({ - members: [ - { id: 'lead-1', name: 'lead', phase: 'active' }, - { id: 'z-1', name: 'zhongshu', phase: 'active' }, - { id: 'g-1', name: 'gongbu', phase: 'active' }, - ], - tasks: [], - }) - const options = seatMentionOptions(seats) - assert.deepEqual(Array.from(options, (item) => item.label), ['中书省', '工部']) - assert.deepEqual(Array.from(options, (item) => item.value), ['z-1', 'g-1']) - assert.match(options[1].description, /选择后进入该部门会话/) - assert.equal(childRoleOf(seats, 'g-1'), 'gongbu') - assert.equal(childRoleOf(seats, 'unknown'), undefined) - - const sources = [] - const { ctx } = mockContext() - ctx.get = (name) => name === 'inputTriggers' - ? { registerSource(source) { sources.push(source); return () => {} } } - : undefined - exports.apply(ctx) - assert.equal(sources.length, 1) - assert.equal(sources[0].trigger, '@') - - const { createSeatMentionSource } = exports.__test - let opened - const source = createSeatMentionSource({ - sessions: { - list: { getSnapshot: () => ({ projectionsBySession: { 'lead-1': { values: { agentTeam: { - members: [ - { id: 'lead-1', name: 'lead', phase: 'active' }, - { id: 'z-1', name: 'zhongshu', phase: 'active' }, - { id: 'g-1', name: 'gongbu', phase: 'active' }, - ], - } } } } }) }, - subagentAddress: () => ({ parentSessionId: 'lead-1', childSessionId: 'child-1' }), - }, - uiWorkspace: { selection: { getSnapshot: () => ({ sessionId: 'child-1' }) } }, - }, { openSession: (id) => { opened = id } }) - const matched = Array.from(await source.candidates({ sessionId: 'child-1' }, { query: '工' })) - assert.deepEqual(Array.from(matched, (item) => item.label), ['工部']) - const outcome = source.onPick({ candidate: matched[0] }) - assert.equal(outcome.text, '') - assert.deepEqual(Object.keys(outcome), ['text']) - await Promise.resolve() - assert.equal(opened, 'g-1') -}) - -test('separates running state from task state', () => { - const { exports } = loadPlugin() - const { memberStatus, bucketsOf, tasksOfRole, statusSummary } = exports.__test - assert.equal(memberStatus({ phase: 'active' }, true, false), 'running') - assert.equal(memberStatus({ phase: 'active' }, false, false), 'idle') - assert.equal(memberStatus({ phase: 'provisioning' }, false, false), 'provisioning') - assert.equal(memberStatus({ phase: 'failed' }, false, false), 'failed') - assert.equal(memberStatus(undefined, false, false), 'absent') - const tasks = [ - { id: 't1', subject: '规模', status: 'in_progress', ownerName: 'zhongshu' }, - { id: 't2', subject: '核对', status: 'completed', ownerName: 'menxia' }, - { id: 't3', subject: '备料', status: 'pending', ownerName: 'shangshu' }, - ] - const buckets = bucketsOf(tasks) - assert.equal(buckets.pending.length, 1) - assert.equal(buckets.in_progress.length, 1) - assert.equal(buckets.completed.length, 1) - assert.equal(tasksOfRole(tasks, 'menxia').length, 1) - const summary = statusSummary({ role: 'zhongshu', member: { phase: 'active' } }, { tasks }, true, false) - assert.equal(summary.status, 'running') - assert.equal(summary.statusLabel, '运行中') - assert.equal(summary.runningCount, 1) -}) - -test('builds model options with reasoning efforts', () => { - const { exports } = loadPlugin() - const { modelOptions, findModelOption, modelSwitchPlan } = exports.__test - const options = modelOptions({ - groups: [{ id: 'moonshotai-cn', models: [{ id: 'kimi-k3', name: 'Kimi K3', reasoning: { efforts: [{ id: 'high', name: '高' }], defaultEffort: 'high' } }] }], - }) - assert.equal(options.length, 1) - assert.equal(options[0].rowId, 'moonshotai-cn/kimi-k3') - assert.equal(options[0].provider, 'moonshotai-cn') - assert.equal(options[0].model, 'kimi-k3') - assert.equal(options[0].defaultEffort, 'high') - assert.equal(findModelOption(options, { provider: 'moonshotai-cn', model: 'kimi-k3' }).model, 'kimi-k3') - const plan = modelSwitchPlan({ provider: 'x', model: 'y' }, { provider: 'moonshotai-cn', model: 'kimi-k3', reasoningEffort: 'high' }, false) - assert.equal(plan.ok, true) - assert.equal(plan.payload.provider, 'moonshotai-cn') - assert.equal(plan.payload.reasoningEffort, 'high') - const subagentPlan = modelSwitchPlan(undefined, { provider: 'a', model: 'b' }, true) - assert.equal(subagentPlan.ok, true, '子会话改模型走模式插件的部门路由') - assert.equal(subagentPlan.via, 'command') - assert.equal(modelSwitchPlan({ provider: 'a', model: 'b' }, { provider: 'a', model: 'b' }, true).ok, false, '同样的选择不必再保存') -}) - -test('formats a decree with the target department', () => { - const { exports } = loadPlugin() - const text = exports.__test.decreeText('gongbu', ' 补一版安装脚本 ', { - tasks: [{ id: 't9', subject: '打包', status: 'in_progress' }], - }) - assert.match(text, /工部/) - assert.match(text, /补一版安装脚本/) - assert.match(text, /打包/) - assert.equal(exports.__test.decreeText('gongbu', ' ', {}), '') -}) - -test('reads the latest exchange from chat nodes', () => { - const { exports } = loadPlugin() - const exchange = exports.__test.lastExchange([ - { kind: 'user', anchorSeq: 1, data: { content: [{ type: 'text', text: '拟一份方案' }] } }, - { kind: 'assistant', anchorSeq: 2, data: { blocks: [{ kind: 'text', text: '已有方案草稿' }] } }, - ]) - assert.equal(exchange.lastUser, '拟一份方案') - assert.equal(exchange.lastAssistant, '已有方案草稿') -}) - -test('delivers a decree into the selected department session', async () => { - const { exports } = loadPlugin() - const prompts = [] - const { ctx } = mockContext(prompts) - exports.apply(ctx) - const host = exports.createHost(ctx) - const result = await host.sendPrompt('gongbu-1', '补一版安装脚本') - assert.equal(result.ok, true) - assert.equal(prompts.length, 1) - assert.equal(prompts[0].sessionId, 'gongbu-1') - assert.equal(prompts[0].mode, 'queue') - assert.equal(prompts[0].parts[0].text, '补一版安装脚本') -}) - -test('registers its page through better-sidebar when that plugin is installed', () => { - const { exports } = loadPlugin() - const { ctx, tabTypes, openTabs } = mockContext() - const registered = [] - ctx.betterSidebar = { - registerTab(descriptor) { registered.push(descriptor); return () => {} }, - openTab(seed, scope) { openTabs.push({ seed, scope }) }, - } - exports.apply(ctx) - - // 让位给 better-sidebar:不再重复注册宿主原生 tab 类型。 - assert.equal(tabTypes.length, 0) - assert.equal(registered.length, 1) - const descriptor = registered[0] - assert.equal(descriptor.id, exports.SANSENG_TAB_ID) - assert.equal(descriptor.single, true) - assert.equal(typeof descriptor.component, 'function') - - const host = exports.createHost(ctx) - const result = host.openSanshengTab('lead-1') - assert.equal(result.ok, true) - assert.equal(openTabs.length, 1) - assert.equal(openTabs[0].seed.type, exports.SANSENG_TAB_ID) - assert.equal(openTabs[0].scope.sessionId, 'lead-1') - - const tree = descriptor.component({ scope: { sessionId: 'lead-1' }, host }) - const panelEl = tree.children[0] - const rendered = panelEl.type(panelEl.props) - assert.equal(rendered.props['data-sansheng-compact'], '1', '朝堂页以紧凑形态渲染到侧边栏') -}) - -test('falls back to the newest session when nothing is selected', () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - // 空选中记录:模拟用户还没点开任何会话就打开朝堂页。 - ctx.uiWorkspace.selection.getSnapshot = () => ({}) - ctx.sessions.list.getSnapshot = () => ({ - ids: ['old-1', 'new-1', 'blank-1'], - byId: { - 'old-1': { id: 'old-1', updatedAt: '2026-11-01T00:00:00.000Z' }, - 'new-1': { id: 'new-1', updatedAt: '2026-11-07T00:00:00.000Z' }, - 'blank-1': { id: 'blank-1', blank: true, updatedAt: '2026-11-09T00:00:00.000Z' }, - }, - projectionsBySession: {}, - }) - exports.apply(ctx) - const host = exports.createHost(ctx) - assert.equal(host.getSelectedSession(), 'new-1') -}) - -test('opens an addressed child conversation with its parent', () => { - const { exports } = loadPlugin() - const { ctx, selections } = mockContext() - ctx.sessions.list.getSnapshot = () => ({ - ids: ['lead-1', 'child-1'], - byId: { 'child-1': { id: 'child-1', subagent: { address: { parentSessionId: 'lead-1', childSessionId: 'child-1' } } } }, - projectionsBySession: {}, - }) - exports.apply(ctx) - const host = exports.createHost(ctx) - host.openSession('child-1') - const target = selections.find((entry) => entry && typeof entry === 'object' && entry.childSessionId === 'child-1') - assert.ok(target, '子会话按 parent/child 地址打开') - assert.equal(target.parentSessionId, 'lead-1') - assert.equal(target.mode, 'continuable') -}) - -/** - * 回归:右侧栏页签由宿主注入 props,不应依赖会话级 hook 才能渲染; - * 面板必须只靠 host 的服务层 store 就能出图,否则会整片空白。 - */ -test('sidebar panel renders without slot-provided session hooks', () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - exports.apply(ctx) - const tree = exports.SanshengPanel({ host: exports.createHost(ctx) }) - let hasRoot = false - const classes = new Set() - const walk = (node) => { - if (Array.isArray(node)) { node.forEach(walk); return } - if (!node || typeof node !== 'object') return - const cls = node.props && node.props.className - if (typeof cls === 'string') { - cls.split(' ').forEach((name) => classes.add(name)) - if (cls.split(' ').includes('sl-root')) hasRoot = true - } - walk(node.children) - } - walk(tree) - assert.equal(hasRoot, true, '无会话级 hook 时仍渲染出面板根节点') - for (const name of ['sl-side-meta', 'sl-side-tabs', 'sl-map-head', 'sl-detail-title']) { - assert.ok(classes.has(name), `新版侧栏缺少 ${name}`) - } - assert.equal(classes.has('sl-left'), false, '侧栏形态不再包含独立聊天栏') - assert.equal(classes.has('sl-conv'), false) -}) - -test('renders a card-first court and a settings panel without duplicate decree input', () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - ctx.sessions.list.getSnapshot = () => ({ - ids: ['lead-1'], - byId: { 'lead-1': { id: 'lead-1' } }, - projectionsBySession: { - 'lead-1': { - values: { - agentTeam: { - members: [{ id: 'lead-1', name: 'lead', phase: 'active' }], - tasks: [], - }, - }, - }, - }, - }) - exports.apply(ctx) - const tree = exports.SanshengPanel({ host: exports.createHost(ctx) }) - const nodes = [] - const childrenOf = (node) => { - if (Array.isArray(node.children) && node.children.length > 0) return node.children - return node.props && node.props.children - } - const walk = (node) => { - if (Array.isArray(node)) { node.forEach(walk); return } - if (!node || typeof node !== 'object') return - nodes.push(node) - walk(childrenOf(node)) - } - walk(tree) - const seatElements = nodes.filter((node) => typeof node.type === 'function' && node.type.name === 'SeatCard') - assert.equal(seatElements.length, 10, '朝堂图始终保留十席卡片') - seatElements.forEach((node) => walk(node.type(node.props))) - const withClass = (name) => nodes.filter((node) => node.type && String(node.props?.className || '').split(' ').includes(name)) - const textOf = (node) => { - if (typeof node === 'string' || typeof node === 'number') return String(node) - if (Array.isArray(node)) return node.map(textOf).join('') - if (!node || typeof node !== 'object') return '' - return textOf(childrenOf(node)) - } - - assert.equal(withClass('sl-node').length, 10, '朝堂图始终保留十席卡片') - assert.equal(withClass('sl-node-check').length, 1, '只有当前部门显示选中勾') - assert.equal(withClass('sl-node-status').length, 10, '每张卡片都有独立状态行') - assert.equal(withClass('sl-ministry-group').length, 1, '六部收在同一个尚书省分组') - assert.equal(withClass('sl-sidebar').length, 1, '根节点是右侧栏形态') - assert.equal(withClass('sl-side-tabs').length, 1, '侧栏顶部有朝堂/任务切换') - assert.equal(nodes.filter((node) => node.props && node.props['data-side-tab']).length, 2) - assert.match(textOf(withClass('sl-side-tabs')[0]), /朝堂/) - assert.match(textOf(withClass('sl-side-tabs')[0]), /任务/) - assert.equal(withClass('sl-side-court').length, 1, '默认展示朝堂编制') - const courtTab = nodes.find((node) => node.props && node.props['data-side-tab'] === 'court') - assert.equal(courtTab.props['aria-selected'], true) - assert.equal(withClass('sl-left').length, 0, '不再保留重复的左侧聊天栏') - assert.equal(withClass('sl-conv').length, 0) - assert.equal(withClass('sl-left-nav').length, 0) - assert.equal(withClass('sl-task-jump').length, 0) - assert.equal(nodes.filter((node) => node.props && node.props['data-task-flow-jump'] === '1').length, 0) - assert.equal(withClass('sl-stat-pending')[0].type, 'button', '在办任务统计可直接切换到任务流转') - assert.equal(withClass('sl-stat-members')[0].type, 'button', '在朝成员统计可直接进入朝堂编制') - assert.equal(withClass('sl-stat-members')[0].props.title, '查看朝堂编制') - assert.equal(typeof withClass('sl-stat-members')[0].props.onClick, 'function') - const grid = withClass('sl-grid-6')[0] - assert.ok(grid, '六部使用独立网格') - const gridKids = Array.isArray(childrenOf(grid)) ? childrenOf(grid).flat(2) : [] - assert.equal(gridKids.filter((node) => typeof node?.type === 'function' && node.type.name === 'SeatCard').length, 6) - assert.equal(withClass('sl-conversation-action').length, 1, '设置区有明确的子 Agent 对话入口') - assert.match(textOf(withClass('sl-conversation-action')[0]), /丞相主会话/) - assert.equal(withClass('sl-advanced').length, 1, '技术信息收在高级信息里') - assert.equal(withClass('sl-detail-chip')[0] && textOf(withClass('sl-detail-chip')[0]), '固定职责') - assert.equal(withClass('sl-setting-block').length, 1) - assert.equal(withClass('sl-model-foot').length, 1) - assert.equal(nodes.filter((node) => node.type === 'textarea').length, 0, '不再提供重复的下旨输入框') - assert.equal(nodes.filter((node) => node.type === 'input').length, 0, '设置区没有可编辑的预设输入') - assert.equal(nodes.filter((node) => node.type === 'datalist').length, 0) - const text = textOf(tree) - assert.match(text, /输入 @ 选择部门/, '侧栏提示原生 @ 入口') - assert.doesNotMatch(text, /打开主对话/) - assert.doesNotMatch(text, /下旨/) - assert.doesNotMatch(text, /预设 ID 可直接填写/) - assert.match(text, /空闲/) - assert.doesNotMatch(text, /\bidle\b/) - assert.doesNotMatch(text, /项在办/, '窄卡片不塞任务计数,避免状态行换行') -}) - -test('sidebar tab wraps its content in a visible error boundary', () => { - const { exports } = loadPlugin() - const { ctx, registrations } = mockContext() - exports.apply(ctx) - const tab = registrations.find((entry) => entry.options.name === 'sidebar.right.pane.tab') - const tree = tab.component({}) - assert.ok(tree, '侧栏页签组件返回元素树') - let found = false - const walk = (node) => { - if (Array.isArray(node)) { node.forEach(walk); return } - if (!node || typeof node !== 'object') return - if (typeof node.type === 'function' && /PanelBoundary/.test(node.type.name || '')) found = true - const kids = Array.isArray(node.children) ? node.children : node.props && node.props.children - if (Array.isArray(kids)) kids.forEach(walk) - else if (kids) walk(kids) - } - if (typeof tree.type === 'function') walk(tree.type(tree.props)) - else walk(tree) - assert.equal(found, true, '内容被错误边界包住') -}) - -test('sendPrompt returns a structured error instead of throwing when the session is missing', async () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - ctx.sessions.binding = () => undefined - const host = exports.createHost(ctx) - const result = await host.sendPrompt('not-here', '测试') - assert.equal(result.ok, false) - assert.equal(result.errorCode, 'no-session') - assert.match(result.error, /对话通道|会话/) -}) - -test('opens an independent court session and delivers the formation prompt exactly once', async () => { - const { exports } = loadPlugin() - const { ctx, prompts, addSession, setStartSession } = mockContext() - setStartSession((workspaceId) => addSession('court-1', workspaceId)) - const host = exports.createHost(ctx) - const result = await host.openCourtSession() - assert.equal(result.ok, true, JSON.stringify(result)) - assert.equal(result.stage, 'delivered') - assert.equal(result.sessionId, 'court-1') - assert.equal(prompts.length, 1, '只投递一次组建指令') - assert.equal(prompts[0].sessionId, 'court-1') - const text = prompts[0].parts[0].text - assert.match(text, /组建朝班/) - assert.ok(text.indexOf('\n') > 0, '组建指令里应有真实换行') - assert.equal(text.indexOf('\\n'), -1, '不应出现字面反斜杠 n') -}) - -test('refuses a second court session request while the first one is pending', async () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - const host = exports.createHost(ctx) - const first = host.openCourtSession() - const second = await host.openCourtSession() - assert.equal(second.ok, false) - assert.equal(second.errorCode, 'busy') - const settled = await first - assert.equal(settled.ok, false) - assert.equal(settled.errorCode, 'create-timeout') -}) - -test('openConversation starts a usable conversation with the 上朝 preset and sends nothing', async () => { - const { exports } = loadPlugin() - const { ctx, prompts, addSession, setStartSession, selections } = mockContext() - const started = [] - setStartSession((workspaceId, options) => { started.push({ workspaceId, options }); addSession('court-2', workspaceId) }) - const host = exports.createHost(ctx) - const result = await host.openConversation() - assert.equal(result.ok, true, JSON.stringify(result)) - assert.equal(result.stage, 'created') - assert.equal(result.sessionId, 'court-2') - assert.equal(started.length, 1) - assert.equal(started[0].options.agentPreset, 'sansheng-liubu', '新对话带上朝预设') - assert.equal(prompts.length, 0, '只开对话,不自动发组建指令') - assert.ok(selections.indexOf('court-2') >= 0, '把中央切到新会话') -}) - -test('focusConversation jumps to the existing session and reports a missing one', () => { - const { exports } = loadPlugin() - const { ctx, selections } = mockContext() - const host = exports.createHost(ctx) - const jumped = host.focusConversation() - assert.equal(jumped.ok, true) - assert.equal(jumped.sessionId, 'lead-1') - assert.ok(selections.indexOf('lead-1') >= 0) - - const empty = mockContext() - empty.ctx.sessions.list = { getSnapshot: () => ({ ids: [], byId: {}, projectionsBySession: {} }) } - empty.ctx.uiWorkspace.selection = { getSnapshot: () => ({}), subscribe: () => () => {} } - const other = exports.createHost(empty.ctx) - const miss = other.focusConversation() - assert.equal(miss.ok, false) - assert.equal(miss.errorCode, 'no-session') -}) - -test('会话头开关拿不到会话时给出可见原因,而不是静默失效', () => { - const { exports } = loadPlugin() - const { ctx, registrations } = mockContext() - // 模拟「还没有打开任何会话」:会话列表与当前选中都为空。 - ctx.sessions.list = { getSnapshot: () => ({ ids: [], byId: {}, projectionsBySession: {} }) } - ctx.uiWorkspace.selection = { getSnapshot: () => ({}), subscribe: () => () => {} } - exports.apply(ctx) - const host = exports.createHost(ctx) - const toggle = registrations.find((entry) => entry.options.name === 'conversation.session.header.actions') - assert.ok(toggle, '会话头入口已注册') - - // 把函数组件就地展开成一棵扁平节点表。宿主由注册项自己注入,测试不另造一份。 - const expand = (node) => { - if (Array.isArray(node)) return node.flatMap(expand) - if (!node || typeof node !== 'object') return [] - if (typeof node.type === 'function') return expand(node.type(node.props)) - return [node, ...expand(node.children), ...expand(node.props && node.props.children)] - } - const render = () => { - const wrapper = toggle.component({}) - return { host: wrapper.props.host, nodes: expand(wrapper) } - } - const withClass = (nodes, name) => nodes.filter((node) => String((node.props && node.props.className) || '').split(' ').includes(name)) - - const before = render() - assert.notEqual(before.host, host, '注册项注入的是它自己那份 host') - assert.equal(withClass(before.nodes, 'sl-toggle-notice').length, 0, '还没点击时不显示提示') - const button = before.nodes.find((node) => node.type === 'button') - assert.equal(typeof button.props.onClick, 'function') - button.props.onClick() - - const after = render() - const notices = withClass(after.nodes, 'sl-toggle-notice') - assert.equal(notices.length, 1, '失败原因要渲染出来,不能只回退不吭声') - assert.match(String(notices[0].props.children), /会话/) - assert.equal(notices[0].props.role, 'status') - assert.equal(notices[0].props.title, notices[0].props.children, '完整原因放在 title 里') - - after.host.setToggleNotice(null) - assert.equal(withClass(render().nodes, 'sl-toggle-notice').length, 0, '提示可以被清掉') -}) - -test('面板用到的每个 sl-* 类名都有对应 CSS 规则', () => { - const { css } = loadPlugin() - const text = css() - assert.ok(text.length > 2000, '样式已注入宿主') - const defined = new Set([...text.matchAll(/\.([a-zA-Z0-9_-]+)/g)].map((match) => match[1])) - const used = new Set() - for (const match of source.matchAll(/className:\s*"([^"$]*)"/g)) { - for (const token of match[1].split(/\s+/)) { - if (token.startsWith('sl-') && !token.endsWith('-')) used.add(token) - } - } - assert.ok(used.size > 30, '至少要扫到面板的类名') - const missing = [...used].filter((name) => !defined.has(name)).sort() - assert.deepEqual(missing, [], '不允许出现挂着类名却没有样式的元素') -}) - -test('响应式跟随侧栏容器宽度,而不是浏览器视口', () => { - const { css } = loadPlugin() - const text = css() - assert.match(text, /\.sl-root\{[^}]*container-type:inline-size/, '根节点要建立尺寸容器,才能按侧栏宽度断点') - assert.equal(/@media\s*\(\s*max-width/.test(text), false, '不得再用视口断点:侧栏宽度与浏览器窗口宽度无关') - const queries = [...text.matchAll(/@container slpanel \(max-width:(\d+)px\)/g)].map((match) => Number(match[1])) - assert.ok(queries.length >= 10, `容器断点太少:${queries.length}`) - for (const px of [1180, 980, 620]) { - assert.ok(queries.includes(px), `缺少 ${px}px 容器断点`) - } -}) - -test('部门设置里的最近活动单独占一行,不再和状态挤在同一行', () => { - const { css } = loadPlugin() - const rule = css().match(/\.sl-detail-status small\{([^}]*)\}/) - assert.ok(rule, '.sl-detail-status small 要有独立规则') - assert.match(rule[1], /flex:1 1 100%/, '最近活动要独占一整行') - assert.equal(/white-space:nowrap/.test(rule[1]), false, '不能强制单行,否则窄侧栏会横向挤压') -}) - -test('会话头开关失败时不再回退到不存在的整页面板', () => { - const { exports } = loadPlugin() - const { ctx, registrations, selections } = mockContext() - ctx.sessions.list = { getSnapshot: () => ({ ids: [], byId: {}, projectionsBySession: {} }) } - ctx.uiWorkspace.selection = { getSnapshot: () => ({}), subscribe: () => () => {} } - exports.apply(ctx) - const toggle = registrations.find((entry) => entry.options.name === 'conversation.session.header.actions') - const expand = (node) => { - if (Array.isArray(node)) return node.flatMap(expand) - if (!node || typeof node !== 'object') return [] - if (typeof node.type === 'function') return expand(node.type(node.props)) - return [node, ...expand(node.children), ...expand(node.props && node.props.children)] - } - expand(toggle.component({})).find((node) => node.type === 'button').props.onClick() - assert.equal(selections.includes(exports.PANEL_ID), false, '失败时不得 selectPanel 到无 main 槽的面板') -}) - -/** 模型目录相关用例:宿主面按用例替换 modelDirectories。 */ -function catalogHost(overrides = {}) { - const { exports } = loadPlugin() - const context = mockContext() - Object.assign(context.ctx, overrides) - exports.apply(context.ctx) - return { ...context, host: exports.createHost(context.ctx) } -} - -test('宿主没有模型目录服务时,错误要说清是服务缺失', async () => { - const { host } = catalogHost({ modelDirectories: undefined }) - const result = await host.loadCatalog('lead-1') - assert.equal(result.options.length, 0) - assert.match(result.error, /没有模型目录服务/) - assert.notEqual(result.error, '当前宿主未提供模型目录', '不能再用那句笼统的误导文案') - const saved = await host.selectModel('lead-1', { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(saved.ok, false) - assert.match(saved.error, /没有模型目录服务/) -}) - -test('清单来自全局目录,不依赖哪个会话是否在本页登记', async () => { - const calls = [] - const { host } = catalogHost({ - modelDirectories: { - catalog: { - load: async () => CATALOG_VALUE, - store: { getSnapshot: () => ({ value: CATALOG_VALUE, status: 'ready', error: null }) }, - }, - directoryFor(sessionId) { - calls.push(sessionId) - throw new Error('ui-model-selection: session "' + sessionId + '" resolved no scope') - }, - }, - }) - const result = await host.loadCatalog('libu') - assert.equal(result.error, null, '未登记的会话也要能列出模型') - assert.equal(result.options.map((option) => option.rowId).join(','), 'deepseek/deepseek-chat,deepseek/deepseek-reasoner') - assert.equal(result.inherited, true, '读不到该部门自己的选择时标成跟随默认') - assert.deepEqual(result.current, { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(result.unresolved, true, '界面据此提示「未在本页打开」') - assert.deepEqual(calls, ['libu']) -}) - -test('部门会话没在本页登记时,保存直接走宿主 RPC', async () => { - const sent = [] - const { host } = catalogHost({ - modelDirectories: { - catalog: { - load: async () => CATALOG_VALUE, - store: { getSnapshot: () => ({ value: CATALOG_VALUE, status: 'ready', error: null }) }, - }, - directoryFor() { throw new Error('ui-model-selection: session "libu" resolved no binding') }, - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async (request) => { sent.push(request); return { ok: true } } }, - }, - }) - const saved = await host.selectModel('libu', { provider: 'deepseek', model: 'deepseek-reasoner', reasoningEffort: 'high' }) - assert.equal(JSON.stringify(saved), JSON.stringify({ ok: true })) - assert.equal(JSON.stringify(sent), JSON.stringify([{ sessionId: 'libu', provider: 'deepseek', model: 'deepseek-reasoner', reasoningEffort: 'high' }]), '要带 sessionId 和推理等级') -}) - -test('宿主拒绝保存时把原因原样带出', async () => { - const { host } = catalogHost({ - modelDirectories: { - catalog: { - load: async () => CATALOG_VALUE, - store: { getSnapshot: () => ({ value: CATALOG_VALUE, status: 'ready', error: null }) }, - }, - directoryFor() { throw new Error('ui-model-selection: session "libu" resolved no binding') }, - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: false, error: { code: 'session/unknown', message: '没有这个会话' } }) }, - }, - }) - const saved = await host.selectModel('libu', { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(saved.ok, false) - assert.match(saved.error, /session\/unknown:没有这个会话/) -}) - -test('清单读取失败时说明是读清单失败,并保留已知缓存', async () => { - const { host } = catalogHost({ - modelDirectories: { - catalog: { - load: async () => { throw new Error('宿主断线') }, - store: { getSnapshot: () => ({ value: null, status: 'error', error: '宿主断线' }) }, - }, - directoryFor: () => ({ - load: async () => {}, - select: async () => ({ ok: true }), - store: { getSnapshot: () => ({ current: { provider: 'p', model: 'm' }, groups: [], failures: [], status: 'ready', error: null }) }, - }), - }, - }) - const result = await host.loadCatalog('lead-1') - assert.match(result.error, /读取模型清单失败:宿主断线/) - assert.deepEqual(result.current, { provider: 'p', model: 'm' }, '清单读不到时仍显示该会话已知的当前模型') - assert.equal(result.unresolved, false) -}) - -test('正常路径给出全局清单与该会话自己的当前选择', async () => { - const { host } = catalogHost() - const result = await host.loadCatalog('lead-1') - assert.equal(result.error, null) - assert.equal(result.unresolved, false) - assert.equal(result.inherited, false) - assert.equal(result.options.length, 2) - assert.deepEqual(result.current, { provider: 'p', model: 'm' }) -}) - -test('部门是子会话时,改模型靠宿主直接执行指令,不投递给模型', async () => { - const prompts = [] - const executed = [] - const { host } = catalogHost({ - sessions: { - list: () => [], - binding: (sessionId) => ({ - session: { prompt: async (parts, mode) => { prompts.push({ sessionId, parts, mode }); return { ok: true } } }, - }), - subagentAddress: () => ({ parentSessionId: 'lead-1', childSessionId: 'gongbu-1' }), - refreshProjections: async () => {}, - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - commands: { - execute: async (agentId, line, attachments) => { - executed.push({ agentId, line, attachments }) - return { commandId: 'cmd-1', result: { kind: 'success', text: '好' } } - }, - }, - }, - }) - const result = await host.routeModel('gongbu', { provider: 'deepseek', model: 'deepseek-chat', reasoningEffort: 'high' }) - assert.equal(result.ok, true) - assert.equal(prompts.length, 0, '不能向会话投递提示词,否则会触发模型思考') - assert.equal(executed.length, 1) - assert.equal(executed[0].agentId, 'lead-1') - assert.equal(executed[0].line, '/dept-model gongbu deepseek deepseek-chat high') - assert.equal(executed[0].attachments.length, 0) -}) - -test('宿主没有执行指令的接口时,报错要指明原因', async () => { - const { host } = catalogHost({ - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - }, - }) - const result = await host.routeModel('gongbu', { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(result.ok, false) - assert.match(result.error, /remote.commands.execute/) -}) - -test('指令接口挂在 ctx.get 上(官方挂法)时也照样静默执行', async () => { - const executed = [] - const commands = { - execute: async (agentId, line, attachments) => { - executed.push({ agentId, line, attachments }) - return { ok: true, value: { commandId: 'cmd-9', result: { kind: 'success', text: '已固定' } } } - }, - } - const { host, prompts } = catalogHost({ - get: (name) => (name === 'remote.commands' ? commands : undefined), - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - }, - }) - const result = await host.routeModel('libu', { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(result.ok, true) - assert.equal(prompts.length, 0, '走指令就不该往会话里投提示词') - assert.equal(executed.length, 1) - assert.equal(executed[0].line, '/dept-model libu deepseek deepseek-chat') -}) - -test('子会话的固定路由从面板记录里读出来当「当前模型」', async () => { - const { exports, storage } = loadPlugin() - storage.set('sansheng-liubu.route.gongbu', JSON.stringify({ provider: 'deepseek', model: 'deepseek-reasoner', reasoningEffort: 'high' })) - const context = mockContext() - context.ctx.sessions.subagentAddress = () => ({ parentSessionId: 'lead-1', childSessionId: 'gongbu-1' }) - exports.apply(context.ctx) - const host = exports.createHost(context.ctx) - const result = await host.loadCatalog('gongbu-1', 'gongbu') - assert.equal(result.fixed, true, '有固定路由时不算继承') - assert.equal(result.current.model, 'deepseek-reasoner') - assert.equal(result.current.reasoningEffort, 'high') -}) - -test('还没召见的部门也能先选好模型,保存走 /dept-model', async () => { - const { exports } = loadPlugin() - const { ctx } = mockContext() - exports.apply(ctx) - const host = exports.createHost(ctx) - - const catalog = await host.loadCatalog(undefined, 'libu') - assert.equal(catalog.options.length, 2, '没有会话也能拿到全局模型清单') - assert.equal(catalog.subagent, true, '未召见的部门同样按子会话处理') - assert.equal(catalog.error, null) - - const routed = await host.routeModel('libu', { provider: 'deepseek', model: 'deepseek-chat' }) - assert.equal(routed.ok, true) - assert.match(routed.text, /^\/dept-model libu deepseek deepseek-chat$/) - - // 详情区的模型设置对缺席席位也要渲染出来(不再是 seat.present 才给)。 - assert.match(source, /seat \? h\("div", \{ className: "sl-setting-block" \}, \[/, '模型设置绑定席位,而不是绑定「已召见」') -}) - -test('用户直接派活:走 subagent 投递,不经过丞相', async () => { - const delivered = [] - const { host } = catalogHost({ - sessions: { - list: { getSnapshot: () => ({ ids: ['lead-1', 'gongbu-1'], byId: {}, projectionsBySession: {} }), subscribe: () => () => {} }, - binding: () => ({ session: { prompt: async () => ({ ok: true }) } }), - subagentAddress: (sessionId) => (sessionId === 'gongbu-1' ? { parentSessionId: 'lead-1', childSessionId: 'gongbu-1' } : undefined), - refreshProjections: async () => {}, - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - commands: { execute: async () => ({ commandId: 'cmd-1', result: { kind: 'success' } }) }, - subagents: { prompt: async (request) => { delivered.push(request); return { messageId: 'msg-1' } } }, - }, - }) - const result = await host.dispatchToSeat('gongbu-1', '把安装脚本补完') - assert.equal(result.ok, true) - assert.equal(delivered.length, 1) - assert.equal(delivered[0].parentSessionId, 'lead-1') - assert.equal(delivered[0].childSessionId, 'gongbu-1') - assert.equal(delivered[0].mode, 'continuable') - assert.equal(delivered[0].delivery, 'queue') - assert.equal(JSON.stringify(delivered[0].content), JSON.stringify([{ type: 'text', text: '把安装脚本补完' }])) - assert.equal(typeof delivered[0].requestId, 'string') - assert.ok(delivered[0].requestId.length > 0, '每次投递都要带独立的 requestId') -}) - -test('不是子会话时,直接派活要说清原因', async () => { - const { host } = catalogHost() - const result = await host.dispatchToSeat('lead-1', '随便说说') - assert.equal(result.ok, false) - assert.match(result.error, /不是子会话/) -}) - -test('改模型优先在部门自己的会话里执行指令', async () => { - const executed = [] - const { host } = catalogHost({ - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - subagents: { prompt: async () => ({ messageId: 'msg-1' }) }, - commands: { - execute: async (agentId, line) => { - executed.push(agentId) - return { commandId: 'cmd-1', result: { kind: 'success', text: line } } - }, - }, - }, - }) - const result = await host.routeModel('gongbu', { provider: 'deepseek', model: 'deepseek-chat' }, 'gongbu-1') - assert.equal(result.ok, true) - assert.equal(JSON.stringify(executed), JSON.stringify(['gongbu-1']), '第一步就该用部门自己的会话') -}) - -test('部门会话执行不了时退到别的会话,仍然不碰对话', async () => { - const executed = [] - const prompts = [] - const { host } = catalogHost({ - sessions: { - list: { getSnapshot: () => ({ ids: ['lead-1'], byId: {}, projectionsBySession: {} }), subscribe: () => () => {} }, - binding: (sessionId) => ({ session: { prompt: async (parts, mode) => { prompts.push({ sessionId, parts, mode }); return { ok: true } } } }), - subagentAddress: () => undefined, - refreshProjections: async () => {}, - }, - remote: { - agentPresets: { list: async () => ({ ok: true, value: { presets: [] } }), select: async () => ({ ok: true }) }, - session: { selectModel: async () => ({ ok: true }) }, - subagents: { prompt: async () => ({ messageId: 'msg-1' }) }, - commands: { - execute: async (agentId) => { - executed.push(agentId) - if (agentId === 'gongbu-1') throw new Error('session "gongbu-1" resolved no scope') - return { commandId: 'cmd-1', result: { kind: 'success' } } - }, - }, - }, - }) - const result = await host.routeModel('gongbu', { provider: 'deepseek', model: 'deepseek-chat' }, 'gongbu-1') - assert.equal(result.ok, true) - assert.equal(JSON.stringify(executed), JSON.stringify(['gongbu-1', 'lead-1'])) - assert.equal(prompts.length, 0, '退到别的会话也只是执行指令,不发消息') -}) diff --git a/preset.patch.yml b/preset.patch.yml deleted file mode 100644 index 0b088f2..0000000 --- a/preset.patch.yml +++ /dev/null @@ -1,22 +0,0 @@ -# 可选层:只有把下面的条目合并进 -# ~/.dsh/profiles/desktop/cordis.patch.yml -# 并彻底重启 DSH 之后,「上朝」才会出现在模式选择器里。 -# 不合并 = 永远不开;删掉 = 立即退出。 -# -# 合并方式(PowerShell,在 profile 目录下): -# $patch = Get-Content ~/.dsh/profiles/desktop/cordis.patch.yml -Raw -# Get-Content ./preset.patch.yml -Raw | Add-Content ~/.dsh/profiles/desktop/cordis.patch.yml -# 注意保持 YAML 顶层是「数组」:删掉文件里那行 `[]` 之后再把本文件内容接在末尾。 -- insert: - - id: preset-sansheng-liubu - name: '@deepseek-ai/dsh-agent-preset' - config: - id: sansheng-liubu - name: 上朝 - description: 丞相统筹,中书规划、门下审核、尚书调度,工部通过 Image-gen 进行视觉创作、礼部文档、兵部代码与工具武库。 - order: 30 - plugins: - - id: sansheng-liubu-policy - name: dsh-sansheng-liubu-mode - config: - presetId: sansheng-liubu diff --git a/preview/check-dsh-go.mjs b/preview/check-dsh-go.mjs new file mode 100644 index 0000000..27c2bbf --- /dev/null +++ b/preview/check-dsh-go.mjs @@ -0,0 +1,30 @@ +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(()=>{})} \ No newline at end of file diff --git a/preview/check-dsh-go.sh b/preview/check-dsh-go.sh new file mode 100644 index 0000000..cd8312a --- /dev/null +++ b/preview/check-dsh-go.sh @@ -0,0 +1,3 @@ +#!/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 diff --git a/preview/check-live.mjs b/preview/check-live.mjs new file mode 100644 index 0000000..6df48a9 --- /dev/null +++ b/preview/check-live.mjs @@ -0,0 +1,181 @@ +// 真机检查:无头 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 '); 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)) diff --git a/preview/check-preview.mjs b/preview/check-preview.mjs new file mode 100644 index 0000000..78f0528 --- /dev/null +++ b/preview/check-preview.mjs @@ -0,0 +1,33 @@ +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="";document.getElementById("composer").requestSubmit();const ok=!document.querySelector(".message img")&&document.querySelector(".message").textContent.includes("{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(()=>{})} diff --git a/preview/check-preview.sh b/preview/check-preview.sh new file mode 100644 index 0000000..47fb134 --- /dev/null +++ b/preview/check-preview.sh @@ -0,0 +1,3 @@ +#!/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 diff --git a/preview/desktop-dark.png b/preview/desktop-dark.png new file mode 100644 index 0000000..ca9743a Binary files /dev/null and b/preview/desktop-dark.png differ diff --git a/preview/desktop-light.png b/preview/desktop-light.png new file mode 100644 index 0000000..77ab659 Binary files /dev/null and b/preview/desktop-light.png differ diff --git a/preview/dsh-go-dark.png b/preview/dsh-go-dark.png new file mode 100644 index 0000000..ffdb143 Binary files /dev/null and b/preview/dsh-go-dark.png differ diff --git a/preview/dsh-go-light.png b/preview/dsh-go-light.png new file mode 100644 index 0000000..cd0e319 Binary files /dev/null and b/preview/dsh-go-light.png differ diff --git a/preview/dsh-go-models.png b/preview/dsh-go-models.png new file mode 100644 index 0000000..a19237e Binary files /dev/null and b/preview/dsh-go-models.png differ diff --git a/preview/dsh-go-narrow.png b/preview/dsh-go-narrow.png new file mode 100644 index 0000000..061f736 Binary files /dev/null and b/preview/dsh-go-narrow.png differ diff --git a/preview/dsh-go.html b/preview/dsh-go.html new file mode 100644 index 0000000..956e09a --- /dev/null +++ b/preview/dsh-go.html @@ -0,0 +1,18 @@ +三省六部 · dsh-go 第一版样式

三省六部 / DSH-GO

会话在前,工作台按需展开

第一版样式提案 · 保留原生会话,十席工作台分屏呈现

原生风格概念稿,非 App 实机截图。按钮可演示;对话、模型为示例,不连接后端。查看 Web 三栏方案 ↗
+ \ No newline at end of file diff --git a/preview/dump-grep.mjs b/preview/dump-grep.mjs new file mode 100644 index 0000000..4241d9c --- /dev/null +++ b/preview/dump-grep.mjs @@ -0,0 +1,7 @@ +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++ } +} diff --git a/preview/dump-sidebar.mjs b/preview/dump-sidebar.mjs new file mode 100644 index 0000000..b1bba77 --- /dev/null +++ b/preview/dump-sidebar.mjs @@ -0,0 +1,36 @@ +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)) diff --git a/preview/enable-now.mjs b/preview/enable-now.mjs new file mode 100644 index 0000000..6fb965c --- /dev/null +++ b/preview/enable-now.mjs @@ -0,0 +1,11 @@ +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)) diff --git a/preview/expand-more.mjs b/preview/expand-more.mjs new file mode 100644 index 0000000..60e3c43 --- /dev/null +++ b/preview/expand-more.mjs @@ -0,0 +1,40 @@ +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 { 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)) diff --git a/preview/index.html b/preview/index.html new file mode 100644 index 0000000..caf0f1a --- /dev/null +++ b/preview/index.html @@ -0,0 +1,34 @@ + +三省六部 · 前端预览 + + +
+
三省六部/丞相独立会话
请选择模型
会话框为布局示意 · 正式接入复用 DSH 原生会话组件
+ +
+ \ No newline at end of file diff --git a/preview/inspect-sidebar.mjs b/preview/inspect-sidebar.mjs new file mode 100644 index 0000000..d50b35b --- /dev/null +++ b/preview/inspect-sidebar.mjs @@ -0,0 +1,45 @@ +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)) diff --git a/preview/live-01-entry.png b/preview/live-01-entry.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/live-01-entry.png differ diff --git a/preview/live-02-workbench.png b/preview/live-02-workbench.png new file mode 100644 index 0000000..f7aa3ea Binary files /dev/null and b/preview/live-02-workbench.png differ diff --git a/preview/live-03-enabled.png b/preview/live-03-enabled.png new file mode 100644 index 0000000..259cb80 Binary files /dev/null and b/preview/live-03-enabled.png differ diff --git a/preview/live-04-seat.png b/preview/live-04-seat.png new file mode 100644 index 0000000..2539e81 Binary files /dev/null and b/preview/live-04-seat.png differ diff --git a/preview/live-05-report.png b/preview/live-05-report.png new file mode 100644 index 0000000..bec9f91 Binary files /dev/null and b/preview/live-05-report.png differ diff --git a/preview/live-06-report-lipu.png b/preview/live-06-report-lipu.png new file mode 100644 index 0000000..86ef263 Binary files /dev/null and b/preview/live-06-report-lipu.png differ diff --git a/preview/live-07-gongbu-session.png b/preview/live-07-gongbu-session.png new file mode 100644 index 0000000..e4efe9d Binary files /dev/null and b/preview/live-07-gongbu-session.png differ diff --git a/preview/live-07-lipu-session.png b/preview/live-07-lipu-session.png new file mode 100644 index 0000000..7a65fbf Binary files /dev/null and b/preview/live-07-lipu-session.png differ diff --git a/preview/live-08-sidebar.png b/preview/live-08-sidebar.png new file mode 100644 index 0000000..7a65fbf Binary files /dev/null and b/preview/live-08-sidebar.png differ diff --git a/preview/mobile-chat.png b/preview/mobile-chat.png new file mode 100644 index 0000000..12e3c43 Binary files /dev/null and b/preview/mobile-chat.png differ diff --git a/preview/mobile-workbench.png b/preview/mobile-workbench.png new file mode 100644 index 0000000..b629647 Binary files /dev/null and b/preview/mobile-workbench.png differ diff --git a/preview/montage.py b/preview/montage.py new file mode 100644 index 0000000..4219e9f --- /dev/null +++ b/preview/montage.py @@ -0,0 +1,27 @@ +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) diff --git a/preview/role-config.png b/preview/role-config.png new file mode 100644 index 0000000..94d696a Binary files /dev/null and b/preview/role-config.png differ diff --git a/preview/seat-01.png b/preview/seat-01.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-01.png differ diff --git a/preview/seat-02.png b/preview/seat-02.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-02.png differ diff --git a/preview/seat-03.png b/preview/seat-03.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-03.png differ diff --git a/preview/seat-04.png b/preview/seat-04.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-04.png differ diff --git a/preview/seat-05.png b/preview/seat-05.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-05.png differ diff --git a/preview/seat-06.png b/preview/seat-06.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-06.png differ diff --git a/preview/seat-07.png b/preview/seat-07.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-07.png differ diff --git a/preview/seat-08.png b/preview/seat-08.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-08.png differ diff --git a/preview/seat-09.png b/preview/seat-09.png new file mode 100644 index 0000000..99e0425 Binary files /dev/null and b/preview/seat-09.png differ diff --git a/preview/seat-10.png b/preview/seat-10.png new file mode 100644 index 0000000..166cfdd Binary files /dev/null and b/preview/seat-10.png differ diff --git a/preview/seats-contact.png b/preview/seats-contact.png new file mode 100644 index 0000000..933016d Binary files /dev/null and b/preview/seats-contact.png differ diff --git a/preview/seats-summary.mjs b/preview/seats-summary.mjs new file mode 100644 index 0000000..d78199d --- /dev/null +++ b/preview/seats-summary.mjs @@ -0,0 +1,10 @@ +import fs from 'node:fs' +const r = JSON.parse(fs.readFileSync('preview/each.json', 'utf8')) +const st = JSON.parse(fs.readFileSync('C:/Users/qyh15/.dsh-test-b/sansheng/state.json', 'utf8')) +const proj = Object.values(st.projects)[0] +const seats = proj ? Object.values(proj.seats) : [] +console.log(JSON.stringify({ + pass: r.pass, + each: r.each, + seats: seats.map(s => ({ seat: s.seatId, session: (s.sessionId || '').slice(0, 8), status: s.status })), +}, null, 2)) diff --git a/preview/smoke-summary.mjs b/preview/smoke-summary.mjs new file mode 100644 index 0000000..d0416d6 --- /dev/null +++ b/preview/smoke-summary.mjs @@ -0,0 +1,14 @@ +import fs from 'node:fs' +const runs = [1, 2, 3].map(i => { + try { return JSON.parse(fs.readFileSync('preview/smoke' + i + '.json', 'utf8')) } + catch (e) { return { parseError: String(e) } } +}) +const summary = runs.map((r, i) => ({ + run: i + 1, + pass: r.pass, + seats: r.workbench?.seatCount, + inDock: r.workbench?.inDock, + reportCount: r.report?.count, + consoleErrors: (r.consoleErrors || []).length, +})) +console.log(JSON.stringify({ runs: summary, items: runs[0]?.report?.items ?? runs[0]?.parseError }, null, 2)) diff --git a/sansheng/.gitignore b/sansheng/.gitignore new file mode 100644 index 0000000..c2658d7 --- /dev/null +++ b/sansheng/.gitignore @@ -0,0 +1 @@ +node_modules/ diff --git a/sansheng/CONTRACT.md b/sansheng/CONTRACT.md new file mode 100644 index 0000000..696eccc --- /dev/null +++ b/sansheng/CONTRACT.md @@ -0,0 +1,61 @@ +# 三省六部 v0.1 内部接口契约 + +本文件约束 Web 工作台、dsh-go 原生面板与宿主服务之间的数据形状。三端共用 `src/shared/roles.js` 与 `src/shared/schema.js`。 + +## 十席 + +- `SEAT_IDS` 顺序:lead, zhongshu, shangshu, menxia, libu, hubu, lipu, bingbu, xingbu, gongbu。 +- `SEATS[id]` = `{ id, label(两字), duty(短摘要), responsibility(职责全文) }`。 +- `SEAT_GROUPS` = `{ lead:[lead], sansheng:[zhongshu,shangshu,menxia], liubu:[libu,hubu,lipu,bingbu,xingbu,gongbu] }`(工作台布局用)。 + +## 宿主 HTTP:POST `/api/sansheng` + +请求体 `{ endpoint: string, payload?: object }`;成功回 `{ ok:true, value }`,失败回 `{ ok:false, error:{ code, message } }`(HTTP 200)。 + +| endpoint | payload | value | +|---|---|---| +| `list` | — | `{ projects:[{ id, name, status, revision }] }` | +| `project` | `{ projectId }` | 项目视图(见下) | +| `open` | `{ workspaceId, name?, path? }` | 项目视图;不存在则按 workspaceId 建项目记录(不创建会话) | +| `enable` | `{ projectId }` | 项目视图;严格创建/恢复十席会话 | +| `configure` | `{ projectId, seatId, model:({provider,model,reasoningEffort?}|null), instructions? }` | `{ seat }` | +| `models` | — | `{ providers:[{ provider, models:[{ model, reasoningEffort?:[...] }] }], default:({provider,model}|null), failures:[...] }` | + +错误码:`sansheng/invalid`、`sansheng/not-found`、`sansheng/conflict`、`sansheng/unbound`(席尚未绑定会话)、`sansheng/model-invalid`、`sansheng/state-corrupt`。 + +## 项目视图 + +```jsonc +{ + "revision": 0, + "project": { + "id": "ws-1", "name": "项目名", "workspaceId": "ws-1", "path": "D:/x", "status": "pending|provisioning|ready|error", + "seats": [ + { "id":"lead","label":"丞相","duty":"...","responsibility":"...","status":"pending|creating|bound|failed|missing","sessionId":null,"model":null,"instructions":"","error":null } + ], + "groups": { "lead":["lead"], "sansheng":[...], "liubu":[...] } + } +} +``` + +## 会话/模型规则(两端 UI 必须遵守) + +- 每席一个独立 root Session;切换角色 = 导航到该席 `sessionId`,不新建、不重建聊天引擎。 +- 模型未选择显示“请选择模型”;选择后显示具体名称。界面不提供“跟随宿主模型”选项。 +- “启用”只建立十个会话,不自动运行模型。 +- 角色补充说明:Web 可编辑;原生面板只读(原生无自由文本控件)。 + +## Web 工作台(`src/client/`) + +纯视图模型函数 `buildWorkbenchView(view, ui)` 必须可由 node 直接 import 测试(不依赖 React/DOM): +- `view` = 项目视图;`ui` = `{ selectedSeatId, models, draft }`。 +- 返回:`{ projectTitle, ready, seats:[{id,name,duty,statusLabel,selected}], groups, selected:{ id,name,responsibility,duty,modelValue,modelLabel,instructions,modelOptions } }`。 +- `seats` 必须正好十项且 name 两字;未选模型时 `modelLabel==='请选择模型'` 且 `modelValue===''`;`modelOptions` 不得含 value==='inherit' 的项。 +React 接线用 `React.createElement`(不用 JSX,便于 esbuild 直接打包)。入口 `export const inject=[...]` + `export function apply(ctx)`。 + +## dsh-go 原生面板(`src/native/`) + +纯视图树函数 `buildPanelView(input)` 必须可由 node 直接 import 测试: +- `input` = `{ project, selectedSeatId, models }`。 +- 返回原生 view 节点(`{ type:'stack'|'row'|'text'|'list'|'callout'|'button'|'accordion'... }`)。 +- 硬约束:节点数 ≤120、深度 ≤8、单个 options/列表 ≤8 项、无自由文本输入控件;十席按 lead/sansheng/liubu 分组呈现。 diff --git a/sansheng/README.md b/sansheng/README.md new file mode 100644 index 0000000..0e9ec55 --- /dev/null +++ b/sansheng/README.md @@ -0,0 +1,22 @@ +# 三省六部(dsh-sansheng)· 第一版 + +在 DSH 里为每个项目提供固定的十席角色(丞相、中书、门下、尚书、吏部、户部、礼部、兵部、刑部、工部), +每席绑定一个独立的原生命 root Session,模型与补充说明按项目独立保存。中间复用宿主原生会话,不替换聊天引擎。 + +当前进度(对应 `docs/v1-plan.md` §7 实施顺序): + +- ✅ 第 2 步:项目内身份与十席会话绑定(宿主服务 + 严格创建/恢复/失败重试/跨项目隔离,`npm test` 用 fake ctx 验证)。 +- ✅ 第 3 步:Web 入口与右侧工作台(已在隔离测试 DSH 真机验证:入口、十席工作台、真实建十个会话、重启幂等)。 +- 🟡 第 4 步:dsh-go 原生面板(源代码就位,触摸/返回/会话跳转需真机核验)。 +- ⬜ 第 5 步:双项目联调后打包发布。 + +**本包尚未安装到任何 DSH profile,也未改动用户的日常 DSH 配置。** + +## 目录 + +- `index.js` — 宿主插件入口(`name` / `inject` / `apply`)。 +- `src/shared/` — 十席定义与项目状态 schema(前后端共用)。 +- `src/host/` — 项目状态存储、严格会话创建/恢复、模型配置(不写 profile)、提示词 section、HTTP `api/sansheng`。 +- `src/client/` — Web 工作台(纯视图模型 + React 接线 + 传输层)。 +- `src/native/` — dsh-go 原生面板(纯视图树构造 + bridge 接线)。 +- `test/` — fake ctx 单元/集成测试。 diff --git a/sansheng/client.js b/sansheng/client.js new file mode 100644 index 0000000..fc7dc3e --- /dev/null +++ b/sansheng/client.js @@ -0,0 +1,1447 @@ +// Generated from src/client by `npm run build` (scripts/build-client.mjs). Do not edit by hand. +window.__ModuleLoader__.load({ + id: 'dsh-sansheng', + factory: (require) => { +const module = { exports: {} } +var __defProp = Object.defineProperty; +var __getOwnPropDesc = Object.getOwnPropertyDescriptor; +var __getOwnPropNames = Object.getOwnPropertyNames; +var __hasOwnProp = Object.prototype.hasOwnProperty; +var __export = (target, all) => { + for (var name in all) + __defProp(target, name, { get: all[name], enumerable: true }); +}; +var __copyProps = (to, from, except, desc) => { + if (from && typeof from === "object" || typeof from === "function") { + for (let key of __getOwnPropNames(from)) + if (!__hasOwnProp.call(to, key) && key !== except) + __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable }); + } + return to; +}; +var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod); + +// src/client/index.js +var index_exports = {}; +__export(index_exports, { + apply: () => apply, + inject: () => inject +}); +module.exports = __toCommonJS(index_exports); + +// src/shared/roles.js +var SEAT_IDS = Object.freeze([ + "lead", + "zhongshu", + "shangshu", + "menxia", + "libu", + "hubu", + "lipu", + "bingbu", + "xingbu", + "gongbu" +]); +var SEATS = Object.freeze({ + lead: { + id: "lead", + label: "丞相", + duty: "接需求 · 协调汇报", + responsibility: "面向用户承接想法:判断是否需要开工、必要时派给具体部门,并把各部门结果汇总成对用户的一次交付。" + }, + zhongshu: { + id: "zhongshu", + label: "中书", + duty: "调查 · 澄清 · 规划", + responsibility: "先把问题问清、把材料看全,再给出可执行的方案与验收标准草案,不直接产出最终交付物。" + }, + shangshu: { + id: "shangshu", + label: "尚书", + duty: "分工 · 组织交付", + responsibility: "把已经明确的方案拆成部门分工并组织交付;六部直属于尚书这一同级分组,六部之间不是上下级。" + }, + menxia: { + id: "menxia", + label: "门下", + duty: "审议 · 整体审核", + responsibility: "对方案和交付做独立审议,指出风险与不达标处。首版没有门下审核的任务必须如实标注“未审核”。" + }, + libu: { + id: "libu", + label: "吏部", + duty: "角色 · 技能配置", + responsibility: "对角色、技能与编制给出建议;职责不含绕过用户授权去改权限或其他项目设置。" + }, + hubu: { + id: "hubu", + label: "户部", + duty: "数据 · 表格计算", + responsibility: "处理数据、表格与计算,结论应可复算。" + }, + lipu: { + id: "lipu", + label: "礼部", + duty: "文档 · 内容呈现", + responsibility: "负责文档、内容与呈现形式,产出可编辑的源文件。" + }, + bingbu: { + id: "bingbu", + label: "兵部", + duty: "环境 · 调试部署", + responsibility: "负责环境、调试与部署;部署/发布等外部副作用仍服从用户授权与宿主审批。" + }, + xingbu: { + id: "xingbu", + label: "刑部", + duty: "测试 · 风险检查", + responsibility: "做测试与风险检查,给出可追溯的检查结果,而不是一句“已通过”。" + }, + gongbu: { + id: "gongbu", + label: "工部", + duty: "代码 · 工程产出", + responsibility: "负责代码实现与工程产出,交付可编辑源文件与真实检查结果。" + } +}); +var SEAT_GROUPS = Object.freeze({ + lead: Object.freeze(["lead"]), + sansheng: Object.freeze(["zhongshu", "shangshu", "menxia"]), + liubu: Object.freeze(["libu", "hubu", "lipu", "bingbu", "xingbu", "gongbu"]) +}); +function isSeatId(id) { + return SEAT_IDS.includes(id); +} +function seatOf(id) { + return SEATS[id]; +} +function seatLabel(id) { + return SEATS[id]?.label ?? ""; +} +function seatBySessionId(projects, sessionId) { + if (!sessionId || !projects) return void 0; + for (const project of Object.values(projects)) { + for (const seatId of SEAT_IDS) { + if (project?.seats?.[seatId]?.sessionId === sessionId) { + return { project, seatId, seat: SEATS[seatId] }; + } + } + } + return void 0; +} + +// src/client/workbench.js +var UNCHOSEN_MODEL_LABEL = "请选择模型"; +var SEAT_STATUS_LABELS = Object.freeze({ + pending: "待启用", + creating: "创建中", + bound: "已绑定", + failed: "创建失败", + missing: "会话缺失" +}); +var DEFAULT_SEAT_STATUS = "pending"; +function seatStatusLabel(status) { + if (typeof status !== "string") return "未知状态"; + return SEAT_STATUS_LABELS[status] ?? "未知状态"; +} +function projectStatusLabel(status) { + switch (status) { + case "pending": + return "待启用"; + case "provisioning": + return "启用中"; + case "ready": + return "已启用"; + case "error": + return "启用失败"; + default: + return "未知状态"; + } +} +function collectModelOptions(models) { + const out = []; + const seen = /* @__PURE__ */ new Set(); + const providers = Array.isArray(models?.providers) ? models.providers : []; + for (const entry of providers) { + const provider = typeof entry?.provider === "string" ? entry.provider : ""; + if (!provider) continue; + const list = Array.isArray(entry?.models) ? entry.models : []; + for (const item of list) { + const model = typeof item?.model === "string" ? item.model : ""; + if (!model) continue; + const efforts = Array.isArray(item?.reasoningEffort) ? item.reasoningEffort.filter((e) => typeof e === "string" && e.trim() !== "") : []; + if (efforts.length > 0) { + for (const effort of efforts) { + const value = provider + "::" + model + "::" + effort; + if (value === "inherit" || seen.has(value)) continue; + seen.add(value); + out.push({ value, label: model + " · " + effort, provider, model, reasoningEffort: effort }); + } + } else { + const value = provider + "::" + model; + if (value === "inherit" || seen.has(value)) continue; + seen.add(value); + out.push({ value, label: model, provider, model }); + } + } + } + return out; +} +function findModelOption(options, modelValue2) { + if (!Array.isArray(options)) return void 0; + return options.find((option) => option.value === modelValue2); +} +function describeModel(model, options) { + if (!model || typeof model !== "object" || typeof model.provider !== "string" || typeof model.model !== "string") { + return { modelValue: "", modelLabel: UNCHOSEN_MODEL_LABEL }; + } + const effort = typeof model.reasoningEffort === "string" && model.reasoningEffort ? model.reasoningEffort : void 0; + const match = (Array.isArray(options) ? options : []).find((option) => option.provider === model.provider && option.model === model.model && (option.reasoningEffort ?? void 0) === effort); + if (match) return { modelValue: match.value, modelLabel: match.label }; + const modelLabel = effort ? model.model + " · " + effort : model.model; + const modelValue2 = effort ? model.provider + "::" + model.model + "::" + effort : model.provider + "::" + model.model; + return { modelValue: modelValue2, modelLabel }; +} +function normalizeSeats(seats) { + const map = {}; + if (Array.isArray(seats)) { + for (const seat of seats) { + if (seat && typeof seat === "object" && typeof seat.id === "string") map[seat.id] = seat; + } + } else if (seats && typeof seats === "object") { + for (const [id, seat] of Object.entries(seats)) { + if (seat && typeof seat === "object") map[id] = { id, ...seat }; + } + } + return map; +} +function cloneGroups() { + const out = {}; + for (const key of Object.keys(SEAT_GROUPS)) out[key] = Array.from(SEAT_GROUPS[key]); + return out; +} +function pickSelectedId(requested) { + if (typeof requested === "string" && SEAT_IDS.includes(requested)) return requested; + return SEAT_IDS[0]; +} +function hasOwn(obj, key) { + return obj !== null && obj !== void 0 && Object.prototype.hasOwnProperty.call(obj, key); +} +function draftOf(draft, seatId) { + if (!draft || typeof draft !== "object") return {}; + const entry = draft[seatId]; + return entry && typeof entry === "object" ? entry : {}; +} +function updateDraft(draft, seatId, patch) { + const base = draft && typeof draft === "object" ? draft : {}; + const previous = base[seatId] && typeof base[seatId] === "object" ? base[seatId] : {}; + return { ...base, [seatId]: { ...previous, ...patch ?? {} } }; +} +function clearDraft(draft, seatId) { + if (!draft || typeof draft !== "object" || !hasOwn(draft, seatId)) return draft ?? {}; + const next = { ...draft }; + delete next[seatId]; + return next; +} +function buildWorkbenchView(view, ui) { + const safeView = view && typeof view === "object" ? view : {}; + const project = safeView.project && typeof safeView.project === "object" ? safeView.project : {}; + const status = typeof project.status === "string" ? project.status : "pending"; + const ready = status === "ready"; + const seatMap = normalizeSeats(project.seats); + const selectedSeatId = pickSelectedId(ui?.selectedSeatId); + const models = ui?.models ?? null; + const modelOptions = collectModelOptions(models); + const draft = ui?.draft ?? null; + const seats = SEAT_IDS.map((id) => { + const def = SEATS[id]; + const rec = seatMap[id] ?? {}; + const seatStatus = typeof rec.status === "string" ? rec.status : DEFAULT_SEAT_STATUS; + return { + id, + name: def.label, + duty: def.duty, + status: seatStatus, + statusLabel: seatStatusLabel(seatStatus), + selected: id === selectedSeatId + }; + }); + const seatDef = SEATS[selectedSeatId]; + const seatRec = seatMap[selectedSeatId] ?? {}; + const draftEntry = draftOf(draft, selectedSeatId); + let described; + if (hasOwn(draftEntry, "modelValue")) { + const raw = draftEntry.modelValue; + if (raw === "" || raw === null || raw === void 0) { + described = { modelValue: "", modelLabel: UNCHOSEN_MODEL_LABEL }; + } else { + const match = findModelOption(modelOptions, raw); + described = match ? { modelValue: match.value, modelLabel: match.label } : { modelValue: String(raw), modelLabel: String(raw) }; + } + } else if (hasOwn(draftEntry, "model")) { + described = describeModel(draftEntry.model, modelOptions); + } else { + described = describeModel(seatRec.model ?? null, modelOptions); + } + const instructions = hasOwn(draftEntry, "instructions") ? draftEntry.instructions : typeof seatRec.instructions === "string" ? seatRec.instructions : ""; + const selectedStatus = typeof seatRec.status === "string" ? seatRec.status : DEFAULT_SEAT_STATUS; + let boundCount = 0; + let sessionCount = 0; + for (const id of SEAT_IDS) { + const rec = seatMap[id]; + if (rec?.status === "bound") boundCount += 1; + if (rec?.sessionId) sessionCount += 1; + } + return { + projectTitle: typeof project.name === "string" ? project.name : "", + ready, + project: { + id: project.id ?? "", + name: typeof project.name === "string" ? project.name : "", + status, + statusLabel: projectStatusLabel(status), + workspaceId: project.workspaceId ?? null, + path: project.path ?? null, + seatCount: seats.length, + boundCount, + sessionCount + }, + seats, + groups: cloneGroups(), + selected: { + id: selectedSeatId, + name: seatDef.label, + duty: seatDef.duty, + responsibility: seatDef.responsibility, + status: selectedStatus, + statusLabel: seatStatusLabel(selectedStatus), + sessionId: seatRec.sessionId ?? null, + modelValue: described.modelValue, + modelLabel: described.modelLabel, + instructions, + modelOptions, + dirty: Object.keys(draftEntry).length > 0 + } + }; +} + +// src/client/transport.js +var ROUTE = "api/sansheng"; +var SanshengRequestError = class extends Error { + constructor(message, code) { + super(message); + this.name = "SanshengRequestError"; + this.code = code || "sansheng/error"; + } +}; +async function request(endpoint, payload, signal) { + let response; + try { + response = await fetch(ROUTE, { + method: "POST", + credentials: "same-origin", + headers: { "content-type": "application/json" }, + body: JSON.stringify({ endpoint, payload: payload ?? null }), + signal + }); + } catch (error) { + if (error && error.name === "AbortError") throw error; + const detail = error && error.message ? error.message : String(error); + throw new SanshengRequestError("无法连接 DSH,请确认它仍在运行(" + detail + ")", "NETWORK"); + } + if (!response.ok) { + throw new SanshengRequestError("HTTP " + response.status, "HTTP_" + response.status); + } + let result; + try { + result = await response.json(); + } catch (error) { + throw new SanshengRequestError("响应不是合法 JSON", "sansheng/bad-response"); + } + if (!result || result.ok !== true) { + const code = result && result.error && result.error.code ? result.error.code : "sansheng/error"; + const message = result && result.error && result.error.message ? result.error.message : "请求失败"; + throw new SanshengRequestError(message, code); + } + return result.value; +} +var transport_default = request; + +// src/client/styles.js +var CSS = ` +.ssw-scope{--ssw-bg:#ffffff;--ssw-side:#f8f9fa;--ssw-rail:#f7f9fc;--ssw-card:#ffffff;--ssw-line:#e3e8ef;--ssw-strong:#c7d8f5;--ssw-ink:#0f172a;--ssw-muted:#667085;--ssw-faint:#98a2b3;--ssw-blue:#3b82f6;--ssw-wash:#eff6ff;--ssw-frame:#3b82f6;--ssw-wire:#c9d6ea;--ssw-danger:#dc2626;--ssw-ok:#16a34a;box-sizing:border-box;color:var(--ssw-ink);font-family:Inter,"Segoe UI","Microsoft YaHei",sans-serif;font-size:13px;line-height:1.5} +.ssw-scope *,.ssw-scope *::before,.ssw-scope *::after{box-sizing:border-box} +.ssw-scope button{font:inherit;color:inherit;background:transparent;border:0;cursor:pointer} +.ssw-scope button:disabled{cursor:default;opacity:.55} +.ssw-scope :focus-visible{outline:2px solid var(--ssw-blue);outline-offset:2px} +body[data-ds-dark-theme] .ssw-scope,html[data-theme=dark] .ssw-scope,.ssw-scope[data-ssw-theme=dark]{--ssw-bg:#14171c;--ssw-side:#171b21;--ssw-rail:#161a20;--ssw-card:#1e232b;--ssw-line:#2c333d;--ssw-strong:#3b4a63;--ssw-frame:#6ea8ff;--ssw-ink:#e6ebf2;--ssw-muted:#a9b4c2;--ssw-faint:#7b8797;--ssw-blue:#6ea8ff;--ssw-wash:#1d2b40;--ssw-wire:#3a4350;--ssw-danger:#f87171;--ssw-ok:#4ade80} +.ssw-float{position:fixed;right:14px;bottom:70px;z-index:2147483000;width:min(374px,calc(100vw - 28px));max-height:calc(100vh - 96px);display:flex;flex-direction:column;background:#ffffff;border:1px solid #e3e8ef;border-radius:12px;box-shadow:0 18px 50px -12px rgba(16,24,40,.28),0 4px 12px -2px rgba(16,24,40,.12);overflow:hidden} +body[data-ds-dark-theme] .ssw-float,html[data-theme=dark] .ssw-float{background:#161a20;border-color:#2c333d} +.ssw-root{display:flex;flex-direction:column;min-height:0;height:100%;overflow:auto;background:var(--ssw-rail);color:var(--ssw-ink)} +.ssw-head{flex:none;height:52px;display:flex;align-items:center;gap:8px;padding:0 16px;border-bottom:1px solid var(--ssw-line);background:var(--ssw-card)} +.ssw-head svg{width:18px;height:18px;color:var(--ssw-muted)} +.ssw-head-title{font-size:13px;font-weight:600} +.ssw-icon-btn{margin-left:auto;display:inline-flex;align-items:center;justify-content:center;width:30px;height:30px;border-radius:6px;color:var(--ssw-muted)} +.ssw-icon-btn:hover{background:var(--ssw-wash);color:var(--ssw-blue)} +.ssw-project{padding:18px 16px 0} +.ssw-project-line{display:flex;align-items:center;justify-content:space-between;margin-bottom:5px} +.ssw-eyebrow{display:inline-flex;align-items:center;gap:6px;font-size:11px;color:var(--ssw-muted)} +.ssw-eyebrow svg{width:14px;height:14px} +.ssw-count{font-size:10px;color:var(--ssw-faint)} +.ssw-project-title{font-size:17px;font-weight:600;letter-spacing:.3px;margin:0 0 14px} +.ssw-enable{margin:0 16px 4px;padding:12px;border:1px solid var(--ssw-strong);background:var(--ssw-wash);border-radius:10px} +.ssw-enable-note{margin:0 0 10px;font-size:12px;color:var(--ssw-muted);line-height:1.7} +.ssw-primary{background:var(--ssw-blue);color:#ffffff;border-radius:7px;padding:8px 13px;font-size:12px;font-weight:500} +.ssw-primary:hover{filter:brightness(1.05)} +.ssw-tree{padding:14px 16px 4px;position:relative} +.ssw-lead{width:150px;margin:0 auto;position:relative} +.ssw-lead::after{content:none} +.ssw-sansheng{position:relative;margin-top:22px} +.ssw-trio{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:9px} +.ssw-seat{position:relative;width:100%;display:flex;flex-direction:column;gap:6px;padding:10px 9px 8px;border:1.5px solid var(--ssw-frame);border-radius:10px;background:var(--ssw-card);text-align:left;min-height:70px;box-shadow:0 1px 2px rgba(16,24,40,.04);transition:border-color .15s,box-shadow .15s,transform .15s} +.ssw-seat:hover{border-color:var(--ssw-blue);transform:translateY(-1px);box-shadow:0 3px 8px rgba(16,24,40,.06)} +.ssw-seat[aria-pressed=true]{border-color:var(--ssw-blue);background:var(--ssw-wash);box-shadow:0 0 0 2px rgba(59,130,246,.12)} +.ssw-lead .ssw-seat{border-color:var(--ssw-blue)} +.ssw-role-top{display:flex;align-items:center;justify-content:space-between;gap:6px} +.ssw-role-name{font-size:14px;font-weight:600;letter-spacing:2px} +.ssw-role-duty{font-size:10px;color:var(--ssw-muted);line-height:1.5} +.ssw-dot{flex:none;width:6px;height:6px;border-radius:50%;border:1px solid var(--ssw-faint);background:transparent} +.ssw-dot[data-status=bound]{background:var(--ssw-ok);border-color:var(--ssw-ok)} +.ssw-dot[data-status=failed],.ssw-dot[data-status=missing]{background:var(--ssw-danger);border-color:var(--ssw-danger)} +.ssw-dot[data-status=creating]{background:var(--ssw-blue);border-color:var(--ssw-blue)} +.ssw-ministries{position:relative;margin-top:18px} +.ssw-group-label{display:block;margin:0 2px 8px;font-size:11px;font-weight:600;letter-spacing:.5px;color:var(--ssw-muted)} +.ssw-six{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px} +.ssw-six .ssw-seat{min-height:66px;padding:9px 8px} +.ssw-report{padding:0 16px;margin-top:4px} +.ssw-report-toggle{font-size:12px;color:var(--ssw-blue);padding:7px 2px;font-weight:500} +.ssw-report-list{display:flex;flex-direction:column;gap:8px;margin-top:4px} +.ssw-report-item{border:1px solid var(--ssw-line);border-radius:9px;padding:9px 11px;background:var(--ssw-card)} +.ssw-report-head{display:flex;gap:8px;align-items:baseline} +.ssw-report-head strong{font-size:13px;letter-spacing:1px} +.ssw-report-head span{font-size:10px;color:var(--ssw-muted)} +.ssw-report-model{margin:4px 0 0;font-size:11px;color:var(--ssw-blue);letter-spacing:.2px} +.ssw-report-text{margin:4px 0 0;font-size:12px;line-height:1.7;color:var(--ssw-muted)} +.ssw-current{margin:16px 16px 0;padding:13px;border:1px solid var(--ssw-line);border-radius:11px;background:var(--ssw-card)} +.ssw-current-top{display:flex;align-items:center;justify-content:space-between;margin-bottom:9px} +.ssw-current-name{font-size:13px;font-weight:600} +.ssw-current-label{font-size:10px;color:var(--ssw-faint)} +.ssw-current-text{margin:0;font-size:12px;line-height:1.8;color:var(--ssw-muted)} +.ssw-config{margin:10px 16px 0;border:1px solid var(--ssw-line);border-radius:10px;background:var(--ssw-card);overflow:hidden} +.ssw-config-toggle{display:flex;align-items:center;gap:8px;width:100%;padding:12px 13px;font-size:12px;color:var(--ssw-ink)} +.ssw-config-toggle svg{width:15px;height:15px;color:var(--ssw-muted)} +.ssw-chevron{margin-left:auto;transition:transform .2s} +.ssw-config-toggle[aria-expanded=true] .ssw-chevron{transform:rotate(180deg)} +.ssw-config-body{padding:0 13px 14px} +.ssw-label{display:block;font-size:11px;color:var(--ssw-muted);margin:12px 0 6px} +.ssw-field{width:100%;border:1px solid var(--ssw-line);background:var(--ssw-bg);color:var(--ssw-ink);border-radius:6px;padding:8px;font-size:12px;line-height:1.5} +.ssw-textarea{resize:vertical;min-height:84px;font-family:inherit} +.ssw-scope-note{margin:10px 0;font-size:10px;line-height:1.6;color:var(--ssw-faint)} +.ssw-save-row{display:flex;align-items:center;gap:10px} +.ssw-save-status{font-size:10px;color:var(--ssw-muted)} +.ssw-notice{margin:12px 16px 16px;font-size:11px;color:var(--ssw-muted)} +.ssw-error{margin:12px 16px 16px;font-size:11px;color:var(--ssw-danger)} +.ssw-loading,.ssw-empty{padding:36px 20px;text-align:center;font-size:12px;color:var(--ssw-muted)} +.ssw-empty .ssw-primary{margin-top:12px} +.ssw-entry{display:flex;align-items:center;gap:9px;width:100%;padding:0 10px;height:35px;border-radius:7px;font-size:13px;color:inherit;text-align:left} +.ssw-entry:hover{background:#eef4ff} +.ssw-entry[aria-expanded=true]{color:#2563eb;background:#eaf1fe;font-weight:600} +.ssw-entry svg{width:16px;height:16px;flex:none} +.ssw-entry-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.ssw-entry-compact{width:auto;max-width:100%;height:28px;padding:0 8px;gap:6px;border:1px solid var(--ssw-line);border-radius:7px;background:var(--ssw-card);font-size:12px} +.ssw-entry-compact:hover{background:var(--ssw-wash)} +body[data-ds-dark-theme] .ssw-entry:hover{background:#1d2b40} +body[data-ds-dark-theme] .ssw-entry[aria-expanded=true]{color:#91bafa;background:#1d2b40} +@media (prefers-reduced-motion:reduce){.ssw-scope *{transition:none!important}} +.ssw-tab-body{height:100%;min-height:0;display:flex;flex-direction:column} +.ssw-tab-body .ssw-root{flex:1;min-height:0} +.ssw-tab-title{font-size:13px} +`; + +// src/native/panel.js +var GROUP_ORDER = ["lead", "sansheng", "liubu"]; +var GROUP_TITLE = { lead: "统领", sansheng: "三省", liubu: "六部" }; +var MAX_OPTIONS = 8; +var PROJECT_STATUS_TEXT = { + pending: "待启用", + provisioning: "启用中", + ready: "已就绪", + error: "异常" +}; +var SEAT_STATUS_TEXT = { + pending: "待启用", + creating: "创建中", + bound: "已绑定", + failed: "失败", + missing: "缺失" +}; +function asText(v) { + return typeof v === "string" ? v : ""; +} +function seatRecords(project) { + const out = {}; + const seats = project ? project.seats : null; + if (Array.isArray(seats)) { + for (const s of seats) if (s && SEATS[s.id]) out[s.id] = s; + } else if (seats && typeof seats === "object") { + for (const id of SEAT_IDS) if (seats[id]) out[id] = seats[id]; + } + return out; +} +function isBound(seat) { + return !!seat && typeof seat.sessionId === "string" && seat.sessionId.length > 0; +} +function modelValue(model) { + if (!model || typeof model !== "object") return ""; + if (typeof model.provider !== "string" || typeof model.model !== "string") return ""; + return model.provider + "::" + model.model; +} +function flattenModels(models) { + const opts = []; + const providers = models && Array.isArray(models.providers) ? models.providers : []; + for (const p of providers) { + const pid = asText(p && p.provider); + if (!pid) continue; + const list = Array.isArray(p && p.models) ? p.models : []; + for (const m of list) { + const mid = typeof m === "string" ? m : asText(m && m.model); + if (!mid) continue; + opts.push({ value: pid + "::" + mid, label: pid + " / " + mid }); + if (opts.length >= MAX_OPTIONS - 1) break; + } + if (opts.length >= MAX_OPTIONS - 1) break; + } + return opts; +} +function buildModelSelect(project, seat, models) { + const real = flattenModels(models); + const options = [{ value: "", label: "请选择模型" }].concat(real).slice(0, MAX_OPTIONS); + const want = modelValue(seat && seat.model); + const value = options.some((o) => o.value === want) ? want : ""; + return { + type: "select", + label: "模型", + value, + options, + action: { type: "sansheng/select-model", seatId: seat && seat.id || null, projectId: project && project.id || null } + }; +} +function seatButton(project, seat, selectedSeatId) { + const meta = SEATS[seat.id]; + const selected = seat.id === selectedSeatId; + return { + type: "button", + seatId: seat.id, + label: meta.label, + selected, + variant: selected ? "primary" : "ghost", + action: { type: "sansheng/select-seat", seatId: seat.id, projectId: project && project.id || null } + }; +} +function groupNode(project, records, key, selectedSeatId) { + const ids = (SEAT_GROUPS[key] || []).filter((id) => records[id] && SEATS[id]); + if (ids.length === 0) return null; + const perRow = key === "liubu" ? 3 : ids.length; + const rows = []; + for (let i = 0; i < ids.length; i += perRow) { + const slice = ids.slice(i, i + perRow); + rows.push({ type: "row", children: slice.map((id) => seatButton(project, records[id], selectedSeatId)) }); + } + return { + type: "stack", + group: key, + children: [{ type: "text", text: GROUP_TITLE[key] + " · " + ids.length + " 席" }].concat(rows) + }; +} +function selectedDetail(project, records, selectedSeatId, models) { + const seat = selectedSeatId ? records[selectedSeatId] : null; + if (!seat) { + return { type: "callout", tone: "info", text: "点击上方角色卡片查看职责、模型与进入会话。" }; + } + const meta = SEATS[seat.id]; + const bound = isBound(seat); + const statusLabel = SEAT_STATUS_TEXT[seat.status] || asText(seat.status) || "未知"; + const instructions = asText(seat.instructions).trim() || "(未填写)"; + return { + type: "stack", + detail: seat.id, + children: [ + { type: "text", text: meta.label + " · " + meta.duty + " · " + statusLabel }, + { type: "callout", tone: "info", text: "职责:" + meta.responsibility }, + { type: "text", text: "角色补充说明(只读,请在 Web 端编辑)" }, + { type: "callout", tone: "warn", text: instructions }, + buildModelSelect(project, seat, models), + { + type: "button", + label: bound ? "进入" + meta.label + "会话" : meta.label + "尚未绑定会话", + variant: bound ? "primary" : "ghost", + disabled: !bound, + action: { + type: "sansheng/enter-session", + seatId: seat.id, + projectId: project && project.id || null, + sessionId: isBound(seat) ? seat.sessionId : null + } + } + ] + }; +} +function buildPanelView(input) { + const { project = null, selectedSeatId = null, models = null } = input || {}; + if (!project || typeof project !== "object") { + return { + type: "stack", + children: [ + { type: "text", text: "三省六部" }, + { + type: "callout", + tone: "warn", + text: "无法确定当前项目:原生面板作用域不含 workspaceId,且未能由 sessionId 反查到所属项目。请从已启用「三省六部」的项目会话中打开,或在 Web 工作台查看。" + } + ] + }; + } + const records = seatRecords(project); + const sel = selectedSeatId && records[selectedSeatId] ? selectedSeatId : records.lead ? "lead" : null; + const ready = project.status === "ready"; + const boundCount = SEAT_IDS.filter((id) => isBound(records[id])).length; + const children = [ + { type: "text", text: "三省六部 · " + (asText(project.name) || "未命名项目") }, + { + type: "callout", + tone: ready ? "good" : "warn", + text: (PROJECT_STATUS_TEXT[project.status] || "状态未知") + " · 已绑定 " + boundCount + "/10 席" + } + ]; + for (const key of GROUP_ORDER) { + const g = groupNode(project, records, key, sel); + if (g) children.push(g); + } + children.push(selectedDetail(project, records, sel, models)); + return { type: "stack", children }; +} +var panel_default = buildPanelView; + +// src/native/index.js +var PANEL_ID = "sansheng"; +var viewBySession = /* @__PURE__ */ new Map(); +var selectionBySession = /* @__PURE__ */ new Map(); +var modelsBySession = /* @__PURE__ */ new Map(); +function cacheProject(project) { + if (!project || typeof project !== "object") return; + const seats = project.seats; + for (const id of SEAT_IDS) { + let seat = null; + if (Array.isArray(seats)) seat = seats.find((s) => s && s.id === id) || null; + else if (seats && typeof seats === "object") seat = seats[id] || null; + if (seat && typeof seat.sessionId === "string" && seat.sessionId) { + viewBySession.set(seat.sessionId, project); + } + } +} +function resolveProject(native, scope) { + const sid = scope && typeof scope.sessionId === "string" ? scope.sessionId : null; + const lookup = native && (native.sansheng || native.sanshengProjects) || null; + if (lookup && typeof lookup.projectForScope === "function") { + try { + const p = lookup.projectForScope(scope); + if (p) { + cacheProject(p); + return p; + } + } catch (e) { + } + } + if (lookup && typeof lookup.projectForSession === "function" && sid) { + try { + const p = lookup.projectForSession(sid); + if (p) { + cacheProject(p); + return p; + } + } catch (e) { + } + } + let workspaceId = null; + try { + const sessions = native && native.sessions; + if (sessions && typeof sessions.binding === "function" && sid) { + const b = sessions.binding(sid); + workspaceId = b && (b.workspaceId || b.workspace && b.workspace.id) || null; + } + } catch (e) { + } + if (lookup && typeof lookup.projectForWorkspace === "function" && workspaceId) { + try { + const p = lookup.projectForWorkspace(workspaceId); + if (p) { + cacheProject(p); + return p; + } + } catch (e) { + } + } + if (sid && viewBySession.has(sid)) return viewBySession.get(sid); + return null; +} +function makeView(native, scope) { + const sid = scope && typeof scope.sessionId === "string" ? scope.sessionId : null; + const project = resolveProject(native, scope); + const selectedSeatId = sid && selectionBySession.has(sid) ? selectionBySession.get(sid) : null; + const models = sid && modelsBySession.has(sid) ? modelsBySession.get(sid) : null; + return buildPanelView({ project, selectedSeatId, models }); +} +function normalizeAction(event) { + const a = event && event.action; + if (a && typeof a === "object") return a; + const v = event && event.value; + if (v && typeof v === "object" && typeof v.type === "string") return v; + if (typeof a === "string") return Object.assign({ type: a }, v && typeof v === "object" ? v : {}); + return null; +} +async function handleEvent(native, scope, event) { + const sid = scope && typeof scope.sessionId === "string" ? scope.sessionId : null; + const action = normalizeAction(event); + if (!action || typeof action.type !== "string") return []; + switch (action.type) { + case "sansheng/select-seat": { + if (sid && action.seatId) selectionBySession.set(sid, action.seatId); + return [{ type: "refresh", id: PANEL_ID }]; + } + case "sansheng/select-model": { + if (sid && action.seatId) selectionBySession.set(sid, action.seatId); + return [{ type: "toast", text: "模型选择在原生面板暂未接持久化,请在 Web 端保存(需真机核验)" }]; + } + case "sansheng/enter-session": { + const bridged = native && native.dshGo; + const open = bridged && (bridged.openSession || bridged.navigate) || native && native.sansheng && native.sansheng.openSession; + if (typeof open === "function" && action.sessionId) { + try { + await open(action.sessionId); + return [{ type: "toast", text: "已请求打开会话" }]; + } catch (e) { + } + } + return [{ type: "toast", text: "原生 effect 暂不支持会话跳转,请从宿主会话列表进入(需真机核验)" }]; + } + default: + return []; + } +} +function makeDataProvider(native, dshGo) { + return function data(scope, emit) { + let cancelled = false; + const run = async () => { + if (typeof fetch !== "function") return; + const sid = scope && typeof scope.sessionId === "string" ? scope.sessionId : null; + if (!sid) return; + const post = async (endpoint, payload) => { + const res = await fetch("/api/sansheng", { + method: "POST", + credentials: "same-origin", + headers: { "content-type": "application/json" }, + body: JSON.stringify({ endpoint, payload: payload == null ? null : payload }) + }); + if (!res.ok) throw new Error("HTTP " + res.status); + const r = await res.json(); + if (!r || r.ok !== true) throw new Error(r && r.error && r.error.message || "request failed"); + return r.value; + }; + const list = await post("list"); + const projects = list && Array.isArray(list.projects) ? list.projects : []; + for (const meta of projects) { + const value = await post("project", { projectId: meta.id }); + const project = value && value.project ? value.project : value; + cacheProject(project); + const seats = project && project.seats; + const found = Array.isArray(seats) ? seats.some((s) => s && s.sessionId === sid) : seats && Object.values(seats).some((s) => s && s.sessionId === sid); + if (found) { + if (!cancelled) { + try { + emit({ project }); + } catch (e) { + } + try { + if (dshGo && typeof dshGo.refresh === "function") dshGo.refresh(PANEL_ID, scope); + } catch (e) { + } + } + return; + } + } + }; + run().catch(() => { + }); + return () => { + cancelled = true; + }; + }; +} +function install(ctx) { + if (!ctx || typeof ctx.inject !== "function") return () => { + }; + return ctx.inject(["dshGo", "sessions"], (native) => { + const dshGo = native && native.dshGo; + if (!dshGo || typeof dshGo.panel !== "function") return () => { + }; + const disposers = []; + try { + const offPanel = native.dshGo.panel(PANEL_ID, { + view: (scope, caps) => makeView(native, scope), + data: makeDataProvider(native, native.dshGo) + }); + if (typeof offPanel === "function") disposers.push(offPanel); + } catch (e) { + } + if (typeof native.dshGo.on === "function") { + try { + const offOn = native.dshGo.on(PANEL_ID, (scope, event) => handleEvent(native, scope, event)); + if (typeof offOn === "function") disposers.push(offOn); + } catch (e) { + } + } + return () => { + for (const off of disposers) { + try { + off(); + } catch (e) { + } + } + }; + }); +} +var native_default = { install }; + +// src/client/index.js +var import_react = require("react"); +var import_react_dom = require("react-dom"); +var inject = ["sessions", "uiWorkspace", "uiConversation", "slots", "theme", "layout"]; +var PLUGIN_ID = "dsh-sansheng"; +var TAB_KIND = "sansheng-workbench"; +var TAB_TYPE_ID = "dsh-sansheng:workbench"; +function installStyles(doc, tag, text) { + if (!doc || !doc.head) return null; + const style = doc.createElement("style"); + style.dataset.plugin = PLUGIN_ID; + style.dataset.sansheng = tag; + style.textContent = text; + doc.head.appendChild(style); + return style; +} +function svgWrap(children, props) { + return (0, import_react.createElement)("svg", { + viewBox: "0 0 24 24", + width: 16, + height: 16, + fill: "none", + stroke: "currentColor", + strokeWidth: 1.6, + strokeLinecap: "round", + strokeLinejoin: "round", + "aria-hidden": "true", + ...props || {} + }, children); +} +var TreeIcon = (props) => svgWrap([ + (0, import_react.createElement)("rect", { key: "a", x: 9, y: 2, width: 6, height: 5, rx: 1 }), + (0, import_react.createElement)("path", { key: "b", d: "M12 7v5M5 16v-4h14v4" }), + (0, import_react.createElement)("rect", { key: "c", x: 2, y: 16, width: 6, height: 5, rx: 1 }), + (0, import_react.createElement)("rect", { key: "d", x: 16, y: 16, width: 6, height: 5, rx: 1 }) +], props); +var CloseIcon = (props) => svgWrap([(0, import_react.createElement)("path", { key: "p", d: "m6 6 12 12M6 18 18 6" })], props); +var FolderIcon = (props) => svgWrap([(0, import_react.createElement)("path", { key: "p", d: "M3 7V5a2 2 0 0 1 2-2h5l2 3h7a2 2 0 0 1 2 2v11H3Z" })], props); +var GearIcon = (props) => svgWrap([ + (0, import_react.createElement)("path", { key: "a", d: "M4 6h16M4 12h16M4 18h16" }), + (0, import_react.createElement)("circle", { key: "b", cx: 9, cy: 6, r: 2 }), + (0, import_react.createElement)("circle", { key: "c", cx: 16, cy: 12, r: 2 }), + (0, import_react.createElement)("circle", { key: "d", cx: 8, cy: 18, r: 2 }) +], props); +var ChevronIcon = (props) => (0, import_react.createElement)("svg", { + viewBox: "0 0 24 24", + width: 14, + height: 14, + fill: "none", + stroke: "currentColor", + strokeWidth: 1.6, + strokeLinecap: "round", + strokeLinejoin: "round", + className: "ssw-chevron", + "aria-hidden": "true" +}, (0, import_react.createElement)("path", { d: "m6 9 6 6 6-6" })); +function isFn(value) { + return typeof value === "function"; +} +function safeCall(obj, name) { + try { + if (!obj || !isFn(obj[name])) return void 0; + return obj[name](); + } catch { + return void 0; + } +} +function snapshotOf(obj) { + if (!obj) return void 0; + if (isFn(obj.getSnapshot)) { + try { + return obj.getSnapshot(); + } catch { + return void 0; + } + } + return obj; +} +function apply(ctx) { + if (typeof document !== "undefined") installStyles(document, "workbench", CSS); + const get = (name) => { + try { + return ctx.get(name); + } catch { + return void 0; + } + }; + function workspaceItems() { + const fromWorkspaces = snapshotOf(get("workspaces")?.list)?.items; + if (Array.isArray(fromWorkspaces)) return fromWorkspaces; + const fromUi = snapshotOf(get("uiWorkspace")?.workspaces)?.items; + if (Array.isArray(fromUi)) return fromUi; + return []; + } + function normalizeWorkspace(item) { + if (!item || typeof item !== "object") return null; + const workspaceId = item.workspaceId ?? item.id ?? null; + if (typeof workspaceId !== "string" || !workspaceId) return null; + return { + workspaceId, + name: typeof item.name === "string" ? item.name : typeof item.title === "string" ? item.title : void 0, + path: typeof item.path === "string" ? item.path : void 0 + }; + } + function currentSessionId() { + const snap = snapshotOf(get("sessions")?.list) ?? snapshotOf(get("sessions")); + if (!snap || typeof snap !== "object") return null; + for (const key of ["activeId", "currentId", "selectedId"]) { + if (typeof snap[key] === "string" && snap[key]) return snap[key]; + } + if (snap.byId && typeof snap.byId === "object") { + const main = Object.values(snap.byId).find((session) => (session?.retainedBy?.mainView ?? 0) > 0); + if (main && typeof main.id === "string") return main.id; + } + return null; + } + function currentWorkspaceId() { + const candidates = []; + for (const holder of [get("workspaces"), get("uiWorkspace")]) { + if (!holder) continue; + for (const key of ["currentWorkspaceId", "currentId", "activeId"]) { + if (isFn(holder[key])) candidates.push(safeCall(holder, key)); + else if (typeof holder[key] === "string") candidates.push(holder[key]); + } + for (const key of ["current", "active", "selected", "currentWorkspace"]) { + const value = holder[key]; + const snap = snapshotOf(value); + if (snap && typeof snap === "object") candidates.push(snap.workspaceId ?? snap.id); + else if (typeof value === "string") candidates.push(value); + } + } + const sessionId = currentSessionId(); + if (sessionId) { + const owner = workspaceItems().find((item) => Array.isArray(item.sessionIds) && item.sessionIds.includes(sessionId)); + if (owner) candidates.push(owner.workspaceId ?? owner.id); + } + return candidates.find((id) => typeof id === "string" && id) ?? null; + } + function currentWorkspace() { + const items = workspaceItems().map(normalizeWorkspace).filter(Boolean); + const id = currentWorkspaceId(); + if (id) { + const hit = items.find((item) => item.workspaceId === id); + return hit || { workspaceId: id, name: void 0, path: void 0 }; + } + if (items.length === 1) return items[0]; + return null; + } + function seatRecordOf(view, id) { + const seats = view && view.project ? view.project.seats : null; + if (Array.isArray(seats)) return seats.find((seat) => seat && seat.id === id) || null; + if (seats && typeof seats === "object") return seats[id] || null; + return null; + } + function navigateToSession(sessionId) { + if (!sessionId) return false; + const attempts = []; + const ui = get("uiWorkspace"); + if (ui) { + if (isFn(ui.openSession)) attempts.push(() => ui.openSession(sessionId)); + if (isFn(ui.open)) attempts.push(() => ui.open(sessionId)); + } + const sessions = get("sessions"); + if (sessions) { + if (isFn(sessions.open)) attempts.push(() => sessions.open(sessionId)); + if (isFn(sessions.openSession)) attempts.push(() => sessions.openSession(sessionId)); + if (isFn(sessions.select)) attempts.push(() => sessions.select(sessionId)); + } + for (const name of ["navigation", "navigator", "router"]) { + const svc = get(name); + if (!svc) continue; + if (isFn(svc.openSession)) attempts.push(() => svc.openSession(sessionId)); + if (isFn(svc.navigate)) attempts.push(() => svc.navigate({ sessionId })); + if (isFn(svc.open)) attempts.push(() => svc.open(sessionId)); + } + for (const run of attempts) { + try { + const result = run(); + if (result && isFn(result.then)) result.catch(() => { + }); + return true; + } catch { + } + } + console.warn("[sansheng] 未找到可用的会话导航接口,仅发出 navigate 意图:", sessionId); + try { + if (typeof window !== "undefined") { + window.dispatchEvent(new CustomEvent("sansheng:navigate", { detail: { sessionId } })); + } + } catch { + } + return false; + } + function ensureRightTab() { + const tabs = get("sidebarRightTabs"); + return !!(tabs && isFn(tabs.get) && tabs.get(TAB_KIND)); + } + function tryOpenRightTab() { + const right = get("sidebarRight"); + if (!right || !isFn(right.openTab)) return false; + if (!ensureRightTab()) return false; + try { + right.openTab(TAB_KIND); + return true; + } catch (error) { + console.warn("[sansheng] 打开右侧标签失败,改用浮动面板:", error && error.message ? error.message : error); + return false; + } + } + function SanshengTabBody() { + return (0, import_react.createElement)("div", { className: "ssw-tab-body" }, (0, import_react.createElement)(SanshengWorkbench, {})); + } + function SanshengTabTitle() { + return (0, import_react.createElement)("span", { className: "ssw-tab-title" }, "三省六部"); + } + function registerRightTabType() { + try { + if (!isFn(ctx.inject)) return; + ctx.inject(["sidebarRightTabs"], (injected) => { + const tabs = injected.get("sidebarRightTabs"); + if (!tabs || !isFn(tabs.register)) return; + let disposeType = null, disposeBody = null, disposeTitle = null; + try { + disposeType = tabs.register({ id: TAB_TYPE_ID, kind: TAB_KIND, keepMounted: true, priority: "extension", title: () => "三省六部" }); + disposeBody = ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({ + name: "sidebar.right.pane.tab", + key: TAB_TYPE_ID, + inject: (sessionId) => ({ sessionId }) + }, SanshengTabBody)); + disposeTitle = ctx.slots.inject("sidebar.right.pane.tab.title", () => ctx.slots.register({ + name: "sidebar.right.pane.tab.title", + key: TAB_TYPE_ID, + inject: (sessionId) => ({ sessionId }) + }, SanshengTabTitle)); + } catch (error) { + console.warn("[sansheng] 注册右侧标签失败:", error && error.message ? error.message : error); + try { + disposeBody && disposeBody(); + } catch { + } + try { + disposeTitle && disposeTitle(); + } catch { + } + try { + disposeType && disposeType(); + } catch { + } + return; + } + return () => { + try { + disposeBody && disposeBody(); + } catch { + } + try { + disposeTitle && disposeTitle(); + } catch { + } + try { + disposeType && disposeType(); + } catch { + } + }; + }); + } catch (error) { + console.warn("[sansheng] 注册右侧标签失败:", error && error.message ? error.message : error); + } + } + function SanshengWorkbench(props) { + const onClose = props && props.onClose ? props.onClose : null; + const [phase, setPhase] = (0, import_react.useState)("loading"); + const [error, setError] = (0, import_react.useState)(null); + const [notice, setNotice] = (0, import_react.useState)(null); + const [view, setView] = (0, import_react.useState)(null); + const [models, setModels] = (0, import_react.useState)(null); + const [selectedSeatId, setSelectedSeatId] = (0, import_react.useState)(SEAT_IDS[0]); + const [draft, setDraft] = (0, import_react.useState)({}); + const [busy, setBusy] = (0, import_react.useState)(false); + const [configOpen, setConfigOpen] = (0, import_react.useState)(false); + const [reportOpen, setReportOpen] = (0, import_react.useState)(false); + const alive = (0, import_react.useRef)(true); + (0, import_react.useEffect)(() => () => { + alive.current = false; + }, []); + const loadProject = (0, import_react.useCallback)(async () => { + setPhase("loading"); + setError(null); + setNotice(null); + const workspace = currentWorkspace(); + if (!workspace) { + setPhase("no-workspace"); + return; + } + try { + const projectView = await request("open", { + workspaceId: workspace.workspaceId, + name: workspace.name, + path: workspace.path + }); + let modelCatalog = null; + try { + modelCatalog = await request("models"); + } catch (modelError) { + console.warn("[sansheng] 模型目录加载失败:", modelError && modelError.message ? modelError.message : modelError); + } + if (!alive.current) return; + setView(projectView); + setModels(modelCatalog); + setPhase("ready"); + } catch (loadError) { + if (!alive.current) return; + setError(loadError && loadError.message ? loadError.message : "加载失败"); + setPhase("error"); + } + }, []); + (0, import_react.useEffect)(() => { + void loadProject(); + }, [loadProject]); + const wb = buildWorkbenchView(view, { selectedSeatId, models, draft }); + const seatById = (0, import_react.useMemo)(() => { + const map = {}; + for (const seat of wb.seats) map[seat.id] = seat; + return map; + }, [wb.seats]); + function pickSeat(id) { + if (!id) return; + if (id !== selectedSeatId) { + setSelectedSeatId(id); + setConfigOpen(false); + } + const seat = seatById[id]; + if (wb.ready && seat && seat.status === "bound") { + const rec = seatRecordOf(view, id); + if (rec && rec.sessionId) { + navigateToSession(rec.sessionId); + setNotice("已切换到" + seat.name + "会话"); + return; + } + } + if (wb.ready && seat && seat.status !== "bound") setNotice("该席尚未绑定会话,先启用或重试启用"); + } + function setModelValue(value) { + setDraft((prev) => updateDraft(prev, selectedSeatId, { modelValue: value })); + } + function setInstructions(value) { + setDraft((prev) => updateDraft(prev, selectedSeatId, { instructions: value })); + } + async function enableSeats() { + const projectId = view && view.project ? view.project.id : null; + if (!projectId) return; + setBusy(true); + setError(null); + setNotice("正在启用十席…"); + try { + const next = await request("enable", { projectId }); + if (!alive.current) return; + setView(next); + setNotice("十席已启用(建立独立会话,不自动运行模型)"); + } catch (enableError) { + if (alive.current) setError(enableError && enableError.message ? enableError.message : "启用失败"); + } finally { + if (alive.current) setBusy(false); + } + } + async function saveConfig() { + const projectId = view && view.project ? view.project.id : null; + if (!projectId) return; + const seatId = wb.selected.id; + const value = wb.selected.modelValue; + if (!value) { + setNotice("请先为当前角色选择模型"); + return; + } + const option = findModelOption(wb.selected.modelOptions, value); + const model = option ? option.reasoningEffort ? { provider: option.provider, model: option.model, reasoningEffort: option.reasoningEffort } : { provider: option.provider, model: option.model } : null; + setBusy(true); + setError(null); + setNotice("保存中…"); + try { + await request("configure", { projectId, seatId, model, instructions: wb.selected.instructions }); + const next = await request("project", { projectId }); + if (!alive.current) return; + setView(next); + setDraft((prev) => clearDraft(prev, seatId)); + setNotice("已保存"); + } catch (saveError) { + if (alive.current) setError(saveError && saveError.message ? saveError.message : "保存失败"); + } finally { + if (alive.current) setBusy(false); + } + } + const seatCard = (seat) => (0, import_react.createElement)( + "button", + { + key: seat.id, + type: "button", + className: "ssw-seat", + "aria-pressed": seat.selected ? "true" : "false", + title: seat.name + " · " + seat.duty + "(" + seat.statusLabel + ")", + onClick: () => pickSeat(seat.id) + }, + (0, import_react.createElement)( + "span", + { className: "ssw-role-top" }, + (0, import_react.createElement)("span", { className: "ssw-role-name" }, seat.name), + (0, import_react.createElement)("span", { className: "ssw-dot", "data-status": seat.status, "aria-hidden": "true" }) + ), + (0, import_react.createElement)("span", { className: "ssw-role-duty" }, seat.duty) + ); + const pickList = (ids) => ids.map((id) => seatById[id]).filter(Boolean); + const tree = (0, import_react.createElement)( + "section", + { className: "ssw-tree", "aria-label": "切换角色" }, + (0, import_react.createElement)("div", { className: "ssw-lead" }, pickList(wb.groups.lead).map(seatCard)), + (0, import_react.createElement)( + "div", + { className: "ssw-sansheng" }, + (0, import_react.createElement)("span", { className: "ssw-group-label" }, "三省"), + (0, import_react.createElement)("div", { className: "ssw-trio" }, pickList(wb.groups.sansheng).map(seatCard)) + ), + (0, import_react.createElement)( + "div", + { className: "ssw-ministries" }, + (0, import_react.createElement)("span", { className: "ssw-group-label" }, "六部 · 尚书统筹"), + (0, import_react.createElement)("div", { className: "ssw-six" }, pickList(wb.groups.liubu).map(seatCard)) + ) + ); + const head = (0, import_react.createElement)( + "header", + { className: "ssw-head" }, + (0, import_react.createElement)(TreeIcon), + (0, import_react.createElement)("strong", { className: "ssw-head-title" }, "工作台"), + onClose ? (0, import_react.createElement)("button", { type: "button", className: "ssw-icon-btn", onClick: onClose, "aria-label": "收起工作台" }, (0, import_react.createElement)(CloseIcon)) : null + ); + const projectInfo = (0, import_react.createElement)( + "div", + { className: "ssw-project" }, + (0, import_react.createElement)( + "div", + { className: "ssw-project-line" }, + (0, import_react.createElement)("span", { className: "ssw-eyebrow" }, (0, import_react.createElement)(FolderIcon), "当前项目"), + (0, import_react.createElement)("span", { className: "ssw-count" }, wb.project.seatCount + " 个角色 · " + wb.project.sessionCount + " 个会话") + ), + (0, import_react.createElement)("div", { className: "ssw-project-title" }, wb.projectTitle || "未命名项目") + ); + const enableBlock = !wb.ready ? (0, import_react.createElement)( + "div", + { className: "ssw-enable" }, + (0, import_react.createElement)("p", { className: "ssw-enable-note" }, "这个项目还没有启用十席。启用会建立十个独立会话,但不会自动运行模型。"), + (0, import_react.createElement)("button", { + type: "button", + className: "ssw-primary", + disabled: busy, + onClick: enableSeats + }, busy ? "正在启用…" : "启用此项目的十席") + ) : null; + const currentCard = (0, import_react.createElement)( + "section", + { className: "ssw-current" }, + (0, import_react.createElement)( + "div", + { className: "ssw-current-top" }, + (0, import_react.createElement)("strong", { className: "ssw-current-name" }, wb.selected.name), + (0, import_react.createElement)("span", { className: "ssw-current-label" }, "角色职责 · " + wb.selected.statusLabel) + ), + (0, import_react.createElement)("p", { className: "ssw-current-text" }, wb.selected.responsibility) + ); + const optionEls = wb.selected.modelOptions.map((option) => (0, import_react.createElement)("option", { key: option.value, value: option.value }, option.label)); + if (wb.selected.modelValue && !wb.selected.modelOptions.some((option) => option.value === wb.selected.modelValue)) { + optionEls.push((0, import_react.createElement)("option", { key: "__current__", value: wb.selected.modelValue }, wb.selected.modelLabel)); + } + const config = (0, import_react.createElement)( + "section", + { className: "ssw-config" }, + (0, import_react.createElement)( + "button", + { + type: "button", + className: "ssw-config-toggle", + "aria-expanded": configOpen ? "true" : "false", + onClick: () => setConfigOpen((value) => !value) + }, + (0, import_react.createElement)(GearIcon), + (0, import_react.createElement)("span", null, "配置" + wb.selected.name + (wb.selected.dirty ? " · 未保存" : "")), + (0, import_react.createElement)(ChevronIcon) + ), + configOpen ? (0, import_react.createElement)( + "div", + { className: "ssw-config-body" }, + (0, import_react.createElement)("label", { className: "ssw-label" }, "会话模型"), + (0, import_react.createElement)( + "select", + { + className: "ssw-field", + value: wb.selected.modelValue, + disabled: busy, + onChange: (event) => setModelValue(event.target.value) + }, + (0, import_react.createElement)("option", { value: "", disabled: true }, UNCHOSEN_MODEL_LABEL), + ...optionEls + ), + (0, import_react.createElement)("label", { className: "ssw-label" }, "角色补充说明"), + (0, import_react.createElement)("textarea", { + className: "ssw-field ssw-textarea", + rows: 4, + value: wb.selected.instructions, + disabled: busy, + placeholder: "补充该角色在当前项目中的工作要求", + onChange: (event) => setInstructions(event.target.value) + }), + (0, import_react.createElement)("p", { className: "ssw-scope-note" }, "每个角色是独立会话;模型与说明只影响当前项目当前角色,不改变宿主默认模型。"), + (0, import_react.createElement)( + "div", + { className: "ssw-save-row" }, + (0, import_react.createElement)("button", { type: "button", className: "ssw-primary", disabled: busy, onClick: saveConfig }, busy ? "保存中…" : "保存配置"), + wb.selected.dirty ? (0, import_react.createElement)("span", { className: "ssw-save-status" }, "有未保存修改") : null + ) + ) : null + ); + const report = (0, import_react.createElement)( + "section", + { className: "ssw-report" }, + (0, import_react.createElement)("button", { + type: "button", + className: "ssw-report-toggle", + "aria-expanded": reportOpen ? "true" : "false", + onClick: () => setReportOpen((value) => !value) + }, reportOpen ? "收起职责汇报" : "全部汇报职责"), + reportOpen ? (0, import_react.createElement)( + "div", + { className: "ssw-report-list" }, + SEAT_IDS.map((id) => { + const rec = seatRecordOf(view, id); + const m = rec && rec.model; + const modelLabel = m && m.model ? m.model + (m.reasoningEffort ? " · " + m.reasoningEffort : "") : "未选择模型"; + return (0, import_react.createElement)( + "div", + { key: id, className: "ssw-report-item", "data-seat": id }, + (0, import_react.createElement)( + "div", + { className: "ssw-report-head" }, + (0, import_react.createElement)("strong", null, SEATS[id].label), + (0, import_react.createElement)("span", null, SEATS[id].duty) + ), + (0, import_react.createElement)("p", { className: "ssw-report-model" }, "模型:" + modelLabel), + (0, import_react.createElement)("p", { className: "ssw-report-text" }, SEATS[id].responsibility) + ); + }) + ) : null + ); + const statusEl = error ? (0, import_react.createElement)("p", { className: "ssw-error", role: "alert" }, error) : notice ? (0, import_react.createElement)("p", { className: "ssw-notice", role: "status" }, notice) : null; + let body; + if (phase === "loading") body = (0, import_react.createElement)("div", { className: "ssw-loading" }, "正在加载工作台…"); + else if (phase === "no-workspace") body = (0, import_react.createElement)( + "div", + { className: "ssw-empty" }, + (0, import_react.createElement)("p", null, "先从左侧选择一个项目"), + (0, import_react.createElement)("button", { type: "button", className: "ssw-primary", onClick: loadProject }, "重试") + ); + else if (phase === "error" && !view) body = (0, import_react.createElement)( + "div", + { className: "ssw-empty" }, + (0, import_react.createElement)("p", { className: "ssw-error" }, error || "加载失败"), + (0, import_react.createElement)("button", { type: "button", className: "ssw-primary", onClick: loadProject }, "重试") + ); + else body = (0, import_react.createElement)(import_react.Fragment, null, projectInfo, enableBlock, tree, report, currentCard, config, statusEl); + return (0, import_react.createElement)("div", { className: "ssw-root ssw-scope" }, head, body); + } + function SanshengEntry(props) { + const compact = !!(props && props.compact); + const [floating, setFloating] = (0, import_react.useState)(false); + const onClick = () => { + if (tryOpenRightTab()) { + setFloating(false); + return; + } + setFloating((value) => !value); + }; + let panel = null; + if (floating) { + const card = (0, import_react.createElement)( + "div", + { className: "ssw-float", role: "dialog", "aria-label": "三省六部工作台" }, + (0, import_react.createElement)(SanshengWorkbench, { onClose: () => setFloating(false) }) + ); + const canPortal = typeof document !== "undefined" && document.body && isFn(import_react_dom.createPortal); + panel = canPortal ? (0, import_react_dom.createPortal)(card, document.body) : card; + } + return (0, import_react.createElement)( + import_react.Fragment, + null, + (0, import_react.createElement)( + "button", + { + type: "button", + className: compact ? "ssw-entry ssw-entry-compact" : "ssw-entry", + title: "三省六部", + "aria-expanded": floating ? "true" : "false", + onClick + }, + (0, import_react.createElement)(TreeIcon), + (0, import_react.createElement)("span", { className: "ssw-entry-label" }, "三省六部") + ), + panel + ); + } + function SanshengSessionAction(props) { + const children = props && props.children; + return (0, import_react.createElement)(import_react.Fragment, null, children, (0, import_react.createElement)(SanshengEntry, { compact: true })); + } + try { + if (ctx.slots && isFn(ctx.slots.inject) && isFn(ctx.slots.register)) { + ctx.slots.inject("sidebar.session.action", () => ctx.slots.register({ + name: "sidebar.session.action", + id: "sansheng-entry" + }, SanshengSessionAction)); + } else { + console.warn("[sansheng] 宿主未提供 slots.inject / slots.register,无法注册侧栏入口"); + } + } catch (error) { + console.warn("[sansheng] 注册侧栏入口失败:", error && error.message ? error.message : error); + } + registerRightTabType(); + try { + install(ctx); + } catch (error) { + console.warn("[sansheng] 原生面板注册失败:", error && error.message ? error.message : error); + } +} +return Object.defineProperty({ ...module.exports }, Symbol.toStringTag, { value: 'Module' }) + }, +}) diff --git a/sansheng/cordis.patch.yml b/sansheng/cordis.patch.yml new file mode 100644 index 0000000..728e622 --- /dev/null +++ b/sansheng/cordis.patch.yml @@ -0,0 +1,4 @@ +# 三省六部:挂到 DSH 宿主的三省六部工作台插件。 +- insert: + - id: sansheng + name: 'dsh-sansheng' diff --git a/sansheng/index.js b/sansheng/index.js new file mode 100644 index 0000000..e1aa966 --- /dev/null +++ b/sansheng/index.js @@ -0,0 +1,46 @@ +// 三省六部宿主插件入口:只使用宿主公开注入服务,不 patch DSH,不写 profile 全局默认。 +import { SanshengStore } from './src/host/store.js' +import { createProvisioner } from './src/host/provision.js' +import { SanshengService } from './src/host/service.js' +import { createApiHandler } from './src/host/api.js' +import { installPromptSection } from './src/host/prompt.js' +import { sanshengStatePath } from './src/host/paths.js' +import { ROUTE } from './src/host/constants.js' + +export const name = 'sansheng' +export const inject = ['workspaceRegistry', 'sessionController', 'agents', 'llm', 'systemPrompt', 'connection'] + +export function apply(ctx, config = {}) { + const store = new SanshengStore( + typeof config.statePath === 'string' && config.statePath !== '' ? config.statePath : sanshengStatePath(config.home), + ) + // apply 必须同步返回(cordis 把异步/非函数返回值当非法 effect);状态在首次请求时惰性读入。 + void store.ensureLoaded().catch(error => { + console.warn(`sansheng: ${error?.message ?? error}`) + }) + + const host = { + workspaceRegistry: ctx.workspaceRegistry, + sessionController: ctx.sessionController, + agents: ctx.agents, + llm: ctx.llm, + } + const provisioner = createProvisioner({ store, host }) + const service = new SanshengService({ store, host, provisioner }) + const handle = createApiHandler(service) + + ctx.effect(() => installPromptSection(ctx, { store }), 'sansheng: prompt section') + + // 复用宿主共享 /api 通道;浏览器带会话 Cookie 认证。 + ctx.effect(() => ctx.connection.fetch.register({ + path: ROUTE, + methods: ['POST'], + requestBody: 'buffered', + fetch: async request => { + let body + try { body = await request.json() } catch { body = {} } + const result = await handle(String(body?.endpoint ?? ''), body?.payload) + return new Response(JSON.stringify(result), { status: 200, headers: { 'content-type': 'application/json' } }) + }, + }), 'sansheng: api route') +} diff --git a/sansheng/package.json b/sansheng/package.json new file mode 100644 index 0000000..17cc72a --- /dev/null +++ b/sansheng/package.json @@ -0,0 +1,52 @@ +{ + "name": "dsh-sansheng", + "version": "0.1.0", + "description": "三省六部:每个项目固定十席角色与独立会话的 DSH 插件(第一版)。", + "keywords": [ + "dsh-plugin", + "deepseek-harness", + "dsh", + "sansheng", + "multi-agent", + "agents" + ], + "license": "Apache-2.0", + "type": "module", + "main": "index.js", + "exports": { + ".": "./index.js", + "./client": "./client.js", + "./package.json": "./package.json" + }, + "files": [ + "index.js", + "client.js", + "src/", + "cordis.patch.yml", + "README.md" + ], + "scripts": { + "build": "node scripts/build-client.mjs", + "build:check": "node scripts/build-client.mjs --check", + "test": "node --test --test-timeout=120000 \"test/*.test.js\"" + }, + "peerDependencies": { + "@deepseek-ai/cordis": "*", + "@deepseek-ai/dsh-llm": "*", + "@deepseek-ai/dsh-web": "*" + }, + "dsh": { + "client": { + "platform": "web", + "inject": [ + "@deepseek-ai/dsh-client-ui-primitives" + ] + }, + "bundle": { + "patch": "./cordis.patch.yml" + } + }, + "devDependencies": { + "esbuild": "0.28.2" + } +} diff --git a/sansheng/pnpm-lock.yaml b/sansheng/pnpm-lock.yaml new file mode 100644 index 0000000..676fa64 --- /dev/null +++ b/sansheng/pnpm-lock.yaml @@ -0,0 +1,407 @@ +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + '@deepseek-ai/cordis': + specifier: '*' + version: 4.1.0 + '@deepseek-ai/dsh-llm': + specifier: '*' + version: 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))) + '@deepseek-ai/dsh-web': + specifier: '*' + version: 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-llm@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))) + devDependencies: + esbuild: + specifier: 0.28.2 + version: 0.28.2 + +packages: + + '@deepseek-ai/cordis@4.1.0': + resolution: {integrity: sha512-CJrjNyBkKn1SfvBQUcgFYKFnLjS+uKrhdMsbHU60xabvi12d+xQ+IQSNlME5Z+B+4Zi6n4BDknKY94tEPeo47w==} + hasBin: true + peerDependencies: + '@deepseek-ai/cordis-plugin-include': ~1.1.0 + '@deepseek-ai/cordis-plugin-loader': ~1.1.0 + peerDependenciesMeta: + '@deepseek-ai/cordis-plugin-include': + optional: true + '@deepseek-ai/cordis-plugin-loader': + optional: true + + '@deepseek-ai/cosmokit@1.9.0': + resolution: {integrity: sha512-5O1S53mZiJyZYcvxxD0Qv1EY7qFPSxbGyD8CbVK6gw7W9FvcXZj2YIX1ZkOqyQQ3Xt2rFkZDHJv0+V3Zmmp8CA==} + + '@deepseek-ai/dsh-attachment@0.0.1-rc.1': + resolution: {integrity: sha512-zBBw6h+YKOf7U8uEZezbFUjLsA8VU1GfCIUonAZHG2hWDWhWbrGaoO9fL8KyncEDSWMLMoIoGo+ZxDEPVJZYOA==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + '@deepseek-ai/dsh-brand': ^0.0.1-rc.1 + '@deepseek-ai/dsh-invariants': ^0.0.1-rc.1 + + '@deepseek-ai/dsh-brand@0.0.1-rc.1': + resolution: {integrity: sha512-XhwNAugG/baCVA+BMMvjihYi9XMLcDUew3G63i+ATWIZCvpx8CghbgcV93DEeMH2sqhNuQAssmHgXkpRld3gyQ==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + '@deepseek-ai/dsh-invariants': ^0.0.1-rc.1 + + '@deepseek-ai/dsh-invariants@0.0.1-rc.1': + resolution: {integrity: sha512-ZoGCGColviu3Tkdnv9hMkgBE4eg0hAz5GXR/knqRf7mJUeBlTCya2dIckYlqekYmp5L+1AeWxf9j+Lv1YRcvXw==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + + '@deepseek-ai/dsh-llm@0.0.1-rc.1': + resolution: {integrity: sha512-mRJj07IQNfRReGrhpMpL8AONiYKqfwzxvepg/ut9Wkj8oH2BuoftPS4cMnnXFFCUlYql04/sezwDLriYks/bmw==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + '@deepseek-ai/dsh-attachment': ^0.0.1-rc.1 + '@deepseek-ai/dsh-brand': ^0.0.1-rc.1 + '@deepseek-ai/dsh-invariants': ^0.0.1-rc.1 + '@deepseek-ai/dsh-timeout': ^0.0.1-rc.1 + + '@deepseek-ai/dsh-timeout@0.0.1-rc.1': + resolution: {integrity: sha512-lIMhY/JqA+eLpXXUN33xA7mlAYeHTDTWfcJ3CmEtplvGnvpDAHQ6oPeFs9JtWcfKbuNDZFMNutyhD0qoRkFQeg==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + '@deepseek-ai/dsh-invariants': ^0.0.1-rc.1 + + '@deepseek-ai/dsh-web@0.0.1-rc.1': + resolution: {integrity: sha512-kbfr8aPtbsO9XOYqbdy39HwLPlVDH3GWjg9J2cJge5jgGPfN0lGlh5hcj4wvHxUEhGOZF+vieR/U8NmzeaeZMw==} + peerDependencies: + '@deepseek-ai/cordis': ^4.0.1-rc.1 + '@deepseek-ai/dsh-invariants': ^0.0.1-rc.1 + '@deepseek-ai/dsh-llm': ^0.0.1-rc.1 + + '@deepseek-ai/schemastery@3.19.0': + resolution: {integrity: sha512-bDXoYQa7ghAhmdYD5VPlzKxEzJV/aKkz5l4V5h1u06z8GAPN1ROewSjvR9WiXhpa52E9fng8lpH5QdCRIQgnyQ==} + + '@esbuild/aix-ppc64@0.28.2': + resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + + '@esbuild/android-arm64@0.28.2': + resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==} + engines: {node: '>=18'} + cpu: [arm64] + os: [android] + + '@esbuild/android-arm@0.28.2': + resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==} + engines: {node: '>=18'} + cpu: [arm] + os: [android] + + '@esbuild/android-x64@0.28.2': + resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==} + engines: {node: '>=18'} + cpu: [x64] + os: [android] + + '@esbuild/darwin-arm64@0.28.2': + resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [darwin] + + '@esbuild/darwin-x64@0.28.2': + resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==} + engines: {node: '>=18'} + cpu: [x64] + os: [darwin] + + '@esbuild/freebsd-arm64@0.28.2': + resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [freebsd] + + '@esbuild/freebsd-x64@0.28.2': + resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==} + engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + + '@esbuild/linux-arm64@0.28.2': + resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==} + engines: {node: '>=18'} + cpu: [arm64] + os: [linux] + + '@esbuild/linux-arm@0.28.2': + resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + + '@esbuild/linux-ia32@0.28.2': + resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + + '@esbuild/linux-loong64@0.28.2': + resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + + '@esbuild/linux-mips64el@0.28.2': + resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + + '@esbuild/linux-ppc64@0.28.2': + resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + + '@esbuild/linux-riscv64@0.28.2': + resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + + '@esbuild/linux-s390x@0.28.2': + resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + + '@esbuild/linux-x64@0.28.2': + resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + + '@esbuild/netbsd-arm64@0.28.2': + resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + + '@esbuild/netbsd-x64@0.28.2': + resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + + '@esbuild/openbsd-arm64@0.28.2': + resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + + '@esbuild/openbsd-x64@0.28.2': + resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + + '@esbuild/openharmony-arm64@0.28.2': + resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + + '@esbuild/sunos-x64@0.28.2': + resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + + '@esbuild/win32-arm64@0.28.2': + resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + + '@esbuild/win32-ia32@0.28.2': + resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + + '@esbuild/win32-x64@0.28.2': + resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + + '@standard-schema/spec@1.1.0': + resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==} + + esbuild@0.28.2: + resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==} + engines: {node: '>=18'} + hasBin: true + +snapshots: + + '@deepseek-ai/cordis@4.1.0': + dependencies: + '@deepseek-ai/cosmokit': 1.9.0 + '@standard-schema/spec': 1.1.0 + + '@deepseek-ai/cosmokit@1.9.0': {} + + '@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/dsh-brand': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)) + '@deepseek-ai/dsh-invariants': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0) + + '@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/dsh-invariants': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0) + + '@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/schemastery': 3.19.0 + + '@deepseek-ai/dsh-llm@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/dsh-attachment': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)) + '@deepseek-ai/dsh-brand': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)) + '@deepseek-ai/dsh-invariants': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0) + '@deepseek-ai/dsh-timeout': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)) + '@deepseek-ai/schemastery': 3.19.0 + + '@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/dsh-invariants': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0) + + '@deepseek-ai/dsh-web@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-llm@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))))': + dependencies: + '@deepseek-ai/cordis': 4.1.0 + '@deepseek-ai/dsh-invariants': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0) + '@deepseek-ai/dsh-llm': 0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-attachment@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-brand@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)))(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))(@deepseek-ai/dsh-timeout@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0)(@deepseek-ai/dsh-invariants@0.0.1-rc.1(@deepseek-ai/cordis@4.1.0))) + '@deepseek-ai/schemastery': 3.19.0 + + '@deepseek-ai/schemastery@3.19.0': + dependencies: + '@deepseek-ai/cosmokit': 1.9.0 + '@standard-schema/spec': 1.1.0 + + '@esbuild/aix-ppc64@0.28.2': + optional: true + + '@esbuild/android-arm64@0.28.2': + optional: true + + '@esbuild/android-arm@0.28.2': + optional: true + + '@esbuild/android-x64@0.28.2': + optional: true + + '@esbuild/darwin-arm64@0.28.2': + optional: true + + '@esbuild/darwin-x64@0.28.2': + optional: true + + '@esbuild/freebsd-arm64@0.28.2': + optional: true + + '@esbuild/freebsd-x64@0.28.2': + optional: true + + '@esbuild/linux-arm64@0.28.2': + optional: true + + '@esbuild/linux-arm@0.28.2': + optional: true + + '@esbuild/linux-ia32@0.28.2': + optional: true + + '@esbuild/linux-loong64@0.28.2': + optional: true + + '@esbuild/linux-mips64el@0.28.2': + optional: true + + '@esbuild/linux-ppc64@0.28.2': + optional: true + + '@esbuild/linux-riscv64@0.28.2': + optional: true + + '@esbuild/linux-s390x@0.28.2': + optional: true + + '@esbuild/linux-x64@0.28.2': + optional: true + + '@esbuild/netbsd-arm64@0.28.2': + optional: true + + '@esbuild/netbsd-x64@0.28.2': + optional: true + + '@esbuild/openbsd-arm64@0.28.2': + optional: true + + '@esbuild/openbsd-x64@0.28.2': + optional: true + + '@esbuild/openharmony-arm64@0.28.2': + optional: true + + '@esbuild/sunos-x64@0.28.2': + optional: true + + '@esbuild/win32-arm64@0.28.2': + optional: true + + '@esbuild/win32-ia32@0.28.2': + optional: true + + '@esbuild/win32-x64@0.28.2': + optional: true + + '@standard-schema/spec@1.1.0': {} + + esbuild@0.28.2: + optionalDependencies: + '@esbuild/aix-ppc64': 0.28.2 + '@esbuild/android-arm': 0.28.2 + '@esbuild/android-arm64': 0.28.2 + '@esbuild/android-x64': 0.28.2 + '@esbuild/darwin-arm64': 0.28.2 + '@esbuild/darwin-x64': 0.28.2 + '@esbuild/freebsd-arm64': 0.28.2 + '@esbuild/freebsd-x64': 0.28.2 + '@esbuild/linux-arm': 0.28.2 + '@esbuild/linux-arm64': 0.28.2 + '@esbuild/linux-ia32': 0.28.2 + '@esbuild/linux-loong64': 0.28.2 + '@esbuild/linux-mips64el': 0.28.2 + '@esbuild/linux-ppc64': 0.28.2 + '@esbuild/linux-riscv64': 0.28.2 + '@esbuild/linux-s390x': 0.28.2 + '@esbuild/linux-x64': 0.28.2 + '@esbuild/netbsd-arm64': 0.28.2 + '@esbuild/netbsd-x64': 0.28.2 + '@esbuild/openbsd-arm64': 0.28.2 + '@esbuild/openbsd-x64': 0.28.2 + '@esbuild/openharmony-arm64': 0.28.2 + '@esbuild/sunos-x64': 0.28.2 + '@esbuild/win32-arm64': 0.28.2 + '@esbuild/win32-ia32': 0.28.2 + '@esbuild/win32-x64': 0.28.2 diff --git a/sansheng/scripts/build-client.mjs b/sansheng/scripts/build-client.mjs new file mode 100644 index 0000000..54699d8 --- /dev/null +++ b/sansheng/scripts/build-client.mjs @@ -0,0 +1,57 @@ +// Builds client.js (browser half) from src/client. Mirrors the DS Bot wrapper so dsh can +// load it as a classic script and resolve platform modules from the shell. +// node scripts/build-client.mjs writes client.js +// node scripts/build-client.mjs --check exit 1 if client.js differs from a fresh build +import { readFileSync, writeFileSync } from 'node:fs' +import { dirname, join } from 'node:path' +import { fileURLToPath } from 'node:url' + +const PLUGIN = dirname(dirname(fileURLToPath(import.meta.url))) +const OUTPUT = join(PLUGIN, 'client.js') +const PLATFORM_MODULES = ['react', 'react-dom', '@deepseek-ai/dsh-client-ui-primitives'] + +export async function bundleClient() { + let esbuild + try { esbuild = await import('esbuild') } catch { + throw new Error('缺少 esbuild:请先在包内安装 devDependencies(pnpm/npm i),再构建 client.js。') + } + const result = await esbuild.build({ + absWorkingDir: PLUGIN, + entryPoints: ['src/client/index.js'], + bundle: true, + format: 'cjs', + platform: 'browser', + target: 'es2022', + external: PLATFORM_MODULES, + treeShaking: false, + charset: 'utf8', + write: false, + logLevel: 'silent', + }) + if (result.warnings.length > 0) throw new Error('esbuild warnings:\n' + result.warnings.map(w => w.text).join('\n')) + return [ + '// Generated from src/client by `npm run build` (scripts/build-client.mjs). Do not edit by hand.', + 'window.__ModuleLoader__.load({', + " id: 'dsh-sansheng',", + ' factory: (require) => {', + 'const module = { exports: {} }', + result.outputFiles[0].text.trimEnd(), + "return Object.defineProperty({ ...module.exports }, Symbol.toStringTag, { value: 'Module' })", + ' },', + '})', + '', + ].join('\n') +} + +if (process.argv[1] === fileURLToPath(import.meta.url)) { + const next = await bundleClient() + if (process.argv.includes('--check')) { + let current = '' + try { current = readFileSync(OUTPUT, 'utf8') } catch {} + if (current !== next) { console.error('client.js 与 src/client 不一致,请运行 npm run build'); process.exit(1) } + console.log('client.js 是最新的') + } else { + writeFileSync(OUTPUT, next) + console.log('已写出 client.js') + } +} diff --git a/sansheng/src/client/index.js b/sansheng/src/client/index.js new file mode 100644 index 0000000..b910c93 --- /dev/null +++ b/sansheng/src/client/index.js @@ -0,0 +1,563 @@ +// 三省六部 Web 插件入口:左侧追加「三省六部」入口,点开右侧工作台。 +// 所有对宿主可选服务的调用都用 ctx.get(...) 特性探测,探测不到就降级,不伪造接口。 + +import { createElement as h, Fragment, useCallback, useEffect, useMemo, useRef, useState } from 'react' +import { createPortal } from 'react-dom' +import { SEAT_IDS, SEATS } from '../shared/roles.js' +import { + buildWorkbenchView, + findModelOption, + updateDraft, + clearDraft, + UNCHOSEN_MODEL_LABEL, +} from './workbench.js' +import { request } from './transport.js' +import { CSS as WORKBENCH_CSS } from './styles.js' +import { install as installNativePanel } from '../native/index.js' + +export const inject = ['sessions', 'uiWorkspace', 'uiConversation', 'slots', 'theme', 'layout'] + +const PLUGIN_ID = 'dsh-sansheng' +const TAB_KIND = 'sansheng-workbench' +const TAB_TYPE_ID = 'dsh-sansheng:workbench' + +function installStyles(doc, tag, text) { + if (!doc || !doc.head) return null + const style = doc.createElement('style') + // 带上插件 id,避免被 ClientModuleSystem 当作别人的模块样式回收。 + style.dataset.plugin = PLUGIN_ID + style.dataset.sansheng = tag + style.textContent = text + doc.head.appendChild(style) + return style +} + +// ---------- 小图标(createElement,无 JSX) ---------- +function svgWrap(children, props) { + return h('svg', { + viewBox: '0 0 24 24', width: 16, height: 16, fill: 'none', stroke: 'currentColor', + strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round', 'aria-hidden': 'true', + ...(props || {}), + }, children) +} +const TreeIcon = (props) => svgWrap([ + h('rect', { key: 'a', x: 9, y: 2, width: 6, height: 5, rx: 1 }), + h('path', { key: 'b', d: 'M12 7v5M5 16v-4h14v4' }), + h('rect', { key: 'c', x: 2, y: 16, width: 6, height: 5, rx: 1 }), + h('rect', { key: 'd', x: 16, y: 16, width: 6, height: 5, rx: 1 }), +], props) +const CloseIcon = (props) => svgWrap([h('path', { key: 'p', d: 'm6 6 12 12M6 18 18 6' })], props) +const FolderIcon = (props) => svgWrap([h('path', { key: 'p', d: 'M3 7V5a2 2 0 0 1 2-2h5l2 3h7a2 2 0 0 1 2 2v11H3Z' })], props) +const GearIcon = (props) => svgWrap([ + h('path', { key: 'a', d: 'M4 6h16M4 12h16M4 18h16' }), + h('circle', { key: 'b', cx: 9, cy: 6, r: 2 }), + h('circle', { key: 'c', cx: 16, cy: 12, r: 2 }), + h('circle', { key: 'd', cx: 8, cy: 18, r: 2 }), +], props) +const ChevronIcon = (props) => h('svg', { + viewBox: '0 0 24 24', width: 14, height: 14, fill: 'none', stroke: 'currentColor', + strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round', + className: 'ssw-chevron', 'aria-hidden': 'true', +}, h('path', { d: 'm6 9 6 6 6-6' })) + +function isFn(value) { return typeof value === 'function' } +function safeCall(obj, name) { + try { + if (!obj || !isFn(obj[name])) return undefined + return obj[name]() + } catch { return undefined } +} +function snapshotOf(obj) { + if (!obj) return undefined + if (isFn(obj.getSnapshot)) { + try { return obj.getSnapshot() } catch { return undefined } + } + return obj +} + +export function apply(ctx) { + if (typeof document !== 'undefined') installStyles(document, 'workbench', WORKBENCH_CSS) + + const get = (name) => { try { return ctx.get(name) } catch { return undefined } } + + // ---------- 当前项目 / 工作区(特性探测,拿不到就提示用户先选项目) ---------- + function workspaceItems() { + const fromWorkspaces = snapshotOf(get('workspaces')?.list)?.items + if (Array.isArray(fromWorkspaces)) return fromWorkspaces + const fromUi = snapshotOf(get('uiWorkspace')?.workspaces)?.items + if (Array.isArray(fromUi)) return fromUi + return [] + } + + function normalizeWorkspace(item) { + if (!item || typeof item !== 'object') return null + const workspaceId = item.workspaceId ?? item.id ?? null + if (typeof workspaceId !== 'string' || !workspaceId) return null + return { + workspaceId, + name: typeof item.name === 'string' ? item.name : (typeof item.title === 'string' ? item.title : undefined), + path: typeof item.path === 'string' ? item.path : undefined, + } + } + + function currentSessionId() { + const snap = snapshotOf(get('sessions')?.list) ?? snapshotOf(get('sessions')) + if (!snap || typeof snap !== 'object') return null + for (const key of ['activeId', 'currentId', 'selectedId']) { + if (typeof snap[key] === 'string' && snap[key]) return snap[key] + } + if (snap.byId && typeof snap.byId === 'object') { + const main = Object.values(snap.byId).find(session => (session?.retainedBy?.mainView ?? 0) > 0) + if (main && typeof main.id === 'string') return main.id + } + return null + } + + function currentWorkspaceId() { + const candidates = [] + for (const holder of [get('workspaces'), get('uiWorkspace')]) { + if (!holder) continue + for (const key of ['currentWorkspaceId', 'currentId', 'activeId']) { + if (isFn(holder[key])) candidates.push(safeCall(holder, key)) + else if (typeof holder[key] === 'string') candidates.push(holder[key]) + } + for (const key of ['current', 'active', 'selected', 'currentWorkspace']) { + const value = holder[key] + const snap = snapshotOf(value) + if (snap && typeof snap === 'object') candidates.push(snap.workspaceId ?? snap.id) + else if (typeof value === 'string') candidates.push(value) + } + } + const sessionId = currentSessionId() + if (sessionId) { + const owner = workspaceItems().find(item => Array.isArray(item.sessionIds) && item.sessionIds.includes(sessionId)) + if (owner) candidates.push(owner.workspaceId ?? owner.id) + } + return candidates.find(id => typeof id === 'string' && id) ?? null + } + + function currentWorkspace() { + const items = workspaceItems().map(normalizeWorkspace).filter(Boolean) + const id = currentWorkspaceId() + if (id) { + const hit = items.find(item => item.workspaceId === id) + return hit || { workspaceId: id, name: undefined, path: undefined } + } + if (items.length === 1) return items[0] + return null + } + + function seatRecordOf(view, id) { + const seats = view && view.project ? view.project.seats : null + if (Array.isArray(seats)) return seats.find(seat => seat && seat.id === id) || null + if (seats && typeof seats === 'object') return seats[id] || null + return null + } + + // ---------- 会话导航(特性探测;拿不到只发意图并 console.warn) ---------- + function navigateToSession(sessionId) { + if (!sessionId) return false + const attempts = [] + const ui = get('uiWorkspace') + if (ui) { + if (isFn(ui.openSession)) attempts.push(() => ui.openSession(sessionId)) + if (isFn(ui.open)) attempts.push(() => ui.open(sessionId)) + } + const sessions = get('sessions') + if (sessions) { + if (isFn(sessions.open)) attempts.push(() => sessions.open(sessionId)) + if (isFn(sessions.openSession)) attempts.push(() => sessions.openSession(sessionId)) + if (isFn(sessions.select)) attempts.push(() => sessions.select(sessionId)) + } + for (const name of ['navigation', 'navigator', 'router']) { + const svc = get(name) + if (!svc) continue + if (isFn(svc.openSession)) attempts.push(() => svc.openSession(sessionId)) + if (isFn(svc.navigate)) attempts.push(() => svc.navigate({ sessionId })) + if (isFn(svc.open)) attempts.push(() => svc.open(sessionId)) + } + for (const run of attempts) { + try { + const result = run() + if (result && isFn(result.then)) result.catch(() => {}) + return true + } catch { /* 换下一个候选 */ } + } + console.warn('[sansheng] 未找到可用的会话导航接口,仅发出 navigate 意图:', sessionId) + try { + if (typeof window !== 'undefined') { + window.dispatchEvent(new CustomEvent('sansheng:navigate', { detail: { sessionId } })) + } + } catch { /* 忽略 */ } + return false + } + + // ---------- 右侧标签页(真实契约:register 类型 + 正文/标题 slot;不可用时回退浮动面板) ---------- + function ensureRightTab() { + const tabs = get('sidebarRightTabs') + return !!(tabs && isFn(tabs.get) && tabs.get(TAB_KIND)) + } + function tryOpenRightTab() { + const right = get('sidebarRight') + if (!right || !isFn(right.openTab)) return false + if (!ensureRightTab()) return false + try { right.openTab(TAB_KIND); return true } catch (error) { + console.warn('[sansheng] 打开右侧标签失败,改用浮动面板:', error && error.message ? error.message : error) + return false + } + } + function SanshengTabBody() { + return h('div', { className: 'ssw-tab-body' }, h(SanshengWorkbench, {})) + } + function SanshengTabTitle() { + return h('span', { className: 'ssw-tab-title' }, '三省六部') + } + // 宿主按 definition.id 选 slot(TabSlot: entryKey=definition.id),因此 slot key 必须等于类型 id。 + function registerRightTabType() { + try { + if (!isFn(ctx.inject)) return + ctx.inject(['sidebarRightTabs'], (injected) => { + const tabs = injected.get('sidebarRightTabs') + if (!tabs || !isFn(tabs.register)) return + let disposeType = null, disposeBody = null, disposeTitle = null + try { + disposeType = tabs.register({ id: TAB_TYPE_ID, kind: TAB_KIND, keepMounted: true, priority: 'extension', title: () => '三省六部' }) + disposeBody = ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({ + name: 'sidebar.right.pane.tab', key: TAB_TYPE_ID, inject: (sessionId) => ({ sessionId }), + }, SanshengTabBody)) + disposeTitle = ctx.slots.inject('sidebar.right.pane.tab.title', () => ctx.slots.register({ + name: 'sidebar.right.pane.tab.title', key: TAB_TYPE_ID, inject: (sessionId) => ({ sessionId }), + }, SanshengTabTitle)) + } catch (error) { + console.warn('[sansheng] 注册右侧标签失败:', error && error.message ? error.message : error) + try { disposeBody && disposeBody() } catch { /* 忽略 */ } + try { disposeTitle && disposeTitle() } catch { /* 忽略 */ } + try { disposeType && disposeType() } catch { /* 忽略 */ } + return + } + return () => { + try { disposeBody && disposeBody() } catch { /* 忽略 */ } + try { disposeTitle && disposeTitle() } catch { /* 忽略 */ } + try { disposeType && disposeType() } catch { /* 忽略 */ } + } + }) + } catch (error) { + console.warn('[sansheng] 注册右侧标签失败:', error && error.message ? error.message : error) + } + } + + // ---------- 工作台组件 ---------- + function SanshengWorkbench(props) { + const onClose = props && props.onClose ? props.onClose : null + const [phase, setPhase] = useState('loading') + const [error, setError] = useState(null) + const [notice, setNotice] = useState(null) + const [view, setView] = useState(null) + const [models, setModels] = useState(null) + const [selectedSeatId, setSelectedSeatId] = useState(SEAT_IDS[0]) + const [draft, setDraft] = useState({}) + const [busy, setBusy] = useState(false) + const [configOpen, setConfigOpen] = useState(false) + const [reportOpen, setReportOpen] = useState(false) + const alive = useRef(true) + + useEffect(() => () => { alive.current = false }, []) + + const loadProject = useCallback(async () => { + setPhase('loading'); setError(null); setNotice(null) + const workspace = currentWorkspace() + if (!workspace) { setPhase('no-workspace'); return } + try { + const projectView = await request('open', { + workspaceId: workspace.workspaceId, + name: workspace.name, + path: workspace.path, + }) + let modelCatalog = null + try { modelCatalog = await request('models') } catch (modelError) { + console.warn('[sansheng] 模型目录加载失败:', modelError && modelError.message ? modelError.message : modelError) + } + if (!alive.current) return + setView(projectView) + setModels(modelCatalog) + setPhase('ready') + } catch (loadError) { + if (!alive.current) return + setError(loadError && loadError.message ? loadError.message : '加载失败') + setPhase('error') + } + }, []) + + useEffect(() => { void loadProject() }, [loadProject]) + + const wb = buildWorkbenchView(view, { selectedSeatId, models, draft }) + const seatById = useMemo(() => { + const map = {} + for (const seat of wb.seats) map[seat.id] = seat + return map + }, [wb.seats]) + + function pickSeat(id) { + if (!id) return + if (id !== selectedSeatId) { + setSelectedSeatId(id) + setConfigOpen(false) + } + const seat = seatById[id] + if (wb.ready && seat && seat.status === 'bound') { + const rec = seatRecordOf(view, id) + if (rec && rec.sessionId) { + navigateToSession(rec.sessionId) + setNotice('已切换到' + seat.name + '会话') + return + } + } + if (wb.ready && seat && seat.status !== 'bound') setNotice('该席尚未绑定会话,先启用或重试启用') + } + + function setModelValue(value) { + setDraft(prev => updateDraft(prev, selectedSeatId, { modelValue: value })) + } + function setInstructions(value) { + setDraft(prev => updateDraft(prev, selectedSeatId, { instructions: value })) + } + + async function enableSeats() { + const projectId = view && view.project ? view.project.id : null + if (!projectId) return + setBusy(true); setError(null); setNotice('正在启用十席…') + try { + const next = await request('enable', { projectId }) + if (!alive.current) return + setView(next) + setNotice('十席已启用(建立独立会话,不自动运行模型)') + } catch (enableError) { + if (alive.current) setError(enableError && enableError.message ? enableError.message : '启用失败') + } finally { + if (alive.current) setBusy(false) + } + } + + async function saveConfig() { + const projectId = view && view.project ? view.project.id : null + if (!projectId) return + const seatId = wb.selected.id + const value = wb.selected.modelValue + if (!value) { setNotice('请先为当前角色选择模型'); return } + const option = findModelOption(wb.selected.modelOptions, value) + const model = option + ? (option.reasoningEffort + ? { provider: option.provider, model: option.model, reasoningEffort: option.reasoningEffort } + : { provider: option.provider, model: option.model }) + : null + setBusy(true); setError(null); setNotice('保存中…') + try { + await request('configure', { projectId, seatId, model, instructions: wb.selected.instructions }) + const next = await request('project', { projectId }) + if (!alive.current) return + setView(next) + setDraft(prev => clearDraft(prev, seatId)) + setNotice('已保存') + } catch (saveError) { + if (alive.current) setError(saveError && saveError.message ? saveError.message : '保存失败') + } finally { + if (alive.current) setBusy(false) + } + } + + const seatCard = (seat) => h('button', { + key: seat.id, type: 'button', className: 'ssw-seat', + 'aria-pressed': seat.selected ? 'true' : 'false', + title: seat.name + ' · ' + seat.duty + '(' + seat.statusLabel + ')', + onClick: () => pickSeat(seat.id), + }, + h('span', { className: 'ssw-role-top' }, + h('span', { className: 'ssw-role-name' }, seat.name), + h('span', { className: 'ssw-dot', 'data-status': seat.status, 'aria-hidden': 'true' }), + ), + h('span', { className: 'ssw-role-duty' }, seat.duty), + ) + + const pickList = (ids) => ids.map(id => seatById[id]).filter(Boolean) + const tree = h('section', { className: 'ssw-tree', 'aria-label': '切换角色' }, + h('div', { className: 'ssw-lead' }, pickList(wb.groups.lead).map(seatCard)), + h('div', { className: 'ssw-sansheng' }, + h('span', { className: 'ssw-group-label' }, '三省'), + h('div', { className: 'ssw-trio' }, pickList(wb.groups.sansheng).map(seatCard)), + ), + h('div', { className: 'ssw-ministries' }, + h('span', { className: 'ssw-group-label' }, '六部 · 尚书统筹'), + h('div', { className: 'ssw-six' }, pickList(wb.groups.liubu).map(seatCard)), + ), + ) + + const head = h('header', { className: 'ssw-head' }, + h(TreeIcon), + h('strong', { className: 'ssw-head-title' }, '工作台'), + onClose + ? h('button', { type: 'button', className: 'ssw-icon-btn', onClick: onClose, 'aria-label': '收起工作台' }, h(CloseIcon)) + : null, + ) + + const projectInfo = h('div', { className: 'ssw-project' }, + h('div', { className: 'ssw-project-line' }, + h('span', { className: 'ssw-eyebrow' }, h(FolderIcon), '当前项目'), + h('span', { className: 'ssw-count' }, wb.project.seatCount + ' 个角色 · ' + wb.project.sessionCount + ' 个会话'), + ), + h('div', { className: 'ssw-project-title' }, wb.projectTitle || '未命名项目'), + ) + + const enableBlock = !wb.ready + ? h('div', { className: 'ssw-enable' }, + h('p', { className: 'ssw-enable-note' }, '这个项目还没有启用十席。启用会建立十个独立会话,但不会自动运行模型。'), + h('button', { + type: 'button', className: 'ssw-primary', disabled: busy, onClick: enableSeats, + }, busy ? '正在启用…' : '启用此项目的十席'), + ) + : null + + const currentCard = h('section', { className: 'ssw-current' }, + h('div', { className: 'ssw-current-top' }, + h('strong', { className: 'ssw-current-name' }, wb.selected.name), + h('span', { className: 'ssw-current-label' }, '角色职责 · ' + wb.selected.statusLabel), + ), + h('p', { className: 'ssw-current-text' }, wb.selected.responsibility), + ) + + const optionEls = wb.selected.modelOptions.map(option => h('option', { key: option.value, value: option.value }, option.label)) + if (wb.selected.modelValue && !wb.selected.modelOptions.some(option => option.value === wb.selected.modelValue)) { + optionEls.push(h('option', { key: '__current__', value: wb.selected.modelValue }, wb.selected.modelLabel)) + } + const config = h('section', { className: 'ssw-config' }, + h('button', { + type: 'button', className: 'ssw-config-toggle', 'aria-expanded': configOpen ? 'true' : 'false', + onClick: () => setConfigOpen(value => !value), + }, + h(GearIcon), + h('span', null, '配置' + wb.selected.name + (wb.selected.dirty ? ' · 未保存' : '')), + h(ChevronIcon), + ), + configOpen + ? h('div', { className: 'ssw-config-body' }, + h('label', { className: 'ssw-label' }, '会话模型'), + h('select', { + className: 'ssw-field', value: wb.selected.modelValue, disabled: busy, + onChange: event => setModelValue(event.target.value), + }, + h('option', { value: '', disabled: true }, UNCHOSEN_MODEL_LABEL), + ...optionEls, + ), + h('label', { className: 'ssw-label' }, '角色补充说明'), + h('textarea', { + className: 'ssw-field ssw-textarea', rows: 4, value: wb.selected.instructions, disabled: busy, + placeholder: '补充该角色在当前项目中的工作要求', + onChange: event => setInstructions(event.target.value), + }), + h('p', { className: 'ssw-scope-note' }, '每个角色是独立会话;模型与说明只影响当前项目当前角色,不改变宿主默认模型。'), + h('div', { className: 'ssw-save-row' }, + h('button', { type: 'button', className: 'ssw-primary', disabled: busy, onClick: saveConfig }, busy ? '保存中…' : '保存配置'), + wb.selected.dirty ? h('span', { className: 'ssw-save-status' }, '有未保存修改') : null, + ), + ) + : null, + ) + + const report = h('section', { className: 'ssw-report' }, + h('button', { + type: 'button', className: 'ssw-report-toggle', 'aria-expanded': reportOpen ? 'true' : 'false', + onClick: () => setReportOpen(value => !value), + }, reportOpen ? '收起职责汇报' : '全部汇报职责'), + reportOpen + ? h('div', { className: 'ssw-report-list' }, + SEAT_IDS.map(id => { + const rec = seatRecordOf(view, id) + const m = rec && rec.model + const modelLabel = m && m.model ? (m.model + (m.reasoningEffort ? ' · ' + m.reasoningEffort : '')) : '未选择模型' + return h('div', { key: id, className: 'ssw-report-item', 'data-seat': id }, + h('div', { className: 'ssw-report-head' }, + h('strong', null, SEATS[id].label), + h('span', null, SEATS[id].duty), + ), + h('p', { className: 'ssw-report-model' }, '模型:' + modelLabel), + h('p', { className: 'ssw-report-text' }, SEATS[id].responsibility), + ) + }), + ) + : null, + ) + + const statusEl = error + ? h('p', { className: 'ssw-error', role: 'alert' }, error) + : (notice ? h('p', { className: 'ssw-notice', role: 'status' }, notice) : null) + + let body + if (phase === 'loading') body = h('div', { className: 'ssw-loading' }, '正在加载工作台…') + else if (phase === 'no-workspace') body = h('div', { className: 'ssw-empty' }, + h('p', null, '先从左侧选择一个项目'), + h('button', { type: 'button', className: 'ssw-primary', onClick: loadProject }, '重试'), + ) + else if (phase === 'error' && !view) body = h('div', { className: 'ssw-empty' }, + h('p', { className: 'ssw-error' }, error || '加载失败'), + h('button', { type: 'button', className: 'ssw-primary', onClick: loadProject }, '重试'), + ) + else body = h(Fragment, null, projectInfo, enableBlock, tree, report, currentCard, config, statusEl) + + return h('div', { className: 'ssw-root ssw-scope' }, head, body) + } + + // ---------- 左侧入口 ---------- + function SanshengEntry(props) { + const compact = !!(props && props.compact) + const [floating, setFloating] = useState(false) + const onClick = () => { + if (tryOpenRightTab()) { setFloating(false); return } + setFloating(value => !value) + } + let panel = null + if (floating) { + const card = h('div', { className: 'ssw-float', role: 'dialog', 'aria-label': '三省六部工作台' }, + h(SanshengWorkbench, { onClose: () => setFloating(false) })) + const canPortal = typeof document !== 'undefined' && document.body && isFn(createPortal) + panel = canPortal ? createPortal(card, document.body) : card + } + return h(Fragment, null, + h('button', { + type: 'button', className: compact ? 'ssw-entry ssw-entry-compact' : 'ssw-entry', title: '三省六部', + 'aria-expanded': floating ? 'true' : 'false', onClick, + }, + h(TreeIcon), + h('span', { className: 'ssw-entry-label' }, '三省六部'), + ), + panel, + ) + } + + function SanshengSessionAction(props) { + const children = props && props.children + return h(Fragment, null, children, h(SanshengEntry, { compact: true })) + } + + // 顶部入口:包住「新会话」行(HOC 槽位),在原按钮后追加「三省六部」,不替换原按钮/项目树。 + try { + if (ctx.slots && isFn(ctx.slots.inject) && isFn(ctx.slots.register)) { + ctx.slots.inject('sidebar.session.action', () => ctx.slots.register({ + name: 'sidebar.session.action', + id: 'sansheng-entry', + }, SanshengSessionAction)) + } else { + console.warn('[sansheng] 宿主未提供 slots.inject / slots.register,无法注册侧栏入口') + } + } catch (error) { + console.warn('[sansheng] 注册侧栏入口失败:', error && error.message ? error.message : error) + } + + // 右侧工作台标签类型:需在 apply 时就注册(宿主按类型 id 选正文 slot)。 + registerRightTabType() + + // dsh-go 原生面板:浏览器(无 dshGo 服务)或桥未就绪时,install 内部安静退出。 + try { + installNativePanel(ctx) + } catch (error) { + console.warn('[sansheng] 原生面板注册失败:', error && error.message ? error.message : error) + } +} diff --git a/sansheng/src/client/styles.js b/sansheng/src/client/styles.js new file mode 100644 index 0000000..45327b5 --- /dev/null +++ b/sansheng/src/client/styles.js @@ -0,0 +1,93 @@ +// 三省六部工作台样式:白蓝主题,自带深色适配。 +// 所有选择器以 .ssw- 前缀隔离,避免污染宿主样式;变量参考 preview/index.html。 +// 不依赖任何构建工具,作为普通字符串导出,由入口注入 - - -
-
-
三
-
三省六部 · 工作台
-
${theme} · ${width}px
-
-
-${panelHtml} -
-
- - - - - -` - return html -} - -function measureHeight(chrome, htmlPath, width, theme, profileDir) { - const args = [ - '--headless=new', - '--disable-gpu', - '--disable-crash-reporter', - '--disable-breakpad', - '--no-first-run', - '--hide-scrollbars', - `--window-size=${width},200`, - '--force-device-scale-factor=1', - '--virtual-time-budget=3000', - '--dump-dom', - `--user-data-dir=${profileDir}`, - ] - if (theme === 'dark') args.push('--blink-settings=preferredColorScheme=0') - args.push(pathToFileURL(htmlPath).href) - const result = chromeRun(chrome, args, '量高') - const dom = String(result.stdout || '') - const match = /id="pv-height"[^>]*>([0-9]+)]*>([\s\S]*?)<\/script>/.exec(dom) - if (wireMatch) { - const raw = wireMatch[1] - .replace(/"/g, '"') - .replace(/&/g, '&') - .replace(/</g, '<') - .replace(/>/g, '>') - try { - wires = JSON.parse(raw) - } catch (error) { - log(`连线重算结果解析失败:${error && error.message ? error.message : error}`) - } - } - return { height, wires, dom } -} - -function screenshot(chrome, htmlPath, pngPath, width, height, theme, scale, profileDir) { - const args = [ - '--headless=new', - '--disable-gpu', - '--disable-crash-reporter', - '--disable-breakpad', - '--no-first-run', - '--hide-scrollbars', - `--window-size=${width},${height}`, - `--force-device-scale-factor=${scale}`, - '--virtual-time-budget=2000', - `--screenshot=${pngPath}`, - `--user-data-dir=${profileDir}`, - ] - if (theme === 'dark') args.push('--blink-settings=preferredColorScheme=0') - args.push(pathToFileURL(htmlPath).href) - chromeRun(chrome, args, '截图') - if (!existsSync(pngPath)) fail(`Chrome 没有写出截图:${pngPath}`) - const size = readPngSize(pngPath) - const expectedWidth = width * scale - if (size.width !== expectedWidth) { - fail(`截图宽度异常:期望 ${expectedWidth}px,实际 ${size.width}px(${pngPath})`) - } - if (size.bytes < 3000) { - fail(`截图疑似空白:${pngPath} 只有 ${size.bytes} 字节`) - } - return size -} - -async function main() { - const options = parseArgs(process.argv.slice(2)) - if (options.help) { - process.stdout.write(`${usage()}\n`) - return - } - - const theme = String(options.theme) - if (theme !== 'light' && theme !== 'dark') fail(`--theme 只能是 light 或 dark,收到:${theme}`) - const width = Number.parseInt(options.width, 10) - if (!Number.isFinite(width) || width < 200 || width > 1200) fail(`--width 需要在 200–1200 之间,收到:${options.width}`) - const scale = Number.parseInt(options.scale, 10) - if (!Number.isFinite(scale) || scale < 1 || scale > 4) fail(`--scale 需要在 1–4 之间,收到:${options.scale}`) - const name = String(options.name) - if (!/^[A-Za-z0-9._-]+$/.test(name)) fail(`--name 只允许字母、数字、点、下划线和短横线,收到:${name}`) - const view = String(options.view || 'court') - if (!['court', 'tasks', 'artifacts'].includes(view)) fail(`--view 只能是 court / tasks / artifacts,收到:${view}`) - const openText = String(options.open || '') - const scenario = options.live ? String(options.scenario || inferLiveScenario(name, view)) : '' - if (options.live && !['court', 'tasks', 'cancel', 'revise', 'missing'].includes(scenario)) { - fail(`--scenario 只能是 court / tasks / cancel / revise / missing,收到:${scenario}`) - } - const effectiveView = scenario === 'revise' || scenario === 'missing' - ? 'artifacts' - : (scenario === 'cancel' ? 'tasks' : (openText && view === 'court' ? 'artifacts' : view)) - - const bundlePath = resolve(ROOT, options.bundle) - const outDir = resolve(ROOT, options.out) - ensureDir(SCRATCH) - ensureDir(outDir) - - if (!existsSync(bundlePath)) { - fail(`bundle 不存在:${bundlePath}\n(相对路径按仓库根目录解析:${ROOT})`) - } - - const pngPath = join(outDir, `${name}-${width}-${theme}.png`) - const htmlPath = join(SCRATCH, `${name}-${width}-${theme}.html`) - const profileDir = join(SCRATCH, 'chrome-profile') - ensureDir(profileDir) - - let live = null - if (options.live) { - log('模式:--live(真实 Host 路由,内存账本,不使用固定数据)') - live = await setupLiveHost() - await registerLiveProject(live) - await prepareLiveScenario(live, scenario) - } - - log(`加载 bundle:${bundlePath}`) - const hooks = createHooks() - const loaded = loadBundle(bundlePath, hooks, { theme, fetchStub: live ? live.fetchLive : null }) - log(`bundle 导出键:${Object.keys(loaded.exports).join(', ') || '(空)'}`) - log(`捕获 CSS:${loaded.css.length} 字符`) - - const picked = pickComponent(loaded.exports) - log(`渲染入口:${picked.mode}`) - - let component = picked.component - let props = { ...picked.props } - let placeholder = false - let entryMode = picked.mode - - if (live && typeof loaded.exports.WorkbenchRail === 'function') { - // 真实 Host 模式下用 rail 本体(WorkbenchPanel 会丢掉 projectId 并走工作区推导, - // 这里已经有真实注册出来的项目号,直接喂给它)。 - component = loaded.exports.WorkbenchRail - props = { ctx: createLiveUiContext(), projectId: live.projectId, compact: true } - entryMode = 'exports.WorkbenchRail(live)' - log(`渲染入口改为 exports.WorkbenchRail(projectId=${live.projectId})`) - } else if (typeof component !== 'function') { - placeholder = true - const keyList = (picked.keys || Object.keys(loaded.exports)).join(', ') || '(空)' - log(`没有找到面板组件,退化为占位 div。bundle 导出键:${keyList}`) - component = () => hooks.React.createElement( - 'div', - { className: 'pv-placeholder' }, - hooks.React.createElement('h3', null, '预览占位'), - hooks.React.createElement('p', null, '这个 bundle 没有导出 __preview,也没有可识别的默认面板组件。'), - hooks.React.createElement('pre', null, `导出键:${keyList}`), - ) - props = {} - } else if (typeof loaded.exports.createHost === 'function') { - try { - const demo = createDemoContext() - props = { - ...props, - host: loaded.exports.createHost(demo.ctx), - sessionId: LEAD_SESSION, - compact: true, - } - log('已用 createHost(ctx) 构造旧式 host') - } catch (error) { - log(`createHost 失败,改为直接传 props:${error && error.message ? error.message : error}`) - } - } - - if (!live && props.projectId === undefined) props.projectId = 'prj_demo1' - if (!live && props.sessionId === undefined) props.sessionId = LEAD_SESSION - if (props.compact === undefined) props.compact = true - - const rootVNode = hooks.React.createElement(component, props) - const settleResult = await settle(hooks, rootVNode, 1500) - log(`渲染稳定:${settleResult.settled ? '是' : '否(达到 1.5s 预算)'},${settleResult.passes} 轮,${settleResult.elapsedMs}ms`) - - let tree = settleResult.tree - let stateSwitch = { clickedTab: null, openedArtifact: null } - let liveScenario = null - if (live) { - liveScenario = await runLiveScenario({ - hooks, - rootVNode, - view: effectiveView, - live, - projectId: live.projectId, - scenario, - }) - tree = liveScenario.tree - settleResult.passes += liveScenario.passes - for (const assertion of liveScenario.assertions) { - log(`[live] 断言「${assertion.name}」:${assertion.ok ? '通过' : '未通过'};after=${assertion.after}`) - } - log(`[live] 请求 ${liveScenario.requests.length} 次;dispatch.status=${liveScenario.dispatchStatus ?? '(无)'};prompt ${liveScenario.prompts.length} 条`) - } else if (effectiveView !== 'court' || openText) { - const switched = await switchPreviewState(hooks, rootVNode, effectiveView, openText, tree) - tree = switched.tree - stateSwitch = { clickedTab: switched.clickedTab, openedArtifact: switched.openedArtifact } - settleResult.passes += switched.passes - log(`视图切换:${stateSwitch.clickedTab || '(未切换)'}${stateSwitch.openedArtifact ? `,已打开成果「${stateSwitch.openedArtifact}」` : ''}`) - } - - const panelHtml = serializeNode(tree) - const html = buildPage({ css: loaded.css, panelHtml, width, theme }) - writeFileSync(htmlPath, html, 'utf8') - log(`HTML:${htmlPath}(${html.length} 字符,面板 DOM ${panelHtml.length} 字符)`) - - const chrome = findChrome(options.chrome) - log(`Chrome:${chrome}`) - const measured = measureHeight(chrome, htmlPath, width, theme, profileDir) - const height = measured.height - log(`页面 scrollHeight:${height}px`) - - const wires = measured.wires - if (wires && wires.applied) { - log(`连线重算:已按真实 DOM rect 重写 ${wires.after.length} 条 path`) - log(` 分叉[0] before:${wires.before[0]}`) - log(` 分叉[0] after :${wires.after[0]}`) - log(` 丞相底边 y=${wires.lead.bottom},三省顶边 y=${wires.sansheng.map((card) => card.top).join('/')},六部组顶边 y=${wires.group.top}`) - log(` 端点:分支终点 y 与卡片 top 相等;主干终点 y 与 group.top 相等(${wires.group.top})`) - } else { - log('连线重算:页面里没有 .wb-tree 或未写入 #pv-wires(旧 bundle / 占位渲染属正常)') - } - - const size = screenshot(chrome, htmlPath, pngPath, width, height, theme, scale, profileDir) - log(`截图:${pngPath}(${size.width}x${size.height},${size.bytes} 字节,scale=${scale})`) - - const sourceLines = readFileSync(fileURLToPath(import.meta.url), 'utf8').split(/\r?\n/).length - const report = { - bundle: bundlePath, - bundleBase: options.bundle, - bundleBytes: statSync(bundlePath).size, - entry: entryMode, - placeholder, - live: liveScenario - ? { - projectId: liveScenario.projectId, - requests: liveScenario.requests, - dispatches: liveScenario.dispatches, - cancellations: liveScenario.cancellations, - revisions: liveScenario.revisions, - preparedArtifact: liveScenario.preparedArtifact, - dispatchStatus: liveScenario.dispatchStatus, - prompts: liveScenario.prompts.map((entry) => ({ - sessionId: entry.sessionId, - requestId: entry.requestId, - text: entry.text.slice(0, 200), - chars: entry.text.length, - })), - assertions: liveScenario.assertions, - controllerCalls: liveScenario.controllerCalls, - } - : null, - theme, - width, - scale, - view: effectiveView, - scenario: scenario || null, - openedArtifact: stateSwitch.openedArtifact, - html: htmlPath, - png: pngPath, - pngSize: { width: size.width, height: size.height, bytes: size.bytes }, - scrollHeight: height, - passes: settleResult.passes, - settled: settleResult.settled, - elapsedMs: settleResult.elapsedMs, - cssLength: loaded.css.length, - exportKeys: Object.keys(loaded.exports), - wireRecompute: wires && wires.applied - ? { - applied: true, - box: wires.box, - branchBefore: wires.before[0], - branchAfter: wires.after[0], - trunkBefore: wires.before[3], - trunkAfter: wires.after[3], - leadBottom: wires.lead.bottom, - sanshengTops: wires.sansheng.map((card) => card.top), - groupTop: wires.group.top, - } - : null, - scriptLines: sourceLines, - } - if (liveScenario) { - const liveLogPath = join(SCRATCH, `${name}-${width}-${theme}-live.json`) - writeFileSync(liveLogPath, JSON.stringify({ - bundle: bundlePath, - projectId: liveScenario.projectId, - requests: liveScenario.requests, - dispatches: liveScenario.dispatches, - cancellations: liveScenario.cancellations, - revisions: liveScenario.revisions, - preparedArtifact: liveScenario.preparedArtifact, - dispatchStatus: liveScenario.dispatchStatus, - prompts: liveScenario.prompts, - assertions: liveScenario.assertions, - controllerCalls: liveScenario.controllerCalls, - }, null, 2), 'utf8') - log(`[live] 请求/派发/prompt 日志:${liveLogPath}`) - } - process.stdout.write(`PREVIEW_RESULT ${JSON.stringify(report)}\n`) -} - -main().catch((error) => { - if (error && error.previewFailure) { - process.stderr.write(`\n[preview-workbench] 失败:${error.message}\n`) - } else { - process.stderr.write(`\n[preview-workbench] 未预期错误:${error && error.stack ? error.stack : error}\n`) - } - process.exitCode = 1 -}) diff --git a/scripts/preview.mjs b/scripts/preview.mjs deleted file mode 100644 index 27f4264..0000000 --- a/scripts/preview.mjs +++ /dev/null @@ -1,1154 +0,0 @@ -#!/usr/bin/env node -/** - * scripts/preview.mjs — 零依赖侧栏预览生成器。 - * - * 做法: - * 1. 用 vm 加载真实的 panel/lib/client.js(复用 panel/test/client.test.js 的 - * window.__ModuleLoader__.load + 最小 React/document 替身思路),并捕获 - * bundle 注入到 - - -
- -
-
-${panelHtml} -
-
-
- - - - -`, - } -} - -// #endregion - -// #region 主流程 - -async function tick(times = 4) { - for (let i = 0; i < times; i += 1) { - await new Promise((resolveTick) => setImmediate(resolveTick)) - } -} - -async function settle(hooks, rootVNode) { - let tree = null - for (let pass = 0; pass < 40; pass += 1) { - hooks.beginRender() - tree = mountNode(rootVNode) - hooks.runEffects() - await tick() - if (!hooks.consumeDirty()) return tree - } - fail('面板在 40 次渲染后仍未稳定(可能存在状态更新死循环)。') -} - -function readPngSize(pngPath) { - const bytes = readFileSync(pngPath) - if (bytes.length < 33) fail(`截图文件不完整:${pngPath}(${bytes.length} 字节)`) - const signature = bytes.subarray(0, 8).toString('hex') - if (signature !== '89504e470d0a1a0a') fail(`截图不是合法 PNG:${pngPath}`) - return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20), bytes: bytes.length } -} - -function measureHeight(chrome, htmlPath, pageWidth, windowWidth, profileDir) { - const args = [ - '--headless=new', - '--disable-gpu', - '--hide-scrollbars', - '--no-first-run', - '--no-default-browser-check', - '--disable-extensions', - '--disable-background-networking', - '--disable-sync', - '--mute-audio', - `--user-data-dir=${profileDir}`, - '--virtual-time-budget=3000', - `--window-size=${windowWidth},600`, - '--dump-dom', - pathToFileURL(htmlPath).href, - ] - const result = chromeRun(chrome, args, '测量页面高度') - const match = String(result.stdout || '').match(/id="pv-height"[^>]*>(\d+) 20000) { - fail(`测量到的页面高度不合理:${height}`) - } - return height -} - -function screenshot(chrome, htmlPath, pngPath, pageWidth, height, scale, profileDir, windowWidth) { - const args = [ - '--headless=new', - '--disable-gpu', - '--hide-scrollbars', - `--force-device-scale-factor=${scale}`, - '--no-first-run', - '--no-default-browser-check', - '--disable-extensions', - '--disable-background-networking', - '--disable-sync', - '--mute-audio', - `--user-data-dir=${profileDir}`, - '--virtual-time-budget=3000', - `--window-size=${windowWidth},${height}`, - `--screenshot=${pngPath}`, - pathToFileURL(htmlPath).href, - ] - chromeRun(chrome, args, '截图') - if (!existsSync(pngPath)) fail(`Chrome 没有生成截图:${pngPath}`) - const size = readPngSize(pngPath) - if (size.bytes < 5000) fail(`截图文件过小,可能是空白图:${pngPath}(${size.bytes} 字节)`) - return size -} - -async function main() { - const options = parseArgs(process.argv.slice(2)) - const chrome = options.htmlOnly ? null : findChrome(options.chrome) - const hooks = createHooks() - const bundle = loadBundle(options.source, hooks) - - if (typeof bundle.exports.SanshengPanel !== 'function') { - fail('bundle 没有导出 SanshengPanel,无法渲染。') - } - - const { React } = hooks - const { ctx } = createDemoContext(options) - const host = bundle.exports.createHost(ctx) - const rootVNode = React.createElement(bundle.exports.SanshengPanel, { - host, - sessionId: LEAD_SESSION, - compact: true, - }) - - let tree = await settle(hooks, rootVNode) - - if (options.view === 'tasks') { - const tab = findNode(tree, (node) => node.props && node.props['data-side-tab'] === 'tasks') - if (!tab || typeof tab.props.onClick !== 'function') { - fail('找不到「任务」页签,无法切换到 tasks 视图。') - } - tab.props.onClick() - tree = await settle(hooks, rootVNode) - const activeTab = findNode(tree, (node) => node.props && node.props['data-side-tab'] === 'tasks') - if (!activeTab || activeTab.props['aria-selected'] !== true) { - fail('点击「任务」页签后没有切换到任务视图。') - } - } - - if (options.view === 'court' && options.seat !== 'lead') { - const card = findNode(tree, (node) => node.props && node.props['data-role'] === options.seat) - if (!card || typeof card.props.onClick !== 'function') { - fail(`找不到「${options.seat}」席位,无法切到该部门详情。`) - } - card.props.onClick() - tree = await settle(hooks, rootVNode) - const selected = findNode(tree, (node) => node.props && node.props['data-role'] === options.seat) - if (!selected || selected.props['aria-pressed'] !== 'true') { - fail(`点击「${options.seat}」席位后没有切换到该部门详情。`) - } - } - - const panelHtml = serializeNode(tree) - if (!panelHtml.trim()) fail('序列化后的面板 HTML 为空。') - if (panelHtml.length < 2000) fail(`面板 HTML 过短(${panelHtml.length} 字符),可能渲染不完整。`) - if (panelHtml.includes('sl-crash')) fail('面板渲染进了错误边界(出现 .sl-crash)。') - - const rootNode = findNode(tree, (node) => node.type === 'div') - if (!rootNode || rootNode.props['data-sansheng-sidebar'] !== '1') { - fail('渲染结果不是侧栏形态(缺少 data-sansheng-sidebar="1")。') - } - - // 先落中间 HTML:即使后面的校验/截图失败,也能直接打开排查。 - const page = buildPage({ viewport: options.viewport, - css: bundle.css, - panelHtml, - width: options.width, - theme: options.theme, - view: options.view, - }) - const htmlPath = join(os.tmpdir(), `dsh-preview-${process.pid}-${Date.now()}.html`) - writeFileSync(htmlPath, page.html, 'utf8') - const htmlTarget = options.html || (options.htmlOnly ? resolve(options.out, `${options.name}.html`) : null) - if (htmlTarget) { - mkdirSync(dirname(htmlTarget), { recursive: true }) - writeFileSync(htmlTarget, page.html, 'utf8') - } - - if (options.view === 'court') { - const seatCount = (panelHtml.match(/data-role="/g) || []).length - if (seatCount !== 10) fail(`朝堂应该渲染 10 个席位,实际 ${seatCount} 个。`) - const missing = Object.values(DEMO_LABELS).filter((label) => !panelHtml.includes(label)) - if (missing.length > 0) fail(`面板缺少席位:${missing.join('、')}`) - for (const key of ['在朝成员', '正在运行', '在办任务', '已完成']) { - if (!panelHtml.includes(key)) fail(`统计区缺少「${key}」。`) - } - if (!panelHtml.includes('GPT-6 Astra')) fail('模型下拉没有渲染出「GPT-6 Astra」。') - if (!panelHtml.includes('>高<')) fail('推理等级下拉没有渲染出「高」。') - } else { - if (!panelHtml.includes('任务队列')) fail('任务视图缺少「任务队列」标题。') - const taskRows = (panelHtml.match(/class="sl-task-copy"/g) || []).length - if (taskRows !== 4) fail(`任务视图应该渲染 4 条任务,实际 ${taskRows} 条。`) - } - - if (options.htmlOnly) { - if (!htmlTarget) fail('内部错误:--html-only 没有解析出 HTML 输出路径。') - const bytes = statSync(htmlTarget).size - if (bytes < 5000) fail(`HTML 过小,可能渲染不完整:${htmlTarget}(${bytes} 字节)`) - try { rmSync(htmlPath, { force: true }) } catch { /* 忽略清理失败 */ } - process.stdout.write( - `✓ ${htmlTarget}\n` + - ` HTML-only · ${bytes} 字节 · 侧栏 ${options.width}px · ` + - `视图 ${options.view} · 主题 ${options.theme}\n` + - ` CSS ${bundle.css.length} 字符 · 面板 ${panelHtml.length} 字符 · 源 ${bundle.sourcePath}\n`, - ) - return - } - - const outDir = options.out - mkdirSync(outDir, { recursive: true }) - const pngPath = join(outDir, `${options.name}.png`) - - const profileDir = join(os.tmpdir(), `dsh-preview-chrome-${process.pid}-${Date.now()}`) - mkdirSync(profileDir, { recursive: true }) - - let size - try { - const measured = measureHeight(chrome, htmlPath, page.pageWidth, page.windowWidth, profileDir) - const height = Math.max(200, Math.ceil(measured) + 2) - size = screenshot(chrome, htmlPath, pngPath, page.pageWidth, height, options.scale, profileDir, page.windowWidth) - - const expectedWidth = page.windowWidth * options.scale - if (size.width !== expectedWidth) { - fail( - `截图宽度 ${size.width}px 与预期 ${expectedWidth}px(${page.windowWidth}×${options.scale})不符,` + - '页面可能被 Chrome 缩放或窗口尺寸未生效。', - ) - } - } finally { - try { rmSync(profileDir, { recursive: true, force: true }) } catch { /* 忽略清理失败 */ } - try { rmSync(htmlPath, { force: true }) } catch { /* 忽略清理失败 */ } - } - - const seatNote = options.view === 'court' ? ' · 十席齐全' : ' · 任务队列' - process.stdout.write( - `✓ ${pngPath}\n` + - ` ${size.width}×${size.height}px @${options.scale}x · 侧栏 ${options.width}px · ` + - `视图 ${options.view} · 主题 ${options.theme}${seatNote}\n` + - ` CSS ${bundle.css.length} 字符 · HTML ${panelHtml.length} 字符 · 源 ${bundle.sourcePath}\n`, - ) - if (options.html) process.stdout.write(` 中间 HTML:${options.html}\n`) -} - -main().catch((error) => { - if (error && error.previewFailure) { - process.stderr.write(`\n[preview] 失败:${error.message}\n`) - } else { - process.stderr.write(`\n[preview] 未预期的错误:\n${error && error.stack ? error.stack : error}\n`) - } - process.exit(1) -}) - -// #endregion diff --git a/scripts/workbench-install.mjs b/scripts/workbench-install.mjs deleted file mode 100644 index 578d1ce..0000000 --- a/scripts/workbench-install.mjs +++ /dev/null @@ -1,144 +0,0 @@ -#!/usr/bin/env node -// 工作台前端(workbench/panel)的安装开关:只动 profile 的 package.json、 -// bundles 列表,以及 node_modules 里的一个链接。它不碰 cordis.patch.yml, -// 也不改「上朝」预设——那是 scripts/mode.mjs 的事。 -// -// node scripts/workbench-install.mjs status # 现在装没装 -// node scripts/workbench-install.mjs on # 装上(需要彻底重启 DSH 才生效) -// node scripts/workbench-install.mjs off # 卸掉 -// -// 幂等:重复执行结果一致;不需要备份(版本历史由 Git 管)。 - -import { readFile, writeFile, mkdir, lstat, readlink, rm, symlink } from 'node:fs/promises' -import { existsSync } from 'node:fs' -import { homedir } from 'node:os' -import { dirname, join, resolve } from 'node:path' - -const NAME = 'dsh-sansheng-liubu-workbench' -const REPO = resolve(import.meta.dirname, '..') -const TARGET = join(REPO, 'workbench', 'panel') -const profileDir = resolve(process.env.DSH_PROFILE_DIR ?? join(homedir(), '.dsh', 'profiles', 'desktop')) -const profilePath = join(profileDir, 'package.json') -const linkPath = join(profileDir, 'node_modules', NAME) - -/** Windows 上 `link:` 依赖写成正斜杠;反斜杠在 profile 里会被当成转义。 */ -const posix = (value) => value.replace(/\\/g, '/') - -async function readProfile() { - return JSON.parse(await readFile(profilePath, 'utf8')) -} - -async function writeProfile(profile) { - await writeFile(profilePath, `${JSON.stringify(profile, null, 2)}\n`, 'utf8') -} - -async function linkState() { - try { - const stat = await lstat(linkPath) - if (!stat.isSymbolicLink()) return { linked: false, note: '不是链接(可能有同名真实目录)' } - const actual = await readlink(linkPath) - const resolved = resolve(profileDir, 'node_modules', actual) - const ok = resolved.toLowerCase() === resolve(TARGET).toLowerCase() - return { linked: ok, target: actual, note: ok ? undefined : `链接指向 ${actual}` } - } catch (error) { - if (error.code === 'ENOENT') return { linked: false, note: '链接不存在' } - throw error - } -} - -async function status() { - const profile = await readProfile() - const link = await linkState() - const bundles = profile.dsh?.profile?.bundles ?? [] - return { - profile: profilePath, - target: TARGET, - targetExists: existsSync(join(TARGET, 'lib', 'client.js')), - dependency: profile.dependencies?.[NAME] ?? null, - inBundles: bundles.includes(NAME), - link, - installed: profile.dependencies?.[NAME] === `link:${posix(TARGET)}` && bundles.includes(NAME) && link.linked, - } -} - -async function ensureLink() { - await mkdir(dirname(linkPath), { recursive: true }) - const state = await linkState() - if (state.linked) return { changed: false } - if (existsSync(linkPath) || state.note === '不是链接(可能有同名真实目录)') await rm(linkPath, { recursive: true, force: true }) - // Windows 上用 junction:不需要管理员权限,跳转由文件系统处理。 - await symlink(TARGET, linkPath, process.platform === 'win32' ? 'junction' : 'dir') - return { changed: true } -} - -async function enable() { - if (!existsSync(join(TARGET, 'lib', 'client.js'))) { - throw new Error(`找不到 ${join(TARGET, 'lib', 'client.js')}:工作台前端还没构建出来,先别装。`) - } - const profile = await readProfile() - let changed = false - profile.dependencies ??= {} - const wanted = `link:${posix(TARGET)}` - if (profile.dependencies[NAME] !== wanted) { - profile.dependencies[NAME] = wanted - changed = true - } - profile.dsh ??= {} - profile.dsh.profile ??= {} - profile.dsh.profile.bundles ??= [] - if (!profile.dsh.profile.bundles.includes(NAME)) { - profile.dsh.profile.bundles.push(NAME) - changed = true - } - if (changed) await writeProfile(profile) - const link = await ensureLink() - return { - ...(await status()), - changed: changed || link.changed, - hint: changed || link.changed - ? '已装上。彻底退出并重启 DSH 后生效(客户端 bundle 在启动时加载,热更新不覆盖)。' - : '本来就已经装好,未改动。', - } -} - -async function disable() { - const profile = await readProfile() - let changed = false - if (profile.dependencies && NAME in profile.dependencies) { - delete profile.dependencies[NAME] - changed = true - } - const bundles = profile.dsh?.profile?.bundles - if (Array.isArray(bundles) && bundles.includes(NAME)) { - profile.dsh.profile.bundles = bundles.filter((name) => name !== NAME) - changed = true - } - if (changed) await writeProfile(profile) - let unlinked = false - try { - await rm(linkPath, { recursive: true, force: true }) - unlinked = true - } catch { - /* 链接本来就不在 */ - } - return { - ...(await status()), - changed: changed || unlinked, - hint: changed || unlinked ? '已卸掉。彻底重启 DSH 后生效。' : '本来就没装,未改动。', - } -} - -const action = (process.argv[2] ?? 'status').toLowerCase() -const handlers = { status, on: enable, off: disable } -const handler = handlers[action] -if (!handler) { - console.error(`未知动作:${action}(可用:status / on / off)`) - process.exit(2) -} - -try { - console.log(JSON.stringify(await handler(), null, 2)) -} catch (error) { - console.error(String(error?.message ?? error)) - process.exit(1) -} diff --git a/scripts/workbench-preflight.mjs b/scripts/workbench-preflight.mjs deleted file mode 100644 index 574af2f..0000000 --- a/scripts/workbench-preflight.mjs +++ /dev/null @@ -1,128 +0,0 @@ -// 重启前自检:只读,不改任何东西。 -// -// 目的:把「重启 DSH 之后才发现客户端 bundle 根本没加载」这类问题提前挡掉。 -// 检查四件事—— -// 1. profile 里到底有没有把本插件链进去(dependencies + dsh.profile.bundles) -// 2. 链接指向的目录里,exports 声明的那个文件在不在 -// 3. 那个文件是不是一段能解析的 JS(语法坏了会让整页白屏,且报错很难看懂) -// 4. Host 侧装配能不能在内存账本上跑起来(13 条路由 + bootstrap 可用) -// -// 用法:node scripts/workbench-preflight.mjs -// 退出码:0 全通;1 有失败项(打印哪一项失败、为什么)。 - -import fs from 'node:fs' -import os from 'node:os' -import path from 'node:path' -import vm from 'node:vm' - -import { createWorkbenchHost } from '../workbench/host/index.mjs' -import { WorkbenchStore } from '../workbench/core/store.mjs' - -const PLUGIN_ID = 'dsh-sansheng-liubu-workbench' -const results = [] - -function check(name, run) { - try { - const detail = run() - results.push({ name, ok: true, detail }) - } catch (error) { - results.push({ name, ok: false, detail: error?.message ?? String(error) }) - } -} - -function dshHome(env = process.env) { - const value = typeof env.DSH_HOME === 'string' && env.DSH_HOME.trim() ? env.DSH_HOME.trim() : '' - return value === '' ? path.join(os.homedir(), '.dsh') : value -} - -const profileDir = path.join(dshHome(), 'profiles', 'desktop') -const profilePackage = path.join(profileDir, 'package.json') - -let profile = null -check('读取 profile/package.json', () => { - profile = JSON.parse(fs.readFileSync(profilePackage, 'utf8')) - return profilePackage -}) - -check('profile 的 dependencies 里链了本插件', () => { - const spec = profile?.dependencies?.[PLUGIN_ID] - if (typeof spec !== 'string' || spec === '') throw new Error(`dependencies 里没有 ${PLUGIN_ID}`) - return spec -}) - -check('profile 的 bundles 里登记了本插件', () => { - const bundles = profile?.dsh?.profile?.bundles - if (!Array.isArray(bundles) || !bundles.includes(PLUGIN_ID)) { - throw new Error(`dsh.profile.bundles 里没有 ${PLUGIN_ID}(现有:${Array.isArray(bundles) ? bundles.join(', ') : '无'})`) - } - return `${bundles.length} 个 bundle` -}) - -const linkedDir = path.join(profileDir, 'node_modules', PLUGIN_ID) - -let entryFile = null -check('链接目录与入口文件存在', () => { - const stat = fs.statSync(linkedDir) - if (!stat.isDirectory()) throw new Error(`${linkedDir} 不是目录`) - const pkg = JSON.parse(fs.readFileSync(path.join(linkedDir, 'package.json'), 'utf8')) - const exported = pkg?.exports?.['./client'] - const rel = typeof exported === 'string' ? exported : exported?.import ?? exported?.default - if (typeof rel !== 'string') throw new Error('package.json 没有 exports["./client"]') - entryFile = path.join(linkedDir, rel) - const size = fs.statSync(entryFile).size - if (size < 1024) throw new Error(`入口文件过小(${size} 字节),可能是空壳`) - return `${path.basename(entryFile)} · ${size} 字节` -}) - -check('客户端 bundle 语法可解析(语法错会让整页白屏)', () => { - if (entryFile === null) throw new Error('上一个检查没通过,跳过') - const text = fs.readFileSync(entryFile, 'utf8') - if (!text.includes('__ModuleLoader__')) throw new Error('入口不像 DSH 客户端 bundle(缺少 __ModuleLoader__)') - if (!text.includes(PLUGIN_ID)) throw new Error(`入口里没有插件 id ${PLUGIN_ID}`) - // 只解析不执行:能抓住未闭合括号、非法 token 这类致命错误。 - new vm.Script(text, { filename: entryFile }) - return `${Math.round(text.length / 1024)} KB` -}) - -check('Host 侧装配:内存账本上能起 13 条路由', () => { - const routes = new Map() - const fakeCtx = { - get: () => undefined, - webServer: { - register(route) { - routes.set(route.path, route) - return () => routes.delete(route.path) - }, - }, - } - const store = new WorkbenchStore({ file: null }) - const host = createWorkbenchHost(fakeCtx, { store, startReconciler: false, load: false }) - try { - if (routes.size !== 13) throw new Error(`注册了 ${routes.size} 条路由,预期 13 条`) - // bootstrap 要落在具体项目上才有席位;这里现建一个临时项目,不写磁盘。 - const project = host.service.registerProject({ hostWorkspaceId: 'preflight' }).project - const boot = host.service.bootstrap(project.id) - if (!Array.isArray(boot.seats) || boot.seats.length !== 10) throw new Error('bootstrap 没有给出十席') - return `${routes.size} 条路由 · 十席就位` - } finally { - host.dispose() - } -}) - -check('账本落点可写(重启后第一次写账不会失败)', () => { - const dir = path.join(dshHome(), 'sansheng-liubu') - fs.mkdirSync(dir, { recursive: true }) - const probe = path.join(dir, '.preflight') - fs.writeFileSync(probe, String(Date.now())) - fs.rmSync(probe, { force: true }) - return dir -}) - -let failed = 0 -for (const row of results) { - const mark = row.ok ? 'PASS' : 'FAIL' - if (!row.ok) failed += 1 - process.stdout.write(`[${mark}] ${row.name}${row.detail ? ` — ${row.detail}` : ''}\n`) -} -process.stdout.write(`\n${results.length - failed}/${results.length} 通过\n`) -if (failed > 0) process.exitCode = 1 diff --git a/test/policy.test.js b/test/policy.test.js deleted file mode 100644 index 632410e..0000000 --- a/test/policy.test.js +++ /dev/null @@ -1,164 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { - COURT_ROLES, - DEFAULT_ROUTES, - EXECUTION_TOOLSET, - inject, - roleFromMembership, - routeForRole, - toolsetForRole, - evaluateToolPolicy, - apply, -} from '../index.js' - -const approvedTask = ownerName => ({ id: 'exec-1', status: 'in_progress', ownerName, blockedBy: [] }) - -function mockRuntime(role = 'lead') { - const sections = new Map() - const tools = new Map() - const agent = { - ctx: { - effect: callback => callback(), - systemPrompt: { - getSectionOrder: () => 0, - section: section => { - if (sections.has(section.name)) throw new Error(`duplicate prompt ${section.name}`) - sections.set(section.name, section) - return () => sections.delete(section.name) - }, - }, - on: () => () => {}, - tools: { - register: definition => { tools.set(definition.name, definition); return () => tools.delete(definition.name) }, - guard: callback => { agent.guard = callback; return () => { delete agent.guard } }, - }, - }, - } - const ctx = { - agents: { list: () => [agent] }, - agentPresets: { composedPreset: () => 'sansheng-liubu' }, - agentTeams: { - tryMembership: () => role === 'unassigned' ? undefined : role === 'lead' ? { role: 'lead', name: 'lead' } : { role: 'teammate', name: role }, - listTasks: () => [], - }, - logger: { info: () => {}, warn: () => {} }, - on: () => () => {}, - } - return { ctx, agent, sections, tools } -} - -test('maps roles and preserves model routes', () => { - assert.equal(roleFromMembership(undefined), 'lead') - assert.equal(roleFromMembership({ role: 'lead', name: 'lead' }), 'lead') - assert.equal(roleFromMembership({ role: 'teammate', name: 'menxia' }), 'menxia') - assert.equal(routeForRole('lead', DEFAULT_ROUTES), undefined, '默认不强制模型,避免宿主缺少适配器') - assert.deepEqual(routeForRole('lead', { lead: { provider: 'p', model: 'm', reasoningEffort: 'high' } }), { provider: 'p', model: 'm', reasoningEffort: 'high' }) - assert.equal(routeForRole('gongbu', { minister: { provider: 'p', model: 'm' } }).model, 'm', '未列出的角色回退到 minister 路由') - assert.equal(inject.includes('sanshengLiubuGeneration'), false) - assert.equal(inject.includes('credentials'), false) -}) - -test('maps the normal unassigned primary agent to Chancellor automatically', () => { - const runtime = mockRuntime('unassigned') - const dispose = apply(runtime.ctx) - assert.match(runtime.sections.get('sansheng-liubu:role').text, /三省六部模式:丞相/) - dispose() -}) - -test('keeps execution file tools and planning roles read-only', () => { - for (const role of ['gongbu', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu']) { - assert.deepEqual(toolsetForRole(role), EXECUTION_TOOLSET) - } - for (const role of ['gongbu', 'lipu', 'bingbu', 'xingbu']) { - assert.equal(evaluateToolPolicy(role, 'bash', [approvedTask(role)]), undefined) - } - assert.match(evaluateToolPolicy('menxia', 'write', []), /只读/) -}) - -test('keeps clerk and revenue ministries off the command line', () => { - for (const role of ['libu', 'hubu']) { - assert.equal(evaluateToolPolicy(role, 'write', [approvedTask(role)]), undefined) - assert.match(evaluateToolPolicy(role, 'bash', [approvedTask(role)]), /不属于/) - } - assert.match(evaluateToolPolicy('libu', 'pwsh', [approvedTask('libu')]), /不属于/) -}) - -test('keeps the court at ten seats', () => { - assert.equal(COURT_ROLES.length, 10) - assert.deepEqual([...COURT_ROLES].sort(), ['bingbu', 'gongbu', 'hubu', 'lead', 'libu', 'lipu', 'menxia', 'shangshu', 'xingbu', 'zhongshu']) - for (const role of COURT_ROLES.filter((entry) => entry !== 'lead')) { - assert.equal(roleFromMembership({ role: 'teammate', name: role }), role, `${role} 是可识别的朝堂角色`) - } - assert.equal(roleFromMembership({ role: 'lead', name: 'lead' }), 'lead', '丞相由主会话担任') -}) - -test('allows Image-gen generation, batch, and edit only for approved Gongbu work', () => { - for (const tool of ['generate_image', 'generate_images', 'edit_image']) { - assert.match(evaluateToolPolicy('gongbu', tool, []), /尚未准奏/) - assert.equal(evaluateToolPolicy('gongbu', tool, [approvedTask('gongbu')]), undefined) - assert.match(evaluateToolPolicy('libu', tool, [approvedTask('libu')]), /不属于/) - assert.match(evaluateToolPolicy('lead', tool, []), /只读/) - } -}) - -test('blocks non-Image-gen image tools', () => { - for (const tool of ['image_generate', 'codex_image_generate']) { - assert.match(evaluateToolPolicy('gongbu', tool, [approvedTask('gongbu')]), /只允许使用 Image-gen/) - } -}) - -test('does not register duplicate image tools', () => { - const runtime = mockRuntime('gongbu') - const dispose = apply(runtime.ctx) - assert.equal(runtime.tools.size, 0) - assert.deepEqual([...runtime.sections.keys()], ['sansheng-liubu:role']) - const prompt = runtime.sections.get('sansheng-liubu:role').text - assert.ok(prompt.includes('工部职责') || prompt.includes('你负责代码实现'), '工部提示词已注册且不重复') - dispose() -}) - -test('role prompt registration remains idempotent', () => { - const runtime = mockRuntime('gongbu') - const disposeFirst = apply(runtime.ctx) - const disposeSecond = apply(runtime.ctx) - assert.deepEqual([...runtime.sections.keys()], ['sansheng-liubu:role']) - assert.equal(runtime.tools.size, 0) - disposeFirst() - assert.ok(runtime.sections.has('sansheng-liubu:role')) - disposeSecond() - assert.equal(runtime.sections.size, 0) -}) - -test('keeps management tool audit and approval rules', () => { - const audit = [] - assert.equal(evaluateToolPolicy('lead', 'task_board_create', [], { audit: item => audit.push(item) }), undefined) - assert.equal(audit[0].authority, 'chancellor') - assert.match(evaluateToolPolicy('bingbu', 'automation_create', [approvedTask('bingbu')]), /门下省准奏记录/) -}) - -test('parses the department model command the panel sends', async () => { - const { parseDeptModelCommand, describeDeptRoutes, readStoredRoutes, writeStoredRoutes } = await import('../index.js') - assert.deepEqual(parseDeptModelCommand('gongbu deepseek deepseek-chat high'), { - action: 'set', - role: 'gongbu', - route: { provider: 'deepseek', model: 'deepseek-chat', reasoningEffort: 'high' }, - }) - assert.equal(parseDeptModelCommand('gongbu deepseek deepseek-chat').route.reasoningEffort, undefined) - assert.equal(parseDeptModelCommand('').action, 'list') - assert.equal(parseDeptModelCommand('list').action, 'list') - assert.deepEqual(parseDeptModelCommand('clear gongbu'), { action: 'clear', role: 'gongbu' }) - assert.match(parseDeptModelCommand('hufu a b').reason, /未知部门/) - assert.match(parseDeptModelCommand('gongbu deepseek').reason, /用法/) - assert.match(describeDeptRoutes({ gongbu: { provider: 'p', model: 'm', reasoningEffort: 'high' } }), /gongbu=p\/m·high/) - - const { mkdtempSync, rmSync } = await import('node:fs') - const { tmpdir } = await import('node:os') - const { join } = await import('node:path') - const dir = mkdtempSync(join(tmpdir(), 'sansheng-routes-')) - const file = join(dir, 'nested', 'routes.json') - assert.equal(writeStoredRoutes(file, { bingbu: { provider: 'p', model: 'm' } }), true) - assert.deepEqual(readStoredRoutes(file).bingbu, { provider: 'p', model: 'm' }) - assert.deepEqual(readStoredRoutes(join(dir, 'missing.json')), {}, '读不到就当没有固定过') - rmSync(dir, { recursive: true, force: true }) -}) diff --git a/workbench/core/ids.mjs b/workbench/core/ids.mjs deleted file mode 100644 index 3c4817e..0000000 --- a/workbench/core/ids.mjs +++ /dev/null @@ -1,81 +0,0 @@ -// 稳定随机 ID:所有业务主键都由这里生成,名称/路径只作属性,不复用为键。 -// 随机源可注入,测试里给定字符表就能复现同一串 ID,避免断言依赖运气。 - -const ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyz' - -/** 方案里出现的所有前缀;拼错前缀属于开发期错误,直接抛而不是静默接受。 */ -export const ID_PREFIXES = Object.freeze({ - project: 'proj', - binding: 'bind', - config: 'cfg', - task: 'task', - dispatch: 'dsp', - attempt: 'att', - contextPacket: 'ctx', - result: 'res', - artifact: 'art', - event: 'evt', - authorization: 'auth', -}) - -export const ID_ENTITIES = Object.freeze(Object.keys(ID_PREFIXES)) - -/** 默认随机源:crypto.getRandomValues,取 0..35 的字符。 */ -export function cryptoRandom() { - const crypto = globalThis.crypto - if (!crypto || typeof crypto.getRandomValues !== 'function') { - throw new Error('缺少可用的随机源,请注入 random 参数') - } - const bytes = crypto.getRandomValues(new Uint8Array(8)) - // 除 36 取余有轻微偏差,但只用于 ID 唯一性,不用于安全令牌。 - return ALPHABET[bytes[0] % ALPHABET.length] -} - -/** - * 注入的随机源可以返回数字(映射到字母表)或单个字符(必须来自字母表)。 - * 两种都接受是为了测试能写 `() => 0` 这样最直白的桩。 - */ -function pick(random, index) { - const value = random(index) - if (typeof value === 'number') { - if (!Number.isInteger(value)) throw new Error('随机源必须返回整数或字母表内字符') - // 随机源常被测试当作递增计数器使用,数值可能超过字母表长度甚至为负; - // 先取绝对整数再取模,保证任意整数都能映射到合法字符。 - return ALPHABET[Math.abs(value) % 36] - } - const char = String(value) - if (char.length !== 1 || !ALPHABET.includes(char)) throw new Error(`随机源返回了字母表外字符: ${char}`) - return char -} - -/** - * 生成 `_<随机串>`。 - * 前缀既可用实体名('task')也可用前缀本身('task'),两者一致时可省心。 - */ -export function newId(prefix, options = {}) { - const { random = cryptoRandom, length = 12 } = options - const known = ID_PREFIXES[prefix] - const resolved = known ?? (Object.values(ID_PREFIXES).includes(prefix) ? prefix : undefined) - if (resolved === undefined) throw new Error(`未知 ID 前缀: ${prefix}`) - if (!Number.isInteger(length) || length < 4 || length > 64) throw new Error('ID 随机串长度须为 4..64') - let out = '' - for (let index = 0; index < length; index += 1) out += pick(random, index) - return `${resolved}_${out}` -} - -/** 每个实体一个绑定好随机源的生成器,便于在服务层统一注入并保持测试确定性。 */ -export function createIdFactory(options = {}) { - const { random = cryptoRandom, length = 12 } = options - const factory = {} - for (const entity of ID_ENTITIES) { - factory[entity] = () => newId(ID_PREFIXES[entity], { random, length }) - } - return Object.freeze(factory) -} - -/** 校验外部传入的 ID 形状(防伪 ID 进账;存在性仍由 store 查表)。 */ -export function isIdOf(entity, value) { - const prefix = ID_PREFIXES[entity] - if (typeof value !== 'string' || typeof prefix !== 'string') return false - return value.startsWith(`${prefix}_`) && value.length > prefix.length + 1 -} diff --git a/workbench/core/roles.mjs b/workbench/core/roles.mjs deleted file mode 100644 index 0a59a8c..0000000 --- a/workbench/core/roles.mjs +++ /dev/null @@ -1,192 +0,0 @@ -// 十席角色常量:新工作台的身份只来自可信的 (projectId, roleId) 绑定, -// 不再用 Team membership 推断,也不再让模型自报角色。 -// 布局按「丞相居中在顶 → 三省一列一个 → 六部两排(吏户礼 / 兵刑工)」给出, -// UI 直接按 order 渲染稳定三列,连线的上下级由结构表达,不靠坐标猜测。 - -/** - * column:布局列(lead 跨三列居中)。 - * row:视觉行号(0 丞相、1 三省、2/3 六部一排/二排)。 - * tier:leaders = 丞相与三省,ministries = 六部;分组只用于展示,不是 session 父子关系。 - */ -const SEATS = [ - { - id: 'lead', - name: '丞相', - short: '丞', - tier: 'leaders', - group: 'lead', - column: 'span', - row: 0, - duty: '接需求、分流、协调、汇报', - responsibility: '面向用户承接想法:判断是否需要开工、必要时派给具体部门,并把各部门结果汇总成对用户的一次交付。', - canDispatch: true, - }, - { - id: 'zhongshu', - name: '中书', - short: '中', - tier: 'leaders', - group: 'sansheng', - column: 'left', - row: 1, - duty: '调查、澄清、规划', - responsibility: '先把问题问清、把材料看全,再给出可执行的方案与验收标准草案,不直接产出最终交付物。', - canDispatch: false, - }, - { - id: 'shangshu', - name: '尚书', - short: '尚', - tier: 'leaders', - group: 'sansheng', - column: 'center', - row: 1, - duty: '分工建议、组织交付', - responsibility: '把已经明确的方案拆成部门分工并组织交付;六部直属于尚书这一同级分组,六部之间不是上下级。', - canDispatch: true, - }, - { - id: 'menxia', - name: '门下', - short: '门', - tier: 'leaders', - group: 'sansheng', - column: 'right', - row: 1, - duty: '审议与整体审核', - responsibility: '对方案和交付做独立审议,指出风险与不达标处。首版没有门下审核的任务必须如实标注“未审核”。', - canDispatch: false, - }, - { - id: 'libu', - name: '吏部', - short: '吏', - tier: 'ministries', - group: 'ministries', - column: 'left', - row: 2, - duty: '角色和技能配置建议', - responsibility: '对角色、技能与编制给出建议;职责不含绕过用户授权去改权限或其他项目设置。', - canDispatch: false, - }, - { - id: 'hubu', - name: '户部', - short: '户', - tier: 'ministries', - group: 'ministries', - column: 'center', - row: 2, - duty: '数据、表格、计算', - responsibility: '处理数据、表格与计算,结论应可复算。', - canDispatch: false, - }, - { - id: 'lipu', - name: '礼部', - short: '礼', - tier: 'ministries', - group: 'ministries', - column: 'right', - row: 2, - duty: '文档、内容、呈现', - responsibility: '负责文档、内容与呈现形式,产出可编辑的源文件。', - canDispatch: false, - }, - { - id: 'bingbu', - name: '兵部', - short: '兵', - tier: 'ministries', - group: 'ministries', - column: 'left', - row: 3, - duty: '环境、调试、部署', - responsibility: '负责环境、调试与部署;部署/发布等外部副作用仍服从用户授权与宿主审批。', - canDispatch: false, - }, - { - id: 'xingbu', - name: '刑部', - short: '刑', - tier: 'ministries', - group: 'ministries', - column: 'center', - row: 3, - duty: '测试与风险检查', - responsibility: '做测试与风险检查,给出可追溯的检查结果,而不是一句“已通过”。', - canDispatch: false, - }, - { - id: 'gongbu', - name: '工部', - short: '工', - tier: 'ministries', - group: 'ministries', - column: 'right', - row: 3, - duty: '代码实现与工程产出', - responsibility: '负责代码实现与工程产出,交付可编辑源文件与真实检查结果。', - canDispatch: false, - }, -] - -export const ROLE_IDS = Object.freeze(SEATS.map((seat) => seat.id)) - -const byId = new Map(SEATS.map((seat) => [seat.id, Object.freeze(seat)])) - -/** 稳定顺序(上表即布局顺序),UI 与初始化都按这个序写,避免每次渲染顺序抖动。 */ -export const ROLES = Object.freeze(ROLE_IDS.map((id) => byId.get(id))) - -/** 布局顺序 = 数组顺序;单独导出常量是为了让调用方不必依赖“数组被排序过”这个隐含约定。 */ -export const LAYOUT_ORDER = ROLE_IDS - -export const LEADERS = Object.freeze(ROLES.filter((seat) => seat.tier === 'leaders').map((seat) => seat.id)) -export const MINISTRIES = Object.freeze(ROLES.filter((seat) => seat.tier === 'ministries').map((seat) => seat.id)) - -export function isRoleId(value) { - return typeof value === 'string' && byId.has(value) -} - -/** 未知角色返回 undefined,由调用方决定报错文案(不同入口提示不同)。 */ -export function getRole(roleId) { - return byId.get(roleId) -} - -/** 找不到就抛:角色是内部常量,拼错属于代码错误而非用户输入错误。 */ -export function requireRole(roleId) { - const seat = byId.get(roleId) - if (seat === undefined) throw new Error(`未知角色: ${String(roleId)}`) - return seat -} - -export const ROLE_NAMES = Object.freeze(Object.fromEntries(ROLES.map((seat) => [seat.id, seat.name]))) - -/** 存储与显示的兼容映射:旧代码用“中书省/尚书省/门下省”,roleId 不变,名称不参与身份。 */ -export const ROLE_NAME_ALIASES = Object.freeze({ - zhongshu: Object.freeze(['中书省']), - shangshu: Object.freeze(['尚书省']), - menxia: Object.freeze(['门下省']), -}) - -/** 按布局把十席分成分组,供右侧部门树一次画完:top / sansheng / ministries 两排。 */ -export function layoutGroups() { - return { - lead: ROLES.filter((seat) => seat.id === 'lead').map((seat) => seat.id), - sansheng: ROLES.filter((seat) => seat.group === 'sansheng').map((seat) => seat.id), - ministries: [ - ROLES.filter((seat) => seat.tier === 'ministries' && seat.row === 2).map((seat) => seat.id), - ROLES.filter((seat) => seat.tier === 'ministries' && seat.row === 3).map((seat) => seat.id), - ], - } -} - -/** 首版允许主动派工的席:丞相默认,尚书在用户明确要求时经同一权限校验。 */ -export function canDispatch(roleId) { - return byId.get(roleId)?.canDispatch === true -} - -/** 初始化项目时用的角色清单(不创建会话,只建配置与绑定初值)。 */ -export function initialSeats() { - return ROLES.map((seat) => ({ roleId: seat.id, name: seat.name, tier: seat.tier })) -} diff --git a/workbench/core/states.mjs b/workbench/core/states.mjs deleted file mode 100644 index 69ca1c1..0000000 --- a/workbench/core/states.mjs +++ /dev/null @@ -1,138 +0,0 @@ -// 四套状态机分开维护:部门运行、任务结论、投递进度、单次尝试。 -// 合并成一个大状态会让“空闲”被当成“已完成”,正是方案 7.3/8.1 明确禁止的误判。 - -export const TASK_STATES = Object.freeze([ - 'draft', - 'queued', - 'running', - 'waiting_input', - 'needs_attention', - 'completed', - 'failed', - 'cancelled', -]) - -export const DISPATCH_STATES = Object.freeze(['prepared', 'sending', 'accepted', 'unknown', 'rejected']) - -export const ATTEMPT_STATES = Object.freeze([ - 'queued', - 'running', - 'succeeded', - 'failed', - 'cancel_requested', - 'cancelled', - 'unknown', -]) - -export const DEPARTMENT_STATES = Object.freeze(['uninitialized', 'idle', 'queued', 'running', 'unavailable']) - -/** - * Task:draft 校验通过且授权有效才入队;waiting_input 只能回到原任务的执行路径, - * completed 是唯一“可交付”终态;needs_attention 仍可补报后完成,也可显式失败/取消。 - * 终态(completed / failed / cancelled)不回到任何活动状态:重试一律新 attempt 或新任务。 - */ -const TASK_TRANSITIONS = Object.freeze({ - draft: Object.freeze(['queued', 'cancelled']), - queued: Object.freeze(['running', 'waiting_input', 'needs_attention', 'failed', 'cancelled']), - running: Object.freeze(['waiting_input', 'needs_attention', 'completed', 'failed', 'cancelled']), - waiting_input: Object.freeze(['queued', 'running', 'cancelled']), - needs_attention: Object.freeze(['running', 'completed', 'failed', 'cancelled']), - completed: Object.freeze([]), - failed: Object.freeze([]), - cancelled: Object.freeze([]), -}) - -/** Dispatch:发出不等于接收;超时可能 unknown,必须先对账,不能自动当失败重试。 */ -const DISPATCH_TRANSITIONS = Object.freeze({ - prepared: Object.freeze(['sending', 'rejected', 'unknown']), - sending: Object.freeze(['accepted', 'unknown', 'rejected']), - accepted: Object.freeze([]), - unknown: Object.freeze(['accepted', 'rejected']), - rejected: Object.freeze([]), -}) - -/** Attempt:cancel_requested 不等于已取消;unknown 必须先核对宿主运行再定终态。 */ -const ATTEMPT_TRANSITIONS = Object.freeze({ - queued: Object.freeze(['running', 'cancelled', 'failed', 'unknown']), - running: Object.freeze(['succeeded', 'failed', 'cancel_requested', 'unknown']), - cancel_requested: Object.freeze(['cancelled', 'succeeded', 'unknown']), - succeeded: Object.freeze([]), - failed: Object.freeze([]), - cancelled: Object.freeze([]), - unknown: Object.freeze(['succeeded', 'failed', 'cancelled', 'running']), -}) - -/** Department 只表达会话运行情况:unavailable 是绑定失效,仍保留旧引用。 */ -const DEPARTMENT_TRANSITIONS = Object.freeze({ - uninitialized: Object.freeze(['idle', 'queued', 'unavailable']), - idle: Object.freeze(['queued', 'running', 'unavailable']), - queued: Object.freeze(['running', 'idle', 'unavailable']), - running: Object.freeze(['idle', 'queued', 'unavailable']), - unavailable: Object.freeze(['uninitialized', 'idle']), -}) - -const MACHINES = Object.freeze({ - task: Object.freeze({ key: 'task', name: 'Task', states: TASK_STATES, transitions: TASK_TRANSITIONS }), - dispatch: Object.freeze({ key: 'dispatch', name: 'Dispatch', states: DISPATCH_STATES, transitions: DISPATCH_TRANSITIONS }), - attempt: Object.freeze({ key: 'attempt', name: 'Attempt', states: ATTEMPT_STATES, transitions: ATTEMPT_TRANSITIONS }), - department: Object.freeze({ key: 'department', name: 'Department', states: DEPARTMENT_STATES, transitions: DEPARTMENT_TRANSITIONS }), -}) - -export const STATE_MACHINES = Object.freeze( - Object.fromEntries(Object.entries(MACHINES).map(([key, machine]) => [key, Object.freeze({ - name: machine.name, - states: machine.states, - transitions: machine.transitions, - })])), -) - -export const TERMINAL_STATES = Object.freeze({ - task: Object.freeze(['completed', 'failed', 'cancelled']), - dispatch: Object.freeze(['accepted', 'rejected']), - attempt: Object.freeze(['succeeded', 'failed', 'cancelled']), - department: Object.freeze([]), -}) - -function machineOf(kind) { - const machine = MACHINES[kind] - if (machine === undefined) throw new Error(`未知状态机: ${String(kind)}`) - return machine -} - -export function statesOf(kind) { - return machineOf(kind).states -} - -export function isState(kind, value) { - return machineOf(kind).states.includes(value) -} - -export function allowedTransitions(kind, from) { - const machine = machineOf(kind) - if (!machine.states.includes(from)) throw new Error(`${machine.name} 未知状态: ${String(from)}`) - return machine.transitions[from] -} - -export function canTransition(kind, from, to) { - // 同状态重复写入不算迁移:事件重放时应由调用方静默忽略,而不是报错。 - if (from === to) return true - return allowedTransitions(kind, from).includes(to) -} - -const MACHINE_KEY = Object.freeze({ task: 'task', dispatch: 'dispatch', attempt: 'attempt', department: 'department' }) - -export function isTerminal(kind, state) { - return TERMINAL_STATES[machineOf(kind).key].includes(state) -} - -/** 非法迁移一律抛错:状态倒退还沉默会让故障矩阵里“终态不被覆盖”的保证失效。 */ -export function assertTransition(kind, from, to) { - const machine = machineOf(kind) - if (!machine.states.includes(from)) throw new Error(`${machine.name} 当前状态非法: ${String(from)}`) - if (!machine.states.includes(to)) throw new Error(`${machine.name} 目标状态非法: ${String(to)}`) - if (from === to) return to - if (!machine.transitions[from].includes(to)) { - throw new Error(`${machine.name} 不允许从 ${from} 迁移到 ${to}`) - } - return to -} diff --git a/workbench/core/store.mjs b/workbench/core/store.mjs deleted file mode 100644 index 8915cb3..0000000 --- a/workbench/core/store.mjs +++ /dev/null @@ -1,1019 +0,0 @@ -// 领域存储:内存表 + JSON 文件快照(先写 .tmp 再 rename)。 -// 只存业务账、引用和交接快照;聊天正文仍由 DSH 保存,这里不复制一份会过期的副本。 -// 所有写入都走 mutate():一次写入 = 一次事务,中途抛错就整体回滚,内存里不会留下半截状态。 - -import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs' -import { homedir } from 'node:os' -import { dirname, join, resolve } from 'node:path' -import { createIdFactory, isIdOf, newId } from './ids.mjs' -import { ROLES, isRoleId } from './roles.mjs' -import { assertTransition, isTerminal, isState } from './states.mjs' - -export const SCHEMA_VERSION = 1 - -const COLLECTIONS = Object.freeze([ - 'projects', - 'bindings', - 'configs', - 'tasks', - 'dispatches', - 'attempts', - 'contextPackets', - 'results', - 'artifacts', - 'events', -]) - -const ENTITY_OF = Object.freeze({ - projects: 'project', - bindings: 'binding', - configs: 'config', - tasks: 'task', - dispatches: 'dispatch', - attempts: 'attempt', - contextPackets: 'contextPacket', - results: 'result', - artifacts: 'artifact', - events: 'event', -}) - -/** 跨项目校验用的引用表:source 实体上的某字段 → 目标实体。 */ -const REFERENCES = Object.freeze({ - tasks: Object.freeze({ - activeAttemptId: 'attempts', - sourceBindingId: 'bindings', - ownerBindingId: 'bindings', - }), - dispatches: Object.freeze({ - taskId: 'tasks', - attemptId: 'attempts', - contextPacketId: 'contextPackets', - bindingId: 'bindings', - }), - attempts: Object.freeze({ - taskId: 'tasks', - dispatchId: 'dispatches', - bindingId: 'bindings', - }), - contextPackets: Object.freeze({ taskId: 'tasks' }), - results: Object.freeze({ - taskId: 'tasks', - attemptId: 'attempts', - sourceBindingId: 'bindings', - }), - artifacts: Object.freeze({ - taskId: 'tasks', - sourceResultId: 'results', - // 修订关系:新成果指向被它替换的旧成果(必须同项目,跨项目一律拒绝)。 - revisesArtifactId: 'artifacts', - ownerBindingId: 'bindings', - }), - events: Object.freeze({}), -}) - -export class StoreError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'StoreError' - this.code = code - if (details !== undefined) this.details = details - } -} - -export function defaultStorePath(env = process.env) { - const home = env.DSH_HOME && String(env.DSH_HOME).trim() !== '' ? env.DSH_HOME : join(homedir(), '.dsh') - return join(resolve(home), 'sansheng-liubu', 'workbench.json') -} - -const nowIso = (clock) => new Date(clock()).toISOString() - -function bindingKey(projectId, roleId) { - return `${projectId}\u0000${roleId}` -} - -function emptyState() { - return { - schemaVersion: SCHEMA_VERSION, - revision: 0, - eventSeq: 0, - projects: new Map(), - bindings: new Map(), - configs: new Map(), - tasks: new Map(), - dispatches: new Map(), - attempts: new Map(), - contextPackets: new Map(), - results: new Map(), - artifacts: new Map(), - events: [], - } -} - -/** 深拷贝走 JSON:状态里只有可序列化数据,写文件同样是这个形状,避免两条路径不同步。 */ -function clone(value) { - return value === undefined ? undefined : JSON.parse(JSON.stringify(value)) -} - -function requireString(value, field) { - if (typeof value !== 'string' || value.trim() === '') { - throw new StoreError('INVALID_INPUT', `${field} 必须是非空字符串`) - } - return value -} - -/** 集合 → 主键字段,注册时统一生成 ID 并校验前缀。 */ -const KEY_FIELD = Object.freeze({ - projects: 'id', - bindings: 'id', - configs: 'id', - tasks: 'id', - dispatches: 'id', - attempts: 'id', - contextPackets: 'id', - results: 'id', - artifacts: 'id', - events: 'eventId', -}) - -export class WorkbenchStore { - /** - * @param {object} [options] - * @param {string} [options.file] 持久化路径;null/'' 表示纯内存(测试与只读投影用)。 - * @param {() => number} [options.clock] 注入时钟,测试可固定时间戳。 - * @param {() => string} [options.random] 注入随机源,测试可固定 ID。 - * @param {object} [options.env] 计算默认路径用的环境变量。 - */ - constructor(options = {}) { - const { file = defaultStorePath(options.env), clock = Date.now, random, env } = options - this.file = file === null || file === '' ? null : resolve(String(file)) - this.clock = clock - this.random = random - this.ids = createIdFactory(random === undefined ? {} : { random }) - - this.state = emptyState() - // 事务深度为 0 才是真正的提交点;嵌套写入并进外层事务,内层抛错由外层整体回滚。 - this._txDepth = 0 - this._stamp = null - this._dirty = false - this.env = env - } - - // ---------- 事务与生命周期 ---------- - - /** - * 一次事务提交所有内存变更并顺带落盘;payloads 里收集的 ID 说明“写成功”才对外可见。 - * 不自动落盘失败时的部分内存修改被丢弃,重试不会撞上幽灵记录。 - */ - mutate(payloads = () => null) { - const snapshot = this._txDepth === 0 ? this._captureState() : null - this._txDepth += 1 - const result = {} - let committed = false - let value - try { - value = payloads(result) - committed = true - } finally { - this._txDepth -= 1 - // 外层事务收尾:成功则递增版本并落盘;失败则回滚到事务开始时的快照。 - if (this._txDepth === 0) { - if (committed) { - this.state.revision += 1 - this._stamp = nowIso(this.clock) - this._dirty = true - try { - this.save() - } catch (error) { - if (snapshot !== null) this.state = snapshot - throw error - } - } else if (snapshot !== null) { - this.state = snapshot - } - } - } - return { ...result, value } - } - - /** 只读运行,不递增 revision,也不落盘。 */ - view(fn) { - return fn() - } - - save() { - if (this.file === null) return false - this._writeAtomically(this.serialize()) - this._dirty = false - return true - } - - load() { - if (this.file === null) return false - if (!existsSync(this.file)) return false - const raw = readFileSync(this.file, 'utf8') - this._applySnapshot(raw) - return true - } - - serialize() { - const state = this.state - return JSON.stringify({ - schemaVersion: state.schemaVersion, - revision: state.revision, - eventSeq: state.eventSeq, - projects: [...state.projects.values()], - bindings: [...state.bindings.values()], - configs: [...state.configs.values()], - tasks: [...state.tasks.values()], - dispatches: [...state.dispatches.values()], - attempts: [...state.attempts.values()], - contextPackets: [...state.contextPackets.values()], - results: [...state.results.values()], - artifacts: [...state.artifacts.values()], - events: state.events, - }) - } - - /** 投影给 UI 用:只读副本,避免调用方直接改 Map。 */ - snapshot() { - return clone({ - schemaVersion: this.state.schemaVersion, - revision: this.state.revision, - eventSeq: this.state.eventSeq, - savedAt: this._stamp ?? null, - projects: [...this.state.projects.values()], - bindings: [...this.state.bindings.values()], - configs: [...this.state.configs.values()], - tasks: [...this.state.tasks.values()], - dispatches: [...this.state.dispatches.values()], - attempts: [...this.state.attempts.values()], - contextPackets: [...this.state.contextPackets.values()], - results: [...this.state.results.values()], - artifacts: [...this.state.artifacts.values()], - events: this.state.events, - }) - } - - get revision() { - return this.state.revision - } - - get eventSeq() { - return this.state.eventSeq - } - - _captureState() { - return this._fromSnapshot(JSON.parse(this.serialize())) - } - - _writeAtomically(text) { - const dir = dirname(this.file) - mkdirSync(dir, { recursive: true }) - const tmp = `${this.file}.${process.pid}.${Date.now()}.tmp` - try { - writeFileSync(tmp, text, 'utf8') - // Windows 上 rename 覆盖已存在文件可能失败(杀软/索引占用),失败时删旧再改名, - // 最坏情况是两个窗口都读到“空账”,但不会读到半截 JSON。 - try { - renameSync(tmp, this.file) - } catch (error) { - rmSync(this.file, { force: true }) - renameSync(tmp, this.file) - } - } finally { - rmSync(tmp, { force: true }) - } - } - - _applySnapshot(text) { - const parsed = JSON.parse(text) - this.state = this._fromSnapshot(parsed) - } - - _fromSnapshot(parsed) { - if (parsed === null || typeof parsed !== 'object') throw new StoreError('CORRUPT', '账本不是对象') - if (parsed.schemaVersion !== SCHEMA_VERSION) { - throw new StoreError('SCHEMA_MISMATCH', `账本 schemaVersion=${String(parsed.schemaVersion)},期望 ${SCHEMA_VERSION}`) - } - const state = emptyState() - state.revision = Number(parsed.revision) || 0 - state.eventSeq = Number(parsed.eventSeq) || 0 - for (const collection of COLLECTIONS) { - const list = Array.isArray(parsed[collection]) ? parsed[collection] : [] - if (collection === 'events') { - state.events = list - continue - } - const keyOf = collection === 'bindings' || collection === 'configs' - ? (row) => bindingKey(row.projectId, row.roleId) - : (row) => row[KEY_FIELD[collection]] - for (const row of list) state[collection].set(keyOf(row), row) - } - return state - } - - // ---------- 通用查询 ---------- - - getProject(id) { - return this.state.projects.get(id) - } - - listProjects() { - return [...this.state.projects.values()] - } - - getBinding(projectId, roleId) { - return this.state.bindings.get(bindingKey(projectId, roleId)) - } - - listBindings(projectId) { - return [...this.state.bindings.values()].filter((row) => projectId === undefined || row.projectId === projectId) - } - - getConfig(projectId, roleId) { - return this.state.configs.get(bindingKey(projectId, roleId)) - } - - listConfigs(projectId) { - return [...this.state.configs.values()].filter((row) => projectId === undefined || row.projectId === projectId) - } - - getTask(id) { - return this.state.tasks.get(id) - } - - listTasks(projectId) { - return [...this.state.tasks.values()].filter((row) => projectId === undefined || row.projectId === projectId) - } - - getDispatch(id) { - return this.state.dispatches.get(id) - } - - getAttempt(id) { - return this.state.attempts.get(id) - } - - listAttempts(taskId) { - return [...this.state.attempts.values()].filter((row) => taskId === undefined || row.taskId === taskId) - } - - getContextPacket(id) { - return this.state.contextPackets.get(id) - } - - getResult(id) { - return this.state.results.get(id) - } - - listResults(taskId) { - return [...this.state.results.values()].filter((row) => taskId === undefined || row.taskId === taskId) - } - - getArtifact(id) { - return this.state.artifacts.get(id) - } - - listArtifacts(projectId) { - return [...this.state.artifacts.values()].filter((row) => projectId === undefined || row.projectId === projectId) - } - - listEvents(projectId) { - return this.state.events.filter((row) => projectId === undefined || row.projectId === projectId) - } - - findDispatchByIdempotencyKey(projectId, key) { - return [...this.state.dispatches.values()].find( - (row) => row.projectId === projectId && row.idempotencyKey === key, - ) - } - - // ---------- 写入:项目 ---------- - - createProject(input) { - const hostWorkspaceId = requireString(input?.hostWorkspaceId, 'hostWorkspaceId') - const existing = [...this.state.projects.values()].find((row) => row.hostWorkspaceId === hostWorkspaceId) - if (existing !== undefined) { - throw new StoreError('DUPLICATE_PROJECT', `宿主工作区已登记为项目 ${existing.id}`, { projectId: existing.id }) - } - const id = this.ids.project() - const stamp = nowIso(this.clock) - return this.mutate((out) => { - const project = { - id, - hostWorkspaceId, - displayNameCache: input.displayNameCache ?? '', - canonicalRoot: input.canonicalRoot ?? null, - status: input.status ?? 'active', - schemaVersion: SCHEMA_VERSION, - revision: 1, - createdAt: stamp, - updatedAt: stamp, - } - this.state.projects.set(id, project) - // 首次进入只建十席配置初值与空绑定,不自动创建会话、不发模型请求。 - for (const seat of ROLES) { - const binding = this._emptyBinding(id, seat.id, stamp) - const config = this._emptyConfig(id, seat.id, stamp) - this.state.bindings.set(bindingKey(id, seat.id), binding) - this.state.configs.set(bindingKey(id, seat.id), config) - } - this._appendEvent({ type: 'project.created', projectId: id, payload: { hostWorkspaceId } }, stamp) - out.projectId = id - return id - }).value - } - - updateProject(id, patch) { - return this.mutate((out) => { - const project = this._project(id) - const stamp = nowIso(this.clock) - const next = { ...project, updatedAt: stamp, revision: project.revision + 1 } - if (patch?.displayNameCache !== undefined) next.displayNameCache = String(patch.displayNameCache) - if (patch?.canonicalRoot !== undefined) next.canonicalRoot = patch.canonicalRoot - if (patch?.status !== undefined) next.status = patch.status - this.state.projects.set(id, next) - out.written = 1 - return next - }).value - } - - _project(id) { - requireString(id, 'projectId') - const project = this.state.projects.get(id) - if (project === undefined) throw new StoreError('NOT_FOUND', `项目不存在: ${id}`) - return project - } - - // ---------- 写入:绑定 ---------- - - _emptyBinding(projectId, roleId, stamp) { - return { - id: this.ids.binding(), - projectId, - roleId, - currentSessionId: null, - bindingGeneration: 0, - historySessionRefs: [], - creationRequestId: null, - status: 'uninitialized', - revision: 1, - createdAt: stamp, - updatedAt: stamp, - } - } - - _emptyConfig(projectId, roleId, stamp) { - return { - id: this.ids.config(), - projectId, - roleId, - providerId: null, - modelId: null, - reasoningEffort: null, - rolePromptVersion: 1, - skillRefs: [], - permissionRef: null, - configRevision: 0, - updatedAt: stamp, - } - } - - ensureBinding(projectId, roleId) { - this._project(projectId) - this._role(roleId) - const existing = this.getBinding(projectId, roleId) - if (existing !== undefined) return existing - const stamp = nowIso(this.clock) - return this.mutate((out) => { - const binding = this._emptyBinding(projectId, roleId, stamp) - this.state.bindings.set(bindingKey(projectId, roleId), binding) - out.bindingId = binding.id - return binding - }).value - } - - /** - * 绑定会话:写入前先校验唯一性——同一 currentSessionId 不得同时属于两个 (projectId, roleId), - * 除非旧绑定已被 releaseBinding 释放(currentSessionId 置空并进入 historySessionRefs)。 - * bindingGeneration 每次换绑 +1:派发时固定它,旧消息不会被自动送进新会话。 - * 本部门已绑定另一会话时默认拒绝:静默覆盖等于把旧会话的历史从账上抹掉。 - * 只有调用方显式 allowReplace 才换绑,并仍把旧会话保留进 historySessionRefs。 - */ - bindSession(projectId, roleId, sessionId, options = {}) { - this._project(projectId) - this._role(roleId) - requireString(sessionId, 'sessionId') - return this.mutate((out) => { - const binding = this.getBinding(projectId, roleId) - if (binding === undefined) throw new StoreError('NOT_FOUND', '部门绑定不存在,请先 initializeProject') - const holder = this._sessionHolder(projectId, roleId, sessionId) - if (holder !== undefined) { - throw new StoreError('SESSION_CONFLICT', '会话已绑定到另一个项目或部门', { - sessionId, - heldBy: { projectId: holder.projectId, roleId: holder.roleId }, - }) - } - if (binding.currentSessionId !== null) { - if (binding.currentSessionId === sessionId) { - throw new StoreError('SESSION_CONFLICT', '该会话已是本部门的当前会话,无需重复绑定', { sessionId }) - } - if (options.allowReplace !== true) { - throw new StoreError('SESSION_CONFLICT', '本部门已绑定其他会话,请先 releaseBinding 或显式 allowReplace', { - currentSessionId: binding.currentSessionId, - }) - } - } - const stamp = nowIso(this.clock) - const history = binding.currentSessionId === null || options.allowReplace !== true - ? binding.historySessionRefs - : [ - ...binding.historySessionRefs, - { sessionId: binding.currentSessionId, releasedAt: stamp, bindingGeneration: binding.bindingGeneration }, - ] - const next = { - ...binding, - currentSessionId: sessionId, - historySessionRefs: history, - bindingGeneration: binding.bindingGeneration + 1, - creationRequestId: options.creationRequestId ?? null, - status: options.status ?? 'idle', - revision: binding.revision + 1, - updatedAt: stamp, - } - assertTransition('department', binding.status, next.status) - this.state.bindings.set(bindingKey(projectId, roleId), next) - this._appendEvent({ - type: 'binding.session_bound', - projectId, - roleId, - payload: { sessionId, bindingGeneration: next.bindingGeneration, bindingId: next.id }, - }, stamp) - out.bindingId = next.id - return next - }).value - } - - /** - * 释放当前会话:旧会话进入 historySessionRefs(不删除历史),供以后接续。 - * 释放后同一 sessionId 才能绑定到别处。 - */ - releaseBinding(projectId, roleId) { - return this.mutate((out) => { - const binding = this.getBinding(projectId, roleId) - if (binding === undefined) throw new StoreError('NOT_FOUND', '部门绑定不存在') - const sessionId = binding.currentSessionId - const stamp = nowIso(this.clock) - const history = sessionId === null - ? binding.historySessionRefs - : [...binding.historySessionRefs, { sessionId, releasedAt: stamp, bindingGeneration: binding.bindingGeneration }] - const next = { - ...binding, - currentSessionId: null, - historySessionRefs: history, - status: 'uninitialized', - revision: binding.revision + 1, - updatedAt: stamp, - } - this.state.bindings.set(bindingKey(projectId, roleId), next) - if (sessionId !== null) { - this._appendEvent({ type: 'binding.session_released', projectId, roleId, payload: { sessionId } }, stamp) - } - out.bindingId = next.id - return next - }).value - } - - setBindingStatus(projectId, roleId, status) { - return this.mutate((out) => { - const binding = this.getBinding(projectId, roleId) - if (binding === undefined) throw new StoreError('NOT_FOUND', '部门绑定不存在') - assertTransition('department', binding.status, status) - const stamp = nowIso(this.clock) - const next = { ...binding, status, revision: binding.revision + 1, updatedAt: stamp } - this.state.bindings.set(bindingKey(projectId, roleId), next) - out.bindingId = next.id - return next - }).value - } - - /** 会话归属查询:返回 nullptr 以外的唯一持有者(含跨项目),用于唯一性校验。 */ - _sessionHolder(projectId, roleId, sessionId) { - for (const row of this.state.bindings.values()) { - if (row.currentSessionId !== sessionId) continue - if (row.projectId === projectId && row.roleId === roleId) continue - return row - } - return undefined - } - - // ---------- 写入:配置(CAS) ---------- - - /** - * 保存某项目某部门的模型设置。expectedRevision 必须等于当前 configRevision, - * 否则抛 CAS_CONFLICT 并带回当前值,让 UI 提示后重应用,而不是静默覆盖另一标签页的修改。 - */ - saveConfig(projectId, roleId, desired, expectedRevision) { - this._project(projectId) - this._role(roleId) - if (!Number.isInteger(expectedRevision)) { - throw new StoreError('INVALID_INPUT', 'expectedRevision 必须是整数') - } - const provider = requireString(desired?.provider ?? desired?.providerId, 'provider') - const model = requireString(desired?.model ?? desired?.modelId, 'model') - const effort = desired?.reasoningEffort ?? null - if (effort !== null && typeof effort !== 'string') { - throw new StoreError('INVALID_INPUT', 'reasoningEffort 必须是字符串或 null') - } - return this.mutate((out) => { - const config = this.getConfig(projectId, roleId) - if (config === undefined) throw new StoreError('NOT_FOUND', '部门配置不存在') - if (config.configRevision !== expectedRevision) { - throw new StoreError('CAS_CONFLICT', '配置已被其他窗口修改', { - expectedRevision, - currentRevision: config.configRevision, - current: { - provider: config.providerId, - model: config.modelId, - reasoningEffort: config.reasoningEffort ?? null, - }, - }) - } - const stamp = nowIso(this.clock) - const next = { - ...config, - providerId: provider, - modelId: model, - reasoningEffort: effort, - configRevision: config.configRevision + 1, - updatedAt: stamp, - } - this.state.configs.set(bindingKey(projectId, roleId), next) - this._appendEvent({ - type: 'config.saved', - projectId, - roleId, - payload: { provider, model, reasoningEffort: effort, configRevision: next.configRevision }, - }, stamp) - out.configId = next.id - return next - }).value - } - - // ---------- 写入:任务 ---------- - - /** - * raw 模式的写入口:tasks.mjs 负责生命周期判断,store 只保证“存在、状态合法、归属正确”。 - * 直接调用的调用方必须自己先用 assertTransition,并且不能跳过 task.ts。 - */ - insertTask(task) { - return this.mutate((out) => { - // 先定 ID:显式传入的 ID 撞键按重复报错(调用方给了确定的键,不能偷偷换); - // 自动生成的 ID 撞键就再抽一次——ID 用尽属于随机源问题,重抽几次仍撞才算失败。 - const auto = task?.id === undefined - let candidate = task?.id ?? this.ids.task() - for (let retry = 0; auto && this.state.tasks.has(candidate) && retry < 8; retry += 1) { - candidate = this.ids.task() - } - if (this.state.tasks.has(candidate)) throw new StoreError('DUPLICATE_ID', `任务已存在: ${candidate}`) - const next = { ...task, id: candidate, revision: task?.revision ?? 1 } - this._assertTaskFields(next) - this.state.tasks.set(candidate, next) - out.taskId = candidate - return next - }).value - } - - updateTask(task) { - return this.mutate((out) => { - const current = this.state.tasks.get(task?.id) - if (current === undefined) throw new StoreError('NOT_FOUND', `任务不存在: ${String(task?.id)}`) - if (current.projectId !== task.projectId) { - throw new StoreError('CROSS_PROJECT', '任务的 projectId 不能被改写') - } - const next = { ...task, revision: current.revision + 1 } - assertTransition('task', current.status, next.status) - this.state.tasks.set(next.id, next) - out.taskId = next.id - return next - }).value - } - - _assertTaskFields(task) { - requireString(task.id, 'task.id') - isIdOf('task', task.id) || (() => { throw new StoreError('INVALID_ID', `任务 ID 形状非法: ${task.id}`) })() - this._project(task.projectId) - if (!isRoleId(task.ownerRoleId)) throw new StoreError('INVALID_ROLE', `未知主责部门: ${String(task.ownerRoleId)}`) - if (!isRoleId(task.sourceRoleId)) throw new StoreError('INVALID_ROLE', `未知来源部门: ${String(task.sourceRoleId)}`) - if (!isState('task', task.status)) throw new StoreError('INVALID_STATE', `未知任务状态: ${String(task.status)}`) - return task - } - - _role(roleId) { - if (!isRoleId(roleId)) throw new StoreError('INVALID_ROLE', `未知角色: ${String(roleId)}`) - return roleId - } - - // ---------- 写入:派发(幂等) ---------- - - /** - * 幂等键 (projectId, idempotencyKey) 唯一:重复点击派工返回既有记录并标 duplicate, - * 绝不生成第二条 dispatch——投递可能已经发生,重写一条等于假装配送两次。 - */ - recordDispatch(input) { - const projectId = requireString(input?.projectId, 'projectId') - const key = requireString(input?.idempotencyKey, 'idempotencyKey') - this._project(projectId) - const existing = this.findDispatchByIdempotencyKey(projectId, key) - if (existing !== undefined) return { dispatch: clone(existing), duplicate: true } - return this.mutate((out) => { - const stamp = nowIso(this.clock) - const dispatch = { - id: this.ids.dispatch(), - projectId, - taskId: input.taskId ?? null, - attemptId: input.attemptId ?? null, - sourceSessionId: input.sourceSessionId ?? null, - targetSessionId: input.targetSessionId ?? null, - bindingId: input.bindingId ?? null, - bindingGeneration: input.bindingGeneration ?? 0, - contextPacketId: input.contextPacketId ?? null, - idempotencyKey: key, - status: input.status ?? 'prepared', - hostMessageId: null, - createdAt: stamp, - updatedAt: stamp, - } - if (!isState('dispatch', dispatch.status)) { - throw new StoreError('INVALID_STATE', `未知派发状态: ${String(dispatch.status)}`) - } - // 先落库再校验:派发与自己的 attemptId 是同一事务内的前向引用, - // 若先校验会读不到刚创建的 dispatch 自身(历史 bug:所有派发失败)。 - this.state.dispatches.set(dispatch.id, dispatch) - this._checkReferences({ ...dispatch, source: 'dispatches' }) - this._appendEvent({ type: 'dispatch.recorded', projectId, payload: { dispatchId: dispatch.id, idempotencyKey: key } }, stamp) - out.dispatchId = dispatch.id - return { dispatch, duplicate: false } - }).value - } - - /** 派发状态推进:接受状态必须由宿主回执驱动,不允许调用方跳过 sending 直接 accepted 之外的猜测。 */ - updateDispatch(id, patch) { - return this.mutate((out) => { - const current = this.state.dispatches.get(id) - if (current === undefined) throw new StoreError('NOT_FOUND', `派发不存在: ${id}`) - const next = { ...current, ...patch, id: current.id, projectId: current.projectId } - if (patch?.status !== undefined) assertTransition('dispatch', current.status, patch.status) - const stamp = nowIso(this.clock) - next.updatedAt = stamp - this.state.dispatches.set(id, next) - out.dispatchId = id - return next - }).value - } - - // ---------- 写入:尝试 / 上下文包 ---------- - - insertAttempt(attempt) { - return this.mutate((out) => { - const id = attempt?.id ?? this.ids.attempt() - const next = { ...attempt, id } - if (!isState('attempt', next.state)) throw new StoreError('INVALID_STATE', `未知尝试状态: ${String(next.state)}`) - this._checkReferences({ ...next, source: 'attempts' }) - this.state.attempts.set(id, next) - out.attemptId = id - return next - }).value - } - - updateAttempt(id, patch) { - return this.mutate((out) => { - const current = this.state.attempts.get(id) - if (current === undefined) throw new StoreError('NOT_FOUND', `尝试不存在: ${id}`) - if (patch?.state !== undefined) assertTransition('attempt', current.state, patch.state) - const next = { ...current, ...patch, id, projectId: current.projectId, taskId: current.taskId } - this.state.attempts.set(id, next) - out.attemptId = id - return next - }).value - } - - insertContextPacket(packet) { - return this.mutate((out) => { - const id = packet?.id ?? this.ids.contextPacket() - const next = { ...packet, id } - this._checkReferences({ ...next, source: 'contextPackets' }) - this.state.contextPackets.set(id, next) - out.contextPacketId = id - return next - }).value - } - - // ---------- 写入:结果(幂等) / 成果 ---------- - - /** - * 结果去重:同一 (attemptId, reportVersion) 或同一条源消息只登记一次。 - * 完成事件重复到达是常态(刷新、重连、双窗口),重写一次结果会把检查与未完成项覆盖成“最新一次”的假象。 - */ - recordResult(input) { - const projectId = requireString(input?.projectId, 'projectId') - const attemptId = requireString(input?.attemptId, 'attemptId') - const reportVersion = input.reportVersion ?? 1 - const sourceMessageRef = input.sourceMessageRef ?? null - const existing = this._findDuplicateResult(projectId, attemptId, reportVersion, sourceMessageRef) - if (existing !== undefined) return { result: clone(existing), duplicate: true } - return this.mutate((out) => { - const stamp = nowIso(this.clock) - const result = { - id: this.ids.result(), - projectId, - taskId: input.taskId ?? null, - attemptId, - reportVersion, - summary: String(input.summary ?? ''), - artifactRefs: Array.isArray(input.artifactRefs) ? [...input.artifactRefs] : [], - checks: Array.isArray(input.checks) ? clone(input.checks) : [], - remainingItems: Array.isArray(input.remainingItems) ? [...input.remainingItems] : [], - blockedReason: input.blockedReason ?? null, - sourceMessageRef: sourceMessageRef ?? null, - createdAt: stamp, - } - this._checkReferences({ ...result, source: 'results' }) - this.state.results.set(result.id, result) - this._appendEvent({ type: 'result.recorded', projectId, payload: { resultId: result.id, attemptId } }, stamp) - out.resultId = result.id - return { result, duplicate: false } - }).value - } - - _findDuplicateResult(projectId, attemptId, reportVersion, sourceMessageRef) { - for (const row of this.state.results.values()) { - if (row.projectId !== projectId || row.attemptId !== attemptId) continue - if (row.reportVersion === reportVersion) return row - if (sourceMessageRef !== null && row.sourceMessageRef === sourceMessageRef) return row - } - return undefined - } - - recordArtifact(input) { - return this.mutate((out) => { - const stamp = nowIso(this.clock) - const artifact = { - id: input?.id ?? this.ids.artifact(), - projectId: input?.projectId, - taskId: input?.taskId ?? null, - ownerRoleId: input?.ownerRoleId, - fileRef: input?.fileRef ?? null, - displayName: input?.displayName ?? '', - mediaType: input?.mediaType ?? 'application/octet-stream', - versionOrHash: input?.versionOrHash ?? null, - verification: input?.verification ?? { status: 'unverified' }, - sourceResultId: input?.sourceResultId ?? null, - // 修订链:revisesArtifactId 指向被替换的旧版本,revision 从 1 起递增。 - // 只在登记时写入,之后不原地改——历史版本必须能追。 - revisesArtifactId: input?.revisesArtifactId ?? null, - revision: Number.isInteger(input?.revision) && input.revision > 0 ? input.revision : 1, - revisionOfTaskId: input?.revisionOfTaskId ?? null, - createdAt: stamp, - } - if (!isRoleId(artifact.ownerRoleId)) throw new StoreError('INVALID_ROLE', `未知主责部门: ${String(artifact.ownerRoleId)}`) - this._checkReferences({ ...artifact, source: 'artifacts' }) - this.state.artifacts.set(artifact.id, artifact) - out.artifactId = artifact.id - return artifact - }).value - } - - // ---------- 事件日志 / outbox ---------- - - /** - * 追加事件:seq 单调递增,eventId 作为去重键(重复完成事件只登记一次)。 - * 事件与业务写入同一次 mutate,崩溃时要么一起在,要么一起不在。 - */ - appendEvent(event) { - return this.mutate((out) => { - const row = this._appendEvent(event, nowIso(this.clock)) - out.eventId = row.eventId - return row - }).value - } - - _appendEvent(event, stamp) { - // 事件 ID 额外带首个事件自增号:即使调用方注入常量随机源(测试),eventId 仍唯一。 - const eventId = event?.eventId ?? this._nextEventId() - if (this.state.events.some((row) => row.eventId === eventId)) { - throw new StoreError('DUPLICATE_EVENT', `事件已登记: ${eventId}`) - } - this.state.eventSeq += 1 - const row = { - eventId, - seq: this.state.eventSeq, - type: requireString(event?.type, 'event.type'), - projectId: event?.projectId ?? null, - roleId: event?.roleId ?? null, - taskId: event?.taskId ?? null, - attemptId: event?.attemptId ?? null, - payload: clone(event?.payload ?? {}), - createdAt: stamp, - processedAt: event?.processedAt ?? null, - // outbox 投递标记:null 表示尚未确认送达,ack 后写时间戳,事件本身保留审计。 - deliveredAt: event?.deliveredAt ?? null, - } - this.state.events.push(row) - return row - } - - _nextEventId() { - const base = newId('event', this.random === undefined ? {} : { random: this.random }) - const taken = this.state.events.some((row) => row.eventId === base) - return taken ? `${base}.${this.state.eventSeq + 1}` : base - } - - // ---------- 归属校验 ---------- - - _checkReferences(entity) { - const collection = entity.source - const table = REFERENCES[collection] - if (table === undefined) return - if (entity.projectId === undefined || entity.projectId === null) return - if (!isIdOf('project', entity.projectId) || !this.state.projects.has(entity.projectId)) { - throw new StoreError('CROSS_PROJECT', `引用的项目不存在或 ID 非法: ${String(entity.projectId)}`) - } - for (const [field, target] of Object.entries(table)) { - const value = entity[field] - if (value === undefined || value === null) continue - const row = this.state[target].get(value) - if (row === undefined) { - throw new StoreError('NOT_FOUND', `${field} 指向的${target}不存在: ${value}`) - } - if (row.projectId !== entity.projectId) { - throw new StoreError('CROSS_PROJECT', `跨项目引用被拒绝: ${field}=${value} 属于 ${row.projectId}`) - } - } - } - - /** - * 显式归属检查,供服务层在写入前校验外部传入的 task/attempt/artifact ID。 - * 不猜身份:调用方带上的 projectId 必须与目标记录一致,否则拒绝。 - */ - assertProjectOwns(projectId, collection, id) { - const table = this.state[collection] - if (!(table instanceof Map)) throw new StoreError('INVALID_INPUT', `未知集合: ${collection}`) - const row = table.get(id) - if (row === undefined) throw new StoreError('NOT_FOUND', `${collection} 中不存在 ${id}`) - if (row.projectId !== projectId) { - throw new StoreError('CROSS_PROJECT', `${collection}/${id} 不属于项目 ${projectId}`) - } - return row - } - - /** 非终态尝试:宿主重启后要对账的对象。 */ - listOpenAttempts() { - return [...this.state.attempts.values()].filter((row) => !isTerminal('attempt', row.state)) - } - - /** - * 未完成的 outbox:processedAt 与 deliveredAt 都为空的事件,按 seq 升序。 - * options.limit 为正整数时只取最早的前 limit 条(投递端分批拉取用);不传或非法则返回全部,保持旧行为。 - * 只读:不递增 revision,也不落盘。 - */ - listPendingEvents(projectId, options = {}) { - const rows = this.state.events - .filter((row) => row.processedAt === null && (row.deliveredAt ?? null) === null) - .filter((row) => projectId === undefined || row.projectId === projectId) - .slice() - .sort((left, right) => left.seq - right.seq) - const limit = options?.limit - if (!Number.isInteger(limit) || limit <= 0) return rows - return rows.slice(0, limit) - } - - /** - * outbox 的 ack:把属于 projectId、且 eventId 在 eventIds 中的事件标记为已投递(deliveredAt)。 - * 不物理删除——投递记录要能审计;重复 ack、未知 id、别的项目的事件都静默忽略(不跨项目写)。 - * 返回 {delivered}:本次实际新标记的条数;一条都没标时不进 mutate,也就不会白增 revision。 - */ - markEventDelivered(projectId, eventIds) { - requireString(projectId, 'projectId') - // 项目不存在与其它方法一致抛 NOT_FOUND;纯查询校验,失败时不留任何写入。 - if (!this.state.projects.has(projectId)) { - throw new StoreError('NOT_FOUND', `项目不存在: ${projectId}`) - } - if (!Array.isArray(eventIds)) throw new StoreError('INVALID_INPUT', 'eventIds 必须是数组') - const wanted = new Set(eventIds.filter((id) => typeof id === 'string' && id !== '')) - const targets = wanted.size === 0 - ? [] - : this.state.events.filter((row) => wanted.has(row.eventId) && row.projectId === projectId && (row.deliveredAt ?? null) === null) - if (targets.length === 0) return { delivered: 0 } - const stamp = nowIso(this.clock) - return this.mutate(() => { - for (const row of targets) row.deliveredAt = stamp - return { delivered: targets.length } - }).value - } -} - -/** 集合名 → 实体名,供 UI 或日志把表名翻译成实体。 */ -export function entityOf(collection) { - return ENTITY_OF[collection] ?? null -} diff --git a/workbench/core/tasks.mjs b/workbench/core/tasks.mjs deleted file mode 100644 index 92a3f27..0000000 --- a/workbench/core/tasks.mjs +++ /dev/null @@ -1,436 +0,0 @@ -// 任务生命周期:纯函数 + 显式副作用端口。 -// 判定永远不读聊天文本,只认结构化报告、宿主真实终态和可解析的成果引用—— -// 这是“agent 说已完成”与“任务完成”分开的落点。 -// 副作用(写 store、入队、回传)由调用方注入,core 本身不碰网络和调度。 - -import { assertTransition, isState, isTerminal } from './states.mjs' -import { isRoleId } from './roles.mjs' - -export class TaskError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'TaskError' - this.code = code - if (details !== undefined) this.details = details - } -} - -const TASK_BASE_TRANSITIONS = Object.freeze([ - ['draft', 'queued'], - ['queued', 'running'], - ['running', 'waiting_input'], - ['running', 'needs_attention'], - ['running', 'completed'], - ['running', 'failed'], - ['waiting_input', 'queued'], - ['waiting_input', 'running'], - ['needs_attention', 'completed'], - ['needs_attention', 'running'], - ['needs_attention', 'failed'], - // 取消可在任何非终态发起 - ['draft', 'cancelled'], - ['queued', 'cancelled'], - ['running', 'cancelled'], - ['waiting_input', 'cancelled'], - ['needs_attention', 'cancelled'], - // 入队后模型不可用:允许直接失败并保留错误 - ['queued', 'failed'], -]) - -export const TASK_TRANSITIONS = Object.freeze(TASK_BASE_TRANSITIONS.map(([from, to]) => Object.freeze([from, to]))) - -const TERMINAL_TASK_STATES = Object.freeze(['completed', 'failed', 'cancelled']) - -/** seq 比较:仅当新事件 seq 严格大于已见 seq 才视为“更新”。 */ -export function isStaleSeq(lastSeq, nextSeq) { - if (lastSeq === null || lastSeq === undefined) return false - if (!Number.isFinite(nextSeq)) return true - return nextSeq <= lastSeq -} - -/** 乱序/重复事件:达到终态后任何“回到活动态”的事件都必须忽略,而不是报错中断处理。 */ -export function isRegressingEvent(currentStatus, nextStatus) { - if (TERMINAL_TASK_STATES.includes(currentStatus)) return currentStatus !== nextStatus - return false -} - -function transition(state, next, extra = {}) { - assertTransition('task', state, next) - return next -} - -function requireString(value, field) { - if (typeof value !== 'string' || value.trim() === '') { - throw new TaskError('INVALID_INPUT', `${field} 必须是非空字符串`) - } - return value -} - -function requireTask(task) { - if (task === null || typeof task !== 'object' || typeof task.id !== 'string') { - throw new TaskError('INVALID_TASK', '任务记录不合法') - } - return task -} - -/** - * createTask:只建草稿。draft 不等于入队,校验通过且授权有效后才 startTask 入队。 - * ownerRoleId 与 sourceRoleId 都必须是已知席,来源席默认丞相。 - */ -export function createTask(options, deps = {}) { - const { projectId, title, objective, acceptance = [], ownerRoleId, sourceRoleId = 'lead', originMessageRef = null, scope = null, constraints = [], returnTarget = null } = options ?? {} - requireString(projectId, 'projectId') - requireString(title, 'title') - requireString(objective, 'objective') - if (!isRoleId(ownerRoleId)) throw new TaskError('INVALID_ROLE', `未知主责部门: ${String(ownerRoleId)}`) - if (!isRoleId(sourceRoleId)) throw new TaskError('INVALID_ROLE', `未知来源部门: ${String(sourceRoleId)}`) - const id = typeof deps.newTaskId === 'function' ? deps.newTaskId() : undefined - const stamp = typeof deps.now === 'function' ? deps.now() : new Date().toISOString() - return { - ...(id === undefined ? {} : { id }), - projectId, - title, - objective, - acceptance: Array.isArray(acceptance) ? [...acceptance] : [String(acceptance)], - constraints: Array.isArray(constraints) ? [...constraints] : [], - scope: scope ?? null, - ownerRoleId, - sourceRoleId, - originMessageRef, - returnTarget, - status: 'draft', - activeAttemptId: null, - attempts: [], - startedAt: null, - endedAt: null, - reportReceivedAt: null, - needsAttentionReason: null, - failureReason: null, - waitingReason: null, - revision: 1, - createdAt: stamp, - updatedAt: stamp, - } -} - -/** 入队:唯一需要的前置是 draft,或者 waiting_input 拿到补充。 */ -export function startTask(task, deps = {}) { - requireTask(task) - if (task.status !== 'draft' && task.status !== 'waiting_input') { - throw new TaskError('INVALID_STATE', `只有草稿或待补充的任务可以入队,当前 ${task.status}`) - } - const stamp = stampOf(deps) - return { - ...task, - status: transition(task.status, 'queued'), - waitingReason: null, - revision: task.revision + 1, - updatedAt: stamp, - } -} - -/** - * beginAttempt:队列中的任务进入执行,并绑定一次尝试。 - * 每次重试都是新 attempt,旧尝试(及旧结果引用)保留,不覆盖成“第一次就成功”。 - */ -export function beginAttempt(task, attempt, deps = {}) { - requireTask(task) - if (task.status !== 'queued' && task.status !== 'waiting_input' && task.status !== 'needs_attention' && task.status !== 'running') { - throw new TaskError('INVALID_STATE', `任务 ${task.status} 不能开始新的尝试`) - } - // 是否“仍有活动尝试”不能只看 activeAttemptId 是否为空: - // 取消/失败/对账后,Attempt 已转 cancelled/failed/succeeded 终态,但任务的 activeAttemptId 仍指向它(保留审计), - // 若只看非空就会把取消后的重试挡在 ACTIVE_ATTEMPT 上。deps.attemptLookup 由调用方注入(core 不读 store), - // 只有明确查到“非终态”尝试时才算有活动尝试;查不到(undefined/null)时保持旧行为,按非空处理。 - // 另:attempt 的 unknown 是待对账状态,不算终态,仍会挡住重试。 - const hasActiveAttempt = task.activeAttemptId !== null && task.activeAttemptId !== undefined - && !isSettledAttempt(task.activeAttemptId, deps) - // running 下换尝试等于重试:必须先把旧尝试对账(失败/取消),否则两次运行会同时往一个任务里写结果。 - if (task.status === 'running' && hasActiveAttempt) { - throw new TaskError('ACTIVE_ATTEMPT', '当前尝试仍在运行,先对账再重试') - } - if (attempt === null || typeof attempt !== 'object' || typeof attempt.id !== 'string') { - throw new TaskError('INVALID_ATTEMPT', '尝试记录不合法') - } - if (attempt.projectId !== task.projectId) { - throw new TaskError('CROSS_PROJECT', '尝试与任务不属于同一项目') - } - if (attempt.taskId !== task.id) { - throw new TaskError('CROSS_TASK', '尝试挂在别的任务上') - } - if (task.status === 'needs_attention' && hasActiveAttempt) { - throw new TaskError('ACTIVE_ATTEMPT', '仍有未对账的尝试,先完成或标记失败') - } - const stamp = stampOf(deps) - return { - ...task, - status: transition(task.status, 'running'), - activeAttemptId: attempt.id, - attempts: [...task.attempts, attempt.id], - startedAt: task.startedAt ?? stamp, - needsAttentionReason: null, - waitingReason: null, - revision: task.revision + 1, - updatedAt: stamp, - } -} - -/** 结构化报告是否“可信”:summary 非空、成果引用形状正确、检查是真实结果而非空话。 */ -export function validateReport(report) { - const errors = [] - if (report === null || typeof report !== 'object') return ['报告必须是对象'] - if (!report.attemptId || typeof report.attemptId !== 'string') errors.push('缺少 attemptId') - if (!report.taskId || typeof report.taskId !== 'string') errors.push('缺少 taskId') - if (typeof report.summary !== 'string' || report.summary.trim() === '') errors.push('结果摘要为空') - if (report.artifactRefs !== undefined) { - if (!Array.isArray(report.artifactRefs)) errors.push('artifactRefs 必须是数组') - else { - for (const ref of report.artifactRefs) { - if (typeof ref !== 'string' || !ref.startsWith('art_')) errors.push(`成果引用形状非法: ${String(ref)}`) - } - } - } - if (report.checks !== undefined && !Array.isArray(report.checks)) errors.push('checks 必须是数组') - return errors -} - -/** - * 三条完成条件各占一票,缺一条都不能标 completed: - * 1. 可信结构化报告(有摘要、有检查、没有未解决阻塞) - * 2. 宿主运行终态成功(由调用方从宿主取得,不能猜“空闲=成功”) - * 3. 成果引用有效(引用指向本项目现存成果,或被显式标为不可用) - */ -export function checkCompletion(input) { - const { report = null, runTerminal = null, artifactRefs = [], artifactLookup = null } = input ?? {} - const blockers = [] - let reportOk = false - if (report !== null) { - const errors = validateReport(report) - if (errors.length > 0) blockers.push(...errors) - else if (typeof report.blockedReason === 'string' && report.blockedReason.trim() !== '') { - blockers.push('报告标记了阻塞原因') - } else reportOk = true - } else { - blockers.push('未收到结构化报告') - } - const runOk = runTerminal === 'succeeded' - if (runTerminal === null) blockers.push('宿主运行尚未结束') - else if (!runOk) blockers.push(`宿主运行终态为 ${String(runTerminal)}`) - const refs = Array.isArray(artifactRefs) ? artifactRefs : [] - const invalidRefs = [] - for (const ref of refs) { - if (typeof ref !== 'string' || !ref.startsWith('art_')) invalidRefs.push(String(ref)) - else if (typeof artifactLookup === 'function') { - const artifact = artifactLookup(ref) - if (artifact === undefined || artifact === null) invalidRefs.push(ref) - else if (artifact.verification?.status === 'missing') invalidRefs.push(ref) - } - } - if (invalidRefs.length > 0) blockers.push(`成果引用无效: ${invalidRefs.join(', ')}`) - // 纯分析任务允许没有文件,所以“引用为空”本身不算失败,但登记结果时不能伪造附件。 - return { reportOk, runOk, refsValid: invalidRefs.length === 0, blockers, ok: reportOk && runOk && invalidRefs.length === 0 } -} - -/** - * 完成判定三分支: - * - 报告 + 终态成功 + 成果有效 → completed - * - 只有报告(运行未结束) → 保持 running 等终态(waiting 只是“候选结果已存”) - * - 只有终态(无报告) → needs_attention,提供补报入口,不显示已完成 - */ -export function evaluateCompletion(task, input, deps = {}) { - return decide(task, { kind: 'completion', ...input }, deps) -} - -/** - * 统一事件入口:先按 seq 去重、再按状态机判定。旧 seq 或终态后的事件返回 - * { applied:false, stale:true, task },让调用方知道“什么都没变”而不是误以为写入失败。 - */ -export function decide(task, event, deps = {}) { - requireTask(task) - if (event === null || typeof event !== 'object') throw new TaskError('INVALID_EVENT', '事件必须是对象') - const nextSeq = event.seq - if (nextSeq !== undefined && isStaleSeq(task.lastSeq ?? null, nextSeq)) { - return { applied: false, stale: true, task } - } - const stamp = stampOf(deps) - const base = nextSeq === undefined ? task : { ...task, lastSeq: nextSeq } - const commit = (next) => ({ - applied: true, - stale: false, - task: applyStamp({ ...next, id: task.id, projectId: task.projectId }, next, stamp, base), - }) - - switch (event.kind) { - case 'completion': { - if (isTerminal('task', task.status)) return { applied: false, stale: true, task, reason: '任务已终态' } - const verdict = checkCompletion(event) - if (!verdict.reportOk && verdict.runOk) { - return commit({ - ...base, - status: transition(task.status, 'needs_attention'), - needsAttentionReason: '宿主运行已结束但没有有效的结构化报告', - reportReceivedAt: base.reportReceivedAt ?? null, - }) - } - // 用户主动停止的会话,运行终态是 cancelled 而不是"成功但没报告": - // 这一票足以把任务收成 cancelled,不需要也不可能再等到结构化报告。 - if (event.runTerminal === 'cancelled' && !verdict.reportOk) { - return commit({ ...base, status: transition(task.status, 'cancelled'), endedAt: stamp }) - } - if (!verdict.ok) { - // 报告不完整:只记录候选报告,等下一次带完整信息的事件。 - return { applied: false, stale: false, task: base, reason: verdict.blockers.join('; '), verdict } - } - return commit({ - ...base, - status: transition(task.status, 'completed'), - reportReceivedAt: stamp, - needsAttentionReason: null, - failureReason: null, - }) - } - case 'report': { - if (isTerminal('task', task.status)) return { applied: false, stale: true, task } - const errors = validateReport(event.report) - if (errors.length > 0) throw new TaskError('INVALID_REPORT', errors.join('; '), { errors }) - // 报告先到:保存候选结果,等待宿主终态。 - return commit({ ...base, reportReceivedAt: stamp, needsAttentionReason: null }) - } - case 'run_terminal': { - if (isTerminal('task', task.status)) return { applied: false, stale: true, task } - const state = event.runTerminal - if (state === 'succeeded') { - // 只有报告已经到达,才可能在这里直接完成;否则留给 completion 判定。 - if (base.reportReceivedAt !== null && base.status === 'running') { - return commit({ ...base, status: transition(task.status, 'completed') }) - } - return { applied: false, stale: false, task: base, reason: '等待结构化报告' } - } - if (state === 'cancelled') { - return commit({ ...base, status: transition(task.status, 'cancelled'), endedAt: stamp }) - } - return commit({ - ...base, - status: transition(task.status, 'needs_attention'), - needsAttentionReason: `宿主运行终态为 ${String(state)}`, - }) - } - case 'input_required': { - if (task.status !== 'running' && task.status !== 'queued') { - return { applied: false, stale: false, task, reason: `任务 ${task.status} 不接受待补充状态` } - } - return commit({ ...base, status: transition(task.status, 'waiting_input'), waitingReason: String(event.reason ?? '') }) - } - case 'input_supplied': { - if (task.status !== 'waiting_input') return { applied: false, stale: false, task, reason: '任务不在待补充状态' } - return commit({ ...base, status: transition(task.status, 'running'), waitingReason: null }) - } - case 'retry': { - if (task.status !== 'failed' && task.status !== 'cancelled') { - return { applied: false, stale: false, task, reason: '只有失败或已取消的任务可以重试(新任务)' } - } - throw new TaskError('RETRY_REQUIRES_NEW_TASK', '失败/取消后的重试必须创建新任务与新尝试,不能复活旧记录') - } - default: - throw new TaskError('UNKNOWN_EVENT', `未知事件类型: ${String(event.kind)}`) - } -} - -/** 结束时间只写一次:重复到达的终态事件不应改动“最后一次改动时间”。 */ -function applyStamp(task, next, stamp, base) { - const now = { ...base, ...next, updatedAt: stamp } - // completed/failed/cancelled 结束时间只写一次,重复写入会伪造“最后一次改动时间”。 - if (TERMINAL_TASK_STATES.includes(now.status) && now.endedAt === null) now.endedAt = stamp - if (!Number.isFinite(now.revision) || now.revision < 1) now.revision = 1 - else if (now.status !== task.status) now.revision = task.revision + 1 - return now -} - -function stampOf(deps) { - return typeof deps.now === 'function' ? deps.now() : new Date().toISOString() -} - -/** - * activeAttemptId 指向的尝试是否已对账(终态)。 - * 调用方通过 deps.attemptLookup(attemptId) 提供当前 Attempt 记录;core 不直接读 store。 - * unknown 是“待核对宿主”的中间态,不是终态,因此仍然算活动尝试。 - */ -function isSettledAttempt(attemptId, deps) { - const lookup = deps?.attemptLookup - if (typeof lookup !== 'function') return false - const record = lookup(attemptId) - if (record === null || record === undefined || typeof record !== 'object') return false - return isTerminal('attempt', record.state) -} - -// ---------- 便捷包装:每个都只调用 decide,签名简单便于调用方阅读 ---------- - -export function requestInput(task, reason, deps = {}) { - return decide(task, { kind: 'input_required', reason, seq: deps.seq }, deps) -} - -export function supplyInput(task, deps = {}) { - return decide(task, { kind: 'input_supplied', seq: deps.seq }, deps) -} - -export function completeTask(task, input, deps = {}) { - return decide(task, { kind: 'completion', ...input, seq: input?.seq }, deps) -} - -/** 失败必须带原因:没有原因的失败在详情页无法给出恢复入口。 */ -export function failTask(task, reason, deps = {}) { - requireTask(task) - requireString(reason, 'reason') - if (isTerminal('task', task.status)) { - return { applied: false, stale: true, task, reason: '任务已终态' } - } - const stamp = stampOf(deps) - return { - applied: true, - stale: false, - task: { - ...task, - status: transition(task.status, 'failed'), - failureReason: reason, - updatedAt: stamp, - endedAt: task.endedAt ?? stamp, - revision: task.revision + 1, - }, - } -} - -/** 取消是请求,不是结果:这里只落“已取消”的业务结论,宿主的 cancel_requested 另记在 attempt。 */ -export function cancelTask(task, reason = '用户取消', deps = {}) { - requireTask(task) - if (isTerminal('task', task.status)) { - return { applied: false, stale: true, task, reason: '任务已终态' } - } - const stamp = stampOf(deps) - return { - applied: true, - stale: false, - task: { - ...task, - status: transition(task.status, 'cancelled'), - failureReason: task.failureReason ?? null, - cancelReason: reason, - updatedAt: stamp, - endedAt: task.endedAt ?? stamp, - revision: task.revision + 1, - }, - } -} - -/** 把 decide 的结果套到 store 上:只有 applied 才写,避免陈旧事件产生 revision 抖动。 */ -export function applyDecision(store, taskId, decision) { - if (store === undefined || store === null) throw new TaskError('INVALID_STORE', '需要 store') - if (decision === null || typeof decision !== 'object') throw new TaskError('INVALID_DECISION', '判定结果不合法') - if (decision.applied !== true) return decision - const saved = store.updateTask(decision.task) - return { ...decision, task: saved } -} - -/** 任务是否仍在进行(UI 需要区分终态与活动态,但不允许显示百分比)。 */ -export function isOpenTask(task) { - return task !== null && typeof task === 'object' && isState('task', task.status) && !isTerminal('task', task.status) -} diff --git a/workbench/host/contract.mjs b/workbench/host/contract.mjs deleted file mode 100644 index 719784b..0000000 --- a/workbench/host/contract.mjs +++ /dev/null @@ -1,144 +0,0 @@ -// 部门 ↔ 程序的内部操作契约(方案 §6)。 -// -// 四个动作是唯一的“业务事实来源”: -// dispatchTask / reportTaskResult / requestTaskInput / syncDecision -// 部门在会话里怎么说话都不影响账本;账本只认这四条结构化调用。 -// -// 部门在没有自建 HTTP 通道时,用一段可解析的行内指令表达这四个动作: -// 【三省六部】{"action":"reportTaskResult","taskId":"task_…","attemptId":"att_…",…} -// 指令行必须单独成行,前缀固定、正文是单行 JSON。解析器宁可返回 null 也不猜测: -// 解析失败的行当普通文本,绝不用“看起来像”的句子更新任务状态(方案明令禁止)。 -// -// 这里只做“文本 ↔ 结构化调用”的纯转换,不碰网络、不碰 store,便于单测。 - -export const CONTRACT_ACTION_PREFIX = '【三省六部】' - -/** 四个合法动作:多一个少一个都属于“意图不明”,直接拒绝而不是猜。 */ -export const CONTRACT_ACTIONS = Object.freeze([ - 'dispatchTask', - 'reportTaskResult', - 'requestTaskInput', - 'syncDecision', -]) - -const ACTION_SET = new Set(CONTRACT_ACTIONS) - -export class ContractError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'ContractError' - this.code = code - if (details !== undefined) this.details = details - } -} - -/** - * 从一段部门输出里取出全部契约行。 - * - * 返回 { calls, invalid }: - * - calls:解析成功的调用,按出现顺序; - * - invalid:看起来像契约行但 JSON 坏了/缺 action 的行(附原文,便于在 UI 上提示重发)。 - * - * 一个动作只接受一行一条。同一行里塞数组视为格式错误:批量派发必须逐条写, - * 否则“派发到一半失败”无法解释是哪一条。 - */ -export function parseContractLines(text) { - const calls = [] - const invalid = [] - if (typeof text !== 'string' || text === '') return { calls, invalid } - const lines = text.split(/\r?\n/) - for (const raw of lines) { - const line = raw.trim() - if (!line.startsWith(CONTRACT_ACTION_PREFIX)) continue - const body = line.slice(CONTRACT_ACTION_PREFIX.length).trim() - let parsed - try { - parsed = JSON.parse(body) - } catch (error) { - invalid.push({ line: raw, reason: `JSON 解析失败:${error.message}` }) - continue - } - if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) { - invalid.push({ line: raw, reason: '契约正文必须是单个对象' }) - continue - } - if (typeof parsed.action !== 'string' || !ACTION_SET.has(parsed.action)) { - invalid.push({ line: raw, reason: `未知动作:${String(parsed.action)}` }) - continue - } - calls.push({ action: parsed.action, payload: parsed }) - } - return { calls, invalid } -} - -/** 给部门用的指令模板:只描述字段,不塞业务判断,避免模板把“已完成”写成结论。 */ -const TEMPLATES = Object.freeze({ - dispatchTask: { - taskId: 'task_…', - targetRoleId: 'gongbu', - idempotencyKey: '<同一任务同一意图固定不变>', - packet: { objective: '…', acceptance: ['…'], constraints: [], materialRefs: [] }, - }, - reportTaskResult: { - taskId: 'task_…', - attemptId: 'att_…', - reportVersion: 1, - summary: '做了什么、结果是什么', - checks: [{ name: '检查项', ok: true, detail: '证据' }], - artifactRefs: ['art_…'], - }, - requestTaskInput: { - taskId: 'task_…', - attemptId: 'att_…', - reason: '缺什么、为什么必须由用户决定', - }, - syncDecision: { - taskId: 'task_…', - decision: 'approve | reject | retry', - note: '可选说明', - }, -}) - -/** 渲染成可直接贴进部门系统提示的一小段说明。 */ -export function describeContract() { - const lines = [ - `需要走程序的动作,请单独起一行,写作:${CONTRACT_ACTION_PREFIX}{…单行 JSON…}`, - '平台只认下面四个动作,且只认结构化字段——在正文里写“已完成”不会改变任务状态。', - ] - for (const action of CONTRACT_ACTIONS) { - lines.push(`· ${action}:${JSON.stringify(TEMPLATES[action])}`) - } - return lines.join('\n') -} - -/** - * 单条调用的轻量校验(字段存在性与形状)。业务级校验(归属、状态机、幂等)在 service 层, - * 这里只拦“明显没法处理”的调用,让错误尽早、可读地回到部门。 - */ -export function validateContractCall(call) { - const errors = [] - if (call === null || typeof call !== 'object') return ['调用必须是对象'] - if (!ACTION_SET.has(call.action)) errors.push(`未知动作:${String(call.action)}`) - const payload = call.payload ?? {} - if (typeof payload.taskId !== 'string' || payload.taskId.trim() === '') errors.push('缺少 taskId') - switch (call.action) { - case 'dispatchTask': - if (typeof payload.idempotencyKey !== 'string' || payload.idempotencyKey.trim() === '') { - errors.push('dispatchTask 必须带 idempotencyKey(同一意图固定不变)') - } - break - case 'reportTaskResult': - if (typeof payload.attemptId !== 'string' || payload.attemptId.trim() === '') errors.push('reportTaskResult 必须带 attemptId') - if (typeof payload.summary !== 'string' || payload.summary.trim() === '') errors.push('reportTaskResult 必须带非空 summary') - break - case 'requestTaskInput': - if (typeof payload.reason !== 'string' || payload.reason.trim() === '') errors.push('requestTaskInput 必须带 reason') - break - case 'syncDecision': - if (typeof payload.decision !== 'string' || payload.decision.trim() === '') errors.push('syncDecision 必须带 decision') - break - default: - break - } - return errors -} diff --git a/workbench/host/dispatch-service.mjs b/workbench/host/dispatch-service.mjs deleted file mode 100644 index b16fde0..0000000 --- a/workbench/host/dispatch-service.mjs +++ /dev/null @@ -1,211 +0,0 @@ -// DispatchService:把“账本里的一纸派发”变成“部门会话里真实收到的一条消息”。 -// -// 方案 §7.5 的时序在这里落成四段,每一步失败都有明确去向: -// prepared → 选定会话与配置快照 → sending → prompt(requestId=attemptId) -// ├─ 成功 → accepted -// ├─ 宿主明确拒绝 → rejected(任务保留在排队态,可重试,不算业务失败) -// └─ 超时/断线 → unknown(先查证再决定,绝不自动当失败重发) -// -// 幂等的两层:dispatch 行按 (projectId, idempotencyKey) 去重;prompt 按 attemptId 当 requestId。 -// 因此“用户连点两次”与“发送超时后重试”都不会让部门收到两条任务单。 - -import { buildDispatchText } from './session-adapter.mjs' -import { describeContract } from './contract.mjs' - -export const DISPATCH_OUTCOMES = Object.freeze(['accepted', 'rejected', 'unknown']) - -export class DispatchError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'DispatchError' - this.code = code - if (details !== undefined) this.details = details - } -} - -/** - * @param {object} options - * @param {object} options.store WorkbenchStore - * @param {object} options.service 工作台服务 - * @param {object} options.sessions createSessionAdapter 的产物 - * @param {(message: string) => void} [options.log] - * @param {string} [options.clientTimeZone] 派发提示里的时区,默认 Asia/Shanghai - */ -export function createDispatchService(options = {}) { - const { store, service, sessions, log = () => {}, clientTimeZone = 'Asia/Shanghai', - applyModelToSessions = false } = options - if (store === undefined || typeof store.findDispatchByIdempotencyKey !== 'function') { - throw new DispatchError('NO_STORE', 'DispatchService 需要 WorkbenchStore') - } - if (service === undefined || typeof service.dispatchTask !== 'function') { - throw new DispatchError('NO_SERVICE', 'DispatchService 需要工作台服务') - } - if (sessions === undefined || typeof sessions.sendPrompt !== 'function') { - throw new DispatchError('NO_SESSIONS', 'DispatchService 需要会话适配层') - } - - const contractGuide = describeContract() - - /** - * 派发一个已入队任务。返回 { dispatch, attempt, outcome, duplicate }。 - * - * 注意顺序:先写账(dispatch+attempt,同一次事务)再发消息。发送前崩溃只会留下 - * prepared 行,对账器会把它当“未发出”处理;先发后写则会出现“部门已收到但账上没有”。 - */ - async function dispatch(input = {}) { - const projectId = requireText(input.projectId, 'projectId') - const taskId = requireText(input.taskId, 'taskId') - const idempotencyKey = requireText(input.idempotencyKey, 'idempotencyKey') - - // 1) 账务:去重 + 校验 + 落 prepared - const prepared = service.dispatchTask({ - projectId, - taskId, - idempotencyKey, - sourceRoleId: input.sourceRoleId, - targetRoleId: input.targetRoleId, - targetSessionId: input.targetSessionId, - bindingGeneration: input.bindingGeneration, - packet: input.packet, - attemptId: input.attemptId, - }) - const { dispatch, attempt, duplicate } = splitPrepared(prepared) - - if (duplicate) { - // 重复点击:什么都不再做,返回既有结论(含 unknown 的历史要由对账处理)。 - return { dispatch, attempt, outcome: outcomeOf(dispatch), duplicate: true } - } - if ((dispatch.status ?? dispatch.state) === 'accepted') return { dispatch, attempt, outcome: 'accepted', duplicate: false } - - // 2) 发送:先把 dispatch 推到 sending,再动宿主,避免“宿主已收但账上还是 prepared”。 - store.updateDispatch(dispatch.id, { status: 'sending', state: 'sending', sendingAt: new Date().toISOString() }) - - const task = store.getTask(taskId) - const packet = attempt?.contextPacketId === undefined || attempt?.contextPacketId === null - ? null - : store.getContextPacket(attempt.contextPacketId) - const roleName = input.roleName ?? null - - try { - // 3) 固定本轮配置:模型只在发送前覆写一次,运行中改配置不影响这一轮。 - // 默认不碰宿主会话的模型选择:部门模型由政策插件在 agent/request 上按角色覆写, - // 再调 selectModel 既重复,又会让宿主后台把全局默认模型存成本部门的(A06)。 - // 只有显式 applyModelToSessions:true 时才落这一步。 - const snapshot = attempt?.effectiveConfigSnapshot ?? null - if (applyModelToSessions && snapshot !== null && snapshot.provider && snapshot.model) { - await sessions.applyModel({ - sessionId: attempt.sessionId, - provider: snapshot.provider, - model: snapshot.model, - reasoningEffort: snapshot.reasoningEffort ?? undefined, - }) - } - const text = buildDispatchText({ task, packet, contractGuide, roleName }) - const result = await sessions.sendPrompt({ - sessionId: attempt.sessionId, - requestId: attempt.id, - text, - mode: input.mode ?? 'queue', - clientTimeZone, - }) - if (result.accepted !== true) { - markRejected({ dispatch, attempt, reason: '宿主未确认接收' }) - return { dispatch: store.getDispatch(dispatch.id), attempt, outcome: 'rejected', duplicate: false } - } - // 宿主确认接收 = 这一轮真的开始跑:任务与尝试同时进 running。 - // 只改尝试不改任务,运行终态就无处落地(completion 会因任务仍在 queued 而被丢弃)。 - service.startAttempt({ - projectId: dispatch.projectId, - taskId: dispatch.taskId, - attemptId: attempt.id, - hostRunId: null, - }) - markAccepted({ dispatch, attempt }) - return { dispatch: store.getDispatch(dispatch.id), attempt: store.getAttempt(attempt.id), outcome: 'accepted', duplicate: false } - } catch (error) { - const code = error?.code ?? 'unknown' - if (code === 'conflict' || code === 'rejected') { - markRejected({ dispatch, attempt, reason: error?.message ?? String(error) }) - return { dispatch: store.getDispatch(dispatch.id), attempt, outcome: 'rejected', duplicate: false } - } - // 超时、断线、context 丢失:一律 unknown —— 先查证,不重发。 - markUnknown({ dispatch, attempt, reason: code }) - log(`[sansheng-liubo] 派发 ${dispatch.id} 结果未知(${code}):${error?.message ?? error}`) - return { dispatch: store.getDispatch(dispatch.id), attempt, outcome: 'unknown', duplicate: false } - } - } - - /** - * 对 unknown 的派发做查证:问宿主该会话是否有过这次 attempt 的请求。 - * 查不到就保持 unknown(再次对账),查到有 → accepted;宿主明确从未收到 → rejected。 - */ - async function verifyUnknown(dispatchId) { - const dispatch = store.getDispatch(dispatchId) - if (dispatch === undefined) throw new DispatchError('NOT_FOUND', `派发不存在:${dispatchId}`) - if ((dispatch.status ?? dispatch.state) !== 'unknown') return { dispatch, outcome: outcomeOf(dispatch), changed: false } - const attempt = dispatch.attemptId === null ? null : store.getAttempt(dispatch.attemptId) - if (attempt === null) return { dispatch, outcome: 'unknown', changed: false } - const known = await sessions.inspectSession(attempt.sessionId) - if (known === null) return { dispatch, outcome: 'unknown', changed: false } - // 会话存在:宿主已经接受过这条消息(prompt 幂等键会挡住重复投递),按 accepted 收口。 - store.updateDispatch(dispatch.id, { status: 'accepted', state: 'accepted', verifiedAt: new Date().toISOString() }) - if (attempt.state === 'unknown') { - store.updateAttempt(attempt.id, { state: 'running', hostRunId: attempt.hostRunId ?? null }) - } - return { dispatch: store.getDispatch(dispatch.id), outcome: 'accepted', changed: true } - } - - function splitPrepared(result) { - // service.dispatchTask 返回 { dispatch, attempt, task, roleId, duplicate }(形状见 P1 Phase2)。 - if (result === null || typeof result !== 'object' || result.dispatch === undefined) { - throw new DispatchError('BAD_PREPARED', '服务返回的派发结果形状不正确') - } - return { dispatch: result.dispatch, attempt: result.attempt ?? null, duplicate: result.duplicate === true } - } - - function markAccepted({ dispatch, attempt }) { - const stamp = new Date().toISOString() - store.mutate(() => { - store.updateDispatch(dispatch.id, { status: 'accepted', state: 'accepted', acceptedAt: stamp }) - if (attempt !== null && attempt.state === 'queued') { - store.updateAttempt(attempt.id, { state: 'running', startedAt: stamp }) - } - }) - } - - function markRejected({ dispatch, attempt, reason }) { - const stamp = new Date().toISOString() - store.mutate(() => { - store.updateDispatch(dispatch.id, { status: 'rejected', state: 'rejected', rejectedAt: stamp, error: String(reason ?? '') }) - if (attempt !== null && (attempt.state === 'queued' || attempt.state === 'unknown')) { - store.updateAttempt(attempt.id, { state: 'failed', endedAt: stamp, error: String(reason ?? '') }) - } - }) - } - - function markUnknown({ dispatch, attempt, reason }) { - const stamp = new Date().toISOString() - store.mutate(() => { - store.updateDispatch(dispatch.id, { status: 'unknown', state: 'unknown', unknownAt: stamp, error: String(reason ?? '') }) - if (attempt !== null && attempt.state === 'queued') { - store.updateAttempt(attempt.id, { state: 'unknown' }) - } - }) - } - - return Object.freeze({ dispatch, verifyUnknown }) -} - -function outcomeOf(dispatch) { - if ((dispatch.status ?? dispatch.state) === 'accepted') return 'accepted' - if ((dispatch.status ?? dispatch.state) === 'rejected') return 'rejected' - if ((dispatch.status ?? dispatch.state) === 'unknown') return 'unknown' - return 'prepared' -} - -function requireText(value, field) { - if (typeof value !== 'string' || value.trim() === '') { - throw new DispatchError('INVALID_INPUT', `${field} 必须是非空字符串`, { field }) - } - return value -} diff --git a/workbench/host/index.mjs b/workbench/host/index.mjs deleted file mode 100644 index 5fcc048..0000000 --- a/workbench/host/index.mjs +++ /dev/null @@ -1,229 +0,0 @@ -// Host 侧装配:把账本、业务服务、会话层和 HTTP 路由接在一起。 -// -// 这一层是唯一知道“账本文件在哪、损坏了怎么办”的地方: -// - 账本损坏(不是 JSON / schemaVersion 不符)时不崩溃:把坏文件改名留存, -// 从空账本启动,并把 warning 交给调用方(index.js / 诊断页)显示。 -// 悄悄删掉或不说话都会让人以为“历史记录丢了”。 -// - 宿主没有 webServer 时照常返回 service,只是路由不注册,registered=false; -// 若宿主稍后提供了 webServer,用 ctx.inject 补注册一次(不重复建 store)。 -// - 宿主没有 sessionController 时,工作台仍能读写账本(投影可用), -// 但派发只落账不投递,UI 显示“尚未接通”,绝不假装成功。 -// -// 与 workbench-host.mjs 的关系:那边是「账本 + 会话层 + 对账」的纯逻辑外壳, -// 这边负责文件、损坏隔离、HTTP 与生命周期,并把路由钩子接到外壳上。 - -import { existsSync, renameSync } from 'node:fs' -import { WorkbenchStore, SCHEMA_VERSION } from '../core/store.mjs' -import { corruptPathFor, ensureSidecarDir, resolveSidecarDir, resolveStorePath } from './paths.mjs' -import { registerWorkbenchRoutes } from './routes.mjs' -import { createWorkbenchHost as createWorkbenchShell } from './workbench-host.mjs' - -export { createWorkbenchService } from './service.mjs' -export { - createWorkbenchHost as createWorkbenchShell, - CONTRACT_ACTIONS, - CONTRACT_ACTION_PREFIX, - describeContract, - parseContractLines, - WORKBENCH_HOST_VERSION, -} from './workbench-host.mjs' -export { - buildRouteTable, - listWorkbenchRoutes, - registerWorkbenchRoutes, - MAX_BODY_BYTES, - ROUTE_PREFIX, -} from './routes.mjs' -export { - SIDECAR_DIR_NAME, - corruptPathFor, - ensureSidecarDir, - quarantineFile, - readJsonSafe, - resolveSidecarDir, - resolveSidecarFile, - resolveStorePath, - writeFileAtomic, - writeJsonAtomic, -} from './paths.mjs' - -/** - * 创建 Host 侧工作台。 - * - * @param {object|null} ctx 宿主上下文(可为 null:服务仍可用,只是没有路由/会话)。 - * @param {object} [options] - * @param {string} [options.file] 账本路径;默认 %DSH_HOME%/sansheng-liubu/workbench.json。 - * @param {object} [options.env] 计算默认路径用的环境变量。 - * @param {() => number} [options.clock] 注入时钟。 - * @param {() => string} [options.random] 注入随机源(测试里固定 ID 用)。 - * @param {boolean} [options.load=true] 是否从磁盘加载既有账本。 - * @param {string} [options.presetId] 部门会话使用的 agentPreset,默认「上朝」。 - * @param {boolean} [options.startReconciler=true] 是否启动周期对账。 - * @param {number} [options.longPollMs] 事件长轮询上限(毫秒)。 - * @param {number} [options.pollIntervalMs] 长轮询内部检查间隔(毫秒)。 - * @returns {object} 见文件末尾 return 语句的字段说明。 - */ -export function createWorkbenchHost(ctx, options = {}) { - const env = options.env ?? process.env - const clock = options.clock ?? Date.now - const file = options.file === undefined ? resolveStorePath(env) : options.file - const warnings = [] - const log = typeof options.log === 'function' ? options.log : () => {} - - // 测试与嵌入场景可以自带账本;自带时不碰磁盘路径,也不做损坏隔离(那是文件的责任)。 - const injectedStore = options.store ?? null - const store = injectedStore ?? new WorkbenchStore({ - file, - clock, - env, - ...(options.random === undefined ? {} : { random: options.random }), - }) - - if (injectedStore === null && options.load !== false && file !== null && file !== '') { - ensureSidecarDir(env) - if (existsSync(file)) { - try { - store.load() - } catch (error) { - // 损坏与版本不符都是“这个文件不能用”:改名留存后从空账本启动。 - // 绝不覆盖原文件——里面可能是用户唯一一份历史。 - const stamp = new Date(clock()).toISOString().replace(/[:.]/g, '-') - let quarantined = corruptPathFor(file, stamp) - try { - renameSync(file, quarantined) - } catch (renameError) { - // 改名失败(被占用/权限不足):不能继续往同一个文件写,退回纯内存账本。 - quarantined = null - warnings.push( - `账本损坏且无法改名留存(${renameError?.code ?? 'UNKNOWN'}):${error?.message ?? ''};本次使用内存账本`, - ) - } - if (quarantined !== null) { - warnings.push( - `账本损坏(${error?.code ?? 'ERROR'}:${error?.message ?? ''}),已改名留存为 ${quarantined},以空账本启动`, - ) - } - } - } - } - - // 外壳持有 store 与 service,并在宿主有能力时装配会话层/派发/对账。 - const shell = createWorkbenchShell(ctx, { - store, - presetId: options.presetId, - startReconciler: options.startReconciler, - clock, - // 成果文件是否还在,由宿主文件系统回答(A23 失效显示);测试可注入替身。 - fileExists: options.fileExists ?? existsSync, - }) - const service = shell.service - - const hooks = routeHooks(shell, service) - let routes = registerWorkbenchRoutes(ctx, service, { ...options, ...hooks }) - let registered = routes.registered !== false - if (!registered) warnings.push(`工作台接口未注册:${routes.reason ?? '宿主未提供 webServer'}`) - - // 宿主稍后才提供 webServer 时补注册一次;cordis 会在依赖出现时回调, - // 插件卸载时随作用域一起清理,不需要手工跟踪。 - if (!registered && ctx !== null && typeof ctx?.inject === 'function') { - try { - ctx.inject(['webServer'], (scoped) => { - if (registered) return - const late = registerWorkbenchRoutes({ webServer: scoped?.webServer }, service, { ...options, ...hooks }) - if (late.registered === false) return - routes = late - registered = true - }) - } catch (error) { - warnings.push(`工作台接口补注册失败:${error?.message ?? error}`) - } - } - - // 会话层也可能晚到:apply 时 sessionController 还没装好,等它出现再挂载一次, - // 这样用户不必为了「接通部门」而多重启一次 DSH。 - if (shell.hasSessions === false && ctx !== null && typeof ctx?.inject === 'function') { - try { - ctx.inject(['sessionController'], (scoped) => { - if (shell.hasSessions === true) return - const controller = scoped?.sessionController ?? scoped?.remote?.session ?? null - if (controller === null) return - if (!shell.attachSessions(controller)) return - log('[sansheng-liubo] 会话层已就绪,部门可以接通与派发') - }) - } catch (error) { - warnings.push(`会话层补挂失败:${error?.message ?? error}`) - } - } - - shell.start() - - const dispose = () => { - try { - routes() - } finally { - shell.dispose() - } - } - - return { - store, - service, - shell, - routes, - get sessions() { - return shell.sessions - }, - get reconciler() { - return shell.reconciler - }, - get dispatchService() { - return shell.dispatchService - }, - get hasSessions() { - return shell.hasSessions - }, - attachSessions: shell.attachSessions, - presetId: shell.presetId, - connectDepartment: shell.connectDepartment, - dispatchTask: shell.dispatchTask, - ingestAgentOutput: shell.ingestAgentOutput, - file: store.file, - sidecarDir: resolveSidecarDir(env), - get registered() { - return registered - }, - warning: warnings.length === 0 ? null : warnings.join(';'), - warnings, - /** 卸载路由与后台服务(幂等);账本不删除,下次启动继续用。 */ - dispose, - schemaVersion: SCHEMA_VERSION, - } -} - -/** - * 路由钩子:只有宿主真有能力时才接管,否则让路由退回“只落账”的保守路径。 - * 这样“没接通”永远不会被伪装成“已发送”。 - */ -function routeHooks(shell, service) { - return { - connect: (input) => shell.connectDepartment(input), - ingest: (input) => shell.ingestAgentOutput(input), - // 会话层可能晚到,所以钩子恒挂:真挂上了就走派发,没挂上就退回「只落账」, - // 绝不把「没接通」伪装成「已发送」。 - dispatch: (input) => { - if (shell.hasSessions === true) return shell.dispatchTask(input) - return service.dispatchTask({ - projectId: input.projectId, - taskId: input.taskId, - idempotencyKey: input.idempotencyKey, - sourceRoleId: input.sourceRoleId, - targetRoleId: input.targetRoleId, - targetSessionId: input.targetSessionId, - bindingGeneration: input.bindingGeneration, - packet: input.packet, - }) - }, - } -} - -export default createWorkbenchHost diff --git a/workbench/host/paths.mjs b/workbench/host/paths.mjs deleted file mode 100644 index 79ca54b..0000000 --- a/workbench/host/paths.mjs +++ /dev/null @@ -1,118 +0,0 @@ -// 侧车(sidecar)路径与目录:业务账、导出物都放在宿主允许的位置,不进项目目录。 -// 默认 %DSH_HOME%/sansheng-liubu/;没有 DSH_HOME 时退回 ~/.dsh。 -// env 可注入:测试与多实例部署用同一套函数,不读第二份全局配置。 -// -// 原子写在 store 里还有一份(先写 .tmp 再 rename);这里只给 HTTP/导出这类 -// “宿主侧杂项文件”用同一套规则,避免两处对“半截文件”的处理不一致。 - -import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs' -import { homedir } from 'node:os' -import { dirname, join, resolve } from 'node:path' - -export const SIDECAR_DIR_NAME = 'sansheng-liubu' - -/** 侧车目录:DSH_HOME 优先,其次 ~/.dsh;相对路径按当前目录解析,不做猜测。 */ -export function resolveSidecarDir(env = process.env) { - const raw = env && typeof env.DSH_HOME === 'string' ? env.DSH_HOME.trim() : '' - const home = raw === '' ? join(homedir(), '.dsh') : raw - return resolve(home, SIDECAR_DIR_NAME) -} - -/** - * 账本文件路径。DSH_SANSHENG_WORKBENCH_FILE 可整体改写(用于独立测试实例); - * 它必须指向具体文件名,不能只是目录,否则会在目录名上写半截 JSON。 - */ -export function resolveStorePath(env = process.env) { - const override = env && typeof env.DSH_SANSHENG_WORKBENCH_FILE === 'string' - ? env.DSH_SANSHENG_WORKBENCH_FILE.trim() - : '' - if (override !== '') return resolve(override) - return join(resolveSidecarDir(env), 'workbench.json') -} - -/** 派生路径:同一侧车目录下按用途分开,便于用户自己备份或清理而不碰账本。 */ -export function resolveSidecarFile(name, env = process.env) { - if (typeof name !== 'string' || name.trim() === '') throw new Error('name 必须是非空字符串') - if (name.includes('/') || name.includes('\\')) throw new Error('name 只能是一级文件名,不能带目录分隔符') - return join(resolveSidecarDir(env), name) -} - -/** 目录级入口:所有写入前都先建目录,缺目录不该表现为“保存失败”。 */ -export function ensureSidecarDir(env = process.env) { - const dir = resolveSidecarDir(env) - mkdirSync(dir, { recursive: true }) - return dir -} - -/** 损坏文件的改名后缀:.corrupt-<时间戳>,保留现场且不覆盖下一次的结果。 */ -export function corruptPathFor(file, stamp = Date.now()) { - return `${file}.corrupt-${stamp}` -} - -/** - * 把可能损坏的文件挪到一边:返回新路径;文件不存在返回 null(不算错误)。 - * 只改名不删除——损坏的账本里可能有用户唯一的业务记录,删掉就等于替用户做了决定。 - */ -export function quarantineFile(file, stamp = Date.now()) { - if (!existsSync(file)) return null - let target = corruptPathFor(file, stamp) - let attempt = 1 - while (existsSync(target)) { - target = `${corruptPathFor(file, stamp)}-${attempt}` - attempt += 1 - } - renameSync(file, target) - return target -} - -/** - * 原子写文本:同目录 .tmp → rename。 - * Windows 上覆盖 rename 可能因杀软/索引占用失败,退化成“删旧再改名”; - * 最坏情况是目标短暂缺失,而不是留下半截内容。 - */ -export function writeFileAtomic(file, text) { - const target = resolve(file) - mkdirSync(dirname(target), { recursive: true }) - const tmp = `${target}.${process.pid}.${Date.now()}.tmp` - try { - writeFileSync(tmp, String(text), 'utf8') - try { - renameSync(tmp, target) - } catch { - rmSync(target, { force: true }) - renameSync(tmp, target) - } - } finally { - rmSync(tmp, { force: true }) - } - return target -} - -/** - * 原子写 JSON:两空格缩进加尾换行,适合人读与 git diff。 - * 不能序列化的值(BigInt、循环引用)直接抛错,不写一份“看起来写成了”的内容。 - */ -export function writeJsonAtomic(file, value) { - const text = `${JSON.stringify(value, null, 2)}\n` - return writeFileAtomic(file, text) -} - -/** 读 JSON;文件不存在或解析失败都返回 fallback,让调用方决定是否报错。 */ -export function readJsonSafe(file, fallback = null) { - try { - if (!existsSync(file)) return fallback - return JSON.parse(readFileSync(file, 'utf8')) - } catch { - return fallback - } -} - -/** 文件是否可读且非空;用于“成果文件已被删除”这类检查,不做内容解析。 */ -export function fileLooksUsable(file) { - try { - const info = statSync(file) - return info.isFile() && info.size > 0 - } catch { - return false - } -} diff --git a/workbench/host/reconciler.mjs b/workbench/host/reconciler.mjs deleted file mode 100644 index 4f1d9a4..0000000 --- a/workbench/host/reconciler.mjs +++ /dev/null @@ -1,181 +0,0 @@ -// Reconciler:把“部门会话里真实发生了什么”折算成 attempt 的终态。 -// -// 方案 §7.4 的硬约束:宿主运行结束 ≠ 业务完成。所以这里只做“运行终态”的判定, -// 业务完成由 tasks.decide 用(结构化报告 + 运行终态 + 成果引用)三票共同决定。 -// -// 数据来源只有两类可信信号: -// 1. 宿主 follow 事件里的 turn/结束信号(附加 latest.assistant-stream 之外的持久帧); -// 2. 主动查询 controller.list() 里该会话的 running 位。 -// 绝不从聊天文本推断“做完了”。 - -import { classifyHostError } from './session-adapter.mjs' - -export const RECONCILER_DEFAULT_INTERVAL_MS = 30000 -export const RECONCILER_MIN_INTERVAL_MS = 5000 - -/** - * @param {object} options - * @param {object} options.store WorkbenchStore - * @param {object} options.service 工作台服务(reportRunTerminal / markDispatch / syncDecision…) - * @param {object} options.sessions createSessionAdapter 的产物 - * @param {() => number} [options.clock] - * @param {(message: string) => void} [options.log] - */ -export function createReconciler(options = {}) { - const { store, service, sessions, clock = Date.now, log = () => {} } = options - if (store === undefined || typeof store.listOpenAttempts !== 'function') { - throw new Error('createReconciler 需要 WorkbenchStore') - } - if (service === undefined || typeof service.reportRunTerminal !== 'function') { - throw new Error('createReconciler 需要工作台服务') - } - let timer = null - let running = false - - /** - * 单次对账。返回结构化结果供日志与测试断言,不吞异常也不抛出: - * 一个会话查不到不该阻断其它会话的对账。 - */ - async function reconcileOnce() { - if (running) return { skipped: true, reason: 'busy', checked: 0, changed: [] } - running = true - const outcome = { skipped: false, checked: 0, changed: [], errors: [] } - try { - const open = store.listOpenAttempts() - for (const attempt of open) { - outcome.checked += 1 - try { - const change = await reconcileAttempt(attempt) - if (change !== null) outcome.changed.push(change) - } catch (error) { - outcome.errors.push({ attemptId: attempt.id, message: messageOf(error) }) - log(`[sansheng-liubo] 对账 ${attempt.id} 失败:${messageOf(error)}`) - } - } - } finally { - running = false - } - return outcome - } - - /** - * 单个 attempt 的对账: - * - 宿主问不到(null)→ 什么也不改,等下一轮(宁可晚,不可猜); - * - 还在跑 → 只把 queued 推进到 running,不改结论; - * - 已停 → 依 state 决定:cancel_requested 转 cancelled,其余转 succeeded(再交 completion 三票判定)。 - */ - async function reconcileAttempt(attempt) { - const projectId = attempt.projectId - let task = store.getTask(attempt.taskId) - if (task === undefined) return null - const runningFlag = await sessions.isRunning(attempt.sessionId) - if (runningFlag === null) return null - const now = new Date(clock()).toISOString() - - if (runningFlag) { - if (attempt.state === 'queued') { - store.updateAttempt(attempt.id, { state: 'running', hostRunId: attempt.hostRunId ?? null, heartbeatAt: now }) - // 任务要跟着进 running:只有任务处于 running 时,运行终态才能折算成 - // completed / needs_attention / cancelled,否则终态会被状态机丢弃。 - if (task.status === 'queued') { - try { - // service.startAttempt 会同时把任务推进到 running,并把最新任务读回来。 - const started = service.startAttempt({ - projectId, - taskId: task.id, - attemptId: attempt.id, - hostRunId: attempt.hostRunId ?? null, - }) - task = started.task ?? task - } catch (error) { - log(`[sansheng-liubo] 任务 ${task.id} 推进 running 被拒:${messageOf(error)}`) - } - } - return { attemptId: attempt.id, from: 'queued', to: 'running' } - } - return null - } - - // 宿主说会话不跑了:这是“运行终态 = 正常结束”,不是业务完成。 - // 用户点过停止(cancel_requested)的尝试记为 cancelled,不当成成功运行。 - // 用户点过停止:可能是适配器已经写过 cancel_requested,也可能只是刚发出停止请求 - // (cancel() 是同步 accepted,不等于已停)。两种都按取消收口,否则"取消与成功竞争"里 - // 被取消的这一次会被记成成功运行,任务显示已完成。 - const cancelRequested = attempt.state === 'cancel_requested' || sessions.wasCancelRequested(attempt.sessionId) - if (attempt.state === 'running' || attempt.state === 'queued' || cancelRequested) { - const nextState = cancelRequested ? 'cancelled' : 'succeeded' - // running 不能直接到 cancelled:用户请求过停止的,先记 cancel_requested 再收口, - // 状态机与审计都保留"请求过停止"这一步。 - if (nextState === 'cancelled' && attempt.state !== 'cancel_requested') { - store.updateAttempt(attempt.id, { state: 'cancel_requested', cancelRequestedAt: now }) - } - store.updateAttempt(attempt.id, { state: nextState, endedAt: now }) - applyTerminal({ attempt, task, terminal: nextState === 'cancelled' ? 'cancelled' : 'succeeded' }) - return { attemptId: attempt.id, from: attempt.state, to: nextState } - } - return null - } - - function applyTerminal({ attempt, task, terminal }) { - try { - // 任务侧:run_terminal 只是“一票”。没报告时只会变 needs_attention,不会变 completed。 - service.reportRunTerminal({ - projectId: attempt.projectId, - taskId: attempt.taskId, - attemptId: attempt.id, - runTerminal: terminal, - }) - } catch (error) { - // 状态机拒绝重复/乱序终态是正常情况:记一行,不抛出。 - log(`[sansheng-liubo] 任务 ${task.id} 记录运行终态被拒:${messageOf(error)}`) - } - } - - /** 一个会话里出现了新的 assistant 完成回合:作为“可能已结束”的信号触发一次定向对账。 */ - async function onSessionFrame({ sessionId }) { - const open = store.listOpenAttempts().filter((row) => row.sessionId === sessionId) - if (open.length === 0) return { checked: 0 } - for (const attempt of open) { - try { - await reconcileAttempt(attempt) - } catch (error) { - log(`[sansheng-liubo] 帧触发对账失败:${messageOf(error)}`) - } - } - return { checked: open.length } - } - - function start({ intervalMs = RECONCILER_DEFAULT_INTERVAL_MS } = {}) { - if (timer !== null) return - const period = Math.max(RECONCILER_MIN_INTERVAL_MS, Number(intervalMs) || RECONCILER_DEFAULT_INTERVAL_MS) - timer = setInterval(() => { - reconcileOnce().catch((error) => log(`[sansheng-liubo] 周期对账异常:${messageOf(error)}`)) - }, period) - // 宿主退出时不要让定时器把进程吊住。 - if (typeof timer.unref === 'function') timer.unref() - } - - function stop() { - if (timer !== null) { - clearInterval(timer) - timer = null - } - } - - return Object.freeze({ - reconcileOnce, - reconcileAttempt, - onSessionFrame, - start, - stop, - get scheduled() { - return timer !== null - }, - }) -} - -function messageOf(error) { - return error instanceof Error ? error.message : String(error) -} - -export { classifyHostError } diff --git a/workbench/host/routes.mjs b/workbench/host/routes.mjs deleted file mode 100644 index 0541e94..0000000 --- a/workbench/host/routes.mjs +++ /dev/null @@ -1,445 +0,0 @@ -// 工作台 HTTP 路由:把 service 暴露给宿主 Web 服务。 -// -// 设计取舍: -// - 全部 exact 路由,不做前缀匹配:/sansheng/workbench/xxx 未登记的一律 404, -// 不会因为前缀相同就把未知路径交给某个 handler 兜底。 -// - 非 GET 只接受 POST(其余方法 405),未实现的路径 404,参数错误 400,体过大 413。 -// - 统一包装 { ok:true, value } / { ok:false, error:{ code, message, details? } }, -// Content-Type 带 charset、Cache-Control: no-store、Content-Length 手写。 -// - 事件通道用长轮询而不是 SSE:宿主侧只是一个普通 HTTP handler, -// 浏览器刷新/断线重连后靠 since 补齐天然幂等,不需要管连接生命周期; -// 最长挂 25 秒,远低于常见代理/浏览器的空闲超时,也不占住宿主的事件循环。 -// - 任何 ctx.webServer 的缺失都在 registerWorkbenchRoutes 里探测并降级: -// 返回一个 no-op 的 dispose,route 列表照常给出,便于诊断而不至于让插件加载失败。 - -import { ServiceError } from './service.mjs' - -export const ROUTE_PREFIX = '/sansheng/workbench' - -/** 请求体字节上限:契约里最大的是交接材料(摘录 + 引用),256 KB 足够且能挡住误传大文件。 */ -export const MAX_BODY_BYTES = 256 * 1024 - -/** 长轮询最长挂起时间(毫秒)。浏览器重连后靠 since 补齐,所以不需要真正的无限等待。 */ -export const DEFAULT_LONG_POLL_MS = 25_000 - -/** 轮询间隔:太密会白烧 CPU,太疏会让“有新事件立刻返回”的承诺打折。 */ -const POLL_INTERVAL_MS = 1_000 - -/** 业务错误码 → HTTP 状态码。未列出的统一 400。 */ -const STATUS_OF_CODE = Object.freeze({ - INVALID_INPUT: 400, - INVALID_ROLE: 400, - INVALID_STATE: 400, - DISPATCH_INVALID: 400, - ATTEMPT_MISMATCH: 400, - REPORT_INVALID: 400, - NOT_FOUND: 404, - CROSS_PROJECT: 409, - CONFIG_CONFLICT: 409, - SESSION_CONFLICT: 409, - DUPLICATE_PROJECT: 409, - INTERNAL: 500, -}) - -function statusOf(error) { - if (error instanceof ServiceError) return STATUS_OF_CODE[error.code] ?? 400 - if (error !== null && typeof error === 'object' && typeof error.code === 'string') { - return STATUS_OF_CODE[error.code] ?? 400 - } - return 500 -} - -/** 响应写出:统一头 + 手写 Content-Length,HEAD 不写体。 */ -function sendJson(res, status, payload, extraHeaders = undefined) { - const body = JSON.stringify(payload) - const headers = { - 'Content-Type': 'application/json; charset=utf-8', - 'Cache-Control': 'no-store', - 'Content-Length': Buffer.byteLength(body), - ...(extraHeaders ?? {}), - } - res.writeHead(status, headers) - res.end(body) - return body -} - -function sendOk(res, value, extraHeaders) { - return sendJson(res, 200, { ok: true, value }, extraHeaders) -} - -function sendError(res, error) { - const status = statusOf(error) - const code = typeof error?.code === 'string' ? error.code : 'INTERNAL' - const message = status === 500 && !(error instanceof ServiceError) - ? '内部错误' - : (typeof error?.message === 'string' ? error.message : '请求失败') - const payload = { ok: false, error: { code, message } } - if (error?.details !== undefined) payload.error.details = error.details - return sendJson(res, status, payload) -} - -/** - * 读请求体:按字节累计,超限立即拒绝(不再继续读,避免被巨大体拖住)。 - * 空体视为 {},让无参 POST 也能走同一个入口。 - */ -async function readJsonBody(req, limit = MAX_BODY_BYTES) { - const chunks = [] - let total = 0 - for await (const chunk of req) { - const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk) - total += buffer.length - if (total > limit) { - const error = new ServiceError('INVALID_INPUT', `请求体超过 ${limit} 字节上限`, { limit }) - error.httpStatus = 413 - throw error - } - chunks.push(buffer) - } - const text = Buffer.concat(chunks).toString('utf8').trim() - if (text === '') return {} - try { - const parsed = JSON.parse(text) - if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) { - throw new Error('not an object') - } - return parsed - } catch { - const error = new ServiceError('INVALID_INPUT', '请求体必须是 JSON 对象') - error.httpStatus = 400 - throw error - } -} - -async function readBody(req, limit) { - try { - return await readJsonBody(req, limit) - } catch (error) { - // 体超限与 JSON 非法是 HTTP 层语义,借 httpStatus 覆盖默认映射。 - if (typeof error.httpStatus === 'number') { - const wrapped = new ServiceError(error.code, error.message, error.details) - wrapped.httpStatus = error.httpStatus - throw wrapped - } - throw error - } -} - -/** 从 URL 里取查询参数(不依赖宿主框架,纯 node URL)。 */ -function queryOf(url) { - const index = typeof url === 'string' ? url.indexOf('?') : -1 - if (index < 0) return new URLSearchParams('') - const rest = url.slice(index + 1) - const hash = rest.indexOf('#') - return new URLSearchParams(hash < 0 ? rest : rest.slice(0, hash)) -} - -function pathOf(url) { - if (typeof url !== 'string') return '' - const cut = url.search(/[?#]/) - return cut < 0 ? url : url.slice(0, cut) -} - -/** - * 长轮询:最多挂 maxWaitMs,期间每 pollIntervalMs 检查一次是否有新事件; - * 一旦有就立刻返回(不等到窗口结束),没有就等到窗口结束返回空列表 + 当前 seq。 - * 客户端断开(req 触发 close)时立即结束,不留悬挂计时器。 - */ -async function waitForEvents(service, projectId, since, options) { - const maxWaitMs = options.longPollMs ?? DEFAULT_LONG_POLL_MS - const pollIntervalMs = options.pollIntervalMs ?? POLL_INTERVAL_MS - const immediate = service.listEvents(projectId, since, options.eventLimit === undefined ? {} : { limit: options.eventLimit }) - if (immediate.events.length > 0 || immediate.reset) return immediate - const deadline = Date.now() + maxWaitMs - while (Date.now() < deadline) { - const remain = deadline - Date.now() - await sleep(Math.max(1, Math.min(pollIntervalMs, remain))) - const fresh = service.listEvents(projectId, since, options.eventLimit === undefined ? {} : { limit: options.eventLimit }) - if (fresh.events.length > 0 || fresh.reset) return fresh - } - return service.listEvents(projectId, since, options.eventLimit === undefined ? {} : { limit: options.eventLimit }) -} - -function sleep(ms) { - return new Promise((resolve) => { - const timer = setTimeout(resolve, ms) - // 计时器不应阻止进程退出(测试里尤其明显)。 - if (typeof timer.unref === 'function') timer.unref() - }) -} - -/** 统一 handler 包装:方法校验、异常兜底、响应头注入。 */ -function wrap(handler, { methods = ['POST'], allowBody = true, bodyLimit = MAX_BODY_BYTES } = {}) { - return async (req, res) => { - try { - const method = String(req.method ?? 'GET').toUpperCase() - if (!methods.includes(method)) { - res.setHeader('Allow', methods.join(', ')) - sendJson(res, 405, { ok: false, error: { code: 'METHOD_NOT_ALLOWED', message: `仅支持 ${methods.join(', ')}` } }) - return - } - const body = allowBody && method === 'POST' ? await readBody(req, bodyLimit) : {} - const url = req.url ?? '' - const value = await handler({ req, res, body, method, query: queryOf(url), path: pathOf(url) }) - // handler 自己已经写过响应(例如长轮询中途断开)时不再写第二遍。 - if (res.writableEnded === true) return - const headers = value !== null && typeof value === 'object' && value.__headers !== undefined ? value.__headers : undefined - const payload = headers === undefined ? value : value.payload - sendOk(res, payload, headers) - } catch (error) { - if (res.writableEnded === true) return - const status = typeof error?.httpStatus === 'number' ? error.httpStatus : statusOf(error) - const code = typeof error?.code === 'string' ? error.code : 'INTERNAL' - const payload = { ok: false, error: { code, message: error?.message ?? '请求失败' } } - if (error?.details !== undefined) payload.error.details = error.details - sendJson(res, status, payload) - } - } -} - -/** - * 路由表:path → handler 定义。集中声明,便于诊断页一次性列出全部端点。 - * 每个 handler 都从 body/query 取参数并原样交给 service,不在路由层做业务判断。 - */ -export function buildRouteTable(service, options = {}) { - const select = options.projectIdFrom === undefined ? (body) => body.projectId : options.projectIdFrom - return Object.freeze({ - [`${ROUTE_PREFIX}/bootstrap`]: { - method: 'GET', - handler: async ({ query }) => service.bootstrap(query.get('projectId') ?? undefined), - }, - [`${ROUTE_PREFIX}/project`]: { - method: 'POST', - handler: async ({ body }) => service.registerProject({ - hostWorkspaceId: body.hostWorkspaceId, - displayNameCache: body.displayNameCache, - canonicalRoot: body.canonicalRoot, - }), - }, - [`${ROUTE_PREFIX}/bind`]: { - method: 'POST', - handler: async ({ body }) => service.bindDepartmentSession({ - projectId: select(body), - roleId: body.roleId, - sessionId: body.sessionId, - allowReplace: body.allowReplace, - creationRequestId: body.creationRequestId, - }), - }, - [`${ROUTE_PREFIX}/config`]: { - method: 'POST', - handler: async ({ body }) => service.saveDepartmentConfig({ - projectId: select(body), - roleId: body.roleId, - provider: body.provider, - model: body.model, - reasoningEffort: body.reasoningEffort, - expectedRevision: body.expectedRevision, - }), - }, - [`${ROUTE_PREFIX}/task`]: { - method: 'POST', - handler: async ({ body }) => service.createTask({ - projectId: select(body), - title: body.title, - objective: body.objective, - acceptance: body.acceptance, - constraints: body.constraints, - scope: body.scope, - ownerRoleId: body.ownerRoleId, - sourceRoleId: body.sourceRoleId, - originMessageRef: body.originMessageRef, - returnTarget: body.returnTarget, - status: body.status, - }), - }, - [`${ROUTE_PREFIX}/task/cancel`]: { - method: 'POST', - handler: async ({ body }) => service.cancelTask({ - projectId: select(body), - taskId: body.taskId, - reason: body.reason, - }), - }, - [`${ROUTE_PREFIX}/connect`]: { - method: 'POST', - handler: async ({ body }) => { - if (typeof options.connect !== 'function') { - throw new ServiceError('INVALID_STATE', '宿主未提供会话能力,暂时无法接通部门') - } - return options.connect({ - projectId: select(body), - roleId: body.roleId, - sessionId: body.sessionId, - agentPreset: body.agentPreset, - }) - }, - }, - [`${ROUTE_PREFIX}/dispatch`]: { - method: 'POST', - handler: async ({ body }) => { - const ledger = { - projectId: select(body), - taskId: body.taskId, - idempotencyKey: body.idempotencyKey, - sourceRoleId: body.sourceRoleId, - targetRoleId: body.targetRoleId, - targetSessionId: body.targetSessionId, - bindingGeneration: body.bindingGeneration, - packet: body.packet, - } - // 有 Host 会话能力时走 DispatchService:它会真的把任务单送进部门会话, - // 并把 prepared → sending → accepted/rejected/unknown 走完。 - // 没有会话层时只落账(prepared),UI 据此显示“尚未接通”,绝不假装已发送。 - if (typeof options.dispatch === 'function') { - return options.dispatch({ - ...ledger, - sourceSessionId: body.sourceSessionId, - mode: body.mode, - roleName: body.roleName, - }) - } - return service.dispatchTask(ledger) - }, - }, - [`${ROUTE_PREFIX}/ingest`]: { - method: 'POST', - handler: async ({ body }) => { - if (typeof options.ingest !== 'function') { - throw new ServiceError('INVALID_STATE', '宿主未提供契约解析能力') - } - return options.ingest({ - projectId: select(body), - roleId: body.roleId, - text: body.text, - }) - }, - }, - [`${ROUTE_PREFIX}/result`]: { - method: 'POST', - handler: async ({ body }) => service.reportTaskResult({ - projectId: select(body), - taskId: body.taskId, - attemptId: body.attemptId, - report: body.report, - runTerminal: body.runTerminal, - artifactRefs: body.artifactRefs, - checks: body.checks, - remainingItems: body.remainingItems, - blockedReason: body.blockedReason, - sourceMessageRef: body.sourceMessageRef, - reportVersion: body.reportVersion, - }), - }, - [`${ROUTE_PREFIX}/artifact/revision`]: { - method: 'POST', - handler: async ({ body }) => service.requestArtifactRevision({ - projectId: select(body), - artifactId: body.artifactId, - instruction: body.instruction, - ownerRoleId: body.ownerRoleId, - sourceRoleId: body.sourceRoleId, - title: body.title, - acceptance: body.acceptance, - constraints: body.constraints, - status: body.status, - originMessageRef: body.originMessageRef, - returnTarget: body.returnTarget, - }), - }, - [`${ROUTE_PREFIX}/artifact`]: { - method: 'POST', - handler: async ({ body }) => service.registerArtifact({ - projectId: select(body), - taskId: body.taskId, - ownerRoleId: body.ownerRoleId, - fileRef: body.fileRef, - displayName: body.displayName, - mediaType: body.mediaType, - versionOrHash: body.versionOrHash, - verification: body.verification, - sourceResultId: body.sourceResultId, - revisesArtifactId: body.revisesArtifactId, - }), - }, - [`${ROUTE_PREFIX}/events`]: { - method: 'GET', - handler: async ({ query, req, res }) => { - const projectId = query.get('projectId') ?? undefined - const since = Number(query.get('since') ?? 0) - if (query.get('since') !== null && !Number.isFinite(since)) { - throw new ServiceError('INVALID_INPUT', 'since 必须是数字', { field: 'since' }) - } - const immediateOnly = query.get('wait') === '0' - if (immediateOnly || (options.longPollMs ?? DEFAULT_LONG_POLL_MS) <= 0) { - return service.listEvents(projectId, since, { limit: options.eventLimit }) - } - return waitForEvents(service, projectId, since, { - ...options, - // 客户端断开时不再等满窗口:把当前结果写回去(或让外层发现已结束)。 - onAbort: () => { - if (res.writableEnded !== true && res.destroyed !== true) { - sendOk(res, service.listEvents(projectId, since, { limit: options.eventLimit }), { Connection: 'close' }) - } - }, - }) - }, - }, - }) -} - -/** - * 注册路由。宿主没有 webServer(或没有 register)时返回 no-op dispose, - * 并在返回值上标 registered:false,调用方可据此提示“宿主不支持工作台接口”。 - * - * @returns {() => void} dispose:卸载全部已注册路由;重复调用无副作用。 - */ -export function registerWorkbenchRoutes(ctx, service, options = {}) { - const disposes = [] - const server = ctx?.webServer - if (server === undefined || server === null || typeof server.register !== 'function') { - const noop = () => {} - noop.registered = false - noop.reason = '宿主未提供 webServer.register' - return noop - } - const table = buildRouteTable(service, options) - const bodyLimit = options.maxBodyBytes ?? MAX_BODY_BYTES - try { - for (const [path, def] of Object.entries(table)) { - const methods = def.method === 'GET' ? ['GET'] : ['POST'] - const handler = wrap(def.handler, { methods, allowBody: def.method === 'POST', bodyLimit }) - const dispose = server.register({ kind: 'exact', path, handler }) - if (typeof dispose === 'function') disposes.push(dispose) - } - } catch (error) { - // 部分注册失败:先把已注册的回滚,避免留下半套路由(前端会看到一多半 404)。 - for (const dispose of disposes.reverse()) { - try { - dispose() - } catch { - // 卸载失败不影响主流程:宿主要么已卸载,要么进程即将重启。 - } - } - throw error - } - let disposed = false - const dispose = () => { - if (disposed) return - disposed = true - for (const fn of disposes.reverse()) { - try { - fn() - } catch { - // 同上:dispose 必须幂等且不抛。 - } - } - } - dispose.registered = true - dispose.paths = Object.keys(table) - return dispose -} - -/** 供诊断页使用:列出全部端点与其方法。 */ -export function listWorkbenchRoutes() { - return Object.entries(buildRouteTable({ bootstrap: () => null }, {})).map(([path, def]) => ({ path, method: def.method })) -} diff --git a/workbench/host/service.mjs b/workbench/host/service.mjs deleted file mode 100644 index 1aca849..0000000 --- a/workbench/host/service.mjs +++ /dev/null @@ -1,1483 +0,0 @@ -// 工作台业务服务:纯业务,不碰 HTTP、不碰宿主会话 API。 -// -// 三类职责: -// 1. 入口校验(项目隔离):凡是以实体 ID 为参数的调用,先确认项目存在, -// 再确认目标记录属于该项目。伪造 ID 与跨项目引用各自返回确定的错误码, -// 且不泄露“别的项目里有没有这条记录”。 -// 2. 契约操作:registerProject / listSeats / bindDepartmentSession / saveDepartmentConfig / -// createTask / dispatchTask / reportTaskResult / requestTaskInput / syncDecision。 -// 3. 投影:bootstrap 一次拿全(项目列表 + 十席 + 任务 + 成果),UI 只读投影。 -// -// 幂等与状态机全部下沉到 core:store.recordDispatch / store.recordResult 自带去重, -// tasks.decide 负责完成判定。这里只做三件事:组织一次事务、把 core 异常翻成带 code 的业务错误、 -// 保证任何返回值都是副本(调用方改返回值改不到账本)。 - -import { isIdOf } from '../core/ids.mjs' -import { ROLES, isRoleId, layoutGroups } from '../core/roles.mjs' -import { isTerminal } from '../core/states.mjs' -import { - applyDecision, - beginAttempt, - cancelTask as cancelTaskDecision, - createTask as createTaskRecord, - decide, - isOpenTask, - startTask, -} from '../core/tasks.mjs' -import { StoreError } from '../core/store.mjs' - -export const WORKBENCH_SERVICE_VERSION = 1 - -/** 错误码:路由层据此映射 HTTP 状态码,调用方据此分支,永远不解析 message。 */ -export const SERVICE_CODES = Object.freeze({ - INVALID_INPUT: 'INVALID_INPUT', - INVALID_ROLE: 'INVALID_ROLE', - NOT_FOUND: 'NOT_FOUND', - CROSS_PROJECT: 'CROSS_PROJECT', - CONFIG_CONFLICT: 'CONFIG_CONFLICT', - SESSION_CONFLICT: 'SESSION_CONFLICT', - DUPLICATE_PROJECT: 'DUPLICATE_PROJECT', - INVALID_STATE: 'INVALID_STATE', - DISPATCH_INVALID: 'DISPATCH_INVALID', - ATTEMPT_MISMATCH: 'ATTEMPT_MISMATCH', - REPORT_INVALID: 'REPORT_INVALID', - INTERNAL: 'INTERNAL', -}) - -export class ServiceError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'ServiceError' - this.code = code - if (details !== undefined) this.details = details - } -} - -// ---------- 纯工具 ---------- - -function requireText(value, field) { - if (typeof value !== 'string' || value.trim() === '') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `${field} 必须是非空字符串`, { field }) - } - return value -} - -function optionalText(value, field) { - if (value === undefined || value === null) return null - if (typeof value !== 'string') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `${field} 必须是字符串或 null`, { field }) - } - return value -} - -function requireRole(value, field) { - if (!isRoleId(value)) { - throw new ServiceError(SERVICE_CODES.INVALID_ROLE, `${field} 不是已知部门: ${String(value)}`, { field }) - } - return value -} - -function requireBool(value, field) { - if (value === undefined) return false - if (typeof value !== 'boolean') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `${field} 必须是布尔值`, { field }) - } - return value -} - -function optionalArray(value, field) { - if (value === undefined || value === null) return [] - if (!Array.isArray(value)) throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `${field} 必须是数组`, { field }) - return value.map((item) => (typeof item === 'string' ? item : JSON.parse(JSON.stringify(item)))) -} - -/** 深拷贝:对外只给副本,避免调用方拿到账本里的同一个对象。 */ -function copy(value) { - return value === undefined || value === null ? value : JSON.parse(JSON.stringify(value)) -} - -/** store 的 Getter 名 → 实体名(ID 前缀)与集合名(归属校验用)。 */ -const GETTERS = Object.freeze({ - project: { get: 'getProject', entity: 'project', prefix: 'project' }, - task: { get: 'getTask', entity: 'task', prefix: 'task' }, - attempt: { get: 'getAttempt', entity: 'attempt', prefix: 'attempt' }, - dispatch: { get: 'getDispatch', entity: 'dispatch', prefix: 'dispatch' }, - result: { get: 'getResult', entity: 'result', prefix: 'result' }, - artifact: { get: 'getArtifact', entity: 'artifact', prefix: 'artifact' }, -}) - -/** - * 宿主运行终态:只认 成功 / 失败 / 取消 / 仍在跑。 - * 未知字符串一律拒绝——把 "done" 当成功正是方案 §7.3 明令禁止的猜测。 - */ -const RUN_TERMINALS = Object.freeze(['succeeded', 'failed', 'cancelled', 'running']) -function normalizeRunTerminal(value, field = 'runTerminal') { - if (value === undefined || value === null) return null - if (typeof value !== 'string' || !RUN_TERMINALS.includes(value)) { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `${field} 取值非法: ${String(value)}`, { allowed: RUN_TERMINALS }) - } - return value -} - -/** 宿主终态 → attempt 状态。attempt 跟着落,但业务结论只由 tasks.decide 给。 */ -const ATTEMPT_STATE_OF_RUN = Object.freeze({ succeeded: 'succeeded', failed: 'failed', cancelled: 'cancelled' }) - -export function createWorkbenchService(options = {}) { - const { store, clock = Date.now, env = process.env, fileExists = null } = options - if (store === undefined || store === null || typeof store.mutate !== 'function') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, 'createWorkbenchService 需要 WorkbenchStore') - } - - const nowIso = () => new Date(clock()).toISOString() - - // ---------- 异常翻译 ---------- - - /** - * core 的异常统一翻成 ServiceError,保留 code 与 details。 - * CROSS_PROJECT 的 message 改写成不含其他项目 ID 的版本,避免把归属泄露出去。 - */ - function translate(error) { - if (error instanceof ServiceError) return error - if (error instanceof StoreError) { - const details = error.details - switch (error.code) { - case 'CROSS_PROJECT': - return new ServiceError(SERVICE_CODES.CROSS_PROJECT, '引用的记录不属于本项目', details) - case 'NOT_FOUND': - return new ServiceError(SERVICE_CODES.NOT_FOUND, error.message, details) - case 'CAS_CONFLICT': - return new ServiceError(SERVICE_CODES.CONFIG_CONFLICT, error.message, details) - case 'SESSION_CONFLICT': - return new ServiceError(SERVICE_CODES.SESSION_CONFLICT, error.message, details) - case 'DUPLICATE_PROJECT': - return new ServiceError(SERVICE_CODES.DUPLICATE_PROJECT, error.message, details) - case 'INVALID_ROLE': - return new ServiceError(SERVICE_CODES.INVALID_ROLE, error.message, details) - case 'INVALID_INPUT': - return new ServiceError(SERVICE_CODES.INVALID_INPUT, error.message, details) - case 'DUPLICATE_ID': - // ID 由随机源生成却撞了已有记录:属于宿主侧内部故障,不是调用方的错, - // 更不能伪装成"当前状态不接受该操作"。 - return new ServiceError(SERVICE_CODES.INTERNAL, `生成的主键重复(${error.message}),请检查随机源`, { ...details, storeCode: error.code }) - default: - // INVALID_STATE / INVALID_ID / CORRUPT 等:状态机与形状问题, - // 对调用方而言都是“当前数据不接受这个操作”,归到 INVALID_STATE,code 保留在 details。 - return new ServiceError(SERVICE_CODES.INVALID_STATE, error.message, { ...details, storeCode: error.code }) - } - } - // tasks.mjs 的 TaskError:code 语义已经够用,原样带出(INVALID_STATE / ACTIVE_ATTEMPT / CROSS_TASK 等)。 - if (error !== null && typeof error === 'object' && typeof error.code === 'string' && typeof error.message === 'string') { - return new ServiceError(error.code, error.message, error.details) - } - const wrapped = new ServiceError(SERVICE_CODES.INTERNAL, error instanceof Error ? error.message : String(error)) - wrapped.cause = error - return wrapped - } - - /** 包一层:把同步异常翻译成 ServiceError,调用点就不必逐处 try/catch。 */ - function guard(fn) { - return (...args) => { - try { - return fn(...args) - } catch (error) { - throw translate(error) - } - } - } - - // ---------- 项目隔离 ---------- - - /** - * 项目必须存在。不存在与伪造同一个返回:凡不可见的项目都是 NOT_FOUND, - * 调用方无法用它区分“没有这个项目”和“这个项目不属于你”。 - */ - function projectIdOf(input) { - const projectId = input === null || typeof input !== 'object' ? input : input.projectId - if (typeof projectId !== 'string' || !isIdOf('project', projectId)) { - throw new ServiceError(SERVICE_CODES.NOT_FOUND, '项目不存在', { field: 'projectId' }) - } - const project = store.getProject(projectId) - if (project === undefined) throw new ServiceError(SERVICE_CODES.NOT_FOUND, '项目不存在', { field: 'projectId' }) - return project - } - - /** - * 归属校验的公共实现:先验项目,再验 ID 形状,最后验归属。 - * - ID 形状非法或查不到 → NOT_FOUND(伪造/已删不可区分) - * - 查到了但 projectId 不符 → CROSS_PROJECT - * 返回值里不带任何其他项目的字段。 - */ - function ownedRow(project, kind, id, field) { - const spec = GETTERS[kind] - if (typeof id !== 'string' || !isIdOf(spec.prefix, id)) { - throw new ServiceError(SERVICE_CODES.NOT_FOUND, `${field} 不存在`, { field }) - } - const row = store[spec.get](id) - if (row === undefined || row === null) throw new ServiceError(SERVICE_CODES.NOT_FOUND, `${field} 不存在`, { field }) - if (row.projectId !== project.id) { - throw new ServiceError(SERVICE_CODES.CROSS_PROJECT, `${field} 不属于本项目`, { field }) - } - return row - } - - const requireTask = (project, id) => ownedRow(project, 'task', id, 'taskId') - const requireAttempt = (project, id) => ownedRow(project, 'attempt', id, 'attemptId') - - function requireSeat(project, roleId) { - requireRole(roleId, 'roleId') - const binding = store.getBinding(project.id, roleId) - const config = store.getConfig(project.id, roleId) - if (binding === undefined || config === undefined) { - throw new ServiceError(SERVICE_CODES.NOT_FOUND, `项目中缺少 ${roleId} 的席位记录,账本可能未初始化`, { roleId }) - } - // 引用校验要用 bindings.id 这个真实键;角色名不是键。 - // 注意 core 的 store.state.bindings 以 `${projectId}\u0000${roleId}` 为键, - // 所以派发时直接内联绑定对象,不再把 binding.id 透传给 _checkReferences。 - return { binding, config } - } - - // ---------- 项目 ---------- - - /** - * 路径归一:Windows 大小写不敏感、反斜杠与正斜杠等价、末尾分隔符不算差异。 - * 约定用不了真实 canonicalize(junction / 短路径要碰文件系统),所以只做到“字符串级等价”, - * 命中时明确说这是识别到的冲突,而不是宣称已经做了完全隔离。 - */ - function normalizeRoot(path) { - if (typeof path !== 'string' || path.trim() === '') return null - return path.trim().replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase() - } - - /** - * A20:同一目录(含父子目录、junction 指向同一目标)不能登记成两个互不相干的项目。 - * 只识别、不篡改:命中就报明确的 relation,调用方要么换目录,要么显式 allowSharedRoot。 - */ - function rootConflict(self, canonicalRoot) { - const mine = normalizeRoot(canonicalRoot) - if (mine === null) return null - for (const other of store.listProjects()) { - if (other.id === self?.id) continue - const theirs = normalizeRoot(other.canonicalRoot) - if (theirs === null) continue - if (mine === theirs) { - return { relation: 'same', otherProjectId: other.id, otherHostWorkspaceId: other.hostWorkspaceId, otherRoot: other.canonicalRoot } - } - if (mine.startsWith(`${theirs}/`) || theirs.startsWith(`${mine}/`)) { - return { relation: 'nested', otherProjectId: other.id, otherHostWorkspaceId: other.hostWorkspaceId, otherRoot: other.canonicalRoot } - } - } - return null - } - - /** - * 登记项目。同一 hostWorkspaceId 只会得到一个 projectId: - * UI 重复进入同一工作区不该产生两个项目,也不该把已有任务晾在新项目里。 - */ - const registerProject = guard((input = {}) => { - const hostWorkspaceId = requireText(input.hostWorkspaceId, 'hostWorkspaceId') - const displayNameCache = input.displayNameCache === undefined ? '' : String(input.displayNameCache ?? '') - const canonicalRoot = optionalText(input.canonicalRoot, 'canonicalRoot') - const existing = store.listProjects().find((row) => row.hostWorkspaceId === hostWorkspaceId) - // 目录冲突先查:两个工作区挂在同一目录(或父子目录)时,任务与会话会互相串, - // 这不是“用户想要两个项目”,而是登记错误,必须在写账之前拦住。 - const conflict = rootConflict(existing, canonicalRoot) - if (conflict !== null && input.allowSharedRoot !== true) { - throw new ServiceError( - SERVICE_CODES.DUPLICATE_PROJECT, - conflict.relation === 'same' - ? '这个目录已经登记为另一个项目了;同一个目录不会自动隔离' - : '这个目录与已登记的项目是父子关系,两者不会自动隔离', - { ...conflict, hint: 'allowSharedRoot' }, - ) - } - if (existing !== undefined) { - const patch = {} - if (existing.displayNameCache !== displayNameCache) patch.displayNameCache = displayNameCache - if (existing.canonicalRoot !== canonicalRoot) patch.canonicalRoot = canonicalRoot - const project = Object.keys(patch).length > 0 ? store.updateProject(existing.id, patch) : existing - return { project: copy(project), duplicate: true, sharedRoot: conflict } - } - try { - const projectId = store.createProject({ hostWorkspaceId, displayNameCache, canonicalRoot }) - return { project: copy(store.getProject(projectId)), duplicate: false, sharedRoot: conflict } - } catch (error) { - // 两个窗口同时登记:唯一性在 store 内检查,竞态也归成 duplicate。 - if (error instanceof StoreError && error.code === 'DUPLICATE_PROJECT') { - const again = store.listProjects().find((row) => row.hostWorkspaceId === hostWorkspaceId) - if (again !== undefined) return { project: copy(again), duplicate: true, sharedRoot: conflict } - } - throw error - } - }) - - /** 项目列表:只给投影需要的计数,不把其他项目的实体带出来。 */ - function listProjects() { - return store.listProjects().map((project) => { - const tasks = store.listTasks(project.id) - return { - ...copy(project), - seatCount: ROLES.length, - taskCount: tasks.length, - openTaskCount: tasks.filter((task) => isOpenTask(task)).length, - } - }) - } - - function getProject(projectId) { - return copy(projectIdOf({ projectId })) - } - - // ---------- 十席 ---------- - - /** - * 十席布局 + 每席现状。 - * connected=false 即“尚未接通”:没有会话或绑定失效时,UI 不能显示可派工。 - */ - function seatView(project, seat) { - const binding = store.getBinding(project.id, seat.id) - const config = store.getConfig(project.id, seat.id) - const sessionId = binding?.currentSessionId ?? null - const status = binding?.status ?? 'uninitialized' - const connected = sessionId !== null && status !== 'unavailable' - const activeTask = store - .listTasks(project.id) - .filter((task) => task.ownerRoleId === seat.id && isOpenTask(task)) - .sort((left, right) => String(right.updatedAt).localeCompare(String(left.updatedAt)))[0] - return { - roleId: seat.id, - name: seat.name, - short: seat.short, - tier: seat.tier, - group: seat.group, - column: seat.column, - row: seat.row, - duty: seat.duty, - canDispatch: seat.canDispatch === true, - connected, - pending: !connected, - pendingLabel: connected ? null : (status === 'unavailable' ? '绑定失效,需重新接通' : '尚未接通'), - activeTaskId: activeTask?.id ?? null, - binding: { - id: binding?.id ?? null, - currentSessionId: sessionId, - // 生成序号是派发时的护栏:换绑后旧序号失效,旧消息不会被送进新会话。 - bindingGeneration: binding?.bindingGeneration ?? 0, - status, - historyCount: binding?.historySessionRefs?.length ?? 0, - revision: binding?.revision ?? 0, - }, - // 只给 provider/model/effort 名字与修订号,不给任何凭据。 - config: { - provider: config?.providerId ?? null, - model: config?.modelId ?? null, - reasoningEffort: config?.reasoningEffort ?? null, - configRevision: config?.configRevision ?? 0, - configured: Boolean(config?.providerId && config?.modelId), - }, - } - } - - /** 配置的对外视图:provider/model 与账本的 providerId/modelId 只在这一处转换。 */ - function configView(config) { - if (config === undefined || config === null) return null - return { - roleId: config.roleId ?? null, - provider: config.providerId ?? null, - model: config.modelId ?? null, - reasoningEffort: config.reasoningEffort ?? null, - configRevision: config.configRevision ?? 0, - updatedAt: config.updatedAt ?? null, - } - } - - function listSeats(projectId) { - const project = projectIdOf({ projectId }) - return ROLES.map((seat) => seatView(project, seat)) - } - - function layout() { - return layoutGroups() - } - - // ---------- 绑定 ---------- - - /** - * 绑定部门会话。唯一性与“已绑定时是否允许替换”都在 store 里判定, - * 这里只把 SESSION_CONFLICT / CROSS_PROJECT 原样带出(含 code 与 details.heldBy), - * 让 UI 能说清“这个会话正在被谁持有”,而不是笼统的 500。 - */ - const bindDepartmentSession = guard((input = {}) => { - const project = projectIdOf(input) - const roleId = requireRole(input.roleId, 'roleId') - const sessionId = requireText(input.sessionId, 'sessionId') - const allowReplace = requireBool(input.allowReplace, 'allowReplace') - const creationRequestId = optionalText(input.creationRequestId, 'creationRequestId') - try { - const binding = store.bindSession(project.id, roleId, sessionId, { allowReplace, creationRequestId }) - return { binding: copy(binding), seat: seatView(project, ROLES.find((seat) => seat.id === roleId)) } - } catch (error) { - if (error instanceof StoreError && error.code === 'SESSION_CONFLICT') { - // 失败分支不带 seat:绑定没变,别让前端误以为状态已更新。 - throw translate(error) - } - throw translate(error) - } - }) - - /** 解除绑定:旧会话进历史,不删除记录。释放后同一 sessionId 才能绑到别处。 */ - const releaseDepartmentSession = guard((input = {}) => { - const project = projectIdOf(input) - const roleId = requireRole(input.roleId, 'roleId') - requireSeat(project, roleId) - return { binding: copy(store.releaseBinding(project.id, roleId)) } - }) - - /** 部门运行态(uninitialized/idle/queued/running/unavailable),由适配器回执驱动。 */ - const setDepartmentStatus = guard((input = {}) => { - const project = projectIdOf(input) - const roleId = requireRole(input.roleId, 'roleId') - requireSeat(project, roleId) - const status = requireText(input.status, 'status') - return { binding: copy(store.setBindingStatus(project.id, roleId, status)) } - }) - - // ---------- 配置(CAS) ---------- - - /** - * 保存部门模型设置。CAS 冲突必须把“当前值”一起返回, - * 否则 UI 只能提示“保存失败”,用户无从判断是自己过时还是别人改的。 - */ - const saveDepartmentConfig = guard((input = {}) => { - const project = projectIdOf(input) - const roleId = requireRole(input.roleId, 'roleId') - requireSeat(project, roleId) - if (!Number.isInteger(input.expectedRevision)) { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, 'expectedRevision 必须是整数', { field: 'expectedRevision' }) - } - if (input.reasoningEffort !== undefined && input.reasoningEffort !== null - && typeof input.reasoningEffort !== 'string') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, 'reasoningEffort 必须是字符串或 null', { field: 'reasoningEffort' }) - } - try { - const config = store.saveConfig(project.id, roleId, { - provider: input.provider, - model: input.model, - reasoningEffort: input.reasoningEffort ?? null, - }, input.expectedRevision) - // 出参用对外口径(provider/model),不把账本里的 providerId/modelId 漏给 UI: - // 两套命名混用迟早在某处接错。 - return { config: configView(config), configRevision: config.configRevision } - } catch (error) { - if (error instanceof StoreError && error.code === 'CAS_CONFLICT') { - const details = error.details ?? {} - throw new ServiceError(SERVICE_CODES.CONFIG_CONFLICT, '配置已被其他窗口修改,请读回后再保存', { - roleId, - expectedRevision: details.expectedRevision ?? input.expectedRevision, - currentRevision: details.currentRevision ?? null, - current: details.current ?? null, - }) - } - throw error - } - }) - - /** - * 先做不花 ID 的前置校验(角色、状态取值、部门是否接通), - * 再进主流程取 ID。失败时一个 ID 都不该被消耗:ID 是业务主键, - * 让失败请求"吃掉"ID 会让重试与断言都对不上。 - */ - function preflightCreateTask(input) { - if (input === null || typeof input !== 'object') return input - const sourceRoleId = input.sourceRoleId === undefined ? 'lead' : requireRole(input.sourceRoleId, 'sourceRoleId') - const ownerRoleId = requireRole(input.ownerRoleId, 'ownerRoleId') - const wanted = input.status === undefined ? 'queued' : input.status - if (wanted !== 'queued' && wanted !== 'draft') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `新建任务只能是 queued 或 draft,收到 ${String(wanted)}`, { field: 'status' }) - } - if (wanted === 'queued' && typeof input.projectId === 'string' && isIdOf('project', input.projectId)) { - const binding = store.getBinding(input.projectId, ownerRoleId) - if (binding?.currentSessionId === null || binding?.currentSessionId === undefined) { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, `${ownerRoleId} 尚未接通会话,不能直接入队;可先存草稿`, { - roleId: ownerRoleId, - hint: 'draft', - }) - } - } - return input - } - - // ---------- 任务 ---------- - - /** - * 建任务。默认直接入队(queued);status='draft' 时保持草稿。 - * 入队前要求主责部门已接通:派给一个没有会话的部门只会在派发阶段撞 unknown。 - */ - const createTask = guard((input = {}) => { - input = preflightCreateTask(input) - const project = projectIdOf(input) - const ownerRoleId = requireRole(input.ownerRoleId, 'ownerRoleId') - const sourceRoleId = input.sourceRoleId === undefined ? 'lead' : requireRole(input.sourceRoleId, 'sourceRoleId') - const wanted = input.status === undefined ? 'queued' : input.status - if (wanted !== 'queued' && wanted !== 'draft') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `新建任务只能是 queued 或 draft,收到 ${String(wanted)}`, { field: 'status' }) - } - if (wanted === 'queued') { - const binding = store.getBinding(project.id, ownerRoleId) - if (binding?.currentSessionId === null || binding?.currentSessionId === undefined) { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, `${ownerRoleId} 尚未接通会话,不能直接入队;可先存草稿`, { - roleId: ownerRoleId, - hint: 'draft', - }) - } - } - // 先按入队语义校验通过再取 ID:校验失败不该消耗掉一个 ID, - // 否则同一测试里连续建任务的 ID 会与预期错位。 - const record = createTaskRecord({ - projectId: project.id, - title: input.title, - objective: input.objective, - acceptance: optionalArray(input.acceptance, 'acceptance'), - constraints: optionalArray(input.constraints, 'constraints'), - scope: input.scope ?? null, - ownerRoleId, - sourceRoleId, - originMessageRef: optionalText(input.originMessageRef, 'originMessageRef'), - returnTarget: input.returnTarget ?? null, - }, { newTaskId: () => store.ids.task(), now: nowIso }) - const queued = wanted === 'queued' ? startTask(record, { now: nowIso }) : record - return { task: copy(store.insertTask(queued)) } - }) - - function getTask(projectId, taskId) { - const project = projectIdOf({ projectId }) - return copy(requireTask(project, taskId)) - } - - /** 任务列表:附开放标记与尝试/结果计数,UI 不必为每行再发请求。 */ - function listTasks(projectId, filter = {}) { - const project = projectIdOf({ projectId }) - if (filter.ownerRoleId !== undefined) requireRole(filter.ownerRoleId, 'ownerRoleId') - return store - .listTasks(project.id) - .filter((task) => filter.status === undefined || task.status === filter.status) - .filter((task) => filter.ownerRoleId === undefined || task.ownerRoleId === filter.ownerRoleId) - .sort((left, right) => String(right.updatedAt).localeCompare(String(left.updatedAt))) - .map((task) => ({ - ...copy(task), - open: isOpenTask(task), - attemptCount: store.listAttempts(task.id).length, - resultCount: store.listResults(task.id).length, - })) - } - - /** - * 取消任务。业务上立即落 cancelled,但运行的尝试只到 cancel_requested: - * 宿主取消是另一条腿,不能在这里假装已经停了(宿主记录 L6:cancel 不撤回排队消息)。 - */ - const cancelTask = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - const reason = input.reason === undefined ? '用户取消' : requireText(input.reason, 'reason') - const decision = cancelTaskDecision(task, reason, { now: nowIso }) - const applied = applyDecision(store, task.id, decision) - let attempt = null - let cancelRequest = null - const activeId = task.activeAttemptId - if (activeId !== null && activeId !== undefined) { - const current = store.getAttempt(activeId) - if (current !== undefined && current.projectId === project.id && !isTerminal('attempt', current.state)) { - if (current.state === 'queued') { - attempt = store.updateAttempt(current.id, { state: 'cancelled', endedAt: nowIso() }) - } else if (current.state === 'running') { - attempt = store.updateAttempt(current.id, { state: 'cancel_requested', cancelRequestedAt: nowIso() }) - // 交给适配器去调宿主 cancel;这里只声明“该取消哪个运行”。 - cancelRequest = { projectId: project.id, taskId: task.id, attemptId: current.id, hostRunId: current.hostRunId ?? null } - } else { - attempt = current - } - } - } - return { - task: copy(applied.task), - applied: applied.applied === true, - reason: applied.reason ?? null, - attempt: copy(attempt), - cancelRequest, - } - }) - - // ---------- 派发 ---------- - - /** - * dispatchTask:一次事务写三样东西——dispatch(prepared) + contextPacket + attempt(queued)。 - * 三者同生共死,崩溃时不会留下“有派发没尝试”或“有尝试没交接材料”的半条记录。 - * - * 幂等:同一 (projectId, idempotencyKey) 只会有一条 dispatch。 - * 命中时把挂在它上面的 attempt/上下文包一起返回,duplicate=true,不新建任何记录—— - * 派发可能已经投递出去,重写一条等于假装配送了两次。 - */ - const dispatchTask = guard((input = {}) => { - const project = projectIdOf(input) - let task = requireTask(project, input.taskId) - const idempotencyKey = requireText(input.idempotencyKey, 'idempotencyKey') - - const existing = store.findDispatchByIdempotencyKey(project.id, idempotencyKey) - if (existing !== undefined) return dispatchView(existing, true) - - if (isTerminal('task', task.status)) { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, `任务已终态(${task.status}),不能再次派发`, { status: task.status }) - } - if (task.status === 'running') { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, '任务正在执行,派发前需先对账当前尝试', { status: task.status }) - } - const targetRoleId = input.targetRoleId === undefined ? task.ownerRoleId : requireRole(input.targetRoleId, 'targetRoleId') - if (targetRoleId !== task.ownerRoleId) { - throw new ServiceError(SERVICE_CODES.DISPATCH_INVALID, '派发目标必须与任务主责部门一致', { - targetRoleId, - ownerRoleId: task.ownerRoleId, - }) - } - const sourceRoleId = input.sourceRoleId === undefined ? task.sourceRoleId : requireRole(input.sourceRoleId, 'sourceRoleId') - const target = requireSeat(project, targetRoleId) - const sessionId = input.targetSessionId === undefined ? target.binding.currentSessionId : optionalText(input.targetSessionId, 'targetSessionId') - if (sessionId === null || sessionId === undefined) { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, `${targetRoleId} 尚未接通会话,不能派发`, { roleId: targetRoleId }) - } - if (target.binding.currentSessionId !== null && target.binding.currentSessionId !== sessionId) { - // 调用方拿着旧会话号派发:这是换绑后的典型故障,必须显式失败而不是投给新会话。 - throw new ServiceError(SERVICE_CODES.SESSION_CONFLICT, 'targetSessionId 与当前绑定不一致,请重新读取席位后再派发', { - currentSessionId: target.binding.currentSessionId, - }) - } - if (input.bindingGeneration !== undefined && input.bindingGeneration !== target.binding.bindingGeneration) { - throw new ServiceError(SERVICE_CODES.SESSION_CONFLICT, 'bindingGeneration 已变化,派发目标可能已被换绑', { - expected: input.bindingGeneration, - current: target.binding.bindingGeneration, - }) - } - const sourceBinding = store.getBinding(project.id, sourceRoleId) - const sourceSessionId = input.sourceSessionId === undefined - ? sourceBinding?.currentSessionId ?? null - : optionalText(input.sourceSessionId, 'sourceSessionId') - const packet = input.packet === undefined || input.packet === null ? {} : input.packet - if (typeof packet !== 'object' || Array.isArray(packet)) { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, 'packet 必须是对象', { field: 'packet' }) - } - // 修订任务默认把「要改的那份成果 + 版本」带进交接材料: - // 主责部门不需要回头翻记录,也不会改到别的版本上。 - const revisionMaterials = task.scope?.kind === 'artifact-revision' && typeof task.scope.artifactId === 'string' - ? [{ artifactId: task.scope.artifactId, revision: Number(task.scope.revision ?? 1) }] - : [] - - // 派工本身就意味着“开始干”。草稿还停在 draft 时必须先入队: - // beginAttempt 只接受 queued/waiting_input/needs_attention/running,draft 会被拒, - // 而拒绝发生在消息已经发出之后 —— 结果是「部门收到了、账上记 unknown、任务不前进」。 - // 放在所有校验之后、写账之前:校验不过就不该改动任务状态。 - if (task.status === 'draft') { - task = store.updateTask({ ...task, status: 'queued', queuedAt: nowIso() }) - } - - const committed = store.mutate(() => { - const stamp = nowIso() - const attemptId = store.ids.attempt() - const dispatchId = store.ids.dispatch() - const contextPacketId = store.ids.contextPacket() - // 交接材料版本号:同任务内递增,重派不覆盖上一版的验收标准与摘录。 - const version = [...store.state.contextPackets.values()] - .filter((row) => row.taskId === task.id) - .reduce((max, row) => Math.max(max, Number(row.version) || 0), 0) + 1 - - store.insertContextPacket({ - id: contextPacketId, - projectId: project.id, - taskId: task.id, - version, - objective: packet.objective ?? task.objective, - acceptance: packet.acceptance === undefined ? task.acceptance : optionalArray(packet.acceptance, 'packet.acceptance'), - constraints: packet.constraints === undefined ? task.constraints : optionalArray(packet.constraints, 'packet.constraints'), - originMessageRef: packet.originMessageRef ?? task.originMessageRef, - excerpts: optionalArray(packet.excerpts, 'packet.excerpts'), - materialRefs: normalizeMaterialRefs( - packet.materialRefs === undefined ? revisionMaterials : packet.materialRefs, - project, - ), - authorizationRefs: optionalArray(packet.authorizationRefs, 'packet.authorizationRefs'), - scope: packet.scope ?? task.scope, - expectedOutputs: optionalArray(packet.expectedOutputs, 'packet.expectedOutputs'), - returnTarget: packet.returnTarget ?? task.returnTarget ?? { roleId: task.sourceRoleId }, - createdAt: stamp, - }) - - // 注意顺序:dispatches 的引用表会校验 attemptId 与 contextPacketId, - // 所以必须先有 attempt 与上下文包,再写派发;否则 recordDispatch 会报“引用不存在”。 - store.insertAttempt({ - id: attemptId, - projectId: project.id, - taskId: task.id, - dispatchId: null, - // 不传 bindingId:core 的 bindings 表以 projectId+roleId 复合键存放,binding.id 不是键。 - // 席位归属已由 requireSeat(project, targetRoleId) 保证。 - sessionId, - hostRunId: null, - state: 'queued', - // 派发时把模型设置快照下来:之后改配置不影响这一次运行。 - effectiveConfigSnapshot: { - provider: target.config.providerId, - model: target.config.modelId, - reasoningEffort: target.config.reasoningEffort ?? null, - configRevision: target.config.configRevision, - }, - error: null, - createdAt: stamp, - startedAt: null, - endedAt: null, - }) - - const recorded = store.recordDispatch({ - projectId: project.id, - taskId: task.id, - attemptId, - sourceSessionId, - targetSessionId: sessionId, - // 同上:席位归属由 requireSeat 保证,这里只记换绑护栏用的 generation。 - bindingGeneration: target.binding.bindingGeneration, - contextPacketId, - idempotencyKey, - status: 'prepared', - }) - // attempt 先插、派发后写:这里把 dispatchId 补回尝试,两表互指成立。 - store.updateAttempt(attemptId, { dispatchId: recorded.dispatch.id }) - return recorded.dispatch.id - }) - - return dispatchView(store.getDispatch(committed.value), false) - }) - - /** 把一条 dispatch 连同挂在它上面的尝试、上下文包、任务一起投影。 */ - function dispatchView(dispatch, duplicate) { - const attempt = dispatch.attemptId === null ? null : store.getAttempt(dispatch.attemptId) - const packet = dispatch.contextPacketId === null ? null : store.getContextPacket(dispatch.contextPacketId) - const task = dispatch.taskId === null ? null : store.getTask(dispatch.taskId) - return { - dispatch: copy(dispatch), - attempt: copy(attempt ?? null), - contextPacket: copy(packet ?? null), - task: copy(task ?? null), - duplicate, - } - } - - /** 派发状态推进(由适配器拿宿主回执驱动):走 store 的状态机,不接受跳跃。 */ - const markDispatch = guard((input = {}) => { - const project = projectIdOf(input) - const dispatch = ownedRow(project, 'dispatch', input.dispatchId, 'dispatchId') - const patch = {} - if (input.status !== undefined) patch.status = input.status - if (input.hostMessageId !== undefined) patch.hostMessageId = optionalText(input.hostMessageId, 'hostMessageId') - return { dispatch: copy(store.updateDispatch(dispatch.id, patch)) } - }) - - // ---------- 结果 ---------- - - /** - * 登记尝试推进(适配器在宿主侧拿到 runId/开跑回执后调用)。 - * 用 core 的 beginAttempt:任务进入 running 且 activeAttemptId 指向这次尝试。 - */ - const startAttempt = guard((input = {}) => { - const project = projectIdOf(input) - // taskId 可省:Attempt 自己知道属于哪个任务。传入时必须与它对上, - // 免得 UI 拿错 ID 把别的任务推进 running。 - const attempt = requireAttempt(project, input.attemptId) - const task = requireTask(project, input.taskId ?? attempt.taskId) - if (attempt.taskId !== task.id) { - throw new ServiceError(SERVICE_CODES.ATTEMPT_MISMATCH, '尝试不属于该任务', { attemptId: attempt.id }) - } - const hostRunId = optionalText(input.hostRunId, 'hostRunId') - let next = attempt - if (attempt.state === 'queued') { - next = store.updateAttempt(attempt.id, { state: 'running', hostRunId, startedAt: nowIso() }) - } else if (hostRunId !== null && attempt.hostRunId !== hostRunId) { - next = store.updateAttempt(attempt.id, { hostRunId }) - } - // core 的 beginAttempt 只计算新对象不写库,所以这里显式落库: - // 成功即“任务进入 running 且 activeAttemptId 指向这次尝试”。 - // 只把 Attempt 推到 running 是不够的:任务的 run_terminal 判定要求它当时处于 running, - // 否则"运行结束但无报告"会被当成"还在排队",needs_attention 永远落不下来。 - // core 的 beginAttempt 在任务仍为 queued 时会连同任务一起推进到 running。 - const decision = beginAttempt(task, next, { now: nowIso, attemptLookup: (id) => store.getAttempt(id) }) - const persisted = store.updateTask(decision) - return { task: copy(persisted), attempt: copy(store.getAttempt(attempt.id)), applied: true, reason: null } - }) - - /** - * reportTaskResult:登记结构化结果 + 完成判定,一次事务内完成。 - * - * 去重先于一切写入:同一 (attemptId, reportVersion) 或同一条 sourceMessageRef - * 只登记一次,命中时返回旧结果且 applied=false,不重跑判定、不动 revision。 - * - * 判定交给 core/tasks.decide(kind:'completion'),服务层实际落地四种结果: - * 1. completed —— 报告可信 + 宿主终态 succeeded + 成果引用有效; - * 2. needs_attention—— 宿主终态 succeeded 但报告不可信(含标记了阻塞原因); - * 3. 保持不变(applied:false) —— 报告可信但宿主还没结束(candidate),等终态再定, - * 此处把报告登记进账,任务停在 running/queued,不显示已完成; - * 4. 等待结构化报告 —— 报告先到、终态后到的顺序由 reportRunTerminal 补齐。 - * 任务已终态时迟到报告只登记、不改结论(stale)。 - */ - const reportTaskResult = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - const attempt = requireAttempt(project, input.attemptId) - if (attempt.taskId !== task.id) { - throw new ServiceError(SERVICE_CODES.ATTEMPT_MISMATCH, '尝试不属于该任务', { attemptId: attempt.id }) - } - const report = input.report - if (report === null || typeof report !== 'object' || Array.isArray(report)) { - throw new ServiceError(SERVICE_CODES.REPORT_INVALID, 'report 必须是对象', { field: 'report' }) - } - const summary = requireText(report.summary, 'report.summary') - const runTerminal = normalizeRunTerminal(input.runTerminal ?? report.runTerminal) - const artifactRefs = optionalArray(input.artifactRefs ?? report.artifactRefs, 'artifactRefs') - // 成果引用必须指向本项目现存成果:账上查不到就是伪造或已删,直接拒绝,不记空引用。 - for (const ref of artifactRefs) { - ownedRow(project, 'artifact', ref, 'artifactRefs') - } - const sourceMessageRef = optionalText(input.sourceMessageRef, 'sourceMessageRef') - const reportVersion = input.reportVersion === undefined ? 1 : input.reportVersion - if (!Number.isInteger(reportVersion) || reportVersion < 1) { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, 'reportVersion 必须是正整数', { field: 'reportVersion' }) - } - const blockedReason = typeof input.blockedReason === 'string' && input.blockedReason.trim() !== '' - ? input.blockedReason - : (typeof report.blockedReason === 'string' && report.blockedReason.trim() !== '' ? report.blockedReason : null) - - const duplicateRow = findResult(project.id, attempt.id, reportVersion, sourceMessageRef) - if (duplicateRow !== undefined) { - return { - result: copy(duplicateRow), - duplicate: true, - task: copy(store.getTask(task.id)), - decision: { applied: false, duplicate: true, reason: '结果已登记,重复事件不重新判定' }, - } - } - - const recorded = store.recordResult({ - projectId: project.id, - taskId: task.id, - attemptId: attempt.id, - reportVersion, - summary, - artifactRefs, - checks: optionalArray(input.checks ?? report.checks, 'checks'), - remainingItems: optionalArray(input.remainingItems ?? report.remainingItems, 'remainingItems'), - blockedReason, - sourceMessageRef, - }) - if (recorded.duplicate) { - return { - result: copy(recorded.result), - duplicate: true, - task: copy(store.getTask(task.id)), - decision: { applied: false, duplicate: true, reason: '结果已登记' }, - } - } - - if (isTerminal('task', task.status)) { - return { - result: copy(recorded.result), - duplicate: false, - task: copy(store.getTask(task.id)), - decision: { applied: false, stale: true, reason: `任务已终态(${task.status}),迟到报告只登记不判定` }, - } - } - - // 尝试对齐:报告意味着运行已经开始;宿主给了终态就同步落 attempt,但业务结论仍看 decide。 - let liveAttempt = attempt - if (liveAttempt.state === 'queued') { - liveAttempt = store.updateAttempt(attempt.id, { state: 'running', startedAt: nowIso() }) - } - if (runTerminal !== null && ATTEMPT_STATE_OF_RUN[runTerminal] !== undefined - && !isTerminal('attempt', liveAttempt.state) && liveAttempt.state !== 'cancel_requested') { - liveAttempt = store.updateAttempt(attempt.id, { state: ATTEMPT_STATE_OF_RUN[runTerminal], endedAt: nowIso() }) - } - - const reportForJudge = { - taskId: task.id, - attemptId: attempt.id, - summary, - artifactRefs, - checks: optionalArray(input.checks ?? report.checks, 'checks'), - ...(blockedReason === null ? {} : { blockedReason }), - } - const judged = store.mutate(() => { - const fresh = store.getTask(task.id) - // 运行还没结束:走 core 的“报告先到”分支,只登记报告时间(候选),任务保持原状态。 - // 不能走 completion 判定——那会把“还没跑完”误判成 needs_attention,等于替宿主宣布结束。 - if (runTerminal === null || runTerminal === 'running') { - const pending = decide(fresh, { kind: 'report', report: reportForJudge }, { now: nowIso }) - if (pending.applied === true) store.updateTask(pending.task) - const summary = summarize(pending) - return { - task: store.getTask(task.id), - summary: { ...summary, reason: summary.reason ?? '报告已登记为候选,等待宿主运行结束' }, - } - } - const decision = decide(fresh, { - kind: 'completion', - report: reportForJudge, - runTerminal, - artifactRefs, - artifactLookup: (ref) => store.getArtifact(ref), - }, { now: nowIso }) - if (decision.applied === true) { - const applied = applyDecision(store, task.id, decision) - return { task: applied.task, summary: summarize(applied) } - } - return { task: fresh, summary: summarize(decision) } - }) - - return { - result: copy(recorded.result), - duplicate: false, - task: copy(judged.value.task), - attempt: copy(liveAttempt), - decision: judged.value.summary, - } - }) - - function findResult(projectId, attemptId, reportVersion, sourceMessageRef) { - return store.listResults(undefined) - .filter((row) => row.projectId === projectId && row.attemptId === attemptId) - .find((row) => row.reportVersion === reportVersion - || (sourceMessageRef !== null && row.sourceMessageRef === sourceMessageRef)) - } - - /** 判定摘要:UI 与日志只读这几项,不解析整条任务。 */ - function summarize(decision) { - const verify = decision.verdict ?? null - return { - applied: decision.applied === true, - stale: decision.stale === true, - status: decision.task?.status ?? null, - reason: decision.reason ?? null, - blockers: verify?.blockers ?? (decision.applied === true ? [] : (decision.reason === undefined ? [] : [decision.reason])), - // 三条完成条件各自的结论,UI 可逐条显示为什么还没完成。 - verdict: verify === null ? null : { reportOk: verify.reportOk, runOk: verify.runOk, refsValid: verify.refsValid, ok: verify.ok }, - } - } - - /** - * 宿主终态单独到达(结果先到、终态后到)。只有“报告已到 + running”才会在这里完成; - * 其余按 core 的 run_terminal 分支落 needs_attention 或保持不变。 - */ - const reportRunTerminal = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - if (isTerminal('task', task.status)) { - // 任务已有结论(取消/完成/失败):迟到的宿主回执只能核对尝试,不能改判。 - return { task: copy(task), attempt: null, decision: { applied: false, stale: true, status: task.status, reason: '任务已终态' } } - } - const runTerminal = normalizeRunTerminal(input.runTerminal) - if (runTerminal === null || runTerminal === 'running') { - return { task: copy(task), attempt: null, decision: { applied: false, status: task.status, reason: '尚未到终态' } } - } - let attempt = null - const attemptId = input.attemptId === undefined ? task.activeAttemptId : input.attemptId - if (attemptId !== null && attemptId !== undefined) { - attempt = requireAttempt(project, attemptId) - if (!isTerminal('attempt', attempt.state) && attempt.state !== 'cancel_requested' - && ATTEMPT_STATE_OF_RUN[runTerminal] !== undefined) { - attempt = store.updateAttempt(attempt.id, { state: ATTEMPT_STATE_OF_RUN[runTerminal], endedAt: nowIso() }) - } - } - const judged = store.mutate(() => { - const fresh = store.getTask(task.id) - if (runTerminal === 'running') { - // 报告正文已在 reportTaskResult 里登记,这里只需确认“仍在跑”这一事实。 - return { task: fresh, summary: { applied: false, stale: false, status: fresh.status, reason: '尚未到终态' } } - } - // 运行已结束、任务却还停在 queued(适配器没来得及推进):先补一次 running, - // 否则 completion 会被状态机丢弃,任务卡在排队态,日志与 UI 都会说谎。 - let live = fresh - if (live.status === 'queued') { - live = store.updateTask({ ...live, status: 'running', startedAt: nowIso() }) - } - if (isTerminal('task', live.status)) { - return { task: live, summary: { applied: false, stale: true, status: live.status, reason: '任务已终态' } } - } - const report = input.report ?? latestReport(project, live, attempt?.id ?? null) - const vote = (event) => decide(live, event, { now: nowIso }) - let decision - if (report !== null) { - // 报告已在账本里:按三条完成条件整体判一次(报告+终态成功+成果有效才 completed)。 - decision = vote({ - kind: 'completion', - report, - runTerminal, - artifactRefs: report.artifactRefs ?? [], - artifactLookup: (ref) => store.getArtifact(ref), - }) - } else { - // 没收到报告、宿主却已正常结束:按"成功但无报告"记完成判定 → needs_attention - // (宿主跑完不等于业务完成,不能判 completed);failed / cancelled 各有归宿。 - // 用 report: null 明确表达"确实没有报告",不靠缺省字段碰运气。 - decision = vote({ - kind: 'completion', - report: null, - runTerminal, - artifactRefs: [], - artifactLookup: (ref) => store.getArtifact(ref), - }) - } - if (decision.applied === true) { - const applied = applyDecision(store, task.id, decision) - return { task: applied.task, summary: summarize(applied) } - } - return { task: live, summary: summarize(decision) } - }) - return { task: copy(judged.value.task), attempt: copy(attempt), decision: judged.value.summary } - }) - - // ---------- 待补充 / 同步决定 ---------- - - /** requestTaskInput:明确缺什么就进入 waiting_input,只等用户补充,不广播其他部门。 */ - const requestTaskInput = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - const reason = requireText(input.reason, 'reason') - const missingItems = optionalArray(input.missingItems, 'missingItems') - const judged = store.mutate(() => { - const fresh = store.getTask(task.id) - const decision = decide(fresh, { - kind: 'input_required', - reason, - payload: { missingItems, scope: input.scope ?? null }, - }, { now: nowIso }) - if (decision.applied === true) { - const applied = applyDecision(store, task.id, decision) - return { task: applied.task, summary: summarize(applied) } - } - return { task: fresh, summary: summarize(decision) } - }) - return { - task: copy(judged.value.task), - applied: judged.value.summary.applied, - reason: judged.value.summary.reason, - missingItems, - } - }) - - /** supplyTaskInput:用户补齐后回到原任务,不扩大范围、不新建任务。 */ - const supplyTaskInput = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - const judged = store.mutate(() => { - const fresh = store.getTask(task.id) - const decision = decide(fresh, { kind: 'input_supplied' }, { now: nowIso }) - if (decision.applied === true) { - const applied = applyDecision(store, task.id, decision) - return { task: applied.task, summary: summarize(applied) } - } - return { task: fresh, summary: summarize(decision) } - }) - return { task: copy(judged.value.task), applied: judged.value.summary.applied, reason: judged.value.summary.reason } - }) - - /** 取出该任务最近一次登记的结构化报告;没有就返回 null(由完成判定判成 needs_attention)。 */ - function latestReport(project, task, attemptId) { - const rows = store.listResults(task.id).filter((row) => row.taskId === task.id - && (attemptId === null || row.attemptId === attemptId)) - if (rows.length === 0) return null - const last = rows.reduce((max, row) => (Number(row.reportVersion) >= Number(max.reportVersion) ? row : max), rows[0]) - // taskId / attemptId 必须一起带上:core 的 validateReport 把它们当作报告可信度的一部分, - // 少一个就会判成“缺少 attemptId”,完成判定直接掉进 needs_attention。 - return { - taskId: last.taskId, - attemptId: last.attemptId, - summary: last.summary, - checks: last.checks ?? [], - blockedReason: last.blockedReason ?? null, - artifactRefs: last.artifactRefs ?? [], - } - } - - /** - * syncDecision:把用户在某条会话里明确同意/否决的决定,定向同步给指定任务或丞相。 - * 最小实现:只登记一条带来源与选中片段的事件,不解析整段聊天、不广播给十席。 - */ - const syncDecision = guard((input = {}) => { - const project = projectIdOf(input) - const content = requireText(input.content, 'content') - const sourceSessionId = optionalText(input.sourceSessionId, 'sourceSessionId') - const roleId = input.roleId === undefined ? 'lead' : requireRole(input.roleId, 'roleId') - const task = input.taskId === undefined || input.taskId === null ? null : requireTask(project, input.taskId) - const event = store.appendEvent({ - type: 'decision.synced', - projectId: project.id, - roleId, - taskId: task?.id ?? null, - payload: { content, sourceSessionId, scope: input.scope ?? null, taskId: task?.id ?? null }, - }) - return { event: copy(event), task: copy(task), roleId } - }) - - // ---------- 成果 ---------- - - /** - * A23:成果文件被删/移走后,界面要显示「失效」而不是照旧显示可打开。 - * 这里不读文件内容、不改账本,只在投影时按注入的 fileExists 探一次。 - * 探不了(没接文件系统、fileRef 不是本地路径)就是 unknown,绝不猜成 ok。 - */ - function artifactView(artifact) { - if (artifact === null || artifact === undefined) return null - const path = typeof artifact.fileRef === 'string' && artifact.fileRef.trim() !== '' ? artifact.fileRef.trim() : null - let existence = 'unknown' - if (path !== null && typeof fileExists === 'function') { - try { - existence = fileExists(path) ? 'ok' : 'missing' - } catch { - existence = 'unknown' - } - } - return { ...copy(artifact), existence } - } - - /** - * 交接材料引用(A09):两种可追溯形态,别的一律拒绝。 - * - 字符串:历史数据里的自由文本引用,原样保留 - * - {artifactId}:必须是本项目的成果;版本缺省取该成果当前版本,显式给了就按给的记 - * - {attachmentId}:附件的宿主侧 ID,允许带 name/mime/size 供阅读 - * 显式拒绝跨项目成果引用:交接材料不能成为越权读取的通道。 - */ - function normalizeMaterialRefs(value, project) { - const list = optionalArray(value, 'packet.materialRefs') - return list.map((ref, index) => { - if (typeof ref === 'string') { - if (ref.trim() === '') throw new ServiceError(SERVICE_CODES.INVALID_INPUT, '材料引用不能是空字符串', { field: `materialRefs[${index}]` }) - return ref - } - if (ref === null || typeof ref !== 'object' || Array.isArray(ref)) { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, '材料引用必须是字符串或 {artifactId} / {attachmentId} 对象', { - field: `materialRefs[${index}]`, - }) - } - if (typeof ref.artifactId === 'string' && ref.artifactId !== '') { - const artifact = store.getArtifact(ref.artifactId) - if (artifact === undefined) { - throw new ServiceError(SERVICE_CODES.NOT_FOUND, '材料引用指向的成果不存在', { field: `materialRefs[${index}]` }) - } - if (artifact.projectId !== project.id) { - throw new ServiceError(SERVICE_CODES.CROSS_PROJECT, '材料引用指向的成果属于别的项目', { - field: `materialRefs[${index}]`, - }) - } - const revision = Number.isInteger(ref.revision) && ref.revision > 0 ? ref.revision : Number(artifact.revision ?? 1) - const out = { artifactId: artifact.id, revision } - // 名字只是给人读的,默认取成果自己的显示名;显式给了就以调用方为准。 - const title = typeof ref.title === 'string' && ref.title !== '' - ? ref.title - : (typeof artifact.displayName === 'string' && artifact.displayName !== '' ? artifact.displayName : '') - if (title !== '') out.title = title - return out - } - if (typeof ref.attachmentId === 'string' && ref.attachmentId !== '') { - const out = { attachmentId: ref.attachmentId } - if (typeof ref.name === 'string' && ref.name !== '') out.name = ref.name - if (typeof ref.mime === 'string' && ref.mime !== '') out.mime = ref.mime - if (Number.isInteger(ref.size) && ref.size > 0) out.size = ref.size - return out - } - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, '材料引用缺少 artifactId 或 attachmentId', { - field: `materialRefs[${index}]`, - }) - }) - } - - /** 登记成果引用:只记引用与校验结论,不复制文件内容,也不改文件本体。 */ - const registerArtifact = guard((input = {}) => { - const project = projectIdOf(input) - const task = requireTask(project, input.taskId) - const ownerRoleId = input.ownerRoleId === undefined ? task.ownerRoleId : requireRole(input.ownerRoleId, 'ownerRoleId') - const sourceResultId = input.sourceResultId === undefined || input.sourceResultId === null - ? null - : ownedRow(project, 'result', input.sourceResultId, 'sourceResultId').id - // 修订链:只有指向本项目既有成果才认,跨项目一律 CROSS_PROJECT。 - const revisesArtifactId = input.revisesArtifactId === undefined || input.revisesArtifactId === null - ? null - : ownedRow(project, 'artifact', input.revisesArtifactId, 'revisesArtifactId').id - const previous = revisesArtifactId === null ? null : store.getArtifact(revisesArtifactId) - const artifact = store.recordArtifact({ - projectId: project.id, - taskId: task.id, - ownerRoleId, - fileRef: optionalText(input.fileRef, 'fileRef'), - displayName: input.displayName === undefined ? '' : String(input.displayName), - mediaType: input.mediaType === undefined ? 'application/octet-stream' : String(input.mediaType), - versionOrHash: optionalText(input.versionOrHash, 'versionOrHash'), - verification: input.verification ?? { status: 'unverified' }, - sourceResultId, - revisesArtifactId, - revision: previous === null ? 1 : Number(previous.revision ?? 1) + 1, - revisionOfTaskId: previous === null ? null : (previous.revisionOfTaskId ?? previous.taskId ?? null), - }) - return { artifact: artifactView(artifact) } - }) - - /** - * 成果修订(方案路径 B):在成果区点“找主责部门修改”,只开一条修订任务给原主责部门, - * 不重跑整套三省。任务把原成果与版本写进 scope,派发时自动进交接材料。 - */ - const requestArtifactRevision = guard((input = {}) => { - const project = projectIdOf(input) - const artifact = ownedRow(project, 'artifact', input.artifactId, 'artifactId') - const instruction = requireText(input.instruction, 'instruction') - const ownerRoleId = input.ownerRoleId === undefined ? artifact.ownerRoleId : requireRole(input.ownerRoleId, 'ownerRoleId') - const sourceRoleId = input.sourceRoleId === undefined ? 'lead' : requireRole(input.sourceRoleId, 'sourceRoleId') - const wanted = input.status === undefined ? 'draft' : input.status - if (wanted !== 'queued' && wanted !== 'draft') { - throw new ServiceError(SERVICE_CODES.INVALID_INPUT, `修订任务只能是 queued 或 draft,收到 ${String(wanted)}`, { field: 'status' }) - } - if (wanted === 'queued') { - const binding = store.getBinding(project.id, ownerRoleId) - if (binding?.currentSessionId === null || binding?.currentSessionId === undefined) { - throw new ServiceError(SERVICE_CODES.INVALID_STATE, `${ownerRoleId} 尚未接通会话,不能直接入队;可先存草稿`, { - roleId: ownerRoleId, - hint: 'draft', - }) - } - } - const record = createTaskRecord({ - projectId: project.id, - title: input.title === undefined ? `修改成果:${artifact.displayName || artifact.id}` : String(input.title), - objective: instruction, - acceptance: optionalArray(input.acceptance, 'acceptance'), - constraints: optionalArray(input.constraints, 'constraints'), - scope: { - kind: 'artifact-revision', - artifactId: artifact.id, - revision: Number(artifact.revision ?? 1), - sourceTaskId: artifact.taskId ?? null, - }, - ownerRoleId, - sourceRoleId, - originMessageRef: optionalText(input.originMessageRef, 'originMessageRef'), - returnTarget: input.returnTarget ?? { roleId: sourceRoleId }, - }, { newTaskId: () => store.ids.task(), now: nowIso }) - const withChain = { - ...record, - kind: 'revision', - reviseOfArtifactId: artifact.id, - reviseOfTaskId: artifact.taskId ?? null, - artifactRevision: Number(artifact.revision ?? 1), - } - const queued = wanted === 'queued' ? startTask(withChain, { now: nowIso }) : withChain - return { task: copy(store.insertTask(queued)), artifact: artifactView(artifact) } - }) - - function listArtifacts(projectId) { - const project = projectIdOf({ projectId }) - return store.listArtifacts(project.id).map(artifactView) - } - - function getArtifact(projectId, artifactId) { - const project = projectIdOf({ projectId }) - return artifactView(ownedRow(project, 'artifact', artifactId, 'artifactId')) - } - - function getAttempt(projectId, attemptId) { - const project = projectIdOf({ projectId }) - return copy(requireAttempt(project, attemptId)) - } - - // ---------- 事件 ---------- - - /** - * 事件轮询数据源:since 之后的本项目事件,按 seq 升序。 - * - since 超出当前 seq(账本被替换/回滚)→ reset=true,前端应全量重拉而不是空等; - * - 只返回本项目事件;projectId 为空时返回全局(宿主内部用,UI 不传)。 - */ - function listEvents(projectId, since = 0, optionsArg = {}) { - let scope = null - if (projectId !== undefined && projectId !== null && projectId !== '') { - scope = projectIdOf({ projectId }).id - } - const cursor = Number(since) - const start = Number.isFinite(cursor) && cursor > 0 ? Math.floor(cursor) : 0 - const limit = Number.isInteger(optionsArg.limit) && optionsArg.limit > 0 ? optionsArg.limit : 200 - const all = store.listEvents(scope === null ? undefined : scope) - const fresh = all.filter((row) => row.seq > start).sort((left, right) => left.seq - right.seq) - return { - events: fresh.slice(0, limit).map(copy), - seq: store.eventSeq, - reset: start > store.eventSeq, - hasMore: fresh.length > limit, - } - } - - // ---------- 投影 ---------- - - /** - * bootstrap:一次拿全。projectId 为空时取列表第一个; - * 传入的项目不可见按 NOT_FOUND 报错,不泄露其他项目是否存在。 - */ - function bootstrap(projectId) { - const projects = listProjects() - let selectedId = null - if (projectId !== undefined && projectId !== null && projectId !== '') { - selectedId = projectIdOf({ projectId }).id - } else if (projects.length > 0) { - selectedId = projects[0].id - } - if (selectedId === null) { - return { - projects, - projectId: null, - project: null, - seats: [], - layout: layout(), - tasks: [], - artifacts: [], - results: [], - eventSeq: store.eventSeq, - } - } - const project = store.getProject(selectedId) - const taskIds = new Set(store.listTasks(selectedId).map((task) => task.id)) - return { - projects, - projectId: selectedId, - project: copy(project), - seats: listSeats(selectedId), - layout: layout(), - tasks: listTasks(selectedId), - artifacts: store.listArtifacts(selectedId).map(artifactView), - results: store.listResults(undefined).filter((row) => taskIds.has(row.taskId)).map(copy), - eventSeq: store.eventSeq, - } - } - - // ---------- 事件:每次状态变更都写一条 outbox ---------- - - /** - * 哪些操作要发事件:凡是「UI 需要立刻看到」的写操作。 - * 放在出口统一包一层而不是各函数里各写一遍——漏一处就是一个静默不刷新的 bug。 - * syncDecision 自己已经登记了 decision.synced,这里跳过,避免同一动作两条事件。 - */ - const EVENT_OPS = new Set([ - 'registerProject', - 'bindDepartmentSession', - 'releaseDepartmentSession', - 'setDepartmentStatus', - 'saveDepartmentConfig', - 'createTask', - 'cancelTask', - 'dispatchTask', - 'markDispatch', - 'startAttempt', - 'reportTaskResult', - 'reportRunTerminal', - 'requestTaskInput', - 'supplyTaskInput', - 'registerArtifact', - 'requestArtifactRevision', - ]) - - /** 从返回值里找这次写入属于哪个项目;找不到就不带项目(全局事件)。 */ - function projectIdOfResult(value, input) { - const candidates = [ - value?.project?.id, - value?.task?.projectId, - value?.binding?.projectId, - value?.dispatch?.projectId, - value?.attempt?.projectId, - value?.config?.projectId, - value?.artifact?.projectId, - value?.result?.projectId, - input?.projectId, - ] - return candidates.find((id) => typeof id === 'string' && id !== '') ?? null - } - - /** - * 事件只是“给 UI 的增量提示”,写入失败绝不能让业务失败: - * 账已经落对了,事件补不上顶多让界面晚一拍,靠 /bootstrap 仍能自愈。 - */ - function emitChange(op, value, input) { - try { - const projectId = projectIdOfResult(value, input) - const roleId = value?.task?.ownerRoleId - ?? value?.binding?.roleId - ?? value?.attempt?.roleId - ?? input?.roleId - ?? null - store.appendEvent({ - type: `state.${op}`, - projectId, - roleId, - taskId: value?.task?.id ?? input?.taskId ?? null, - attemptId: value?.attempt?.id ?? input?.attemptId ?? null, - payload: { op }, - }) - } catch { - // 见上:事件不是业务前置条件。 - } - } - - const api = { - version: WORKBENCH_SERVICE_VERSION, - store, - clock, - env, - // 项目 - registerProject, - listProjects, - getProject, - // 十席 - listSeats, - layout, - // 绑定与配置 - bindDepartmentSession, - releaseDepartmentSession, - setDepartmentStatus, - saveDepartmentConfig, - // 任务 - createTask, - getTask, - listTasks, - cancelTask, - // 派发 - dispatchTask, - markDispatch, - startAttempt, - // 结果 - reportTaskResult, - reportRunTerminal, - requestTaskInput, - supplyTaskInput, - syncDecision, - // 成果 - registerArtifact, - requestArtifactRevision, - listArtifacts, - getArtifact, - getAttempt, - // 投影与事件 - bootstrap, - listEvents, - // 供路由与测试复用 - translate, - } - - const wrapped = {} - for (const [name, fn] of Object.entries(api)) { - if (typeof fn !== 'function' || !EVENT_OPS.has(name)) { - wrapped[name] = fn - continue - } - wrapped[name] = (...args) => { - const value = fn(...args) - emitChange(name, value, args[0]) - return value - } - } - return Object.freeze(wrapped) -} diff --git a/workbench/host/session-adapter.mjs b/workbench/host/session-adapter.mjs deleted file mode 100644 index f40c9ad..0000000 --- a/workbench/host/session-adapter.mjs +++ /dev/null @@ -1,307 +0,0 @@ -// 会话适配层:把 Host 的 SessionController 收敛成“派发只需要几个动作”。 -// -// 依据 docs/v0.1-宿主能力记录.md(P0 实测的类型层事实): -// - create({workspaceId}) 幂等:同一 workspace 已绑定时返回同一个会话,不会造出第二个; -// - create 里没有 creationRequestId,也没有 cwd+workspaceId 同时给的用法(会 bad-request); -// - prompt 的 requestId 才是真幂等键(跨重启有效),所以 attemptId 直接当 requestId 用; -// - cancel() 只是“请求取消”,accepted:true ≠ 已取消,终态必须靠 follow/对账得到。 -// -// 这一层只做三件事:拿到会话、送一条消息、听它的事件。其余判定留在核心层。 - -export class SessionAdapterError extends Error { - constructor(code, message, details = undefined) { - super(message) - this.name = 'SessionAdapterError' - this.code = code - if (details !== undefined) this.details = details - } -} - -/** 把宿主抛出的杂异常收敛成“可重试 / 必失败”两类,reconciler 依赖这个区分。 */ -export function classifyHostError(error) { - const code = error && typeof error.code === 'string' ? error.code : '' - const message = error instanceof Error ? error.message : String(error) - if (code === 'session/conflict' || /session\/conflict/.test(message)) return 'conflict' - if (code === 'session/model-unavailable' || /model-unavailable/.test(message)) return 'model_unavailable' - if (code === 'session/agent-busy' || /agent-busy/.test(message)) return 'busy' - if (code === 'session/writer-held' || /writer-held/.test(message)) return 'transient' - if (/timeout|ETIMEDOUT|ECONNRESET|ECONNREFUSED|socket hang up/i.test(message)) return 'transient' - return 'unknown' -} - -/** - * @param {object} options - * @param {object} options.sessionController Host 的 ctx.sessionController(或同形状替身)。 - * @param {(event: object) => void} [options.onEvent] 订阅回调:任意会话事件(对账与 UI 都用它)。 - * @param {(message: string) => void} [options.log] 诊断日志出口;默认吞掉。 - */ -export function createSessionAdapter(options = {}) { - const { sessionController, onEvent, log = () => {} } = options - if (sessionController === undefined || sessionController === null || typeof sessionController.prompt !== 'function') { - throw new SessionAdapterError('NO_SESSION_CONTROLLER', '会话适配层需要 Host 的 sessionController') - } - const controller = sessionController - /** 正在跑 follow 的会话:sessionId → { controller: AbortController, done: Promise } */ - const followers = new Map() - // 被用户明确要求停止过的会话(只影响对账收口,不影响派发)。 - const cancelRequested = new Set() - let disposed = false - - function ensureAlive() { - if (disposed) throw new SessionAdapterError('DISPOSED', '会话适配层已释放') - } - - /** - * 拿到(或复用)一个会话。上层传入的 sessionId 是 store 里登记的绑定; - * 为空时用 workspaceId 建一个新会话,并把 host 返回的 id 交回给上层登记。 - */ - async function ensureSession({ workspaceId, sessionId, agentPreset } = {}) { - ensureAlive() - if (typeof sessionId === 'string' && sessionId.trim() !== '') { - // 已有绑定:不重建,只确认宿主能看到它(看不到就交给上层判定绑定失效)。 - const known = await inspectSession(sessionId) - return { sessionId, created: false, known } - } - if (typeof workspaceId !== 'string' || workspaceId.trim() === '') { - throw new SessionAdapterError('NO_TARGET', '既没有绑定会话也没有 workspaceId,无法接通部门') - } - const request = { workspaceId } - if (typeof agentPreset === 'string' && agentPreset.trim() !== '') request.agentPreset = agentPreset - try { - const value = await controller.create(request) - if (value === null || typeof value !== 'object' || typeof value.sessionId !== 'string') { - throw new SessionAdapterError('BAD_CREATE_RESULT', '宿主 create 未返回 sessionId') - } - return { sessionId: value.sessionId, created: true, agentPreset: value.agentPreset ?? null } - } catch (error) { - throw new SessionAdapterError(classifyHostError(error), `接通部门会话失败:${messageOf(error)}`, { cause: error }) - } - } - - async function inspectSession(sessionId) { - if (typeof controller.inspect !== 'function') return null - try { - return await controller.inspect(sessionId) - } catch { - return null - } - } - - /** - * 送一条消息。requestId 由调用方(attemptId)给,重试同一条 attempt 不会重复投递; - * 超时/未知一律抛 transient,由 reconciler 决定是查证还是标 unknown。 - */ - async function sendPrompt({ sessionId, requestId, text, mode = 'queue', signal, clientTimeZone } = {}) { - ensureAlive() - if (typeof sessionId !== 'string' || sessionId.trim() === '') { - throw new SessionAdapterError('NO_SESSION', '送消息前必须有 sessionId') - } - if (typeof text !== 'string' || text.trim() === '') { - throw new SessionAdapterError('EMPTY_PROMPT', '送消息内容为空') - } - if (typeof requestId !== 'string' || requestId.trim() === '') { - throw new SessionAdapterError('NO_REQUEST_ID', '送消息必须带 requestId(幂等键)') - } - const request = { - requestId, - sessionId, - mode: mode === 'steer' ? 'steer' : 'queue', - content: [{ type: 'text', text }], - } - if (typeof clientTimeZone === 'string' && clientTimeZone !== '') request.clientTimeZone = clientTimeZone - try { - const value = await controller.prompt(request, signal) - return { accepted: value?.accepted === true } - } catch (error) { - throw new SessionAdapterError(classifyHostError(error), `投递失败:${messageOf(error)}`, { cause: error }) - } - } - - /** - * 取消只是“请求取消”;调用方必须等 follow 上的终态或对账结果,不能直接当已停。 - * 这里额外记下"这个会话被用户要求停过",对账时用它把停跑结果收口成 cancelled, - * 避免"取消与成功竞争"里被取消的那一次被记成成功运行。 - */ - function requestCancel(sessionId) { - ensureAlive() - try { - const value = controller.cancel({ sessionId }) - if (value?.accepted === true) cancelRequested.add(sessionId) - return { accepted: value?.accepted === true } - } catch (error) { - throw new SessionAdapterError(classifyHostError(error), `取消失败:${messageOf(error)}`, { cause: error }) - } - } - - /** 该会话是否被明确要求过停止(跨本次进程有效;宿主重启后由 attempt 状态兜底)。 */ - function wasCancelRequested(sessionId) { - return cancelRequested.has(sessionId) - } - - /** 新一轮派发成功投递后可清掉停止标记:同一会话的下一次运行不该继承上一次的取消意图。 */ - function clearCancelRequest(sessionId) { - return cancelRequested.delete(sessionId) - } - - /** 每次派发都显式覆写模型:宿主 selectModel 会顺手改全局默认,所以用快照固定本轮。 */ - async function applyModel({ sessionId, provider, model, reasoningEffort } = {}) { - ensureAlive() - if (typeof controller.selectModel !== 'function') return { selected: false, reason: 'controller 无 selectModel' } - if (typeof provider !== 'string' || provider === '' || typeof model !== 'string' || model === '') { - return { selected: false, reason: '未配置模型' } - } - const request = { sessionId, provider, model } - if (typeof reasoningEffort === 'string' && reasoningEffort !== '') request.reasoningEffort = reasoningEffort - try { - const value = await controller.selectModel(request) - return { selected: true, selection: value?.selected ?? null } - } catch (error) { - // 模型不可用是“本次派发不能开工”,不是“任务失败”,交由上层标 unavailable 并保留任务。 - throw new SessionAdapterError(classifyHostError(error), `模型切换失败:${messageOf(error)}`, { cause: error }) - } - } - - async function getSessionSummary(sessionId) { - if (typeof controller.list !== 'function') return null - try { - const value = await controller.list({}, new AbortController().signal) - const items = Array.isArray(value?.items) ? value.items : [] - return items.find((row) => row.sessionId === sessionId) ?? null - } catch { - return null - } - } - - /** 宿主是否还在跑这个会话:null 表示问不到(不当成“已结束”)。 */ - async function isRunning(sessionId) { - const summary = await getSessionSummary(sessionId) - if (summary === null) return null - return summary.running === true - } - - /** - * 订阅会话事件。alreadyAttached 时不重复起流:同一个会话只留一条 follow, - * 避免双窗口/重启后重建出两条流导致事件重复。 - */ - function follow(sessionId, { onFrame } = {}) { - ensureAlive() - if (followers.has(sessionId)) return followers.get(sessionId).handle - if (typeof controller.follow !== 'function') throw new SessionAdapterError('NO_FOLLOW', 'controller 无 follow') - const abort = new AbortController() - const handle = { sessionId, stop: () => abort.abort() } - const done = (async () => { - try { - const address = { sessionId } - const stream = controller.follow({ address }, abort.signal) - for await (const frame of stream) { - if (disposed || abort.signal.aborted) break - if (frame?.type === 'assistant-stream') continue - try { - if (typeof onFrame === 'function') onFrame(frame) - if (typeof onEvent === 'function') onEvent({ sessionId, frame }) - } catch (error) { - log(`[sansheng-liubu] 处理会话帧失败:${messageOf(error)}`) - } - } - } catch (error) { - if (!abort.signal.aborted) log(`[sansheng-liubu] 会话流中断:${messageOf(error)}`) - } finally { - followers.delete(sessionId) - } - })() - followers.set(sessionId, { handle, done }) - return handle - } - - function unfollow(sessionId) { - const entry = followers.get(sessionId) - if (entry === undefined) return false - entry.handle.stop() - return true - } - - function dispose() { - disposed = true - for (const entry of followers.values()) entry.handle.stop() - followers.clear() - } - - return Object.freeze({ - ensureSession, - inspectSession, - sendPrompt, - requestCancel, - wasCancelRequested, - clearCancelRequest, - applyModel, - getSessionSummary, - isRunning, - follow, - unfollow, - dispose, - get following() { - return [...followers.keys()] - }, - }) -} - -function messageOf(error) { - return error instanceof Error ? error.message : String(error) -} - -/** - * 把一条材料引用写成人能读的一行,并保留可追溯的 ID。 - * - 字符串:原样(历史数据里的自由文本引用) - * - {artifactId, revision}:成果引用,带版本号 - * - {attachmentId, name, mime, size}:附件引用(A09 附件级交接) - */ -export function describeMaterialRef(ref) { - if (typeof ref === 'string') return ref - if (ref === null || typeof ref !== 'object') return String(ref) - if (typeof ref.artifactId === 'string' && ref.artifactId !== '') { - const version = Number.isInteger(ref.revision) && ref.revision > 0 ? `(第 ${ref.revision} 版)` : '' - const title = typeof ref.title === 'string' && ref.title !== '' ? ` ${ref.title}` : '' - return `成果${title} ${ref.artifactId}${version}` - } - if (typeof ref.attachmentId === 'string' && ref.attachmentId !== '') { - const bits = [] - if (typeof ref.name === 'string' && ref.name !== '') bits.push(ref.name) - if (typeof ref.mime === 'string' && ref.mime !== '') bits.push(ref.mime) - if (Number.isInteger(ref.size) && ref.size > 0) bits.push(`${ref.size} 字节`) - const suffix = bits.length === 0 ? '' : `(${bits.join(' · ')})` - return `附件 ${ref.attachmentId}${suffix}` - } - return JSON.stringify(ref) -} - -/** - * 把一次派发写成部门能直接执行的提示词。只放事实(任务、验收、材料、回传方式), - * 不写“请确认已完成”这类引导语——完成判定只认结构化报告。 - */ -export function buildDispatchText({ task, packet, contractGuide, roleName } = {}) { - const lines = [] - const name = typeof roleName === 'string' && roleName !== '' ? roleName : '你' - lines.push(`【任务单 ${task?.id ?? ''}】${task?.title ?? ''}`) - if (typeof task?.objective === 'string' && task.objective !== '') lines.push(`目标:${task.objective}`) - const acceptance = Array.isArray(packet?.acceptance) && packet.acceptance.length > 0 ? packet.acceptance : task?.acceptance - if (Array.isArray(acceptance) && acceptance.length > 0) { - lines.push('验收标准:') - for (const item of acceptance) lines.push(`- ${String(item)}`) - } - const constraints = Array.isArray(packet?.constraints) ? packet.constraints : task?.constraints - if (Array.isArray(constraints) && constraints.length > 0) { - lines.push('约束:') - for (const item of constraints) lines.push(`- ${String(item)}`) - } - const refs = Array.isArray(packet?.materialRefs) ? packet.materialRefs : [] - if (refs.length > 0) { - lines.push('相关材料:') - for (const ref of refs) lines.push(`- ${describeMaterialRef(ref)}`) - } - lines.push('') - lines.push(`完成后请用结构化回传(不要只在正文里说“已完成”,那样不算完成):`) - lines.push(typeof contractGuide === 'string' && contractGuide !== '' ? contractGuide : '') - lines.push('') - lines.push(`(你是本项目的 ${name};任务与成果归属由程序按项目登记,不要自行改派给其他部门。)`) - return lines.join('\n') -} diff --git a/workbench/host/workbench-host.mjs b/workbench/host/workbench-host.mjs deleted file mode 100644 index 5844f7c..0000000 --- a/workbench/host/workbench-host.mjs +++ /dev/null @@ -1,212 +0,0 @@ -// 工作台 Host 外壳:把 store + service + 适配层 + 两个后台服务组装成一个可挂载组件。 -// -// 挂载方式(index.js 里): -// const host = createWorkbenchHost(ctx, { store, presetId }) -// ctx.effect(() => () => host.dispose(), 'sansheng-liubo: workbench') -// -// 能力探测优先:宿主没有 sessionController 时,工作台仍然能读写账本(投影可用), -// 但任何“派发/接通”都返回 NO_SESSION_CONTROLLER,UI 显示“尚未接通”,绝不假装成功。 - -import { WorkbenchStore, defaultStorePath } from '../core/store.mjs' -import { createWorkbenchService } from './service.mjs' -import { createSessionAdapter } from './session-adapter.mjs' -import { createDispatchService } from './dispatch-service.mjs' -import { createReconciler } from './reconciler.mjs' -import { CONTRACT_ACTIONS, CONTRACT_ACTION_PREFIX, parseContractLines, describeContract } from './contract.mjs' - -export const WORKBENCH_HOST_VERSION = 1 - -/** - * @param {object} ctx Host 插件上下文(cordis Context) - * @param {object} [options] - * @param {object} [options.store] 已有 store(测试注入);缺省按环境建一个。 - * @param {object} [options.service] 已有 service;缺省按 store 新建。给了 service 就必须同时给 store, - * 否则两边的账不是同一本。 - * @param {string} [options.presetId] 部门会话使用的 agentPreset,首版沿用「上朝」。 - * @param {boolean} [options.startReconciler] 是否启动周期对账,默认 true。 - */ -export function createWorkbenchHost(ctx, options = {}) { - const log = (message) => { - try { - ctx?.logger?.info?.(message) - } catch { - /* 日志失败不能影响业务 */ - } - } - - const store = options.store ?? createStore(options) - const service = options.service ?? createWorkbenchService({ store, clock: options.clock, fileExists: options.fileExists }) - - // 会话层是可选能力:宿主没有 sessionController(或版本不提供)时整体降级。 - // 注意 apply 时宿主可能还没把 sessionController 装好,所以这里只是「尝试挂载」, - // 真正的挂载动作集中在 mountSessions,宿主晚到时由 attachSessions 再补一次。 - let sessions = null - let dispatchService = null - let reconciler = null - let hasSessions = false - let started = false - - function mountSessions(controller) { - const usable = controller !== null && typeof controller?.prompt === 'function' - if (!usable) return false - if (sessions !== null) return true - try { - sessions = createSessionAdapter({ sessionController: controller, log }) - } catch (error) { - log(`[sansheng-liubo] 会话层不可用:${error?.message ?? error}`) - sessions = null - return false - } - dispatchService = createDispatchService({ store, service, sessions, log, applyModelToSessions: options.applyModelToSessions === true }) - reconciler = createReconciler({ store, service, sessions, log }) - hasSessions = true - if (started && options.startReconciler !== false) reconciler.start() - return true - } - - /** 宿主稍后才提供 sessionController 时补挂(不重启也能用)。返回是否挂上。 */ - function attachSessions(controller) { - const mounted = mountSessions(controller ?? null) - if (!mounted) log('[sansheng-liubo] 会话控制器仍不可用,派发继续保持“只落账”') - return mounted - } - - mountSessions(ctx?.sessionController ?? ctx?.remote?.session ?? null) - - const presetId = typeof options.presetId === 'string' && options.presetId !== '' ? options.presetId : 'sansheng-liubu' - - /** - * 接通某个部门的会话:已有绑定就直接用,没有就按 workspace 建一个并登记。 - * 绑定替换由 store 的 bindSession 判定(allowReplace),账上和宿主保持一致。 - */ - async function connectDepartment(input = {}) { - const projectId = requireText(input.projectId, 'projectId') - const roleId = requireText(input.roleId, 'roleId') - const project = store.getProject(projectId) - if (project === undefined) throw new Error('项目不存在') - if (sessions === null) { - throw new Error('宿主未提供会话能力,暂时无法接通部门(账本仍可读写)') - } - const binding = store.getBinding(projectId, roleId) - const existing = binding?.currentSessionId ?? null - if (existing !== null) { - const known = await sessions.inspectSession(existing) - if (known !== null) return { sessionId: existing, created: false, seat: seatOf(projectId, roleId) } - } - const target = await sessions.ensureSession({ - workspaceId: project?.hostWorkspaceId, - sessionId: input.sessionId ?? null, - agentPreset: input.agentPreset ?? presetId, - }) - // 账上登记:同一会话被别的部门占用时 store 会拒绝,正是我们要的“会话独占”。 - const saved = service.bindDepartmentSession({ - projectId, - roleId, - sessionId: target.sessionId, - allowReplace: existing !== null, - }) - return { sessionId: target.sessionId, created: target.created === true, seat: saved.seat } - } - - function seatOf(projectId, roleId) { - return service.listSeats(projectId).find((seat) => seat.roleId === roleId) ?? null - } - - /** 派发(对 UI 的唯一入口)。没有会话层时返回明确错误,不假装已发送。 */ - async function dispatchTask(input = {}) { - if (dispatchService === null) { - return { ok: false, code: 'NO_SESSION_CONTROLLER', message: '宿主未提供会话能力,派发已停在工作台账内' } - } - return dispatchService.dispatch(input) - } - - /** 处理部门输出里的契约行:只认结构化字段,解析失败的行原样返回给 UI 提示。 */ - function ingestAgentOutput({ projectId, roleId, text } = {}) { - const parsed = parseContractLines(text) - const applied = [] - const failed = [] - for (const call of parsed.calls) { - try { - applied.push(applyContractCall({ projectId, roleId, call })) - } catch (error) { - failed.push({ action: call.action, code: error?.code ?? 'unknown', message: error?.message ?? String(error) }) - } - } - return { applied, failed, invalid: parsed.invalid } - } - - function applyContractCall({ projectId, roleId, call }) { - const payload = { ...call.payload, projectId } - switch (call.action) { - case 'dispatchTask': - if (payload.sourceRoleId === undefined) payload.sourceRoleId = roleId - return { action: call.action, result: service.dispatchTask(payload) } - case 'reportTaskResult': - return { action: call.action, result: service.reportTaskResult(payload) } - case 'requestTaskInput': - return { action: call.action, result: service.requestTaskInput(payload) } - case 'syncDecision': - return { action: call.action, result: service.syncDecision(payload) } - default: - throw new Error(`未知动作:${String(call.action)}`) - } - } - - function start() { - if (started) return - started = true - if (options.startReconciler !== false && reconciler !== null) reconciler.start() - } - - function dispose() { - if (reconciler !== null) reconciler.stop() - if (sessions !== null) sessions.dispose() - started = false - } - - return Object.freeze({ - version: WORKBENCH_HOST_VERSION, - store, - service, - // 会话层可能晚到:用 getter,调用方总能读到最新挂载结果。 - get sessions() { - return sessions - }, - get reconciler() { - return reconciler - }, - get dispatchService() { - return dispatchService - }, - get hasSessions() { - return hasSessions - }, - attachSessions, - presetId, - connectDepartment, - dispatchTask, - ingestAgentOutput, - bootstrap: (projectId) => service.bootstrap(projectId), - listEvents: (projectId, since, opts) => service.listEvents(projectId, since, opts), - start, - dispose, - }) -} - -function createStore(options) { - const file = options.storeFile ?? defaultStorePath(process.env) - const store = new WorkbenchStore({ file }) - try { - store.load() - } catch { - // 读到坏账本时不静默清空:由 paths.quarantineFile 在 HTTP 层隔离,这里保持空账可写。 - } - return store -} - -function requireText(value, field) { - if (typeof value !== 'string' || value.trim() === '') throw new Error(`${field} 必须是非空字符串`) - return value -} - -export { CONTRACT_ACTIONS, CONTRACT_ACTION_PREFIX, parseContractLines, describeContract } diff --git a/workbench/panel/lib/client.js b/workbench/panel/lib/client.js deleted file mode 100644 index 43ba526..0000000 --- a/workbench/panel/lib/client.js +++ /dev/null @@ -1,2242 +0,0 @@ -window.__ModuleLoader__.load({ - id: "dsh-sansheng-liubu-workbench", - factory: (require) => { - var module = { exports: {} }; - var exports = module.exports; - Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" }); - - const React = require("react"); - const h = React.createElement; - - // --------------------------------------------------------------------- - // 常量与纯函数(不依赖宿主、不依赖 DOM,供单测直接调用) - // --------------------------------------------------------------------- - - const API_BASE = "/sansheng/workbench"; - const TAB_ID = "sansheng-liubu-workbench"; - const TAB_KIND = "sansheng-liubu-workbench"; - const CSS_ID = "dsh-sansheng-liubu-workbench/workbench.css"; - const RAIL_WIDTH_KEY = "sansheng.workbench.railWidth"; - const MAIN_SWITCH_KEY = "sansheng.workbench.main"; - const RAIL_MIN = 340; - const RAIL_MAX = 600; - const RAIL_DEFAULT = 400; - - const ROLE_ORDER = [ - "lead", - "zhongshu", - "shangshu", - "menxia", - "libu", - "hubu", - "lipu", - "bingbu", - "xingbu", - "gongbu", - ]; - - const ROLE_META = { - lead: { name: "丞相", mark: "丞", kicker: "主代理", tier: "leaders", group: "lead", column: "span", row: 0, duty: "接需求、分流、协调、汇报" }, - zhongshu: { name: "中书", mark: "中", kicker: "省", tier: "sansheng", group: "sansheng", column: "left", row: 1, duty: "起草方案、拆解路径" }, - shangshu: { name: "尚书", mark: "尚", kicker: "省", tier: "sansheng", group: "sansheng", column: "center", row: 1, duty: "总揽执行、调度六部" }, - menxia: { name: "门下", mark: "门", kicker: "省", tier: "sansheng", group: "sansheng", column: "right", row: 1, duty: "审核把关、封驳纠偏" }, - libu: { name: "吏部", mark: "吏", kicker: "部", tier: "ministries", group: "ministries", column: "left", row: 2, duty: "人事、配置、席位" }, - hubu: { name: "户部", mark: "户", kicker: "部", tier: "ministries", group: "ministries", column: "center", row: 2, duty: "资源、预算、账目" }, - lipu: { name: "礼部", mark: "礼", kicker: "部", tier: "ministries", group: "ministries", column: "right", row: 2, duty: "文档、规范、对外表达" }, - bingbu: { name: "兵部", mark: "兵", kicker: "部", tier: "ministries", group: "ministries", column: "left", row: 3, duty: "执行、工具、攻坚" }, - xingbu: { name: "刑部", mark: "刑", kicker: "部", tier: "ministries", group: "ministries", column: "center", row: 3, duty: "测试、审查、问责" }, - gongbu: { name: "工部", mark: "工", kicker: "部", tier: "ministries", group: "ministries", column: "right", row: 3, duty: "工程、构建、基础设施" }, - }; - - const STATUS_LABELS = { - uninitialized: "未接通", - idle: "空闲", - queued: "排队", - running: "正在运行", - unavailable: "不可用", - needs_attention: "需人处理", - }; - - const EFFORT_LABELS = { - minimal: "极低", - low: "低", - medium: "中", - high: "高", - none: "无", - }; - - const TASK_STATUS_LABELS = { - draft: "草稿", - queued: "排队", - running: "执行中", - waiting_input: "待输入", - needs_attention: "需人处理", - completed: "已完成", - failed: "失败", - cancelled: "已取消", - }; - - function assign(target) { - for (var i = 1; i < arguments.length; i++) { - var source = arguments[i]; - if (!source) continue; - for (var key in source) { - if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key]; - } - } - return target; - } - - function clamp(value, low, high) { - var number = Number(value); - if (!isFinite(number)) return low; - return Math.min(high, Math.max(low, number)); - } - - function round(value) { - return Math.round(Number(value) * 10) / 10; - } - - function statusOf(status) { - if (typeof status !== "string" || status === "") return "未接通"; - return STATUS_LABELS[status] || "未知"; - } - - function seatDisplayName(seat) { - if (!seat) return ""; - var meta = ROLE_META[seat.roleId] || {}; - // short 是单字简称(丞/中/尚…),只能在最后兜底;完整名优先。 - return seat.name || meta.name || seat.short || seat.roleId || ""; - } - - function formatModelLine(config) { - if (!config || typeof config !== "object") return "跟随宿主"; - var provider = typeof config.provider === "string" ? config.provider.trim() : ""; - var model = typeof config.model === "string" ? config.model.trim() : ""; - var effort = typeof config.reasoningEffort === "string" ? config.reasoningEffort.trim() : ""; - if (!provider || !model) return "跟随宿主"; - var effortText = effort ? " · " + (EFFORT_LABELS[effort] || effort) : ""; - // model 自带 provider 前缀(如 magpie/workbuddy/deepseek-v4)时只留最后一段, - // 避免一行放不下、也避免 provider 重复;完整路径留在卡片 title 里。 - if (model.indexOf("/") >= 0) return model.slice(model.lastIndexOf("/") + 1) + effortText; - return provider + "/" + model + effortText; - } - - function modelTitle(config) { - if (!config || typeof config !== "object") return "跟随宿主(未单独配置模型)"; - var provider = typeof config.provider === "string" ? config.provider.trim() : ""; - var model = typeof config.model === "string" ? config.model.trim() : ""; - var effort = typeof config.reasoningEffort === "string" ? config.reasoningEffort.trim() : ""; - if (!provider || !model) return "跟随宿主(未单独配置模型)"; - return provider + "/" + model + (effort ? " · " + (EFFORT_LABELS[effort] || effort) : ""); - } - - function mergeEvents(current, incoming) { - var seen = new Set(); - var merged = []; - var batches = [current || [], incoming || []]; - for (var b = 0; b < batches.length; b++) { - var rows = batches[b]; - for (var i = 0; i < rows.length; i++) { - var row = rows[i]; - if (!row || typeof row !== "object") continue; - var key = row.eventId !== undefined && row.eventId !== null - ? "id:" + String(row.eventId) - : row.seq !== undefined && row.seq !== null - ? "seq:" + String(row.seq) - : null; - if (key === null || seen.has(key)) continue; - seen.add(key); - merged.push(row); - } - } - merged.sort(function (left, right) { - return (Number(left.seq) || 0) - (Number(right.seq) || 0); - }); - return merged; - } - - function apiPath(name, query) { - var clean = String(name === undefined || name === null ? "" : name).replace(/^\/+/, ""); - var path = API_BASE + (clean ? "/" + clean : ""); - if (query && typeof query === "object") { - var parts = []; - var keys = Object.keys(query); - for (var i = 0; i < keys.length; i++) { - var key = keys[i]; - var value = query[key]; - if (value === undefined || value === null) continue; - parts.push(encodeURIComponent(key) + "=" + encodeURIComponent(String(value))); - } - if (parts.length > 0) path += "?" + parts.join("&"); - } - return path; - } - - function pickProjectId(data, hostWorkspaceId) { - var projects = data && Array.isArray(data.projects) ? data.projects : []; - if (hostWorkspaceId) { - for (var i = 0; i < projects.length; i++) { - var project = projects[i]; - if (project && project.hostWorkspaceId === hostWorkspaceId && project.id) return project.id; - } - return null; - } - if (data && typeof data.projectId === "string" && data.projectId) return data.projectId; - for (var j = 0; j < projects.length; j++) { - if (projects[j] && projects[j].id) return projects[j].id; - } - return null; - } - - /** - * 纯几何布局:400px 栏宽时给出与 docs/preview/v01-nodes-*.png 一致的坐标。 - * 返回 nodes 每项都有 id / x / y / col / row(六部 row 为 2、3), - * 不依赖 DOM,列表渲染与单测共用,避免两套尺寸。 - */ - function computeRailLayout(width) { - var railWidth = Number(width) > 0 ? Number(width) : 400; - var padding = 12; - var gap = 10; - var sixGap = 8; - var groupPad = 8; - var leadHeight = 80; - var sanHeight = 80; - var sixHeight = 74; - var sectionGap = 26; - // 丞相与三省之间留出分叉展开的垂直空间,和 CSS 的 .wb-trio margin-top 保持一致。 - var leadGap = 48; - - var inner = Math.max(0, railWidth - padding * 2); - var columnWidth = Math.max(0, (inner - gap * 2) / 3); - var leadWidth = Math.min(184, inner); - var leadX = (railWidth - leadWidth) / 2; - - var nodes = []; - function node(roleId, box) { - var meta = ROLE_META[roleId]; - return assign({ - id: roleId, - roleId: roleId, - name: meta.name, - mark: meta.mark, - tier: meta.tier, - group: meta.group, - }, box); - } - - nodes.push(node("lead", { - x: leadX, - y: 0, - w: leadWidth, - h: leadHeight, - col: 1, - row: 0, - span: 3, - cx: leadX + leadWidth / 2, - })); - - var sanY = leadHeight + leadGap; - var sanIds = ["zhongshu", "shangshu", "menxia"]; - for (var i = 0; i < sanIds.length; i++) { - var sanX = padding + i * (columnWidth + gap); - nodes.push(node(sanIds[i], { - x: sanX, - y: sanY, - w: columnWidth, - h: sanHeight, - col: i, - row: 1, - cx: sanX + columnWidth / 2, - })); - } - - var groupY = sanY + sanHeight + sectionGap; - var sixY = groupY + groupPad; - var sixWidth = Math.max(0, (inner - groupPad * 2 - sixGap * 2) / 3); - var sixIds = ["libu", "hubu", "lipu", "bingbu", "xingbu", "gongbu"]; - for (var j = 0; j < sixIds.length; j++) { - var gridRow = j < 3 ? 0 : 1; - var col = j % 3; - var sixX = padding + groupPad + col * (sixWidth + sixGap); - nodes.push(node(sixIds[j], { - x: sixX, - y: sixY + gridRow * (sixHeight + sixGap), - w: sixWidth, - h: sixHeight, - col: col, - row: gridRow + 2, - gridRow: gridRow, - cx: sixX + sixWidth / 2, - })); - } - - var groupHeight = groupPad * 2 + sixHeight * 2 + sixGap; - - return { - width: railWidth, - padding: padding, - gap: gap, - leadWidth: leadWidth, - columnWidth: columnWidth, - nodes: nodes, - lead: nodes[0], - sansheng: nodes.slice(1, 4), - ministries: nodes.slice(4), - groups: { - lead: { x: leadX, y: 0, w: leadWidth, h: leadHeight, cx: railWidth / 2 }, - sansheng: { x: padding, y: sanY, w: inner, h: sanHeight }, - ministries: { x: padding, y: groupY, w: inner, h: groupHeight, cx: railWidth / 2 }, - }, - wires: { - lead: { x: railWidth / 2, y: leadHeight }, - ministries: { x: railWidth / 2, y: groupY }, - }, - height: groupY + groupHeight + 16, - }; - } - - // 分叉线:先垂直下行到 mid,再用两次控制点把切线转正, - // 终点处以垂直切线落到卡片顶边中点(C 的第二个控制点与终点同 x)。 - function branchPathD(cx0, y0, cx1, y1) { - var mid = y0 + (y1 - y0) * 0.55; - return "M " + round(cx0) + " " + round(y0) + - " V " + round(mid) + - " C " + round(cx0) + " " + round(y1) + " " + round(cx1) + " " + round(mid) + - " " + round(cx1) + " " + round(y1); - } - - // 由几何布局生成连线:丞相底中点 → 三省顶中点,尚书底中点 → 六部组顶边。 - // 真实测量走 DOM rect,量不到时走这里;两边共用同一套 M/V/C 公式。 - function wirePathsFromLayout(layout) { - var paths = []; - var lead = layout.lead; - var sansheng = layout.sansheng; - var y0 = lead.y + lead.h; - for (var i = 0; i < sansheng.length; i++) { - var card = sansheng[i]; - var y1 = card.y; - if (!(y1 > y0)) continue; - paths.push({ - key: "lead-" + card.id, - kind: "branch", - d: branchPathD(lead.cx, y0, card.cx, y1), - }); - } - var shangshu = null; - for (var j = 0; j < sansheng.length; j++) { - if (sansheng[j].id === "shangshu") shangshu = sansheng[j]; - } - var group = layout.groups.ministries; - if (shangshu) { - paths.push({ - key: "trunk", - kind: "trunk", - d: "M " + round(shangshu.cx) + " " + round(shangshu.y + shangshu.h) + - " L " + round(shangshu.cx) + " " + round(group.y), - }); - } - return paths; - } - - function isSeatOnlyEventBatch(events) { - if (!events || events.length === 0) return false; - for (var i = 0; i < events.length; i++) { - var type = String((events[i] && events[i].type) || ""); - if (!/^(seat|department|binding|config)\./.test(type)) return false; - } - return true; - } - - function describeError(error) { - if (!error) return "请求失败"; - var code = error.code ? String(error.code) : ""; - var message = error.message ? String(error.message) : ""; - var text = ""; - if (code && message && message.indexOf(code) < 0) text = code + ":" + message; - else text = message || code || String(error); - var details = error.details; - if (details && typeof details === "object" && typeof details.hint === "string" && details.hint) { - text += "(" + details.hint + ")"; - } - return text; - } - - // --------------------------------------------------------------------- - // HTTP:统一同源、解包 {ok,value}、失败抛 error.code - // --------------------------------------------------------------------- - - async function request(method, name, query, body, options) { - var init = { - method: method, - credentials: "same-origin", - headers: { Accept: "application/json" }, - }; - if (body !== undefined) { - init.headers["Content-Type"] = "application/json"; - init.body = JSON.stringify(body); - } - if (options && options.signal) init.signal = options.signal; - - var response; - try { - response = await fetch(apiPath(name, query), init); - } catch (cause) { - var network = new Error("网络请求失败:" + (cause && cause.message ? cause.message : String(cause))); - network.code = "NETWORK"; - throw network; - } - - var payload = null; - try { - payload = await response.json(); - } catch (cause) { - payload = null; - } - - if (!response.ok || !payload || payload.ok !== true) { - var failure = (payload && payload.error) || {}; - var error = new Error(failure.message || "请求失败(HTTP " + response.status + ")"); - error.code = failure.code || "HTTP_" + response.status; - error.details = failure.details; - error.status = response.status; - throw error; - } - return payload.value; - } - - function apiGet(name, query, options) { - return request("GET", name, query, undefined, options); - } - - function apiPost(name, body, query, options) { - return request("POST", name, query, body, options); - } - - // --------------------------------------------------------------------- - // 宿主服务探测(都不是 public API,缺了要让插件照常加载,不能 park) - // --------------------------------------------------------------------- - - function readService(ctx, name) { - try { - if (ctx && typeof ctx.get === "function") { - var service = ctx.get(name); - if (service) return service; - } - } catch (error) { - // 宿主没有这个服务;忽略。 - } - try { - return ctx ? ctx[name] : undefined; - } catch (error) { - return undefined; - } - } - - function betterSidebarOf(ctx) { - var candidates = [readService(ctx, "betterSidebar"), ctx && ctx.betterSidebar]; - for (var i = 0; i < candidates.length; i++) { - var candidate = candidates[i]; - if (candidate && typeof candidate.registerTab === "function") return candidate; - } - return null; - } - - function sidebarRightTabsOf(ctx) { - var service = readService(ctx, "sidebarRightTabs"); - if (service && typeof service.register === "function") return service; - return null; - } - - function effectOf(ctx, factory, label) { - if (ctx && typeof ctx.effect === "function") return ctx.effect(factory, label); - try { - return factory(); - } catch (error) { - console.warn("[sansheng-workbench] " + label + " 注册失败", error); - return undefined; - } - } - - function workspaceIdOf(ctx) { - var workspace = ctx && ctx.uiWorkspace; - if (!workspace) return null; - var direct = workspace.currentWorkspaceId || workspace.workspaceId; - if (direct) return String(direct); - try { - var selection = workspace.selection && typeof workspace.selection.getSnapshot === "function" - ? workspace.selection.getSnapshot() - : null; - if (selection && selection.workspaceId) return String(selection.workspaceId); - } catch (error) { - // 忽略:拿不到工作区就退回 bootstrap 自带 projectId。 - } - return null; - } - - function displayNameOf(ctx, workspaceId) { - var workspace = ctx && ctx.uiWorkspace; - var name = workspace && (workspace.currentWorkspaceName || workspace.workspaceName || workspace.displayName); - if (typeof name === "string" && name) return name; - return workspaceId ? "工作区 " + workspaceId : ""; - } - - function canonicalRootOf(ctx) { - var workspace = ctx && ctx.uiWorkspace; - var root = workspace && ( - workspace.currentWorkspaceRoot || - workspace.workspaceRoot || - (workspace.currentWorkspace && workspace.currentWorkspace.root) - ); - return typeof root === "string" && root ? root : null; - } - - async function resolveWorkbenchProject(ctx) { - var hostWorkspaceId = workspaceIdOf(ctx); - var value = await apiGet("bootstrap"); - var targetId = pickProjectId(value, hostWorkspaceId); - - if (hostWorkspaceId && !targetId) { - var body = { - hostWorkspaceId: hostWorkspaceId, - displayNameCache: displayNameOf(ctx, hostWorkspaceId), - }; - var root = canonicalRootOf(ctx); - if (root) body.canonicalRoot = root; - - var created = null; - try { - created = await apiPost("project", body); - } catch (error) { - if (error && error.code === "DUPLICATE_PROJECT" && error.details && error.details.projectId) { - targetId = error.details.projectId; - } else { - throw error; - } - } - if (created) { - targetId = (created.project && created.project.id) || created.id || targetId; - } - if (!targetId) { - value = await apiGet("bootstrap"); - targetId = pickProjectId(value, hostWorkspaceId) || value.projectId || null; - } - } - - if (targetId && value.projectId !== targetId) { - value = await apiGet("bootstrap", { projectId: targetId }); - } - if (!targetId) targetId = value.projectId || null; - return { projectId: targetId, value: value }; - } - - async function findBoundProject(ctx, sessionId) { - var cached = BOUND_PROJECT_CACHE.get(sessionId); - if (cached) return cached; - var first = await apiGet("bootstrap"); - var projects = Array.isArray(first.projects) ? first.projects : []; - var hostWorkspaceId = workspaceIdOf(ctx); - var ordered = projects.slice().sort(function (left, right) { - var leftMatch = left && left.hostWorkspaceId === hostWorkspaceId ? 1 : 0; - var rightMatch = right && right.hostWorkspaceId === hostWorkspaceId ? 1 : 0; - return rightMatch - leftMatch; - }); - - function hasSession(value) { - var seats = value && Array.isArray(value.seats) ? value.seats : []; - for (var i = 0; i < seats.length; i++) { - var binding = seats[i] && seats[i].binding; - if (!binding) continue; - if (binding.currentSessionId === sessionId || binding.sessionId === sessionId) return true; - } - return false; - } - - if (first.projectId && hasSession(first)) { - BOUND_PROJECT_CACHE.set(sessionId, first.projectId); - return first.projectId; - } - for (var i = 0; i < ordered.length; i++) { - var project = ordered[i]; - if (!project || !project.id || project.id === first.projectId) continue; - var value = await apiGet("bootstrap", { projectId: project.id }); - if (hasSession(value)) { - BOUND_PROJECT_CACHE.set(sessionId, project.id); - return project.id; - } - } - return null; - } - - function openSession(ctx, sessionId) { - var workspace = ctx && ctx.uiWorkspace; - try { - if (workspace && typeof workspace.openSession === "function") { - workspace.openSession(sessionId); - return true; - } - var selection = workspace && workspace.selection; - if (selection && typeof selection.set === "function") { - selection.set({ sessionId: sessionId }); - return true; - } - throw new Error("宿主未提供打开会话的接口(uiWorkspace.openSession)"); - } catch (error) { - return error && error.message ? error.message : String(error); - } - } - - // --------------------------------------------------------------------- - // 样式(照 .scratch/mock-nodes/rail.html 与 docs/preview/v01-nodes-400-*.png) - // --------------------------------------------------------------------- - - const CSS = [ - ".wb-rail{--wb-bg:#f7f9fc;--wb-card:#ffffff;--wb-line:#e3e8ef;--wb-line-strong:#c7d8f5;--wb-ink:#0f172a;--wb-ink-2:#475467;--wb-ink-3:#98a2b3;--wb-blue:#3b82f6;--wb-green:#22c55e;--wb-amber:#f59e0b;--wb-gray:#94a3b8;--wb-wire:#c9d6ea;--wb-dashed:#d7e1f0;--wb-group-bg:rgba(255,255,255,.55);position:relative;display:flex;flex-direction:column;height:100%;min-height:0;min-width:0;background:var(--wb-bg);color:var(--wb-ink);font-size:12px;line-height:1.4;font-family:inherit;overflow:hidden}", - ".wb-rail *,.wb-rail *::before,.wb-rail *::after{box-sizing:border-box}", - ".wb-head{flex:none;display:flex;align-items:baseline;justify-content:space-between;gap:8px;padding:10px 14px 8px}", - ".wb-title{font-size:12px;font-weight:600;color:var(--wb-ink-2);letter-spacing:.01em}", - ".wb-meta{font-size:10.5px;color:var(--wb-ink-3);white-space:nowrap}", - ".wb-tabs{flex:none;display:flex;gap:2px;margin:0 12px 8px;padding:2px;border:1px solid var(--wb-line);border-radius:8px;background:var(--wb-card)}", - ".wb-tab{flex:1 1 0;min-width:0;border:0;background:transparent;color:var(--wb-ink-3);font:inherit;font-size:11px;line-height:1.2;padding:4px 6px;border-radius:6px;cursor:pointer}", - ".wb-tab.is-active{background:var(--wb-bg);color:var(--wb-ink);font-weight:600;box-shadow:0 1px 2px rgba(16,24,40,.05)}", - ".wb-tab:hover{color:var(--wb-ink-2)}", - ".wb-scroll{flex:1 1 auto;min-height:0;overflow-y:auto;overflow-x:hidden;padding:0 12px 16px}", - ".wb-alert{display:flex;align-items:flex-start;gap:6px;margin:0 12px 8px;padding:6px 8px;border:1px solid #fecaca;border-radius:7px;background:#fef2f2;color:#b42318;font-size:11px;line-height:1.4;flex:none}", - ".wb-alert.is-info{border-color:#bbf7d0;background:#f0fdf4;color:#166534}", - ".wb-alert-text{flex:1 1 auto;min-width:0;word-break:break-word}", - ".wb-alert button{flex:none;border:1px solid currentColor;background:transparent;color:inherit;font:inherit;font-size:10px;line-height:1;padding:3px 5px;border-radius:4px;cursor:pointer}", - ".wb-tree{position:relative;padding:0 0 4px}", - ".wb-wires{position:absolute;left:0;top:0;z-index:0;pointer-events:none;overflow:visible}", - ".wb-wire{fill:none;stroke:var(--wb-wire);stroke-width:1.2;stroke-linecap:round}", - ".wb-lead-row{display:flex;justify-content:center;padding-top:4px}", - ".wb-trio{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;margin-top:48px}", - ".wb-group{position:relative;margin-top:26px;padding:8px;border:1px dashed var(--wb-dashed);border-radius:12px;background:var(--wb-group-bg)}", - ".wb-group-label{position:absolute;top:-9px;left:10px;padding:0 5px;border-radius:4px;background:var(--wb-bg);color:var(--wb-ink-3);font-size:9.5px;line-height:18px;letter-spacing:.02em}", - ".wb-six{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}", - ".wb-card{position:relative;z-index:1;display:flex;flex-direction:column;gap:1px;min-width:0;padding:8px 10px;border:1px solid var(--wb-line);border-radius:10px;background:var(--wb-card);box-shadow:0 1px 2px rgba(16,24,40,.04);color:inherit;font:inherit;text-align:left;cursor:pointer;transition:border-color .12s ease,box-shadow .12s ease,transform .12s ease}", - ".wb-card:hover{border-color:var(--wb-line-strong)}", - ".wb-card:focus-visible{outline:2px solid var(--wb-blue);outline-offset:2px}", - ".wb-card.is-lead{width:min(184px,100%);margin:0 auto;padding:9px 12px;border-color:var(--wb-line-strong);background:linear-gradient(180deg,#fbfdff 0%,#ffffff 100%)}", - ".wb-card.is-running{border-color:var(--wb-blue);box-shadow:0 0 0 2px rgba(59,130,246,.14),0 2px 8px rgba(59,130,246,.12)}", - ".wb-card.is-attention{border-color:var(--wb-amber)}", - ".wb-card.is-unavailable{opacity:.72}", - ".wb-kicker{font-size:10px;color:var(--wb-ink-3);letter-spacing:.02em}", - ".wb-name{font-size:15px;font-weight:600;line-height:1.25;color:var(--wb-ink)}", - ".wb-model{font-size:11px;letter-spacing:-.01em;color:var(--wb-ink-2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}", - ".wb-status{display:flex;align-items:center;gap:5px;margin-top:1px;font-size:11px;color:var(--wb-ink-2);white-space:nowrap;min-width:0}", - ".wb-card.has-connect .wb-status{padding-right:30px}", - ".wb-status>span:last-child{overflow:hidden;text-overflow:ellipsis}", - ".wb-card{min-width:0}", - ".wb-connect{max-width:calc(100% - 10px);padding:2px 5px;font-size:9.5px}", - ".wb-dot{flex:none;width:8px;height:8px;border-radius:50%;background:var(--wb-gray)}", - ".wb-dot.is-idle{background:var(--wb-green)}", - ".wb-dot.is-running{background:var(--wb-blue)}", - ".wb-dot.is-attention{background:var(--wb-amber)}", - ".wb-connect{position:absolute;right:8px;bottom:7px;z-index:2;padding:3px 6px;border:1px solid var(--wb-line-strong);border-radius:5px;background:var(--wb-card);color:var(--wb-ink-2);font:inherit;font-size:10px;line-height:1;cursor:pointer}", - ".wb-connect:hover{border-color:var(--wb-blue);color:var(--wb-blue)}", - ".wb-connect:disabled{opacity:.6;cursor:default}", - ".wb-list{display:flex;flex-direction:column;gap:6px;padding:2px 0 8px}", - ".wb-list-head{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:0 2px 2px;color:var(--wb-ink-2);font-size:11px}", - ".wb-small-btn{border:1px solid var(--wb-line-strong);border-radius:6px;background:var(--wb-card);color:var(--wb-ink-2);font:inherit;font-size:10.5px;line-height:1;padding:4px 7px;cursor:pointer}", - ".wb-small-btn:hover{border-color:var(--wb-blue);color:var(--wb-blue)}", - ".wb-small-btn:disabled{opacity:.6;cursor:default}", - ".wb-task{border:1px solid var(--wb-line);border-radius:9px;background:var(--wb-card);padding:8px 9px;display:flex;flex-direction:column;gap:2px}", - ".wb-task-title{font-size:12px;font-weight:600;color:var(--wb-ink);word-break:break-word}", - ".wb-task-meta{font-size:10.5px;color:var(--wb-ink-3)}", - ".wb-task-body{margin-top:2px;font-size:11px;color:var(--wb-ink-2);display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}", - ".wb-task-actions{display:flex;gap:6px;justify-content:flex-end;margin-top:6px}", - ".wb-small-btn.is-quiet{border-color:var(--wb-line);color:var(--wb-ink-3)}", - ".wb-small-btn.is-quiet:hover{border-color:var(--wb-red,#d9534f);color:var(--wb-red,#d9534f)}", - ".wb-empty{margin:10px 2px;color:var(--wb-ink-3);font-size:11px;line-height:1.5}", - ".wb-form{display:flex;flex-direction:column;gap:6px;padding:8px;margin-bottom:2px;border:1px solid var(--wb-line);border-radius:9px;background:var(--wb-card)}", - ".wb-input,.wb-select,.wb-textarea{width:100%;border:1px solid var(--wb-line);border-radius:6px;background:var(--wb-bg);color:var(--wb-ink);font:inherit;font-size:11px;padding:5px 6px}", - ".wb-textarea{min-height:44px;resize:vertical}", - ".wb-form-row{display:flex;gap:6px;align-items:center;justify-content:flex-end}", - ".wb-artifact{display:flex;flex-direction:column;gap:2px;width:100%;text-align:left;border:1px solid var(--wb-line);border-radius:9px;background:var(--wb-card);color:inherit;font:inherit;padding:8px 9px;cursor:pointer}", - ".wb-artifact:hover{border-color:var(--wb-line-strong)}", - ".wb-artifact-name{font-size:12px;font-weight:600;color:var(--wb-ink);word-break:break-word}", - ".wb-artifact-meta{font-size:10.5px;color:var(--wb-ink-3)}", - ".wb-artifact.is-missing{border-style:dashed;border-color:#f2b8b5;background:#fff6f5}", - ".wb-artifact.is-missing .wb-artifact-name{color:#b42318}", - ".wb-artifact-flag{color:#b42318}", - ".wb-artifact-flag.is-unknown{color:var(--wb-ink-3)}", - ".wb-missing-note{margin:0;padding:7px 8px;border:1px solid #f2b8b5;border-radius:7px;background:#fff6f5;color:#b42318;font-size:11px;line-height:1.5}", - ".wb-task-tag{display:inline-block;margin-right:4px;padding:0 4px;border-radius:4px;background:rgba(59,130,246,.12);color:#2563eb;font-size:9.5px;font-weight:600}", - ".wb-task.is-new{outline:2px solid var(--wb-blue);outline-offset:1px}", - ".wb-drawer{position:absolute;top:0;right:0;bottom:0;z-index:6;display:flex;flex-direction:column;gap:8px;width:min(280px,82%);padding:12px;overflow-y:auto;border-left:1px solid var(--wb-line);background:var(--wb-card);box-shadow:-8px 0 24px rgba(16,24,40,.08)}", - ".wb-drawer-head{display:flex;align-items:center;justify-content:space-between;gap:8px}", - ".wb-drawer-title{font-size:12px;font-weight:600;color:var(--wb-ink-2)}", - ".wb-icon-btn{border:0;background:transparent;color:var(--wb-ink-3);font:inherit;font-size:16px;line-height:1;padding:2px 4px;border-radius:4px;cursor:pointer}", - ".wb-icon-btn:hover{background:var(--wb-bg);color:var(--wb-ink)}", - ".wb-field{display:flex;flex-direction:column;gap:2px}", - ".wb-field-label{font-size:10px;color:var(--wb-ink-3);letter-spacing:.02em}", - ".wb-field-value{font-size:11.5px;color:var(--wb-ink);word-break:break-word}", - ".wb-drawer-body{margin:0;font-size:11.5px;line-height:1.55;color:var(--wb-ink-2);white-space:pre-wrap;word-break:break-word}", - ".wb-tab-title{display:inline-flex;align-items:center;gap:4px}", - ".wb-main-split{display:flex;flex-direction:row;height:100%;min-width:0}", - ".wb-main-native{flex:1 1 auto;min-width:560px;min-height:0;height:100%;display:flex;flex-direction:column}", - ".wb-main-resizer{flex:0 0 2px;position:relative;width:2px;cursor:col-resize;background:rgba(127,127,127,.18)}", - ".wb-main-resizer::after{content:\"\";position:absolute;top:0;bottom:0;left:-4px;right:-4px}", - ".wb-main-resizer:hover{background:var(--wb-blue,#3b82f6)}", - ".wb-main-rail{flex:0 0 auto;height:100%;min-width:0;overflow:hidden;border-left:1px solid rgba(127,127,127,.12)}", - "@media (prefers-color-scheme: dark){.wb-rail{--wb-bg:#161a20;--wb-card:#1e232b;--wb-line:#2c333d;--wb-line-strong:#3a4350;--wb-ink:#e6ebf2;--wb-ink-2:#a9b4c2;--wb-ink-3:#7b8797;--wb-blue:#6ea8ff;--wb-green:#4ade80;--wb-amber:#f59e0b;--wb-gray:#5c6672;--wb-wire:#3a4350;--wb-dashed:#2f3742;--wb-group-bg:rgba(30,35,43,.6)}.wb-card.is-lead{background:linear-gradient(180deg,#1f2530 0%,#1e232b 100%);border-color:#3b4a63}.wb-card.is-running{border-color:#3b5a8a;background:#1d242f;box-shadow:0 0 0 2px rgba(110,168,255,.16),0 2px 8px rgba(110,168,255,.12)}.wb-alert{border-color:#5b2b2b;background:#2a1a1c;color:#fca5a5}.wb-alert.is-info{border-color:#245c3a;background:#12271b;color:#86efac}.wb-tabs,.wb-card,.wb-task,.wb-artifact,.wb-form{background:var(--wb-card)}.wb-tab.is-active{background:#242a33}.wb-drawer{box-shadow:-8px 0 24px rgba(0,0,0,.35)}.wb-artifact.is-missing{border-color:#6b3a36;background:#2a1c1c}.wb-artifact.is-missing .wb-artifact-name{color:#fca5a5}.wb-artifact-flag{color:#fca5a5}.wb-artifact-flag.is-unknown{color:var(--wb-ink-3)}.wb-missing-note{border-color:#6b3a36;background:#2a1c1c;color:#fca5a5}.wb-task-tag{background:rgba(110,168,255,.16);color:#9cc4ff}}", - ].join(""); - - function injectCss() { - if (typeof document === "undefined" || !document || typeof document.createElement !== "function") return; - try { - var selector = "style[data-plugin-css=" + JSON.stringify(CSS_ID) + "]"; - if (typeof document.querySelector === "function" && document.querySelector(selector) !== null) return; - var tag = document.createElement("style"); - tag.dataset.plugin = "dsh-sansheng-liubu-workbench"; - tag.dataset.pluginCss = CSS_ID; - tag.textContent = CSS; - if (document.head && typeof document.head.appendChild === "function") document.head.appendChild(tag); - } catch (error) { - // 样式失败不阻断面板功能。 - } - } - - injectCss(); - - // --------------------------------------------------------------------- - // 纯 UI 小工具 - // --------------------------------------------------------------------- - - const BOUND_PROJECT_CACHE = new Map(); - - function readRailWidth() { - try { - var stored = Number(localStorage.getItem(RAIL_WIDTH_KEY)); - if (isFinite(stored) && stored > 0) return clamp(stored, RAIL_MIN, RAIL_MAX); - } catch (error) { - // localStorage 不可用时用默认值。 - } - return RAIL_DEFAULT; - } - - function saveRailWidth(width) { - try { - localStorage.setItem(RAIL_WIDTH_KEY, String(Math.round(clamp(width, RAIL_MIN, RAIL_MAX)))); - } catch (error) { - // 忽略。 - } - } - - function mainTakeoverEnabled() { - try { - return String(localStorage.getItem(MAIN_SWITCH_KEY) || "") !== "off"; - } catch (error) { - return true; - } - } - - function shortTime(value) { - if (!value) return ""; - var text = String(value); - return text.length >= 16 ? text.slice(0, 16).replace("T", " ") : text; - } - - function emptyTaskForm() { - return { title: "", objective: "", ownerRoleId: "lead" }; - } - - function seatsFor(data) { - var byId = {}; - var rows = data && Array.isArray(data.seats) ? data.seats : []; - for (var i = 0; i < rows.length; i++) { - if (rows[i] && rows[i].roleId) byId[rows[i].roleId] = rows[i]; - } - return ROLE_ORDER.map(function (roleId) { - if (byId[roleId]) return byId[roleId]; - var meta = ROLE_META[roleId]; - return { - roleId: roleId, - name: meta.name, - short: meta.name, - tier: meta.tier, - group: meta.group, - column: meta.column, - row: meta.row, - duty: meta.duty, - connected: false, - pending: true, - pendingLabel: "尚未接通", - activeTaskId: null, - binding: null, - config: null, - placeholder: true, - }; - }); - } - - function findResultForArtifact(results, artifact) { - if (!Array.isArray(results) || !artifact) return null; - if (artifact.sourceResultId) { - for (var i = 0; i < results.length; i++) { - if (results[i] && results[i].id === artifact.sourceResultId) return results[i]; - } - } - for (var j = 0; j < results.length; j++) { - var result = results[j]; - if (result && Array.isArray(result.artifactRefs) && result.artifactRefs.indexOf(artifact.id) >= 0) return result; - } - return null; - } - - // 成果存在性:missing 是宿主确认文件已不在;unknown 只表示没核验过, - // 绝不能当成“正常”,也不能用警告色吓人。 - function existenceLabel(existence) { - if (existence === "missing") return "文件已失效"; - if (existence === "unknown") return "位置未核验"; - return ""; - } - - // 原始 verification.status 是英文枚举,直接摆在「文件已失效」旁边会读成自相矛盾: - // 「已核验」说的是结果被核验过,不是文件现在还在。 - function verificationLabel(status) { - if (status === "verified") return "已核验"; - if (status === "rejected") return "未通过"; - if (status === "unverified") return "未核验"; - return "核验未知"; - } - - function revisionLabel(artifact) { - var revision = Number(artifact && artifact.revision); - if (!isFinite(revision) || revision < 1) revision = 1; - revision = Math.floor(revision); - var text = "第 " + revision + " 版"; - if (revision > 1 && artifact && artifact.revisesArtifactId) { - text += " · 修订自上一版"; - } - return text; - } - - function taskKindLabel(task) { - return task && task.kind === "revision" ? "修订" : ""; - } - - // 任务行上该有哪几个动作,纯函数,UI 与测试共用一份判断。 - function taskActionKeys(task) { - var keys = []; - if (!task || typeof task !== "object") return keys; - if (task.status === "draft" || task.status === "queued") keys.push("dispatch"); - if (task.status === "queued" || task.status === "running" || task.status === "needs_attention") keys.push("cancel"); - return keys; - } - - function conversationPhase(session, conversation) { - if (!session || !conversation) return "blank"; - var activeTargets = conversation.activeTargets; - var hasActiveTargets = activeTargets && typeof activeTargets.size === "number" && activeTargets.size > 0; - if (hasActiveTargets) return "active"; - if (!session.blank && !session.awaitingFirstTurn) return "active"; - if (session.running) return "active"; - return session.promptAttempted ? "engaging" : "blank"; - } - - function useBoundProject(ctx, sessionId) { - var state = React.useState(null); - var projectId = state[0]; - var setProjectId = state[1]; - - React.useEffect(function () { - if (!sessionId) { - setProjectId(null); - return undefined; - } - var cancelled = false; - findBoundProject(ctx, sessionId) - .then(function (found) { - if (!cancelled) setProjectId(found); - }) - .catch(function () { - if (!cancelled) setProjectId(null); - }); - return function () { - cancelled = true; - }; - }, [ctx, sessionId]); - - return projectId; - } - - // 分隔条的键盘语义抽成纯函数:同一套键位在真浏览器和单测里走同一条代码。 - // 不支持的键返回 null(调用方据此决定是否 preventDefault)。 - function railResizeTarget(key, options) { - var opts = options || {}; - var width = Number(opts.width); - if (!isFinite(width)) width = RAIL_MIN; - var step = opts.shift ? 64 : 16; - if (key === "ArrowLeft") return clamp(width - step, RAIL_MIN, RAIL_MAX); - if (key === "ArrowRight") return clamp(width + step, RAIL_MIN, RAIL_MAX); - if (key === "Home") return RAIL_MIN; - if (key === "End") return RAIL_MAX; - return null; - } - - function useRailWidth() { - var state = React.useState(readRailWidth()); - var width = state[0]; - var setWidth = state[1]; - var cleanupRef = React.useRef(null); - - React.useEffect(function () { - return function () { - if (cleanupRef.current) cleanupRef.current(); - }; - }, []); - - function onMouseDown(event) { - if (event && typeof event.preventDefault === "function") event.preventDefault(); - var session = { x: Number(event.clientX) || 0, width: width, last: width }; - function onMove(moveEvent) { - var next = clamp(session.width - ((Number(moveEvent.clientX) || 0) - session.x), RAIL_MIN, RAIL_MAX); - session.last = next; - setWidth(next); - } - function cleanup() { - if (typeof document !== "undefined" && document.removeEventListener) { - document.removeEventListener("mousemove", onMove); - document.removeEventListener("mouseup", onUp); - } - cleanupRef.current = null; - } - function onUp() { - cleanup(); - saveRailWidth(session.last); - } - if (typeof document !== "undefined" && document.addEventListener) { - document.addEventListener("mousemove", onMove); - document.addEventListener("mouseup", onUp); - cleanupRef.current = cleanup; - } - } - - function nudge(delta) { - var next = clamp(width + delta, RAIL_MIN, RAIL_MAX); - if (next === width) return; - setWidth(next); - saveRailWidth(next); - } - - return [width, onMouseDown, nudge]; - } - - // --------------------------------------------------------------------- - // 组件 - // --------------------------------------------------------------------- - - class PanelBoundary extends React.Component { - constructor(props) { - super(props); - this.state = { error: null }; - } - - static getDerivedStateFromError(error) { - return { error: error }; - } - - componentDidCatch(error) { - try { - console.error("[sansheng-workbench] 面板渲染失败", error); - } catch (ignored) { - // 忽略日志失败。 - } - } - - render() { - if (this.state.error) { - return h("div", { className: "wb-alert", role: "alert" }, [ - h("span", { className: "wb-alert-text" }, "工作台面板渲染失败:" + (this.state.error.message || String(this.state.error))), - ]); - } - return this.props.children; - } - } - - function SeatCard(props) { - var seat = props.seat; - var meta = ROLE_META[seat.roleId] || {}; - var binding = seat.binding || null; - var sessionId = binding && (binding.currentSessionId || binding.sessionId); - var status = seat.placeholder - ? "loading" - : (binding && binding.status) || (seat.connected ? "idle" : "uninitialized"); - var label = seat.placeholder ? "读取中…" : statusOf(status); - var name = seatDisplayName(seat); - var model = formatModelLine(seat.config); - var fullModel = modelTitle(seat.config); - var isLead = seat.roleId === "lead"; - var showConnect = !seat.placeholder && !seat.connected; - var classes = ["wb-card"]; - if (isLead) classes.push("is-lead"); - if (status === "running") classes.push("is-running"); - if (status === "needs_attention") classes.push("is-attention"); - if (status === "unavailable") classes.push("is-unavailable"); - if (showConnect) classes.push("has-connect"); - - function activate() { - if (props.onActivate) props.onActivate(seat); - } - - function onKeyDown(event) { - if (!event) return; - if (event.key === "Enter" || event.key === " " || event.key === "Spacebar") { - if (typeof event.preventDefault === "function") event.preventDefault(); - activate(); - } - } - - var children = [ - h("span", { className: "wb-kicker", key: "kicker" }, meta.kicker || ""), - h("span", { className: "wb-name", key: "name" }, name), - h("span", { className: "wb-model", key: "model", title: fullModel }, model), - h("span", { className: "wb-status", key: "status" }, [ - h("span", { className: "wb-dot is-" + status, key: "dot" }), - h("span", { key: "label" }, label), - ]), - ]; - - if (showConnect) { - children.push(h("button", { - key: "connect", - type: "button", - className: "wb-connect", - disabled: Boolean(props.connecting), - onClick: function (event) { - if (event && typeof event.stopPropagation === "function") event.stopPropagation(); - if (props.onConnect) props.onConnect(seat); - }, - }, props.connecting ? "接通中…" : "接通")); - } - - return h("div", { - className: classes.join(" "), - ref: props.cardRef, - role: "button", - tabIndex: 0, - title: [seat.duty || meta.duty || "", fullModel].filter(Boolean).join(" · "), - "aria-label": (seat.name || name) + "," + label + (sessionId ? ",点击打开会话" : ""), - onClick: activate, - onKeyDown: onKeyDown, - }, children); - } - - function WorkbenchRail(props) { - var ctx = props.ctx; - var compact = props.compact !== false; - - var viewState = React.useState("court"); - var view = viewState[0]; - var setView = viewState[1]; - - var projectState = React.useState(props.projectId || null); - var projectId = projectState[0]; - var setProjectId = projectState[1]; - - var dataState = React.useState(null); - var data = dataState[0]; - var setData = dataState[1]; - - var errorState = React.useState(null); - var error = errorState[0]; - var setError = errorState[1]; - - var noticeState = React.useState(null); - var notice = noticeState[0]; - var setNotice = noticeState[1]; - - // 提示语气:成功用 info(绿),失败/警告用 error(红)。默认红——凡是没显式说 - // "这是好消息"的提示,多半是用户在排障。 - var noticeToneState = React.useState("error"); - var noticeTone = noticeToneState[0]; - var setNoticeTone = noticeToneState[1]; - - function announce(message, tone) { - setNoticeTone(tone || "error"); - setNotice(message); - } - - var connectingState = React.useState(null); - var connecting = connectingState[0]; - var setConnecting = connectingState[1]; - - var artifactState = React.useState(null); - var selectedArtifactId = artifactState[0]; - var setSelectedArtifactId = artifactState[1]; - - var formOpenState = React.useState(false); - var taskFormOpen = formOpenState[0]; - var setTaskFormOpen = formOpenState[1]; - - var formState = React.useState(emptyTaskForm()); - var taskForm = formState[0]; - var setTaskForm = formState[1]; - - var taskBusyState = React.useState(false); - var taskBusy = taskBusyState[0]; - var setTaskBusy = taskBusyState[1]; - - // 任务行上的「派工 / 取消」:存 taskId,防止同一行被连点两次。 - var dispatchBusyState = React.useState(null); - var dispatchBusy = dispatchBusyState[0]; - var setDispatchBusy = dispatchBusyState[1]; - - var reviseOpenState = React.useState(false); - var reviseOpen = reviseOpenState[0]; - var setReviseOpen = reviseOpenState[1]; - - var reviseTextState = React.useState(""); - var reviseText = reviseTextState[0]; - var setReviseText = reviseTextState[1]; - - // null | "draft" | "queued":标明正在提交哪个按钮,防止重复点。 - var reviseBusyState = React.useState(null); - var reviseBusy = reviseBusyState[0]; - var setReviseBusy = reviseBusyState[1]; - - var highlightTaskState = React.useState(null); - var highlightTaskId = highlightTaskState[0]; - var setHighlightTaskId = highlightTaskState[1]; - var highlightTimerRef = React.useRef(null); - - var reloadState = React.useState(0); - var reloadToken = reloadState[0]; - var setReloadToken = reloadState[1]; - - var projectIdRef = React.useRef(projectId); - var seqRef = React.useRef(0); - var hostRef = React.useRef(null); - var loadTokenRef = React.useRef(0); - var aliveRef = React.useRef(true); - var treeRef = React.useRef(null); - var leadRef = React.useRef(null); - var groupRef = React.useRef(null); - var sanRefs = React.useRef({}); - - // 首帧先给一份 400px 的几何连线,保证即使宿主/预览器不跑 effect 也能看见树; - // 真实浏览器随后用 getBoundingClientRect 校正到实际栏宽。 - var initialLayout = computeRailLayout(400); - var wireState = React.useState({ - width: initialLayout.width, - height: initialLayout.height, - paths: wirePathsFromLayout(initialLayout), - }); - var wires = wireState[0]; - var setWires = wireState[1]; - - projectIdRef.current = projectId; - - React.useEffect(function () { - aliveRef.current = true; - return function () { - aliveRef.current = false; - if (highlightTimerRef.current) { - clearTimeout(highlightTimerRef.current); - highlightTimerRef.current = null; - } - }; - }, []); - - function applyBootstrap(result, token) { - if (token !== undefined && token !== loadTokenRef.current) return; - if (!aliveRef.current) return; - projectIdRef.current = result.projectId; - seqRef.current = Number(result.value && result.value.eventSeq) || 0; - setProjectId(result.projectId); - setData(result.value); - } - - // 首屏 / 项目切换 / 手动重试:整树重取,绝不沿用上一个项目的 seats。 - React.useEffect(function () { - var cancelled = false; - var token = ++loadTokenRef.current; - setData(null); - setError(null); - setSelectedArtifactId(null); - setNotice(null); - hostRef.current = workspaceIdOf(ctx); - - var loading; - if (props.projectId) { - loading = apiGet("bootstrap", { projectId: props.projectId }).then(function (value) { - return { projectId: props.projectId, value: value }; - }); - } else { - loading = resolveWorkbenchProject(ctx); - } - - loading.then(function (result) { - if (cancelled) return; - applyBootstrap(result, token); - }).catch(function (failure) { - if (cancelled) return; - if (token !== loadTokenRef.current) return; - setError(describeError(failure)); - }); - - return function () { - cancelled = true; - }; - }, [ctx, props.projectId, reloadToken]); - - // 工作区切换:换项目就整树重取。 - React.useEffect(function () { - if (props.projectId) return undefined; - var workspace = ctx && ctx.uiWorkspace; - if (!workspace) return undefined; - var disposers = []; - var pendingToken = 0; - var cancelled = false; - - function check() { - var next = workspaceIdOf(ctx); - if (!next || next === hostRef.current) return; - hostRef.current = next; - var token = ++pendingToken; - var loadToken = ++loadTokenRef.current; - setData(null); - setSelectedArtifactId(null); - setNotice(null); - setError(null); - resolveWorkbenchProject(ctx).then(function (result) { - if (cancelled || token !== pendingToken) return; - applyBootstrap(result, loadToken); - }).catch(function (failure) { - if (cancelled || token !== pendingToken) return; - if (loadToken === loadTokenRef.current) setError(describeError(failure)); - }); - } - - var selection = workspace.selection; - if (selection && typeof selection.subscribe === "function") { - var off = selection.subscribe(check); - if (typeof off === "function") disposers.push(off); - } - if (typeof workspace.subscribe === "function") { - var offWorkspace = workspace.subscribe(check); - if (typeof offWorkspace === "function") disposers.push(offWorkspace); - } - if (typeof workspace.on === "function") { - var offEvent = workspace.on("change", check); - if (typeof offEvent === "function") disposers.push(offEvent); - } - - return function () { - cancelled = true; - for (var i = 0; i < disposers.length; i++) { - try { - disposers[i](); - } catch (ignored) { - // 忽略取消订阅失败。 - } - } - }; - }, [ctx, props.projectId]); - - // 长轮询:事件只作为“该刷新了”的信号,状态一律回读账本,绝不猜。 - React.useEffect(function () { - if (!projectId) return undefined; - var stopped = false; - var paused = false; - var inflight = false; - var timer = null; - var controller = null; - - function schedule(delay) { - if (stopped) return; - timer = setTimeout(run, delay); - } - - function refresh(mode) { - return apiGet("bootstrap", { projectId: projectId }).then(function (value) { - if (stopped || !aliveRef.current) return null; - if (projectIdRef.current !== projectId) return null; - var seq = Number(value && value.eventSeq); - if (isFinite(seq)) seqRef.current = Math.max(seqRef.current, seq); - setData(function (previous) { - if (!previous || previous.projectId !== value.projectId) return value; - if (mode === "seats") { - return assign({}, previous, { seats: value.seats, eventSeq: value.eventSeq }); - } - return assign({}, previous, { - seats: value.seats, - tasks: value.tasks, - artifacts: value.artifacts, - results: value.results, - project: value.project || previous.project, - projects: value.projects || previous.projects, - eventSeq: value.eventSeq, - }); - }); - return value; - }); - } - - function run() { - if (stopped || inflight) return; - timer = null; - if (paused) { - schedule(1500); - return; - } - inflight = true; - var localController = typeof AbortController === "function" ? new AbortController() : null; - controller = localController; - - apiGet("events", { projectId: projectId, since: seqRef.current }, { - signal: localController ? localController.signal : undefined, - }).then(function (result) { - if (stopped) return undefined; - var events = result && Array.isArray(result.events) ? result.events : []; - if (result && result.reset) { - seqRef.current = Number(result.seq) || 0; - return refresh("full").then(function () { - schedule(120); - }); - } - if (events.length > 0) { - var merged = mergeEvents([], events); - var maxSeq = Number(result.seq) || 0; - for (var i = 0; i < merged.length; i++) { - maxSeq = Math.max(maxSeq, Number(merged[i].seq) || 0); - } - seqRef.current = Math.max(seqRef.current, maxSeq); - var mode = isSeatOnlyEventBatch(merged) ? "seats" : "full"; - return refresh(mode).then(function () { - schedule(result.hasMore ? 0 : 120); - }); - } - var seq = Number(result && result.seq); - if (isFinite(seq)) seqRef.current = Math.max(seqRef.current, seq); - schedule(result && result.hasMore ? 0 : 250); - return undefined; - }).catch(function (failure) { - if (stopped) return; - if (failure && failure.name === "AbortError") return; - setNotice(describeError(failure)); - schedule(2500); - }).then(function () { - inflight = false; - controller = null; - }); - } - - function onVisibilityChange() { - if (typeof document !== "undefined" && document.hidden) { - paused = true; - if (timer) { - clearTimeout(timer); - timer = null; - } - if (controller) controller.abort(); - return; - } - paused = false; - if (!inflight) run(); - } - - if (typeof document !== "undefined" && document.addEventListener) { - document.addEventListener("visibilitychange", onVisibilityChange); - } - run(); - - return function () { - stopped = true; - if (timer) clearTimeout(timer); - if (controller) controller.abort(); - if (typeof document !== "undefined" && document.removeEventListener) { - document.removeEventListener("visibilitychange", onVisibilityChange); - } - }; - }, [projectId]); - - // 连线:每次渲染后按真实 rect 现算,窄栏/字体差异都不会错位。 - React.useEffect(function () { - if (view !== "court") return undefined; - var tree = treeRef.current; - if (!tree || typeof tree.getBoundingClientRect !== "function") return undefined; - - // 真实布局量不到时(离线预览替身 DOM、隐藏 tab 里 rect 全 0)的兜底: - // 用 computeRailLayout 的几何盒子算同一组贝塞尔,公式与真实测量完全一致。 - function fallbackWires(widthHint) { - var width = Number(widthHint) > 0 ? Number(widthHint) : 0; - if (!width) { - try { - width = tree.clientWidth || 0; - } catch (ignored) { - width = 0; - } - } - var layout = computeRailLayout(width || 400); - return { width: layout.width, height: layout.height, paths: wirePathsFromLayout(layout) }; - } - - function measure() { - var box = tree.getBoundingClientRect(); - if (!box || !box.width) { - setWires(fallbackWires(0)); - return; - } - - function rel(element) { - var rect = element.getBoundingClientRect(); - return { - top: rect.top - box.top, - bottom: rect.bottom - box.top, - left: rect.left - box.left, - cx: rect.left - box.left + rect.width / 2, - }; - } - - var paths = []; - var lead = leadRef.current; - if (lead) { - var leadRect = rel(lead); - var sanIds = ["zhongshu", "shangshu", "menxia"]; - for (var i = 0; i < sanIds.length; i++) { - var element = sanRefs.current[sanIds[i]]; - if (!element) continue; - var cardRect = rel(element); - var y0 = leadRect.bottom; - var y1 = cardRect.top; - if (!(y1 > y0)) continue; - paths.push({ - key: "lead-" + sanIds[i], - kind: "branch", - d: branchPathD(leadRect.cx, y0, cardRect.cx, y1), - }); - } - } - - var shangshu = sanRefs.current.shangshu; - var group = groupRef.current; - if (shangshu && group) { - var shangshuRect = rel(shangshu); - var groupRect = rel(group); - if (groupRect.top > shangshuRect.bottom) { - paths.push({ - key: "trunk", - kind: "trunk", - d: "M " + round(shangshuRect.cx) + " " + round(shangshuRect.bottom) + - " L " + round(shangshuRect.cx) + " " + round(groupRect.top), - }); - } - } - - if (paths.length === 0) { - // 关键 rect 全是 0(替身 DOM)时不能把 0 传给 。 - setWires(fallbackWires(box.width)); - return; - } - setWires({ width: Math.round(box.width), height: Math.round(box.height), paths: paths }); - } - - measure(); - var observer = null; - if (typeof ResizeObserver === "function") { - observer = new ResizeObserver(function () { - measure(); - }); - observer.observe(tree); - } - if (typeof window !== "undefined" && window.addEventListener) window.addEventListener("resize", measure); - - return function () { - if (observer) observer.disconnect(); - if (typeof window !== "undefined" && window.removeEventListener) window.removeEventListener("resize", measure); - }; - }, [view, data]); - - var seats = seatsFor(data); - var connectedCount = 0; - for (var seatIndex = 0; seatIndex < seats.length; seatIndex++) { - if (seats[seatIndex].connected) connectedCount += 1; - } - var metaText = "十席 · " + connectedCount + " 席已接通"; - - function activateSeat(seat) { - var binding = seat && seat.binding; - var sessionId = binding && (binding.currentSessionId || binding.sessionId); - if (!sessionId) return; - var failure = openSession(ctx, sessionId); - if (typeof failure === "string") setNotice("打开会话失败:" + failure); - } - - function connectSeat(seat) { - if (!projectId || connecting) return; - setConnecting(seat.roleId); - setNotice(null); - apiPost("connect", { projectId: projectId, roleId: seat.roleId }).then(function (result) { - var sessionId = result && ( - result.sessionId || - (result.seat && result.seat.binding && (result.seat.binding.currentSessionId || result.seat.binding.sessionId)) - ); - return apiGet("bootstrap", { projectId: projectId }).then(function (value) { - if (!aliveRef.current) return; - if (projectIdRef.current === projectId) { - seqRef.current = Math.max(seqRef.current, Number(value.eventSeq) || 0); - setData(value); - } - if (sessionId) { - var failure = openSession(ctx, sessionId); - if (typeof failure === "string") { - announce("已接通,但打开会话失败:" + failure, "error"); - } else { - announce("已接通。现在可以去任务页派工了。", "info"); - } - } else { - announce("已接通,但宿主没有返回会话号;请重试或检查宿主会话能力。", "error"); - } - }); - }).catch(function (failure) { - setNotice(describeError(failure)); - }).then(function () { - setConnecting(null); - }); - } - - function submitTask(event) { - if (event && typeof event.preventDefault === "function") event.preventDefault(); - if (!projectId) { - setNotice("还没有定位到工作台项目,无法新建任务。"); - return; - } - var title = String(taskForm.title || "").trim(); - var objective = String(taskForm.objective || "").trim(); - if (!title || !objective) { - setNotice("新建任务需要填写标题和目标。"); - return; - } - setTaskBusy(true); - setNotice(null); - apiPost("task", { - projectId: projectId, - title: title, - objective: objective, - ownerRoleId: taskForm.ownerRoleId || "lead", - sourceRoleId: "lead", - // 服务端 queued 要求该部门已接通会话;界面不替用户做这个决定,先存草稿。 - status: "draft", - }).then(function () { - return apiGet("bootstrap", { projectId: projectId }); - }).then(function (value) { - if (!aliveRef.current) return; - if (projectIdRef.current === projectId) { - seqRef.current = Math.max(seqRef.current, Number(value.eventSeq) || 0); - setData(value); - } - setTaskForm(emptyTaskForm()); - setTaskFormOpen(false); - announce("已存为草稿。去任务页点「派工」才会交给部门。", "info"); - }).catch(function (failure) { - setNotice(describeError(failure)); - }).then(function () { - setTaskBusy(false); - }); - } - - // 派工:把队列里的任务真正交给主责部门的会话。 - // 宿主的 /dispatch 需要 targetSessionId + bindingGeneration 才肯真的发送; - // 缺这两项时后端只会把派发记成 prepared("已备好、没发出"),所以这里先检查席位。 - function dispatchTaskItem(task) { - if (!projectId || !task || dispatchBusy) return; - var seat = null; - for (var i = 0; i < seats.length; i += 1) { - if (seats[i] && seats[i].roleId === task.ownerRoleId) { - seat = seats[i]; - break; - } - } - var binding = seat && seat.binding; - var sessionId = binding && (binding.currentSessionId || binding.sessionId); - if (!sessionId) { - setNotice("「" + (ROLE_META[task.ownerRoleId] ? ROLE_META[task.ownerRoleId].name : task.ownerRoleId) + "」还没接通会话,先在朝堂里点「接通」。"); - return; - } - setDispatchBusy(task.id); - setNotice(null); - var body = { - projectId: projectId, - taskId: task.id, - // 幂等键:同一张任务重复点不会派出两份,后端会返回既有那条。 - idempotencyKey: "ui:" + task.id, - sourceRoleId: "lead", - targetRoleId: task.ownerRoleId, - targetSessionId: sessionId, - bindingGeneration: binding.bindingGeneration, - mode: "queue", - }; - apiPost("dispatch", body).then(function (result) { - var record = result && (result.dispatch || result); - var status = record && (record.status || record.state); - return apiGet("bootstrap", { projectId: projectId }).then(function (value) { - if (aliveRef.current && projectIdRef.current === projectId) { - seqRef.current = Math.max(seqRef.current, Number(value.eventSeq) || 0); - setData(value); - } - if (status === "accepted") announce("已派出,部门会话里能看到这条任务。", "info"); - else if (status === "prepared") announce("已记入台账,但宿主没接上会话层,暂时没有真的发出。", "error"); - else if (status === "unknown") announce("宿主可能已经收到,但账上没拿到确认;先别重派,等对账。", "error"); - else if (result && result.duplicate) announce("这条任务之前已经派过,没有重复发送。", "info"); - }); - }).catch(function (failure) { - setNotice(describeError(failure)); - }).then(function () { - setDispatchBusy(null); - }); - } - - function cancelTaskItem(task) { - if (!projectId || !task || dispatchBusy) return; - setDispatchBusy(task.id); - setNotice(null); - apiPost("task/cancel", { projectId: projectId, taskId: task.id }).then(function () { - return apiGet("bootstrap", { projectId: projectId }); - }).then(function (value) { - if (!aliveRef.current) return; - if (projectIdRef.current === projectId) { - seqRef.current = Math.max(seqRef.current, Number(value.eventSeq) || 0); - setData(value); - } - announce("已取消。", "info"); - }).catch(function (failure) { - setNotice(describeError(failure)); - }).then(function () { - setDispatchBusy(null); - }); - } - - // A22:不重跑三省,只给原主责部门开一条修订任务。 - function submitRevision(artifact, status) { - if (!projectId || !artifact) { - setNotice("还没有定位到工作台项目或成果,无法提交修订。"); - return; - } - var instruction = String(reviseText || "").trim(); - if (!instruction) { - setNotice("请先写清楚要主责部门改什么。"); - return; - } - if (reviseBusy) return; - var targetProjectId = projectId; - setReviseBusy(status); - setNotice(null); - apiPost("artifact/revision", { - projectId: targetProjectId, - artifactId: artifact.id, - instruction: instruction, - status: status, - }).then(function (value) { - var createdTaskId = value && value.task && value.task.id ? value.task.id : null; - return apiGet("bootstrap", { projectId: targetProjectId }).then(function (next) { - if (!aliveRef.current || projectIdRef.current !== targetProjectId) return; - seqRef.current = Math.max(seqRef.current, Number(next && next.eventSeq) || 0); - setData(next); - setReviseOpen(false); - setReviseText(""); - setSelectedArtifactId(null); - setView("tasks"); - if (createdTaskId) { - setHighlightTaskId(createdTaskId); - if (highlightTimerRef.current) clearTimeout(highlightTimerRef.current); - highlightTimerRef.current = setTimeout(function () { - highlightTimerRef.current = null; - if (aliveRef.current) setHighlightTaskId(null); - }, 2600); - } - }); - }).catch(function (failure) { - if (!aliveRef.current) return; - var message = describeError(failure); - // 服务端 INVALID_STATE 的原文就是「尚未接通会话」;这里补一句怎么解决。 - if (failure && (failure.code === "INVALID_STATE" || String(message).indexOf("尚未接通") >= 0)) { - message += " 请先在「朝堂」里接通主责部门,再点「直接派工」。"; - } - setNotice(message); - }).then(function () { - if (aliveRef.current) setReviseBusy(null); - }); - } - - function switchView(next) { - setView(next); - if (next !== "artifacts") { - setSelectedArtifactId(null); - setReviseOpen(false); - setReviseText(""); - setReviseBusy(null); - } - } - - function tabButton(key, label) { - var active = view === key; - return h("button", { - key: key, - type: "button", - role: "tab", - "aria-selected": active, - className: "wb-tab" + (active ? " is-active" : ""), - onClick: function () { - switchView(key); - }, - }, label); - } - - function renderCourt() { - var seatNodes = seats; - var byId = {}; - for (var i = 0; i < seatNodes.length; i++) byId[seatNodes[i].roleId] = seatNodes[i]; - - function cardRef(roleId) { - return function (element) { - if (roleId === "lead") leadRef.current = element; - if (roleId === "zhongshu" || roleId === "shangshu" || roleId === "menxia") { - sanRefs.current[roleId] = element; - } - }; - } - - function renderCard(roleId) { - var seat = byId[roleId]; - if (!seat) return null; - return h(SeatCard, { - key: roleId, - seat: seat, - cardRef: cardRef(roleId), - connecting: connecting === roleId, - onActivate: activateSeat, - onConnect: connectSeat, - }); - } - - var sanIds = ["zhongshu", "shangshu", "menxia"]; - var firstRow = ["libu", "hubu", "lipu"]; - var secondRow = ["bingbu", "xingbu", "gongbu"]; - - return h("div", { className: "wb-tree", ref: treeRef }, [ - h("svg", { - key: "wires", - className: "wb-wires", - width: wires.width || 0, - height: wires.height || 0, - "aria-hidden": "true", - }, wires.paths.map(function (wire) { - return h("path", { - key: wire.key, - className: wire.kind === "trunk" ? "wb-wire is-trunk" : "wb-wire", - d: wire.d, - }); - })), - h("div", { className: "wb-lead-row", key: "lead" }, [renderCard("lead")]), - h("div", { className: "wb-trio", key: "sansheng" }, sanIds.map(renderCard)), - h("div", { className: "wb-group", ref: groupRef, key: "ministries" }, [ - h("span", { className: "wb-group-label", key: "label" }, "六部 · 同级"), - h("div", { className: "wb-six", key: "six" }, firstRow.concat(secondRow).map(renderCard)), - ]), - ]); - } - - function renderTasks() { - var tasks = data && Array.isArray(data.tasks) ? data.tasks : []; - var ownerOptions = ROLE_ORDER.map(function (roleId) { - return h("option", { key: roleId, value: roleId }, ROLE_META[roleId].name); - }); - - return h("div", { className: "wb-list" }, [ - h("div", { className: "wb-list-head", key: "head" }, [ - h("span", { key: "count" }, "任务 · " + tasks.length), - h("button", { - key: "new", - type: "button", - className: "wb-small-btn", - onClick: function () { - setTaskFormOpen(!taskFormOpen); - }, - }, taskFormOpen ? "收起" : "新建"), - ]), - taskFormOpen ? h("form", { className: "wb-form", key: "form", onSubmit: submitTask }, [ - h("input", { - key: "title", - className: "wb-input", - placeholder: "标题", - value: taskForm.title, - onChange: function (event) { - setTaskForm(assign({}, taskForm, { title: event.target.value })); - }, - }), - h("textarea", { - key: "objective", - className: "wb-textarea", - placeholder: "目标(交给部门做什么)", - value: taskForm.objective, - onChange: function (event) { - setTaskForm(assign({}, taskForm, { objective: event.target.value })); - }, - }), - h("select", { - key: "owner", - className: "wb-select", - value: taskForm.ownerRoleId, - onChange: function (event) { - setTaskForm(assign({}, taskForm, { ownerRoleId: event.target.value })); - }, - }, ownerOptions), - h("div", { className: "wb-form-row", key: "actions" }, [ - h("button", { key: "submit", type: "submit", className: "wb-small-btn", disabled: taskBusy }, taskBusy ? "提交中…" : "存为草稿"), - ]), - ]) : null, - tasks.length === 0 ? h("p", { className: "wb-empty", key: "empty" }, "这个项目还没有任务。点「新建」先存一张草稿。") : null, - tasks.map(function (task) { - var owner = task.ownerRoleId && ROLE_META[task.ownerRoleId] ? ROLE_META[task.ownerRoleId].name : (task.ownerRoleId || "—"); - var status = TASK_STATUS_LABELS[task.status] || task.status || "—"; - var kind = taskKindLabel(task); - var titleText = task.title || "(未命名)"; - var busy = dispatchBusy === task.id; - var actionKeys = taskActionKeys(task); - var canDispatch = actionKeys.indexOf("dispatch") !== -1; - var canCancel = actionKeys.indexOf("cancel") !== -1; - var actions = []; - if (canDispatch) { - actions.push(h("button", { - key: "dispatch", - type: "button", - className: "wb-small-btn", - disabled: busy, - title: "把这条任务交给主责部门的会话", - onClick: function (event) { - if (event && typeof event.stopPropagation === "function") event.stopPropagation(); - dispatchTaskItem(task); - }, - }, busy ? "派工中…" : "派工")); - } - if (canCancel) { - actions.push(h("button", { - key: "cancel", - type: "button", - className: "wb-small-btn is-quiet", - disabled: busy, - title: "取消这条任务(不影响已经发生的对话)", - onClick: function (event) { - if (event && typeof event.stopPropagation === "function") event.stopPropagation(); - cancelTaskItem(task); - }, - }, "取消")); - } - return h("div", { - className: "wb-task" + (highlightTaskId && task.id === highlightTaskId ? " is-new" : ""), - key: task.id || task.title, - }, [ - h("div", { className: "wb-task-title", key: "title" }, kind - ? [h("span", { className: "wb-task-tag", key: "kind" }, kind), titleText] - : titleText), - h("div", { className: "wb-task-meta", key: "meta" }, owner + " · " + status + (task.updatedAt ? " · " + shortTime(task.updatedAt) : "")), - task.objective ? h("div", { className: "wb-task-body", key: "body" }, task.objective) : null, - actions.length ? h("div", { className: "wb-task-actions", key: "actions" }, actions) : null, - ]); - }), - ]); - } - - function renderArtifacts() { - var artifacts = data && Array.isArray(data.artifacts) ? data.artifacts : []; - return h("div", { className: "wb-list" }, [ - h("div", { className: "wb-list-head", key: "head" }, [ - h("span", { key: "count" }, "成果 · " + artifacts.length), - h("span", { key: "hint", style: { fontSize: "10px", color: "var(--wb-ink-3)" } }, "点一行看详情"), - ]), - artifacts.length === 0 ? h("p", { className: "wb-empty", key: "empty" }, "这个项目还没有登记成果。") : null, - artifacts.map(function (artifact) { - var owner = artifact.ownerRoleId && ROLE_META[artifact.ownerRoleId] ? ROLE_META[artifact.ownerRoleId].name : (artifact.ownerRoleId || "—"); - var verify = artifact.verification && artifact.verification.status ? artifact.verification.status : "unverified"; - var existence = artifact.existence; - var flag = existenceLabel(existence); - var missing = existence === "missing"; - var metaChildren = [owner + " · " + (artifact.mediaType || "未知类型") + " · " + verificationLabel(verify)]; - if (flag) { - metaChildren.push(h("span", { - className: "wb-artifact-flag" + (existence === "unknown" ? " is-unknown" : ""), - key: "existence", - }, " · " + flag)); - } - return h("button", { - key: artifact.id || artifact.fileRef, - type: "button", - className: "wb-artifact" + (missing ? " is-missing" : ""), - title: (artifact.displayName || artifact.fileRef || artifact.id) + - (artifact.fileRef && artifact.fileRef !== artifact.displayName ? " · " + artifact.fileRef : "") + - (flag ? " · " + flag : ""), - onClick: function () { - setSelectedArtifactId(artifact.id); - setReviseOpen(false); - setReviseText(""); - setReviseBusy(null); - setNotice(null); - }, - }, [ - h("span", { className: "wb-artifact-name", key: "name" }, artifact.displayName || artifact.fileRef || artifact.id), - h("span", { className: "wb-artifact-meta", key: "meta" }, metaChildren), - ]); - }), - ]); - } - - function renderDrawer() { - if (!selectedArtifactId) return null; - var artifacts = data && Array.isArray(data.artifacts) ? data.artifacts : []; - var artifact = null; - for (var i = 0; i < artifacts.length; i++) { - if (artifacts[i] && artifacts[i].id === selectedArtifactId) { - artifact = artifacts[i]; - break; - } - } - if (!artifact) return null; - var related = findResultForArtifact(data && data.results, artifact); - var owner = artifact.ownerRoleId && ROLE_META[artifact.ownerRoleId] ? ROLE_META[artifact.ownerRoleId].name : (artifact.ownerRoleId || "—"); - var verify = artifact.verification && artifact.verification.status ? artifact.verification.status : "unverified"; - - var reviseForm = reviseOpen ? h("form", { - className: "wb-form", - key: "revise-form", - onSubmit: function (event) { - if (event && typeof event.preventDefault === "function") event.preventDefault(); - submitRevision(artifact, "draft"); - }, - }, [ - h("textarea", { - key: "text", - className: "wb-textarea", - placeholder: "要改什么?写清楚交给主责部门。", - value: reviseText, - onChange: function (event) { - setReviseText(event.target.value); - }, - }), - h("div", { className: "wb-form-row", key: "actions" }, [ - h("button", { - key: "draft", - type: "submit", - className: "wb-small-btn", - disabled: Boolean(reviseBusy), - }, reviseBusy === "draft" ? "保存中…" : "存为草稿"), - h("button", { - key: "queue", - type: "button", - className: "wb-small-btn", - disabled: Boolean(reviseBusy), - onClick: function () { - submitRevision(artifact, "queued"); - }, - }, reviseBusy === "queued" ? "派工中…" : "直接派工"), - ]), - ]) : null; - - return h("aside", { className: "wb-drawer", role: "dialog", "aria-label": "成果详情" }, [ - h("div", { className: "wb-drawer-head", key: "head" }, [ - h("span", { className: "wb-drawer-title", key: "title" }, "成果"), - h("button", { - key: "close", - type: "button", - className: "wb-icon-btn", - "aria-label": "关闭", - onClick: function () { - setSelectedArtifactId(null); - setReviseOpen(false); - setReviseText(""); - setReviseBusy(null); - }, - }, "×"), - ]), - h("div", { className: "wb-field", key: "revision" }, [ - h("span", { className: "wb-field-label", key: "label" }, "版本"), - h("span", { className: "wb-field-value", key: "value" }, revisionLabel(artifact)), - ]), - artifact.existence === "missing" ? h("p", { className: "wb-missing-note", key: "missing" }, - "这份文件在磁盘上找不到了,记录还在,可以重新登记或找主责部门补一份。") : null, - h("div", { className: "wb-field", key: "name" }, [ - h("span", { className: "wb-field-label", key: "label" }, "名称"), - h("span", { className: "wb-field-value", key: "value" }, artifact.displayName || "(未命名)"), - ]), - h("div", { className: "wb-field", key: "owner" }, [ - h("span", { className: "wb-field-label", key: "label" }, "部门 / 任务"), - h("span", { className: "wb-field-value", key: "value" }, owner + " · " + (artifact.taskId || "未关联任务")), - ]), - h("div", { className: "wb-field", key: "file" }, [ - h("span", { className: "wb-field-label", key: "label" }, "文件引用"), - h("span", { className: "wb-field-value", key: "value" }, artifact.fileRef || "—"), - ]), - h("div", { className: "wb-field", key: "verify" }, [ - h("span", { className: "wb-field-label", key: "label" }, "校验状态"), - h("span", { className: "wb-field-value", key: "value" }, verify), - ]), - h("div", { className: "wb-field", key: "summary" }, [ - h("span", { className: "wb-field-label", key: "label" }, "摘要"), - h("p", { className: "wb-drawer-body", key: "value" }, related && related.summary - ? related.summary - : "账本里这条成果没有关联的结案摘要。"), - ]), - h("div", { className: "wb-field", key: "revise" }, [ - h("button", { - key: "toggle", - type: "button", - className: "wb-small-btn", - onClick: function () { - setReviseOpen(!reviseOpen); - if (reviseOpen) setReviseText(""); - setNotice(null); - }, - }, reviseOpen ? "收起修改请求" : "找主责部门修改"), - reviseForm, - ]), - ]); - } - - var alert = null; - if (error) { - alert = h("div", { className: "wb-alert", role: "alert", key: "error" }, [ - h("span", { className: "wb-alert-text", key: "text" }, error), - h("button", { - key: "retry", - type: "button", - onClick: function () { - setReloadToken(reloadToken + 1); - }, - }, "重试"), - ]); - } else if (notice) { - alert = h("div", { className: "wb-alert is-" + noticeTone, role: "alert", key: "notice" }, [ - h("span", { className: "wb-alert-text", key: "text" }, notice), - ]); - } - - var content; - if (view === "tasks") content = renderTasks(); - else if (view === "artifacts") content = renderArtifacts(); - else content = renderCourt(); - - return h("div", { className: "wb-rail" + (compact ? " is-compact" : "") }, [ - h("div", { className: "wb-head", key: "head" }, [ - h("span", { className: "wb-title", key: "title" }, "三省六部"), - h("span", { className: "wb-meta", key: "meta" }, metaText), - ]), - h("div", { className: "wb-tabs", role: "tablist", key: "tabs" }, [ - tabButton("court", "朝堂"), - tabButton("tasks", "任务"), - tabButton("artifacts", "成果"), - ]), - alert, - h("div", { className: "wb-scroll", key: "scroll" }, [content]), - renderDrawer(), - ]); - } - - function WorkbenchPanel(props) { - return h(PanelBoundary, null, h(WorkbenchRail, { ctx: props.ctx, compact: true })); - } - - /** - * main.conversation 的接管组件。 - * 逃生开关:localStorage["sansheng.workbench.main"] === "off" 时不注册这个槽, - * 只保留右侧栏「朝堂」页签版,普通聊天完全不受影响。 - */ - function createConversationMain(ctx) { - return function SanshengConversationMain(props) { - var input = props || {}; - var sessionId = input.sessionId; - var useSession = input.useSession; - var useSessions = input.useSessions; - var useConversation = input.useConversation; - var renderSlot = input.renderSlot; - var renderFactorySlot = input.renderFactorySlot; - - // 宿主自己的 header + content:组件体内任何一步炸掉都回退到这里,中央聊天不白屏。 - function renderNative(phaseValue, heroValue) { - return h("div", { className: "wb-main-native", "data-phase": phaseValue }, [ - typeof renderSlot === "function" ? renderSlot("conversation.header", {}) : null, - typeof renderFactorySlot === "function" - ? renderFactorySlot( - "conversation.content", - { variant: "main", phase: phaseValue, hero: heroValue }, - { slots: { widthControls: input.widthControls || {} } }, - ) - : null, - ]); - } - - try { - var session = typeof useSession === "function" ? useSession(function (value) { return value; }) : undefined; - var conversation = typeof useConversation === "function" ? useConversation(function (value) { return value; }) : undefined; - var summaryBlank = typeof useSessions === "function" - ? useSessions(function (state) { - if (sessionId === undefined || !state) return undefined; - var summary = state.byId && state.byId[sessionId]; - return summary ? summary.blank : undefined; - }) - : undefined; - - var shellPhase = session === undefined || conversation === undefined - ? "blank" - : conversationPhase(session, conversation); - var openState = session && session.openState; - var subagent = session && session.subagent; - var address = subagent && subagent.address; - var parentAvailabilityPending = Boolean(address) && - address.mode === "continuable" && - subagent.parentAvailable === undefined; - var settling = sessionId !== undefined && ( - (shellPhase === "blank" && openState === "loading" && summaryBlank !== true) || - parentAvailabilityPending - ); - var hero = sessionId === undefined || - (shellPhase === "blank" && (openState === "open" || summaryBlank === true)); - var phase = settling ? "settling" : hero ? "hero" : "active"; - - var railProjectId = useBoundProject(ctx, sessionId); - var widthState = useRailWidth(); - var railWidth = widthState[0]; - var onResizeStart = widthState[1]; - var nudgeRail = widthState[2]; - - var native = renderNative(phase, hero); - - // 不是本工作台已绑定的部门会话:只渲染原生会话,与宿主原行为一致,不加任何东西。 - if (!sessionId || !railProjectId) return native; - - return h("div", { className: "wb-main-split" }, [ - native, - h("div", { - className: "wb-main-resizer", - key: "resizer", - role: "separator", - "aria-orientation": "vertical", - "aria-label": "调整朝堂栏宽度", - "aria-valuenow": railWidth, - "aria-valuemin": RAIL_MIN, - "aria-valuemax": RAIL_MAX, - tabIndex: 0, - title: "拖动或用方向键调整朝堂栏宽度(Shift 加速,Home/End 到两端)", - onMouseDown: typeof onResizeStart === "function" ? onResizeStart : null, - onKeyDown: function (event) { - if (!event || typeof nudgeRail !== "function") return; - var target = railResizeTarget(event.key, { width: railWidth, shift: Boolean(event.shiftKey) }); - if (target === null) return; - nudgeRail(target - railWidth); - if (typeof event.preventDefault === "function") event.preventDefault(); - }, - }), - h("div", { - className: "wb-main-rail", - key: "rail", - style: { width: railWidth + "px" }, - }, h(PanelBoundary, null, - h(WorkbenchRail, { ctx: ctx, projectId: railProjectId, compact: false }))), - ]); - } catch (error) { - // 保险:接管逻辑出错时退回宿主原生会话,绝不把中央聊天拖成白屏。 - try { - console.warn("[sansheng-workbench] 接管失败,回退原生会话:", error); - } catch (ignored) { - // 连日志都失败时也要继续回退。 - } - return renderNative(sessionId === undefined ? "hero" : "active", sessionId === undefined); - } - }; - } - - // --------------------------------------------------------------------- - // 注册 - // --------------------------------------------------------------------- - - function apply(ctx) { - if (!ctx) throw new Error("三省六部工作台需要宿主上下文"); - - // 1) 右侧栏页签「朝堂」:优先 better-sidebar 的 registerTab。 - var better = betterSidebarOf(ctx); - if (better) { - effectOf(ctx, function () { - return better.registerTab({ - id: TAB_ID, - title: "朝堂", - description: "三省六部 · 十席部门树", - order: 5, - single: true, - component: function (props) { - return h(WorkbenchPanel, { ctx: ctx, scope: props && props.scope }); - }, - }); - }, "三省六部工作台:better-sidebar 页签"); - } else { - var tabs = sidebarRightTabsOf(ctx); - if (tabs) { - effectOf(ctx, function () { - return tabs.register({ - id: TAB_ID, - kind: TAB_KIND, - priority: "builtin", - title: function () { - return "朝堂"; - }, - }); - }, "三省六部工作台:右侧栏页签"); - } else { - console.warn("[sansheng-workbench] 宿主没有 betterSidebar / sidebarRightTabs,页签可能无法停靠;pane 槽仍会注册。"); - } - } - - // 2) 页签内容 + 标题:即使上面没有服务也注册,宿主若按槽渲染仍可用。 - if (ctx.slots && typeof ctx.slots.inject === "function") { - ctx.slots.inject("sidebar.right.pane.tab", function () { - return ctx.slots.register({ name: "sidebar.right.pane.tab", key: TAB_ID }, function (props) { - return h(WorkbenchPanel, { ctx: ctx, props: props }); - }); - }); - ctx.slots.inject("sidebar.right.pane.tab.title", function () { - return ctx.slots.register({ name: "sidebar.right.pane.tab.title", key: TAB_ID }, function () { - return h("span", { className: "wb-tab-title" }, "朝堂"); - }); - }); - } - - // 3) 中央主区接管:priority -1 抢在宿主默认 0 之前;原生会话内容原样透传。 - // 逃生开关:localStorage["sansheng.workbench.main"] = "off" 时跳过本段。 - if (mainTakeoverEnabled() && ctx.slots && typeof ctx.slots.inject === "function") { - ctx.slots.inject("main.conversation", function () { - return ctx.slots.register({ - name: "main.conversation", - priority: -1, - children: { - "conversation.header": { kind: "single", scope: "session-maybe" }, - }, - }, createConversationMain(ctx)); - }); - } - } - - exports.inject = ["slots", "sessions", "uiWorkspace", "uiConversation"]; - exports.apply = apply; - exports.WorkbenchRail = WorkbenchRail; - exports.WorkbenchPanel = WorkbenchPanel; - exports.__test = { - computeRailLayout: computeRailLayout, - railResizeTarget: railResizeTarget, - statusOf: statusOf, - mergeEvents: mergeEvents, - apiPath: apiPath, - pickProjectId: pickProjectId, - formatModelLine: formatModelLine, - seatDisplayName: seatDisplayName, - modelTitle: modelTitle, - existenceLabel: existenceLabel, - verificationLabel: verificationLabel, - revisionLabel: revisionLabel, - taskKindLabel: taskKindLabel, - taskActionKeys: taskActionKeys, - wirePathsFromLayout: wirePathsFromLayout, - ROLE_META: ROLE_META, - }; - - return module.exports; - }, -}); diff --git a/workbench/panel/package.json b/workbench/panel/package.json deleted file mode 100644 index 64893a0..0000000 --- a/workbench/panel/package.json +++ /dev/null @@ -1,26 +0,0 @@ -{ - "name": "dsh-sansheng-liubu-workbench", - "version": "0.1.0", - "private": true, - "description": "三省六部工作台:右侧朝堂部门树、任务与成果", - "type": "module", - "exports": { - "./client": "./lib/client.js" - }, - "files": [ - "lib/**" - ], - "dsh": { - "client": { - "platform": "web", - "inject": [ - "@deepseek-ai/dsh-api-session-controller", - "@deepseek-ai/dsh-client-ui-workspace", - "@deepseek-ai/dsh-client-ui-primitives" - ] - } - }, - "peerDependencies": { - "@deepseek-ai/cordis": "~4.0.5" - } -} diff --git a/workbench/panel/test/client.test.mjs b/workbench/panel/test/client.test.mjs deleted file mode 100644 index a71679a..0000000 --- a/workbench/panel/test/client.test.mjs +++ /dev/null @@ -1,566 +0,0 @@ -import test from "node:test"; -import assert from "node:assert/strict"; -import { readFileSync } from "node:fs"; -import { fileURLToPath } from "node:url"; -import vm from "node:vm"; - -const CLIENT_PATH = fileURLToPath(new URL("../lib/client.js", import.meta.url)); -const SOURCE = readFileSync(CLIENT_PATH, "utf8"); - -function createStorage(initial) { - const map = new Map(Object.entries(initial || {})); - return { - getItem(key) { - return map.has(key) ? map.get(key) : null; - }, - setItem(key, value) { - map.set(key, String(value)); - }, - removeItem(key) { - map.delete(key); - }, - }; -} - -function createReact() { - function createElement(type, props) { - const children = Array.prototype.slice.call(arguments, 2); - return { type: type, props: props || {}, children: children }; - } - - class Component { - constructor(props) { - this.props = props; - this.state = {}; - } - } - - return { - createElement: createElement, - Component: Component, - useState: function (initial) { - return [initial, function () {}]; - }, - useRef: function (initial) { - return { current: initial }; - }, - useEffect: function () {}, - useCallback: function (fn) { - return fn; - }, - useMemo: function (fn) { - return fn(); - }, - useContext: function () { - return null; - }, - createContext: function (value) { - return { _value: value }; - }, - Fragment: "Fragment", - }; -} - -function createDocument() { - const appended = []; - return { - appended: appended, - hidden: false, - head: { - appendChild: function (node) { - appended.push(node); - }, - }, - body: {}, - querySelector: function () { - return null; - }, - createElement: function (tagName) { - return { - tagName: tagName, - dataset: {}, - textContent: "", - appendChild: function () {}, - setAttribute: function () {}, - }; - }, - addEventListener: function () {}, - removeEventListener: function () {}, - }; -} - -function loadPlugin(options) { - options = options || {}; - const storage = createStorage(options.storage); - const document = createDocument(); - const react = createReact(); - let definition = null; - - const window = { - __ModuleLoader__: { - load: function (loaded) { - definition = loaded; - }, - }, - }; - - const sandbox = { - window: window, - document: document, - console: console, - URL: URL, - Map: Map, - Set: Set, - WeakMap: WeakMap, - Promise: Promise, - setTimeout: setTimeout, - clearTimeout: clearTimeout, - localStorage: storage, - Symbol: Symbol, - }; - - vm.runInNewContext(SOURCE, sandbox, { filename: CLIENT_PATH }); - assert.ok(definition, "bundle 应该调用 window.__ModuleLoader__.load"); - assert.equal(definition.id, "dsh-sansheng-liubu-workbench", "bundle id 必须是包名"); - - const exports = definition.factory(function (id) { - if (id === "react") return react; - throw new Error("unexpected require: " + id); - }); - - return { exports: exports, react: react, storage: storage, document: document, definition: definition }; -} - -function createCtx(options) { - options = options || {}; - const registrations = []; - const injections = []; - const tabs = []; - const effects = []; - - const ctx = { - slots: { - inject: function (name, factory) { - injections.push(name); - const value = factory(); - if (value !== undefined) registrations.push(value); - return function () {}; - }, - register: function (spec, component) { - const registration = { spec: spec, component: component }; - registrations.push(registration); - return registration; - }, - }, - effect: function (factory, label) { - effects.push(label); - const value = factory(); - return typeof value === "function" ? value : function () {}; - }, - get: function (name) { - return options.services ? options.services[name] : undefined; - }, - uiWorkspace: { - currentWorkspaceId: options.workspaceId || "ws-1", - openSession: function () {}, - }, - }; - - if (!options.noTabs) { - ctx.sidebarRightTabs = { - register: function (spec) { - tabs.push(spec); - return function () {}; - }, - }; - } - - return { ctx: ctx, registrations: registrations, injections: injections, tabs: tabs, effects: effects }; -} - -test("bundle 契约:id、inject 与纯函数导出", function () { - const plugin = loadPlugin(); - const api = plugin.exports; - - assert.deepEqual(Array.from(api.inject), ["slots", "sessions", "uiWorkspace", "uiConversation"]); - assert.equal(typeof api.apply, "function"); - assert.equal(typeof api.WorkbenchRail, "function"); - assert.equal(typeof api.__test, "object"); - - const expected = ["computeRailLayout", "statusOf", "mergeEvents", "apiPath", "pickProjectId", "formatModelLine", "ROLE_META"]; - for (const key of expected) assert.ok(key in api.__test, "__test 缺少 " + key); - assert.equal(Object.keys(api.__test.ROLE_META).length, 10); - assert.deepEqual(Object.keys(api.__test.ROLE_META).slice(0, 4), ["lead", "zhongshu", "shangshu", "menxia"]); -}); - -test("computeRailLayout:丞相跨三列居中、三省一列、六部 3×2", function () { - const layout = loadPlugin().exports.__test.computeRailLayout(400); - - assert.equal(layout.width, 400); - assert.equal(layout.nodes.length, 10); - - const byId = {}; - for (const node of layout.nodes) { - assert.equal(typeof node.id, "string"); - assert.equal(typeof node.x, "number"); - assert.equal(typeof node.y, "number"); - assert.equal(typeof node.col, "number"); - assert.equal(typeof node.row, "number"); - byId[node.id] = node; - } - - const lead = byId.lead; - assert.equal(lead.col, 1); - assert.equal(lead.span, 3); - assert.ok(Math.abs(lead.x + lead.w / 2 - 200) < 0.001, "丞相应水平居中"); - assert.ok(Math.abs(lead.x - (400 - lead.w) / 2) < 0.001); - - const san = ["zhongshu", "shangshu", "menxia"].map((id) => byId[id]); - assert.deepEqual(Array.from(san, (node) => node.col), [0, 1, 2]); - assert.deepEqual(Array.from(san, (node) => node.row), [1, 1, 1]); - assert.equal(new Set(Array.from(san, (node) => node.y)).size, 1, "三省应在同一行"); - assert.ok(san[0].x < san[1].x && san[1].x < san[2].x, "三省 x 必须递增"); - - const six = layout.nodes.filter((node) => node.row >= 2); - assert.equal(six.length, 6); - assert.deepEqual(Array.from(six, (node) => node.id), ["libu", "hubu", "lipu", "bingbu", "xingbu", "gongbu"]); - assert.equal(six[5].id, "gongbu", "第 6 个是工部"); - assert.deepEqual(Array.from(six, (node) => node.col), [0, 1, 2, 0, 1, 2]); - assert.deepEqual(Array.from(six, (node) => node.row), [2, 2, 2, 3, 3, 3]); - - assert.ok(layout.groups.ministries.y > layout.groups.sansheng.y + layout.groups.sansheng.h); - assert.ok(layout.height > 0); -}); - -test("computeRailLayout:窄栏仍是三列且不出现负宽度", function () { - const layout = loadPlugin().exports.__test.computeRailLayout(340); - assert.equal(layout.nodes.length, 10); - assert.equal(new Set(Array.from(layout.nodes, (node) => node.col)).size, 3); - for (const node of layout.nodes) assert.ok(node.w > 0, node.id + " 宽度必须为正"); - assert.ok(layout.leadWidth <= 184); -}); - -test("statusOf:六种部门状态与未知值兜底", function () { - const { statusOf } = loadPlugin().exports.__test; - assert.equal(statusOf("uninitialized"), "未接通"); - assert.equal(statusOf("idle"), "空闲"); - assert.equal(statusOf("queued"), "排队"); - assert.equal(statusOf("running"), "正在运行"); - assert.equal(statusOf("unavailable"), "不可用"); - assert.equal(statusOf("needs_attention"), "需人处理"); - assert.equal(statusOf("something-new"), "未知"); - assert.equal(statusOf(null), "未接通"); - assert.equal(statusOf(""), "未接通"); -}); - -test("mergeEvents:按 eventId 去重、按 seq 升序、忽略乱序重复", function () { - const { mergeEvents } = loadPlugin().exports.__test; - const merged = mergeEvents( - [{ eventId: "a", seq: 3 }, { eventId: "b", seq: 1 }], - [{ eventId: "b", seq: 1 }, { eventId: "c", seq: 2 }, { eventId: "a", seq: 3 }], - ); - - assert.equal(merged.length, 3); - assert.deepEqual(Array.from(merged, (event) => event.eventId), ["b", "c", "a"]); - assert.deepEqual(Array.from(merged, (event) => event.seq), [1, 2, 3]); - - const again = mergeEvents(merged, []); - assert.deepEqual(Array.from(again, (event) => event.eventId), ["b", "c", "a"]); - assert.deepEqual(Array.from(mergeEvents([], [])), []); -}); - -test("formatModelLine:无配置跟随宿主,有配置拼 provider/model · effort", function () { - const { formatModelLine } = loadPlugin().exports.__test; - assert.equal(formatModelLine(null), "跟随宿主"); - assert.equal(formatModelLine(undefined), "跟随宿主"); - assert.equal(formatModelLine({}), "跟随宿主"); - assert.equal(formatModelLine({ provider: "", model: "" }), "跟随宿主"); - assert.equal(formatModelLine({ provider: "deepseek", model: "", reasoningEffort: "high" }), "跟随宿主"); - assert.equal(formatModelLine({ provider: "deepseek", model: "deepseek-v4", reasoningEffort: "high" }), "deepseek/deepseek-v4 · 高"); - assert.equal(formatModelLine({ provider: "deepseek", model: "deepseek-v4" }), "deepseek/deepseek-v4"); - assert.equal(formatModelLine({ provider: "deepseek", model: "deepseek-v4", reasoningEffort: "custom" }), "deepseek/deepseek-v4 · custom"); - // model 自带 provider 前缀时只留最后一段,完整路径放 title。 - assert.equal( - formatModelLine({ provider: "magpie", model: "workbuddy/deepseek-v4", reasoningEffort: "high" }), - "deepseek-v4 · 高", - ); -}); - -test("seatDisplayName:name 与 short 同时存在时必须用完整名", function () { - const { seatDisplayName, modelTitle } = loadPlugin().exports.__test; - - assert.equal(seatDisplayName({ roleId: "lead", name: "丞相", short: "丞" }), "丞相"); - assert.equal(seatDisplayName({ roleId: "zhongshu", name: "中书", short: "中" }), "中书"); - assert.equal(seatDisplayName({ roleId: "lead" }), "丞相", "缺 name 时回落到 ROLE_META 的完整名"); - assert.equal(seatDisplayName({ roleId: "lead", short: "丞" }), "丞相", "short 不能优先于 ROLE_META 的完整名"); - assert.equal(seatDisplayName({ name: "", roleId: "unknown" }), "unknown"); - - assert.equal(modelTitle(null), "跟随宿主(未单独配置模型)"); - assert.equal( - modelTitle({ provider: "magpie", model: "workbuddy/deepseek-v4", reasoningEffort: "high" }), - "magpie/workbuddy/deepseek-v4 · 高", - ); -}); - -test("wirePathsFromLayout:量不到 DOM 时仍能生成三支 + 主干连线", function () { - const { computeRailLayout, wirePathsFromLayout } = loadPlugin().exports.__test; - const layout = computeRailLayout(400); - const paths = wirePathsFromLayout(layout); - - assert.equal(paths.length, 4, "三省三支 + 尚书到六部一条主干"); - const branch = paths.filter((item) => item.kind === "branch"); - const trunk = paths.filter((item) => item.kind === "trunk"); - assert.equal(branch.length, 3); - assert.equal(trunk.length, 1); - assert.deepEqual(Array.from(branch).map((item) => item.key), ["lead-zhongshu", "lead-shangshu", "lead-menxia"]); - for (const item of branch) { - const id = item.key.replace(/^lead-/, ""); - const card = layout.sansheng.find((node) => node.id === id); - assert.ok(item.d.includes(" C "), "分支必须用三次贝塞尔收口,垂直进入卡片顶边"); - assert.ok(!item.d.includes(" Q "), "不要退回二次贝塞尔(会在卡片顶边上方擦成一条横线)"); - const tail = item.d.match(/ C [0-9.]+ [0-9.]+ [0-9.]+ [0-9.]+ ([0-9.]+) ([0-9.]+)$/); - assert.ok(tail, "分支末尾应是第二个控制点 + 终点"); - assert.ok(Math.abs(Number(tail[1]) - card.cx) < 0.06, "终点 x 应等于卡片顶边中点"); - assert.equal(Number(tail[2]), card.y, "终点 y 应落在卡片顶边"); - } - const shangshu = layout.sansheng.find((node) => node.id === "shangshu"); - assert.equal(trunk[0].d, "M 200 " + (shangshu.y + shangshu.h) + " L 200 " + layout.groups.ministries.y); -}); - -test("apiPath:拼出同源工作台路径并编码查询串", function () { - const { apiPath } = loadPlugin().exports.__test; - assert.equal(apiPath("bootstrap"), "/sansheng/workbench/bootstrap"); - assert.equal(apiPath("/connect"), "/sansheng/workbench/connect"); - assert.equal(apiPath("events", { projectId: "p-1", since: 7 }), "/sansheng/workbench/events?projectId=p-1&since=7"); - assert.equal(apiPath("events", { projectId: "p 1", since: undefined }), "/sansheng/workbench/events?projectId=p%201"); - assert.equal(apiPath("bootstrap", {}), "/sansheng/workbench/bootstrap"); -}); - -test("pickProjectId:优先当前工作区,其次 bootstrap 默认项目", function () { - const { pickProjectId } = loadPlugin().exports.__test; - const data = { - projectId: "p-default", - projects: [ - { id: "p-other", hostWorkspaceId: "ws-other" }, - { id: "p-mine", hostWorkspaceId: "ws-mine" }, - ], - }; - assert.equal(pickProjectId(data, "ws-mine"), "p-mine"); - assert.equal(pickProjectId(data, "ws-missing"), null); - assert.equal(pickProjectId(data), "p-default"); - assert.equal(pickProjectId({ projects: [{ id: "p-only" }] }), "p-only"); - assert.equal(pickProjectId({ projects: [] }), null); -}); - -test("apply:注册朝堂页签、pane 槽与 priority -1 的 main.conversation", function () { - const plugin = loadPlugin(); - const mock = createCtx(); - plugin.exports.apply(mock.ctx); - - assert.ok(mock.injections.includes("sidebar.right.pane.tab")); - assert.ok(mock.injections.includes("sidebar.right.pane.tab.title")); - assert.ok(mock.injections.includes("main.conversation")); - - assert.equal(mock.tabs.length, 1); - assert.equal(mock.tabs[0].id, "sansheng-liubu-workbench"); - assert.equal(mock.tabs[0].priority, "builtin"); - assert.equal(mock.tabs[0].title(), "朝堂"); - - const main = mock.registrations.find((entry) => entry.spec && entry.spec.name === "main.conversation"); - assert.ok(main, "必须注册 main.conversation"); - assert.equal(main.spec.priority, -1); - assert.deepEqual(Array.from(Object.keys(main.spec.children)), ["conversation.header"]); -}); - -test("apply:localStorage 逃生开关 sansheng.workbench.main=off 时不接管主区", function () { - const plugin = loadPlugin({ storage: { "sansheng.workbench.main": "off" } }); - const mock = createCtx(); - plugin.exports.apply(mock.ctx); - - assert.equal(mock.injections.includes("main.conversation"), false); - assert.ok(mock.injections.includes("sidebar.right.pane.tab")); -}); - -test("main.conversation:非绑定会话只透传原生 header/content,不加右栏", function () { - const plugin = loadPlugin(); - const mock = createCtx(); - plugin.exports.apply(mock.ctx); - - const main = mock.registrations.find((entry) => entry.spec && entry.spec.name === "main.conversation"); - const tree = main.component({ - sessionId: "session-1", - useSession: function () { - return { openState: "open", blank: true, running: false, promptAttempted: false }; - }, - useSessions: function (select) { - return select({ byId: { "session-1": { blank: true } } }); - }, - useConversation: function () { - return { activeTargets: new Set() }; - }, - renderSlot: function (name) { - return { type: "header-slot", name: name }; - }, - renderFactorySlot: function (name, params) { - return { type: "content-slot", name: name, params: params }; - }, - widthControls: { width: 900 }, - }); - - assert.equal(tree.props.className, "wb-main-native"); - const children = tree.children[0]; - assert.equal(children[0].type, "header-slot"); - assert.equal(children[1].type, "content-slot"); - assert.equal(children[1].params.phase, "hero"); - assert.deepEqual(children[1].params.hero, true); - assert.ok(!JSON.stringify(tree).includes("wb-main-rail"), "非工作台会话不能出现右栏"); -}); - -test("WorkbenchRail:无数据时也渲染完整骨架与三个内部页签", function () { - const plugin = loadPlugin(); - const mock = createCtx(); - const tree = plugin.exports.WorkbenchRail({ ctx: mock.ctx, compact: true }); - - assert.ok(tree.props.className.includes("wb-rail")); - assert.ok(tree.props.className.includes("is-compact")); - const serialized = JSON.stringify(tree); - assert.ok(serialized.includes("三省六部")); - assert.ok(serialized.includes("朝堂")); - assert.ok(serialized.includes("任务")); - assert.ok(serialized.includes("成果")); - assert.ok(serialized.includes("十席 · 0 席已接通")); - assert.ok(serialized.includes("六部 · 同级")); - assert.ok(serialized.includes("正在读取") === false); -}); - -test("main.conversation:接管逻辑抛错时回退原生会话,不白屏", function () { - const plugin = loadPlugin(); - const mock = createCtx(); - plugin.exports.apply(mock.ctx); - - const main = mock.registrations.find((entry) => entry.spec && entry.spec.name === "main.conversation"); - const warnings = []; - const originalWarn = console.warn; - console.warn = function () { - warnings.push(Array.from(arguments)); - }; - try { - const tree = main.component({ - sessionId: "session-1", - useSession: function () { - // 模拟接管逻辑在渲染途中抛异常(理论上不应发生,但必须兜住)。 - throw new Error("boom"); - }, - useSessions: function () { - return undefined; - }, - useConversation: function () { - return { activeTargets: new Set() }; - }, - renderSlot: function (name) { - return { type: "header-slot", name: name }; - }, - renderFactorySlot: function (name, params) { - return { type: "content-slot", name: name, params: params }; - }, - }); - - assert.equal(tree.props.className, "wb-main-native"); - assert.equal(tree.children[0][0].type, "header-slot"); - assert.equal(tree.children[0][1].type, "content-slot"); - assert.ok(!JSON.stringify(tree).includes("wb-main-split"), "回退时不能拼右栏"); - assert.ok(!JSON.stringify(tree).includes("wb-main-resizer"), "回退时不能拼分隔条"); - assert.ok( - warnings.some((args) => String(args[0]).includes("接管失败")), - "回退时要留下可诊断的 console.warn", - ); - } finally { - console.warn = originalWarn; - } -}); - -test("existenceLabel:missing / unknown / ok 三态,unknown 不能被当成正常", function () { - const plugin = loadPlugin(); - const { existenceLabel } = plugin.exports.__test; - - assert.equal(existenceLabel("missing"), "文件已失效"); - assert.equal(existenceLabel("unknown"), "位置未核验"); - assert.equal(existenceLabel("ok"), ""); - assert.equal(existenceLabel(undefined), ""); - assert.notEqual(existenceLabel("unknown"), ""); - assert.ok(!existenceLabel("unknown").includes("正常"), "unknown 不能显示成正常"); - assert.ok(!existenceLabel("ok").includes("正常"), "ok 也不必写正常,静默即可"); -}); - -test("verificationLabel:英文枚举翻成中文,别和「文件已失效」读成自相矛盾", function () { - const plugin = loadPlugin(); - const { verificationLabel } = plugin.exports.__test; - - assert.equal(verificationLabel("verified"), "已核验"); - assert.equal(verificationLabel("unverified"), "未核验"); - assert.equal(verificationLabel("rejected"), "未通过"); - assert.equal(verificationLabel(undefined), "核验未知"); - // 「已核验」说的是结果被核验过,不是文件还在——不能出现「存在」「有效」这类字眼。 - assert.ok(!/存在|有效/.test(verificationLabel("verified"))); -}); - -test("revisionLabel:第 N 版,只有真正修订且 N>1 才写「修订自上一版」", function () { - const plugin = loadPlugin(); - const { revisionLabel } = plugin.exports.__test; - - assert.equal(revisionLabel({ revision: 1, revisesArtifactId: "art-0" }), "第 1 版"); - assert.ok(!revisionLabel({ revision: 1, revisesArtifactId: "art-0" }).includes("修订自")); - assert.equal(revisionLabel({ revision: 2, revisesArtifactId: "art-0" }), "第 2 版 · 修订自上一版"); - assert.equal(revisionLabel({ revision: 3, revisesArtifactId: null }), "第 3 版"); - assert.equal(revisionLabel({}), "第 1 版"); - assert.equal(revisionLabel(null), "第 1 版"); -}); - -test("taskKindLabel:只给 kind=revision 加「修订」标签", function () { - const plugin = loadPlugin(); - const { taskKindLabel } = plugin.exports.__test; - - assert.equal(taskKindLabel({ kind: "revision" }), "修订"); - assert.equal(taskKindLabel({ kind: "normal" }), ""); - assert.equal(taskKindLabel({}), ""); - assert.equal(taskKindLabel(null), ""); -}); - -test("A27 分隔条键盘:方向键 / Shift / Home / End 有确定步长,其它键不动", function () { - const { railResizeTarget } = loadPlugin().exports.__test; - - // 默认 16px 一档,Shift 加速到 64px。 - assert.equal(railResizeTarget("ArrowLeft", { width: 400 }), 384); - assert.equal(railResizeTarget("ArrowRight", { width: 400 }), 416); - assert.equal(railResizeTarget("ArrowRight", { width: 400, shift: true }), 464); - assert.equal(railResizeTarget("ArrowLeft", { width: 400, shift: true }), 340); // 400-64 撞下限 340 - - // 两端截断,不会跑出 340–600。 - assert.equal(railResizeTarget("Home", { width: 500 }), 340); - assert.equal(railResizeTarget("End", { width: 500 }), 600); - assert.equal(railResizeTarget("ArrowLeft", { width: 340 }), 340); - assert.equal(railResizeTarget("ArrowRight", { width: 600 }), 600); - assert.equal(railResizeTarget("ArrowRight", { width: 595, shift: true }), 600); - - // 不认识的键返回 null:调用方不能 preventDefault,浏览器的默认行为要保留。 - assert.equal(railResizeTarget("Tab", { width: 400 }), null); - assert.equal(railResizeTarget("Enter", { width: 400 }), null); - assert.equal(railResizeTarget(undefined, { width: 400 }), null); -}); - -test("任务行动作:草稿可派工、排队可派可取消、终态不给按钮", () => { - const { taskActionKeys } = loadPlugin().exports.__test; - - // 草稿只是记在账本里,还没进部门队列,只能派工。 - assert.equal(taskActionKeys({ status: "draft" }).join(","), 'dispatch'); - // 排队:既能补派(幂等键会去重),也能取消。 - assert.equal(taskActionKeys({ status: "queued" }).join(","), 'dispatch,cancel'); - // 正在跑 / 需人处理:只能取消,不再重复派。 - assert.equal(taskActionKeys({ status: "running" }).join(","), 'cancel'); - assert.equal(taskActionKeys({ status: "needs_attention" }).join(","), 'cancel'); - // 终态不给动作:避免对已完成任务再派一次。 - assert.equal(taskActionKeys({ status: "completed" }).join(","), ''); - assert.equal(taskActionKeys({ status: "cancelled" }).join(","), ''); - assert.equal(taskActionKeys({ status: "failed" }).join(","), ''); - assert.equal(taskActionKeys(null).join(","), ''); -}); diff --git a/workbench/test/acceptance-extra.test.mjs b/workbench/test/acceptance-extra.test.mjs deleted file mode 100644 index ed1dd4e..0000000 --- a/workbench/test/acceptance-extra.test.mjs +++ /dev/null @@ -1,251 +0,0 @@ -// A09 / A17 / A19 的补强验收:附件级材料引用、宿主重启后的账本恢复、项目间材料隔离。 - -import test from 'node:test' -import assert from 'node:assert/strict' -import { mkdtempSync, rmSync } from 'node:fs' -import { tmpdir } from 'node:os' -import { join } from 'node:path' - -import { WorkbenchStore } from '../core/store.mjs' -import { createWorkbenchService } from '../host/service.mjs' -import { buildDispatchText, describeMaterialRef } from '../host/session-adapter.mjs' - -const clock = () => 1700000000000 - -function memoryStore() { - return new WorkbenchStore({ file: null, clock }) -} - -function seed(service, hostWorkspaceId) { - const project = service.registerProject({ hostWorkspaceId, displayNameCache: hostWorkspaceId }).project - const binding = service.bindDepartmentSession({ projectId: project.id, roleId: 'gongbu', sessionId: `ses_${hostWorkspaceId}` }) - return { project, generation: binding.binding.bindingGeneration } -} - -test('A09 交接材料:附件引用原样进 packet,成果引用带版本,文本里可读', () => { - const store = memoryStore() - const service = createWorkbenchService({ store, clock }) - const { project, generation } = seed(service, 'ws-a') - const task = service.createTask({ - projectId: project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: '按预算出方案', - objective: 'o', - status: 'queued', - }).task - const artifact = service.registerArtifact({ - projectId: project.id, - ownerRoleId: 'gongbu', - taskId: task.id, - displayName: '预算表', - fileRef: 'C:/work/预算.xlsx', - kind: 'spreadsheet', - }).artifact - - const dispatched = service.dispatchTask({ - projectId: project.id, - taskId: task.id, - idempotencyKey: 'k-material', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-a', - bindingGeneration: generation, - packet: { - materialRefs: [ - { artifactId: artifact.id }, - { attachmentId: 'att_abc', name: '预算.xlsx', mime: 'application/vnd.ms-excel', size: 2048 }, - '聊天里贴过的那段口径', - ], - }, - }) - - const refs = dispatched.contextPacket.materialRefs - assert.deepEqual(refs[0], { artifactId: artifact.id, revision: 1, title: '预算表' }) - assert.deepEqual(refs[1], { attachmentId: 'att_abc', name: '预算.xlsx', mime: 'application/vnd.ms-excel', size: 2048 }) - assert.equal(refs[2], '聊天里贴过的那段口径') - - // 派发文本必须把材料写成能读的一行,并保留可追溯 ID。 - const text = buildDispatchText({ task, packet: dispatched.contextPacket, contractGuide: 'G', roleName: '工部' }) - assert.ok(text.includes(`成果 预算表 ${artifact.id}(第 1 版)`)) - assert.match(text, /附件 att_abc(预算\.xlsx · application\/vnd\.ms-excel · 2048 字节)/) - assert.match(text, /聊天里贴过的那段口径/) - - // 纯函数本身也单独锁一下:非对象、空串、缺 ID 都不该糊过去。 - assert.equal(describeMaterialRef(null), 'null') - assert.equal(describeMaterialRef('a.xlsx'), 'a.xlsx') -}) - -test('A09/A19 交接材料不能越权:别的项目的成果引用直接拒绝,且不泄露归属', () => { - const store = memoryStore() - const service = createWorkbenchService({ store, clock }) - const a = seed(service, 'ws-a') - const b = seed(service, 'ws-b') - const taskA = service.createTask({ - projectId: a.project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: 'A 的任务', - objective: 'o', - status: 'queued', - }).task - const artifact = service.registerArtifact({ - projectId: a.project.id, - ownerRoleId: 'gongbu', - taskId: taskA.id, - title: 'A 的成果', - fileRef: 'C:/work/a.xlsx', - }).artifact - const task = service.createTask({ - projectId: b.project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: 'B 的任务', - objective: 'o', - status: 'queued', - }).task - - assert.throws( - () => - service.dispatchTask({ - projectId: b.project.id, - taskId: task.id, - idempotencyKey: 'k-cross', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-b', - bindingGeneration: b.generation, - packet: { materialRefs: [{ artifactId: artifact.id }] }, - }), - (error) => error.code === 'CROSS_PROJECT' && !JSON.stringify(error.details ?? {}).includes(a.project.id), - ) - - // 正常派发:B 的上下文包里只有自己的东西,绝不自动继承 A 的材料。 - const dispatched = service.dispatchTask({ - projectId: b.project.id, - taskId: task.id, - idempotencyKey: 'k-own', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-b', - bindingGeneration: b.generation, - }) - assert.deepEqual(dispatched.contextPacket.materialRefs, []) - - // 缺 ID 的引用、空字符串都要明确报错,而不是“尽力猜”。 - assert.throws( - () => - service.dispatchTask({ - projectId: b.project.id, - taskId: task.id, - idempotencyKey: 'k-bad', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-b', - bindingGeneration: b.generation, - packet: { materialRefs: [{ name: '没有 ID 的东西' }] }, - }), - (error) => error.code === 'INVALID_INPUT', - ) -}) - -test('A17 宿主重启:账本重开后项目/绑定/配置/任务/派发都还在,换绑代号不回退', () => { - const dir = mkdtempSync(join(tmpdir(), 'wb-restart-')) - const file = join(dir, 'workbench.json') - try { - const first = new WorkbenchStore({ file, clock }) - first.load() - const service = createWorkbenchService({ store: first, clock }) - const { project, generation } = seed(service, 'ws-restart') - service.saveDepartmentConfig({ projectId: project.id, roleId: 'gongbu', provider: 'magpie', model: 'workbuddy/deepseek-v4.1-flash', expectedRevision: 0 }) - const task = service.createTask({ - projectId: project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: '重启前建的任务', - objective: 'o', - status: 'queued', - }).task - const dispatched = service.dispatchTask({ - projectId: project.id, - taskId: task.id, - idempotencyKey: 'k-restart', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-restart', - bindingGeneration: generation, - }) - assert.equal(dispatched.dispatch.idempotencyKey, 'k-restart') - - // —— 模拟宿主重启:新建 store 从同一文件重开 —— - const second = new WorkbenchStore({ file, clock }) - second.load() - const revived = createWorkbenchService({ store: second, clock }) - - const projects = revived.listProjects() - assert.equal(projects.length, 1) - assert.equal(projects[0].hostWorkspaceId, 'ws-restart') - - const seats = revived.listSeats(project.id) - const gongbu = seats.find((seat) => seat.roleId === 'gongbu') - assert.equal(gongbu.connected, true) - assert.equal(gongbu.config.model, 'workbuddy/deepseek-v4.1-flash') - assert.equal(gongbu.config.configRevision, 1) - - const revivedTask = revived.getTask(project.id, task.id) - assert.equal(revivedTask.title, '重启前建的任务') - - // 幂等键跨重启仍有效:再点一次不会重复投递。 - const again = revived.dispatchTask({ - projectId: project.id, - taskId: task.id, - idempotencyKey: 'k-restart', - targetRoleId: 'gongbu', - targetSessionId: 'ses_ws-restart', - bindingGeneration: generation, - }) - assert.equal(again.duplicate, true) - assert.equal(again.dispatch.id, dispatched.dispatch.id) - } finally { - rmSync(dir, { recursive: true, force: true }) - } -}) - -test('A26 切项目后草稿、绑定、配置各归所属,不互相串', () => { - const store = memoryStore() - const service = createWorkbenchService({ store, clock }) - const a = service.registerProject({ hostWorkspaceId: 'ws-a', displayNameCache: 'A' }).project - const b = service.registerProject({ hostWorkspaceId: 'ws-b', displayNameCache: 'B' }).project - - // 两个项目各自的工部配置不同,且都绑了不同会话。 - service.saveDepartmentConfig({ projectId: a.id, roleId: 'gongbu', provider: 'magpie', model: 'workbuddy/deepseek-v4.1-flash', expectedRevision: 0 }) - service.saveDepartmentConfig({ projectId: b.id, roleId: 'gongbu', provider: 'magpie', model: 'workbuddy/deepseek-v4.1-pro', expectedRevision: 0 }) - service.bindDepartmentSession({ projectId: a.id, roleId: 'gongbu', sessionId: 'ses_a_gongbu' }) - service.bindDepartmentSession({ projectId: b.id, roleId: 'gongbu', sessionId: 'ses_b_gongbu' }) - - // A 里存一份草稿(还没派工的修订单)。 - const taskA = service.createTask({ - projectId: a.id, ownerRoleId: 'gongbu', sourceRoleId: 'lead', - title: 'A 的草稿', objective: 'o', status: 'draft', - }).task - const taskB = service.createTask({ - projectId: b.id, ownerRoleId: 'gongbu', sourceRoleId: 'lead', - title: 'B 的草稿', objective: 'o', status: 'draft', - }).task - - const bootA = service.bootstrap(a.id) - const bootB = service.bootstrap(b.id) - const gongbuA = bootA.seats.find((seat) => seat.roleId === 'gongbu') - const gongbuB = bootB.seats.find((seat) => seat.roleId === 'gongbu') - - // 配置与绑定各归各的:切项目不会把 A 的模型/会话带到 B。 - assert.equal(gongbuA.config.model, 'workbuddy/deepseek-v4.1-flash') - assert.equal(gongbuB.config.model, 'workbuddy/deepseek-v4.1-pro') - assert.equal(gongbuA.binding.currentSessionId, 'ses_a_gongbu') - assert.equal(gongbuB.binding.currentSessionId, 'ses_b_gongbu') - - // 草稿也只是各自项目里的任务,不会出现在对方列表里。 - const titlesA = bootA.tasks.map((task) => task.title) - const titlesB = bootB.tasks.map((task) => task.title) - assert.ok(titlesA.includes('A 的草稿')) - assert.ok(!titlesA.includes('B 的草稿')) - assert.ok(titlesB.includes('B 的草稿')) - assert.ok(!titlesB.includes('A 的草稿')) - assert.equal(taskA.projectId, a.id) - assert.equal(taskB.projectId, b.id) -}) diff --git a/workbench/test/assembly.test.mjs b/workbench/test/assembly.test.mjs deleted file mode 100644 index 8069494..0000000 --- a/workbench/test/assembly.test.mjs +++ /dev/null @@ -1,275 +0,0 @@ -// 装配层测试:index.mjs 把 store / service / 会话层 / HTTP 路由拼在一起的那一层。 -// 这里专门验「宿主稍后才给 sessionController」这条真实时序——它决定用户要不要多重启一次。 - -import test from 'node:test' -import assert from 'node:assert/strict' -import { Readable } from 'node:stream' - -import { createWorkbenchHost } from '../host/index.mjs' -import { WorkbenchStore } from '../core/store.mjs' - -const clock = () => 1700000000000 -const WS = 'ws_demo' - -/** 最小 webServer 替身:记下注册的路由,卸载时清掉。 */ -function fakeWebServer() { - const routes = new Map() - return { - routes, - register(route) { - routes.set(route.path, route) - return () => routes.delete(route.path) - }, - } -} - -/** 最小 cordis 替身:inject 只把回调存起来,测试手动触发「依赖出现」。 */ -function fakeCtx({ webServer = null, controller = null } = {}) { - const pending = [] - return { - webServer, - sessionController: controller, - get: () => undefined, - inject(deps, callback) { - pending.push({ deps, callback }) - return { dispose() {} } - }, - fire(dep, scoped) { - const hit = pending.filter((row) => row.deps.includes(dep)) - for (const row of hit) row.callback(scoped) - return hit.length - }, - pending, - } -} - -function fakeRes() { - const res = { - statusCode: 0, - headers: {}, - body: '', - writableEnded: false, - headersSent: false, - setHeader(name, value) { - this.headers[String(name).toLowerCase()] = value - return this - }, - writeHead(status, headers) { - this.statusCode = status - for (const [name, value] of Object.entries(headers ?? {})) this.headers[String(name).toLowerCase()] = value - this.headersSent = true - return this - }, - end(chunk) { - if (chunk !== undefined) this.body += String(chunk) - this.writableEnded = true - return this - }, - get json() { - return this.body === '' ? null : JSON.parse(this.body) - }, - } - return res -} - -function fakeReq(method, url, body) { - const text = body === undefined ? '' : JSON.stringify(body) - const stream = Readable.from(body === undefined ? [] : [Buffer.from(text, 'utf8')]) - stream.method = method - stream.url = url - stream.headers = { 'content-type': 'application/json' } - return stream -} - -async function callRoute(webServer, suffix, method, body) { - const route = [...webServer.routes.values()].find((item) => String(item.path).endsWith(suffix)) - assert.notEqual(route, undefined, `未注册路由:${suffix}`) - const res = fakeRes() - await route.handler(fakeReq(method, route.path, body), res) - return res.json -} - -/** 所有测试都用内存账本,绝不碰 %DSH_HOME% 下的真账本。 */ -function memoryStore() { - return new WorkbenchStore({ file: null, clock }) -} - -function tinyController(seed = ['ses_gongbu']) { - const sessions = new Map() - const prompts = [] - for (const sessionId of seed) { - sessions.set(sessionId, { sessionId, workspaceId: WS, running: false, accepted: new Set() }) - } - return { - prompts, - sessions, - async create(request) { - const sessionId = request.sessionId ?? 'ses_auto' - sessions.set(sessionId, { sessionId, workspaceId: request.workspaceId ?? WS, running: false, accepted: new Set() }) - return { sessionId } - }, - async prompt(request) { - prompts.push(request) - const row = sessions.get(request.sessionId) - if (row === undefined || !row.accepted) throw Object.assign(new Error('no session'), { code: 'session/conflict' }) - row.accepted.add(request.requestId) - return { accepted: true } - }, - cancel() { - return { accepted: true } - }, - } -} - -test('装配层:宿主先有 webServer、后有 sessionController 时,派发从“只落账”升级为真投递', async () => { - const store = memoryStore() - const webServer = fakeWebServer() - const ctx = fakeCtx({ webServer }) - - const host = createWorkbenchHost(ctx, { store, startReconciler: false }) - assert.equal(host.store, store) - assert.equal(host.registered, true) - assert.equal(webServer.routes.size, 13) - assert.equal(host.hasSessions, false) - - const project = host.service.registerProject({ hostWorkspaceId: WS }).project - const bound = host.service.bindDepartmentSession({ projectId: project.id, roleId: 'gongbu', sessionId: 'ses_gongbu' }) - const generation = bound.binding.bindingGeneration - const task = host.service.createTask({ - projectId: project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: '接线后派发', - objective: 'o', - status: 'queued', - }).task - - // 还没有会话层:路由只落账,状态停在 prepared,不伪装成已发送。 - const before = await callRoute(webServer, '/dispatch', 'POST', { - projectId: project.id, - taskId: task.id, - idempotencyKey: 'k-ledger', - targetRoleId: 'gongbu', - targetSessionId: 'ses_gongbu', - bindingGeneration: generation, - }) - assert.equal(before.ok, true) - assert.equal(before.value.dispatch.status, 'prepared') - - // 宿主晚到:装配层自己把会话层补挂上,不需要重建工作台、也不需要多重启一次。 - const controller = tinyController() - assert.equal(ctx.fire('sessionController', { sessionController: controller }), 1) - assert.equal(host.hasSessions, true) - assert.notEqual(host.dispatchService, null) - assert.notEqual(host.reconciler, null) - - // 同一份账本、同一张任务,换新的幂等键再派一次:这次真的投递到会话。 - const after = await callRoute(webServer, '/dispatch', 'POST', { - projectId: project.id, - taskId: task.id, - idempotencyKey: 'k-live', - targetRoleId: 'gongbu', - targetSessionId: 'ses_gongbu', - bindingGeneration: generation, - }) - assert.equal(after.ok, true) - assert.equal(after.value.dispatch.state ?? after.value.dispatch.status, 'accepted') - assert.equal(controller.prompts.length, 1) - - host.dispose() - assert.equal(webServer.routes.size, 0) -}) - -test('装配层:重复挂载会话层是幂等的,不会把已挂上的换掉', () => { - const store = memoryStore() - const ctx = fakeCtx({ webServer: fakeWebServer() }) - const host = createWorkbenchHost(ctx, { store, startReconciler: false }) - assert.equal(host.hasSessions, false) - - assert.equal(host.attachSessions(tinyController()), true) - const first = host.sessions - assert.equal(host.attachSessions(tinyController()), true) - assert.equal(host.sessions, first) - host.dispose() -}) - -test('A05 两席闭环:丞相派工给工部 → 工部回执 → 成果登记 → 任务完成', async () => { - const store = memoryStore() - const webServer = fakeWebServer() - const controller = tinyController(['ses_gongbu']) - const ctx = fakeCtx({ webServer, controller }) - - const host = createWorkbenchHost(ctx, { store, startReconciler: false }) - assert.equal(host.hasSessions, true, '有 sessionController 时就该能派发') - - // 1) 项目 + 工部接通(丞相那一席由账本自带,不需要建会话也能当派发方) - const project = host.service.registerProject({ hostWorkspaceId: WS, displayNameCache: '闭环' }).project - const bound = host.service.bindDepartmentSession({ projectId: project.id, roleId: 'gongbu', sessionId: 'ses_gongbu' }) - - // 2) 丞相开任务并派给工部 - const task = host.service.createTask({ - projectId: project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: '做一版预算', - objective: '给出预算表', - status: 'queued', - }).task - - const dispatched = await callRoute(webServer, '/dispatch', 'POST', { - projectId: project.id, - taskId: task.id, - targetRoleId: 'gongbu', - idempotencyKey: 'loop-1', - targetSessionId: 'ses_gongbu', - bindingGeneration: bound.binding.bindingGeneration, - }) - assert.equal(dispatched.ok, true, JSON.stringify(dispatched)) - assert.equal(dispatched.value.dispatch.status, 'accepted') - assert.equal(controller.prompts.length, 1, '工部会话应真实收到一条任务单') - assert.ok(controller.prompts[0].content[0].text.includes('做一版预算')) - - const attempt = store.listAttempts(task.id)[0] - assert.ok(attempt, '派发要落一条 attempt') - - // 3) 工部登记成果,再用契约行回执(正文里说“已完成”不算) - const artifact = host.service.registerArtifact({ - projectId: project.id, - ownerRoleId: 'gongbu', - taskId: task.id, - displayName: '预算表', - fileRef: 'C:/work/预算.xlsx', - verification: { status: 'verified' }, - }).artifact - - const ingest = await callRoute(webServer, '/ingest', 'POST', { - projectId: project.id, - roleId: 'gongbu', - text: `【三省六部】${JSON.stringify({ - action: 'reportTaskResult', - taskId: task.id, - attemptId: attempt.id, - reportVersion: 1, - report: { - summary: '预算表已出', - checks: [{ name: '合计对得上', ok: true, detail: '与台账一致' }], - artifactRefs: [artifact.id], - }, - })}`, - }) - assert.equal(ingest.ok, true, JSON.stringify(ingest)) - assert.equal(ingest.value.applied.length, 1, JSON.stringify(ingest.value.failed)) - - // 4) 会话跑完:报告 + 终态成功 + 成果有效 → 任务完成 - host.service.reportRunTerminal({ - projectId: project.id, - taskId: task.id, - attemptId: attempt.id, - runTerminal: 'succeeded', - }) - const done = store.getTask(task.id) - assert.equal(done.status, 'completed') - assert.ok(store.listResults(task.id).length >= 1, '回执要落成 Result,而不是只改任务状态') - assert.equal(store.listArtifacts(project.id).length, 1) - assert.equal(store.getDispatch(dispatched.value.dispatch.id).status, 'accepted') -}); diff --git a/workbench/test/host.test.mjs b/workbench/test/host.test.mjs deleted file mode 100644 index fb1c80c..0000000 --- a/workbench/test/host.test.mjs +++ /dev/null @@ -1,357 +0,0 @@ -// Host 层测试:契约解析、会话适配、派发幂等、对账与工作台外壳。 -// 全部用假 SessionController(与 P0 记录的签名同形)驱动,不连真宿主, -// 这样“首次派发 / 重复点击 / 超时未知 / 宿主重启后对账”都能确定性地复现。 - -import test from 'node:test' -import assert from 'node:assert/strict' - -import { WorkbenchStore } from '../core/store.mjs' -import { createWorkbenchService } from '../host/service.mjs' -import { - CONTRACT_ACTION_PREFIX, - parseContractLines, - validateContractCall, - describeContract, -} from '../host/contract.mjs' -import { buildDispatchText, classifyHostError, createSessionAdapter } from '../host/session-adapter.mjs' -import { createDispatchService } from '../host/dispatch-service.mjs' -import { createReconciler } from '../host/reconciler.mjs' -import { createWorkbenchHost } from '../host/workbench-host.mjs' - -const clock = () => 1700000000000 -const WS = 'ws_demo' - -/** 假宿主:行为可控,记录每次 create/prompt/cancel,便于断言“没重发”。 */ -function fakeController(behaviour = {}) { - const calls = { create: [], prompt: [], cancel: [], selectModel: [], inspect: [], list: 0 } - const sessions = new Map() - let next = 1 - const controller = { - calls, - sessions, - async create(request) { - calls.create.push(request) - const existing = [...sessions.values()].find((row) => row.workspaceId === request.workspaceId) - if (existing !== undefined && request.sessionId === undefined) return { sessionId: existing.sessionId } - const sessionId = request.sessionId ?? `ses_${next++}` - sessions.set(sessionId, { sessionId, workspaceId: request.workspaceId ?? null, running: false, accepted: new Set() }) - return { sessionId, agentPreset: request.agentPreset ?? null } - }, - async inspect(sessionId) { - calls.inspect.push(sessionId) - const row = sessions.get(sessionId) - if (row === undefined) throw Object.assign(new Error('not found'), { code: 'session/not-found' }) - return { sessionId, attached: true } - }, - async prompt(request) { - calls.prompt.push(request) - const row = sessions.get(request.sessionId) - if (row === undefined) throw Object.assign(new Error('no session'), { code: 'session/conflict' }) - if (behaviour.promptFails === 'timeout') throw Object.assign(new Error('timeout picking up request'), { code: 'ETIMEDOUT' }) - if (behaviour.promptFails === 'busy') throw Object.assign(new Error('agent busy'), { code: 'session/agent-busy' }) - if (row.accepted.has(request.requestId)) return { accepted: true } - row.accepted.add(request.requestId) - row.running = behaviour.staysRunning !== false - return { accepted: true } - }, - cancel(request) { - calls.cancel.push(request) - const row = sessions.get(request.sessionId) - if (row !== undefined) row.running = false - return { accepted: true } - }, - async selectModel(request) { - calls.selectModel.push(request) - if (behaviour.selectModelFails === true) { - throw Object.assign(new Error('model unavailable'), { code: 'session/model-unavailable' }) - } - return { selected: { provider: request.provider, model: request.model } } - }, - async list() { - calls.list += 1 - return { - items: [...sessions.values()].map((row) => ({ sessionId: row.sessionId, running: row.running, agentAvailable: true, updatedAt: '', blank: false })), - } - }, - } - return controller -} - -function freshWorkbench(behaviour = {}) { - const store = new WorkbenchStore({ file: null, clock, env: { DSH_HOME: '/tmp/never-used' } }) - const service = createWorkbenchService({ store, clock }) - const controller = fakeController(behaviour) - const sessions = createSessionAdapter({ sessionController: controller }) - const dispatch = createDispatchService({ store, service, sessions }) - const reconciler = createReconciler({ store, service, sessions, clock }) - const project = service.registerProject({ hostWorkspaceId: WS, displayNameCache: '演示项目' }).project - // 接通丞相与工部两个会话(首版两席闭环)。 - for (const roleId of ['lead', 'gongbu']) { - const sessionId = roleId === 'lead' ? 'ses_lead' : 'ses_gongbu' - controller.sessions.set(sessionId, { sessionId, workspaceId: WS, running: false, accepted: new Set() }) - service.bindDepartmentSession({ projectId: project.id, roleId, sessionId, allowReplace: false }) - } - service.saveDepartmentConfig({ - projectId: project.id, - roleId: 'gongbu', - provider: 'magpie', - model: 'workbuddy/deepseek-v4.1-flash', - expectedRevision: 0, - }) - return { store, service, controller, sessions, dispatch, reconciler, projectId: project.id } -} - -// ---------- 契约 ---------- - -test('契约解析只认四动作,坏 JSON 与未知动作都不改状态', () => { - const text = [ - '普通正文,不含指令。', - `${CONTRACT_ACTION_PREFIX}{"action":"reportTaskResult","taskId":"task_1","attemptId":"att_1","summary":"完成"}`, - `${CONTRACT_ACTION_PREFIX}{"action":"finalizeEverything","taskId":"task_1"}`, - `${CONTRACT_ACTION_PREFIX}{不是 JSON}`, - '我已经完成了。', - ].join('\n') - const { calls, invalid } = parseContractLines(text) - assert.equal(calls.length, 1) - assert.equal(calls[0].action, 'reportTaskResult') - assert.equal(invalid.length, 2) - assert.match(invalid[0].reason, /未知动作/) - assert.match(invalid[1].reason, /JSON/) - // 纯文本“已完成”不产生任何调用:这是方案明令禁止的推断路径。 - assert.deepEqual(parseContractLines('任务已完成,请查收').calls, []) - assert.deepEqual(parseContractLines(null), { calls: [], invalid: [] }) -}) - -test('validateContractCall 拦住缺幂等键/缺摘要的调用', () => { - assert.deepEqual(validateContractCall({ action: 'dispatchTask', payload: { taskId: 'task_1', idempotencyKey: 'k' } }), []) - assert.deepEqual(validateContractCall({ action: 'reportTaskResult', payload: { taskId: 'task_1', attemptId: 'att_1', summary: 's' } }), []) - assert.match(validateContractCall({ action: 'dispatchTask', payload: { taskId: 'task_1' } })[0], /idempotencyKey/) - assert.match(validateContractCall({ action: 'reportTaskResult', payload: { taskId: 't' } }).join(';'), /attemptId/) - assert.match(validateContractCall({ action: 'requestTaskInput', payload: { taskId: 't', attemptId: 'a' } }).join(';'), /reason/) - assert.match(validateContractCall({ action: 'syncDecision', payload: { taskId: 't' } }).join(';'), /decision/) - assert.match(describeContract(), /reportTaskResult/) -}) - -// ---------- 会话适配 ---------- - -test('会话适配:缺 sessionId 时按 workspace 建会话且不重复建', async () => { - const controller = fakeController() - const sessions = createSessionAdapter({ sessionController: controller }) - const first = await sessions.ensureSession({ workspaceId: WS, agentPreset: 'sansheng-liubu' }) - const second = await sessions.ensureSession({ workspaceId: WS, agentPreset: 'sansheng-liubu' }) - assert.equal(first.created, true) - assert.equal(first.sessionId, second.sessionId, '同一 workspace 不能建出第二个会话') - assert.equal(controller.calls.create.length, 2) - await assert.rejects(() => sessions.ensureSession({}), /workspaceId/) -}) - -test('会话适配:prompt 必须带 requestId,错误分类可区分可重试与必失败', async () => { - const controller = fakeController() - const sessions = createSessionAdapter({ sessionController: controller }) - await assert.rejects(() => sessions.sendPrompt({ sessionId: 'ses_1', text: 'hi' }), /requestId/) - await assert.rejects(() => sessions.sendPrompt({ sessionId: 'ses_1', requestId: 'r1', text: ' ' }), /为空/) - assert.equal(classifyHostError(Object.assign(new Error('x'), { code: 'session/conflict' })), 'conflict') - assert.equal(classifyHostError(Object.assign(new Error('x'), { code: 'session/model-unavailable' })), 'model_unavailable') - assert.equal(classifyHostError(new Error('request timeout')), 'transient') - assert.equal(classifyHostError(new Error('随便什么')), 'unknown') -}) - -test('派发提示词只写事实,不给“已完成”下定义', () => { - const text = buildDispatchText({ - task: { id: 'task_1', title: '整理报表', objective: '合并三张表', acceptance: ['口径一致'], constraints: ['只读源文件'] }, - packet: { materialRefs: ['a.xlsx'] }, - contractGuide: '(结构化回传说明)', - roleName: '工部', - }) - assert.match(text, /任务单 task_1/) - assert.match(text, /口径一致/) - assert.match(text, /a\.xlsx/) - assert.match(text, /不要只在正文里说“已完成”/) -}) - -// ---------- 派发 ---------- - -test('首次派发:固定模型快照 → prompt 用 attemptId 作幂等键 → dispatch accepted', async () => { - const { store, service, controller, dispatch, projectId } = freshWorkbench() - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: '导出报表', objective: '按模板导出' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k1' }) - assert.equal(result.outcome, 'accepted') - assert.equal(result.duplicate, false) - const attempt = store.getAttempt(result.attempt.id) - assert.equal(attempt.state, 'running') - // A06:默认不调 selectModel(部门模型由政策插件在 agent/request 上覆写, - // 再调一次会让宿主把全局默认模型存成本部门的)。模型快照仍记在 attempt 上。 - assert.equal(controller.calls.selectModel.length, 0, "默认不碰宿主的模型选择") - assert.equal(attempt.effectiveConfigSnapshot.model, "workbuddy/deepseek-v4.1-flash") - assert.equal(controller.calls.prompt.length, 1) - assert.equal(controller.calls.prompt[0].requestId, attempt.id, 'attemptId 就是 prompt 的幂等键') - assert.equal(store.getDispatch(result.dispatch.id).state, 'accepted') -}) - -test('重复点击同一幂等键:不重复投递、返回既有结论', async () => { - const { service, controller, dispatch, projectId } = freshWorkbench() - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const first = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'same' }) - const second = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'same' }) - assert.equal(second.duplicate, true) - assert.equal(second.dispatch.id, first.dispatch.id) - assert.equal(controller.calls.prompt.length, 1, '第二次点击不能再发一条消息') -}) - -test('投递超时:dispatch 记 unknown,不自动重发', async () => { - const { store, service, controller, dispatch, projectId } = freshWorkbench({ promptFails: 'timeout' }) - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k-timeout' }) - assert.equal(result.outcome, 'unknown') - assert.equal(store.getDispatch(result.dispatch.id).state, 'unknown') - assert.equal(store.getAttempt(result.attempt.id).state, 'unknown') - assert.equal(controller.calls.prompt.length, 1) - // 再点一次同一幂等键:仍是 unknown,不会再发第二遍 - const again = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k-timeout' }) - assert.equal(again.duplicate, true) - assert.equal(controller.calls.prompt.length, 1) - // 查证:会话确实存在 → 收口为 accepted - const verified = await dispatch.verifyUnknown(result.dispatch.id) - assert.equal(verified.outcome, 'accepted') - assert.equal(store.getAttempt(result.attempt.id).state, 'running') -}) - -test('部门未接通时派发被拒,任务留在账上而不是变成失败', async () => { - const { store, service, dispatch, projectId } = freshWorkbench() - // 户部没有接通会话:只能先存草稿,入队会被明确拒绝(派给没会话的部门只会在投递阶段撞 unknown)。 - const task = service.createTask({ projectId, ownerRoleId: 'hubu', sourceRoleId: 'lead', title: 't', objective: 'o', status: 'draft' }).task - await assert.rejects( - () => dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k' }), - (error) => error.code === 'INVALID_STATE', - ) - assert.equal(store.getTask(task.id).status, 'draft', '被拒的派发不改任务状态') -}) - -// ---------- 对账 ---------- - -test('对账:宿主还在跑只推进 running,不判完成', async () => { - const { store, service, dispatch, reconciler, projectId } = freshWorkbench({ staysRunning: true }) - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k' }) - const outcome = await reconciler.reconcileOnce() - assert.equal(outcome.checked >= 1, true) - assert.equal(store.getTask(task.id).status, 'running', '还在跑就不是完成') - assert.equal(store.getAttempt(result.attempt.id).state, 'running') -}) - -test('对账:运行结束但无报告 → needs_attention,而不是 completed', async () => { - const { store, service, controller, dispatch, reconciler, projectId } = freshWorkbench() - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k' }) - controller.sessions.get('ses_gongbu').running = false - await reconciler.reconcileOnce() - assert.equal(store.getAttempt(result.attempt.id).state, 'succeeded') - assert.equal(store.getTask(task.id).status, 'needs_attention') - assert.match(store.getTask(task.id).needsAttentionReason, /结构化报告/) -}) - -test('对账:取消请求后宿主停跑 → attempt cancelled、任务 cancelled', async () => { - const { store, service, controller, dispatch, reconciler, sessions, projectId } = freshWorkbench() - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k' }) - // 只发停止请求:cancel() 是同步 accepted,不等于已停,此时尝试仍停在 running。 - sessions.requestCancel('ses_gongbu') - controller.sessions.get('ses_gongbu').running = false - await reconciler.reconcileOnce() - assert.equal(store.getAttempt(result.attempt.id).state, 'cancelled') - assert.equal(store.getTask(task.id).status, 'cancelled') -}) - -test('对账:宿主重启后查不到会话时不猜,保持原状', async () => { - const { store, service, controller, dispatch, reconciler, projectId } = freshWorkbench() - const task = service.createTask({ projectId, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o' }).task - const result = await dispatch.dispatch({ projectId, taskId: task.id, idempotencyKey: 'k' }) - // 让 list 抛错:问不到 = null - controller.list = async () => { - throw new Error('host restarting') - } - const outcome = await reconciler.reconcileOnce() - assert.equal(outcome.changed.length, 0) - assert.equal(store.getAttempt(result.attempt.id).state, 'running') -}) - -// ---------- 工作台外壳 ---------- - -test('工作台外壳:浏览器侧/无会话能力时降级为只读账本', async () => { - const store = new WorkbenchStore({ file: null, clock }) - const host = createWorkbenchHost({}, { store }) - assert.equal(host.hasSessions, false) - const project = host.service.registerProject({ hostWorkspaceId: WS }).project - const bootstrap = host.bootstrap(project.id) - assert.equal(bootstrap.seats.length, 10) - assert.equal(bootstrap.seats.filter((seat) => seat.connected).length, 0) - assert.equal(bootstrap.seats[0].pendingLabel, '尚未接通') - const dispatched = await host.dispatchTask({ projectId: project.id, taskId: 'task_x', idempotencyKey: 'k' }) - assert.equal(dispatched.ok, false) - assert.equal(dispatched.code, 'NO_SESSION_CONTROLLER') -}) - -test('工作台外壳:接通部门写出绑定,且同一会话不能同时属于两个部门', async () => { - const store = new WorkbenchStore({ file: null, clock }) - const controller = fakeController() - const host = createWorkbenchHost({ sessionController: controller }, { store }) - const project = host.service.registerProject({ hostWorkspaceId: WS }).project - const gongbu = await host.connectDepartment({ projectId: project.id, roleId: 'gongbu' }) - assert.equal(gongbu.created, true) - assert.equal(gongbu.seat.connected, true) - // 把工部已在用的会话硬塞给户部:store 必须拒绝(会话独占) - await assert.rejects( - () => host.connectDepartment({ projectId: project.id, roleId: 'hubu', sessionId: gongbu.sessionId }), - (error) => error.code === 'SESSION_CONFLICT', - ) - const seats = host.bootstrap(project.id).seats - assert.equal(seats.find((seat) => seat.roleId === 'gongbu').connected, true) - assert.equal(seats.find((seat) => seat.roleId === 'hubu').connected, false) -}) - -test('工作台外壳:ingestAgentOutput 只应用可解析的契约行', () => { - const store = new WorkbenchStore({ file: null, clock }) - const host = createWorkbenchHost({}, { store }) - const project = host.service.registerProject({ hostWorkspaceId: WS }).project - // 无会话能力的外壳里工部未接通,只能建草稿;这里要验的是契约解析,不是入队资格。 - const task = host.service.createTask({ projectId: project.id, ownerRoleId: 'gongbu', sourceRoleId: 'lead', title: 't', objective: 'o', status: 'draft' }).task - // 草稿要先入队,才谈得上 waiting_input。 - store.updateTask({ ...store.getTask(task.id), status: 'queued' }) - const text = [ - '正文里说一句“已完成”,不算数。', - `${CONTRACT_ACTION_PREFIX}${JSON.stringify({ action: 'requestTaskInput', taskId: task.id, reason: '缺口径' })}`, - ].join('\n') - const out = host.ingestAgentOutput({ projectId: project.id, roleId: 'gongbu', text }) - assert.equal(out.applied.length, 1) - assert.equal(out.failed.length, 0) - assert.equal(store.getTask(task.id).status, 'waiting_input') -}) - -test('工作台外壳:sessionController 晚到后仍能补挂会话层(不必多重启一次)', async () => { - const store = new WorkbenchStore({ file: null, clock }) - // 模拟 apply 那一刻宿主还没装好 sessionController。 - const host = createWorkbenchHost({}, { store }) - const project = host.service.registerProject({ hostWorkspaceId: WS }).project - assert.equal(host.hasSessions, false) - const refused = await host.dispatchTask({ projectId: project.id, taskId: 'task_x', idempotencyKey: 'k1', sourceRoleId: 'lead', targetRoleId: 'gongbu', targetSessionId: 'ses_gongbu', bindingGeneration: 0 }) - assert.equal(refused.ok, false) - assert.equal(refused.code, 'NO_SESSION_CONTROLLER') - - // 宿主稍后把会话控制器交过来:同一实例直接挂上,不需要重建工作台。 - const controller = fakeController() - assert.equal(host.attachSessions(controller), true) - assert.equal(host.hasSessions, true) - assert.notEqual(host.sessions, null) - assert.notEqual(host.dispatchService, null) - assert.notEqual(host.reconciler, null) - - // 重复挂载必须幂等:不能把已有会话层换掉。 - const first = host.sessions - assert.equal(host.attachSessions(fakeController()), true) - assert.equal(host.sessions, first) - - // 挂上之后「接通部门」才真正建会话并登记到账本。 - const connected = await host.connectDepartment({ projectId: project.id, roleId: 'gongbu' }) - assert.equal(connected.sessionId, 'ses_gongbu'.replace('ses_gongbu', connected.sessionId)) - assert.equal(store.getBinding(project.id, 'gongbu').currentSessionId, connected.sessionId) -}) diff --git a/workbench/test/ids.test.mjs b/workbench/test/ids.test.mjs deleted file mode 100644 index 19d61b1..0000000 --- a/workbench/test/ids.test.mjs +++ /dev/null @@ -1,58 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { - createIdFactory, - ID_ENTITIES, - ID_PREFIXES, - cryptoRandom, - isIdOf, - newId, -} from '../core/ids.mjs' - -test('every entity prefix appears in the plan and generated ids round-trip', () => { - for (const entity of ID_ENTITIES) { - const id = newId(entity, { random: () => 0 }) - assert.match(id, new RegExp(`^${ID_PREFIXES[entity]}_[0-9a-z]{12}$`), `${entity} 前缀正确`) - assert.equal(isIdOf(entity, id), true) - } - // 前缀本身也能直接使用,方便调用方不想记实体名的场景。 - assert.match(newId('task', { random: () => 3 }), /^task_3{12}$/) -}) - -test('prefixes stay unique so ids cannot be confused across entities', () => { - const prefixes = Object.values(ID_PREFIXES) - assert.equal(new Set(prefixes).size, prefixes.length) - assert.deepEqual(prefixes.slice(0, 3), ['proj', 'bind', 'cfg']) -}) - -test('injected random source makes ids reproducible', () => { - const seq = (limit) => { - let index = 0 - return () => index++ % limit - } - assert.equal(newId('project', { random: seq(36), length: 6 }), 'proj_012345') - const a = createIdFactory({ random: () => 1, length: 4 }) - const b = createIdFactory({ random: () => 1, length: 4 }) - for (const entity of ID_ENTITIES) { - assert.equal(a[entity](), b[entity]()) - assert.match(a[entity](), new RegExp(`^${ID_PREFIXES[entity]}_`)) - } -}) - -test('character alphabet values are accepted and unknown prefixes rejected', () => { - assert.equal(newId('result', { random: (i) => ['a', 'b', 'c', 'd'][i], length: 4 }), 'res_abcd') - assert.throws(() => newId('nope', { random: () => 0 }), /未知 ID 前缀/) - assert.throws(() => newId('task', { random: () => 'Z', length: 4 }), /字母表外/) - assert.throws(() => newId('task', { random: () => 1.5, length: 4 }), /整数/) - assert.throws(() => newId('task', { random: () => 0, length: 2 }), /4..64/) - assert.equal(isIdOf('task', 'dsp_abc'), false) - assert.equal(isIdOf('task', 'task_'), false) - assert.equal(isIdOf('task', undefined), false) -}) - -test('default crypto source produces distinct ids', () => { - if (typeof globalThis.crypto?.getRandomValues !== 'function') return - assert.match(cryptoRandom(), /^[0-9a-z]$/) - const ids = new Set(Array.from({ length: 50 }, () => newId('task'))) - assert.ok(ids.size >= 45, '随机 ID 冲突率应很低') -}) diff --git a/workbench/test/panel-contract.test.mjs b/workbench/test/panel-contract.test.mjs deleted file mode 100644 index a405b22..0000000 --- a/workbench/test/panel-contract.test.mjs +++ /dev/null @@ -1,68 +0,0 @@ -// 前端与 Host 的接线契约:路径前缀、端点名、方法。 -// -// 这一条是为"重启后才暴露"的那类错误准备的:如果 panel 里写的是 /sansheng/workbench、 -// 而 Host 改了 ROUTE_PREFIX,真实宿主里所有请求都会 404,界面看起来就是"一直在读、什么都不出来"。 -// 单测跑得比重启快,所以把这条约束钉在测试里。 - -import test from 'node:test' -import assert from 'node:assert/strict' -import { readFileSync } from 'node:fs' -import { fileURLToPath } from 'node:url' -import { dirname, join } from 'node:path' - -import { ROUTE_PREFIX, listWorkbenchRoutes } from '../host/routes.mjs' - -const here = dirname(fileURLToPath(import.meta.url)) -const clientFile = join(here, '..', 'panel', 'lib', 'client.js') - -function readClient() { - return readFileSync(clientFile, 'utf8') -} - -/** 从 apiGet("x") / apiPost("x") 里取出前端真正会请求的端点名。 */ -function clientEndpoints(source) { - const names = new Set() - const pattern = /api(?:Get|Post)\(\s*"([^"]+)"/g - let match = pattern.exec(source) - while (match !== null) { - names.add(match[1]) - match = pattern.exec(source) - } - return [...names].sort() -} - -test('panel 的 API_BASE 与 Host 的 ROUTE_PREFIX 完全一致', () => { - const source = readClient() - const match = /const\s+API_BASE\s*=\s*"([^"]+)"/.exec(source) - assert.ok(match, 'panel 里找不到 API_BASE 声明') - assert.equal(match[1], ROUTE_PREFIX, '两边前缀不一致,真实宿主里会全体 404') -}) - -test('panel 请求的每个端点,Host 都真的注册了', () => { - const routes = listWorkbenchRoutes() - const known = new Set(routes.map((route) => route.path.slice(ROUTE_PREFIX.length + 1))) - const requested = clientEndpoints(readClient()) - - assert.ok(requested.length >= 5, `只解析到 ${requested.length} 个端点,说明提取规则失效了`) - const missing = requested.filter((name) => !known.has(name)) - assert.deepEqual(missing, [], `panel 请求了 Host 没有的端点:${missing.join(', ')}`) -}) - -test('前端会改状态的端点都是 POST,读取类都是 GET', () => { - const source = readClient() - const byMethod = new Map(listWorkbenchRoutes().map((route) => [route.path.slice(ROUTE_PREFIX.length + 1), route.method])) - - const postPattern = /apiPost\(\s*"([^"]+)"/g - let match = postPattern.exec(source) - while (match !== null) { - assert.equal(byMethod.get(match[1]), 'POST', `apiPost 打了 ${match[1]},但 Host 上它不是 POST`) - match = postPattern.exec(source) - } - - const getPattern = /apiGet\(\s*"([^"]+)"/g - match = getPattern.exec(source) - while (match !== null) { - assert.equal(byMethod.get(match[1]), 'GET', `apiGet 打了 ${match[1]},但 Host 上它不是 GET`) - match = getPattern.exec(source) - } -}) diff --git a/workbench/test/roles.test.mjs b/workbench/test/roles.test.mjs deleted file mode 100644 index 6def71a..0000000 --- a/workbench/test/roles.test.mjs +++ /dev/null @@ -1,123 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { - LAYOUT_ORDER, - LEADERS, - MINISTRIES, - ROLE_IDS, - ROLE_NAMES, - ROLE_NAME_ALIASES, - ROLES, - canDispatch, - getRole, - initialSeats, - isRoleId, - layoutGroups, - requireRole, -} from '../core/roles.mjs' - -test('ten seats keep the plan roleIds in the plan order', () => { - assert.deepEqual([...ROLE_IDS], ['lead', 'zhongshu', 'shangshu', 'menxia', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu']) - assert.deepEqual(ROLES.map((seat) => seat.id), [...ROLE_IDS], '导出数组即布局顺序') - assert.equal(ROLES.length, 10) - // 吏部与礼部不可混用:名称、ID、位置都不同。 - assert.equal(ROLE_NAMES.libu, '吏部') - assert.equal(ROLE_NAMES.lipu, '礼部') -}) - -test('seat names and duties match the plan table', () => { - const expected = { - lead: '丞相', - zhongshu: '中书', - shangshu: '尚书', - menxia: '门下', - libu: '吏部', - hubu: '户部', - lipu: '礼部', - bingbu: '兵部', - xingbu: '刑部', - gongbu: '工部', - } - for (const [id, name] of Object.entries(expected)) { - assert.equal(ROLE_NAMES[id], name) - assert.ok(getRole(id).duty.length > 0, `${id} 有职责描述`) - assert.ok(getRole(id).responsibility.length > 10, `${id} 有较完整职责说明`) - } - assert.equal(getRole('lead').duty, '接需求、分流、协调、汇报') - assert.equal(getRole('gongbu').duty, '代码实现与工程产出') -}) - -test('tiers split the chancellery from the six ministries', () => { - assert.deepEqual([...LEADERS], ['lead', 'zhongshu', 'shangshu', 'menxia']) - assert.deepEqual([...MINISTRIES], ['libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu']) - assert.equal(getRole('lead').tier, 'leaders') - assert.equal(getRole('shangshu').tier, 'leaders') - assert.equal(getRole('gongbu').tier, 'ministries') -}) - -test('layout is three columns with the chancellor centred on top', () => { - assert.deepEqual( - { row: getRole('lead').row, column: getRole('lead').column }, - { row: 0, column: 'span' }, - '丞相跨三列居中', - ) - const sansheng = ['zhongshu', 'shangshu', 'menxia'].map((id) => getRole(id)) - assert.deepEqual(sansheng.map((seat) => seat.column), ['left', 'center', 'right']) - assert.ok(sansheng.every((seat) => seat.row === 1)) - // 六部两排:吏户礼 / 兵刑工 - assert.deepEqual( - ['libu', 'hubu', 'lipu'].map((id) => getRole(id).column), - ['left', 'center', 'right'], - ) - assert.deepEqual( - ['bingbu', 'xingbu', 'gongbu'].map((id) => getRole(id).column), - ['left', 'center', 'right'], - ) - assert.ok(['libu', 'hubu', 'lipu'].every((id) => getRole(id).row === 2)) - assert.ok(['bingbu', 'xingbu', 'gongbu'].every((id) => getRole(id).row === 3)) - // 六部同属一个分组,连线不画成吏部下辖兵部。 - assert.equal(new Set(MINISTRIES.map((id) => getRole(id).group)).size, 1) -}) - -test('layoutGroups renders three tiers without inventing parent links', () => { - assert.deepEqual(layoutGroups().lead, ['lead']) - assert.deepEqual(layoutGroups().sansheng, ['zhongshu', 'shangshu', 'menxia']) - assert.deepEqual(layoutGroups().ministries, [['libu', 'hubu', 'lipu'], ['bingbu', 'xingbu', 'gongbu']]) -}) - -test('role lookups reject unknown ids and keep legacy name aliases', () => { - assert.equal(isRoleId('gongbu'), true) - assert.equal(isRoleId('xingbu'), true) - assert.equal(isRoleId('兵部'), false) - assert.equal(isRoleId(undefined), false) - assert.equal(getRole('unknown'), undefined) - assert.throws(() => requireRole('hufu'), /未知角色/) - assert.deepEqual([...ROLE_NAME_ALIASES.zhongshu], ['中书省']) - assert.equal(ROLE_NAME_ALIASES.libu, undefined, '吏部没有旧名别名,防止与礼部混淆') -}) - -test('only the chancellor and shangshu may dispatch by default', () => { - assert.equal(canDispatch('lead'), true) - assert.equal(canDispatch('shangshu'), true) - for (const id of ROLE_IDS.filter((role) => role !== 'lead' && role !== 'shangshu')) { - assert.equal(canDispatch(id), false, `${id} 不自主派工`) - } -}) - -test('initial seats describe configuration rows without creating sessions', () => { - const seats = initialSeats() - assert.equal(seats.length, 10) - assert.deepEqual(seats[0], { roleId: 'lead', name: '丞相', tier: 'leaders' }) - assert.deepEqual(Object.keys(seats[0]).sort(), ['name', 'roleId', 'tier']) -}) - -test('LAYOUT_ORDER 是按布局排序的数组,可直接给 UI 渲染', () => { - assert.deepEqual( - [...LAYOUT_ORDER], - ['lead', 'zhongshu', 'shangshu', 'menxia', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu'], - ) - assert.equal(LAYOUT_ORDER.length, ROLE_IDS.length) - // 每席的 row/column 沿数组单调排列,UI 直接按顺序铺即可 - const rows = LAYOUT_ORDER.map((id) => getRole(id).row) - assert.deepEqual(rows, [...rows].sort((a, b) => a - b)) -}) diff --git a/workbench/test/routes.test.mjs b/workbench/test/routes.test.mjs deleted file mode 100644 index 743f423..0000000 --- a/workbench/test/routes.test.mjs +++ /dev/null @@ -1,587 +0,0 @@ -// 工作台 HTTP 路由测试:用假的 ctx / req / res 直接驱动 handler。 -// 这里不启真服务器:路由层要验的是契约(方法、状态码、包装、上限、长轮询语义), -// 起服务器只会把测试变慢而不多验到东西。 -// -// 长轮询只测“等待”这一侧的时序,所以 options 里把 longPollMs / pollIntervalMs 压到毫秒级; -// 25 秒是生产默认值,由 DEFAULT_LONG_POLL_MS 保证,这里断言常量本身而不是等它。 - -import test from 'node:test' -import assert from 'node:assert/strict' -import { Readable } from 'node:stream' -import { WorkbenchStore } from '../core/store.mjs' -import { createWorkbenchService } from '../host/service.mjs' -import { - MAX_BODY_BYTES, - ROUTE_PREFIX, - buildRouteTable, - listWorkbenchRoutes, - registerWorkbenchRoutes, -} from '../host/routes.mjs' - -const FIXED_NOW = Date.parse('2026-11-09T12:00:00.000Z') - -function makeService() { - let counter = 0 - const random = () => Math.imul(counter++, 2654435761) >>> 0 - const store = new WorkbenchStore({ file: null, clock: () => FIXED_NOW, random }) - const service = createWorkbenchService({ store, clock: () => FIXED_NOW }) - return { store, service } -} - -/** 假 res:只记录 writeHead/end,够断言状态码、头与体。 */ -function fakeRes() { - const res = { - statusCode: 0, - headers: {}, - body: '', - writableEnded: false, - destroyed: false, - headersSent: false, - setHeader(name, value) { - this.headers[String(name).toLowerCase()] = value - return this - }, - writeHead(status, headers) { - this.statusCode = status - for (const [name, value] of Object.entries(headers ?? {})) this.headers[String(name).toLowerCase()] = value - this.headersSent = true - return this - }, - end(chunk) { - if (chunk !== undefined) this.body += String(chunk) - this.writableEnded = true - return this - }, - get json() { - return this.body === '' ? null : JSON.parse(this.body) - }, - } - return res -} - -function fakeReq(method, url, body = undefined) { - const hasBody = body !== undefined - const text = hasBody === false ? '' : (typeof body === 'string' ? body : JSON.stringify(body)) - const stream = Readable.from(hasBody ? [Buffer.from(text, 'utf8')] : []) - stream.method = method - stream.url = url - stream.headers = { 'content-type': 'application/json' } - return stream -} - -/** 装一套路由,返回 { ctx, routes: Map, dispose, options }。 */ -function mount(service, options = {}) { - const registered = new Map() - const disposed = [] - const ctx = { - webServer: { - register(route) { - registered.set(route.path, route) - const off = () => disposed.push(route.path) - return off - }, - }, - } - const dispose = registerWorkbenchRoutes(ctx, service, { longPollMs: 30, pollIntervalMs: 5, ...options }) - const call = async (method, url, body) => { - // 注册表按“不含查询串”的精确路径索引;带 ?since= 的调用要先把查询串切掉再查。 - const path = url.search(/[?#]/) < 0 ? url : url.slice(0, url.search(/[?#]/)) - const route = registered.get(path) - assert.ok(route !== undefined, `未注册路由: ${path}`) - assert.equal(route.kind, 'exact') - const res = fakeRes() - await route.handler(fakeReq(method, url, body), res) - return res - } - return { ctx, registered, disposed, dispose, call } -} - -function seedService(service) { - const a = service.registerProject({ hostWorkspaceId: 'ws-a', displayNameCache: '项目A' }).project - const b = service.registerProject({ hostWorkspaceId: 'ws-b', displayNameCache: '项目B' }).project - service.bindDepartmentSession({ projectId: a.id, roleId: 'libu', sessionId: 'sess-a-libu' }) - service.bindDepartmentSession({ projectId: b.id, roleId: 'libu', sessionId: 'sess-b-libu' }) - return { a, b } -} - -// ---------- 注册与降级 ---------- - -test('注册:十三条 exact 路由,dispose 幂等且能全部卸载', () => { - const { service } = makeService() - const { registered, disposed, dispose } = mount(service) - assert.deepEqual([...registered.keys()].sort(), [ - `${ROUTE_PREFIX}/artifact`, - `${ROUTE_PREFIX}/artifact/revision`, - `${ROUTE_PREFIX}/bind`, - `${ROUTE_PREFIX}/bootstrap`, - `${ROUTE_PREFIX}/config`, - `${ROUTE_PREFIX}/connect`, - `${ROUTE_PREFIX}/dispatch`, - `${ROUTE_PREFIX}/events`, - `${ROUTE_PREFIX}/ingest`, - `${ROUTE_PREFIX}/project`, - `${ROUTE_PREFIX}/result`, - `${ROUTE_PREFIX}/task`, - `${ROUTE_PREFIX}/task/cancel`, - ]) - assert.equal(dispose.registered, true) - assert.equal(dispose.paths.length, 13) - dispose() - dispose() - assert.equal(disposed.length, 13, '十三条路由各卸载一次,重复调用不再卸载') -}) - -test('注册:宿主没有 webServer 时降级为 no-op,不抛', () => { - const { service } = makeService() - for (const ctx of [undefined, null, {}, { webServer: {} }, { webServer: { register: 1 } }]) { - const dispose = registerWorkbenchRoutes(ctx, service, {}) - assert.equal(typeof dispose, 'function') - assert.equal(dispose.registered, false) - assert.match(dispose.reason, /webServer/) - dispose() - } -}) - -test('注册:中途失败会回滚已注册的路由', () => { - const { service } = makeService() - let calls = 0 - const offs = [] - const ctx = { - webServer: { - register() { - calls += 1 - if (calls === 3) throw new Error('宿主拒绝注册') - const off = () => offs.push(calls) - return off - }, - }, - } - assert.throws(() => registerWorkbenchRoutes(ctx, service, {}), /宿主拒绝注册/) - assert.equal(offs.length, 2, '两条已注册的回滚') -}) - -test('listWorkbenchRoutes 列出端点与方法', () => { - const rows = listWorkbenchRoutes() - assert.equal(rows.length, 13) - assert.deepEqual(rows.find((row) => row.path.endsWith('/bootstrap')), { - path: `${ROUTE_PREFIX}/bootstrap`, - method: 'GET', - }) - assert.equal(rows.filter((row) => row.method === 'GET').length, 2) -}) - -// ---------- 方法与包装 ---------- - -test('方法:POST 路由被 GET 调用返回 405 且带 Allow', async () => { - const { service } = makeService() - const { call } = mount(service) - for (const path of Object.keys(buildRouteTable(service, {}))) { - if (path.endsWith('/bootstrap') || path.endsWith('/events')) continue - const res = await call('GET', path) - assert.equal(res.statusCode, 405, `${path} 应 405`) - assert.equal(res.headers.allow, 'POST') - assert.equal(res.json.ok, false) - assert.equal(res.json.error.code, 'METHOD_NOT_ALLOWED') - } -}) - -test('方法:GET 路由被 POST 调用返回 405 且带 Allow', async () => { - const { service } = makeService() - const { call } = mount(service) - for (const path of [`${ROUTE_PREFIX}/bootstrap`, `${ROUTE_PREFIX}/events`]) { - const res = await call('POST', path, {}) - assert.equal(res.statusCode, 405) - assert.equal(res.headers.allow, 'GET') - } -}) - -test('方法:PUT/DELETE 一律 405', async () => { - const { service } = makeService() - const { call } = mount(service) - for (const method of ['PUT', 'DELETE', 'PATCH']) { - const res = await call(method, `${ROUTE_PREFIX}/task`, { projectId: 'proj_x' }) - assert.equal(res.statusCode, 405, `${method} 应 405`) - } -}) - -test('响应头:JSON + charset、no-store、Content-Length 与实际字节一致', async () => { - const { service } = makeService() - const { call } = mount(service) - const res = await call('POST', `${ROUTE_PREFIX}/project`, { hostWorkspaceId: 'ws-a', displayNameCache: '中文项目' }) - assert.equal(res.statusCode, 200) - assert.equal(res.headers['content-type'], 'application/json; charset=utf-8') - assert.equal(res.headers['cache-control'], 'no-store') - assert.equal(res.headers['content-length'], Buffer.byteLength(res.body)) - assert.equal(res.json.ok, true) - assert.ok(res.json.value.project.id.startsWith('proj_')) -}) - -test('未实现路径:不在表里就没有路由,表本身不含其它前缀', () => { - const { service } = makeService() - const table = buildRouteTable(service, {}) - assert.equal(Object.keys(table).some((path) => path === `${ROUTE_PREFIX}/unknown`), false) - assert.equal(Object.keys(table).every((path) => path.startsWith(`${ROUTE_PREFIX}/`)), true) - // 前缀只登记 exact:绝不允许 kind='prefix' 把整棵子树交给某个 handler。 - const { registered } = mount(service) - for (const route of registered.values()) assert.equal(route.kind, 'exact') -}) - -// ---------- 请求体 ---------- - -test('请求体:非法 JSON 返回 400 INVALID_INPUT', async () => { - const { service } = makeService() - const { call } = mount(service) - const res = await call('POST', `${ROUTE_PREFIX}/project`, '{这不是 JSON') - assert.equal(res.statusCode, 400) - assert.equal(res.json.ok, false) - assert.equal(res.json.error.code, 'INVALID_INPUT') -}) - -test('请求体:JSON 数组 / null / 标量都拒绝', async () => { - const { service } = makeService() - const { call } = mount(service) - for (const raw of ['[]', 'null', '42', '"字符串"']) { - const res = await call('POST', `${ROUTE_PREFIX}/project`, raw) - assert.equal(res.statusCode, 400, `${raw} 应 400`) - assert.equal(res.json.error.code, 'INVALID_INPUT') - } -}) - -test('请求体:空体按 {} 处理,交给服务层报缺参', async () => { - const { service } = makeService() - const { call } = mount(service) - const res = await call('POST', `${ROUTE_PREFIX}/task`, undefined) - assert.equal(res.statusCode, 400) - // 路由层不替业务决定“先报哪个缺参”:服务层先校验角色,所以这里是 INVALID_ROLE。 - assert.equal(res.json.error.code, 'INVALID_ROLE') - assert.equal(res.json.error.details.field, 'ownerRoleId') -}) - -test('请求体:超过 256 KB 返回 413', async () => { - const { service } = makeService() - const { call } = mount(service) - const big = JSON.stringify({ projectId: 'proj_x', pad: 'x'.repeat(MAX_BODY_BYTES) }) - assert.ok(Buffer.byteLength(big) > MAX_BODY_BYTES) - const res = await call('POST', `${ROUTE_PREFIX}/task`, big) - assert.equal(res.statusCode, 413) - assert.equal(res.json.ok, false) - assert.equal(res.json.error.code, 'INVALID_INPUT') - assert.equal(res.json.error.details.limit, MAX_BODY_BYTES) -}) - -test('请求体:刚好等于上限不拦,超过上限 1 字节就拦', async () => { - const { service } = makeService() - const { call } = mount(service, { maxBodyBytes: 64 }) - const okBody = JSON.stringify({ pad: 'y'.repeat(64 - '{"pad":""}'.length) }) - assert.equal(Buffer.byteLength(okBody), 64) - const ok = await call('POST', `${ROUTE_PREFIX}/project`, okBody) - assert.equal(ok.statusCode, 400, '体本身合法,但缺 hostWorkspaceId → 业务 400,不是 413') - assert.notEqual(ok.statusCode, 413) - - const over = JSON.stringify({ pad: 'y'.repeat(65 - '{"pad":""}'.length) }) - assert.equal(Buffer.byteLength(over), 65) - const res = await call('POST', `${ROUTE_PREFIX}/project`, over) - assert.equal(res.statusCode, 413) -}) - -// ---------- 业务错误映射 ---------- - -test('错误映射:NOT_FOUND→404、CROSS_PROJECT→409、CONFIG_CONFLICT→409', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a, b } = seedService(service) - - const missing = await call('POST', `${ROUTE_PREFIX}/task/cancel`, { projectId: a.id, taskId: 'task_notexist001' }) - assert.equal(missing.statusCode, 404) - assert.equal(missing.json.error.code, 'NOT_FOUND') - - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - const cross = await call('POST', `${ROUTE_PREFIX}/task/cancel`, { projectId: b.id, taskId: task.id }) - assert.equal(cross.statusCode, 409) - assert.equal(cross.json.error.code, 'CROSS_PROJECT') - assert.equal(cross.body.includes(a.id), false, '不得回显另一个项目的真实 ID') - - const config = await call('POST', `${ROUTE_PREFIX}/config`, { - projectId: a.id, - roleId: 'libu', - provider: 'anthropic', - model: 'claude', - expectedRevision: 7, - }) - assert.equal(config.statusCode, 409) - assert.equal(config.json.error.code, 'CONFIG_CONFLICT') - assert.equal(config.json.error.details.currentRevision, 0) -}) - -test('错误:details 原样透出(CAS 冲突带回当前值)', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const saved = service.saveDepartmentConfig({ - projectId: a.id, - roleId: 'libu', - provider: 'anthropic', - model: 'claude-sonnet', - reasoningEffort: 'high', - expectedRevision: 0, - }) - const res = await call('POST', `${ROUTE_PREFIX}/config`, { - projectId: a.id, - roleId: 'libu', - provider: 'openai', - model: 'gpt', - expectedRevision: saved.config.configRevision, - }) - assert.equal(res.statusCode, 200) - assert.equal(res.json.value.config.model, 'gpt') -}) - -test('错误:未知 roleId → 400 INVALID_ROLE', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const res = await call('POST', `${ROUTE_PREFIX}/bind`, { projectId: a.id, roleId: 'libbu', sessionId: 'sess-x' }) - assert.equal(res.statusCode, 400) - assert.equal(res.json.error.code, 'INVALID_ROLE') -}) - -// ---------- 成功路径 ---------- - -test('bootstrap:一次拿全,且只含选中项目', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a, b } = seedService(service) - service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }) - service.createTask({ projectId: b.id, title: '乙', objective: '乙', ownerRoleId: 'libu' }) - - const res = await call('GET', `${ROUTE_PREFIX}/bootstrap?projectId=${encodeURIComponent(a.id)}`) - assert.equal(res.statusCode, 200) - const value = res.json.value - assert.equal(value.projectId, a.id) - assert.equal(value.projects.length, 2, '项目列表含全部项目(切换器要用)') - assert.equal(value.seats.length, 10) - assert.deepEqual(value.tasks.map((task) => task.title), ['甲']) - // 布局只给角色 ID:前端按 ROLES 拿名字,避免同一份数据两处维护。 - assert.deepEqual(value.layout.lead, ['lead']) -}) - -test('bootstrap:不传 projectId 时选中第一个项目', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const res = await call('GET', `${ROUTE_PREFIX}/bootstrap`) - assert.equal(res.statusCode, 200) - assert.equal(res.json.value.projectId, a.id) -}) - -test('bootstrap:伪造 projectId 返回 404,不泄露存在性', async () => { - const { service } = makeService() - const { call } = mount(service) - const { b } = seedService(service) - const res = await call('GET', `${ROUTE_PREFIX}/bootstrap?projectId=proj_zzzzzzzzzzzz`) - assert.equal(res.statusCode, 404) - assert.equal(res.json.error.code, 'NOT_FOUND') - assert.equal(res.body.includes(b.id), false) -}) - -test('project / bind / config / task 四个 POST 串起来走通', async () => { - const { service } = makeService() - const { call } = mount(service) - const created = await call('POST', `${ROUTE_PREFIX}/project`, { hostWorkspaceId: 'ws-z', displayNameCache: '项目Z' }) - const projectId = created.json.value.project.id - - const bound = await call('POST', `${ROUTE_PREFIX}/bind`, { projectId, roleId: 'libu', sessionId: 'sess-z' }) - assert.equal(bound.statusCode, 200) - assert.equal(bound.json.value.seat.connected, true) - - const configured = await call('POST', `${ROUTE_PREFIX}/config`, { - projectId, - roleId: 'libu', - provider: 'anthropic', - model: 'claude', - reasoningEffort: 'medium', - expectedRevision: 0, - }) - assert.equal(configured.statusCode, 200) - assert.equal(configured.json.value.config.reasoningEffort, 'medium') - - const task = await call('POST', `${ROUTE_PREFIX}/task`, { - projectId, - title: '写一份摘要', - objective: '摘要', - ownerRoleId: 'libu', - }) - assert.equal(task.statusCode, 200) - assert.equal(task.json.value.task.status, 'queued') -}) - -test('artifact:直接登记成果并按修订链累加版本', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - - const first = await call('POST', `${ROUTE_PREFIX}/artifact`, { - projectId: a.id, - taskId: task.id, - displayName: '预算表.xlsx', - mediaType: 'application/vnd.ms-excel', - fileRef: 'C:/tmp/预算表.xlsx', - verification: { status: 'verified' }, - }) - assert.equal(first.statusCode, 200) - assert.equal(first.json.value.artifact.displayName, '预算表.xlsx') - assert.equal(first.json.value.artifact.revision, 1) - // 没注入 fileExists 时不猜文件在不在,如实说未知。 - assert.equal(first.json.value.artifact.existence, 'unknown') - - const second = await call('POST', `${ROUTE_PREFIX}/artifact`, { - projectId: a.id, - taskId: task.id, - displayName: '预算表(改).xlsx', - revisesArtifactId: first.json.value.artifact.id, - }) - assert.equal(second.statusCode, 200) - assert.equal(second.json.value.artifact.revision, 2) - assert.equal(second.json.value.artifact.revisesArtifactId, first.json.value.artifact.id) -}) - -test('dispatch / result / task/cancel 走通并返回去重信息', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - - const first = await call('POST', `${ROUTE_PREFIX}/dispatch`, { - projectId: a.id, - taskId: task.id, - idempotencyKey: 'route-key-1', - packet: { excerpts: ['需求'] }, - }) - assert.equal(first.statusCode, 200) - assert.equal(first.json.value.duplicate, false) - const again = await call('POST', `${ROUTE_PREFIX}/dispatch`, { - projectId: a.id, - taskId: task.id, - idempotencyKey: 'route-key-1', - }) - assert.equal(again.json.value.duplicate, true) - assert.equal(again.json.value.dispatch.id, first.json.value.dispatch.id) - - const started = service.startAttempt({ projectId: a.id, attemptId: first.json.value.attempt.id }) - const result = await call('POST', `${ROUTE_PREFIX}/result`, { - projectId: a.id, - taskId: task.id, - attemptId: started.attempt.id, - report: { summary: '做完了', checks: [] }, - runTerminal: 'succeeded', - }) - assert.equal(result.statusCode, 200) - assert.equal(result.json.value.task.status, 'completed') - - const other = service.createTask({ projectId: a.id, title: '乙', objective: '乙', ownerRoleId: 'libu' }).task - const cancelled = await call('POST', `${ROUTE_PREFIX}/task/cancel`, { projectId: a.id, taskId: other.id, reason: '不做了' }) - assert.equal(cancelled.statusCode, 200) - assert.equal(cancelled.json.value.task.status, 'cancelled') -}) - -// ---------- 事件 ---------- - -test('events:since 之后只给新事件,游标可重放(多标签页共用一条日志)', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const head = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=0&wait=0`) - assert.equal(head.statusCode, 200) - const cursor = head.json.value.seq - assert.ok(cursor >= 1) - // since=0 会补齐历史(建项目/绑定的那些事件),游标之后的才算“新”。 - for (const event of head.json.value.events) assert.ok(event.seq <= cursor) - - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - const after = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=${cursor}&wait=0`) - assert.ok(after.json.value.events.length >= 1) - for (const event of after.json.value.events) { - assert.ok(event.seq > cursor, '只返回 since 之后的事件') - assert.equal(event.projectId, a.id) - } - - // 重放同一个 since 必须拿到同一批事件:事件日志是只读游标,不是"读一次就消失"的队列, - // 否则开两个标签页就会互相偷事件。 - const replay = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=${cursor}&wait=0`) - assert.deepEqual( - replay.json.value.events.map((event) => event.eventId), - after.json.value.events.map((event) => event.eventId), - ) - assert.ok(task.id.startsWith('task_')) -}) - -test('events:since 越界(大于当前 seq)返回 reset 让前端整体重拉', async () => { - const { service } = makeService() - const { call } = mount(service) - const { a } = seedService(service) - const res = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=999999&wait=0`) - assert.equal(res.statusCode, 200) - assert.equal(res.json.value.reset, true) - assert.equal(res.json.value.events.length, 0) -}) - -test('events:since 不是数字 → 400', async () => { - const { service } = makeService() - const { call } = mount(service) - const res = await call('GET', `${ROUTE_PREFIX}/events?since=abc&wait=0`) - assert.equal(res.statusCode, 400) - assert.equal(res.json.error.code, 'INVALID_INPUT') -}) - -test('events:长轮询等到新事件立刻返回,不等满窗口', async () => { - const { service } = makeService() - const { call } = mount(service, { longPollMs: 5_000, pollIntervalMs: 5 }) - const { a } = seedService(service) - const head = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=0&wait=0`) - const cursor = head.json.value.seq - - const startedAt = Date.now() - const pending = call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=${cursor}`) - await new Promise((resolve) => setTimeout(resolve, 20)) - service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }) - const res = await pending - const elapsed = Date.now() - startedAt - assert.equal(res.statusCode, 200) - assert.ok(res.json.value.events.length >= 1, '有新事件就返回') - assert.ok(elapsed < 2_000, `应在窗口耗尽前返回,实际 ${elapsed}ms`) -}) - -test('events:没有新事件时挂满窗口后返回空列表 + 当前 seq', async () => { - const { service } = makeService() - const { call } = mount(service, { longPollMs: 40, pollIntervalMs: 5 }) - const { a } = seedService(service) - const head = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=0&wait=0`) - const cursor = head.json.value.seq - const startedAt = Date.now() - const res = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=${cursor}`) - const elapsed = Date.now() - startedAt - assert.equal(res.statusCode, 200) - assert.deepEqual(res.json.value.events, []) - assert.equal(res.json.value.seq, cursor) - assert.ok(elapsed >= 35, `应至少挂到窗口尾,实际 ${elapsed}ms`) -}) - -test('events:longPollMs=0 时退化为立即返回', async () => { - const { service } = makeService() - const { call } = mount(service, { longPollMs: 0 }) - const { a } = seedService(service) - const startedAt = Date.now() - const res = await call('GET', `${ROUTE_PREFIX}/events?projectId=${encodeURIComponent(a.id)}&since=0`) - assert.equal(res.statusCode, 200) - assert.ok(Date.now() - startedAt < 500) -}) - -test('events:伪造 projectId 返回 404', async () => { - const { service } = makeService() - const { call } = mount(service) - seedService(service) - const res = await call('GET', `${ROUTE_PREFIX}/events?projectId=proj_zzzzzzzzzzzz&since=0&wait=0`) - assert.equal(res.statusCode, 404) - assert.equal(res.json.error.code, 'NOT_FOUND') -}) diff --git a/workbench/test/service.test.mjs b/workbench/test/service.test.mjs deleted file mode 100644 index 76906eb..0000000 --- a/workbench/test/service.test.mjs +++ /dev/null @@ -1,699 +0,0 @@ -// Host 侧业务服务测试:项目隔离、CAS、幂等派发、结果去重、完成判定三分支。 -// 全部用真实 WorkbenchStore(内存账本),不 mock 数据层——幂等与状态机就在那一层, -// 换成假 store 会把要验的东西验掉。 - -import testDefault from 'node:test' -import assert from 'node:assert/strict' -import { WorkbenchStore } from '../core/store.mjs' -import { createWorkbenchService, ServiceError } from '../host/service.mjs' - -const FIXED_NOW = Date.parse('2026-11-09T12:00:00.000Z') - -/** - * 固定时钟 + 可复现随机源:ID 可复现且互不相同,便于断言“只生成了一条”。 - * 种子来自当前用例名,这样每个用例都从同一条 ID 序列开头跑: - * 不会因为别的用例多写了几条记录,就把这里的 ID 推到别处去。 - */ -function makeService(seed = 'default') { - // 单调递增计数器 + 奇数乘法打散:每次 pick 都取一个新的 32 位整数。 - // 直接返回 counter++ 会和字母表长度 36 同周期(12 位 ID 每 36 步就重演同一串, - // 于是「同一次运行里先建任务甲、再建任务乙」可能拿到同一个 ID); - // 乘一个奇数再取 32 位无符号,保证整数性、单调可复现,且不落在 36 的周期上。 - let counter = hashSeed(seed) - const random = () => Math.imul(counter++, 2654435761) >>> 0 - const store = new WorkbenchStore({ - file: null, - clock: () => FIXED_NOW, - random, - }) - const service = createWorkbenchService({ store, clock: () => FIXED_NOW }) - return { store, service } -} - -/** 当前用例名:随机种子取自它,保证每个用例的 ID 序列彼此独立。 */ -let currentTest = 'seed' - -/** 包一层 node:test:进入用例时记下名字,供 makeService 取种子。 */ -function test(name, fn) { - return testDefault(name, (t) => { - currentTest = name - return fn(t) - }) -} - -/** 把用例名里的 ID 前缀说明清掉,只留可哈希的字符。 */ -function seedOfCurrent() { - return currentTest -} -function hashSeed(text) { - let hash = 2166136261 - for (let index = 0; index < text.length; index += 1) { - hash ^= text.charCodeAt(index) - hash = Math.imul(hash, 16777619) - } - return Math.abs(hash) % 100000 -} - -/** 建两个项目,各自把一个部门接通,返回常用 ID。 */ -function seed() { - const { store, service } = makeService(seedOfCurrent()) - const a = service.registerProject({ hostWorkspaceId: 'ws-a', displayNameCache: '项目A' }).project - const b = service.registerProject({ hostWorkspaceId: 'ws-b', displayNameCache: '项目B' }).project - service.bindDepartmentSession({ projectId: a.id, roleId: 'libu', sessionId: 'sess-a-libu' }) - service.bindDepartmentSession({ projectId: b.id, roleId: 'libu', sessionId: 'sess-b-libu' }) - return { store, service, a, b } -} - -function expectCode(fn, code) { - let caught = null - try { - fn() - } catch (error) { - caught = error - } - assert.ok(caught !== null, `期望抛出 ${code},实际没抛`) - assert.ok(caught instanceof ServiceError, `期望 ServiceError,实际 ${caught?.name}`) - assert.equal(caught.code, code, `错误码不符:${caught.code} / ${caught.message}`) - return caught -} - -// ---------- 项目 ---------- - -test('registerProject 同一工作区只建一个项目', () => { - const { service } = makeService(seedOfCurrent()) - const first = service.registerProject({ hostWorkspaceId: 'ws-a', displayNameCache: '甲' }) - assert.equal(first.duplicate, false) - const again = service.registerProject({ hostWorkspaceId: 'ws-a', displayNameCache: '甲改名' }) - assert.equal(again.duplicate, true) - assert.equal(again.project.id, first.project.id, '重复登记不换 projectId') - assert.equal(again.project.displayNameCache, '甲改名', '名称可更新') - assert.equal(service.listProjects().length, 1) - assert.equal(service.listProjects()[0].seatCount, 10) -}) - -test('listSeats 十席布局:未接通时 pending,接通后 connected', () => { - const { service, a } = seed() - const seats = service.listSeats(a.id) - assert.equal(seats.length, 10) - assert.deepEqual(seats.map((seat) => seat.roleId), [ - 'lead', 'zhongshu', 'shangshu', 'menxia', 'libu', 'hubu', 'lipu', 'bingbu', 'xingbu', 'gongbu', - ]) - const libu = seats.find((seat) => seat.roleId === 'libu') - assert.equal(libu.connected, true) - assert.equal(libu.pending, false) - assert.equal(libu.binding.currentSessionId, 'sess-a-libu') - assert.equal(libu.binding.bindingGeneration, 1) - const hubu = seats.find((seat) => seat.roleId === 'hubu') - assert.equal(hubu.connected, false) - assert.equal(hubu.pending, true) - assert.equal(hubu.pendingLabel, '尚未接通') - // 只暴露 provider/model 名字,不含任何凭据字段 - for (const seat of seats) { - assert.deepEqual(Object.keys(seat.config).sort(), ['configRevision', 'configured', 'model', 'provider', 'reasoningEffort']) - } - assert.equal(service.layout().ministries.length, 2) -}) - -// ---------- 项目隔离 ---------- - -test('项目隔离:A 的 taskId 在 B 上被拒为 CROSS_PROJECT', () => { - const { service, a, b } = seed() - const task = service.createTask({ projectId: a.id, title: '甲任务', objective: '做甲事', ownerRoleId: 'libu' }).task - expectCode(() => service.getTask(b.id, task.id), 'CROSS_PROJECT') - expectCode(() => service.cancelTask({ projectId: b.id, taskId: task.id }), 'CROSS_PROJECT') - expectCode(() => service.dispatchTask({ - projectId: b.id, - taskId: task.id, - idempotencyKey: 'k1', - }), 'CROSS_PROJECT') - expectCode(() => service.requestTaskInput({ projectId: b.id, taskId: task.id, reason: '要资料' }), 'CROSS_PROJECT') -}) - -test('项目隔离:伪造/不存在的 ID 一律 NOT_FOUND,且不泄露归属', () => { - const { service, a } = seed() - // 形状合法但不存在 - const fakeTask = expectCode(() => service.getTask(a.id, 'task_doesnotexist'), 'NOT_FOUND') - assert.ok(!JSON.stringify(fakeTask).includes('proj_'), '错误里不带任何项目 ID') - // 形状非法 - expectCode(() => service.getTask(a.id, 'not-a-task-id'), 'NOT_FOUND') - // 不存在的项目 - expectCode(() => service.listSeats('proj_ghost'), 'NOT_FOUND') - expectCode(() => service.registerProject({ hostWorkspaceId: '' }), 'INVALID_INPUT') - // 项目 A 的会话绑不到项目 B 之外的地方时不会串项目 - const conflict = expectCode(() => service.bindDepartmentSession({ - projectId: a.id, - roleId: 'hubu', - sessionId: 'sess-b-libu', - }), 'SESSION_CONFLICT') - assert.equal(conflict.details.heldBy.projectId, b_idOf(service), 'heldBy 指向真实持有者,便于 UI 解释') -}) - -/** 找项目 B 的 id(测试里只为了断言 heldBy,不参与业务)。 */ -function b_idOf(service) { - return service.listProjects().find((row) => row.hostWorkspaceId === 'ws-b').id -} - -test('项目隔离:跨项目成果引用与尝试引用被拒', () => { - const { store, service, a, b } = seed() - const taskA = service.createTask({ projectId: a.id, title: '甲', objective: '甲目标', ownerRoleId: 'libu' }).task - const taskB = service.createTask({ projectId: b.id, title: '乙', objective: '乙目标', ownerRoleId: 'libu' }).task - const artB = service.registerArtifact({ projectId: b.id, taskId: taskB.id, displayName: '乙成果' }).artifact - const dispatched = service.dispatchTask({ projectId: a.id, taskId: taskA.id, idempotencyKey: 'd-a' }) - // 用 B 的成果引用给 A 的任务交报告:拒绝 - const err = expectCode(() => service.reportTaskResult({ - projectId: a.id, - taskId: taskA.id, - attemptId: dispatched.attempt.id, - report: { summary: '做完了', artifactRefs: [artB.id] }, - runTerminal: 'succeeded', - }), 'CROSS_PROJECT') - assert.ok(!JSON.stringify(err).includes(taskB.id), '不泄露另一项目的任务 ID') - // 用 B 的尝试给 A 的任务报结果:CROSS_PROJECT - assert.ok(store.getTask(taskB.id) !== undefined) -}) - -test('项目隔离:另一项目的 attemptId 报结果被拒', () => { - const { service, a, b } = seed() - const taskA = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - const taskB = service.createTask({ projectId: b.id, title: '乙', objective: '乙', ownerRoleId: 'libu' }).task - const dispB = service.dispatchTask({ projectId: b.id, taskId: taskB.id, idempotencyKey: 'kb' }) - expectCode(() => service.reportTaskResult({ - projectId: a.id, - taskId: taskA.id, - attemptId: dispB.attempt.id, - report: { summary: '串了' }, - runTerminal: 'succeeded', - }), 'CROSS_PROJECT') -}) - -// ---------- 配置 CAS ---------- - -test('saveDepartmentConfig 走 CAS:旧 revision 冲突并带回当前值', () => { - const { service, a } = seed() - const first = service.saveDepartmentConfig({ - projectId: a.id, - roleId: 'libu', - provider: 'deepseek', - model: 'v4', - reasoningEffort: 'high', - expectedRevision: 0, - }) - assert.equal(first.configRevision, 1) - const conflict = expectCode(() => service.saveDepartmentConfig({ - projectId: a.id, - roleId: 'libu', - provider: 'openai', - model: 'gpt', - expectedRevision: 0, - }), 'CONFIG_CONFLICT') - assert.equal(conflict.details.expectedRevision, 0) - assert.equal(conflict.details.currentRevision, 1) - assert.deepEqual(conflict.details.current, { provider: 'deepseek', model: 'v4', reasoningEffort: 'high' }) - // 读回新 revision 后可以成功 - const ok = service.saveDepartmentConfig({ - projectId: a.id, - roleId: 'libu', - provider: 'openai', - model: 'gpt', - expectedRevision: conflict.details.currentRevision, - }) - assert.equal(ok.configRevision, 2) - expectCode(() => service.saveDepartmentConfig({ - projectId: a.id, - roleId: 'libu', - provider: 'x', - model: 'y', - expectedRevision: '1', - }), 'INVALID_INPUT') -}) - -test('绑定:同一会话被别处持有 → SESSION_CONFLICT;换绑需 allowReplace', () => { - const { service, a } = seed() - const bound = service.bindDepartmentSession({ projectId: a.id, roleId: 'hubu', sessionId: 'sess-hubu-1' }) - assert.equal(bound.seat.connected, true) - const conflict = expectCode(() => service.bindDepartmentSession({ - projectId: a.id, - roleId: 'hubu', - sessionId: 'sess-hubu-2', - }), 'SESSION_CONFLICT') - assert.equal(conflict.details.currentSessionId, 'sess-hubu-1') - const replaced = service.bindDepartmentSession({ - projectId: a.id, - roleId: 'hubu', - sessionId: 'sess-hubu-2', - allowReplace: true, - }) - assert.equal(replaced.binding.bindingGeneration, 2) - assert.equal(replaced.binding.historySessionRefs.length, 1, '旧会话进历史,不删除') -}) - -// ---------- 派发 ---------- - -test('dispatchTask 写 dispatch+contextPacket+attempt,同幂等键只一条', () => { - const { store, service, a } = seed() - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲目标', ownerRoleId: 'libu' }).task - const first = service.dispatchTask({ - projectId: a.id, - taskId: task.id, - idempotencyKey: 'idem-1', - packet: { excerpts: ['原始需求'], expectedOutputs: ['报告'] }, - }) - assert.equal(first.duplicate, false) - assert.equal(first.dispatch.status, 'prepared') - assert.equal(first.attempt.state, 'queued') - assert.equal(first.attempt.sessionId, 'sess-a-libu') - assert.equal(first.attempt.effectiveConfigSnapshot.provider, null) - assert.equal(first.contextPacket.version, 1) - assert.deepEqual(first.contextPacket.excerpts, ['原始需求']) - - const again = service.dispatchTask({ projectId: a.id, taskId: task.id, idempotencyKey: 'idem-1' }) - assert.equal(again.duplicate, true) - assert.equal(again.dispatch.id, first.dispatch.id, '幂等命中返回原派发') - assert.equal(again.attempt.id, first.attempt.id) - assert.equal(store.state.dispatches.size, 1, '账本里只有一条派发') - assert.equal(store.state.attempts.size, 1, '也为幂等,只有一条尝试') - - // 换个键:新派发,上下文包版本递增 - const second = service.dispatchTask({ projectId: a.id, taskId: task.id, idempotencyKey: 'idem-2' }) - assert.equal(second.duplicate, false) - assert.equal(second.contextPacket.version, 2) - assert.equal(store.state.dispatches.size, 2) -}) - -test('dispatchTask:未接通、已终态、目标与主责不一致都拒绝', () => { - const { service, a } = seed() - // 未接通会话的部门不能直接入队(默认 queued),只能先存草稿 - expectCode(() => service.createTask({ projectId: a.id, title: '丙', objective: '丙', ownerRoleId: 'hubu' }), 'INVALID_STATE') - const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'hubu', status: 'draft' }).task - expectCode(() => service.dispatchTask({ projectId: a.id, taskId: task.id, idempotencyKey: 'k' }), 'INVALID_STATE') - const queued = service.createTask({ projectId: a.id, title: '乙', objective: '乙', ownerRoleId: 'libu' }).task - expectCode(() => service.dispatchTask({ - projectId: a.id, - taskId: queued.id, - idempotencyKey: 'k2', - targetRoleId: 'hubu', - }), 'DISPATCH_INVALID') - // 换绑后旧 bindingGeneration 派发失败 - const first = service.bindDepartmentSession({ projectId: a.id, roleId: 'hubu', sessionId: 'sess-hubu' }) - const fresh = service.createTask({ projectId: a.id, title: '丁', objective: '丁', ownerRoleId: 'hubu' }).task - service.bindDepartmentSession({ projectId: a.id, roleId: 'hubu', sessionId: 'sess-hubu-2', allowReplace: true }) - const staleGeneration = first.binding.bindingGeneration - expectCode(() => service.dispatchTask({ - projectId: a.id, - taskId: fresh.id, - idempotencyKey: 'k3', - bindingGeneration: staleGeneration, - }), 'SESSION_CONFLICT') -}) - -// ---------- 结果与完成判定 ---------- - -/** 建任务 → 派发 → 让任务进入 running,返回三件套。 */ -function runningTask(ctx, projectId = ctx.a.id) { - const task = ctx.service.createTask({ projectId, title: '任务', objective: '目标', ownerRoleId: 'libu' }).task - const dispatched = ctx.service.dispatchTask({ projectId, taskId: task.id, idempotencyKey: `key-${task.id}` }) - const started = ctx.service.startAttempt({ - projectId, - taskId: task.id, - attemptId: dispatched.attempt.id, - hostRunId: 'run-1', - }) - return { task: started.task, attempt: dispatched.attempt, dispatch: dispatched.dispatch } -} - -test('完成判定分支一:报告+终态成功+成果有效 → completed', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - const artifact = ctx.service.registerArtifact({ projectId: ctx.a.id, taskId: task.id, displayName: 'report.md' }).artifact - const out = ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '已完成分析', artifactRefs: [artifact.id], checks: [{ name: '自检', ok: true }] }, - runTerminal: 'succeeded', - sourceMessageRef: 'msg-1', - }) - assert.equal(out.duplicate, false) - assert.equal(out.decision.applied, true) - assert.equal(out.decision.status, 'completed') - assert.equal(out.task.status, 'completed') - assert.ok(out.task.reportReceivedAt !== null) - assert.ok(out.task.endedAt !== null) -}) - -test('完成判定分支二:终态成功但报告不可信 → needs_attention', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - const out = ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '看起来完成了', blockedReason: '缺少关键数据' }, - runTerminal: 'succeeded', - }) - assert.equal(out.decision.status, 'needs_attention') - assert.equal(out.task.status, 'needs_attention') - assert.match(out.task.needsAttentionReason, /有效/) - // needs_attention 不是完成:没有 completed 时间 - assert.equal(out.task.endedAt, null) -}) - -test('完成判定分支三:报告先到、宿主未结束 → 登记但不完成,终态后补齐', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - const first = ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '分析完成,等运行收尾' }, - runTerminal: 'running', - }) - // 报告本身写进了账(status 不是 completed 就是证据),但任务没被判完成 - assert.equal(first.decision.status, 'running', '运行未结束不判完成') - assert.equal(first.task.status, 'running') - assert.ok(first.task.reportReceivedAt !== null, '报告先到时先登记报告时间(候选)') - assert.ok(first.result.id.startsWith('res_'), '结果已登记为候选') - // 终态后到:reportRunTerminal 把它推进到 completed - const second = ctx.service.reportRunTerminal({ projectId: ctx.a.id, taskId: task.id, runTerminal: 'succeeded' }) - assert.equal(second.task.status, 'completed') - assert.equal(second.decision.applied, true) -}) - -test('结果去重:同 (attemptId, reportVersion) 与同 sourceMessageRef 只登记一次', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - const payload = { - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '第一次提交' }, - runTerminal: 'succeeded', - sourceMessageRef: 'msg-9', - } - const first = ctx.service.reportTaskResult(payload) - assert.equal(first.duplicate, false) - const revision = ctx.store.getTask(task.id).revision - const second = ctx.service.reportTaskResult(payload) - assert.equal(second.duplicate, true) - assert.equal(second.result.id, first.result.id) - assert.equal(second.decision.applied, false) - assert.equal(ctx.store.getTask(task.id).revision, revision, '重复事件不改任务 revision') - // 换 reportVersion 但同 sourceMessageRef:仍算重复 - const third = ctx.service.reportTaskResult({ ...payload, reportVersion: 2 }) - assert.equal(third.duplicate, true) - assert.equal(ctx.store.listResults(undefined).filter((row) => row.taskId === task.id).length, 1) -}) - -test('结果:伪造成果引用被拒,不留半条结果', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - expectCode(() => ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '带假附件', artifactRefs: ['art_fake123'] }, - runTerminal: 'succeeded', - }), 'NOT_FOUND') - assert.equal(ctx.store.listResults(undefined).length, 0) - expectCode(() => ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: ' ' }, - }), 'INVALID_INPUT') - expectCode(() => ctx.service.reportTaskResult({ - projectId: ctx.a.id, - taskId: task.id, - attemptId: attempt.id, - report: { summary: '好' }, - runTerminal: 'done', - }), 'INVALID_INPUT') -}) - -test('cancelTask:业务落 cancelled,运行中的尝试只到 cancel_requested', () => { - const ctx = seed() - const { task, attempt } = runningTask(ctx) - const out = ctx.service.cancelTask({ projectId: ctx.a.id, taskId: task.id, reason: '不再需要' }) - assert.equal(out.task.status, 'cancelled') - assert.equal(out.task.cancelReason, '不再需要') - assert.equal(out.attempt.state, 'cancel_requested') - assert.equal(out.cancelRequest.attemptId, attempt.id) - assert.equal(out.cancelRequest.hostRunId, 'run-1') - // 已终态再取消:applied=false,状态不变 - const again = ctx.service.cancelTask({ projectId: ctx.a.id, taskId: task.id }) - assert.equal(again.applied, false) - assert.equal(again.task.status, 'cancelled') -}) - -test('requestTaskInput 进入 waiting_input,supplyTaskInput 回到 running', () => { - const ctx = seed() - const { task } = runningTask(ctx) - const asked = ctx.service.requestTaskInput({ - projectId: ctx.a.id, - taskId: task.id, - reason: '缺少原始数据', - missingItems: ['数据文件'], - }) - assert.equal(asked.task.status, 'waiting_input') - assert.equal(asked.task.waitingReason, '缺少原始数据') - assert.deepEqual(asked.missingItems, ['数据文件']) - const supplied = ctx.service.supplyTaskInput({ projectId: ctx.a.id, taskId: task.id }) - assert.equal(supplied.task.status, 'running') -}) - -test('syncDecision 只登记带来源的决定事件,不广播', () => { - const ctx = seed() - const { task } = runningTask(ctx) - const out = ctx.service.syncDecision({ - projectId: ctx.a.id, - taskId: task.id, - content: '同意按方案 B 执行', - sourceSessionId: 'sess-lead', - roleId: 'lead', - }) - assert.equal(out.event.type, 'decision.synced') - assert.equal(out.event.payload.content, '同意按方案 B 执行') - assert.equal(out.event.payload.sourceSessionId, 'sess-lead') - assert.equal(out.task.id, task.id) - expectCode(() => ctx.service.syncDecision({ projectId: ctx.a.id, content: ' ' }), 'INVALID_INPUT') -}) - -// ---------- 投影与事件 ---------- - -test('bootstrap 一次拿全且只含选中项目的数据', () => { - const ctx = seed() - const taskA = ctx.service.createTask({ projectId: ctx.a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - const taskB = ctx.service.createTask({ projectId: ctx.b.id, title: '乙', objective: '乙', ownerRoleId: 'libu' }).task - const view = ctx.service.bootstrap(ctx.a.id) - assert.equal(view.projectId, ctx.a.id) - assert.equal(view.projects.length, 2) - assert.equal(view.seats.length, 10) - assert.deepEqual(view.tasks.map((row) => row.id), [taskA.id]) - assert.ok(!view.tasks.some((row) => row.id === taskB.id), '不串项目任务') - assert.equal(view.eventSeq, ctx.store.eventSeq) - // 不传 projectId 时取第一个项目 - const fallback = ctx.service.bootstrap() - assert.equal(fallback.projectId, view.projects[0].id) - expectCode(() => ctx.service.bootstrap('proj_ghost'), 'NOT_FOUND') -}) - -test('listEvents since 语义:只给新事件,越界给 reset', () => { - const ctx = seed() - const before = ctx.service.listEvents(ctx.a.id, 0) - assert.ok(before.events.length > 0) - assert.ok(before.events.every((row) => row.projectId === ctx.a.id), '只返回本项目事件') - const last = before.seq - const empty = ctx.service.listEvents(ctx.a.id, last) - assert.equal(empty.events.length, 0) - assert.equal(empty.seq, last) - // 产生一条新事件,且只属于项目 A(项目 B 的事件不该出现在 A 的游标里) - ctx.service.createTask({ projectId: ctx.a.id, title: '新', objective: '新', ownerRoleId: 'libu' }) - const mine = ctx.store.listEvents(ctx.a.id).filter((row) => row.seq > last) - const after = ctx.service.listEvents(ctx.a.id, last) - if (mine.length > 0) { - assert.equal(after.events.length, mine.length) - assert.deepEqual(after.events.map((row) => row.seq), mine.map((row) => row.seq)) - } else { - assert.equal(after.events.length, 0) - } - assert.ok(after.events.every((row) => row.projectId === ctx.a.id)) - // 用当前 seq 当游标再问一次必须为空(since 语义是“严格大于”) - assert.equal(ctx.service.listEvents(ctx.a.id, after.seq).events.length, 0) - // since 超过当前 seq:账本被替换/回滚,前端应全量重拉 - const reset = ctx.service.listEvents(ctx.a.id, last + 9999) - assert.equal(reset.reset, true) -}) - -test('成果登记与查询同样受项目隔离', () => { - const ctx = seed() - const task = ctx.service.createTask({ projectId: ctx.a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task - const art = ctx.service.registerArtifact({ - projectId: ctx.a.id, - taskId: task.id, - displayName: '交付物', - verification: { status: 'verified' }, - }).artifact - assert.equal(ctx.service.getArtifact(ctx.a.id, art.id).displayName, '交付物') - expectCode(() => ctx.service.getArtifact(ctx.b.id, art.id), 'CROSS_PROJECT') - assert.equal(ctx.service.listArtifacts(ctx.b.id).length, 0) -}) - -test('未知部门与缺参数走 INVALID_ROLE / INVALID_INPUT', () => { - const ctx = seed() - expectCode(() => ctx.service.listTasks(ctx.a.id, { ownerRoleId: 'unknown' }), 'INVALID_ROLE') - expectCode(() => ctx.service.createTask({ projectId: ctx.a.id, objective: 'x', ownerRoleId: 'libu' }), 'INVALID_INPUT') - expectCode(() => ctx.service.createTask({ projectId: ctx.a.id, title: 'x', objective: 'y', ownerRoleId: 'hufu' }), 'INVALID_ROLE') - expectCode(() => ctx.service.bindDepartmentSession({ projectId: ctx.a.id, roleId: 'libu', sessionId: '' }), 'INVALID_INPUT') -}) - -// ---------- A20:目录冲突 ---------- - -test('A20 同目录/父子目录登记成另一个项目时明确报冲突,不宣称隔离', () => { - const { service } = makeService(seedOfCurrent()) - service.registerProject({ hostWorkspaceId: 'ws-a', canonicalRoot: 'C:\\work\\alpha' }) - // 大小写、分隔符、末尾斜杠都算同一目录 - const same = expectCode( - () => service.registerProject({ hostWorkspaceId: 'ws-b', canonicalRoot: 'c:/work/alpha/' }), - 'DUPLICATE_PROJECT', - ) - assert.equal(same.details.relation, 'same') - assert.equal(same.details.otherHostWorkspaceId, 'ws-a') - assert.equal(same.details.hint, 'allowSharedRoot') - - const nested = expectCode( - () => service.registerProject({ hostWorkspaceId: 'ws-c', canonicalRoot: 'C:\\work\\alpha\\sub' }), - 'DUPLICATE_PROJECT', - ) - assert.equal(nested.details.relation, 'nested') - - // 显式放行:仍然登记,但把识别到的关系带回去,让 UI 有话说 - const shared = service.registerProject({ - hostWorkspaceId: 'ws-d', - canonicalRoot: 'C:\\work\\alpha', - allowSharedRoot: true, - }) - assert.equal(shared.duplicate, false) - assert.equal(shared.sharedRoot.relation, 'same') - - // 不同目录互不干扰 - const other = service.registerProject({ hostWorkspaceId: 'ws-e', canonicalRoot: 'D:\\other' }) - assert.equal(other.duplicate, false) - assert.equal(other.sharedRoot, null) - // 无关目录不该被误判为同一个:alpha 与 alphabeta 是不同目录 - const notPrefix = service.registerProject({ hostWorkspaceId: 'ws-f', canonicalRoot: 'C:\\work\\alphabeta' }) - assert.equal(notPrefix.duplicate, false) -}) - -// ---------- A22 / A23:成果修订与失效显示 ---------- - -test('A22 成果修订只开一条修订任务给原主责部门,派发自带原成果引用', () => { - const ctx = seed() - const task = ctx.service.createTask({ - projectId: ctx.a.id, ownerRoleId: 'libu', title: '写报告', objective: '产出报告', - }).task - const artifact = ctx.service.registerArtifact({ - projectId: ctx.a.id, taskId: task.id, fileRef: 'C:/work/a/report.md', displayName: '报告', - }).artifact - assert.equal(artifact.revision, 1) - - const revised = ctx.service.requestArtifactRevision({ - projectId: ctx.a.id, artifactId: artifact.id, instruction: '只改第三节的结论', - }) - assert.equal(revised.task.kind, 'revision') - assert.equal(revised.task.ownerRoleId, 'libu', '仍归原主责部门,不重跑整套三省') - assert.equal(revised.task.sourceRoleId, 'lead') - assert.equal(revised.task.reviseOfArtifactId, artifact.id) - assert.equal(revised.task.artifactRevision, 1) - assert.equal(revised.task.scope.kind, 'artifact-revision') - assert.equal(revised.task.objective, '只改第三节的结论') - assert.equal(revised.task.status, 'draft', '默认草稿:不替用户立刻派工') - - // 派发时若没显式给 materialRefs,自动带上「哪份成果的哪一版」 - const dispatched = ctx.service.dispatchTask({ - projectId: ctx.a.id, taskId: revised.task.id, targetRoleId: 'libu', idempotencyKey: 'rev-1', - }) - assert.deepEqual(dispatched.contextPacket.materialRefs, [{ artifactId: artifact.id, revision: 1, title: "报告" }]) - - // 新成果接到旧成果上:版本 +1,且跨项目修订被拒 - const next = ctx.service.registerArtifact({ - projectId: ctx.a.id, taskId: revised.task.id, fileRef: 'C:/work/a/report-v2.md', - displayName: '报告 v2', revisesArtifactId: artifact.id, - }).artifact - assert.equal(next.revision, 2) - assert.equal(next.revisesArtifactId, artifact.id) - - const bTask = ctx.service.createTask({ projectId: ctx.b.id, ownerRoleId: 'libu', title: 'b', objective: 'b' }).task - const foreign = ctx.service.registerArtifact({ projectId: ctx.b.id, taskId: bTask.id }).artifact - expectCode( - () => ctx.service.registerArtifact({ projectId: ctx.a.id, taskId: task.id, revisesArtifactId: foreign.id }), - 'CROSS_PROJECT', - ) -}) - -test('A23 成果文件不见了显示 missing,探不了就是 unknown,绝不猜成 ok', () => { - const { store } = makeService(seedOfCurrent()) - // 文件系统由宿主注入:这里只验投影怎么读结论 - const existing = new Set(['C:/work/keep.md']) - const service = createWorkbenchService({ - store, clock: () => FIXED_NOW, fileExists: (path) => existing.has(path), - }) - const project = service.registerProject({ hostWorkspaceId: 'ws-a' }).project - service.bindDepartmentSession({ projectId: project.id, roleId: 'libu', sessionId: 'sess-a-libu' }) - const task = service.createTask({ projectId: project.id, ownerRoleId: 'libu', title: 't', objective: 'o' }).task - const kept = service.registerArtifact({ projectId: project.id, taskId: task.id, fileRef: 'C:/work/keep.md' }).artifact - const gone = service.registerArtifact({ projectId: project.id, taskId: task.id, fileRef: 'C:/work/gone.md' }).artifact - const remote = service.registerArtifact({ projectId: project.id, taskId: task.id, fileRef: null }).artifact - - assert.equal(kept.existence, 'ok') - assert.equal(gone.existence, 'missing') - assert.equal(remote.existence, 'unknown', '没有本地路径就不下结论') - - const boot = service.bootstrap(project.id) - assert.deepEqual(boot.artifacts.map((row) => row.existence), ['ok', 'missing', 'unknown']) - // 账本不因“文件没了”被改写:历史仍留着 - assert.equal(store.listArtifacts(project.id).length, 3) - assert.equal(store.listArtifacts(project.id)[1].fileRef, 'C:/work/gone.md') -}) - -test('草稿直接派工会先入队,不会出现「消息已发、账上不前进」', () => { - const { store, service } = makeService(seedOfCurrent()) - const project = service.registerProject({ hostWorkspaceId: 'ws-draft', displayNameCache: '草稿项目' }).project - const binding = service.bindDepartmentSession({ projectId: project.id, roleId: 'gongbu', sessionId: 'ses_draft_gongbu' }) - - // 界面上的真实路径:先存草稿,再点派工。 - const draft = service.createTask({ - projectId: project.id, - ownerRoleId: 'gongbu', - sourceRoleId: 'lead', - title: '草稿直派', - objective: '确认草稿派工会先入队', - status: 'draft', - }).task - assert.equal(draft.status, 'draft') - - const result = service.dispatchTask({ - projectId: project.id, - taskId: draft.id, - idempotencyKey: 'ui:' + draft.id, - targetRoleId: 'gongbu', - targetSessionId: 'ses_draft_gongbu', - bindingGeneration: binding.binding.bindingGeneration, - }) - - // 派发记录落地,任务也从 draft 推进到 queued(否则 beginAttempt 会拒绝)。 - assert.ok(result.dispatch && result.dispatch.id) - const after = store.getTask(draft.id) - assert.equal(after.status, 'queued') - assert.ok(after.queuedAt) - // 同一个幂等键再派一次:返回既有记录,不新建第二条。 - const again = service.dispatchTask({ - projectId: project.id, - taskId: draft.id, - idempotencyKey: 'ui:' + draft.id, - targetRoleId: 'gongbu', - targetSessionId: 'ses_draft_gongbu', - bindingGeneration: binding.binding.bindingGeneration, - }) - assert.equal(again.duplicate, true) - assert.equal(again.dispatch.id, result.dispatch.id) -}) diff --git a/workbench/test/states.test.mjs b/workbench/test/states.test.mjs deleted file mode 100644 index a3f18fd..0000000 --- a/workbench/test/states.test.mjs +++ /dev/null @@ -1,127 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { - ATTEMPT_STATES, - DEPARTMENT_STATES, - DISPATCH_STATES, - STATE_MACHINES, - TASK_STATES, - TERMINAL_STATES, - allowedTransitions, - assertTransition, - canTransition, - isState, - isTerminal, - statesOf, -} from '../core/states.mjs' - -test('every machine lists the plan states verbatim', () => { - assert.deepEqual([...TASK_STATES], [ - 'draft', - 'queued', - 'running', - 'waiting_input', - 'needs_attention', - 'completed', - 'failed', - 'cancelled', - ]) - assert.deepEqual([...DISPATCH_STATES], ['prepared', 'sending', 'accepted', 'unknown', 'rejected']) - assert.deepEqual([...ATTEMPT_STATES], [ - 'queued', - 'running', - 'succeeded', - 'failed', - 'cancel_requested', - 'cancelled', - 'unknown', - ]) - assert.deepEqual([...DEPARTMENT_STATES], ['uninitialized', 'idle', 'queued', 'running', 'unavailable']) - assert.equal(Object.keys(STATE_MACHINES).length, 4) -}) - -test('state queries validate the machine name', () => { - assert.equal(isState('task', 'draft'), true) - assert.equal(isState('task', 'pending'), false, '旧 pending/in_progress 不属于新状态机') - assert.equal(isState('attempt', 'cancel_requested'), true) - assert.deepEqual(statesOf('department'), DEPARTMENT_STATES) - assert.throws(() => statesOf('nope'), /未知状态机/) - assert.throws(() => allowedTransitions('task', 'pending'), /未知状态/) -}) - -test('task happy path and legal detours', () => { - assert.deepEqual([...allowedTransitions('task', 'draft')], ['queued', 'cancelled']) - assert.equal(canTransition('task', 'draft', 'queued'), true) - assert.equal(canTransition('task', 'queued', 'running'), true) - assert.equal(canTransition('task', 'running', 'completed'), true) - assert.equal(canTransition('task', 'running', 'waiting_input'), true) - assert.equal(canTransition('task', 'waiting_input', 'queued'), true) - assert.equal(canTransition('task', 'needs_attention', 'completed'), true, '补报后可完成') - assert.equal(canTransition('task', 'running', 'draft'), false) - assert.equal(canTransition('task', 'completed', 'running'), false, '终态不回退') - assert.equal(canTransition('task', 'failed', 'running'), false) - assert.equal(canTransition('task', 'cancelled', 'queued'), false) - assert.equal(canTransition('task', 'running', 'running'), true, '同状态重复写入视为幂等') -}) - -test('dispatch states separate sending from accepted', () => { - assert.equal(canTransition('dispatch', 'prepared', 'sending'), true) - assert.equal(canTransition('dispatch', 'sending', 'accepted'), true) - assert.equal(canTransition('dispatch', 'sending', 'unknown'), true, '回执超时进入 unknown') - assert.equal(canTransition('dispatch', 'unknown', 'accepted'), true, '对账后可确认已接收') - assert.equal(canTransition('dispatch', 'unknown', 'rejected'), true) - assert.equal(canTransition('dispatch', 'accepted', 'unknown'), false) - assert.equal(canTransition('dispatch', 'rejected', 'sending'), false) - assert.equal(canTransition('dispatch', 'prepared', 'accepted'), false, '不能跳过发送直接接收') -}) - -test('attempt states keep cancel requests separate from cancellation', () => { - assert.equal(canTransition('attempt', 'queued', 'running'), true) - assert.equal(canTransition('attempt', 'running', 'cancel_requested'), true) - assert.equal(canTransition('attempt', 'cancel_requested', 'cancelled'), true) - assert.equal(canTransition('attempt', 'cancel_requested', 'succeeded'), true, '取消与成功竞争照常落终态') - assert.equal(canTransition('attempt', 'cancelled', 'running'), false) - assert.equal(canTransition('attempt', 'unknown', 'running'), true, '对账发现仍在跑') - assert.equal(canTransition('attempt', 'succeeded', 'failed'), false) -}) - -test('department states describe the session, not the task', () => { - assert.equal(canTransition('department', 'uninitialized', 'queued'), true) - assert.equal(canTransition('department', 'running', 'unavailable'), true) - assert.equal(canTransition('department', 'unavailable', 'idle'), true) - assert.equal(canTransition('department', 'idle', 'completed'), false, '部门没有完成态') -}) - -test('assertTransition throws readable errors and returns the target', () => { - assert.equal(assertTransition('task', 'draft', 'queued'), 'queued') - assert.equal(assertTransition('task', 'queued', 'queued'), 'queued') - assert.throws(() => assertTransition('task', 'completed', 'running'), /Task 不允许从 completed 迁移到 running/) - assert.throws(() => assertTransition('task', 'bogus', 'running'), /当前状态非法/) - assert.throws(() => assertTransition('task', 'draft', 'bogus'), /目标状态非法/) - assert.throws(() => assertTransition('nope', 'draft', 'queued'), /未知状态机/) -}) - -test('terminal states are explicit per machine', () => { - assert.equal(isTerminal('task', 'completed'), true) - assert.equal(isTerminal('task', 'needs_attention'), false, '待核不算完成') - assert.equal(isTerminal('dispatch', 'accepted'), true) - assert.equal(isTerminal('dispatch', 'unknown'), false, 'unknown 必须对账') - assert.equal(isTerminal('attempt', 'cancel_requested'), false) - assert.equal(isTerminal('attempt', 'cancelled'), true) - assert.equal(isTerminal('department', 'unavailable'), false) - assert.throws(() => isTerminal('nope', 'x'), /未知状态机/) -}) - -test('terminal state sets match the machines', () => { - assert.deepEqual([...TERMINAL_STATES.task], ['completed', 'failed', 'cancelled']) - assert.deepEqual([...TERMINAL_STATES.dispatch], ['accepted', 'rejected']) - assert.deepEqual([...TERMINAL_STATES.attempt], ['succeeded', 'failed', 'cancelled']) - // 部门不是业务流程,没有“完成”概念 - assert.deepEqual([...TERMINAL_STATES.department], []) - for (const key of Object.keys(TERMINAL_STATES)) { - for (const state of TERMINAL_STATES[key]) { - assert.equal(isTerminal(key, state), true, ) - assert.deepEqual(allowedTransitions(key, state), [], ) - } - } -}) diff --git a/workbench/test/store.test.mjs b/workbench/test/store.test.mjs deleted file mode 100644 index b97eb07..0000000 --- a/workbench/test/store.test.mjs +++ /dev/null @@ -1,368 +0,0 @@ -import test from 'node:test' -import assert from 'node:assert/strict' -import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs' -import { tmpdir } from 'node:os' -import { dirname, join } from 'node:path' -import { SCHEMA_VERSION, StoreError, WorkbenchStore, defaultStorePath, entityOf } from '../core/store.mjs' -import { createIdFactory } from '../core/ids.mjs' - -/** 固定随机源和时钟:随机源按调用递增,保证 ID 可复现且互不相同。 */ -function makeStore(file = null) { - let cursor = 0 - return new WorkbenchStore({ - file, - clock: () => Date.parse('2026-11-09T12:00:00.000Z'), - random: () => cursor++, - }) -} - -function mkStore() { - const store = makeStore() - const a = store.createProject({ hostWorkspaceId: 'ws-a', displayNameCache: '项目A' }) - const b = store.createProject({ hostWorkspaceId: 'ws-b', displayNameCache: '项目B' }) - return { store, a, b } -} - -test('createProject seeds ten empty seats without sessions', () => { - const { store, a } = mkStore() - assert.match(a, /^proj_/) - assert.equal(store.listProjects().length, 2) - const bindings = store.listBindings(a) - assert.equal(bindings.length, 10) - assert.ok(bindings.every((row) => row.currentSessionId === null && row.status === 'uninitialized')) - assert.ok(store.listConfigs(a).every((row) => row.providerId === null && row.configRevision === 0)) - assert.equal(store.revision, 2, '每次提交递增 revision') - assert.equal(store.eventSeq, 2, '事件日志追加 seq') - assert.deepEqual(store.listEvents(a).map((row) => row.type), ['project.created']) - assert.throws(() => store.createProject({ hostWorkspaceId: 'ws-a' }), /已登记/) - assert.throws(() => store.createProject({ hostWorkspaceId: ' ' }), /非空字符串/) - assert.throws(() => store.bindSession(a, 'hufu', 's1'), /未知角色/) -}) - -test('one active binding per (projectId, roleId)', () => { - const { store, a } = mkStore() - const bound = store.bindSession(a, 'gongbu', 'sess-1') - assert.equal(bound.bindingGeneration, 1) - assert.equal(bound.currentSessionId, 'sess-1') - assert.equal(store.getBinding(a, 'gongbu').currentSessionId, 'sess-1') - // 同一 (project, role) 的两个绑定行不可能同时存在:键就是 (projectId, roleId)。 - const rows = store.listBindings(a).filter((row) => row.roleId === 'gongbu') - assert.equal(rows.length, 1) - // 同一部门换绑走 releaseBinding,旧会话进历史而不是悄悄被覆盖。 - const rebound = store.bindSession(a, 'gongbu', 'sess-2', { allowReplace: true }) - assert.equal(rebound.currentSessionId, 'sess-2') - assert.equal(rebound.bindingGeneration, 2) - assert.deepEqual(rebound.historySessionRefs.map((row) => row.sessionId), ['sess-1']) -}) - -test('binding requires the old session to be released before it is reused', () => { - const { store, a } = mkStore() - store.bindSession(a, 'gongbu', 'sess-1') - assert.throws(() => store.bindSession(a, 'gongbu', 'sess-1'), /无需重复绑定/) - assert.equal(store.getBinding(a, 'gongbu').bindingGeneration, 1) -}) - -test('a session id cannot be bound to two different (projectId, roleId)', () => { - const { store, a, b } = mkStore() - store.bindSession(a, 'gongbu', 'sess-1') - assert.throws(() => store.bindSession(a, 'libu', 'sess-1'), /SESSION_CONFLICT|已绑定/) - assert.throws(() => store.bindSession(b, 'gongbu', 'sess-1'), /已绑定/) - // 释放后旧会话进入 historySessionRefs,不删除历史,且可绑定到别处。 - const released = store.releaseBinding(a, 'gongbu') - assert.equal(released.currentSessionId, null) - assert.equal(released.historySessionRefs.length, 1) - assert.equal(released.historySessionRefs[0].sessionId, 'sess-1') - const moved = store.bindSession(b, 'gongbu', 'sess-1') - assert.equal(moved.currentSessionId, 'sess-1') - assert.equal(moved.bindingGeneration, 1) -}) - -test('rebinding bumps bindingGeneration so old dispatches stay pinned', () => { - const { store, a } = mkStore() - store.bindSession(a, 'gongbu', 'sess-1') - store.releaseBinding(a, 'gongbu') - const next = store.bindSession(a, 'gongbu', 'sess-2') - assert.equal(next.bindingGeneration, 2) - assert.deepEqual(store.getBinding(a, 'gongbu').historySessionRefs.map((row) => row.sessionId), ['sess-1']) - assert.throws(() => store.setBindingStatus(a, 'gongbu', 'completed'), /目标状态非法/) - assert.equal(store.setBindingStatus(a, 'gongbu', 'unavailable').status, 'unavailable') -}) - -test('configuration CAS rejects stale writers and returns the current value', () => { - const { store, a, b } = mkStore() - const first = store.saveConfig(a, 'gongbu', { provider: 'deepseek', model: 'chat', reasoningEffort: 'high' }, 0) - assert.equal(first.configRevision, 1) - assert.equal(first.providerId, 'deepseek') - assert.throws( - () => store.saveConfig(a, 'gongbu', { provider: 'openai', model: 'gpt', reasoningEffort: null }, 0), - (error) => { - assert.equal(error.code, 'CAS_CONFLICT') - assert.equal(error.details.currentRevision, 1) - assert.deepEqual(error.details.current, { provider: 'deepseek', model: 'chat', reasoningEffort: 'high' }) - return true - }, - ) - // 冲突不写账:revision 与配置保持原样 - assert.equal(store.getConfig(a, 'gongbu').providerId, 'deepseek') - // 另一项目另一部门互不影响 - assert.equal(store.getConfig(b, 'gongbu').configRevision, 0) - const second = store.saveConfig(a, 'gongbu', { provider: 'openai', model: 'gpt' }, 1) - assert.equal(second.configRevision, 2) - assert.equal(second.reasoningEffort, null, '缺省 effort 落 null,不透传 undefined') - assert.throws(() => store.saveConfig(a, 'gongbu', { provider: 'x', model: 'y' }, '1'), /expectedRevision/) - assert.throws(() => store.saveConfig(a, 'gongbu', { provider: 'x' }, 2), /model/) -}) - -test('dispatch idempotency key returns the existing record', () => { - const { store, a } = mkStore() - const first = store.recordDispatch({ projectId: a, idempotencyKey: 'k-1', taskId: null }) - assert.equal(first.duplicate, false) - assert.match(first.dispatch.id, /^dsp_/) - const again = store.recordDispatch({ projectId: a, idempotencyKey: 'k-1' }) - assert.equal(again.duplicate, true) - assert.equal(again.dispatch.id, first.dispatch.id) - assert.equal([...store.state.dispatches.values()].length, 1, '重复点击只留一条派发') - // 幂等键按项目隔离:另一项目同键是另一件事。 - const { b } = { b: store.listProjects()[1].id } - assert.equal(store.recordDispatch({ projectId: b, idempotencyKey: 'k-1' }).duplicate, false) - // 状态推进走状态机 - const accepted = store.updateDispatch(first.dispatch.id, { status: 'sending' }) - assert.equal(accepted.status, 'sending') - assert.throws(() => store.updateDispatch(first.dispatch.id, { status: 'proposed' }), /目标状态非法/) - assert.throws(() => store.updateDispatch(first.dispatch.id, { status: 'prepared' }), /不允许/) -}) - -test('recordResult deduplicates duplicate completion events', () => { - const { store, a } = mkStore() - const task = store.insertTask({ projectId: a, ownerRoleId: 'gongbu', sourceRoleId: 'lead', status: 'draft' }) - const attempt = store.insertAttempt({ projectId: a, taskId: task.id, state: 'running' }) - const base = { projectId: a, taskId: task.id, attemptId: attempt.id, summary: '完成', reportVersion: 1 } - const first = store.recordResult(base) - assert.equal(first.duplicate, false) - assert.match(first.result.id, /^res_/) - const dupVersion = store.recordResult(base) - assert.equal(dupVersion.duplicate, true) - assert.equal(dupVersion.result.id, first.result.id) - // 同一源消息的重复事件同样只登记一次 - const dupMessage = store.recordResult({ ...base, reportVersion: 2, sourceMessageRef: 'msg-1' }) - assert.equal(dupMessage.duplicate, false) - const dupMessageAgain = store.recordResult({ ...base, reportVersion: 3, sourceMessageRef: 'msg-1' }) - assert.equal(dupMessageAgain.duplicate, true) - assert.equal(store.listResults(task.id).length, 2) -}) - -test('cross-project references are rejected on write', () => { - const { store, a, b } = mkStore() - const taskA = store.insertTask({ projectId: a, ownerRoleId: 'gongbu', sourceRoleId: 'lead', status: 'draft' }) - assert.throws( - () => store.insertAttempt({ projectId: b, taskId: taskA.id, state: 'queued' }), - (error) => error.code === 'CROSS_PROJECT', - ) - const attemptA = store.insertAttempt({ projectId: a, taskId: taskA.id, state: 'running' }) - assert.throws( - () => store.recordResult({ projectId: b, taskId: null, attemptId: attemptA.id, summary: 'x' }), - (error) => error.code === 'CROSS_PROJECT', - ) - assert.equal(store.listResults().length, 0, '被拒绝的写入不落账') -}) - -test('cross-project recordResult and artifacts are refused', () => { - const { store, a, b } = mkStore() - const taskA = store.insertTask({ projectId: a, ownerRoleId: 'gongbu', sourceRoleId: 'lead', status: 'draft' }) - const attemptA = store.insertAttempt({ projectId: a, taskId: taskA.id, state: 'running' }) - assert.throws( - () => store.recordResult({ projectId: b, attemptId: attemptA.id, summary: 'x' }), - (error) => error.code === 'CROSS_PROJECT', - ) - const resultA = store.recordResult({ projectId: a, taskId: taskA.id, attemptId: attemptA.id, summary: 'ok' }) - assert.throws( - () => store.recordArtifact({ projectId: b, taskId: taskA.id, ownerRoleId: 'gongbu', sourceResultId: resultA.result.id }), - (error) => error.code === 'CROSS_PROJECT', - ) - const artifact = store.recordArtifact({ projectId: a, taskId: taskA.id, ownerRoleId: 'gongbu', sourceResultId: resultA.result.id }) - assert.match(artifact.id, /^art_/) - assert.throws(() => store.insertContextPacket({ projectId: b, taskId: taskA.id }), /CROSS_PROJECT|跨项目/) - assert.throws(() => store.assertProjectOwns(b, 'tasks', taskA.id), /不属于项目/) - assert.throws(() => store.assertProjectOwns(a, 'tasks', 'task_missing'), /不存在/) - assert.equal(store.assertProjectOwns(a, 'tasks', taskA.id).id, taskA.id) - assert.throws(() => store.insertTask({ projectId: 'proj_nope', ownerRoleId: 'gongbu', sourceRoleId: 'lead', status: 'draft' }), /项目不存在/) - // 先校验角色,未知部门在建立任务时就拒绝 - const fresh = new WorkbenchStore({ file: null, clock: () => 1700000000000, random: () => 7 }) - const fa = fresh.createProject({ hostWorkspaceId: 'ws-a' }) - assert.throws(() => fresh.insertTask({ projectId: fa, ownerRoleId: 'hufu', sourceRoleId: 'lead', status: 'draft' }), /未知主责部门/) - assert.throws(() => store.recordArtifact({ projectId: a, taskId: taskA.id, ownerRoleId: 'hufu' }), /未知主责部门/) -}) - -test('task writes cannot skip the state machine or rewrite project', () => { - const { store, a, b } = mkStore() - const task = store.insertTask({ projectId: a, ownerRoleId: 'gongbu', sourceRoleId: 'lead', status: 'draft' }) - assert.equal(task.revision, 1) - const queued = store.updateTask({ ...task, status: 'queued' }) - assert.equal(queued.revision, 2) - assert.throws(() => store.updateTask({ ...task, status: 'completed' }), /不允许/) - assert.throws(() => store.updateTask({ ...task, projectId: b, status: 'queued' }), /不能被改写/) - assert.throws(() => store.insertTask({ ...task }), /任务已存在/) -}) - -test('markEventDelivered acks the outbox without deleting events', () => { - const { store, a, b } = mkStore() - const first = store.appendEvent({ type: 'ping', projectId: a }) - const second = store.appendEvent({ type: 'ping', projectId: a }) - const other = store.appendEvent({ type: 'ping', projectId: b }) - assert.equal(store.listPendingEvents(a).length, 3, '项目 a:建项目 1 条 + 两条 ping') - - const revision = store.revision - assert.deepEqual(store.markEventDelivered(a, [first.eventId]), { delivered: 1 }) - assert.equal(store.revision, revision + 1, '标记走同一条提交路径,递增 revision') - // 幂等:重复 ack 不报错、不重复计数,也不白增 revision - const revision2 = store.revision - assert.deepEqual(store.markEventDelivered(a, [first.eventId]), { delivered: 0 }) - assert.equal(store.revision, revision2, '空操作不递增 revision') - // 未知 id 静默忽略 - assert.deepEqual(store.markEventDelivered(a, ['evt_missing', 'not-an-id']), { delivered: 0 }) - // 跨项目 id 忽略:既不是错误,也不会写到别的项目 - assert.deepEqual(store.markEventDelivered(a, [other.eventId]), { delivered: 0 }) - assert.equal(store.listPendingEvents(b).length, 2, '项目 b 的事件不受影响') - // 标记后不再出现在 pending,但事件仍可通过 listEvents 审计看到 - assert.deepEqual( - store.listPendingEvents(a).map((row) => row.eventId), - [store.listEvents(a)[0].eventId, second.eventId], - '只剩项目创建事件与第二条 ping', - ) - const acks = store.listEvents(a).find((row) => row.eventId === first.eventId) - assert.ok(acks.deliveredAt !== null, '已投递事件保留记录并写时间戳') - assert.equal(store.listEvents(a).length, 3) - // 项目不存在与其它方法一致抛 StoreError - assert.throws( - () => store.markEventDelivered('proj_nope', [first.eventId]), - (error) => error instanceof StoreError && error.code === 'NOT_FOUND', - ) -}) - -test('listPendingEvents honours limit and keeps seq order', () => { - const { store, a } = mkStore() - // mkStore 先建了两个项目,项目 a 的 project.created 是第 1 条事件 - const created = store.listEvents(a)[0] - const first = store.appendEvent({ type: 'ping', projectId: a }) - const second = store.appendEvent({ type: 'ping', projectId: a }) - const third = store.appendEvent({ type: 'ping', projectId: a }) - assert.deepEqual(store.listPendingEvents(a).map((row) => row.seq), [created.seq, first.seq, second.seq, third.seq]) - assert.deepEqual(store.listPendingEvents(a, { limit: 2 }).map((row) => row.seq), [created.seq, first.seq]) - // 非正整数 limit 视为不传,行为与旧接口一致 - assert.equal(store.listPendingEvents(a, { limit: 0 }).length, 4) - assert.equal(store.listPendingEvents(a, { limit: -1 }).length, 4) - assert.equal(store.listPendingEvents(a, {}).length, 4) - // limit 与 ack 组合:已投递的不占额度 - assert.deepEqual(store.markEventDelivered(a, [created.eventId, first.eventId]), { delivered: 2 }) - assert.equal(store.listPendingEvents(a).length, 2) - assert.deepEqual(store.listPendingEvents(a, { limit: 1 }).map((row) => row.seq), [second.seq]) - assert.deepEqual(store.listPendingEvents(a, { limit: 2 }).map((row) => row.seq), [second.seq, third.seq]) -}) - -test('event log keeps monotonic seq and rejects duplicate eventId', () => { - const { store, a } = mkStore() - const first = store.appendEvent({ type: 'ping', projectId: a }) - const second = store.appendEvent({ type: 'ping', projectId: a }) - assert.ok(second.seq > first.seq) - assert.equal(store.listPendingEvents().length, 4, '两个项目创建 + 两条 ping 都待处理') - assert.deepEqual(store.listPendingEvents().slice(-2).map((row) => row.type), ['ping', 'ping']) - assert.equal(store.listEvents(a).length, 3) - assert.throws(() => store.appendEvent({ type: 'ping', projectId: a, eventId: first.eventId }), /事件已登记/) - assert.throws(() => store.appendEvent({ projectId: a }), /event.type/) -}) - -test('failed writes roll back memory and leave no ghost rows', () => { - const { store, a } = mkStore() - const revision = store.revision - const events = store.eventSeq - assert.throws(() => store.recordDispatch({ projectId: a, idempotencyKey: 'k', status: 'proposed' }), /未知派发状态/) - assert.equal([...store.state.dispatches.values()].length, 0) - assert.equal(store.revision, revision, '失败不递增 revision') - assert.equal(store.eventSeq, events, '失败不留下半截事件') -}) - -test('file persistence round-trips and writes atomically', () => { - const dir = mkdtempSync(join(tmpdir(), 'sansheng-store-')) - try { - const file = join(dir, 'nested', 'workbench.json') - const store = makeStore(file) - const a = store.createProject({ hostWorkspaceId: 'ws-a', displayNameCache: '项目A' }) - store.bindSession(a, 'gongbu', 'sess-1') - store.saveConfig(a, 'gongbu', { provider: 'p', model: 'm', reasoningEffort: 'low' }, 0) - store.recordDispatch({ projectId: a, idempotencyKey: 'k-1' }) - store.appendEvent({ type: 'test.event', projectId: a }) - assert.equal(existsSync(file), true) - // 原子写:目录里只剩目标文件,没有残留 .tmp - assert.deepEqual(readdirSync(dirname(file)), ['workbench.json']) - const raw = JSON.parse(readFileSync(file, 'utf8')) - assert.equal(raw.schemaVersion, 1) - assert.equal(raw.revision, store.revision) - - const reloaded = makeStore(file) - assert.equal(reloaded.load(), true) - assert.equal(reloaded.revision, store.revision) - assert.equal(reloaded.getBinding(a, 'gongbu').currentSessionId, 'sess-1') - assert.equal(reloaded.getConfig(a, 'gongbu').configRevision, 1) - assert.equal(reloaded.listEvents(a).length, store.listEvents(a).length) - assert.deepEqual(reloaded.snapshot().projects, store.snapshot().projects) - // 重新载入后仍能继续写,且唯一性约束照样生效 - assert.throws(() => reloaded.bindSession(a, 'libu', 'sess-1'), /已绑定/) - assert.equal(reloaded.recordDispatch({ projectId: a, idempotencyKey: 'k-1' }).duplicate, true) - - // 缺省路径:%DSH_HOME%\sansheng-liubu\workbench.json,未设置时落 ~/.dsh - const sep = String.fromCharCode(92) - const winPath = defaultStorePath({ DSH_HOME: 'C:' + sep + 'dsh-home' }).split(sep).join('/') - assert.equal(winPath, 'C:/dsh-home/sansheng-liubu/workbench.json') - assert.equal(makeStore(null).save(), false, '纯内存模式不落盘') - } finally { - rmSync(dir, { recursive: true, force: true }) - } -}) - -test('load rejects unknown schema versions instead of guessing', () => { - const dir = mkdtempSync(join(tmpdir(), 'sansheng-schema-')) - try { - const file = join(dir, 'workbench.json') - const store = makeStore(file) - store.createProject({ hostWorkspaceId: 'ws-a' }) - const raw = JSON.parse(readFileSync(file, 'utf8')) - raw.schemaVersion = 99 - writeFileSync(file, JSON.stringify(raw)) - const other = makeStore(file) - assert.throws(() => other.load(), /schemaVersion=99/) - } finally { - rmSync(dir, { recursive: true, force: true }) - } -}) - -test('ids factory is shared with event ids for deterministic tests', () => { - const ids = createIdFactory({ random: () => 2, length: 6 }) - assert.match(ids.task(), /^task_2{6}$/) - // 常量随机源会让 ID 冲突,因此 store 自带事件去重后缀 - const constant = new WorkbenchStore({ file: null, clock: () => 0, random: () => 7 }) - const projectId = constant.createProject({ hostWorkspaceId: 'ws-a' }) - const first = constant.appendEvent({ type: 'x', projectId }) - const second = constant.appendEvent({ type: 'x', projectId }) - assert.match(first.eventId, /^evt_7{12}/) - assert.notEqual(first.eventId, second.eventId) - assert.deepEqual(constant.listEvents(projectId).map((row) => row.seq), [1, 2, 3]) -}) - -test('schema version and entity mapping are exported constants', () => { - assert.equal(SCHEMA_VERSION, 1) - assert.equal(entityOf('tasks'), 'task') - assert.equal(entityOf('contextPackets'), 'contextPacket') - assert.equal(entityOf('nope'), null) - const error = new StoreError('BOOM', '炸了') - assert.ok(error instanceof Error) - assert.equal(error.name, 'StoreError') - assert.equal(error.code, 'BOOM') - assert.equal(error.details, undefined) - assert.deepEqual(new StoreError('X', 'y', { a: 1 }).details, { a: 1 }) - // 缺省路径:%DSH_HOME%\sansheng-liubu\workbench.json,未设置时落 ~/.dsh - const sep = String.fromCharCode(92) - const winPath = defaultStorePath({ DSH_HOME: 'C:' + sep + 'dsh-home' }).split(sep).join('/') - assert.equal(winPath, 'C:/dsh-home/sansheng-liubu/workbench.json') - const homePath = defaultStorePath({}).split(sep).join('/') - assert.match(homePath, /\.dsh\/sansheng-liubu\/workbench\.json$/) -}) diff --git a/workbench/test/tasks.test.mjs b/workbench/test/tasks.test.mjs deleted file mode 100644 index 46bd4c7..0000000 --- a/workbench/test/tasks.test.mjs +++ /dev/null @@ -1,368 +0,0 @@ -// 任务生命周期测试:重点验证「完成判定三分支」与乱序/重复事件不回退状态。 -// 这些是 v0.1 最容易出错的地方,全部用纯函数直接断言,不依赖 store 或宿主。 - -import test from 'node:test' -import assert from 'node:assert/strict' - -import { - TaskError, - TASK_TRANSITIONS, - isStaleSeq, - isRegressingEvent, - createTask, - startTask, - beginAttempt, - validateReport, - checkCompletion, - evaluateCompletion, - decide, - requestInput, - supplyInput, - completeTask, - failTask, - cancelTask, - applyDecision, - isOpenTask, -} from '../core/tasks.mjs' -import { WorkbenchStore } from '../core/store.mjs' - -const clock = () => 1700000000000 - -function draftTask(overrides = {}) { - return createTask( - { - projectId: 'proj_a', - title: '整理季度报表', - objective: '把三份表合并成一份差异表', - ownerRoleId: 'hubu', - sourceRoleId: 'zhongshu', - ...overrides, - }, - { newTaskId: () => 'task_1', now: clock }, - ) -} - -function runningTask() { - const task = startTask(draftTask(), { now: clock }) - return beginAttempt(task, { id: 'att_1', projectId: 'proj_a', taskId: 'task_1' }, { now: clock }) -} - -const goodReport = { - attemptId: 'att_1', - taskId: 'task_1', - summary: '差异 12 处,已附差异表', - checks: [{ name: '数量核对', ok: true }], - artifactRefs: ['art_1'], -} - -test('createTask 只建草稿,缺字段或未知席直接拒绝', () => { - const task = draftTask() - assert.equal(task.status, 'draft') - assert.equal(task.ownerRoleId, 'hubu') - assert.equal(task.sourceRoleId, 'zhongshu') - assert.equal(task.activeAttemptId, null) - assert.equal(task.revision, 1) - assert.deepEqual(task.attempts, []) - assert.throws(() => createTask({ title: 'x', objective: 'y', ownerRoleId: 'hubu' }), TaskError) - assert.throws(() => draftTask({ ownerRoleId: 'hufu' }), /未知主责部门/) - assert.throws(() => draftTask({ sourceRoleId: 'nobody' }), /未知来源部门/) - assert.throws(() => draftTask({ objective: ' ' }), /objective/) -}) - -test('TASK_TRANSITIONS 与方案一致且不可变', () => { - assert.ok(Object.isFrozen(TASK_TRANSITIONS)) - const pairs = TASK_TRANSITIONS.map(([from, to]) => `${from}->${to}`) - for (const expected of ['draft->queued', 'running->completed', 'running->needs_attention', 'needs_attention->completed', 'waiting_input->running']) { - assert.ok(pairs.includes(expected), `缺少迁移 ${expected}`) - } - assert.ok(!pairs.includes('completed->running'), '终态不能被复活') - assert.ok(Object.isFrozen(TASK_TRANSITIONS[0])) -}) - -test('startTask 只从草稿或待补充入队', () => { - const queued = startTask(draftTask(), { now: clock }) - assert.equal(queued.status, 'queued') - assert.equal(queued.revision, 2) - assert.throws(() => startTask(queued), /只有草稿或待补充/) - const waiting = requestInput(runningTask(), '缺少上月口径', { now: clock }).task - assert.equal(waiting.status, 'waiting_input') - assert.equal(startTask(waiting, { now: clock }).status, 'queued') -}) - -test('beginAttempt 绑定新尝试并保留历史', () => { - const task = runningTask() - assert.equal(task.status, 'running') - assert.equal(task.activeAttemptId, 'att_1') - assert.deepEqual(task.attempts, ['att_1']) - // 旧尝试仍活跃时不允许并发换绑:先对账再重试 - assert.throws( - () => beginAttempt(task, { id: 'att_2', projectId: 'proj_a', taskId: 'task_1' }), - (error) => error.code === 'ACTIVE_ATTEMPT', - ) - const settled = { ...task, activeAttemptId: null, status: 'needs_attention' } - const retried = beginAttempt(settled, { id: 'att_2', projectId: 'proj_a', taskId: 'task_1' }, { now: clock }) - assert.equal(retried.activeAttemptId, 'att_2') - assert.deepEqual(retried.attempts, ['att_1', 'att_2'], '旧尝试不能被覆盖') - assert.throws(() => beginAttempt({ ...task, status: 'completed' }, { id: 'att_3', projectId: 'proj_a', taskId: 'task_1' }), /不能开始新的尝试/) - assert.throws( - () => beginAttempt({ ...task, status: 'queued' }, { id: 'att_2', projectId: 'proj_b', taskId: 'task_1' }), - /不属于同一项目/, - ) - assert.throws( - () => beginAttempt({ ...task, status: 'queued' }, { id: 'att_2', projectId: 'proj_a', taskId: 'task_9' }), - /别的任务/, - ) - assert.throws(() => beginAttempt({ ...task, status: 'queued' }, null), /尝试记录不合法/) -}) - -test('beginAttempt 不再被已取消的旧尝试挡住重试', () => { - const running = runningTask() - // 取消后 activeAttemptId 仍指向旧尝试(保留审计),旧 Attempt 已转 cancelled 终态 → 允许重试 - const cancelledLookup = (id) => ({ id, state: 'cancelled' }) - const next = { id: 'att_2', projectId: 'proj_a', taskId: 'task_1' } - const retried = beginAttempt(running, next, { now: clock, attemptLookup: cancelledLookup }) - assert.equal(retried.status, 'running') - assert.equal(retried.activeAttemptId, 'att_2') - assert.deepEqual(retried.attempts, ['att_1', 'att_2'], '旧尝试保留在历史里') - // running 但当前尝试已 unknown/failed/succeeded 终态时同样放行 - for (const state of ['failed', 'succeeded']) { - assert.equal(beginAttempt(running, next, { now: clock, attemptLookup: (id) => ({ id, state }) }).activeAttemptId, 'att_2') - } - // needs_attention 下旧尝试已取消:不被 ACTIVE_ATTEMPT 挡住 - const needsAttention = { ...running, status: 'needs_attention' } - const retriedAfterCancel = beginAttempt(needsAttention, next, { now: clock, attemptLookup: cancelledLookup }) - assert.equal(retriedAfterCancel.status, 'running') - assert.equal(retriedAfterCancel.needsAttentionReason, null) - // 旧尝试 still running / unknown / cancel_requested:仍在活动,必须挡住 - const queuedAttempt = (id) => ({ id, state: 'queued' }) - const unknownAttempt = (id) => ({ id, state: 'unknown' }) - for (const lookup of [queuedAttempt, unknownAttempt]) { - assert.throws( - () => beginAttempt(running, next, { now: clock, attemptLookup: lookup }), - (error) => error.code === 'ACTIVE_ATTEMPT', - ) - assert.throws( - () => beginAttempt(needsAttention, next, { now: clock, attemptLookup: lookup }), - (error) => error.code === 'ACTIVE_ATTEMPT', - ) - } - // 不注入 attemptLookup 时无法证明旧尝试已对账 → 保持旧行为(非空即挡) - assert.throws( - () => beginAttempt(running, next, { now: clock }), - (error) => error.code === 'ACTIVE_ATTEMPT', - ) - // needs_attention 且 activeAttemptId 为空 → 本来就不受影响 - assert.equal(beginAttempt({ ...running, activeAttemptId: null, status: 'needs_attention' }, next, { now: clock }).activeAttemptId, 'att_2') -}) - -test('validateReport 只认结构化字段', () => { - assert.deepEqual(validateReport(goodReport), []) - assert.deepEqual(validateReport({ attemptId: 'a', taskId: 't', summary: 's' }), []) - assert.deepEqual(validateReport(null), ['报告必须是对象']) - const errors = validateReport({ summary: ' ', artifactRefs: ['res_1'], checks: 'ok' }) - assert.ok(errors.some((row) => row.includes('attemptId'))) - assert.ok(errors.some((row) => row.includes('taskId'))) - assert.ok(errors.some((row) => row.includes('摘要为空'))) - assert.ok(errors.some((row) => row.includes('成果引用形状非法'))) - assert.ok(errors.some((row) => row.includes('checks 必须是数组'))) - assert.ok(validateReport({ attemptId: 'a', taskId: 't', summary: 's', artifactRefs: 'art_1' }).some((row) => row.includes('artifactRefs'))) -}) - -test('checkCompletion 三条条件各占一票', () => { - const all = checkCompletion({ report: goodReport, runTerminal: 'succeeded', artifactRefs: ['art_1'], artifactLookup: () => ({ id: 'art_1' }) }) - assert.deepEqual(all, { reportOk: true, runOk: true, refsValid: true, blockers: [], ok: true }) - - const noReport = checkCompletion({ report: null, runTerminal: 'succeeded' }) - assert.equal(noReport.reportOk, false) - assert.equal(noReport.ok, false) - assert.ok(noReport.blockers.includes('未收到结构化报告')) - - const noTerminal = checkCompletion({ report: goodReport, runTerminal: null }) - assert.equal(noTerminal.runOk, false) - assert.ok(noTerminal.blockers.includes('宿主运行尚未结束')) - - const failedRun = checkCompletion({ report: goodReport, runTerminal: 'failed' }) - assert.equal(failedRun.runOk, false) - assert.ok(failedRun.blockers.some((row) => row.includes('failed'))) - - const blocked = checkCompletion({ report: { ...goodReport, blockedReason: '缺权限' }, runTerminal: 'succeeded' }) - assert.equal(blocked.reportOk, false) - - const danglingRef = checkCompletion({ report: goodReport, runTerminal: 'succeeded', artifactRefs: ['art_1'], artifactLookup: () => undefined }) - assert.equal(danglingRef.refsValid, false) - assert.ok(danglingRef.blockers.some((row) => row.includes('成果引用无效'))) - - const missingArtifact = checkCompletion({ report: goodReport, runTerminal: 'succeeded', artifactRefs: ['art_1'], artifactLookup: () => ({ id: 'art_1', verification: { status: 'missing' } }) }) - assert.equal(missingArtifact.refsValid, false) - - // 纯分析任务允许无附件:空引用不算失败 - assert.equal(checkCompletion({ report: goodReport, runTerminal: 'succeeded', artifactRefs: [] }).ok, true) -}) - -test('完成判定三分支:三者齐全 → completed', () => { - const decision = evaluateCompletion( - runningTask(), - { report: goodReport, runTerminal: 'succeeded', artifactRefs: ['art_1'], artifactLookup: () => ({ id: 'art_1' }) }, - { now: clock }, - ) - assert.equal(decision.applied, true) - assert.equal(decision.task.status, 'completed') - assert.ok(decision.task.reportReceivedAt) - assert.equal(decision.task.needsAttentionReason, null) -}) - -test('完成判定三分支:只有报告 → 等待,不置 completed', () => { - // 报告先到:保存候选结果,等宿主终态 - const reported = decide(runningTask(), { kind: 'report', report: goodReport }, { now: clock }) - assert.equal(reported.applied, true) - assert.equal(reported.task.status, 'running', '报告先到不得直接置完成') - assert.ok(reported.task.reportReceivedAt !== null) - - // 只有报告、终态尚未到达 —— 保持 running - const pending = evaluateCompletion(runningTask(), { report: goodReport, runTerminal: null }) - assert.equal(pending.applied, false) - assert.equal(pending.task.status, 'running') - assert.ok(pending.reason.includes('宿主运行尚未结束')) - - // 报告到达后终态成功 → 顺理成章完成 - const finished = decide(reported.task, { kind: 'run_terminal', runTerminal: 'succeeded' }, { now: clock }) - assert.equal(finished.applied, true) - assert.equal(finished.task.status, 'completed') -}) - -test('完成判定三分支:只有终态 → needs_attention', () => { - // 宿主运行先结束但无报告 - const onlyTerminal = evaluateCompletion(runningTask(), { report: null, runTerminal: 'succeeded' }, { now: clock }) - assert.equal(onlyTerminal.applied, true) - assert.equal(onlyTerminal.task.status, 'needs_attention') - assert.match(onlyTerminal.task.needsAttentionReason, /没有有效的结构化报告/) - - // 运行失败同样进入 needs_attention,而不是 completed - const failed = decide(runningTask(), { kind: 'run_terminal', runTerminal: 'failed' }, { now: clock }) - assert.equal(failed.task.status, 'needs_attention') - assert.match(failed.task.needsAttentionReason, /failed/) - - // 终态成功但报告不完整:也不能置完成,最多进入 needs_attention 等补报 - const partial = evaluateCompletion(runningTask(), { report: { attemptId: 'att_1' }, runTerminal: 'succeeded' }) - assert.notEqual(partial.task.status, 'completed') - assert.equal(partial.task.status, 'needs_attention') -}) - -test('运行终态为 cancelled 时任务直接取消', () => { - const decision = decide(runningTask(), { kind: 'run_terminal', runTerminal: 'cancelled' }, { now: clock }) - assert.equal(decision.task.status, 'cancelled') - assert.ok(decision.task.endedAt) -}) - -test('乱序事件:旧 seq 不回退,迟到 running 不覆盖终态', () => { - assert.equal(isStaleSeq(null, 5), false) - assert.equal(isStaleSeq(5, 5), true, '同 seq 视为重复') - assert.equal(isStaleSeq(5, 4), true) - assert.equal(isStaleSeq(5, 6), false) - assert.equal(isStaleSeq(5, Number.NaN), true) - - const withSeq = { ...runningTask(), lastSeq: 10 } - const stale = decide(withSeq, { kind: 'input_required', reason: '旧事件', seq: 9 }, { now: clock }) - assert.equal(stale.applied, false) - assert.equal(stale.stale, true) - assert.equal(stale.task.status, 'running') - - const done = evaluateCompletion( - { ...withSeq, lastSeq: 11 }, - { report: goodReport, runTerminal: 'succeeded', seq: 12 }, - { now: clock }, - ) - assert.equal(done.task.status, 'completed') - assert.equal(done.task.lastSeq, 12) - - const late = decide(done.task, { kind: 'input_required', reason: '迟到的求助', seq: 13 }, { now: clock }) - assert.equal(late.applied, false) - assert.equal(late.task.status, 'completed', '终态不能被迟到事件覆盖') - // 终态之后即使 seq 更大也只记 no-op:调用方据此知道「没有状态变化」 - assert.match(late.reason, /不接受|已终态/) - - assert.equal(isRegressingEvent('completed', 'running'), true) - assert.equal(isRegressingEvent('completed', 'completed'), false) - assert.equal(isRegressingEvent('running', 'running'), false) -}) - -test('waiting_input 往返与非法事件', () => { - const asked = requestInput(runningTask(), '缺口径', { now: clock }) - assert.equal(asked.task.status, 'waiting_input') - assert.equal(asked.task.waitingReason, '缺口径') - const back = supplyInput(asked.task, { now: clock }) - assert.equal(back.task.status, 'running') - assert.equal(back.task.waitingReason, null) - assert.equal(supplyInput(back.task).applied, false, '不在待补充时忽略') - assert.equal(requestInput(draftTask(), 'x').applied, false) - assert.throws(() => decide(runningTask(), { kind: 'nope' }), /未知事件类型/) - assert.throws(() => decide(runningTask(), null), /事件必须是对象/) - assert.throws(() => decide({}, { kind: 'report' }), /任务记录不合法/) - assert.throws( - () => decide(runningTask(), { kind: 'report', report: { summary: '' } }), - (error) => error.code === 'INVALID_REPORT', - ) - assert.throws( - () => decide({ ...runningTask(), status: 'failed' }, { kind: 'retry' }), - (error) => error.code === 'RETRY_REQUIRES_NEW_TASK', - ) - assert.equal(decide(runningTask(), { kind: 'retry' }).applied, false) -}) - -test('failTask 必须带原因,终态后忽略', () => { - const failed = failTask(runningTask(), '模型超时', { now: clock }) - assert.equal(failed.task.status, 'failed') - assert.equal(failed.task.failureReason, '模型超时') - assert.ok(failed.task.endedAt) - assert.throws(() => failTask(runningTask(), ' '), /reason/) - assert.equal(failTask(failed.task, 'again').applied, false) -}) - -test('cancelTask 记录取消原因且只写一次结束时间', () => { - const cancelled = cancelTask(runningTask(), '用户点了取消', { now: clock }) - assert.equal(cancelled.task.status, 'cancelled') - assert.equal(cancelled.task.cancelReason, '用户点了取消') - const again = cancelTask(cancelled.task, '重复取消') - assert.equal(again.applied, false) - assert.equal(again.task.endedAt, cancelled.task.endedAt) - assert.equal(cancelTask(draftTask()).task.cancelReason, '用户取消') -}) - -test('completeTask 是 completion 事件的便捷包装', () => { - const decision = completeTask( - runningTask(), - { report: goodReport, runTerminal: 'succeeded', artifactRefs: ['art_1'], artifactLookup: () => ({ id: 'art_1' }), seq: 3 }, - ) - assert.equal(decision.task.status, 'completed') - assert.equal(decision.task.lastSeq, 3) -}) - -test('applyDecision 只在 applied 时落库', () => { - const store = new WorkbenchStore({ file: null, clock, random: () => 3 }) - const projectId = store.createProject({ hostWorkspaceId: 'ws-a' }) - const created = createTask( - { projectId, title: 't', objective: 'o', ownerRoleId: 'hubu' }, - { newTaskId: () => 'task_1', now: clock }, - ) - store.insertTask(created) - const queued = startTask(store.getTask('task_1'), { now: clock }) - const stale = applyDecision(store, 'task_1', { applied: false, stale: true, task: created }) - assert.equal(stale.applied, false) - assert.equal(store.getTask('task_1').revision, 1, '陈旧事件不得产生版本抖动') - - const started = applyDecision(store, 'task_1', { applied: true, stale: false, task: queued }) - assert.equal(started.task.status, 'queued') - assert.equal(store.getTask('task_1').status, 'queued') - // null 会被默认参数换成 undefined,所以显式传 undefined 才能走到 store 校验 - assert.throws(() => applyDecision(undefined, 'task_1', {}), /需要 store/) - // 未启用的事件不得落库:返回原判定,store 保持 revision 不变 - assert.equal(applyDecision(store, 'task_1', { applied: false, task: queued }).task.status, 'queued') - assert.throws(() => applyDecision(store, 'task_1', null), /判定结果不合法/) -}) - -test('isOpenTask 区分终态与活动态', () => { - assert.equal(isOpenTask(draftTask()), true) - assert.equal(isOpenTask(cancelTask(draftTask()).task), false) - assert.equal(isOpenTask(null), false) - assert.equal(isOpenTask({ status: 'bogus' }), false) -})