nx-kv 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 本文件记录对外可见的变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
 
+## [0.3.2] - 2026-10-08
+
+### Fixed
+
+- **实时任务弹窗：agent 领取（回填 delivered）后不再显示倒计时**。此前弹窗在
+  agent 已取走任务后，状态栏的倒计时仍继续走到 0；现 agent 一旦领取即隐藏整个
+  倒计时状态条（倒计时只在「等待回填」时有意义），计时器同步停止。常驻面板主题
+  卡本就仅在等待中显示倒计时、领取后显示「已结束」，行为一致。
+
+## [0.3.1] - 2026-10-08
+
+### Changed
+
+- **实时任务（sessiontask）主题改按「工作目录名」识别**：主题 key 取 cwd 的
+  目录名（basename，如 `br_ct`）——在该目录执行 CLI 即自动领取对应队列的一条
+  任务；同名目录（即使完整路径不同）共用同一队列，不同目录互不串。
+- **主题拥有可堆积的任务队列**：同一主题下的回填按队列堆积、逐条领取；现状
+  （`--summary`）不再是 key，仅作状态展示。替代 0.3.0「现状总结即等待点 key」
+  的 slots 模型，旧数据自动迁移为主题。
+
+### Added
+
+- **阻塞超时支持在 Web 页面配置**：「实时任务」页顶部新增超时选择，默认/推荐
+  **180 秒（3 分钟）**、上限 **600 秒（10 分钟）**，超上限自动截断；`wait`
+  未带 `--timeout` 时采用该配置。新增 `sessiontask config --timeout <秒>`。
+- 放宽单条任务内容与现状长度上限（任务 20000 字、现状 2000 字）。
+
 ## [0.3.0] - 2026-10-06
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-kv",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "nx-kv — KV 清单管理中枢 + 对话内实时任务接力：serve 驱动 CLI 与 Web 面板，同源同构，附带可安装 skill 供 agent 领取任务与阻塞接收用户输入",
   "type": "module",
   "bin": {

package/src/modules/sessiontask/index.js

@@ -2,28 +2,32 @@
 //
 // 声明了 `resource: 'sessiontask'`，故 CRUD 五操作齐备且两端可调用
 // （tests/unit/registry.test.mjs 据此断言）。核心动作是纯 CLI 的
-// `sessiontask wait --summary "<现状总结>"`——agent 把它放在本轮**最后一步**
-// 调用：阻塞、自动打开浏览器弹窗，用户针对该现状回填后解除阻塞，把新任务返回给
-// agent。现状总结即等待点 key：相同现状复用、不同现状分散答复。
+// `sessiontask wait --cwd "<工作目录>" --summary "<当前现状>"`——agent 把它放在本轮
+// **最后一步**调用：阻塞、自动打开浏览器弹窗，用户回填后解除阻塞，把新任务返回给
+// agent。工作目录即主题、主题拥有任务队列：同目录共用队列、不同目录互不串，任务可
+// 在主题队列里堆积。
 //
 // 与 todo 的区别：todo 管 KV 后端上的清单（需登录）；sessiontask 是**本机**
 // 实时人机接力，数据存本地文件，不依赖后端登录态。
 import * as service from './service.js';
 
-const SUMMARY = { type: 'string', required: true, hint: '当前现状总结（作为等待点 key）' };
+const CWD = { type: 'string', hint: '工作目录（作为主题；默认当前目录）' };
+const SUMMARY = { type: 'string', required: true, hint: '当前现状（agent 当前状态，展示给用户）' };
 
 const STATUS_TAG = { pending: '待领取', consumed: '已领取' };
 
-// 总览：每个等待点一行，先看现状再决定回填哪条
+// 总览：每个主题（工作目录）一行，先看目录与现状再决定回填哪条
 function renderOverview(d) {
-  const lines = [`等待点 ${d.slots.length} 个（等待中 ${d.waiting}）`];
-  if (!d.slots.length) {
-    lines.push('（暂无等待点）');
+  const lines = [`主题 ${d.topics.length} 个（等待中 ${d.waiting} · 默认超时 ${d.settings.timeoutSec}s）`];
+  if (!d.topics.length) {
+    lines.push('（暂无主题）');
     return lines.join('\n');
   }
-  for (const s of d.slots) {
-    const tag = s.waiting ? '[等待中]' : '[已结束]';
-    lines.push(`  ${tag} ${s.summary}  · 待领取 ${s.pending}/${s.total}`);
+  for (const t of d.topics) {
+    const tag = t.waiting ? '[等待中]' : '[已结束]';
+    const head = t.cwd ? `${t.name}  ${t.cwd}` : t.name;
+    lines.push(`  ${tag} ${head}  · 待领取 ${t.pending}/${t.total}`);
+    if (t.summary) lines.push(`        现状: ${t.summary}`);
   }
   return lines.join('\n');
 }
@@ -40,17 +44,20 @@ const renderTask = (t) =>
 function renderAdd(d) {
   const head = `#${d.task.id} [${d.task.status}] ${d.task.text}`;
   return d.delivered
-    ? `已实时回填给等待中的 agent: ${head}`
-    : `已排队（agent 下一次 wait 取走）: ${head}`;
+    ? `已实时回填给等待中的 agent（主题 ${d.name}）: ${head}`
+    : `已排入主题「${d.name}」队列（agent 下一次 wait 取走）: ${head}`;
 }
 
 // wait 的人读输出：成功给任务，超时明确提示「本轮结束」
 function renderWait(r) {
   if (r.status === 'timeout') {
-    return `等待超时（${Math.round(r.timeoutMs / 1000)} 秒未回填）：现状「${r.summary}」结束本轮。`;
+    return `等待超时（${Math.round(r.timeoutMs / 1000)} 秒未回填）：主题「${r.cwd}」现状「${r.summary}」结束本轮。`;
   }
   const origin = r.queued ? '排队任务' : '实时回填';
-  return `已取得下一条任务（${origin} · 现状「${r.summary}」）: #${r.task.id}\n  ${r.task.text.replace(/\n/g, '\n  ')}`;
+  return (
+    `已取得下一条任务（${origin} · 主题「${r.cwd}」现状「${r.summary}」）: #${r.task.id}\n` +
+    `  ${r.task.text.replace(/\n/g, '\n  ')}`
+  );
 }
 
 export default {
@@ -59,7 +66,7 @@ export default {
   order: 20,
   view: () => import('./view.jsx'),
 
-  // CRUD 资源声明：等待点任务的增删查改齐备，CLI 与面板都能调用
+  // CRUD 资源声明：主题任务的增删查改齐备，CLI 与面板都能调用
   resource: 'sessiontask',
 
   actions: [
@@ -68,7 +75,7 @@ export default {
       id: 'sessiontask.list',
       cli: ['sessiontask', 'list'],
       http: ['GET', '/api/sessiontasks'],
-      summary: '总览全部等待点（现状、是否等待中、待领取数）',
+      summary: '总览全部主题（工作目录、现状、是否等待中、待领取数）',
       run: () => service.listTasks(),
       render: renderOverview,
     },
@@ -76,42 +83,52 @@ export default {
       id: 'sessiontask.get',
       cli: ['sessiontask', 'get'],
       http: ['GET', '/api/sessiontasks/item'],
-      summary: '查看单条任务（按 --id，定位到 --summary 现状）',
-      flags: { id: { type: 'number', required: true, hint: '任务编号' }, summary: SUMMARY },
-      run: (ctx) => service.getTask({ id: ctx.id, summary: ctx.summary }),
+      summary: '查看单条任务（按 --id，定位到 --cwd 主题）',
+      flags: { id: { type: 'number', required: true, hint: '任务编号' }, cwd: CWD },
+      run: (ctx) => service.getTask({ id: ctx.id, cwd: ctx.cwd }),
       render: renderTask,
     },
     {
       id: 'sessiontask.add',
       cli: ['sessiontask', 'add'],
       http: ['POST', '/api/sessiontasks'],
-      summary: '针对某现状回填一条任务（有 wait 在等则即时投递，否则排队）',
+      summary: '向某主题（工作目录）的队列回填一条任务（有 wait 在等则即时投递，否则排队）',
       args: ['text'],
-      flags: { summary: SUMMARY },
-      run: (ctx) => service.addTask({ text: ctx.text, summary: ctx.summary }),
+      flags: { cwd: CWD, summary: { type: 'string', hint: '顺带刷新该主题的当前现状（可选）' } },
+      run: (ctx) => service.addTask({ text: ctx.text, cwd: ctx.cwd, summary: ctx.summary }),
       render: renderAdd,
     },
     {
       id: 'sessiontask.update',
       cli: ['sessiontask', 'update'],
       http: ['PATCH', '/api/sessiontasks/item'],
-      summary: '编辑任务内容（按 --id，定位到 --summary 现状）',
+      summary: '编辑任务内容（按 --id，定位到 --cwd 主题）',
       flags: {
         id: { type: 'number', required: true, hint: '任务编号' },
         text: { type: 'string', required: true, hint: '改成这个内容' },
-        summary: SUMMARY,
+        cwd: CWD,
       },
-      run: (ctx) => service.updateTask({ id: ctx.id, text: ctx.text, summary: ctx.summary }),
-      render: (d) => `已更新 #${d.task.id}: ${d.task.text}`,
+      run: (ctx) => service.updateTask({ id: ctx.id, text: ctx.text, cwd: ctx.cwd }),
+      render: (d) => `已更新主题「${d.name}」#${d.task.id}: ${d.task.text}`,
     },
     {
       id: 'sessiontask.remove',
       cli: ['sessiontask', 'remove'],
       http: ['DELETE', '/api/sessiontasks/item'],
-      summary: '删除一条任务（按 --id，定位到 --summary 现状）',
-      flags: { id: { type: 'number', required: true, hint: '任务编号' }, summary: SUMMARY },
-      run: (ctx) => service.removeTask({ id: ctx.id, summary: ctx.summary }),
-      render: (d) => `已删除 #${d.removed.id}: ${d.removed.text}`,
+      summary: '删除一条任务（按 --id，定位到 --cwd 主题）',
+      flags: { id: { type: 'number', required: true, hint: '任务编号' }, cwd: CWD },
+      run: (ctx) => service.removeTask({ id: ctx.id, cwd: ctx.cwd }),
+      render: (d) => `已删除主题「${d.name}」#${d.removed.id}: ${d.removed.text}`,
+    },
+
+    {
+      id: 'sessiontask.config',
+      cli: ['sessiontask', 'config'],
+      http: ['PATCH', '/api/sessiontasks/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}）`,
     },
 
     // ─── 阻塞等待（纯 CLI，agent 本轮最后一步）────────────────
@@ -119,16 +136,18 @@ export default {
       id: 'sessiontask.wait',
       cli: ['sessiontask', 'wait'],
       http: null,
-      summary: '针对当前现状阻塞等待用户回填（默认 120 秒，超时结束本轮）',
+      summary: '针对某主题（按 cwd 目录名识别）阻塞等待用户回填（默认 3 分钟，最大 10 分钟）',
       flags: {
+        cwd: CWD,
         summary: SUMMARY,
-        timeout: { type: 'number', default: 120, hint: '阻塞上限（秒），默认 120' },
+        timeout: { type: 'number', hint: '阻塞上限（秒）；缺省用页面配置（推荐 180，最大 600）' },
         'no-open': { type: 'boolean', hint: '不自动打开浏览器（测试用）' },
       },
       run: (ctx) =>
         service.waitForTask({
+          cwd: ctx.cwd,
           summary: ctx.summary,
-          timeoutMs: ctx.timeout * 1000,
+          timeoutSec: ctx.timeout,
           open: !ctx['no-open'],
         }),
       render: renderWait,

package/src/modules/sessiontask/popup.js

@@ -3,7 +3,10 @@
 // 注意：本文件返回的是一整段 HTML 字符串，内联 <script> 刻意只用单/双引号与
 // 字符串拼接（不用模板字符串、不用 ${}），以免与外层模板串冲突；内联脚本里
 // 出现的反斜杠在此外层模板中需双写（如换行正则写成 /\\n/g）。
-export function renderPopupPage({ key, summary, timeoutMs }) {
+import { basename } from 'node:path';
+
+export function renderPopupPage({ key, cwd, summary, timeoutMs }) {
+  const name = (cwd && basename(cwd)) || '';
   return `<!doctype html>
 <html lang="zh-CN">
 <head>
@@ -36,6 +39,14 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
   .meta { margin-left: auto; color: var(--mid); font-family: ui-monospace, Consolas, monospace; font-size: 11.5px; }
   .meta .pill { background: var(--soft-2); border-radius: 5px; padding: 1px 7px; color: var(--ink); }
 
+  .topic {
+    background: var(--paper); border-radius: var(--radius); box-shadow: var(--shadow);
+    padding: 10px 14px; margin-bottom: 10px;
+  }
+  .topic .topic-label { font-size: 11px; color: var(--mid); letter-spacing: 1px; margin-bottom: 3px; }
+  .topic .topic-name { font-size: 14px; font-weight: 800; }
+  .topic .topic-cwd { font-family: ui-monospace, Consolas, monospace; font-size: 11.5px; color: var(--mid); word-break: break-all; margin-top: 2px; }
+
   .state {
     background: var(--paper); border-radius: var(--radius); box-shadow: var(--shadow);
     border-left: 3px solid var(--ink); padding: 11px 14px; margin-bottom: 12px;
@@ -101,12 +112,18 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
     <div class="meta"><span class="pill">回填后立即返回 agent</span></div>
   </div>
 
+  <div class="topic">
+    <div class="topic-label">主题（工作目录）</div>
+    <div class="topic-name" id="topicName"></div>
+    <div class="topic-cwd" id="topicCwd"></div>
+  </div>
+
   <div class="state">
     <div class="state-label">当前现状</div>
     <div class="state-text" id="summary"></div>
   </div>
 
-  <div class="statusbar">
+  <div class="statusbar" id="statusbar">
     <span class="dot"></span>
     <span>agent 正在等待你针对上述现状回填 · 剩余</span>
     <span id="clock">--:--</span>
@@ -125,7 +142,7 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
   <div class="banner" id="banner"></div>
 
   <div class="card">
-    <div class="colhead"><h3>本现状的任务表</h3><span class="muted" id="count"></span></div>
+    <div class="colhead"><h3>本主题的任务队列</h3><span class="muted" id="count"></span></div>
     <table>
       <thead><tr><th style="width:54px">#</th><th>任务</th><th style="width:78px">状态</th><th style="width:150px">时间</th><th style="width:70px">操作</th></tr></thead>
       <tbody id="list"></tbody>
@@ -135,6 +152,8 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
 
 <script>
   var KEY = ${JSON.stringify(key)};
+  var CWD = ${JSON.stringify(cwd || '')};
+  var TOPIC_NAME = ${JSON.stringify(name || '')};
   var SUMMARY = ${JSON.stringify(summary)};
   var TIMEOUT_MS = ${JSON.stringify(timeoutMs)};
   var delivered = false;
@@ -152,9 +171,12 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
     return (m < 10 ? '0' + m : m) + ':' + (s < 10 ? '0' + s : s);
   }
 
+  el('topicName').textContent = TOPIC_NAME || '（未命名）';
+  el('topicCwd').textContent = CWD || '（旧数据，无目录）';
   el('summary').textContent = SUMMARY;
   var deadline = Date.now() + TIMEOUT_MS;
   function tickClock() {
+    if (delivered) return;
     var left = deadline - Date.now();
     el('clock').textContent = fmtClock(left);
     if (left <= 0 && !delivered) showBanner('等待已结束（超时未回填），本窗口可关闭。', true);
@@ -168,9 +190,9 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
     b.className = 'banner show ' + (bad ? 'bad' : 'good');
   }
 
-  function render(slot) {
-    el('count').textContent = '待领取 ' + slot.pending + ' · 共 ' + slot.tasks.length;
-    var tasks = slot.tasks.slice().reverse();
+  function render(topic) {
+    el('count').textContent = '待领取 ' + topic.pending + ' · 共 ' + topic.tasks.length;
+    var tasks = topic.tasks.slice().reverse();
     var rows = '';
     if (!tasks.length) {
       rows = '<tr><td colspan="5" class="muted empty">（暂无任务，在上方回填第一条）</td></tr>';
@@ -181,7 +203,7 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
         ? '<span class="tag strong">已领取</span>'
         : '<span class="tag">待领取</span>';
       var body = esc(t.text).replace(/\\n/g, '<br>');
-      rows += '<tr><td class="mono">#' + t.id + '</td><td class="text">' + body + '</td><td>' + status +
+      rows += '<tr><td class="mono">#' + t.id + '</td><td class="text">' + body + '<\/td><td>' + status +
         '</td><td class="mono time">' + esc(t.consumedAt || t.createdAt || '') +
         '</td><td class="ops"><button class="btn small ghost" data-id="' + t.id + '">删除</button></td></tr>';
     }
@@ -194,11 +216,11 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
       .then(function (r) { return r.json(); })
       .then(function (j) {
         if (!j.ok) return;
-        var slot = null;
-        for (var i = 0; i < j.data.slots.length; i++) {
-          if (j.data.slots[i].key === KEY) { slot = j.data.slots[i]; break; }
+        var topic = null;
+        for (var i = 0; i < j.data.topics.length; i++) {
+          if (j.data.topics[i].key === KEY) { topic = j.data.topics[i]; break; }
         }
-        if (slot) render(slot);
+        if (topic) render(topic);
       })
       .catch(function () { /* 交付后服务器关闭，静默 */ });
   }
@@ -221,9 +243,11 @@ export function renderPopupPage({ key, summary, timeoutMs }) {
           delivered = true;
           showBanner('已回填给 agent，正在返回，本窗口可关闭。', false);
           el('composer').style.opacity = '0.5';
+          // agent 已领取：不再显示倒计时（倒计时只在「等待回填」时有意义）
+          el('statusbar').style.display = 'none';
           refresh();
         } else {
-          showBanner('已排队，agent 下一次 wait 会取走。', false);
+          showBanner('已排入主题队列，agent 下一次 wait 会取走。', false);
           refresh();
         }
       })