zen-gitsync 2.17.20 → 2.17.22

package/src/ui/public/index.html

@@ -10,38 +10,38 @@
     <meta name="theme-color" content="#141820" media="(prefers-color-scheme: dark)" />
     <title>Zen GitSync</title>
     <!-- 字体改为自托管(@font-face 见 src/main.css),不再依赖 Google Fonts 外链 -->
-    <script type="module" crossorigin src="/assets/index-D_Pwvey4.js"></script>
+    <script type="module" crossorigin src="/assets/index-BVkLqLHo.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-C0FnF6B9.js">
-    <link rel="modulepreload" crossorigin href="/assets/element-plus-AaVXaSqv.js">
+    <link rel="modulepreload" crossorigin href="/assets/element-plus-Bx3j6vzG.js">
     <link rel="modulepreload" crossorigin href="/assets/monaco-DkJuNcCr.js">
-    <link rel="modulepreload" crossorigin href="/assets/vendor-CPpc-p6F.js">
-    <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-o8uPiAjs.js">
-    <link rel="modulepreload" crossorigin href="/assets/SvgIcon-z4ExzvGR.js">
-    <link rel="modulepreload" crossorigin href="/assets/IconButton-D-maDWg7.js">
-    <link rel="modulepreload" crossorigin href="/assets/configStore-DrMJDegh.js">
-    <link rel="modulepreload" crossorigin href="/assets/socket-io-BFqQXqAp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gitStore-BI_ujQ9r.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-CyWsJd6S.js">
+    <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-DBFEfstn.js">
+    <link rel="modulepreload" crossorigin href="/assets/SvgIcon-Cgmy9qD6.js">
+    <link rel="modulepreload" crossorigin href="/assets/IconButton-CyEyp9_D.js">
+    <link rel="modulepreload" crossorigin href="/assets/configStore-6xFSX9E5.js">
+    <link rel="modulepreload" crossorigin href="/assets/socket-io-TBtw0msS.js">
+    <link rel="modulepreload" crossorigin href="/assets/gitStore-BoFStoL3.js">
     <link rel="modulepreload" crossorigin href="/assets/fileIcon-B5p5pGN9.js">
-    <link rel="modulepreload" crossorigin href="/assets/flow-mindmap-C22NSZc1.js">
-    <link rel="modulepreload" crossorigin href="/assets/previewSandbox-B16xvZLS.js">
-    <link rel="modulepreload" crossorigin href="/assets/useThemeObserver-CiUpR4zj.js">
-    <link rel="modulepreload" crossorigin href="/assets/CommonDialog-CZ5McwHT.js">
-    <link rel="modulepreload" crossorigin href="/assets/FileDiffViewer-CKcSkMAd.js">
-    <link rel="modulepreload" crossorigin href="/assets/toolsStore-DgqU92bI.js">
-    <link rel="modulepreload" crossorigin href="/assets/TemplateManager-BSq-dNvW.js">
-    <link rel="modulepreload" crossorigin href="/assets/vue-flow-DwYB6Myr.js">
+    <link rel="modulepreload" crossorigin href="/assets/flow-mindmap-OPE_D4da.js">
+    <link rel="modulepreload" crossorigin href="/assets/previewSandbox-BzitUMhT.js">
+    <link rel="modulepreload" crossorigin href="/assets/useThemeObserver-DYxFoHh1.js">
+    <link rel="modulepreload" crossorigin href="/assets/CommonDialog-B7r-EaIr.js">
+    <link rel="modulepreload" crossorigin href="/assets/FileDiffViewer-7HZ_CW13.js">
+    <link rel="modulepreload" crossorigin href="/assets/toolsStore-B49mCaQ_.js">
+    <link rel="modulepreload" crossorigin href="/assets/TemplateManager-DUPI3yBg.js">
+    <link rel="modulepreload" crossorigin href="/assets/vue-flow-fVVGZspa.js">
     <link rel="stylesheet" crossorigin href="/assets/element-plus-Qexo5hiM.css">
     <link rel="stylesheet" crossorigin href="/assets/monaco-B2lPvkrc.css">
     <link rel="stylesheet" crossorigin href="/assets/vendor-BzMymUBi.css">
