feat(workbench-panel): 任务行可派工/取消;补使用说明
- 派工带上 targetSessionId + bindingGeneration,缺会话时明确提示先去接通 - 幂等键 ui:<taskId>,重复点不会派出两份;prepared 时如实说明没真发出 - taskActionKeys 纯函数 + 单测(草稿/排队/运行中/终态各自的动作) - docs/v0.1-使用说明.md:接通、派工、契约回执、成果修订、模型、栏宽、隔离、排障 - 213/213
This commit is contained in:
parent
1d58d2c3a6
commit
297c0309b9
|
|
@ -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 回退代码不会回退它。
|
||||
|
|
@ -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`;不静默替换 |
|
||||
|
|
|
|||
|
|
@ -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,
|
||||
};
|
||||
|
|
|
|||
|
|
@ -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(","), '');
|
||||
});
|
||||
|
|
|
|||
Loading…
Reference in New Issue