taskboard-workbench 0.3.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/web/app.js CHANGED
@@ -537,7 +537,7 @@
537
537
  // FR-28:会话内**默认按本会话收敛**(档位=`session:<本会话标识>`,可用「全部」一键切回);
538
538
  // 拿不到 sessionId(非会话作用域入口)时保持「全部」,并由工具栏明写降级文案(见 NO_SESSION_NOTICE)。
539
539
  const defaultSessionScope = sessionId ? `${SESSION_SCOPE_CURRENT_PREFIX}${sessionId}` : "";
540
- const state = { statuses: [], priorities: [], projects: [], tasks: [], projectId: "", priority: "", label: "", sessionScope: defaultSessionScope, session: sessionId, keyword: "", loop: {}, host: null, binding: { projectId: null, bound: true, mainSessionId: null, association: null }, showArchived: false, collapsedSections: [], touchedSections: [], emptyState: null, dragTask: null, dragEl: null };
540
+ const state = { statuses: [], priorities: [], projects: [], tasks: [], projectId: "", priority: "", label: "", sessionScope: defaultSessionScope, session: sessionId, keyword: "", loop: {}, host: null, instanceRole: "writer", leaseOwner: null, dataDir: "", dataDirHint: null, binding: { projectId: null, bound: true, mainSessionId: null, association: null }, showArchived: false, collapsedSections: [], touchedSections: [], emptyState: null, dragTask: null, dragEl: null };
541
541
  let editing = null;
542
542
  let destroyed = false;
543
543
 
@@ -683,6 +683,18 @@
683
683
  const hostNotice = mk("div", "banner warn");
684
684
  hostNotice.hidden = true;
685
685
  hostNotice.setAttribute("role", "status");
686
+ /**
687
+ * 卡 `-236` / `-237`(需求 `R173`)· **只读跟随者**常驻条。
688
+ *
689
+ * 真机 2026-11-10:dsh web 与 dsh desktop 同时打开同一个库时,同一时刻只允许一个实例写
690
+ * (租约在库里,见 `src/core/instance-lease.mjs`)。后起的那个窗口**能看不能写**,
691
+ * 但它如果什么都不说,用户点「新建任务」只会收到一条 409 —— 不如在顶上直接讲清楚
692
+ * 「谁在写、要写去哪里、对端退出后会自己接管」。
693
+ * 与一次性 `banner` 分开:这条是**状态**,要一直留到角色变化为止。
694
+ */
695
+ const followerNotice = mk("div", "banner warn");
696
+ followerNotice.hidden = true;
697
+ followerNotice.setAttribute("role", "status");
686
698
  // 卡 `-222`(需求 `R163` ①):**可降级步骤**失败时的常驻条 —— 「面板能用,但这几项没读到」。
687
699
  // 与一次性 `banner` 分开:条里要**留住原因**并带「重试」按钮;banner 到时会自动消失。
688
700
  // 复用 `.empty-guide` 既有排版(只在 tokens.css 补一条宽度收敛,不新增取数通道)。
@@ -717,6 +729,8 @@
717
729
  shell.append(header, toolbar, banner, connNotice, hostNotice, boardScroll, reqScroll, teamScroll, configScroll, gateScroll, advanceScroll);
718
730
  // 卡 `-222`:常驻条挂在「能力提示」与各视图之间(单独插,不改上面那条已被 FR-20 守卫钉住的挂载行)。
719
731
  try { shell.insertBefore(bootStrip, boardScroll); } catch { /* ignore */ }
732
+ // 卡 `-236`/`-237`:只读跟随者条同样单独插,挂载行不动。
733
+ try { shell.insertBefore(followerNotice, boardScroll); } catch { /* ignore */ }
720
734
 
721
735
  // 任务详情抽屉(含"归属团队 / 执行会话"关联)
722
736
  const drawerBackdrop = mk("div", "tb-drawer-backdrop");
@@ -994,6 +1008,110 @@
994
1008
  shell.appendChild(dialog);
995
1009
  root.replaceChildren(shell);
996
1010
 
