nx-kv 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -2,6 +2,111 @@
 
 本文件记录对外可见的变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
 
+## [0.20.0] - 2026-11-04 任务编排（DAG）进面板 + 面包屑/设置面板收拾 + 改归属项目即搬家
+
+### Added
+
+- **任务编排（DAG）进面板（任务 #40）**：目录落地页任务表与项目组「本组任务」列表支持编排——
+  - **拖动排序**：目录任务表待领取行可拖动换位（落点=上半行前/下半行后，青绿线指示），
+    走既有 `localtask reorder`（已领取行是固定历史，不可拖）；
+  - **编排编辑器**（行尾「⋮」→「编排依赖…」）：闸门开关、上游依赖（我等谁）、
+    下游任务（谁等我，逐条改对方 blockBy）三段勾选，保存前客户端查环——
+    会成环的组合直接禁用；闸门开启时上游段禁用并清空、下游自动覆盖（引擎约束对齐：
+    闸门的隐含边与上游边成环，`applySnapshotToTopic` 亦把闸门显式后继按冗余剪除）；
+  - **组页按队列表达**：组任务横跨多个成员队列，编排以**该任务所属队列**为作用域
+    （候选/闸门下游都取本队列），闸门×N 与锁定徽章上屏；
+  - 闸门徽章升级：显示被挡后续数（`闸门×N`，悬停列出 #id）。
+- 组任务行尾新增「⋮」行菜单（编排依赖 / 闸门开关），待领取行悬停可见。
+
+### Changed
+
+- **设置面板观感重做（任务 #41 重开反馈「ui 太丑了」→ 二轮「更丑了」）**：交互语义不变，只收拾
+  密度与层级——「提示词 / 模板」栏的竖排 tab 侧栏改成顶部一排药丸、内容限宽；提示词条目行去描边、
+  编号不用圆圈、**收起标题洗掉原始模板标记**（不再直接甩 `{{#goal}}〔…〕` 给人看）；操作条分隔线分组；
+  项目级设置从大卡片改成紧凑行（项目多时一屏 8 个而不是 2 个），「持续 get」关着时只留一枚行内小开关；
+  「提示词 / 模板」栏不再套卡（盒中盒显脏）。：交互语义不变，只收拾
+  密度与层级——「提示词 / 模板」栏的竖排 tab 侧栏改成顶部一排药丸、内容限宽；
+  提示词条目行去描边、编号不用圆圈；操作条分隔线分组；项目级设置从大卡片改成
+  紧凑行（项目多时一屏 8 个而不是 2 个），「持续 get」关着时只留一枚行内小开关。
+
+### Changed
+
+- **面包屑移到 maincontent 面板内顶部（任务 #44）**：路径条不再占窗口顶部通栏
+  （那是侧栏的地盘），改成挂在**当前主面板**顶部的一枚小药丸——目录任务表 /
+  任务详情页 / 项目组 / 全部目录总览 / 云端总览 / 仓库管理 / 任务模板 各面板
+  根部都有一条；MD 工作台里则直接放进顶部工具栏（`mdw-top`）内、标题左侧；
+  「← 返回」随路径条一起搬进面板（按来处返回的行为不变）。：路径条不再占窗口顶部通栏
+  （那是侧栏的地盘），改成挂在**当前主面板**顶部的一枚小药丸——目录任务表 /
+  任务详情页 / 项目组 / 全部目录总览 / 云端总览 / 仓库管理 / 任务模板 各面板
+  根部都有一条；「← 返回」随路径条一起搬进面板（按来处返回的行为不变）。
+
+### Fixed
+
+- **改归属项目即搬家（任务 #43「提交任务后发现归属项目填错了，重新修改提交无效」）**：
+  此前「归属决定落点」只在提交那一刻生效——提交后发现归属填错，改正文里的 project 再保存，
+  正文改了队列没动：任务还挂在旧项目队列里，旧项目的 agent 照旧领走，新项目的 agent 永远
+  看不见，组面板/目录页也都显示旧归属。现在 `localtask update --text` / `localtask reopen --text`
+  / 面板「保存并同步 / 重做」走与派任务同一套落点判定：effective frontmatter.project 解析到
+  哪个登记项目，任务就迁到哪个队列；介绍引用（projectIntro/projectDesc）随归属刷新。
+  约束如实说明：已领取的任务不能改归属（要改先 reopen）；带队列内依赖/闸门的任务搬运会
+  跨队列断链，先解除再改（明确报错，不静默）；搬家后任务拿到**新队列的 id**（面板页签自动
+  跟到新号，CLI 输出标注迁移）；指向它的跨队列引用（`topicKey:id`）改写到新地址。
+  另自愈历史脏数据：归属字段与所在队列对不上（上一轮只改字段没搬队列的残留）时，
+  保存即搬到归属队列；已领取/带队列内依赖的脏数据不搬也不拦普通编辑。
+
+- **顶部面包屑真正可见 + 补返回键（任务 #42）**：面包屑此前**渲染了却看不见**——
+  FlexLayout 的根是绝对定位（inset:0），铺满工作区把 26px 的路径条盖在下面
+  （侧栏面板压在上面，路径条点不到也看不见）。现在工作区有面包屑时布局整体下移一条；
+  侧栏也不再出页签条（#33「无页签化」的残留，页签条同样压在路径条上）。
+  面包屑条左侧新增「← 返回」：按**来处**返回（会话内路由历史栈）——
+  从项目组点任务（任务住在 dir 队列里，详情页落在 dir 作用域）时，返回会回到**组**
+  而不是掉进目录；没有上一级时不画返回键。
+
+### Changed
+
+- **可视化编排面板（任务 #40 验收反馈重开）**：目录与项目组**共用**一块编排面板，
+  从任务面板**头部右侧的绿色超链**进入（开在右侧主内容区）：
+  - **节点 = 小圆角卡片**，画布带网格底；节点纵向位置 = 队列顺序；
+  - **拖拽排序**：拖节点即改队列顺序（已领取节点是固定历史，不可拖）；
+  - **连线建立有向依赖**：从节点左侧把手拉到另一个节点 = 后者等前者（写入 blockBy）；
+    依赖边以曲线 + 箭头画在画布左侧，节点上显示「等 #N」芯片（可一键解除）；
+  - **节点工具**：设为闸门（挡住后续）/ 加时间目标（timegoal）/ 打开任务；
+  - 组视图进来可在**成员队列之间切换**（DAG 的排序/依赖/闸门都是队列内的）；
+  - 编排只改被碰过的那几项，没编排过的节点保持原队列序。
+- **设置面板交互收敛（任务 #41）**：
+  - **左边 tab 悬停即切换**（设置外层分区导航 + 「提示词 / 模板」栏内的三个分类），
+    点击保留为兜底；少一次点击。
+  - **提示词条目默认收起成标题行**（首行截断 + 字数），**点击才展开编辑**（单开手风琴）；
+    「添加一条…」新增后直接展开待填。
+  - **说明文字全部删除**：设置面板右侧的静态说明段（工作区/任务工具/项目级等）与
+    提示词栏的提示段一并清掉，只留状态与操作。
+  - **项目级「持续 get」一句话配置**：选模板（内置默认 + 全局回调提示词条目）→ 改一句话
+    （`%s` = 任务编号，存取时与 `{{task.id}}` 互转）→ 添加；不再手写整段模板。
+
+### Added
+
+- `localtask config --suffix-list "一条,二条"` / `--ack-list "一条,二条"`：**整体替换**多条
+  提示词列表（逗号分隔；HTTP body 传数组）。此前 action 只暴露单条 `--suffix`/`--ack`，
+  面板的多条保存无处可传（#41 实测发现并修）。
+
+### Fixed
+
+- **首次打开设置面板爆栈**（任务 #41 实测发现，#33 遗留）：`openPanel` 按区域分发时
+  FLOAT → `openFloatingPanel` → `openPanel`（未带 area）→ 又判成 FLOAT → 无限递归
+  （"Maximum call stack size exceeded"）。老布局因已存着设置浮窗、走 existing 早退而侥幸
+  没踩到，全新档案首次打开必崩。内层调用显式指定 `AREA.MAIN` 后收敛。
+- **回调 / ack 提示词在面板上保存不了**（任务 #41 实测发现，#32 遗留）：面板打的是
+  `taskSuffix`/`ackPrompt` 字段，action 未声明 → 请求 400 且**静默无效**（面板回显旧列表，
+  看起来像保存成功）。改为 `suffixList`/`ackList`（对应上面新增的列表 flag）后真正落库。
+- 侧栏搜索框降高响应式（任务 #38）：`label.sbox` 28px→24px 显式定高；「＋」按钮
+  `flex:none` 永不被挤掉；侧栏按实际像素宽分档降级（≤256 收间距 / ≤195 藏撤销重做 /
+  ≤150 藏标题+放大镜 / ≤125 藏品牌字+匹配数），高频件（搜索框、＋、收起/关闭、齿轮）
+  永远在场；`nx-title` 窄宽折两行一并修复。
+- 面板 maximize 键全线下线（任务 #39）：`tabSetEnableMaximize=false` 一关全断
+  （页签条 Maximize/Restore 按钮、右键菜单最大化项、双击标题栏最大化都走
+  `canMaximize()` 门控）；连带清理死翻译与死 CSS 变量。
+- 目录/组任务行的「⋮」菜单点击不再冒泡打开任务详情（stopPropagation）。
+
 ## [0.19.0] - 2026-11-04 提示词/模板收敛到设置面板 + 面板无页签化（面包屑 + 区域策略）+ DAG 引擎与 goal 插件族
 
 ### Added

