weaver-work-cli 0.1.32 → 0.1.36

package/skills/weaver-e10-workflow/tools/todo-serve.cjs

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+/**
+ * todo-serve.cjs —— 待办汇总载荷的本地 GET 数据源（单进程多快照版，2026-10-29）。
+ *
+ * 设计：
+ *   一个常驻进程，按 token 路由到文件系统里的快照目录，进程数恒为 1、端口恒定。
+ *
+ *   ~/.weaver-work-cli/serve/
+ *   ├── current.json              # { pid, port, version, startedAt }
+ *   └── snapshots/<token>/todo.json
+ *
+ *   GET /s/<token>/todo.json     -> 该快照的三键数据
+ *   GET /todo.json?token=<token> -> 同上（兼容旧链接形态）
+ *   GET /health                  -> 存活信息与快照数
+ *
+ * 生命周期：
+ *   - 快照各自按目录 mtime 计空闲，超时即删（请求命中过期快照也会顺手删掉）。
+ *   - 所有快照都过期且全局无请求超过 idle 分钟 -> 进程退出并删 current.json。
+ *
+ * 为什么必须自己写这个服务（而不是 python -m http.server / http-server）：
+ *   https 页面取 http://127.0.0.1 会先发 OPTIONS 私有网络预检，
+ *   必须回 `Access-Control-Allow-Private-Network: true` 且回显 Origin，否则浏览器直接拦
+ *   （python 的 http.server 对 OPTIONS 直接 501）。
+ */
+const http = require('node:http');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+function parseArgs(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (!token.startsWith('--')) continue;
+    const key = token.slice(2);
+    const next = argv[i + 1];
+    if (next === undefined || next.startsWith('--')) out[key] = true;
+    else { out[key] = next; i += 1; }
+  }
+  return out;
+}
+
+/** 与服务端约定一致的版本号：客户端只复用同版本实例。 */
+const SERVE_VERSION = '3';
+
+const args = parseArgs(process.argv.slice(2));
+// 默认放系统临时目录：快照只有 30 分钟寿命，本就不该写进家目录；
+// 而且宿主沙箱对家目录的删除操作更严（unlink/rmdir 会被 EPERM 拦），临时目录不受影响。
+const root = path.resolve(String(
+  args.root && args.root !== true ? args.root : path.join(os.tmpdir(), 'weaver-work-cli-serve'),
+));
+const snapshotsDir = path.join(root, 'snapshots');
+const registryFile = path.join(root, 'current.json');
+const idleMinutes = Number(args.idle && args.idle !== true ? args.idle : 30);
+const port = args.port !== undefined && args.port !== true ? Number(args.port) : 0;
+const allowOrigin = args['allow-origin'] && args['allow-origin'] !== true ? String(args['allow-origin']) : '';
+
+// token 只允许十六进制，避免 `../` 之类的目录穿越
+const TOKEN_RE = /^[a-f0-9]{8,64}$/;
+const IDLE_MS = idleMinutes * 60000;
+
+fs.mkdirSync(snapshotsDir, { recursive: true });
+
+let hits = 0;
+let lastHit = Date.now();
+
+function touchDir(dir) {
+  try {
+    const now = new Date();
+    fs.utimesSync(dir, now, now);
+  } catch { /* 目录已被删，忽略 */ }
+}
+
+function dropSnapshot(dir) {
+  // 不用 rmSync(recursive)：宿主沙箱会拦后台进程的批量删除（EPERM），
+  // 逐文件 unlink 再 rmdir 可以通过；任一步失败都不影响「过期即 404」的安全性。
+  try {
+    for (const name of fs.readdirSync(dir)) {
+      try { fs.unlinkSync(path.join(dir, name)); } catch { /* 忽略 */ }
+    }
+    fs.rmdirSync(dir);
+  } catch { /* 忽略 */ }
+}
+
+/** 读一份快照；不存在或已过期都返回 404（过期的顺手清掉）。 */
+function readSnapshot(token) {
+  if (!TOKEN_RE.test(String(token || ''))) return { status: 400, error: 'invalid_token' };
+  const dir = path.join(snapshotsDir, token);
+  const file = path.join(dir, 'todo.json');
+  let mtime = 0;
+  try {
+    mtime = fs.statSync(dir).mtimeMs;
+  } catch {
+    return { status: 404, error: 'snapshot_not_found' };
+  }
+  if (Date.now() - mtime > IDLE_MS) {
+    dropSnapshot(dir);
+    return { status: 404, error: 'snapshot_expired' };
+  }
+  let body = '';
+  try {
+    body = fs.readFileSync(file, 'utf8');
+  } catch {
+    return { status: 404, error: 'snapshot_empty' };
+  }
+  touchDir(dir);
+  return { status: 200, body };
+}
+
+/** 清掉过期快照，返回仍在有效期内的数量。 */
+function sweepSnapshots() {
+  let names = [];
+  try {
+    names = fs.readdirSync(snapshotsDir);
+  } catch {
+    return 0;
+  }
+  let alive = 0;
+  for (const name of names) {
+    const dir = path.join(snapshotsDir, name);
+    let mtime = 0;
+    try {
+      mtime = fs.statSync(dir).mtimeMs;
+    } catch {
+      continue;
+    }
+    if (Date.now() - mtime > IDLE_MS) dropSnapshot(dir);
+    else alive += 1;
+  }
+  return alive;
+}
+
+function corsHeaders(req) {
+  const origin = allowOrigin || req.headers.origin || '*';
+  return {
+    'Access-Control-Allow-Origin': origin,
+    'Access-Control-Allow-Methods': 'GET, OPTIONS',
+    'Access-Control-Allow-Headers': req.headers['access-control-request-headers'] || '*',
+    'Access-Control-Allow-Private-Network': 'true',
+    'Access-Control-Max-Age': '600',
+    Vary: 'Origin',
+  };
+}
+
+function send(res, status, headers, body) {
+  res.writeHead(status, { ...headers, 'Content-Type': 'application/json; charset=utf-8' });
+  res.end(body);
+}
+
+const server = http.createServer((req, res) => {
+  lastHit = Date.now();
+  const url = new URL(req.url || '/', 'http://127.0.0.1');
+  const headers = corsHeaders(req);
+
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204, headers);
+    res.end();
+    return;
+  }
+  if (req.method !== 'GET') {
+    send(res, 405, headers, JSON.stringify({ ok: false, error: 'method_not_allowed' }));
+    return;
+  }
+  if (url.pathname === '/health') {
+    const alive = sweepSnapshots();
+    const address = server.address();
+    send(res, 200, { ...headers, 'Cache-Control': 'no-store' }, JSON.stringify({
+      ok: true,
+      version: SERVE_VERSION,
+      pid: process.pid,
+      port: address ? address.port : port,
+      snapshots: alive,
+      idleMinutes,
+      hits,
+    }));
+    return;
+  }
+
+  // 新形态 /s/<token>/todo.json，兼容旧形态 /todo.json?token=<token>
+  let token = '';
+  const matched = url.pathname.match(/^\/s\/([^/]+)\/todo\.json$/);
+  if (matched) token = matched[1];
+  else if (url.pathname === '/todo.json' || url.pathname === '/') token = url.searchParams.get('token') || '';
+
+  if (!token) {
+    send(res, 404, headers, JSON.stringify({ ok: false, error: 'not_found' }));
+    return;
+  }
+  const result = readSnapshot(token);
+  if (result.status !== 200) {
+    send(res, result.status, { ...headers, 'Cache-Control': 'no-store' }, JSON.stringify({ ok: false, error: result.error }));
+    return;
+  }
+  hits += 1;
+  send(res, 200, { ...headers, 'Cache-Control': 'no-store' }, result.body);
+});
+
+let retries = 0;
+server.on('error', (error) => {
+  if (error && error.code === 'EADDRINUSE' && retries < 10) {
+    retries += 1;
+    console.error('[todo-serve] 端口 %d 被占用，换下一个', port + retries);
+    server.listen(port + retries, '127.0.0.1');
+    return;
+  }
+  console.error('[todo-serve] 监听失败：%s', error && error.message);
+  cleanup(1);
+});
+
+server.listen(port, '127.0.0.1', () => {
+  const actualPort = server.address().port;
+  fs.writeFileSync(registryFile, JSON.stringify({
+    pid: process.pid,
+    port: actualPort,
+    version: SERVE_VERSION,
+    root,
+    startedAt: new Date().toISOString(),
+    idleMinutes,
+  }, null, 2));
+  console.log('[todo-serve] listening http://127.0.0.1:%d/s/<token>/todo.json｜空闲 %d 分钟自动退出｜pid=%d', actualPort, idleMinutes, process.pid);
+});
+
+function cleanup(code) {
+  try { fs.unlinkSync(registryFile); } catch { /* 已删 */ }
+  process.exit(code);
+}
+
+const sweeper = setInterval(() => {
+  const alive = sweepSnapshots();
+  if (alive > 0) return;
+  if (Date.now() - lastHit < IDLE_MS) return;
+  console.log('[todo-serve] 无快照且连续 %d 分钟无访问，退出', idleMinutes);
+  cleanup(0);
+}, 15000);
+sweeper.unref();
+
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => cleanup(0));
+}