1011
+ /**
1012
+ * 宿主内嵌环境(Electron / 受限 webview)**不实现浏览器原生 prompt()** —— 调用即抛
1013
+ * `prompt() is not supported`,于是「新建项目」这类入口从可用变成直接报错。这里用**页面内原生
1014
+ * `<dialog>` 表单**替代,样式复用既有 `dialog` / `.field` / `.dialog-actions`(与「新建任务」
1015
+ * 对话框同一套),不引入第二套弹窗体系,也不引入前端框架。
1016
+ *
1017
+ * 契约:返回 `{ [name]: string }`;`取消 / Esc / 点遮罩` 一律 resolve(`null`) ——
1018
+ * 调用方**先判 null 再发请求** ⇒ 取消路径零副作用(不产生半截项目、不写事件流)。
1019
+ * 必填校验在本地做(不依赖原生 `required` 的冒泡提示,宿主里的呈现不可控):
1020
+ * 留空则改写提示文案并聚焦,**不关闭对话框、不提交**。
1021
+ */
1022
+ function askFields({ title, hint = "", fields = [], submit = "确定" }) {
1023
+ return new Promise((resolve) => {
1024
+ const d = mk("dialog");
1025
+ const form = mk("form");
1026
+ form.method = "dialog";
1027
+ d.appendChild(mk("h2", null, title));
1028
+ const controls = new Map();
1029
+ fields.forEach((spec, index) => {
1030
+ const wrap = mk("div", "field");
1031
+ const id = `tb-ask-${index}-${Math.random().toString(36).slice(2, 8)}`;
1032
+ const label = mk("label", null, spec.label ?? spec.name);
1033
+ label.htmlFor = id;
1034
+ const control = spec.multiline ? mk("textarea") : mk("input");
1035
+ if (spec.multiline) control.rows = spec.rows ?? 3;
1036
+ else control.type = "text";
1037
+ control.id = id;
1038
+ control.value = spec.value ?? "";
1039
+ control.placeholder = spec.placeholder ?? "";
1040
+ controls.set(spec.name, { control, spec });
1041
+ wrap.append(label, control);
1042
+ form.appendChild(wrap);
1043
+ });
1044
+ const hintEl = mk("p", "hint", hint);
1045
+ form.appendChild(hintEl);
1046
+ const actions = mk("div", "dialog-actions");
1047
+ const cancel = mk("button", "ghost", "取消");
1048
+ cancel.type = "button";
1049
+ const ok = mk("button", "primary", submit);
1050
+ ok.type = "submit";
1051
+ actions.append(cancel, ok);
1052
+ form.appendChild(actions);
1053
+ d.appendChild(form);
1054
+ shell.appendChild(d);
1055
+ let settled = false;
1056
+ const finish = (value) => {
1057
+ if (settled) return;
1058
+ settled = true;
1059
+ if (d.open) d.close();
1060
+ d.remove();
1061
+ resolve(value);
1062
+ };
1063
+ cancel.addEventListener("click", () => finish(null));
1064
+ // Esc:`cancel` 事件在关闭前触发,拦下并走同一条「取消」路径(保证只 resolve 一次)。
1065
+ d.addEventListener("cancel", (event) => { event.preventDefault(); finish(null); });
1066
+ // 点遮罩=取消;点内容不算。按坐标判断,避免把对话框内边距上的点击也当成取消。
1067
+ d.addEventListener("click", (event) => {
1068
+ if (event.target !== d) return;
1069
+ const r = d.getBoundingClientRect();
1070
+ const inside = event.clientX >= r.left && event.clientX <= r.right && event.clientY >= r.top && event.clientY <= r.bottom;
1071
+ if (!inside) finish(null);
1072
+ });
1073
+ /** 收集 + 必填校验。**两条入口共用**:提交按钮的 click 与表单 submit(回车)——
1074
+ * 只挂 submit 会赌「宿主一定派发 submit 事件」,赌输的表现是对话框关不掉也交不出去(Promise 永久挂起)。 */
1075
+ const collect = () => {
1076
+ const out = {};
1077
+ for (const [name, entry] of controls) {
1078
+ const value = String(entry.control.value ?? "");
1079
+ if (entry.spec.required && !value.trim()) {
1080
+ hintEl.textContent = entry.spec.requiredMessage ?? `请填写「${entry.spec.label ?? entry.spec.name}」`;
1081
+ entry.control.focus();
1082
+ return;
1083
+ }
1084
+ out[name] = value;
1085
+ }
1086
+ finish(out);
1087
+ };
1088
+ form.addEventListener("submit", (event) => { event.preventDefault(); collect(); });
1089
+ // click 先于 submit 触发;`finish` 有 settled 守卫,双触发只会生效一次。
1090
+ ok.addEventListener("click", (event) => { event.preventDefault(); collect(); });
1091
+ d.showModal();
1092
+ const first = controls.values().next().value;
1093
+ if (first) first.control.focus();
1094
+ });
1095
+ }
1096
+
1097
+ /**
1098
+ * 新建项目的字段表(会话绑定门 / 工具栏共用一份)—— 两个入口各自拼文案必然漂移。
1099
+ * 返回 `{ name, workspacePath }`(工作目录留空 ⇒ `null`);取消 ⇒ `null`(一个请求都不发)。
1100
+ */
1101
+ async function askNewProject() {
1102
+ const input = await askFields({
1103
+ title: "新建项目",
1104
+ hint: "项目 id 由名称生成;工作目录可留空(留空=不绑定目录)。",
1105
+ submit: "创建",
1106
+ fields: [
1107
+ { name: "name", label: "项目名称 *", placeholder: "例如:水电站集控 · 测试台", required: true, requiredMessage: "项目名称不能为空(项目 id 由它生成)" },
1108
+ { name: "workspacePath", label: "项目工作目录(绝对路径,可留空)", placeholder: "/Users/…/项目目录" },
1109
+ ],
1110
+ });
1111
+ if (!input) return null;
1112
+ return { name: input.name.trim(), workspacePath: (input.workspacePath ?? "").trim() || null };
1113
+ }
1114
+
997
1115
  // ---------------------------------------------------------------- helpers
