From 297c0309b9f72b7b7352fbc601e0601a9b88745e Mon Sep 17 00:00:00 2001 From: qyh15 Date: Tue, 10 Nov 2026 11:20:11 +0800 Subject: [PATCH] =?UTF-8?q?feat(workbench-panel):=20=E4=BB=BB=E5=8A=A1?= =?UTF-8?q?=E8=A1=8C=E5=8F=AF=E6=B4=BE=E5=B7=A5/=E5=8F=96=E6=B6=88?= =?UTF-8?q?=EF=BC=9B=E8=A1=A5=E4=BD=BF=E7=94=A8=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 派工带上 targetSessionId + bindingGeneration,缺会话时明确提示先去接通 - 幂等键 ui:,重复点不会派出两份;prepared 时如实说明没真发出 - taskActionKeys 纯函数 + 单测(草稿/排队/运行中/终态各自的动作) - docs/v0.1-使用说明.md:接通、派工、契约回执、成果修订、模型、栏宽、隔离、排障 - 213/213 --- docs/v0.1-使用说明.md | 77 +++++++++++++++++ docs/v0.1-验收记录.md | 2 +- workbench/panel/lib/client.js | 120 +++++++++++++++++++++++++++ workbench/panel/test/client.test.mjs | 17 ++++ 4 files changed, 215 insertions(+), 1 deletion(-) create mode 100644 docs/v0.1-使用说明.md diff --git a/docs/v0.1-使用说明.md b/docs/v0.1-使用说明.md new file mode 100644 index 0000000..f9b59b9 --- /dev/null +++ b/docs/v0.1-使用说明.md @@ -0,0 +1,77 @@ +# 三省六部工作台 v0.1 · 使用说明 + +装好并重启 DSH 之后,右侧多一栏「三省六部」。它是**贴着当前项目**的一本工作台账:谁在办、办到哪、交了什么,都在这里。中间仍然是原生聊天,没有第二个输入框。 + +## 1. 先接通,再派工 + +十席(丞相 / 中书 / 尚书 / 门下 / 吏户礼兵刑工)一开始都是「未接通」——只是编制,还没有会话。 + +1. **朝堂**页点卡片右下角的「接通」。宿主会给这一席建一个独立会话,并把卡片状态变成「空闲」。 +2. 卡片本身是可点的:点已接通的卡片,中央区会切到那一席的会话。 +3. 接通后,这一席才收得到派工。 + +「接通」做的事:建会话(或复用已有会话)→ 把会话号写进账本绑定 → 打开它。换绑不自动发生,需要显式重接,避免把两个部门串到同一个会话上。 + +## 2. 派一条任务 + +**任务**页 → 「新建」→ 填标题、目标、主责部门 → 「存为草稿」。 + +草稿不会自己跑,因为服务端不允许把任务直接塞进一个还没接通的部门。接下来: + +- 部门已接通:在任务行上点 **「派工」**,任务会被投递到那一席的会话里,卡片变「正在运行」。 +- 部门没接通:先回朝堂接通,再回来点「派工」。 +- 派错了或不想跑了:点 **「取消」**。取消只改台账状态,不会删除已经发生的对话。 + +同一条任务重复点「派工」不会派出两份——幂等键按任务号生成,第二次会返回第一次那条记录。 + +## 3. 部门怎么回话 + +部门在自己的会话里干活,完成后回一段带前缀的契约行(宿主解析,不需要你手抄): + +``` +【三省六部】{"action":"reportTaskResult","taskId":"…","report":{"summary":"…","checks":[…],"artifactRefs":[…]}} +``` + +收到并校验通过后,任务变「已完成」,成果进「成果」页。判定是三件事都要成立:**运行结束、报告合格、成果核验通过**。缺一件就停在「需人处理」,等你说下一步。 + +## 4. 成果与修订 + +**成果**页每行是一份交付物: + +- 灰色「· 位置未核验」:只登记了路径,还没确认文件在不在。 +- 红色虚线「· 文件已失效」:登记过,但磁盘上找不到了。记录还在,可以重新登记,或让主责部门补一份。 +- 「第 N 版 · 修订自上一版」:这是某份成果的修订版,原始版本仍然可查。 + +点开一行 → 「找主责部门修改」→ 写清楚要改什么 → 「存为草稿」或「直接派工」。这会**只**给原主责部门开一条修订任务,不重跑三省。 + +## 5. 模型 + +部门模型由根插件按角色覆写,走的是 `/dept-model` 命令,不在右栏里改(右栏只显示当前生效的模型): + +``` +/dept-model 工部 magpie workbuddy/deepseek-v4.1-flash 高 +/dept-model list +/dept-model clear 工部 +``` + +右栏卡片上的模型行就是它当前会用的那个;显示「跟随宿主」表示没有单独设。 + +## 6. 栏宽与键盘 + +- 拖分隔条,或在分隔条上按方向键(±16px,Shift ±64px,Home/End 到两端),宽度记在 `localStorage['sansheng.workbench.railWidth']`,范围 340–600。 +- 卡片是 `role="button"`,Tab 可到,Enter / 空格打开会话。 + +## 7. 项目隔离 + +每个项目一本账:席位绑定、部门配置、任务、成果、事件都按项目分桶。切项目会重新取一次 `bootstrap`,看不到别的项目的东西。同一个目录被登记成两个项目会明确报冲突(要共用请显式传 `allowSharedRoot`)。 + +## 8. 出问题怎么办 + +| 现象 | 处理 | +| --- | --- | +| 中央区白屏或样式崩了 | 控制台执行 `localStorage['sansheng.workbench.main']='off'`,刷新。接管被整个跳过,原生聊天照旧 | +| 右栏不出现 | `node scripts/workbench-preflight.mjs` 看 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 index 64af7c5..8c28234 100644 --- a/docs/v0.1-验收记录.md +++ b/docs/v0.1-验收记录.md @@ -30,7 +30,7 @@ node --test --test-isolation=none test/policy.test.js workbench/test/*.test.mjs | 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 一致 | 已验(装配层闭环) | `A05 两席闭环`:经 HTTP 路由 `POST /dispatch` 真的把任务单投进工部会话(`controller.prompts[0].content[0].text` 含任务标题),派发按 `targetSessionId` + `bindingGeneration` 双校验;工部用契约行回执 → `Result` 落账 → 终态成功 + 成果核验 → 任务 `completed`。十席各自 session 的输入/历史一致性仍需真机逐个看 | +| A05 | 十席分别发短消息,输入/历史/实际 session 一致 | 已验(装配层闭环 + 界面派工入口) | `A05 两席闭环`:经 HTTP 路由 `POST /dispatch` 真的把任务单投进工部会话(`controller.prompts[0].content[0].text` 含任务标题),派发按 `targetSessionId` + `bindingGeneration` 双校验;工部用契约行回执 → `Result` 落账 → 终态成功 + 成果核验 → 任务 `completed`。十席各自 session 的输入/历史一致性仍需真机逐个看。界面任务行已加「派工 / 取消」(`taskActionKeys` 单测 + tasks 页预览截图),派工同样带 sessionId + bindingGeneration | | A06 | A 工部改模型,B 工部用另一模型,全局默认不变 | 已验(单测)+ 待真机 | 配置按 `projectId+roleId` 存、`saveDepartmentConfig` CAS;**派发时默认不再调 `selectModel`**(部门模型由政策插件在 `agent/request` 上按角色覆写,再调一次会让宿主把全局默认存成本部门的),模型快照仍记在 `attempt.effectiveConfigSnapshot`。真机待看 `modelSelection` 投影 | | A07 | 运行中改模型,本次仍用原模型 | 已验(单测) | `首次派发:固定模型快照 → prompt 用 attemptId 作幂等键`:`effectiveConfigSnapshot` 在派发时冻结 | | A08 | 模型不支持旧 effort / 目录失效,校验错误可见 | 已验(单测) | `会话适配:prompt 必须带 requestId,错误分类可区分可重试与必失败` 覆盖 `model_unavailable`;不静默替换 | diff --git a/workbench/panel/lib/client.js b/workbench/panel/lib/client.js index 7b32197..92a2c89 100644 --- a/workbench/panel/lib/client.js +++ b/workbench/panel/lib/client.js @@ -643,6 +643,9 @@ window.__ModuleLoader__.load({ ".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}", @@ -803,6 +806,15 @@ window.__ModuleLoader__.load({ 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; @@ -1045,6 +1057,11 @@ window.__ModuleLoader__.load({ 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]; @@ -1494,6 +1511,76 @@ window.__ModuleLoader__.load({ }); } + // 派工:把队列里的任务真正交给主责部门的会话。 + // 宿主的 /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") setNotice("已派出,部门会话里能看到这条任务。"); + else if (status === "prepared") setNotice("已记入台账,但宿主没接上会话层,暂时没有真的发出。"); + else if (result && result.duplicate) setNotice("这条任务之前已经派过,没有重复发送。"); + }); + }).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); + } + setNotice("已取消。"); + }).catch(function (failure) { + setNotice(describeError(failure)); + }).then(function () { + setDispatchBusy(null); + }); + } + // A22:不重跑三省,只给原主责部门开一条修订任务。 function submitRevision(artifact, status) { if (!projectId || !artifact) { @@ -1679,6 +1766,37 @@ window.__ModuleLoader__.load({ 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, @@ -1688,6 +1806,7 @@ window.__ModuleLoader__.load({ : 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, ]); }), ]); @@ -2085,6 +2204,7 @@ window.__ModuleLoader__.load({ existenceLabel: existenceLabel, revisionLabel: revisionLabel, taskKindLabel: taskKindLabel, + taskActionKeys: taskActionKeys, wirePathsFromLayout: wirePathsFromLayout, ROLE_META: ROLE_META, }; diff --git a/workbench/panel/test/client.test.mjs b/workbench/panel/test/client.test.mjs index 1d3b684..3b2afee 100644 --- a/workbench/panel/test/client.test.mjs +++ b/workbench/panel/test/client.test.mjs @@ -535,3 +535,20 @@ test("A27 分隔条键盘:方向键 / Shift / Home / End 有确定步长,其 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(","), ''); +});