package/skills/weaver-e10-workflow/{scripts → tools}/todo-summary.cjs

@@ -19,7 +19,42 @@ const { execFileSync } = require('node:child_process');
 const fs = require('node:fs');
 const path = require('node:path');
 
-const CLI = process.env.WEAVER_CLI || 'weaver-work-cli';
+/**
+ * CLI 可执行入口（跨平台）。
+ *
+ * - POSIX：直接跑 PATH 里的 `weaver-work-cli`；
+ * - Windows：npm 全局装出来的是 `weaver-work-cli.cmd`，**不能用 `execFile` 直接跑 `.cmd`**
+ *   （Node ≥ 18.20 / 20.12 起会拒绝，报 `EINVAL`；老版本则 `ENOENT`）——这是本脚本原先在
+ *   Windows 上第一步就崩的原因。所以优先定位包内的 `dist/index.js`，用当前 node 去跑；
+ *   实在找不到才退回 `.cmd`（此时必须 `shell:true`，参数里的引号会被 cmd 重新解释，仅作兜底）。
+ *
+ * `WEAVER_CLI` 环境变量优先级最高（值按原样当可执行文件用）。
+ */
+const CLI_LAUNCH = (() => {
+  const override = process.env.WEAVER_CLI;
+  if (override) return { file: override, prefix: [], shell: false };
+  if (process.platform !== 'win32') return { file: 'weaver-work-cli', prefix: [], shell: false };
+  const entry = path.join('node_modules', 'weaver-work-cli', 'dist', 'index.js');
+  const bases = [
+    process.env.APPDATA ? path.join(process.env.APPDATA, 'npm') : '',
+    path.dirname(process.execPath),
+    process.env.ProgramFiles ? path.join(process.env.ProgramFiles, 'nodejs') : '',
+    process.env['ProgramFiles(x86)'] ? path.join(process.env['ProgramFiles(x86)'], 'nodejs') : '',
+  ].filter(Boolean);
+  for (const base of bases) {
+    const candidate = path.join(base, entry);
+    if (fs.existsSync(candidate)) return { file: process.execPath, prefix: [candidate], shell: false };
+  }
+  return { file: 'weaver-work-cli.cmd', prefix: [], shell: true };
+})();
+
+/** 按平台拼好的入口调 CLI；其余选项由调用方给。 */
+function runCli(args, options) {
+  return execFileSync(CLI_LAUNCH.file, [...CLI_LAUNCH.prefix, ...args], {
+    shell: CLI_LAUNCH.shell,
+    ...options,
+  });
+}
 
 /**
  * 宿主（WorkBuddy）会给每个 node 子进程注入
@@ -59,7 +94,7 @@ function parseArgs(argv) {
 }
 
 function cli(args) {
-  const raw = execFileSync(CLI, ['--json', 'workflow', 'run', 'workflow.todoSmartConvert', ...args], {
+  const raw = runCli(['--json', 'workflow', 'run', 'workflow.todoSmartConvert', ...args], {
     encoding: 'utf8',
     maxBuffer: 512 * 1024 * 1024,
     env: cliEnv(),
@@ -110,8 +145,16 @@ function groupStats(wfIdGroup) {
     covered += subs.reduce((sum, x) => sum + x.count, 0);
     singles += one.length;
     for (const item of items) {
-      const summary = item.type === 'group' ? item.summary : item.requestData.summary;
-      if (!summary) empty += 1;
+      // 汇总项除了自身的组摘要，还要算它内部每条的单条摘要——否则「组内明细全空」会被漏报
+      // （2026-10-28 实测：223 条内部留言单条摘要全空，旧统计只报 84，实际 302）。
+      if (item.type === 'group') {
+        if (!item.summary) empty += 1;
+        for (const row of item.requestDatas || []) {
+          if (!row.summary) empty += 1;
+        }
+      } else if (!item.requestData.summary) {
+        empty += 1;
+      }
     }
     rows.push({
       title: group.title,
@@ -190,7 +233,7 @@ function resolveBaseUrl(state, dir) {
   if (state.baseUrl) return state.baseUrl;
   let baseUrl = '';
   try {
-    const raw = execFileSync(CLI, ['--json', 'auth', 'status'], {
+    const raw = runCli(['--json', 'auth', 'status'], {
       encoding: 'utf8',
       maxBuffer: 16 * 1024 * 1024,
       env: cliEnv(),
@@ -211,21 +254,26 @@ function resolveBaseUrl(state, dir) {
 
 /**
  * 把最终三键对象包成 browsertool 组件载荷（用户 2026-10-27 要求）。
+ * - 外框固定：`callId` 写死 `todo_summary`、`toolId` 写死 `fill_form`（2026-10-28 规范）；
  * - `params.data` 放三键本身；`src` = 当前认证环境 baseUrl + `/workflow/list/todo`；
  * - 数据段沿用调用方的紧凑文本（`requestData` 单行），只加缩进前缀、不重新序列化，
  *   避免几千行 requestData 被展开成 4 倍体积；
  * - 包裹完成后立刻 `JSON.parse` 自检，坏载荷不交给用户。
  */
