nx-kv 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 本文件记录对外可见的变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
 
+## [0.8.2] - 2026-10-12
+
+### Added
+
+- **实时任务 wait 返回任务时自动追加「收尾提醒」（可配置，默认开启）**，防止 agent 在长对话里
+  漂移、偶尔忘记最后再 wait 一次：
+  - wait 交付任务时在 `task.text` 末尾拼接一段固定提醒（默认大意：规划计划、完成本任务，
+    计划的最后一个动作是再次调用 `nx-kv localtask wait` 收尾本轮，拿到下一条或超时前不要提前结束）。
+  - 只作用于**返回给 agent 的载荷**，面板/库存里的任务原文保持干净、不被改写；原文已包含同样
+    追加语时幂等不重复追加。
+  - 可在「本地任务」页配置（编辑、保存、恢复默认、一键关闭），CLI/HTTP：
+    `localtask config --suffix "<文案>"`、`--no-suffix` 关闭、`--reset-suffix` 恢复默认
+    （HTTP `PATCH` 传 `"suffix": ""` 关闭）；
+    `PATCH /api/localtasks/setting` 增 `suffix` 字段，设置视图增 `taskSuffix`/`defaultTaskSuffix`/`suffixEnabled`。
+
+### Fixed
+
+- `loadStore` 重建 settings 时只保留 `timeoutSec`、把 `taskSuffix` 字段丢掉，导致
+  第一次 PATCH 关闭后第二次 PATCH 改超时，taskSuffix 会被默认值覆盖（仅 0.8.1 受影响）。
+
 ## [0.8.1] - 2026-10-12
 
 ### Added

package/package.json

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

package/src/modules/localtask/index.js