-    <link rel="stylesheet" crossorigin href="/assets/SvgIcon-CDNsk4-Q.css">
-    <link rel="stylesheet" crossorigin href="/assets/IconButton-RlXqKOeu.css">
+    <link rel="stylesheet" crossorigin href="/assets/SvgIcon-BQ6bR7l0.css">
+    <link rel="stylesheet" crossorigin href="/assets/IconButton-W2X09OKH.css">
     <link rel="stylesheet" crossorigin href="/assets/flow-mindmap-BMpmHdqh.css">
-    <link rel="stylesheet" crossorigin href="/assets/previewSandbox-PYnM6Paz.css">
-    <link rel="stylesheet" crossorigin href="/assets/CommonDialog-w6EmBEXv.css">
-    <link rel="stylesheet" crossorigin href="/assets/FileDiffViewer-n5ea9qMe.css">
-    <link rel="stylesheet" crossorigin href="/assets/TemplateManager-DO7EPfj8.css">
+    <link rel="stylesheet" crossorigin href="/assets/previewSandbox-SqNQvuHv.css">
+    <link rel="stylesheet" crossorigin href="/assets/CommonDialog-Bzi5ISqT.css">
+    <link rel="stylesheet" crossorigin href="/assets/FileDiffViewer-B6zy6NiA.css">
+    <link rel="stylesheet" crossorigin href="/assets/TemplateManager-DiM3vrbf.css">
     <link rel="stylesheet" crossorigin href="/assets/vue-flow-CavUTEzp.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-Cp5WtCfY.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DVJITdth.css">
   </head>
   <body>
     <div id="app"></div>

package/src/ui/server/index.js