package/assets/kv-get/references/wait-workflow.md

@@ -96,9 +96,10 @@ wait 必带一句当前现状总结（≤2000 字，连续空白会折叠为单
 - **配置**：`nx-kv localtask config --suffix "<模板>"`（占位符
   `{{goal.name}} {{goal.remainingHuman}} {{goal.prompt}} {{task.text}} {{source}} {{name}}…`，
   段落 `{{#goal}}…{{/goal}}` 上下文缺失整段消失；`--no-suffix` 关闭、
-  `--reset-suffix` 恢复默认）。字段缺席 = 已关闭或本轮没有可渲染内容。
+  `--reset-suffix` 恢复默认；**多条**用 `--suffix-list "第一条,第二条"`（逗号分隔）整体替换，
+  或 `--suffix-add` / `--suffix-remove <序号>` 按条增删）。字段缺席 = 已关闭或本轮没有可渲染内容。
 - **ack 提示词（完成总结的格式要求）**：`nx-kv localtask config --ack "<提示词>"`
-  （占位符同上，多条）。配置后，它会随 `instruction` 一起交给你——按它要求的格式
+  （占位符同上；多条用 `--ack-list "第一条,第二条"`（逗号分隔）整体替换）。配置后，它会随 `instruction` 一起交给你——按它要求的格式
   写 `localtask done --summary "<完成总结>"` 即可；没配置时 `instruction` 里没有
   这段，格式自便。设置面板「提示词 / 模板」一栏也能配。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-kv",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "nx-kv — KV 清单管理中枢（远程）+ 本机本地任务队列（localtask）：serve 驱动 CLI 与 Web 面板，同源同构，附带可安装 skill 供 agent 提交 / 领取 / 阻塞接收任务",
   "type": "module",
   "bin": {

package/src/core/workflow/project.js

@@ -1,7 +1,9 @@
 // 主题队列（localtask topic.tasks）↔ WorkflowSnapshot 双向投影。
 // 存盘形状仍是任务行；快照是引擎视图。正文不进快照（payload.textRef）。
+// 跨队列 blockBy（"topicKey:id"）不进引擎边，投影回写时必须保留。
 
 import { BUILTIN_GOALS, edgesFromTasks, taskToNode } from './types.js';
+import { normalizeBlockBy, parseDepRef } from './readiness.js';
 
 /** @typedef {import('./types.js').WorkflowSnapshot} WorkflowSnapshot */
 /** @typedef {import('./types.js').WfNode} WfNode */
@@ -75,14 +77,18 @@ export function applySnapshotToTopic(topic, snap) {
 
   for (const task of tasks) {
     if (task.deletedAt || task.migratedTo) continue;
+    const keepForeign = normalizeBlockBy(task.blockBy, task.id).filter(
+      (d) => parseDepRef(d)?.kind === 'foreign',
+    );
     const incoming = (snap.edges || []).filter((e) => String(e.to) === String(task.id));
-    const deps = [];
+    const localDeps = [];
     for (const e of incoming) {
       // 跳过「闸门挡后续」推出来的边：from 是闸门且闸门在数组序上早于本任务时由 blocksFollowing 覆盖
       if (gateIds.has(String(e.from))) continue;
-      deps.push(e.from);
+      const n = Number(e.from);
+      if (Number.isFinite(n) && n > 0) localDeps.push(n);
     }
-    task.blockBy = deps.map((d) => Number(d)).filter((n) => Number.isFinite(n) && n > 0);
+    task.blockBy = normalizeBlockBy([...localDeps, ...keepForeign], task.id);
   }
 
   topic.workflowRevision = Number(snap.revision) || 0;

package/src/core/workflow/readiness.js

@@ -1,17 +1,90 @@
 // 拓扑就绪（自 localtask/dag.js 下沉）。任务行与快照节点两套入口。
+//
+// blockBy 支持：
+//   - 本地 id（number）——同队列依赖（兼容旧存盘）
+//   - 跨队列引用 `"<topicKey>:<taskId>"`——组编排跨项目边；get 时跨 topic 解析
 
-/** 规范化 blockBy：正整数 id、去重、丢掉自身 */
+/** topicKey:id —— key 允许字母数字与 _-（含 __GLOBAL__） */
+const FOREIGN_RE = /^([A-Za-z0-9_-]+):(\d+)$/;
+
+/**
+ * @typedef {{ kind: 'local', id: number } | { kind: 'foreign', key: string, id: number }} DepRef
+ */
+
+/**
+ * 解析单条依赖引用。
+ * @param {unknown} x
+ * @returns {DepRef | null}
+ */
+export function parseDepRef(x) {
+  if (typeof x === 'number' && Number.isFinite(x) && x > 0) {
+    return { kind: 'local', id: Math.trunc(x) };
+  }
+  const s = String(x ?? '').trim();
+  if (!s) return null;
+  const m = FOREIGN_RE.exec(s);
+  if (m) return { kind: 'foreign', key: m[1], id: Number(m[2]) };
+  // 纯数字字符串 → 本地 id（避免把 "12" 当 foreign）
+  if (/^\d+$/.test(s)) {
+    const n = Number(s);
+    if (Number.isFinite(n) && n > 0) return { kind: 'local', id: n };
+  }
+  return null;
+}
+
+/** @param {DepRef} ref @returns {number|string} */
+export function formatDepRef(ref) {
+  if (!ref) return '';
+  if (ref.kind === 'foreign') return `${ref.key}:${ref.id}`;
+  return ref.id;
+}
+
+/**
+ * 规范化 blockBy：本地正整数 id + 跨队列 "key:id"、去重、丢掉本地自身。
+ * @param {unknown} raw
+ * @param {number|string} [selfId]
+ * @returns {Array<number|string>}
+ */
 export function normalizeBlockBy(raw, selfId) {
   const self = Number(selfId);
   const seen = new Set();
   const out = [];
-  for (const x of Array.isArray(raw) ? raw : []) {
-    const n = Number(x);
-    if (!Number.isFinite(n) || n <= 0) continue;
-    if (Number.isFinite(self) && n === self) continue;
-    if (seen.has(n)) continue;
-    seen.add(n);
-    out.push(n);
+
+  /** @type {unknown[]} */
+  let items = [];
+  if (raw == null || raw === '') items = [];
+  else if (Array.isArray(raw)) items = raw;
+  else if (typeof raw === 'string' && /[,，\s]/.test(raw) && !FOREIGN_RE.test(raw.trim())) {
+    items = raw.split(/[,，\s]+/).filter(Boolean);
+  } else {
+    items = [raw];
+  }
+
+  // 数组元素里也可能是逗号串（HTTP 偶发）
+  const flat = [];
+  for (const x of items) {
+    if (typeof x === 'string' && /[,，]/.test(x) && !FOREIGN_RE.test(x.trim())) {
+      flat.push(...x.split(/[,，\s]+/).filter(Boolean));
+    } else {
+      flat.push(x);
+    }
+  }
+
+  for (const x of flat) {
+    const ref = parseDepRef(x);
+    if (!ref) continue;
+    if (ref.kind === 'local') {
+      if (Number.isFinite(self) && ref.id === self) continue;
+      const token = String(ref.id);
+      if (seen.has(`L:${token}`)) continue;
+      seen.add(`L:${token}`);
+      out.push(ref.id);
+    } else {
+      const token = `${ref.key}:${ref.id}`;
+      if (seen.has(`F:${token}`)) continue;
+      seen.add(`F:${token}`);
+      out.push(token);
+    }
   }
   return out;
 }
@@ -28,18 +101,36 @@ function isPendingLike(t) {
   return isAlive(t) && t.status !== 'consumed';
 }
 
+/**
+ * @typedef {object} ReadyOpts
+ * @property {(topicKey: string, taskId: number) => object|null|undefined} [resolveForeign]
+ *   跨队列依赖解析；缺席或返回空 = fail-open（挡不住）
+ */
+
 /**
  * 某条 pending 现在能不能领（任务行模型）。
  * @param {object} task
  * @param {object[]} all
+ * @param {ReadyOpts} [opts]
  */
-export function isReadyToClaim(task, all = []) {
+export function isReadyToClaim(task, all = [], opts = {}) {
   if (!isPendingLike(task)) return false;
   const byId = new Map((all || []).filter(isAlive).map((t) => [Number(t.id), t]));
 
   const deps = normalizeBlockBy(task.blockBy, task.id);
-  for (const id of deps) {
-    const dep = byId.get(id);
+  for (const d of deps) {
+    const ref = parseDepRef(d);
+    if (!ref) continue;
+    let dep = null;
+    if (ref.kind === 'local') {
+      dep = byId.get(ref.id) || null;
+    } else if (typeof opts.resolveForeign === 'function') {
+      const found = opts.resolveForeign(ref.key, ref.id);
+      dep = found && isAlive(found) ? found : null;
+    } else {
+      // 无解析器：跨队列依赖无法验证 → fail-open（与「依赖缺失」同口径）
+      continue;
+    }
     if (!dep) continue;
     if (!isCompleted(dep)) return false;
   }
@@ -56,10 +147,14 @@ export function isReadyToClaim(task, all = []) {
   return true;
 }
 
-/** 按数组序找第一条可领取的 pending；没有 → null */
-export function findFirstReadyPending(tasks = []) {
+/**
+ * 按数组序找第一条可领取的 pending；没有 → null
+ * @param {object[]} tasks
+ * @param {ReadyOpts} [opts]
+ */
+export function findFirstReadyPending(tasks = [], opts = {}) {
   for (const t of tasks || []) {
-    if (isReadyToClaim(t, tasks)) return t;
+    if (isReadyToClaim(t, tasks, opts)) return t;
   }
   return null;
 }

package/src/core/workflow/types.js

@@ -155,7 +155,10 @@ export const edgesFromTasks = (tasks = []) => {
   const alive = (tasks || []).filter((t) => t && !t.deletedAt && !t.migratedTo);
   for (const t of alive) {
     for (const dep of Array.isArray(t.blockBy) ? t.blockBy : []) {
-      edges.push({ from: dep, to: t.id });
+      // 引擎快照只认本队列数字边；跨队列 "key:id" 留给 get/ready 解析
+      const n = Number(dep);
+      if (!Number.isFinite(n) || n <= 0 || String(dep).includes(':')) continue;
+      edges.push({ from: n, to: t.id });
     }
   }
   for (let i = 0; i < alive.length; i += 1) {

package/src/modules/localtask/dag.js

@@ -1,5 +1,7 @@
 // 过渡再导出：实现已下沉 core/workflow/readiness.js
 export {
+  parseDepRef,
+  formatDepRef,
   normalizeBlockBy,
   isReadyToClaim,
   findFirstReadyPending,

package/src/modules/localtask/index.js

@@ -203,8 +203,14 @@ export default {
         key: KEY,
         text: { type: 'string', hint: '修改后的任务正文（Markdown）；不给则只重开不改内容' },
       },
-      run: (ctx) => service.reopenTask({ id: ctx.id, cwd: ctx.cwd, key: ctx.key, text: ctx.text }),
-      render: (d) => `已重开任务 #${d.id} @ ${d.name}（回到待领取，第 ${d.task.reopenCount} 次重开）`,
+      run: async (ctx) => {
+        // 重开也可能带着改过的归属（--text 的 frontmatter.project 变了）→ 同样搬家
+        const { reopenTask } = await import('../tasktool/update.js');
+        return reopenTask({ id: ctx.id, cwd: ctx.cwd, key: ctx.key, text: ctx.text });
+      },
+      render: (d) =>
+        `已重开任务 #${d.id} @ ${d.name}（回到待领取，第 ${d.task.reopenCount} 次重开）` +
+        (d.moved && d.movedFrom ? `；已改归属项目，原 ${d.movedFrom.name} #${d.movedFrom.id}` : ''),
     },
     {
       // 完成门禁：带时间目标的任务未到点拒绝标记完成（提示派 sub agent 重提需求）。
@@ -314,10 +320,11 @@ export default {
         // CLI、HTTP、面板提交同走这一条链路。
         const { submitTask } = await import('../tasktool/add.js');
         const rawBlock = ctx.blockBy ?? ctx['block-by'];
-        const blockBy = String(rawBlock || '')
-          .split(/[,，\s]+/)
-          .map((s) => Number(s))
-          .filter((n) => Number.isFinite(n) && n > 0);
+        // 支持本地 id 与跨队列 "topicKey:id"（组编排边）；空 → undefined
+        const { normalizeBlockBy } = await import('./dag.js');
+        const blockBy = rawBlock != null && String(rawBlock).trim()
+          ? normalizeBlockBy(String(rawBlock), 0)
+          : [];
         return submitTask({
           text: ctx.text,
           cwd: ctx.cwd,
@@ -355,7 +362,7 @@ export default {
         clearBlockBy: { type: 'boolean', hint: '同 --clear-block-by' },
         gate: { type: 'boolean', hint: '设/清闸门（true=挡住后续；false=取消闸门）' },
       },
-      run: (ctx) => {
+      run: async (ctx) => {
         const gp = ctx.goalPrompt ?? ctx['goal-prompt'];
         const cg = ctx.clearGoal ?? ctx['clear-goal'];
         const hasGoalInput = ctx.duration != null || gp != null || cg;
@@ -363,12 +370,17 @@ export default {
         const clearBlockBy = !!(ctx.clearBlockBy ?? ctx['clear-block-by']);
         let blockBy;
         if (!clearBlockBy && rawBlock !== undefined) {
-          blockBy = String(rawBlock || '')
-            .split(/[,，\s]+/)
-            .map((s) => Number(s))
-            .filter((n) => Number.isFinite(n) && n > 0);
+          // 本地 id + "topicKey:id"；数组 body（面板）与逗号串都走 normalizeBlockBy
+          const { normalizeBlockBy } = await import('./dag.js');
+          blockBy = normalizeBlockBy(
+            Array.isArray(rawBlock) ? rawBlock : String(rawBlock || ''),
+            ctx.id,
+          );
         }
-        return service.updateTask({
+        // 改归属即搬家（任务 #43）：正文 effective project 变了 → 任务迁到新项目的队列。
+        // 编排在 tasktool/update.js，与派任务（tasktool/add.js）同一套落点判定。
+        const { updateTask: editTask } = await import('../tasktool/update.js');
+        return editTask({
           id: ctx.id,
           text: ctx.text,
           cwd: ctx.cwd,
@@ -380,7 +392,11 @@ export default {
         });
       },
       render: (d) =>
-        `已更新主题「${d.name}」#${d.task.id}: ${d.task.text}` +
+        (d.moved
+          ? `已改归属项目：迁到主题「${d.name}」#${d.task.id}` +
+            (d.movedFrom ? `（原 ${d.movedFrom.name} #${d.movedFrom.id}）` : '')
+          : `已更新主题「${d.name}」#${d.task.id}`) +
+        `: ${d.task.text}` +
         (d.goalChanged === 'set'
           ? `（时间目标：${d.task.timegoal.duration}${d.task.timegoal.prompt ? ' · 附加要求已固化' : ''}）`
           : d.goalChanged === 'cleared'
@@ -553,10 +569,27 @@ export default {
           type: 'string',
           hint: 'ack 完成总结提示词（agent 完成任务时写完成总结的格式要求；随领取交付的 instruction 给到 agent）。占位符同 --suffix；传空 = 关闭。设置面板「提示词 / 模板」一栏也能配',
         },
+        // **整体替换**多条列表（面板「提示词 / 模板」一栏用这个保存；服务层本就吃列表，
+        // 但此前 action 只暴露单条 flag → 面板保存 400 且静默无效，2026-11-04 #41 实测发现）。
+        'suffix-list': { type: 'array', hint: '整体替换收尾指令列表（多条，一项一条）' },
+        suffixList: { type: 'array', hint: '同 --suffix-list（驼峰写法，HTTP body 用）' },
+        'ack-list': { type: 'array', hint: '整体替换 ack 完成总结提示词列表（多条）' },
+        ackList: { type: 'array', hint: '同 --ack-list（驼峰写法，HTTP body 用）' },
       },
       run: async (ctx) => {
         const patch = { timeoutSec: ctx.timeout };
         if (ctx.ack !== undefined) patch.ackPrompt = ctx.ack;
+        const suffixList = ctx.suffixList ?? ctx['suffix-list'];
+        const ackList = ctx.ackList ?? ctx['ack-list'];
+        if (suffixList !== undefined || ackList !== undefined) {
+          if (ctx.suffix !== undefined || ctx['no-suffix'] || ctx['reset-suffix']
+            || ctx['suffix-add'] !== undefined || ctx['suffix-remove'] !== undefined) {
+            throw badInput('--suffix-list 不能与 --suffix / --no-suffix / --reset-suffix / --suffix-add / --suffix-remove 同用');
+          }
+          if (ctx.ack !== undefined) throw badInput('--ack-list 不能与 --ack 同用');
+          if (suffixList !== undefined) patch.taskSuffix = suffixList;
+          if (ackList !== undefined) patch.ackPrompt = ackList;
+        }
         const add = ctx['suffix-add'];
         const removeN = ctx['suffix-remove'];
         if (add !== undefined || removeN !== undefined) {