-function wrapBrowseToolPayload(dataText, baseUrl) {
+function wrapBrowseToolPayload(dataText, baseUrl, dataSourceUrl) {
   const indentTail = (text, spaces) => text.split('\n')
     .map((line, index) => (index === 0 ? line : ' '.repeat(spaces) + line))
     .join('\n');
   const src = `${String(baseUrl).replace(/\/+$/, '')}/workflow/list/todo`;
+  // 用户 2026-10-28 定稿的载荷结构：数据源地址放在 `params.data.dataSource`（不是 `params.dataSource`）。
+  const paramsBody = dataSourceUrl
+    ? `        "data": {\n          "dataSource": ${JSON.stringify(dataSourceUrl)}\n        }`
+    : `        "data": ${indentTail(dataText, 8)}`;
   const text = [
     '{',
     '  "version": "1.0",',
-    '  "callId": "call-1",',
-    '  "toolId": "todo_summary",',
+    '  "callId": "todo_summary",',
+    '  "toolId": "fill_form",',
     '  "arguments": {',
     '    "type": "e10",',
     '    "title": "待办摘要汇总",',
@@ -239,7 +287,7 @@ function wrapBrowseToolPayload(dataText, baseUrl) {
     '      "params_pc": { "app": "@weapp/workflow", "compName": "Comp.WflTodoSummary", "clientType": "pc" },',
     '      "params_mobile": { "app": "@weapp/workflow", "compName": "Comp.WflTodoSummary", "clientType": "mobile" },',
     '      "params": {',
-    `        "data": ${indentTail(dataText, 8)}`,
+    paramsBody,
     '      }',
     '    }',
     '  }',
@@ -249,6 +297,129 @@ function wrapBrowseToolPayload(dataText, baseUrl) {
   return `${text}\n`;
 }
 
+/** 同步 sleep（跨平台，不启动子进程）：只在等服务写 serve.json 的这几百毫秒里用。 */
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+/**
+ * 发布一份快照到「单进程多快照」的本地数据源，返回带 token 的完整 URL（2026-10-29 方案 B）。
+ *
+ * - 进程恒为 1、端口恒定：`~/.weaver-work-cli/serve/current.json` 里记录 pid/port/version，
+ *   **只有 `/health` 探通且版本一致**才复用（只看 pid 存活会被 Windows 的 pid 复用骗到）；
+ * - 每份汇总 = 一个快照目录 `<root>/snapshots/<token>/todo.json`，旧链接在各自空闲期内继续可用；
+ * - 快照按目录 mtime 计空闲，超时由服务端自己删；进程在所有快照过期且无请求后才退出。
+ */
+const SERVE_ROOT = path.join(require('node:os').tmpdir(), 'weaver-work-cli-serve');
+const SERVE_VERSION = '3';
+
+/**
+ * 同步探一次本地数据源的 `/health`：通就返回解析后的 JSON，不通返回 null。
+ *
+ * 为什么不用 async `http.get`：`ensureServeServer` 整条调用链是**同步**的（端口要同步返回），
+ * 而 `Atomics.wait` 阻塞主线程后 http 回调永远排不上来。所以用一个极短的 node 子进程发这一发请求：
+ * env 走 `cliEnv()` 摘掉宿主 shim，实测子进程约 0.1~0.2s（不摘 shim 会到 4s）。
+ *
+ * 这一发探测解决两件事：
+ *   1. `current.json` 里的 pid 被系统复用给无关进程时，`process.kill(pid,0)` 会误判「还活着」；
+ *   2. 服务进程被强杀（Windows 的 TerminateProcess）后注册文件残留，端口已无人监听。
+ */
+function probeHealth(port) {
+  if (!port) return null;
+  const code = [
+    "const http=require('node:http');",
+    'const port=Number(process.argv[1]);',
+    "const req=http.get({host:'127.0.0.1',port,path:'/health',timeout:800},(res)=>{",
+    "  let b='';res.setEncoding('utf8');",
+    "  res.on('data',(d)=>{b+=d;});",
+    "  res.on('end',()=>{try{process.stdout.write(b);}catch{}process.exit(0);});",
+    '});',
+    "req.on('timeout',()=>{req.destroy();process.exit(2);});",
+    "req.on('error',()=>process.exit(2));",
+  ].join('');
+  try {
+    const raw = execFileSync(process.execPath, ['-e', code, String(port)], {
+      encoding: 'utf8',
+      timeout: 5000,
+      maxBuffer: 1024 * 1024,
+      env: cliEnv(),
+    });
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === 'object' ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function ensureServeServer(portOption) {
+  const registryFile = path.join(SERVE_ROOT, 'current.json');
+  const wanted = portOption === true ? 0 : (Number(portOption) || 0);
+  fs.mkdirSync(path.join(SERVE_ROOT, 'snapshots'), { recursive: true });
+  if (fs.existsSync(registryFile)) {
+    try {
+      const cur = JSON.parse(fs.readFileSync(registryFile, 'utf8'));
+      if (cur && cur.pid && cur.port) {
+        // 先探活：既验「真有人在这端口上应答」，也验「应答的是不是我们这个版本的自己」。
+        const health = probeHealth(cur.port);
+        if (health && health.ok === true && String(health.version) === SERVE_VERSION) {
+          return cur.port;
+        }
+        if (health && health.ok === true) {
+          // 确认是本项目的**旧版本**实例：收掉再起新的（此时杀掉是安全的，端口已自证身份）。
+          // pid 取 /health 自己报的（authoritative），注册文件里的 pid 可能已过期或被复用。
+          const target = Number(health.pid) || cur.pid;
+          try { process.kill(target, 'SIGTERM'); } catch { /* 已退出 */ }
+          sleepSync(300);
+        }
+        // 应答不通时**绝不发信号**：pid 可能已被系统复用给无关进程，发 SIGTERM 会误杀别人的进程。
+        // 只清注册表、另起一个（旧实例若真活着，会按自己的空闲超时退出）。
+        // Windows 上 process.kill 走 TerminateProcess，服务端 SIGTERM 处理器不执行，
+        // 残留的 current.json 也由这里一并清掉。
+        try { fs.unlinkSync(registryFile); } catch { /* 已删或被杀进程清理过 */ }
+      }
+    } catch { /* 注册文件损坏，当不存在 */ }
+  }
+  const child = require('node:child_process').spawn(
+    process.execPath,
+    [path.join(__dirname, 'todo-serve.cjs'), '--root', SERVE_ROOT, '--port', String(wanted)],
+    { detached: true, stdio: 'ignore' },
+  );
+  child.unref();
+  const deadline = Date.now() + 6000;
+  while (Date.now() < deadline) {
+    if (fs.existsSync(registryFile)) {
+      try {
+        const info = JSON.parse(fs.readFileSync(registryFile, 'utf8'));
+        if (info && info.version === SERVE_VERSION && info.port && info.pid === child.pid) return info.port;
+      } catch { /* 文件正在写入，稍后重试 */ }
+    }
+    sleepSync(120);
+  }
+  console.log('⚠ 本地数据源启动超时，改用内联 data（检查 %s）', registryFile);
+  return null;
+}
+
+function publishSnapshot(dir, portOption) {
+  const dataFile = path.join(dir, 'final.data.json');
+  if (!fs.existsSync(dataFile)) return null;
+  const port = ensureServeServer(portOption);
+  if (!port) return null;
+  const token = require('node:crypto').randomBytes(12).toString('hex');
+  const snapDir = path.join(SERVE_ROOT, 'snapshots', token);
+  fs.mkdirSync(snapDir, { recursive: true });
+  // 先拷到临时名再拷成正式名：沙箱会拒绝对家目录做 rename（EPERM），copyFile 不受限；
+  // 这份 URL 此时还没交给任何人，所以不存在「读到半份」的窗口。
+  const tmp = path.join(snapDir, 'todo.json.tmp');
+  fs.copyFileSync(dataFile, tmp);
+  fs.copyFileSync(tmp, path.join(snapDir, 'todo.json'));
+  try { fs.unlinkSync(tmp); } catch { /* 残留也无害 */ }
+  const url = `http://127.0.0.1:${port}/s/${token}/todo.json`;
+  try {
+    fs.writeFileSync(path.join(dir, 'serve.json'), JSON.stringify({ url, token, port, snapshotDir: snapDir }, null, 2));
+  } catch { /* 只是排错用的旁路文件 */ }
+  return url;
+}
+
 function exportFinal(result, dir, state, kept, opts = {}) {
   const { limit, from, to } = state;
   const excluded = (state.exclude || []).join('/');
@@ -323,8 +494,17 @@ function exportFinal(result, dir, state, kept, opts = {}) {
     lines.push(`    }${gi < payload.wfIdGroup.length - 1 ? ',' : ''}`);
   });
   lines.push('  ]', '}');
+  // 供 todo-serve.cjs 读取的同构数据（只有三键，无外框）：服务与载荷永远读同一份，不会出现两份数据。
+  fs.writeFileSync(path.join(dir, 'final.data.json'), JSON.stringify(payload));
+  // 数据源模式：`--data-source <url>` 直接用给定地址；`--serve [端口]` 现起一个本地服务拿地址。
+  let dataSourceUrl = opts.dataSource && opts.dataSource !== true ? String(opts.dataSource) : null;
+  if (!dataSourceUrl && opts.serve) dataSourceUrl = publishSnapshot(dir, opts.serve);
   // 落盘与 stdout 共用同一份载荷；data 段只保留三个业务键。
-  const finalText = wrapBrowseToolPayload(lines.join('\n'), baseUrl);
+  const finalText = wrapBrowseToolPayload(lines.join('\n'), baseUrl, dataSourceUrl);
+  if (dataSourceUrl) {
+    console.log('\n数据源模式：params.dataSource = %s', dataSourceUrl);
+    console.log('  组件改为 GET 该地址（响应体就是 params.data 的三键对象）；单进程多快照，快照空闲 30 分钟后自动清理');
+  }
   // 用户 2026-10-27 定稿：交付 = 回复里内联 <browsertool> 整块，**不再生成 JSON 文件**。
   // `--file` 仅保留作调试（写一份纯载荷 JSON），交付流程不再使用它。
   if (opts.writeFile) fs.writeFileSync(finalFile, finalText);
@@ -506,32 +686,24 @@ function cmdBuild(args) {
   if (planFile) {
   aiGroups = readJson(planFile);
 
-  // 覆盖校验：每个 groupId 的 1..count 全覆盖、无重复；count 取 CLI 口径（priority 已抽取）
+  // 只做「结构 + groupId + 组内重复」的前置友好检查；
+  // 覆盖度与合法性由 CLI 裁定（`aiGroups.seq` 已废弃，只认 requestIds；漏分的条目 CLI 会落成单条并告警）。
   const byGroup = new Map();
   for (const entry of aiGroups) {
-    if (!entry || !entry.groupId || !Array.isArray(entry.seq)) {
-      console.error('✖ aiGroups 元素必须是 {groupId,title,seq:[...]}'); process.exit(1);
+    if (!entry || !entry.groupId || !Array.isArray(entry.requestIds)) {
+      console.error('✖ aiGroups 元素必须是 {groupId,title,requestIds:[...]}（seq 已废弃）'); process.exit(1);
     }
     if (!countById.has(String(entry.groupId))) {
       console.error(`✖ 未知 groupId ${entry.groupId}（合法值见 state.json 的 planGroups）`); process.exit(1);
     }
     const set = byGroup.get(entry.groupId) || new Set();
-    for (const n of entry.seq) {
-      if (set.has(n)) { console.error(`✖ groupId ${entry.groupId} 的 seq ${n} 重复`); process.exit(1); }
-      set.add(n);
+    for (const id of entry.requestIds) {
+      const key = String(id);
+      if (set.has(key)) { console.error(`✖ groupId ${entry.groupId} 的 requestId ${key} 重复`); process.exit(1); }
+      set.add(key);
     }
     byGroup.set(entry.groupId, set);
   }
-  for (const [groupId, seqs] of byGroup) {
-    const count = countById.get(groupId);
-    const miss = [];
-    for (let i = 1; i <= count; i += 1) if (!seqs.has(i)) miss.push(i);
-    if (miss.length) {
-      const name = (planGroups.find((g) => g.groupId === groupId) || {}).title || groupId;
-      console.error(`✖ ${name} 缺 ${miss.length} 条：${miss.slice(0, 12).join(',')}`);
-      process.exit(1);
-    }
-  }
   const focusKinds = focusCoversKinds(state.groupFocus);
   for (const group of planGroups) {
     if (countById.get(group.groupId) <= 1 || group.groupId === 'priority') continue;
@@ -649,7 +821,17 @@ function cmdFinish(args) {
       console.log('  → 写成 [{groupId,summary}] 后加 `--group-summaries <file>` 重跑本命令，可在同一次调用里回填');
     }
   }
-  exportFinal(finalResult, dir, state, kept.length, { writeFile: args.file === true, timingReport: args['timing-report'] });
+  // 2026-10-28 用户 OA 页面实测通过：默认走本地数据源（params.dataSource），
+  // 载荷只带 URL、不带明细；`--no-serve` 退回内联 data，`--serve <端口>` 换端口。
+  const serveOption = args['no-serve'] === true
+    ? false
+    : (args.serve === undefined ? true : args.serve);
+  exportFinal(finalResult, dir, state, kept.length, {
+    writeFile: args.file === true,
+    timingReport: args['timing-report'],
+    dataSource: args['data-source'],
+    serve: serveOption,
+  });
   console.log('总耗时（脚本口径）：%s', fmt(Date.now() - Date.parse(state.startedAt)));
 }
 
@@ -675,7 +857,14 @@ function cmdRun(args) {
     return;
   }
   // 没有待写摘要 ⇒ 终态可以立刻出，省掉一次约 7s 的进程启动
-  cmdFinish({ dir, file: args.file === true, 'timing-report': args['timing-report'], 'group-summaries': args['group-summaries'] });
+  cmdFinish({
+    dir,
+    file: args.file === true,
+    'timing-report': args['timing-report'],
+    'group-summaries': args['group-summaries'],
+    serve: args.serve,
+    'no-serve': args['no-serve'],
+  });
 }
 
 const args = parseArgs(process.argv.slice(2));
@@ -690,6 +879,7 @@ else {
   console.log('  prep   --limit 100 [--exclude 内部留言] [--days 1460] [--sub-category 待处理] [--out DIR]');
   console.log('  build  --dir DIR [--plan aiGroups.json]   # 不传 plan = 直接走确定性分组');
   console.log('  finish --dir DIR [--summaries aiSummaries.json] [--group-summaries aiGroupSummaries.json] [--file] [--timing-report]');
+  console.log('  默认：载荷只带 params.dataSource（现起本地服务，空闲 30 分钟自动退出）；--no-serve 退回内联 data');
   console.log('  提示：`--timing-report` 会在控制台打一段耗时摘要（阶段墙钟 / CLI 内部），**不产出 md**');
   process.exit(2);
 }

package/skills/weaver-e10-yepiaotong/SKILL.md

@@ -91,11 +91,11 @@ cliHelp: "weaver-work-cli invoice --help"
 | 报销自动填单（发票、事前申请、工作流、预填数据）   | `invoice run invoice.reim.`*                     | `[invoice-reim.md](references/invoice-reim.md)`                                   |
 | 报销单创建 / 修改                   | `workflow run workflow.createForm/createRequest`、`workflow.editLoad/editPrepare/editApply`（`weaver-e10-workflow` 技能） | `[reim-workflow.md](references/reim-workflow.md)` Step 3~6；命令契约见 `[workflow-create.md](../weaver-e10-workflow/references/workflow-create.md)` |
 | 报销完整工作流编排、行为准则             | AI 内部                                            | `[reim-workflow.md](references/reim-workflow.md)`                                 |
-| 批量获取多张发票预填信息               | `invoice run invoice.reim.row-info-batch`    | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
+| 批量获取多张发票预填信息（报销建单不再调用） | `invoice run invoice.reim.row-info-batch`    | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
 | 相关客户 / 相关项目模糊搜索              | `invoice run invoice.reim.field.search`      | `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「相关客户模糊搜索」 |
 | 报销 CLI operation 入参与返回值    | AI 内部                                            | `[reim-api-reference.md](references/reim-api-reference.md)`                       |
 | 发票与事前申请匹配规则                | AI 内部                                            | `[reim-matching-rules.md](references/reim-matching-rules.md)`                     |
-| 费用科目自动匹配规则                 | AI 内部                                            | `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)`       |
+| 费用科目匹配规则（建单不用，仅用户要求改科目时） | AI 内部                                            | `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)`       |
 | 报销表单字段填充与 JSON 组装规则        | AI 内部                                            | `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`                   |
 | 话费补贴 / 话费报销硬拦截规则           | AI 内部                                            | `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`           |
 | 报销端到端示例                    | 参考                                               | `[reim-examples.md](references/reim-examples.md)`                                 |
@@ -118,11 +118,13 @@ cliHelp: "weaver-work-cli invoice --help"
 - 编辑发票：`invoice.update.prepare` -> 用户确认 -> `invoice.update.apply`
 - 删除发票：`invoice.delete.prepare` -> 用户确认 -> `invoice.delete.apply`
 - 流程发票字段：已有 `fid` 或详情时，用 `invoice.browse-field.data` 生成浏览按钮对象；不要运行旧源码脚本或直接调接口。
-- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.reim.candidates.list`（按日期批量）/`invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票（日期筛选默认 `consumption_tm_begin` / `consumption_tm_end`）-> 展示汇总并确认 -> `invoice.reim.requests.list` 只按开票日期和事前申请发起日期关联（只比日期不比钟点，发起日与开票日同一天算对上，默认绑定），一张发票同时落在多条上时让用户选 -> `invoice.reim.workflow.resolve` 得到报销工作流 -> 并行 `workflow.createForm`（`weaver-e10-workflow`，传 `{workFlowName}({workFlowId})`，**不传 `userQuestion`**，也不用 `workflow.createRequestDirect`）、`invoice.reim.row-info-batch`、`invoice.browse-field.data`（只传发票）-> 按规则组装 `data`（**`requestName` 与「报销事由」必传**，按 form-fill-rules 的标题/事由公式生成，禁止留用表单默认标题或留空；发票与事前申请只按时间关联，见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`，科目匹配见 `[reim-expense-subject-rules.md](references/reim-expense-subject-rules.md)`；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`；工作流是「总部费用报销」时，用本次 `createForm` 的 `historyRequestData` 在项目确认后带出合同号，**不要询问合同号**；相关客户和相关项目需要填写时同一次让用户一起输入，未确认不建单，见 `[reim-workflow.md](references/reim-workflow.md)` Step 4.4、Step 4.5；明细「费用说明」「费用明细」不写入 `data`，由发票联动带出）-> 直接 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，**不问用户「存草稿 / 提交审批」**，草稿由用户在 E10 核对后自己提交）-> 原样粘贴 `finalMarkdown` -> **必须做 Step 5.3**：查客户 / 项目是否被联动冲空（已确认值直接写回，不要先建空草稿再问）。创建成功后修改只能用 `workflow.editLoad` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
+- 报销填单（完整工作流见 `[reim-workflow.md](references/reim-workflow.md)`）：先用 `invoice.reim.candidates.list`（按日期批量）/`invoice.list`/`invoice.get`/`invoice.reim.file-ocr.preview` 获取发票（日期筛选默认 `consumption_tm_begin` / `consumption_tm_end`；出差 / 去某城市报销时出发城市没说默认上海，消费日期落在出差时间内的出发城市打车票也一起筛进来，见 `[reim-workflow.md](references/reim-workflow.md)`「出差 / 城市意图查票」）-> 展示汇总并确认 -> `invoice.reim.requests.list` 只按开票日期和事前申请发起日期关联（只比日期不比钟点，发起日与开票日同一天算对上，默认绑定），一张发票同时落在多条上时让用户选 -> `invoice.reim.workflow.resolve` 得到报销工作流 -> 并行 `workflow.createForm`（`weaver-e10-workflow`，传 `{workFlowName}({workFlowId})`，**不传 `userQuestion`**，也不用 `workflow.createRequestDirect`）、`invoice.browse-field.data`（只传发票）-> 按规则组装 `data`（**`requestName` 与「报销事由」必传**，按 form-fill-rules 的标题/事由公式生成，禁止留用表单默认标题或留空；发票与事前申请只按时间关联，见 `[reim-matching-rules.md](references/reim-matching-rules.md)`，填单规则见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`；明细「费用类型（科目）」不传，由发票联动带出；命中话费补贴/话费报销时先读 `[reim-phone-subsidy-rules.md](references/reim-phone-subsidy-rules.md)`；工作流是「总部费用报销」时，用本次 `createForm` 的 `historyRequestData` 在项目确认后带出合同号，**不要询问合同号**；相关客户和相关项目需要填写时同一次让用户一起输入，未确认不建单，见 `[reim-workflow.md](references/reim-workflow.md)` Step 4.4、Step 4.5；明细「费用说明」「费用明细」不写入 `data`，由发票联动带出）-> 直接 `workflow.createRequest` 存草稿（`action` 固定 `"draft"`，**不问用户「存草稿 / 提交审批」**，草稿由用户在 E10 核对后自己提交）-> 原样粘贴 `finalMarkdown` -> **必须做 Step 5.3**：查客户 / 项目是否被联动冲空（已确认值直接写回，不要先建空草稿再问）。创建成功后修改只能用 `workflow.editLoad` -> `workflow.editPrepare` -> 用户确认 -> `workflow.editApply`。
 - 报销单创建/修改依赖同级的 `weaver-e10-workflow` 技能（`../weaver-e10-workflow/`）；该技能不存在时停止并告知用户需要安装，不要改用其他方式创建报销单。
 - **⚠️ 报销单不询问合同号。** 默认 `20260999`。用户本轮自己说了才用用户的；否则按已确认的相关项目，从 `historyRequestData` 里该项目最近一条带出。对不上或项目「不填」则用默认。带出的合同号不是 `20260999` 时，创建阶段承担主体不传。**相关客户和相关项目同一次让用户一起输入**，确认后再写入 `data`，禁止空着先建草稿，也不要拆成两轮。名称先 `invoice.reim.field.search`。明细「费用说明」不自己生成，交给发票联动。口径见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「总部费用报销历史参考」「费用明细字段规则」。
 - **⚠️ 明细列「费用明细」禁止填值**：`createForm` 的 `fields` 里名称是「费用明细」的明细列不要写入 `data`。只传「相关发票」，由发票联动带出。用户给了文字也不要写入。建单后这一列仍空，就说明联动没带出，不要补写。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
 - **⚠️ 明细「费用说明」禁止自己生成**：`createForm` 的 `fields` 里名称是「费用说明」或「摘要」的明细列不要写入 `data`。不要用 `fysm`、起止点、消费内容或话费账单说明去填。只传「相关发票」，由发票联动带出。用户给了文字也不要写入。建单后仍空，只说明联动没带出，不要补写。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
+- **⚠️ 明细每行只写「相关发票」**：有绑定的事前申请时再写「相关流程」（差旅 / 外出每行必须有）。费用日期、金额、币种、费用类型（科目）、费用说明、费用明细、相关凭证、明细相关客户 / 项目、附件数等其余明细列**一律不传**，由「相关发票」联动带出；表单默认值、`row-info` 返回值、用户口述都不写进去。建单后仍空只告知联动没带出，不补写。建单不再调用 `invoice.reim.row-info-batch`。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
+- **⚠️ 明细「费用类型（科目）」不允许 AI 填值**：创建时不写入 `data`，保留空值，由「相关发票」联动带出。不要用 `row-info` 的 `subjectId`、科目匹配规则或兜底科目「其他-管理费用」自己填。建单后仍空只告知联动没带出，不补写，也不让用户选科目；只有用户明确要求改某行科目时才走修改链。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「费用明细字段规则」。
 - **⚠️ 明细「相关凭证」不允许赋值**：创建和修改都不写入 `data`，由「相关发票」联动带出。不做凭证配对，`invoice.browse-field.data` 只传发票。建单后仍空只告知联动没带出，不补写，也不让用户挂行程单。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「3. 相关凭证不赋值」。
 - **⚠️ 主表「事前申请流程」不允许赋值**：创建报销单时不写入 `data.main`，保留空值。匹配到的事前申请只写到明细每行「相关流程」（`{requestname}({requestid})`）。见 `[reim-form-fill-rules.md](references/reim-form-fill-rules.md)`「主表字段规则」。
 - **AI 开票（默认主链路，所有开票意图先走这条）**：`invoice.issuing.qys.list`（合同号传 `contractNo`，公司名等传 `keyword`；没有线索只问一句合同号或客户名）-> 按返回的 `groups`（一组 = 合同号 + 购方 = 一张流程）让用户选组 -> **购方无税号却是专票（`specialInvoiceWithoutTaxNo=true`）时硬拦截：没有税号只能开普票，请用户先在台账改为普票，不发起流程** -> 展示确认卡片（明确"只建草稿，不会直接开票"；必填的「预计收款时间」在卡片里请用户从本月底 / 下月底 / 30 天后候选里选或直接给日期，不自己定默认值，**用户没给日期就不建草稿**）-> 用户确认 -> `workflow.createForm`（`weaver-e10-workflow`，按台账「核算公司」`sellerNames` 选择，名称必须完全相同：只有「上海亘岩网络科技有限公司」时传 `契约锁合同收款发票开具及快递申请(100003460000001852)`；是泛微网络、泛微软件、上海田亩、成都泛微、泛微国际、北京泛微、浙江泛微之一时传 `合同收款发票开具及快递申请(100003460000000214)`；为空或不在这份名单里时先问用户，选定前不建草稿。用户要退票、冲红或红冲时改为 `合同开票冲红流程(887410479139758085)`，不套用开票填单规则。**不传 `userQuestion`**，**不要按宽词“开票”检索**）-> 按 `[invoice-issuing-form-fill-rules.md](references/invoice-issuing-form-fill-rules.md)` 组装 `data`（用户说了就按用户的，没说就按默认值，例如本次开票金额默认 = 总金额、开票事由自动生成、所售产品版本号取明细规格类型（与下拉选项完全一致才填）；「开票内容」只在 `契约锁合同收款发票开具及快递申请(100003460000001852)` 上按明细货物名称推断后传入，其他流程忽略该字段；明细每行只传「金额（含税）」，其余列（货物名称、明细行id、单价、规格类型、税率、总开票金额 / 已开票金额 / 未开票金额等）由合同号联动带出，多传会让总开票金额带不出来；明细「数量」和主表「开户行名称」「开户行银行帐号」创建时不传（数量会被联动写成税率选项 id；开户行会被写成名称账号混写串）；其余购方信息由合同号联动带出，不传）；`requestName` 按 `开票申请-{购方名称}-{合同号}` 必传 -> `workflow.createRequest`（`action` 固定 `"draft"`）-> 原样粘贴 `finalMarkdown`，再用 `linkageResult` 的「是否存在合同明细数据」「总开票金额」和「本次开票总金额」核对明细是否带出、本次填的开票金额是否一致（台账开票金额为含税金额）-> **创建后补正**：`workflow.editLoad` 读草稿。开户行名称 / 账号取分组里 CLI 拆好的 `purchaserBankName` / `purchaserBankAccount`（为空时按「，账号：」拆只读字段「开户行及帐号」），`workflow.editPrepare` **只传主表这两个字段**，用户确认后 `workflow.editApply`。只有契约锁开票流程才在创建时写入「开票内容」，不要再用编辑链改（`editPrepare` 会报错）；没有匹配到选项时才提醒用户在 E10 选择。其他流程没有这个字段，不推断、不提醒。明细数量不经编辑链改（会多出一行）：回复末尾把每行数量改成台账 `items[].quantity`（按「明细行id」对应）。创建成功后修改只走 `workflow.editLoad/editPrepare/editApply`，禁止重复创建。详见 `[invoice-issuing-workflow.md](references/invoice-issuing-workflow.md)`。
@@ -163,11 +165,11 @@ cliHelp: "weaver-work-cli invoice --help"
 - 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作
 - **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。
 - 认证失败后先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`：
-  - 登录失效的认证方式必须由 Agent 复用本任务开始时的宿主判定，禁止调用任何其他登录 Skill。
-  - 明确为 XiaoE 时，只执行 `weaver-work-cli auth xiaoe`，不得改用 `auth login`。
-  - 统一登录返回 `authentication/xiaoe_credential_unavailable` 时停止并反馈宿主凭据不可用，不自动回退浏览器登录。
-  - 非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈，不得改调其他登录 Skill。
-  - 登录恢复后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
+  - 已有 XiaoE 会话的 `session_expired` 已由 CLI 底层自动换票并重放一次；若错误最终仍返回，Agent 只反馈并停止，不执行任何登录命令、其他登录 Skill 或原业务命令。
+  - 仅首次无会话或明确的 `auth not found` 才由 Agent 复用任务开始时的宿主判定。
+  - 首次认证明确为 XiaoE 时，执行一次 `weaver-work-cli auth xiaoe`；返回 `authentication/xiaoe_credential_unavailable` 时停止，不回退浏览器登录。
+  - 首次认证且非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈。
+  - 显式登录后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
 - 登录类命令必须带 timeout 限时（上限 300 秒 / 5 分钟，后台运行 + 限时观察）：输出一旦出现 `Open browser login`、`Waiting for E10 authorization callback` 或 `Could not open browser automatically`，即判定已降级到浏览器 OAuth，立即终止该命令并反馈，不得继续等待。登录失败不自动重试。
 - 需要浏览器登录时必须携带发起方标识 `--agent_type "<当前智能体名称>"`（授权确认页展示用；宿主无法确认名称时才可省略，交由 CLI 从环境变量推断）。