feat(workbench-panel): 任务行可派工/取消;补使用说明

- 派工带上 targetSessionId + bindingGeneration,缺会话时明确提示先去接通
- 幂等键 ui:<taskId>,重复点不会派出两份;prepared 时如实说明没真发出
- taskActionKeys 纯函数 + 单测(草稿/排队/运行中/终态各自的动作)
- docs/v0.1-使用说明.md:接通、派工、契约回执、成果修订、模型、栏宽、隔离、排障
- 213/213
This commit is contained in:
qyh15 2026-11-10 11:20:11 +08:00
parent 1d58d2c3a6
commit 297c0309b9
4 changed files with 215 additions and 1 deletions

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

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

View File

@ -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`;不静默替换 |

View File

@ -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,
};

View File

@ -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(","), '');
});