@@ -697,6 +697,14 @@ async function startUIServer(noOpen = false, savePort = false) {
       // 2) 清心跳 + 反注册实例
       try { clearInterval(heartbeatTimer); } catch (_) {}
       try { await instanceRegistry.unregister(process.pid); } catch (_) {}
+      // 2b) 清掉自己那份「运行中 job」广播文件（live-jobs/<pid>.json）。
+      //     不清也不会留下幽灵「进行中」——别的实例读的时候发现 owner pid 没了会跳过并
+      //     顺手删掉，这里只是让 Ctrl+C 这种常见路径当场干净。动态 import：模块早就在
+      //     路由注册时加载过了，这里只是拿它的函数，不会往入口的静态 import 图里加东西。
+      try {
+        const { clearOwnLiveJobsFile } = await import('./routes/workbench/jobStore.js');
+        await clearOwnLiveJobsFile();
+      } catch (_) {}
       console.log(chalk.gray(`[shutdown] 收到 ${signal}，已清理本实例`));
       // 3) 给 OS 100ms 刷盘日志
       setTimeout(() => process.exit(0), 100);

package/src/ui/server/routes/config.js

@@ -1047,10 +1047,13 @@ export function registerConfigRoutes({
       if (!rawConfig.ui.aiDiffSummaryByProject || typeof rawConfig.ui.aiDiffSummaryByProject !== 'object' || Array.isArray(rawConfig.ui.aiDiffSummaryByProject)) {
         rawConfig.ui.aiDiffSummaryByProject = {}
       }
+      if (!rawConfig.ui.editorWorkspaceByProject || typeof rawConfig.ui.editorWorkspaceByProject !== 'object' || Array.isArray(rawConfig.ui.editorWorkspaceByProject)) {
+        rawConfig.ui.editorWorkspaceByProject = {}
+      }
 
       // 浅合并顶层 ui 字段（支持嵌套对象整体替换，如 commandConsole）
       for (const key of Object.keys(partial)) {
-        if (key === 'layoutsByProject' || key === 'aiDiffSummaryByProject') {
+        if (key === 'layoutsByProject' || key === 'aiDiffSummaryByProject' || key === 'editorWorkspaceByProject') {
           // 深合并 map：保留其它项目条目
           const incoming = partial[key]
           if (incoming && typeof incoming === 'object' && !Array.isArray(incoming)) {

package/src/ui/server/routes/workbench/index.js

@@ -83,8 +83,8 @@ import {
   bus,
   cancelledJobs,
   serializeJob,
-  scheduleJobsSave,
   flushJobsSaveNow,
+  clearOwnLiveJobsFile,
   readJobsConfig,
   writeJobsConfig,
   enforceRetention,
@@ -120,7 +120,15 @@ import {
   setProjectPrompt,
   buildActivityFeed,
   buildRunningAgents,
+  setReportIntervalMs,
+  claimReportSlot,
+  readReports,
+  appendReport,
 } from './orchestratorStore.js';
+import {
+  buildRunningFacts,
+  generateProgressReport,
+} from './progressReport.js';
 
 /**
  * 「任务结束 → 刷快照」的监听器。存成模块级的，是为了在重复装配路由时
@@ -129,6 +137,12 @@ import {
  */
 let jobSettledHandler = null;
 
+/** 自动进度报告的定时器。同上：重复装配路由时先清掉上一个 */
+let reportTimer = null;
+
+/** 自动报告的检查粒度。它**不等于**报告间隔 —— 见 tickProgressReport 的注释 */
+const REPORT_TICK_MS = 30 * 1000;
+
 /**
  * 注册所有 workbench 路由（共 45 个端点）。
  * @param {Object} deps
@@ -897,16 +911,17 @@ ${subSummaries.map((s, i) => `\n### [${i + 1}] ${s.name} (${s.root})\n${s.summar
   app.get('/api/workbench/jobs/:id', asyncRoute(async (req, res) => {
     // 优先查内存（含活跃）
     const live = jobs.get(req.params.id);
+    const tasksData = await readJson(TASKS_FILE, { tasks: [] });
+    const taskMap = new Map((tasksData.tasks || []).map(t => [t.id, t]));
     if (live) {
-      const tasksData = await readJson(TASKS_FILE, { tasks: [] });
-      const taskMap = new Map((tasksData.tasks || []).map(t => [t.id, t]));
       return res.json({ success: true, job: serializeJob(live, taskMap) });
     }
-    // 退回文件
-    const data = await readJson(JOBS_FILE, { version: 1, jobs: [] });
-    const j = (data.jobs || []).find(x => x.id === req.params.id);
+    // 退回「磁盘历史 ∪ 别的实例正在跑」的合并表 —— 光读 jobs.json 会让
+    // "看板上明明在转的那条"点开变成 404(运行中的记录不在历史档案里)。
+    await refreshJobsFromDisk();
+    const j = mergedJobs().get(req.params.id);
     if (!j) throw new HttpError(404, 'job 不存在');
-    res.json({ success: true, job: j });
+    res.json({ success: true, job: serializeJob(j, taskMap) });
   }));
 
   app.delete('/api/workbench/jobs/:id', asyncRoute(async (req, res) => {
@@ -1204,11 +1219,154 @@ ${subSummaries.map((s, i) => `\n### [${i + 1}] ${s.name} (${s.root})\n${s.summar
       // 设置弹窗打开时也不必再单独取一次（单条上限 8000 字，体积可控）
       defaultPrompt: state.defaultPrompt,
       projectPrompts: state.projectPrompts,
+      // 进度报告的**配置**（一个数字 + 一个时间戳）跟着轮询走，报告的**正文**走
+      // /orchestrator/reports：报告历史一份几 KB，20 份就是几十 KB，
+      // 塞进这个 5s 轮询的接口纯属浪费（与 /tasks/:id/detail 不进 /projects 同一个理由）。
+      reportIntervalMs: state.reportIntervalMs,
+      lastReportAt: state.lastReportAt,
       activity: buildActivityFeed({ jobs: jobsSnap, tasks, instructions: state.instructions }),
       running: buildRunningAgents({ jobs: jobsSnap, tasks }),
     });
   }));
 
+  // ════════════════════════════════════════════════════════════════════════
+  // §19.5 进度报告（右栏「进度报告」面板）
+  //
+  // 面板上那一段"现在跑到哪一步了"由模型写，但**什么时候写、写几次**由这一层管：
+  //   · 手动「立即报告」→ POST /orchestrator/report，永远可用；
+  //   · 自动报告 → 下面的定时器，间隔来自用户设置（0 = 关）。
+  // 两份历史都存在 orchestrator-reports.json，读取走 /orchestrator/reports。
+  // ════════════════════════════════════════════════════════════════════════
+
+  /**
+   * 报告要用到的两份东西：默认模型 + 界面语言。
+   * 一次 config 读出来 —— 分两次读会读到"两个瞬间"（改设置的同时正好在报告）。
+   */
+  async function readReportContext() {
+    const out = { model: null, locale: '' };
+    if (!configManager || typeof configManager.readRawConfigFile !== 'function') return out;
+    try {
+      const raw = await configManager.readRawConfigFile();
+      const models = Array.isArray(raw && raw.models) ? raw.models : [];
+      out.model = models.find(m => m && m.isDefault) || models[0] || null;
+      out.locale = typeof (raw && raw.locale) === 'string' ? raw.locale : '';
+    } catch (err) {
+      logger.warn('[workbench] 读取模型配置失败，本次报告只记事实:', (err && err.message) || err);
+    }
+    return out;
+  }
+
+  /** 当前在跑的 job 拼成报告事实。先刷磁盘那一半，别的实例跑的任务也要算进来 */
+  async function collectRunningFacts() {
+    const data = await readJson(TASKS_FILE, { tasks: [] });
+    await refreshJobsFromDisk();
+    return buildRunningFacts({ jobs: Array.from(mergedJobs().values()), tasks: data.tasks || [] });
+  }
+
+  /**
+   * 生成并落盘一份进度报告。
+   *
+   * @param {'auto'|'manual'} trigger
+   * @param {{ locale?: string, intervalMs?: number }} [opts]
+   *        locale 缺省时用配置里的界面语言；intervalMs 只在 auto 时用（抢占名额）
+   * @returns {Promise<object|null>} null = 这次不该报（没任务在跑 / 名额已被占）
+   */
+  async function runProgressReport(trigger, { locale = '', intervalMs = 0 } = {}) {
+    const facts = await collectRunningFacts();
+
+    // 没有任务在跑就**不生成报告**，自动与手动一视同仁。
+    //   · 自动：一条"什么都没发生"每 10 分钟占一格，只会把真正有用的挤出历史（上限 20 条）；
+    //   · 手动：用户点这一下是想知道"现在跑到哪一步了"，而此刻确实没有东西在跑 ——
+    //     前端弹一句"当前没有正在执行的任务"（useOrchestrator.generateReport）比往历史里
+    //     塞一条空记录有用：空记录回头翻的时候零信息量，还会把有用的挤出去。
+    //     （用户 2026-09-29 报的问题：历史里 4 条"当时没有任务在执行"两两重复，
+    //      点一下「立即报告」就多两条 —— 空报告本机几十毫秒返回，前端的防抖拦不住第二次点击。）
+    // 返回 null 是"这次不该报"的正常结果，不是错误。
+    if (!facts.length) return null;
+    if (trigger === 'auto' && !(await claimReportSlot(intervalMs))) return null;
+
+    const ctx = await readReportContext();
+    const report = await generateProgressReport({
+      facts,
+      locale: locale || ctx.locale,
+      trigger,
+      model: ctx.model,
+    });
+    const saved = await appendReport(report);
+    publish('orchestrator:report', { id: saved.id, at: saved.at, trigger: saved.trigger });
+    return saved;
+  }
+
+  /**
+   * 同一时刻只跑一次生成。
+   * 「立即报告」连点两下、或手动与自动撞在一起时，第二次应该**等第一份**，
+   * 而不是再打一次模型换回一份几乎一样的报告。
+   */
+  let reportInFlight = null;
+  function runProgressReportOnce(trigger, opts) {
+    if (reportInFlight) return reportInFlight;
+    reportInFlight = runProgressReport(trigger, opts).finally(() => { reportInFlight = null; });
+    return reportInFlight;
+  }
+
+  /** 取报告历史（新的在前）。面板打开时取一次、之后每次生成后取一次 */
+  app.get('/api/workbench/orchestrator/reports', asyncRoute(async (_req, res) => {
+    res.json({ success: true, reports: await readReports() });
+  }));
+
+  /**
+   * 手动生成一份报告。body: { locale? }
+   *
+   * 与自动报告共用同一条链路，只在两处不同：
+   *   · 不占用自动报告的间隔名额（否则用户点一下「立即报告」，下一次自动报告被推迟一整个间隔）；
+   *   · 间隔窗口内**内容一样**的第二份不重复落盘（连点两下只留一份，见 appendReport）。
+   *
+   * 没有任务在跑时同样返回 `report: null` —— 这时前端弹一句"当前没有正在执行的任务"，
+   * 而不是往历史里记一条空报告（理由见 runProgressReport）。
+   */
+  app.post('/api/workbench/orchestrator/report', asyncRoute(async (req, res) => {
+    const locale = typeof req.body?.locale === 'string' ? req.body.locale : '';
+    const report = await runProgressReportOnce('manual', { locale });
+    res.json({ success: true, report });
+  }));
+
+  /**
+   * 改自动报告间隔。body: { intervalMs }
+   * 取值由 shared.js 的白名单卡死（0 / 5 / 10 / 15 / 30 / 60 分钟），非法值回落默认 ——
+   * 这个数字直接决定每多久烧一次额度，不能让请求体里的任意值进来。
+   */
+  app.post('/api/workbench/orchestrator/report-interval', asyncRoute(async (req, res) => {
+    const reportIntervalMs = await setReportIntervalMs(req.body?.intervalMs);
+    publish('orchestrator:report-interval', { reportIntervalMs });
+    res.json({ success: true, reportIntervalMs });
+  }));
+
+  /**
+   * 自动报告定时器。
+   *
+   * 30s 一跳，但每一跳**只是判断该不该报**：读 orchestrator.json 拿间隔 + 看内存里
+   * 有没有在跑的 job。真正花额度的那一步被三重条件挡住 —— 开关打开、有任务在跑、
+   * 距上次报告满一个间隔。所以"10 分钟报一次"的实际误差不超过 30s，
+   * 而不是每 30 秒打一次模型。
+   *
+   * 为什么放服务端而不是前端定时器：报告是给**离开键盘的人**看的，
+   * 前端定时器在标签页隐藏/关掉后就不跑了，而那正是最需要它的时刻。
+   */
+  async function tickProgressReport() {
+    const state = await readOrchestrator();
+    if (!state.reportIntervalMs) return;
+    await runProgressReportOnce('auto', { intervalMs: state.reportIntervalMs });
+  }
+
+  if (reportTimer) { clearInterval(reportTimer); reportTimer = null; }
+  reportTimer = setInterval(() => {
+    tickProgressReport().catch(err => {
+      logger.warn('[workbench] 自动进度报告失败:', (err && err.message) || err);
+    });
+  }, REPORT_TICK_MS);
+  // 定时器不该把进程吊着不退出
+  reportTimer.unref?.();
+
   app.post('/api/workbench/orchestrator/state', asyncRoute(async (req, res) => {
     const active = req.body?.active;
     if (typeof active !== 'boolean') throw new HttpError(400, 'active 必须是布尔值');

package/src/ui/server/routes/workbench/jobActivity.js

@@ -0,0 +1,254 @@
+// Copyright 2026 xz333221
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// 「这一轮执行现在跑到哪了」—— 从执行记录里抽出可读事实的**唯一实现**。
+//
+// 2026-09-29 从 progressReport.js 拆出来。同一批事实现在有两个消费者：
+//   1. 进度报告（progressReport.buildRunningFacts → 喂给主 Agent 写汇报）；
+//   2. 看板「进行中」卡片（projectRegistry.decorateTaskForBoard → 直接给人看）。
+// 留在 progressReport.js 里会让 projectRegistry 反向依赖报告模块，而报告模块本来就依赖
+// projectRegistry（用它的 projectName）—— 拆成独立模块比引一条循环依赖省事得多：
+// 这几段文本本来就只跟 job 有关，跟"报告"无关。
+//
+// 两处口径必须逐字一致：同一件事在报告里写「最近思考：…」、在卡片上换了另一句话，
+// 用户看到的是**同一条任务的两个说法**，只会以为自己看错了。
+
+/** 一句话的最大长度（最近思考 / 最近输出都走它） */
+export const MAX_LINE_CHARS = 160;
+/** 最近一次工具调用的参数摘要长度 */
+export const MAX_TOOL_CHARS = 100;
+export const MAX_TOOL_NAME_CHARS = 60;
+/** 工具名分布串的长度上限（`Bash×14 · Read×5 · Edit`） */
+export const MAX_MIX_CHARS = 160;
+
+/** 工具分布只看最近这么多次调用：整轮上千次的话，早先的模式早就被淹没了 */
+export const TOOL_MIX_WINDOW = 20;
+/**
+ * 静默多久才算"值得写进事实"（毫秒）。
+ * 低于这个数的"刚刚还在产出"不是事实、只是噪声 —— 写进 prompt 会挤掉有用的话，
+ * 显示在卡片上会让每一条都挂个"静默 2 秒"。
+ */
+export const SILENT_NOTABLE_MS = 60 * 1000;
+
+/** 输出里的最后一行有效文本 —— 模型最近说的一句话，比第一行更能说明"现在在干嘛" */
+export function tailLine(output) {
+  const text = typeof output === 'string' ? output : '';
+  if (!text) return '';
+  const lines = text.split('\n');
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i].replace(/\s+/g, ' ').trim();
+    if (line) return line.slice(0, MAX_LINE_CHARS);
+  }
+  return '';
+}
+
+/**
+ * 「最后回复」摘录最多多少字。
+ *
+ * 100 是按"卡片上放得下多少"倒推的：卡片宽 200–500px、字号 var(--font-size-xs)，
+ * 一行约 25–35 个汉字、卡片最多显示 3 行（.kb-card__reply 的 line-clamp），
+ * 于是 2000px 宽的窗口（本机实测）刚好整段显示得完；窗口更窄时尾部会被 CSS 截掉
+ * 几个字（`…` 是诚实的标记，完整摘录在悬停提示里）。
+ *
+ * 这个数**不能再小**：截断的是头部，而模型收尾那句反问（「要 push 吗？」）常常落在
+ * 倒数第 80–100 字之间 —— 给 80 字就会把它整句丢掉，反而是这个功能最不该丢的东西。
+ * 也不能再大：多出来的部分只会被 CSS 从尾巴切掉，白白把有用的开头挤出去。
+ */
+export const MAX_REPLY_CHARS = 100;
+
+/**
+ * 摘录前先切的尾部窗口。
+ *
+ * 为什么要先切窗口再分行：单条 job 的 output 上限是 100MB（taskRunner 的 MAX_OUTPUT），
+ * 而看板是 5s 轮询一次、每次都要给几十张卡片算这个字段 —— 对着整份输出 split 一遍是
+ * 白白烧 CPU（切片是 O(1) 的 SlicedString，split 不是）。4000 字符足够覆盖一整段收尾。
+ */
+export const REPLY_WINDOW_CHARS = 4000;
+
+/** 纯装饰行（表格分隔线 / 水平线），留着只是噪声 */
+const DECOR_LINE = /^\s*[|:\-\s=]+\s*$/;
+/** Markdown 表格行（`| 项 | 结果 |`）：压成一行文字后只剩一堆竖线，整行丢掉 */
+const TABLE_LINE = /^\s*\|.*\|\s*$/;
+/** 行首的标题 / 列表 / 引用标记 —— 压平成一句话之后它们不再是结构，只是噪声 */
+const LINE_MARKER = /^\s*(?:#{1,6}\s+|[-*+]\s+|>\s*)/;
+/** 行内强调与行内代码的标记。**不**去掉 `_`：它会命中 snake_case 的标识符 */
+const INLINE_MARKER = /\*\*|`/g;
+
+/**
+ * 从执行输出里摘出「最后说了什么」—— 看板「已完成」卡片上那一行。
+ *
+ * 与 tailLine 的分工：tailLine 是**正在跑**时用的，只要最新那一句（"它现在在干嘛"）；
+ * 这里是**跑完之后**用的，要一小段（"它最后交代了什么"）。后者才是"这任务是不是真完了"
+ * 的证据 —— 模型经常在收尾时反问一句「要 push 吗？」，只看标题的话，用户根本不知道
+ * 这条已经完成的任务其实在等他一句话。
+ *
+ * 三条规矩：
+ *   1. 只取**尾部**：一段回复的重点在收尾，不在开头；
+ *   2. 丢掉表格行、行首标记、`**`/反引号，压平成一句话（卡片上没有富文本，留着只是噪声）；
+ *   3. 真截断过才在前面加 `…`（没截就不加，`…` 是"这句话从中间开始"的诚实标记）。
+ */
+export function tailExcerpt(output, { maxChars = MAX_REPLY_CHARS, windowChars = REPLY_WINDOW_CHARS } = {}) {
+  const raw = typeof output === 'string' ? output : '';
+  if (!raw) return '';
+
+  // 窗口起点多半落在半句话中间：从窗口内的第一个换行之后开始取，摘录才不会以半句开头。
+  // 窗口内一个换行都没有（单行超长输出）时只能整段用，此时下面的截断会补上 `…`。
+  // 没切窗口（输出本来就短）时不动第一行 —— 那是完整的一句，不是半截。
+  const cutWindow = raw.length > windowChars;
+  const windowed = cutWindow ? raw.slice(-windowChars) : raw;
+  const body = cutWindow ? windowed.slice(windowed.indexOf('\n') + 1) : windowed;
+
+  const flat = body
+    .split('\n')
+    .filter(line => !DECOR_LINE.test(line) && !TABLE_LINE.test(line))
+    .map(line => line.replace(LINE_MARKER, '').replace(INLINE_MARKER, '').replace(/\s+/g, ' ').trim())
+    .filter(Boolean)
+    .join(' ');
+
+  if (!flat) return '';
+  // 从尾部取：上面已经说明过为什么宁丢开头不丢结尾
+  return flat.length > maxChars ? `…${flat.slice(-maxChars).trim()}` : flat;
+}
+
+/**
+ * 最近一次工具调用的一句话描述（如 `Edit src/ui/client/src/App.vue`）。
+ * 从后往前找：数组里最后一条未必带 name（老数据 / 半截记录），跳过它们而不是返回空。
+ */
+export function describeLastTool(toolCalls) {
+  const list = Array.isArray(toolCalls) ? toolCalls : [];
+  for (let i = list.length - 1; i >= 0; i--) {
+    const call = list[i];
+    if (!call || !call.name) continue;
+    const name = String(call.name).slice(0, MAX_TOOL_NAME_CHARS);
+    const raw = typeof call.argsPreview === 'string' && call.argsPreview
+      ? call.argsPreview
+      : (typeof call.arguments === 'string' ? call.arguments : '');
+    const args = String(raw || '').replace(/\s+/g, ' ').trim().slice(0, MAX_TOOL_CHARS);
+    return args ? `${name} ${args}` : name;
+  }
+  return '';
+}
+
+/**
+ * 最近 N 次工具调用的名字分布（`Bash×14 · Read×5`，从多到少）。
+ *
+ * 为什么需要它：只给"最近一次调用"时，看不出 119 次里有 118 次在干同一件事 ——
+ * 于是只能写"无法判断是在改代码还是反复读文件"。名字为空的老记录 / 半截记录跳过，
+ * 但不占窗口名额（否则一串空名字会把整段分布挤没）。
+ */
+export function describeToolMix(toolCalls) {
+  const list = Array.isArray(toolCalls) ? toolCalls : [];
+  const counts = new Map();
+  let seen = 0;
+  for (let i = list.length - 1; i >= 0 && seen < TOOL_MIX_WINDOW; i--) {
+    const call = list[i];
+    if (!call || !call.name) continue;
+    seen++;
+    const name = String(call.name).slice(0, MAX_TOOL_NAME_CHARS);
+    counts.set(name, (counts.get(name) || 0) + 1);
+  }
+  if (!counts.size) return '';
+  return [...counts.entries()]
+    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+    .map(([name, n]) => (n > 1 ? `${name}×${n}` : name))
+    .join(' · ')
+    .slice(0, MAX_MIX_CHARS);
+}
+
+/**
+ * 距最后一次产出（正文 / 思考 / 工具调用）多久。
+ * 没有 `lastActivityAt`（老记录、别实例上的旧版进程）或还没到阈值 → null，
+ * 调用方据此决定"这条不显示"，而不是显示一个假的 0。
+ */
+export function silentMsOf(job, now) {
+  const last = Date.parse((job && job.lastActivityAt) || '');
+  if (!Number.isFinite(last)) return null;
+  const ms = Math.max(0, now - last);
+  return ms >= SILENT_NOTABLE_MS ? ms : null;
+}
+
+/** job 是否算"正在跑"（看板卡片只在此时显示活动摘要） */
+export function isLiveJob(job) {
+  return !!job && (job.status === 'running' || job.status === 'pending');
+}
+
+/**
+ * 单条 job → 卡片 / 报告可用的活动摘要。非 running/pending 返回 null（调用方据此不显示）。
+ *
+ * 时间戳用**毫秒时长**（elapsedMs / silentMs）而不是 ISO：
+ * 前端两个视图都拿 formatDurationMs 格式化，跨实例读来的记录也一样能算出时长。
+ *
+ * @param {object} job  执行记录（内存里的原始对象，或 projectJob 投影）
+ * @param {number} now  参照时刻，便于单测
+ */
+export function buildLiveActivity(job, now = Date.now()) {
+  if (!isLiveJob(job)) return null;
+  const started = Date.parse(job.startedAt || '');
+  return {
+    jobId: job.id || '',
+    status: job.status,
+    /** 本轮执行器（claude | opencode | codex）。老记录没有这个字段 → 空串 */
+    agent: typeof job.agent === 'string' ? job.agent : '',
+    startedAt: job.startedAt || null,
+    elapsedMs: Number.isFinite(started) ? Math.max(0, now - started) : 0,
+    /** 见 taskRunner 的 MAX_TOOL_CALLS：超上限的调用不再入数组，所以这是"至少这么多次" */
+    toolCallCount: Array.isArray(job.toolCalls) ? job.toolCalls.length : 0,
+    lastTool: describeLastTool(job.toolCalls),
+    toolMix: describeToolMix(job.toolCalls),
+    /** 最近一段思考。多数任务一句正文都不写，它是"它在干嘛"最直接的证据 */
+    lastThought: tailLine(job.thinking),
+    /** 最新的回复（正文最后一行），空串 = 这轮还没写过正文 */
+    lastLine: tailLine(job.output),
+    silentMs: silentMsOf(job, now),
+  };
+}
+
+/** 最近一次产出的时刻，取不到时回落到启动时刻 */
+function activityTimestamp(job) {
+  return Date.parse(job.lastActivityAt || '') || Date.parse(job.startedAt || '') || 0;
+}
+
+/**
+ * 一个任务可能同时有好几条 job 在跑（并行的子任务 / 连点两次执行），
+ * 卡片只放得下一条 —— 挑**最近有动静的**那条：用户问"现在在干嘛"时，
+ * 刚吐过字的那个才是答案，跑得最久的那个未必。
+ *
+ * 时间戳打平时按原顺序取末条（与 latestJob 同口径）。
+ *
+ * @returns {object|null} buildLiveActivity 的结果；没有在跑的 job 时 null
+ */
+export function pickLiveActivity(jobsForTask, now = Date.now()) {
+  const list = Array.isArray(jobsForTask) ? jobsForTask : [];
+  let best = null;
+  let bestAt = -Infinity;
+  for (const j of list) {
+    if (!isLiveJob(j)) continue;
+    const at = activityTimestamp(j);
+    if (at >= bestAt) {
+      best = j;
+      bestAt = at;
+    }
+  }
+  return best ? buildLiveActivity(best, now) : null;
+}
+
+export const __testables = {
+  tailLine,
+  tailExcerpt,
+  describeLastTool,
+  describeToolMix,
+  silentMsOf,
+  buildLiveActivity,
+  pickLiveActivity,
+};