@@ -181,10 +181,24 @@ export default {
       id: 'localtask.config',
       cli: ['localtask', 'config'],
       http: ['PATCH', '/api/localtasks/setting'],
-      summary: '配置等待超时（秒；推荐 180=3 分钟，最大 600=10 分钟，超上限自动截断）',
-      flags: { timeout: { type: 'number', required: true, hint: '超时秒数（1-600）' } },
-      run: (ctx) => service.updateSettings({ timeoutSec: ctx.timeout }),
-      render: (s) => `已配置等待超时 ${s.timeoutSec} 秒（推荐 ${s.recommendedSec}，最大 ${s.maxSec}）`,
+      summary: '配置等待超时（秒）/ 收尾追加语（task.text 末尾自动追加的固定指令；置空关闭）',
+      flags: {
+        timeout: { type: 'number', hint: '超时秒数（1-600）' },
+        suffix: { type: 'string', hint: '收尾追加语文本（与 --reset-suffix/--no-suffix 互斥）' },
+        'reset-suffix': { type: 'boolean', hint: '恢复默认收尾追加语' },
+        'no-suffix': { type: 'boolean', hint: '清空并关闭收尾追加语' },
+      },
+      run: (ctx) => {
+        const patch = { timeoutSec: ctx.timeout };
+        if (ctx['no-suffix']) patch.taskSuffix = '';
+        else if (ctx['reset-suffix']) patch.taskSuffix = service.DEFAULT_TASK_SUFFIX;
+        else if (ctx.suffix !== undefined) patch.taskSuffix = ctx.suffix;
+        return service.updateSettings(patch);
+      },
+      render: (s) => {
+        const x = s.suffixEnabled ? '收尾追加语已开启' : '收尾追加语已关闭';
+        return `已配置等待超时 ${s.timeoutSec} 秒（推荐 ${s.recommendedSec}，最大 ${s.maxSec}）· ${x}`;
+      },
     },
 
     {

package/src/modules/localtask/service.js

@@ -37,6 +37,25 @@ export const MAX_TIMEOUT_SEC = 600; // 阻塞时长上限（10 分钟）
 export const MAX_SUMMARY = 2000; // 现状（状态）长度上限（原 200，已放宽）
 export const MAX_TEXT = 20_000; // 单条任务内容长度上限
 
+// wait 取任务返回时，在 task.text 末尾追加的「收尾指令」（可在面板/CLI 修改；置空关闭）。
+// 作用：从每一条任务层面反复强调「计划最后再 wait 一次」，避免 agent 在长对话里漂移、漏调。
+// 注意：命令名是 localtask 不是 sessiontask（v0.8.0 重命名后），但默认文案直接复用同一段文字。
+export const DEFAULT_TASK_SUFFIX =
+  '规划计划，然后完成这个任务；计划的最后一个动作，是再次调用 ' +
+  'nx-kv localtask wait（带上 --cwd 当前工作目录、--summary 当前现状、--json）收尾本轮，' +
+  '在拿到下一条任务或超时之前不要提前结束。';
+const MAX_SUFFIX_LEN = 500; // 收尾追加语长度上限
+
+// 归一化收尾追加语：缺省（旧 store 无此字段）→ 默认；显式传 ''（清空）→ '' 表示关闭。
+// 注意：与 timeoutSec 不同——timeoutSec 缺省→推荐值（仍开启），taskSuffix 缺省→默认文本。
+// 因此从老 store 读 settings.taskSuffix 时，clampTaskSuffix 会自动补默认；想"关闭"必须显式 ''。
+export function clampTaskSuffix(v) {
+  if (v === undefined || v === null) return DEFAULT_TASK_SUFFIX;
+  let s = String(v).trim();
+  if (s.length > MAX_SUFFIX_LEN) s = s.slice(0, MAX_SUFFIX_LEN);
+  return s;
+}
+
 // ─── 存储位置：可环境变量覆盖（测试隔离）；旧名/旧文件自动兼容 ──────────
 
 export function storePath() {
@@ -119,7 +138,11 @@ export function stampNow(d = new Date()) {
 // ─── 存储读写（原子写 + 损坏容忍 + v1/v2 迁移） ───────────────────
 
 function emptyStore() {
-  return { version: 4, settings: { timeoutSec: DEFAULT_TIMEOUT_SEC }, topics: {} };
+  return {
+    version: 4,
+    settings: { timeoutSec: DEFAULT_TIMEOUT_SEC, taskSuffix: DEFAULT_TASK_SUFFIX },
+    topics: {},
+  };
 }
 
 // 归一化超时秒数：非法/缺省 → 推荐值；超上限截断为 10 分钟
@@ -182,7 +205,14 @@ async function loadStore() {
   if (!topics) return emptyStore();
   return {
     version: 4,
-    settings: { timeoutSec: clampTimeoutSec(settings && settings.timeoutSec) },
+    settings: {
+      timeoutSec: clampTimeoutSec(settings && settings.timeoutSec),
+      // 旧 store 可能没存过 taskSuffix（v0.8.0 之前）；clampTaskSuffix 缺省→默认文本。
+      // 显式 ''（关闭）会保留——判断条件是「字段存在且非 undefined」，不能只看 falsy。
+      taskSuffix: settings && Object.prototype.hasOwnProperty.call(settings, 'taskSuffix')
+        ? clampTaskSuffix(settings.taskSuffix)
+        : DEFAULT_TASK_SUFFIX,
+    },
     topics,
   };
 }
@@ -358,6 +388,10 @@ function settingsView(s) {
     timeoutSec: clampTimeoutSec(s && s.timeoutSec),
     recommendedSec: DEFAULT_TIMEOUT_SEC,
     maxSec: MAX_TIMEOUT_SEC,
+    // wait 交付任务时追加到 task.text 末尾的收尾提醒；''=关闭；defaultTaskSuffix 供 UI 恢复默认
+    taskSuffix: clampTaskSuffix(s && s.taskSuffix),
+    defaultTaskSuffix: DEFAULT_TASK_SUFFIX,
+    suffixEnabled: !!clampTaskSuffix(s && s.taskSuffix),
   };
 }
 
@@ -402,14 +436,27 @@ export async function pruneTopics({ allFinished = false, dryRun = false } = {})
   return { status: 'ok', dryRun: !!dryRun, count: removed.length, removed };
 }
 
-// 配置等待超时（页面可调；推荐 180=3 分钟，最大 600=10 分钟，超上限自动截断）
-export async function updateSettings({ timeoutSec } = {}) {
-  const n = Number(timeoutSec);
-  if (!Number.isFinite(n) || n <= 0) {
-    throw badInput(`超时时间需为 1-${MAX_TIMEOUT_SEC} 秒（推荐 ${DEFAULT_TIMEOUT_SEC}）`);
+// 配置等待超时 / 任务收尾追加语（页面可调）。超时推荐 180=3 分钟、最大 600=10 分钟；
+// taskSuffix 为 wait 返回任务时追加到 task.text 末尾的固定指令，传 '' 关闭、不传保持不变。
+export async function updateSettings({ timeoutSec, taskSuffix } = {}) {
+  const hasTimeout = timeoutSec !== undefined && timeoutSec !== null;
+  const hasSuffix = taskSuffix !== undefined;
+  if (!hasTimeout && !hasSuffix) {
+    throw badInput(
+      '请至少指定一项：--timeout <秒>，或 --suffix "<收尾追加语>"（--no-suffix 关闭追加、--reset-suffix 恢复默认）'
+    );
   }
   const store = await loadStore();
-  store.settings = { timeoutSec: clampTimeoutSec(n) };
+  const next = { ...store.settings };
+  if (hasTimeout) {
+    const n = Number(timeoutSec);
+    if (!Number.isFinite(n) || n <= 0) {
+      throw badInput(`超时时间需为 1-${MAX_TIMEOUT_SEC} 秒（推荐 ${DEFAULT_TIMEOUT_SEC}）`);
+    }
+    next.timeoutSec = clampTimeoutSec(n);
+  }
+  if (hasSuffix) next.taskSuffix = clampTaskSuffix(taskSuffix);
+  store.settings = next;
   await saveStore(store);
   return settingsView(store.settings);
 }
@@ -628,6 +675,16 @@ export async function reorderTasks({ cwd: rawCwd, id, beforeId, afterId } = {})
 
 // ─── 阻塞等待：核心入口 ─────────────────────────────────────────────
 
+// 把收尾追加语拼到返回给 agent 的 task.text 末尾（只改返回载荷，绝不回写库存原文）。
+// suffix 为空 → 原样返回；已包含同样追加语（幂等）→ 不重复追加。
+function withTaskSuffix(task, suffix) {
+  const s = clampTaskSuffix(suffix);
+  if (!task || !s) return task;
+  const base = String(task.text || '');
+  if (base.includes(s)) return task;
+  return { ...task, text: `${base.replace(/\s+$/, '')}\n\n${s}` };
+}
+
 /**
  * 针对某主题（工作目录）等待用户回填下一条任务。
  * @param {string}  [cwd]     工作目录（主题按目录名识别）；缺省 → 进程当前 cwd
@@ -649,15 +706,19 @@ export async function waitForTask({
   const summary = normalizeSummary(rawSummary); // 现状必填
 
   // 超时：显式 --timeout（秒/毫秒）优先；否则用页面配置；统一夹到 1-600
+  const startStore = await loadStore();
   let sec;
   if (timeoutSec !== undefined && timeoutSec !== null) sec = timeoutSec;
   else if (timeoutMs !== undefined && timeoutMs !== null) sec = Number(timeoutMs) / 1000;
-  else sec = (await loadStore()).settings.timeoutSec;
+  else sec = startStore.settings.timeoutSec;
   const tmo = clampTimeoutSec(sec) * 1000;
+  const suffix = startStore.settings.taskSuffix; // 返回任务时追加的收尾指令（本轮固定）
 
   // 1. 主题队列已有 pending → 立即取走，不开窗、不阻塞；记录本轮完成总结
   const queued = await consumeFirstPending(key, summary);
-  if (queued) return { status: 'ok', key, cwd, name, summary, task: queued, queued: true };
+  if (queued) {
+    return { status: 'ok', key, cwd, name, summary, task: withTaskSuffix(queued, suffix), queued: true };
+  }
 
   // 2. 没有 pending → 起内嵌弹窗服务器
   const server = await startPopupServer(key, cwd, summary, tmo);
@@ -722,7 +783,7 @@ export async function waitForTask({
         ? { status: 'timeout', key, cwd, summary, timeoutMs: tmo }
         : r.kind === 'cancelled'
         ? { status: 'timeout', key, cwd, summary, timeoutMs: tmo, cancelled: true }
-        : { status: 'ok', key, cwd, name, summary, task: r.task, delivered: r.delivered, queued: false };
+        : { status: 'ok', key, cwd, name, summary, task: withTaskSuffix(r.task, suffix), delivered: r.delivered, queued: false };
   } finally {
     clearInterval(poll);
     clearInterval(cancelPoll);

package/src/modules/localtask/view.jsx

@@ -47,6 +47,13 @@ export default function SessionTaskView() {
   const [timeoutSec, setTimeoutSec] = useState(180);
   const [cfgSaving, setCfgSaving] = useState(false);
   const [pruning, setPruning] = useState(false);
+  // 收尾追加语：task.text 末尾自动追加的固定指令（强制 agent 计划最后再 wait 一次）
+  const [taskSuffix, setTaskSuffix] = useState('');
+  const [defaultTaskSuffix, setDefaultTaskSuffix] = useState('');
+  const [suffixEnabled, setSuffixEnabled] = useState(false);
+  const [suffixEditing, setSuffixEditing] = useState(false);
+  const [suffixDraft, setSuffixDraft] = useState('');
+  const [suffixSaving, setSuffixSaving] = useState(false);
   const [editingId, setEditingId] = useState(null);
   const [editText, setEditText] = useState('');
   const [editSaving, setEditSaving] = useState(false);
@@ -82,7 +89,12 @@ export default function SessionTaskView() {
 
   // 同步页面上的超时配置（来源：后端 settings）
   useEffect(() => {
-    if (overview && overview.settings) setTimeoutSec(overview.settings.timeoutSec);
+    if (overview && overview.settings) {
+      setTimeoutSec(overview.settings.timeoutSec);
+      setTaskSuffix(overview.settings.taskSuffix || '');
+      setDefaultTaskSuffix(overview.settings.defaultTaskSuffix || '');
+      setSuffixEnabled(!!overview.settings.suffixEnabled);
+    }
   }, [overview]);
 
   const saveTimeout = (sec) =>
@@ -101,6 +113,30 @@ export default function SessionTaskView() {
       }
     });
 
+  // 收尾追加语：保存（draft 是 '' 等价于关闭；非空则启用）
+  const saveSuffix = (text) =>
+    guard(async () => {
+      setSuffixSaving(true);
+      try {
+        const s = await api('/api/localtasks/setting', {
+          method: 'PATCH',
+          body: { suffix: text },
+        });
+        setTaskSuffix(s.taskSuffix);
+        setSuffixEnabled(!!s.suffixEnabled);
+        setSuffixEditing(false);
+        setSuffixDraft('');
+        toast(s.suffixEnabled ? '收尾追加语已更新' : '收尾追加语已关闭');
+        await load();
+      } finally {
+        setSuffixSaving(false);
+      }
+    });
+
+  // 显式关闭（不进入编辑，直接 PATCH suffix=''）
+  const disableSuffix = () =>
+    saveSuffix('');
+
   // 清理旧脏数据（旧模型无目录主题、空主题；等待中保留）
   const prune = () =>
     guard(async () => {
@@ -359,6 +395,96 @@ export default function SessionTaskView() {
         </span>
       </div>
 
+      <div className="card" style={{ padding: '10px 14px' }}>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 12, flexWrap: 'wrap', marginBottom: suffixEditing ? 10 : 0 }}>
+          <span style={{ fontWeight: 700 }}>收尾追加语</span>
+          <span className="muted" style={{ fontSize: 12 }}>
+            每次 wait 返回任务时，自动拼到 task.text 末尾。强制 agent 计划最后再 wait 一次，避免长对话漂移漏调。
+          </span>
+          <span style={{ marginLeft: 'auto', display: 'flex', gap: 8, alignItems: 'center' }}>
+            <span className={'tag' + (suffixEnabled ? '' : ' muted')} style={{ fontSize: 11 }}>
+              {suffixEnabled ? '已开启' : '已关闭'}
+            </span>
+            {!suffixEditing && (
+              <>
+                {suffixEnabled && (
+                  <button className="btn small ghost" onClick={() => { setSuffixDraft(taskSuffix); setSuffixEditing(true); }}>
+                    编辑
+                  </button>
+                )}
+                {suffixEnabled ? (
+                  <button
+                    className="btn small ghost"
+                    onClick={() => disableSuffix()}
+                    disabled={suffixSaving}
+                    title="关闭后，wait 返回的任务不再追加提示词"
+                  >
+                    关闭
+                  </button>
+                ) : (
+                  <button
+                    className="btn small"
+                    onClick={() => { setSuffixDraft(defaultTaskSuffix); setSuffixEditing(true); }}
+                    title="恢复默认收尾追加语并开启"
+                  >
+                    开启
+                  </button>
+                )}
+              </>
+            )}
+          </span>
+        </div>
+        {!suffixEditing && taskSuffix && (
+          <div
+            className="muted"
+            style={{ fontSize: 12, whiteSpace: 'pre-wrap', borderLeft: '2px solid #eee', padding: '4px 0 4px 10px' }}
+          >
+            {taskSuffix}
+          </div>
+        )}
+        {suffixEditing && (
+          <div>
+            <textarea
+              value={suffixDraft}
+              onChange={(e) => setSuffixDraft(e.target.value)}
+              rows={5}
+              style={{ width: '100%', font: 'inherit', padding: 8, boxSizing: 'border-box' }}
+              placeholder="（留空 = 关闭；非空 = 启用并以这段文本作为追加语）"
+            />
+            <div style={{ display: 'flex', gap: 8, marginTop: 8, alignItems: 'center', flexWrap: 'wrap' }}>
+              <button
+                className="btn small"
+                onClick={() => saveSuffix(suffixDraft)}
+                disabled={suffixSaving}
+              >
+                保存
+              </button>
+              <button
+                className="btn small ghost"
+                onClick={() => {
+                  setSuffixEditing(false);
+                  setSuffixDraft('');
+                }}
+                disabled={suffixSaving}
+              >
+                取消
+              </button>
+              <button
+                className="btn small ghost"
+                onClick={() => saveSuffix(defaultTaskSuffix)}
+                disabled={suffixSaving}
+                title="覆盖为默认文案并开启"
+              >
+                恢复默认
+              </button>
+              <span className="muted" style={{ fontSize: 11, marginLeft: 'auto' }}>
+                留空保存 = 关闭
+              </span>
+            </div>
+          </div>
+        )}
+      </div>
+
       <div className="colhead">
         <input
           type="checkbox"

package/src/web/public/assets/{CliHints-B0Qwrf-6.js → CliHints-DNK3TaU5.js}

@@ -1 +1 @@
-import{o as e,s as t,t as n}from"./index-D0ldg3Y8.js";var r=t();function i({module:t}){let{boot:i}=e(),a=(i?.commands||[]).filter(e=>e.module===t);return a.length?(0,r.jsxs)(`div`,{className:`cli-hint`,children:[(0,r.jsx)(`span`,{className:`cli-hint-label`,children:`CLI 等价（同构命令，加 --json 得机器可读输出）：`}),a.map(e=>(0,r.jsx)(n,{className:`cli-cmd`,text:e.command,title:`点击复制：${e.usage}`,children:e.command},e.id))]}):null}export{i as t};
+import{o as e,s as t,t as n}from"./index-Iz1qH6TC.js";var r=t();function i({module:t}){let{boot:i}=e(),a=(i?.commands||[]).filter(e=>e.module===t);return a.length?(0,r.jsxs)(`div`,{className:`cli-hint`,children:[(0,r.jsx)(`span`,{className:`cli-hint-label`,children:`CLI 等价（同构命令，加 --json 得机器可读输出）：`}),a.map(e=>(0,r.jsx)(n,{className:`cli-cmd`,text:e.command,title:`点击复制：${e.usage}`,children:e.command},e.id))]}):null}export{i as t};