998
1116
  /**
999
1117
  * FR-95(2026-10-26 补):会话**命名结果**的如实呈现片段 —— 供各「建会话」出口的横幅复用。
@@ -1106,6 +1224,30 @@
1106
1224
  hostNotice.textContent = "本实例是独立进程,没有 DSH 宿主会话通道:「投给主会话 / 打开会话 / 派发团队」这类动作在这里不可用(相关按钮已置灰)。看板、建卡、改状态、评审、人工收口都照常可用;要投递或派发,请到 DSH 内的任务工作台(地址以 /integrations/taskboard-workbench 结尾的那个页面)操作。";
1107
1225
  hostNotice.hidden = false;
1108
1226
  }
1227
+ /** 卡 `-236`/`-237`:只读跟随者常驻条(角色来自 `/api/health` 的 `role` / `leaseOwner`)。 */
1228
+ function renderFollowerNotice() {
1229
+ if (state.instanceRole !== "follower") { followerNotice.hidden = true; return; }
1230
+ const owner = state.leaseOwner;
1231
+ const who = owner ? `${owner.host ?? "另一个宿主"} · pid ${owner.pid ?? "?"}` : "另一个工作台实例";
1232
+ followerNotice.textContent = `本窗口只读:${who} 正在写同一个数据库(${state.dataDir || "同一 dataDir"})。看板照常可看;新建 / 改状态 / 评论等写操作会被拒绝。要写请去那个窗口;它退出后(约 45 秒租约过期)本窗口会自动接管,无需重启。`;
1233
+ followerNotice.hidden = false;
1234
+ }
1235
+ /** 角色会变(对端退出 ⇒ 自动接管),所以轻量轮询一次 `/api/health`,只更新角色,不动数据。 */
1236
+ async function refreshInstanceRole() {
1237
+ try {
1238
+ const health = await api("GET", "/api/health");
1239
+ const nextRole = health?.role === "follower" ? "follower" : "writer";
1240
+ const changed = nextRole !== state.instanceRole;
1241
+ state.instanceRole = nextRole;
1242
+ state.leaseOwner = health?.leaseOwner ?? null;
1243
+ state.dataDirHint = health?.dataDirHint ?? state.dataDirHint ?? null;
1244
+ renderFollowerNotice();
1245
+ if (changed && nextRole === "writer") {
1246
+ showBanner("已接管写者租约(对端已退出),本窗口恢复读写", "info");
1247
+ if (view === "board") void loadTasks();
1248
+ }
1249
+ } catch { /* 轮询失败不打扰:连接问题由 connNotice 负责 */ }
1250
+ }
1109
1251
  /**
1110
1252
  * FR-84 补口(2026-10-18 真机):`navigator.clipboard.writeText()` 返回 **Promise**,
1111
1253
  * 权限被拒或非安全上下文时是 **rejection** —— 老写法 `try { writeText(x) } catch {}` **抓不到**,
@@ -1896,10 +2038,16 @@
1896
2038
  // 先读能力位再渲染:否则首屏会先画出"能点"的按钮、几百毫秒后再置灰(闪一下更困惑)。
1897
2039
  const health = await runBootStep("health", "宿主能力位(/api/health)", false, () => api("GET", "/api/health"));
1898
2040
  state.host = health.value?.host ?? null;
2041
+ state.instanceRole = health.value?.role === "follower" ? "follower" : "writer";
2042
+ state.leaseOwner = health.value?.leaseOwner ?? null;
2043
+ state.dataDirHint = health.value?.dataDirHint ?? null;
1899
2044
  renderHostNotice();
2045
+ renderFollowerNotice();
1900
2046
  // ② 状态 / 优先级元数据(**必要**:看板列与优先级下拉全靠它,缺了画不出列)
1901
2047
  const meta = await runBootStep("meta", "状态与优先级元数据(/api/meta)", true, () => api("GET", "/api/meta"));
1902
2048
  state.statuses = meta.value?.statuses ?? [];
2049
+ state.dataDir = meta.value?.dataDir ?? "";
2050
+ renderFollowerNotice(); // 只读条里要写清"哪个库",meta 回来后再刷一次文案
1903
2051
  state.priorities = meta.value?.priorities ?? [];
1904
2052
  // ③ FR-60:会话/工作区 → 项目(**可降级**:拿不到就按项目列表第一项)
1905
2053
  const ctxParams = new URLSearchParams();
@@ -1981,10 +2129,10 @@
1981
2129
  bar.append(
1982
2130
  btn(state.binding.association === "pending" ? "重新申请关联" : "申请关联", async () => { try { await api("POST", `/api/projects/${encodeURIComponent(state.projectId)}/sessions/request`, { sessionId }); showBanner("已提交关联申请,等待主会话批准", "info"); await resolveBinding(state.projectId); renderCurrentView(); } catch (e) { showBanner(`申请失败:${e.message}`, "error"); } }, "primary"),
1983
2131
  btn("新建项目(绑定本会话)", async () => {
1984
- const name = window.prompt("新项目名称(将据此生成项目 id)"); if (!name) return;
1985
- const ws = window.prompt("项目工作目录(绝对路径,可留空)");
2132
+ const input = await askNewProject();
2133
+ if (!input) return;
1986
2134
  try {
1987
- const r = await api("POST", "/api/projects", { name, workspacePath: ws && ws.trim() ? ws.trim() : null });
2135
+ const r = await api("POST", "/api/projects", { name: input.name, workspacePath: input.workspacePath });
1988
2136
  state.projectId = r.project.id;
1989
2137
  state.projects = [r.project, ...projects.filter((p) => p.id !== r.project.id)];
1990
2138
  await resolveBinding(state.projectId); // 新项目无主会话 → 本会话成为主会话
@@ -2037,20 +2185,31 @@
2037
2185
  const rowActions = (item) => {
2038
2186
  const box = mk("div", "advance-actions");
2039
2187
  for (const action of (item.actions ?? [])) {
2040
- box.appendChild(btn(ADVANCE_ACTION_LABEL[action.code] ?? action.code, () => {
2188
+ // 取值改走页面内 dialog ⇒ 回调必须是 async(原生 prompt() 是同步阻塞的)。
2189
+ box.appendChild(btn(ADVANCE_ACTION_LABEL[action.code] ?? action.code, async () => {
2041
2190
  if (action.code === "complete") { void decide(item, "complete"); return; }
2042
2191
  if (action.code === "approve") { void decide(item, "approve"); return; }
2043
2192
  if (action.code === "retry") { void decide(item, "retry"); return; }
2044
2193
  if (action.code === "changes") {
2045
- const note = window.prompt(`#${item.taskRef} 返工说明(会写进事件流)`, "") ?? null;
2046
- if (note === null) return;
2047
- void decide(item, "changes", note);
2194
+ const input = await askFields({
2195
+ title: `#${item.taskRef} 返工说明`,
2196
+ hint: "会写进事件流;可留空=只记「返工」不写说明。",
2197
+ submit: "提交返工",
2198
+ fields: [{ name: "note", label: "返工说明", multiline: true, rows: 4, placeholder: "哪里不达标、要改成什么样" }],
2199
+ });
2200
+ if (!input) return;
2201
+ void decide(item, "changes", input.note);
2048
2202
  return;
2049
2203
  }
2050
2204
  if (action.code === "choose") {
2051
- const conclusion = window.prompt(`#${item.taskRef} 的结论(一句话)`, "") ?? null;
2052
- if (conclusion === null || !conclusion.trim()) return;
2053
- void decide(item, conclusion.trim(), item.why);
2205
+ const input = await askFields({
2206
+ title: `#${item.taskRef} 的结论`,
2207
+ hint: "一句话结论,会写进事件流。",
2208
+ submit: "提交结论",
2209
+ fields: [{ name: "conclusion", label: "结论 *", placeholder: "例如:同意,按子任务 B 执行", required: true, requiredMessage: "结论不能为空" }],
2210
+ });
2211
+ if (!input || !input.conclusion.trim()) return;
2212
+ void decide(item, input.conclusion.trim(), item.why);
2054
2213
  return;
2055
2214
  }
2056
2215
  // attribute / dispatch:不在本页代做,指回既有入口(不造第二条写路径)
@@ -2370,11 +2529,10 @@
2370
2529
  // 「新建项目」统一入口(工具栏 / 配置页共用)—— 建完即切换,并让本会话成为该项目主会话
2371
2530
  // (与「会话绑定门」里的建项目同口径:POST /api/projects → resolveBinding)。
2372
2531
  async function createProjectFlow() {
2373
- const name = window.prompt("新项目名称(将据此生成项目 id)");
2374
- if (!name || !name.trim()) return;
2375
- const ws = window.prompt("项目工作目录(绝对路径,可留空)");
2532
+ const input = await askNewProject();
2533
+ if (!input) return;
2376
2534
  try {
2377
- const r = await api("POST", "/api/projects", { name: name.trim(), workspacePath: ws && ws.trim() ? ws.trim() : null });
2535
+ const r = await api("POST", "/api/projects", { name: input.name, workspacePath: input.workspacePath });
2378
2536
  state.projectId = r.project.id;
2379
2537
  state.projects = [r.project, ...(state.projects ?? []).filter((p) => p.id !== r.project.id)];
2380
2538
  await resolveBinding(state.projectId);
@@ -2503,6 +2661,8 @@
2503
2661
  };
2504
2662
  } catch { boardEvents = null; }
2505
2663
  // FR-75/76:看护状态会随"阈值到达"自行变化(不产生 SSE),用轻量轮询兜底刷新看板/详情。
2664
+ // 卡 `-237`:写者租约随时可能交接(对端退出 / 对端起来)—— 30s 刷新一次角色,只读写者身份。
2665
+ const instancePoll = window.setInterval(() => { if (!destroyed) void refreshInstanceRole(); }, 30000);
2506
2666
  const watchdogPoll = window.setInterval(() => {
2507
2667
  if (destroyed) return;
2508
2668
  if (view === "board") void loadTasks();
@@ -2798,15 +2958,27 @@
2798
2958
  const right = mk("span", "config-actions"); right.append(...actions); r.appendChild(right);
2799
2959
  return r;
2800
2960
  };
2801
- // 开工语 —— **不是第 8 步**:它是新会话发给队长的**第一条消息**(`KICKOFF_PROMPT` 的 ①–⑧ 就是
2961
+ // 开工语 —— **不是第 8 步**:它是新会话发给队长的**第一条消息**(`KICKOFF_STEPS` 的 ①–⑧ 就是
2802
2962
  // 下面这 7 步的完整流程),复制即用,没有「做完」这个状态,因此不编号、不参与 ✅/○。
2963
+ //
2964
+ // R177(卡 `-243`):**按「配置对象」取项目,而不是按 `/api/context` 的全局绑定取** ——
2965
+ // 页面头部写的是「配置对象:${state.projectId}」,用顶部下拉切项目时 `info.project` 并不跟着变;
2966
+ // 若拿 `info.project` 插值,切到 B 项目后复制出来仍是 A 项目 ⇒ 与本次要修的 bug 同型。
2967
+ const kickoffProject = (state.projects ?? []).find((p) => p.id === state.projectId)
2968
+ ?? (info.project?.id === state.projectId ? info.project : { id: state.projectId, name: projName, workspacePath: null });
2969
+ const kickoffText = buildKickoffPrompt(kickoffProject);
2803
2970
  const kickoffRow = mk("div", "config-row");
2804
2971
  kickoffRow.appendChild(pill("开工语", "warn", "新会话首条 —— 不是步骤,不编号也没有完成态"));
2805
2972
  kickoffRow.appendChild(mk("span", null, "新会话首条:把这句发给队长(它驱动下面 1–7 步)"));
2806
2973
  const kickoffRight = mk("span", "config-actions");
2807
- kickoffRight.appendChild(gcopy("复制开局提示词", KICKOFF_PROMPT));
2974
+ kickoffRight.appendChild(gcopy("复制开局提示词", kickoffText));
2808
2975
  kickoffRow.appendChild(kickoffRight);
2809
2976
  guide.appendChild(kickoffRow);
2977
+ // R177:**把「复制出去到底带了什么」写在界面上** —— 只有一个按钮,人分不清复制的是哪个项目/哪个目录
2978
+ // (这正是 bug 能在界面上「看起来正常」的原因)。缺 workspacePath 时如实说会写成「请先在配置页补」。
2979
+ guide.appendChild(mk("p", "hint", kickoffProject.workspacePath
2980
+ ? `开工语已带上:项目 ${kickoffProject.id} · 工作目录 ${kickoffProject.workspacePath}`
2981
+ : `⚠ 项目 ${kickoffProject.id || "(未解析)"} 未设 workspacePath —— 开工语里会写「(项目未设 workspacePath → 请先在配置页补)」,新会话仍可能回落默认项目。`));
2810
2982
  guide.appendChild(mk("p", "hint", "「开工语」不是步骤:它没有 ✅,复制进新会话即可;下面的 1–7 步才是可核验的进度。"));
2811
2983
  guide.append(
2812
2984
  srow(gBound, 1, "绑定项目 / 会话", mk("span", "hint", info.project ? `${info.project.id}${sessionId ? (info.sessionBound === false ? "(未绑定)" : " · 已绑定会话") : " · 全局入口"}` : "(未解析)")),
@@ -2977,9 +3149,14 @@
2977
3149
  const req = card("需求", "需求文档与条目的管理入口");
2978
3150
  req.appendChild(row("需求视图", btn("打开", () => setView("req"), "primary")));
2979
3151
  req.appendChild(row("新建需求条目", btn("新建", async () => {
2980
- const title = window.prompt("需求条目标题");
2981
- if (!title) return;
2982
- try { await api("POST", "/api/requirements/items", { projectId: state.projectId, title }); showBanner("已新建需求条目", "info"); await renderConfig(); }
3152
+ const input = await askFields({
3153
+ title: "新建需求条目",
3154
+ hint: "标题写「动词开头 + 一句话」;详细内容按规范 07 在条目详情里补。",
3155
+ submit: "创建",
3156
+ fields: [{ name: "title", label: "需求条目标题 *", placeholder: "例如:需求条目面板工具区不再挤在左侧", required: true, requiredMessage: "需求条目标题不能为空" }],
3157
+ });
3158
+ if (!input) return;
3159
+ try { await api("POST", "/api/requirements/items", { projectId: state.projectId, title: input.title.trim() }); showBanner("已新建需求条目", "info"); await renderConfig(); }
2983
3160
  catch (e) { showBanner(`新建失败:${e.message}`, "error"); }
2984
3161
  })));
2985
3162
  req.appendChild(row("AI 拆解(auto · 不可用即报错)", btn("拆解", async () => {
@@ -3045,6 +3222,11 @@
3045
3222
  opsD.appendChild(kvList([
3046
3223
  ["数据目录", meta?.dataDir ?? "—"],
3047
3224
  ["数据库", meta?.dbPath ?? "—"],
3225
+ // 卡 `-236`/`-237`:同一个 dataDir 被多个宿主打开时,这里能一眼看出本窗口是哪个角色。
3226
+ ["实例角色", state.instanceRole === "follower"
3227
+ ? `只读跟随(${state.leaseOwner ? `${state.leaseOwner.host ?? "宿主"} · pid ${state.leaseOwner.pid ?? "?"}` : "对端实例"} 正在写)`
3228
+ : "写者(可读写)"],
3229
+ ...(state.dataDirHint ? [["数据目录提示", state.dataDirHint.hint]] : []),
3048
3230
  ["接口版本", meta ? `schemaVersion=${meta.schemaVersion ?? "?"}` : "—"],
3049
3231
  ["工作台版本", `app v${window.__TB_BOARD__?.version ?? "?"}`],
3050
3232
  ]));
@@ -3417,7 +3599,41 @@
3417
3599
  if (engine === "nanmicoder") return `请用【@nanmicoder/dsh-agent-teams】创建一个完整执行团队(approval=required,先出计划、由人确认后再启动):agent_teams_create({ name, approval:"required", plan:{ members:[{name,role,provider,model}], tasks:[...] } })。\n${roster}\n队长=本会话(lead):按依赖就绪派发、汇总回流。\n红线:执行侧不得置"完成";不 commit/push/publish。`;
3418
3600
  return `当前为【指令降级(P2)】:不驱动团队插件,只把以下派发指令发给会话并记账。\n${roster}\n(如需真正执行,请在配置里切换到官方或 @nanmicoder 引擎。)`;
3419
3601
  };
3420
- const KICKOFF_PROMPT = "【项目开局】你是本项目队长(lead)。工作目录:<项目绝对路径>。\n① 先做「项目开局对齐」六步自检(配置页 → 项目开局对齐):统一代码规范 / 文档驱动 / Git 协作流程 / 代码审查门 / 协作机制与知识沉淀 / 明确分工;缺哪步补哪步(依据《Vibe Coding 团队协作技巧》,对齐结果要能核验);\n② 确认已加载「任务工作台」插件 + agent team 插件可用;\n③ 绑定项目到本会话作为初始会话;\n④ 配置「项目入口·初始化」:创建执行团队 + 约定环境约束(把①的对齐结论写进 envConfig / teamTemplate);\n⑤ 引入项目资料(md/doc);\n⑥ 团队完成需求梳理 → 落盘需求文档;\n⑦ 拆解成看板任务并归因;\n⑧ 授权开工 → 派发执行 → 反馈回流(执行侧不得写 done)。";
3602
+ /**
3603
+ * 需求 `R177`(卡 `-243`,2026-11-12 真机):**开局提示词必须自证「哪个项目 + 哪个工作目录」**。
3604
+ *
3605
+ * 原实现是一条**纯静态常量**,工作目录写死成一个尖括号占位符(形如「工作目录:‹…›」)——
3606
+ * 从任何项目配置页复制出来的文本一字不差,新会话里的 agent 拿不到项目标识 ⇒
3607
+ * `taskboard_context` 按会话 cwd 匹配不到任何项目 ⇒ `binding.mjs` **静默回落默认项目** ⇒
3608
+ * agent 按**别的仓库**的目录开工(真机现场:拿着 `taskboard-workbench` 的 AGENTS.md 去改另一个项目)。
3609
+ *
3610
+ * 口径三条:① 项目以 **id** 为准(名字只是给人看的补充);② 工作目录写**真实绝对路径**,
3611
+ * 不留任何字面占位符;③ 项目没设 `workspacePath` ⇒ **如实写「请先在配置页补」**,
3612
+ * 不写空值、也不猜路径(猜出来的路径正是这条 bug 的成因)。
3613
+ *
3614
+ * 纯函数:只吃 `{ id, name, workspacePath }`,不碰全局状态 —— 因此可在 `new Function` 里单测(见
3615
+ * `tests/kickoff-prompt-project.test.mjs`)。
3616
+ */
3617
+ /** 开局提示词的**流程正文**(①–⑧):与项目无关,故单列;前半段「项目 / 工作目录」由 `buildKickoffPrompt` 插值。 */
3618
+ const KICKOFF_STEPS = "① 先做「项目开局对齐」六步自检(配置页 → 项目开局对齐):统一代码规范 / 文档驱动 / Git 协作流程 / 代码审查门 / 协作机制与知识沉淀 / 明确分工;缺哪步补哪步(依据《Vibe Coding 团队协作技巧》,对齐结果要能核验);\n② 确认已加载「任务工作台」插件 + agent team 插件可用;\n③ 绑定项目到本会话作为初始会话;\n④ 配置「项目入口·初始化」:创建执行团队 + 约定环境约束(把①的对齐结论写进 envConfig / teamTemplate);\n⑤ 引入项目资料(md/doc);\n⑥ 团队完成需求梳理 → 落盘需求文档;\n⑦ 拆解成看板任务并归因;\n⑧ 授权开工 → 派发执行 → 反馈回流(执行侧不得写 done)。";
3619
+ function buildKickoffPrompt(project) {
3620
+ const id = String(project?.id ?? "").trim();
3621
+ const name = String(project?.name ?? "").trim();
3622
+ const workspacePath = String(project?.workspacePath ?? "").trim();
3623
+ const noWorkspace = "(项目未设 workspacePath → 请先在配置页补)";
3624
+ const head = [
3625
+ "【项目开局】你是本项目队长(lead)。",
3626
+ `项目:${id || "(未解析)"}${name ? `(${name})` : ""}`,
3627
+ `工作目录:${workspacePath || noWorkspace}`,
3628
+ ];
3629
+ if (workspacePath) {
3630
+ head.push(`本会话的看板读写**只作用于**这个项目:taskboard_context 传 cwd=${workspacePath};taskboard_* 写操作传 project=${id || "(项目 id)"}。`);
3631
+ } else {
3632
+ head.push("⚠ 该项目还没有工作目录:先在配置页「当前绑定」补 workspacePath,再开新会话;否则 agent 只能按 cwd 回落默认项目。");
3633
+ }
3634
+ head.push("若当前会话的工作目录不是它 ⇒ **不要**在这里开工:请用户在该目录重开会话(按 cwd 回落会读到别的仓库)。");
3635
+ return `${head.join("\n")}\n${KICKOFF_STEPS}`;
3636
+ }
3421
3637
  // 从需求文档里解析"资料清单" → 引入的文件列表
3422
3638
  function parseIntakeFiles(body) {
3423
3639
  const out = []; let inList = false;
@@ -4446,6 +4662,195 @@
4446
4662
  showBanner(`派发失败(${identifier}):${error.message}${error.code ? `(${error.code})` : ""}`, "error");
4447
4663
  }
4448
4664
  }
4665
+ // ── 卡 `-238`(需求 `R174`):执行者按卡选择 ─────────────────────────────────
4666
+ // 前端**唯一**的执行者知识:只认 `GET /api/executors` 给的 `id` / `kind`。
4667
+ // **不硬编码任何命令行** —— 参数在服务端注册表里,前端说了不算(改参数只改一处)。
4668
+ // 未安装 / 被项目 `forbiddenExecutors` 禁用 ⇒ 置灰 + `title` 写明原因,不把注定被拒的路摆到人面前。
4669
+ const AGENT_ICON_PATHS = {
4670
+ // 16×16、单色 `currentColor`、内联(不引图标字体、不引外部资源)
4671
+ team: [
4672
+ "M6 7.4a2.2 2.2 0 1 0 0-4.4 2.2 2.2 0 0 0 0 4.4Z",
4673
+ "M11 7.2a1.8 1.8 0 1 0 0-3.6 1.8 1.8 0 0 0 0 3.6Z",
4674
+ "M2.1 13.6c0-2 1.8-3.6 3.9-3.6s3.9 1.6 3.9 3.6v.5H2.1v-.5Z",
4675
+ "M11 9.9c1.7 0 3.1 1.2 3.1 2.7v.5h-3.2v-.5c0-1.1-.4-2-1.1-2.7",
4676
+ ],
4677
+ dsh: [
4678
+ "M3.2 2.4h3.9c3.3 0 5.6 2.2 5.6 5.6s-2.3 5.6-5.6 5.6H3.2V2.4Zm2.3 2.2v6.8h1.5c2 0 3.3-1.3 3.3-3.4S9 4.6 7 4.6H5.5Z",
4679
+ "M2.2 13.2h11.6v1.4H2.2v-1.4Z",
4680
+ ],
4681
+ claude: [
4682
+ "M8 1.3l1.15 4.55 4.55-1.15-3.4 3.3 3.4 3.3-4.55-1.15L8 14.7l-1.15-4.55L2.3 11.3l3.4-3.3-3.4-3.3 4.55 1.15L8 1.3Z",
4683
+ ],
4684
+ codex: [
4685
+ "M8 1.5l5.6 3.2v6.6L8 14.5 2.4 11.3V4.7L8 1.5Zm0 3L4.8 6.3v3.4L8 11.5l3.2-1.8V6.3L8 4.5Z",
4686
+ ],
4687
+ hermes: [
4688
+ "M1.5 8.3l12.4-6-3.2 11-2.9-4-6.3-1Z",
4689
+ ],
4690
+ };
4691
+ function agentIcon(agent) {
4692
+ const paths = AGENT_ICON_PATHS[agent] ?? AGENT_ICON_PATHS.team;
4693
+ const svg = doc.createElementNS("http://www.w3.org/2000/svg", "svg");
4694
+ svg.setAttribute("viewBox", "0 0 16 16");
4695
+ svg.setAttribute("aria-hidden", "true");
4696
+ svg.setAttribute("focusable", "false");
4697
+ svg.classList.add("tb-agent-icon");
4698
+ for (const d of paths) {
4699
+ const path = doc.createElementNS("http://www.w3.org/2000/svg", "path");
4700
+ path.setAttribute("d", d);
4701
+ svg.appendChild(path);
4702
+ }
4703
+ return svg;
4704
+ }
4705
+
4706
+ /**
4707
+ * 执行者清单按 `projectId` 缓存 60s(`forbiddenExecutors` / `executionTeam` 都是项目设置)。
4708
+ * @returns {Promise<{ list: Array, defaultId: string|null }>}
4709
+ * `defaultId` 由服务端给(=「不换执行者时本来会走谁」),前端不自己猜项目配置。
4710
+ */
4711
+ const executorsCache = new Map();
4712
+ async function loadExecutors(projectId) {
4713
+ const key = String(projectId ?? "");
4714
+ const hit = executorsCache.get(key);
4715
+ if (hit && Date.now() - hit.at < 60000) return { list: hit.list, defaultId: hit.defaultId };
4716
+ const payload = await api("GET", `/api/executors?projectId=${encodeURIComponent(key)}`);
4717
+ const list = Array.isArray(payload?.executors) ? payload.executors : [];
4718
+ const defaultId = typeof payload?.defaultId === "string" ? payload.defaultId : null;
4719
+ executorsCache.set(key, { at: Date.now(), list, defaultId });
4720
+ return { list, defaultId };
4721
+ }
4722
+
4723
+ /**
4724
+ * 按 `kind` 分流到**三条既有入口** —— 这里只做分发,**不新开任何旁路**:
4725
+ * 归因门 / 授权门 / 人工校验门 / 评审门全在服务端原处照旧。
4726
+ */
4727
+ async function runWithExecutor(task, executor, onDone) {
4728
+ const ref = encodeURIComponent(task.identifier);
4729
+ if (executor.kind === "team") {
4730
+ await dispatchTeam(task.identifier, onDone);
4731
+ return `已派发团队执行(${task.identifier})`;
4732
+ }
4733
+ if (executor.kind === "host-session") {
4734
+ const r = await api("POST", `/api/tasks/${ref}/execute`, {});
4735
+ const launch = r?.launch ?? null;
4736
+ onDone?.();
4737
+ return `已下发宿主会话:mode=${launch?.mode ?? "?"}${launch?.sessionId ? ` · 会话 ${String(launch.sessionId).slice(0, 12)}` : ""}`;
4738
+ }
4739
+ const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { executor: executor.id, async: true });
4740
+ onDone?.();
4741
+ return `已提交 ${executor.label} 后台执行(${r?.executor ?? executor.id})`;
4742
+ }
4743
+
4744
+ /**
4745
+ * 执行者图标行。
4746
+ * @returns {{ node: HTMLElement, selected: () => string|null, list: () => Array }}
4747
+ * `selected()` 给同区块的「预览 / 执行」按钮取当前选择(否则选了 codex 却预览 claude = 预览在骗人)。
4748
+ *
4749
+ * 挂点(稳定,供验证台定位,不靠中文文案):`data-exec-picker` / `data-executor` / `data-executor-kind`。
4750
+ */
4751
+ function mountExecutorPicker(task, { onDone, note: idleNote = null, kinds = null } = {}) {
4752
+ const wrap = mk("div", "tb-exec-picker");
4753
+ wrap.setAttribute("data-exec-picker", "1");
4754
+ wrap.appendChild(mk("span", "tb-exec-picker-label", "执行者"));
4755
+ const choices = mk("div", "tb-exec-picker-choices");
4756
+ const launch = mk("button", "tb-exec-launch", "用所选执行者启动");
4757
+ launch.type = "button";
4758
+ launch.disabled = true;
4759
+ const note = mk("p", "hint tb-exec-note", "加载执行者…");
4760
+ wrap.append(choices, launch, note);
4761
+
4762
+ // 每条通道**此刻**能不能走:服务端注册表只回答「装了没 / 被禁没」,
4763
+ // 「这张卡现在准不准从这条路走」是**卡的状态**决定的(归因门 / 授权门 / 人工校验门),
4764
+ // 与既有「启动执行 / 交给 CLI 执行器执行」用同一把尺子(`executionEntry` / `cliEntry`),不另判一套。
4765
+ const channelBlocker = (executor) => {
4766
+ if (executor.kind === "cli") {
4767
+ const entry = cliEntry(task);
4768
+ if (entry === "start") return null;
4769
+ return entry === "human-review"
4770
+ ? "人工校验任务(FR-85b 升级门):结论只能人给,不得交给执行器"
4771
+ : "本卡未归属需求条目:先归因再执行(EXECUTION_NOT_ATTRIBUTED)";
4772
+ }
4773
+ const entry = executionEntry(task);
4774
+ if (entry === "start") return null;
4775
+ if (entry === "attribute") return "本卡未归属需求条目:先归因再执行";
4776
+ if (entry === "authorize") return "本卡还在「待办池」:先授权开工(授权只是放行,仍需人点执行)";
4777
+ return `当前状态「${STATUS_LABELS[task.status] ?? task.status}」不可从这里启动(仅「可开工」卡可启动)`;
4778
+ };
4779
+ let all = [];
4780
+ let list = [];
4781
+ let selectedId = null;
4782
+ const buttons = [];
4783
+ const pick = (id) => {
4784
+ selectedId = id;
4785
+ for (const button of buttons) button.setAttribute("aria-pressed", String(button.dataset.executor === id));
4786
+ const chosen = buttons.find((button) => button.dataset.executor === id) ?? null;
4787
+ launch.disabled = !chosen || chosen.disabled;
4788
+ };
4789
+
4790
+ void (async () => {
4791
+ let defaultId = null;
4792
+ try { ({ list: all, defaultId } = await loadExecutors(task.projectId)); }
4793
+ catch (error) {
4794
+ note.textContent = `执行者清单加载失败:${error.message}(其余按钮不受影响)`;
4795
+ return;
4796
+ }
4797
+ // `kinds` 过滤:CLI 区块里放「团队 / 宿主会话」只会让人点出一个必然 400 的按钮。
4798
+ list = kinds ? all.filter((executor) => kinds.includes(executor.kind)) : all;
4799
+ if (!list.length) { note.textContent = "没有可用执行者:/api/executors 返回空清单(旧版服务端?)"; return; }
4800
+ for (const executor of list) {
4801
+ const button = mk("button", "tb-exec-choice");
4802
+ button.type = "button";
4803
+ button.dataset.executor = executor.id;
4804
+ button.dataset.executorKind = executor.kind;
4805
+ button.setAttribute("aria-pressed", "false");
4806
+ button.appendChild(agentIcon(executor.agent));
4807
+ button.appendChild(mk("span", null, executor.label));
4808
+ const blockedWhy = executor.usable ? channelBlocker(executor) : null;
4809
+ button.title = !executor.usable
4810
+ ? `${executor.label} 不可用:${executor.reason ?? "原因未知"}`
4811
+ : blockedWhy ? `${executor.label}:${blockedWhy}` : `${executor.label} · ${executor.hint}`;
4812
+ button.disabled = !executor.usable || Boolean(blockedWhy);
4813
+ // 供验证台断言「为什么灰」:状态码化,不靠中文文案。
4814
+ button.dataset.execBlocked = !executor.usable ? "unusable" : blockedWhy ? "gate" : "ok";
4815
+ button.addEventListener("click", () => pick(executor.id));
4816
+ buttons.push(button);
4817
+ choices.appendChild(button);
4818
+ }
4819
+ const unavailable = buttons.filter((button) => button.disabled);
4820
+ // 默认选中:**服务端给的 `defaultId`**(= 不换执行者时本来会走谁),不可用才退第一个可用的。
4821
+ const preferred = list.find((executor) => executor.id === defaultId && executor.usable)
4822
+ ?? list.find((executor) => executor.usable)
4823
+ ?? null;
4824
+ if (preferred) pick(preferred.id);
4825
+ note.textContent = idleNote ?? (unavailable.length
4826
+ ? `选中后点「用所选执行者启动」;${unavailable.length} 个执行者当前不可用(悬停看原因)。原有「启动执行」固定走宿主会话。`
4827
+ : "选中后点「用所选执行者启动」;原有「启动执行」固定走宿主会话。三条通道的既有门(归因 / 人工校验 / 评审)一个不绕。");
4828
+ })();
4829
+
4830
+ launch.addEventListener("click", async () => {
4831
+ const chosen = list.find((executor) => executor.id === selectedId) ?? null;
4832
+ if (!chosen) return;
4833
+ const confirmText = chosen.kind === "team"
4834
+ ? `把 ${task.identifier} 派发给「${chosen.label}」执行?\n\n· 派发后由项目执行团队接手(roles 由项目设置决定)\n· 完成回写「待验收」,收口仍由人确认`
4835
+ : chosen.kind === "host-session"
4836
+ ? `把 ${task.identifier} 交给「${chosen.label}」执行?\n\n· 会尝试新建/切换会话(可能切换主视图)\n· 执行前先认领:卡片置「进行中」`
4837
+ : `把 ${task.identifier} 交给「${chosen.label}」**真实执行**?\n\n· 非交互调用本地 CLI(通常带文件写权限),耗时数十秒到数分钟\n· 执行前先认领:卡片置「进行中」\n· 完成后回流「待验收」或「受阻」,并附证据评论\n· 期间请勿重复点击`;
4838
+ if (typeof window !== "undefined" && typeof window.confirm === "function" && !window.confirm(confirmText)) return;
4839
+ launch.disabled = true;
4840
+ try {
4841
+ const message = await runWithExecutor(task, chosen, onDone);
4842
+ showBanner(message, "info");
4843
+ await loadTasks();
4844
+ } catch (error) {
4845
+ // 归因门等执行类拒绝走统一处置(与既有「启动执行 / 派发团队」同一套措辞与补救入口)
4846
+ if (error.code === "EXECUTION_NOT_ATTRIBUTED") { await handleExecutionFailure(error, task.identifier, task, "派发"); return; }
4847
+ showBanner(`派发失败(${task.identifier} · ${chosen.label}):${error.message}${error.code ? `(${error.code})` : ""}`, "error");
4848
+ } finally { launch.disabled = false; }
4849
+ });
4850
+
4851
+ return { node: wrap, selected: () => selectedId, list: () => list, reload: () => { executorsCache.delete(String(task.projectId ?? "")); } };
4852
+ }
4853
+
4449
4854
  /**
4450
4855
  * FR-108(卡 `-198`):交付阶段徽标的**唯一**渲染点。
4451
4856
  * 文案只描述"交付物到哪一步",不替代"下一步点哪里"(那是 `next` 的活)。
@@ -4897,6 +5302,33 @@
4897
5302
  try { const r = await api("POST", `/api/tasks/${ref}/decompose`, {}); showBanner(`已生成子任务:${(r.children || []).map((c) => c.identifier).join("、")}(待办池)`, "info"); closeDrawer(); await loadTasks(); }
4898
5303
  catch (e) { showBanner(`拆解失败:${e.message}`, "error"); }
4899
5304
  }));
5305
+ // 需求 `R180` / 卡 `-252`(2026-11-12 真机批注「这条任务确认不执行,但是人工操作没有关闭按钮」):
5306
+ // `canceled` 早就是合法终态(服务端 `PATCH /api/tasks/:ref {status:"canceled"}` 放行、库内已有既有 canceled 卡),
5307
+ // 缺的只是**前端入口** —— 「确认不执行」的卡此前只能挂着,或被人拖去别的列。
5308
+ // 口径三条(刻意如此):① 终态卡(done / canceled)不摆这枚按钮;② 必须写原因,空原因直接拒;
5309
+ // ③ 二次确认走**页内 dialog**(宿主没有 `window.prompt`,见卡 `-242`),撤单后落评论 + 审计,不是静默改库。
5310
+ if (t.status !== "done" && t.status !== "canceled") {
5311
+ ops.appendChild(btn("取消任务(撤单)", async () => {
5312
+ const filled = await askFields({
5313
+ title: `取消任务 ${t.identifier}`,
5314
+ hint: "撤单是终态:卡片进「已取消」。原因会写进评论 —— 后人必须能看懂为什么不执行。本动作不删除任何数据。",
5315
+ fields: [{ name: "reason", label: "撤单原因", multiline: true, rows: 3, required: true, requiredMessage: "撤单必须写原因" }],
5316
+ submit: "确认取消",
5317
+ });
5318
+ if (!filled) return;
5319
+ const reason = String(filled.reason ?? "").trim();
5320
+ if (!reason) { showBanner("撤单必须写原因(否则后人不知道为什么不执行)", "error"); return; }
5321
+ try {
5322
+ // 抽屉里的 `t` 可能是几十秒前的快照 ⇒ 先取最新 version,避免 VERSION_CONFLICT 白跑一次。
5323
+ const fresh = await api("GET", `/api/tasks/${ref}`);
5324
+ await api("PATCH", `/api/tasks/${ref}`, { version: fresh?.task?.version, status: "canceled", actor: "human" });
5325
+ await api("POST", `/api/tasks/${ref}/comments`, { body: `人工撤单(不执行):${reason}`, actor: "human" });
5326
+ closeDrawer(); await loadTasks(); showBanner(`${t.identifier} 已撤单(已取消)—— 依赖它的下游卡需要按「前置已撤单」重估`, "info");
5327
+ } catch (e) {
5328
+ showBanner(`撤单失败:${e.message}`, "error");
5329
+ }
5330
+ }, "danger"));
5331
+ }
4900
5332
  // (原 `drawerBody.appendChild(ops)` 已移除:动作区改挂标题栏 `drawerActions`。)
4901
5333
 
4902
5334
  const related = (audit.audit ?? []).filter((a) => a.target === t.identifier);
@@ -5184,6 +5616,14 @@
5184
5616
  const cliSec = mk("div", "drawer-section");
5185
5617
  cliSec.appendChild(mk("h3", null, "CLI 执行器(真实执行)"));
5186
5618
  cliSec.appendChild(mk("p", "hint", "把该任务交给项目配置的 CLI 执行器(teamTemplate.roles[].executor = cli:*,且不在 forbiddenExecutors 中)真实执行:非交互调用 → 采集退出码 / 耗时 / 本次改动差集 → 写回评论 + 尝试记录;成功转「待验收」,失败走统一受阻入口。执行前会先认领并把卡片置为「进行中」——即使它原先在待办池等其它列,执行期也会如实显示在「进行中」,跑完再回到「待验收」。"));
5619
+ // 卡 `-238`(R174):CLI 区也放一个**只含 CLI 形态**的选择器(放团队/宿主会话只会点出必然的 400)。
5620
+ // 「预览 / 执行」都按这里选的那个走 —— 否则选了 codex 却预览 claude,预览就在骗人。
5621
+ const cliPicker = cliEntry(t) === "start" ? mountExecutorPicker(t, {
5622
+ onDone: () => void openTaskDetail(t),
5623
+ kinds: ["cli"],
5624
+ note: "选中后「预览执行计划」与下方按钮都按所选执行者走;「交给 CLI 执行器执行」固定用项目配置的那个。",
5625
+ }) : null;
5626
+ if (cliPicker) cliSec.appendChild(cliPicker.node);
5187
5627
  const cliOut = mk("pre", "cli-plan");
5188
5628
  cliOut.textContent = "(未预览)先点「预览执行计划」看清要跑什么,再决定是否真实执行。";
5189
5629
  cliSec.appendChild(cliOut);
@@ -5191,7 +5631,7 @@
5191
5631
  const cliClosed = t.status === "done" || t.status === "cancelled";
5192
5632
  cliBar.appendChild(btn("预览执行计划", async () => {
5193
5633
  try {
5194
- const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { dryRun: true });
5634
+ const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { dryRun: true, executor: cliPicker?.selected() ?? undefined });
5195
5635
  const p = r.plan ?? {};
5196
5636
  cliOut.textContent = [
5197
5637
  `执行器:${p.executor ?? "—"}(CLI:${p.cli ?? "—"})`,
@@ -5212,7 +5652,7 @@
5212
5652
  if (cliEntryKind === "start") cliBar.appendChild(btn("交给 CLI 执行器执行", async () => {
5213
5653
  if (!window.confirm(`确认把 ${t.identifier} 交给 CLI 执行器**真实执行**?\n\n· 非交互调用本地 CLI(通常带文件写权限),耗时数十秒到数分钟\n· 执行前先认领:卡片将被置为「进行中」(原为 todo 则走授权门)\n· 完成后看板自动刷新为「待验收」或「受阻」,并附退出码/耗时/改动清单\n· 期间请勿重复点击`)) return;
5214
5654
  try {
5215
- const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { async: true });
5655
+ const r = await api("POST", `/api/tasks/${ref}/exec-cli`, { async: true, executor: cliPicker?.selected() ?? undefined });
5216
5656
  cliOut.textContent = [
5217
5657
  `已提交后台执行:${r.executor ?? "—"}(CLI:${r.plan?.cli ?? "—"})`,
5218
5658
  `工作目录:${r.plan?.cwd ?? "—"}`,
@@ -5641,6 +6081,11 @@
5641
6081
  } else {
5642
6082
  sec.appendChild(mk("div", "next-step-title", step.title));
5643
6083
  if (step.hint) sec.appendChild(mk("p", "hint", step.hint));
6084
+ // 卡 `-238`(R174):执行者图标行 —— 只在**这张卡真的能执行**时出现(能走 CLI 或能走宿主/团队)。
6085
+ // 单独一行、不抢主按钮层级:原有「启动执行」仍是主色,本行是「换谁跑」的选择器。
6086
+ if (cliEntry(t) === "start" || executionEntry(t) === "start") {
6087
+ sec.appendChild(mountExecutorPicker(t, { onDone: () => void reopen() }).node);
6088
+ }
5644
6089
  // 操作顺序:异常/待办卡不许只丢几个并列按钮让人自己猜先点哪个(FR-89 第二条约束)。
5645
6090
  if (Array.isArray(step.steps) && step.steps.length) {
5646
6091
  const ol = mk("ol", "next-steps");