magic-agent 1.0.49 → 1.0.109

package/README.md

@@ -128,13 +128,13 @@ magic-agent --engines --no-models | jq -r '.[] | select(.install) | "\(.engine)\
 ### 客户端契约（`--contract`）
 
 ```bash
-magic-agent --contract                              # {"contractVersion":1,"engines":[...]}
+magic-agent --contract                              # {"contractVersion":2,"engines":[...]}
 magic-agent --contract | jq -r '.contractVersion'   # 启动时先校验这个
 ```
 
 | 字段 | 含义 |
 |------|------|
-| `contractVersion` | 契约面版本（当前 `1`）。客户端超出自己支持的范围就明确报错并提示升级，不要带着不匹配的能力继续跑 |
+| `contractVersion` | 契约面版本（当前 `2`）。客户端超出自己支持的范围就明确报错并提示升级，不要带着不匹配的能力继续跑 |
 | `engines` | 与 `--engines` 的行完全同构，每行另含 `capabilities` |
 
 版本规则：**只增字段不升版本**；字段改名 / 语义变化 / 删除时必须升 `contractVersion`。`--contract` 默认**不探测模型**（模型探测要起真 CLI，30 秒级，客户端启动路径等不起），要连模型一起拿就写 `--no-models=false`。
@@ -245,6 +245,29 @@ magic-agent -e claude --stream --keep-alive=false -p "..."       # 要「一轮
 
 > ⚠️ **默认常驻带来的行为变化**：进程会在最后一轮结束后继续存活 `--idle` 等待追加。调用方若要「一轮完成」的信号，请读事件流里的 **`turn_end`** 事件（而不是等进程退出），或启动时传 `--keep-alive=false`。
 
+## 需求聚合（`--requirements` / `--consolidate-requirements`）
+
+把会话里聊过的需求自动归纳成「模块 → 功能点」两级 markdown 文档，存储在
+`~/.magic-agent/requirements/`（`MAGIC_AGENT_REQUIREMENTS` 可覆盖）。
+
+```bash
+magic-agent --requirements all                     # 列全部工作区（只读，不调模型）
+magic-agent --requirements ~/work/proj             # 只列这个目录（也认 ws id）
+magic-agent --consolidate-requirements ~/work/proj # 手动整理：首次=按目录初始化，之后只处理新会话
+magic-agent --consolidate-requirements . --requirement-all   # 全量重放（回填/校正）
+```
+
+- **第一次整理 = 初始化**：工作区还没初始化过时，先有界扫描空间目录，用**客户端配置的默认
+  引擎**（`--requirement-engine`；空 = 自动挑 claude / codebuddy / codex / dsh 等能读代码的）
+  反推一版用户视角的需求基线；此前旧会话记为已消费，之后只消费上次整理后的新会话。
+  默认引擎不能读目录（如 `llm`）会明确报错并提示换引擎。目录为空不算失败，会回落到会话增量。
+- **自动归纳只增量**：插件在每轮对话收尾后防抖 12s 自动归纳（`MAGIC_CLIENT_NO_REQ_AUTO=1`
+  关闭），它带 `--requirement-auto`，**绝不触发首次目录初始化**。
+- 需求页每个空间组头有独立「整理」，只整理那个空间；顶栏「全部整理」按空间串行跑一遍，
+  一键触发全部（某个空间失败不影响后面的）。没有新会话时返回 `noop`，不会空跑一次模型。
+
+详细契约见 [CLIENT-CONTRACT.md](CLIENT-CONTRACT.md) §3.4.1。
+
 ## 停止指定会话
 
 ```bash
@@ -454,6 +477,12 @@ magic-client serve --ui-dir magic-h5
 数据从 IPC→CLI 或自有后端来都行（参考 `client-ui/shared/transport-http.js` 与
 `CLIENT-CONTRACT.md` 的事件流形状）。
 
+> 输入框支持**粘贴 / 拖入图片**：组件与 ＋ 菜单共用同一条管线，走可选的
+> `transport.upload(file)` → magic-client 的 `POST /desk/upload` 落盘（返回 core 那台机器的
+> 绝对路径），路径随后随 `payload.attachments` 下发给引擎。自定义 transport 想支持贴图，
+> 补上 `upload(file)`（返回 `{path, name, size, url}`）即可；没有这个方法时组件会如实提示
+> 「当前传输层不支持上传附件」，不会假装贴上了。
+
 ## 更多文档
 
 | 文档 | 内容 |

package/client-ui/pc/app.css

@@ -5089,43 +5089,9 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
 .qa-fc-p{flex:1;min-width:0;font-family:var(--mono);font-size:10px;color:var(--paper-dim);
   white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 
-/* ---- TodoWrite 待办清单（qaTodoNode；从 TodoWrite/update_plan 参数推导）----
-   与 .qa-fc 同一帧语言：同高的汇总头 + 内容区；状态只落 class。 */
-.qa-todo{min-width:0}
-.qa-todo-hd{display:flex;align-items:center;height:26px;padding:0 8px;
-  border-bottom:1px solid var(--line);background:rgba(28,25,23,.028)}
-.qa-todo-sum{font-family:var(--mono);font-size:10px;color:var(--paper-mute);
-  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.qa-todo-list{padding:5px 8px 7px}
-.qa-todo-row{display:flex;align-items:baseline;gap:7px;padding:2.5px 0;
-  font-size:11.5px;line-height:1.5;color:var(--paper-dim)}
-.qa-todo-ico{width:12px;height:12px;flex:none;align-self:center;border-radius:50%;
-  border:1.3px solid var(--line);display:grid;place-items:center;color:#FFF}
-.qa-todo-ico svg{width:8px;height:8px;display:block;stroke:currentColor;fill:none;
-  stroke-width:3;stroke-linecap:round;stroke-linejoin:round}
-.qa-todo-row.is-in_progress{color:var(--paper);font-weight:600}
-.qa-todo-row.is-in_progress .qa-todo-ico{border-color:var(--amber);color:var(--amber)}
-.qa-todo-row.is-completed{color:var(--paper-mute)}
-.qa-todo-row.is-completed .qa-todo-ico{border-color:var(--jade);background:var(--jade)}
-.qa-todo-row.is-completed .qa-todo-t{text-decoration:line-through}
-
-/* ---- 「任务列表」面板形态（.qa-todo-panel；一条应答只有一块，见 03-chat-message 的 todoList）----
-   与工具卡明细里那一段（无标题）共用上面那套帧语言，只多三样：左侧标题、右端计数与开合箭头、
-   收起时藏列表（标题栏留着 —— 收起的是一份清单，不是一个入口）。
-   开合态只落 `open` 类：快照恢复走 `innerHTML = snapshot`，类跟着还原，不会「恢复后又弹开」。 */
-.qa-todo-panel{min-width:0;margin:0 0 8px;border:1px solid var(--line);
-  border-radius:var(--r-md);overflow:hidden;background:#FFF}
-.qa-todo-panel .qa-todo-hd{gap:7px}
-.qa-todo-tt{flex:none;font-size:11.5px;font-weight:600;color:var(--paper)}
-/* 计数推到右端（只对面板生效：工具卡里那一段是唯一子节点，不该被推走任何东西） */
-.qa-todo-panel .qa-todo-sum{margin-left:auto}
-.qa-todo-toggle{flex:none;display:grid;place-items:center;width:16px;height:16px;
-  border-radius:4px;color:var(--paper-mute);cursor:pointer}
-.qa-todo-toggle:hover{background:rgba(28,25,23,.05)}
-.qa-todo-toggle svg{width:11px;height:11px;fill:none;stroke:currentColor;stroke-width:2.4;
-  stroke-linecap:round;stroke-linejoin:round;transition:transform .15s}
-.qa-todo-panel.open .qa-todo-toggle svg{transform:rotate(180deg)}
-.qa-todo-panel:not(.open) .qa-todo-list{display:none}
+/* ---- 待办清单 / 任务列表（.qa-todo*）：皮肤已收进共用副本 ----
+   见 client-ui/shared/conv/conv.css（三端同一份，含面板形态与失败/跳过两档）。
+   本文件**不再**重复定义这一族，否则两边各改一半会各自漂移。 */
 
 /* ---- 助手图片块（KindImage / P0-1）----
    正文区（.qa-t）与委派卡嵌套区（.qa-sub）共用同一张图卡：细边 + 圆角、宽度自适应
@@ -5171,10 +5137,6 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
 [data-theme="dark"] .qa-cf-bd pre,[data-theme="dark"] .qa-tool-sec pre{
   color:#D6D3D1;background:transparent}
 [data-theme="dark"] .qa-tool-bd > * + *,[data-theme="dark"] .qa-fc-hd{border-color:#3B3835}
-[data-theme="dark"] .qa-todo-hd{background:rgba(245,244,243,.045);border-color:#3B3835}
-[data-theme="dark"] .qa-todo-ico{border-color:#57534E}
-[data-theme="dark"] .qa-todo-row.is-in_progress{color:#F5F4F3}
-[data-theme="dark"] .qa-todo-row.is-completed{color:#A8A29E}
 [data-theme="dark"] .qa-img{border-color:#3B3835}
 [data-theme="dark"] .qa-cf-copy:hover{background:rgba(245,244,243,.09);color:#F5F4F3}
 [data-theme="dark"] .qa-mk-row[data-tog="1"]:hover{background:rgba(245,244,243,.05)}

package/client-ui/pc/js/04-task-list.js

@@ -121,9 +121,13 @@ function qaPermOf(id){ return QA_PERMS.find(x=>x.id === id) || QA_PERMS.find(x=>
 /* 模型 id → 可读模型名：**只用于显示**（模型按钮 / 对话「生成中」行 / 需求看板卡片 / 提示行 / toast）。
    查法 = 按 id 在该引擎的 modelLabels 里找（llm 配置文件里的 name，或 llm 配置的 model_name）；
    当前引擎查不到时扫全部引擎的标签（看板里的需求可能属于别的引擎），再查不到就原样返回 id。
-   ⚠️ 透传给 CLI 的 `-m`、任务 / 需求落库、派发参数一律仍用 id —— 名字只活在展示层。 */
+   ⚠️ 透传给 CLI 的 `-m`、任务 / 需求落库、派发参数一律仍用 id —— 名字只活在展示层。
+   ⚠️ 入参可能是带 `custom-local:` 前缀的完整 id（会话登记表 / start 事件都是这种），
+      而 `--engines` 的清单与标签表**早已剥过前缀**（见 agent.StripCustomLocalPrefix）——
+      不剥就会查不到标签、把整串 id 连前缀一起显示出来。剥完再查（2026-10-21 用户：
+      「codebuddy的custom-local的模型前缀不用显示」），查不到时的兜底也用剥过的形状。 */
 function qaModelName(id, engine){
-  const key = String(id || "");
+  const key = String(id || "").replace(/^custom-local:/, "");
   if(!key) return "";
   const hit = (e)=> (e && e.modelLabels && e.modelLabels[key]) || "";
   return hit(qaEngines.find(x=>x.engine === (engine || qaEngine)))

package/client-ui/pc/js/90-glue.js

@@ -146,10 +146,29 @@ function normalizeEngineRow(r){
         .catch(() => ({ ok: false, engines: [] }));
     },
 
-    /* 附件落盘：上游是 Electron 的 pasteImage（把图写进磁盘并回路径）。
-       这里没有本地壳，**不假装成功** —— 明说这一版还不支持粘贴落盘。 */
-    pasteImage() {
-      return Promise.reject(new Error("这一版（浏览器宿主）还不支持粘贴截图落盘：需要宿主提供 pasteImage 通道"));
+    /* 附件落盘：Electron 壳给的是 IPC 直写（`desk.pasteImage`，把图写进磁盘并回路径）；
+       浏览器宿主没有本地壳，走 magic-client 自己的 `POST /desk/upload` —— 文件落到 core 那台
+       机器的临时目录、回绝对路径，与移动端「先上传再下发」是同一条通道（不是假装成功）。
+       返回形状与 IPC 那份对齐：{ok, item:{name, path, url, bytes}}，内核按它校验（缺 path 即失败）。 */
+    pasteImage(p) {
+      const buf = (p && p.buf) || null;
+      if (!buf) return Promise.resolve({ ok: false, error: "没有收到图片数据" });
+      const type = (p && p.type) || "image/png";
+      const ext = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp",
+        "image/gif": "gif", "image/bmp": "bmp" }[type] || "png";
+      const d = new Date();
+      const pad = (n)=> String(n).padStart(2, "0");
+      /* 名字给人看、也给下游按扩展名认图；真正落盘的文件名由服务端加时间戳前缀去重。 */
+      const name = "paste-" + d.getFullYear() + pad(d.getMonth() + 1) + pad(d.getDate())
+        + "-" + pad(d.getHours()) + pad(d.getMinutes()) + pad(d.getSeconds()) + "." + ext;
+      let file;
+      try { file = new File([buf], name, { type }); }
+      catch (e) { file = new Blob([buf], { type }); }      // 老内核没有 File 构造器
+      return transport.upload(file).then((r)=>({
+        ok: true,
+        item: { name: (r && r.name) || name, path: (r && r.path) || "",
+          url: (r && r.url) || "", bytes: (r && r.size) || 0 },
+      }), (e)=>({ ok: false, error: String((e && e.message) || e) }));
     },
     /* 任务本地库（SQLite）：magic-agent 没有本地库 —— 空清单 + 写入如实回「跳过」。
        04-task-list.js 的 qaDb* 会把这些结果当「桥不可用」，于是只走 localStorage。 */

package/client-ui/pc/js/92-composer.js

@@ -110,13 +110,15 @@ function qaEngMenuBuild(){
   qaAskEach("-engine-menu", m=>{ m.innerHTML = html; });
   qaMenuReplace();
 }
-/** 模型菜单：首项「自动」（按配置链的链首），其后是该引擎探测到的模型。原样搬自上游。 */
+/** 模型菜单：首项「自动」（按配置链的链首），其后是该引擎探测到的模型。原样搬自上游。
+ *  ⚠️ 展示名一律经 qaModelName（已剥 `custom-local:` 前缀，见 04-task-list.js）：
+ *     这里的 `id` 可能是任务 / 会话带回来的完整 id，而 `labels` / `credits` 是按
+ *     `--engines` 那份已剥前缀的清单建的 —— 直接用 id 当名字就会把前缀露出来。 */
 function qaMdlMenuBuild(){
   const auto = qaModelAuto();
   const e = qaEngines.find(x=>x.engine === qaEngine) || null;
-  const labels = (e && e.modelLabels) || {};
   const credits = (e && e.modelCredits) || {};
-  const crOf = (id)=>{ const v = String(credits[id] || "").trim(); return v ? "x" + v : ""; };
+  const crOf = (id)=>{ const v = String(credits[qaModelText(id)] || "").trim(); return v ? "x" + v : ""; };
   const ids = (e && Array.isArray(e.models) ? e.models : []).map(m=>String(m||"")).filter(Boolean);
   const autoName = auto ? qaModelName(auto, qaEngine) : "引擎默认";
   const autoCr = auto ? crOf(auto) : "";
@@ -126,7 +128,7 @@ function qaMdlMenuBuild(){
       if(auto === id) bits.push("链首");
       const cr = crOf(id);
       if(cr) bits.push(cr);
-      return { id, name: labels[id] || id, note: bits.join(" · ") };
+      return { id, name: qaModelName(id, qaEngine), note: bits.join(" · ") };
     }));
   const html = '<span class="ag-menu-cap">模型</span>' + opts.map(m=>
     `<button class="ag-model-opt" data-model="${escHtml(m.id||"")}" type="button" role="option" aria-selected="false" title="${escHtml(m.id ? ("指定模型 · 下发给 -m " + m.id) : ("自动 · 按设置里「" + qaEngine + "」的模型链（链首 " + autoName + "）"))}">
@@ -401,6 +403,11 @@ function qaComposerInit(){
      漏了它的表现是「卡片画出来了但点不动」，而且不报错（绑定函数自己只是加监听）。
      `bindNavTasks()` 是左栏那一套（本版没有左栏），刻意不调。 */
   if(typeof bindQaStreamDelegation === "function") bindQaStreamDelegation();
+  /* 内核的「用户离开底部」闸（2026-10-21）：`qaUserAway` 由它维护，而 `qaScrollIntoView`
+     靠它决定要不要把画布贴到底。那段监听原来只写在圆点轨的 qaDotsBind 里（本版没调），
+     闸恒开 → 用户上滚看历史时被每一笔流式增量拽回结尾（移动端报障的同一根因）。
+     幂等：重复调用不会再绑一遍。 */
+  if(typeof qaScrollGateBind === "function") qaScrollGateBind();
   /* 引擎清单异步取回后再重刷一次（拿不到就保持兜底清单，界面不开天窗） */
   qaEnginesFetch(false);
 }

package/client-ui/pc/js/93-rail.js

@@ -19,6 +19,10 @@
 
 const QA_RAIL_MAX = 60;             // 一屏最多画多少行（CLI 的登记表可能有几百条）
 const QA_RAIL_POLL_MS = 30000;      // 有会话在跑时的兜底轮询（其余时候靠「一轮结束」触发）
+const QA_RAIL_TAIL_MS = 2500;       // 打开一条 running 会话时的进度同步间隔（见 qaRailTailStart）
+/* 一条会话「这一轮结束了」的事件名（与 core 的归一化词表同名）。
+ * ⚠️ 只在**增量**里判：打开时回放到的老终态事件不算数（那条会话可能又在新一轮里跑着）。 */
+const QA_RAIL_TERM_KINDS = ["turn_end", "turn_failed", "result", "error", "interrupted", "stopped", "end"];
 
 let qaRailAll = [];                 // 最近一次拉到的会话（宿主归一后的行）
 let qaRailSkipped = 0;              // 被略掉的一次性调用条数（如实写在列表下方）
@@ -29,22 +33,32 @@ let qaRailErr = "";
 let qaRailLoaded = false;
 let qaRailTimer = null;
 let qaRailMenuEl = null;
+let qaRailTail = null;              // 正在同步的那条 running 会话（见 qaRailTailStart）
 
-/** 会话落到哪一档（左栏分组）—— 判据全部来自 CLI 给的 state / alive。
+/** 这条会话的**统一状态**（CLI 的 `--sessions` 行里的 `status`，会话级、与标题同源保存）。
+ *  ⚠️ 优先读 `status`，没有再回落 `state`：`state` 是**这一轮**的状态（同一条会话每轮一个
+ *  记录，各说各的），两端挑中不同轮就会得出不同结论（2026-10-21 报障「PC 已完成、移动端
+ *  还在排队」）。`status` 是会话级唯一口径；老版本 CLI 不给这个字段时回落，行为不变。 */
+function qaRailState(s){
+  return String((s && (s.status || s.state)) || "");
+}
+/** 会话落到哪一档（左栏分组）—— 判据全部来自 CLI 给的 status / state / alive。
  *  ⚠️ 状态词与 magic-agent 的记录、agents-anywhere 的 TimelineStatus 对齐（2026-09-29）：
  *    running / waiting_approval / done / failed / cancelled / interrupted / gone。
  *    `waiting_approval` 必须算**进行中** —— 它没在跑，但也没结束；归到「已完成」的话，
- *    用户会看到「我还在等它回话，它却已完成」。 */
+ *    用户会看到「我还在等它回话，它却已完成」。
+ *    `idle`（常驻会话本轮已结束、进程还在等追加）**不算进行中**，落到「已完成」—— 与
+ *    PC 按事件流显示的口径一致（2026-10-21）。 */
 function qaRailGroup(s){
   if(!s) return "done";
-  const st = String(s.state || "");
+  const st = qaRailState(s);
   if(s.alive || st === "running") return "live";
   if(st === "waiting_approval") return "live";
   if(st === "failed" || st === "gone") return "failed";
   return "done";
 }
 function qaRailGroupLabel(s){
-  const st = String((s && s.state) || "");
+  const st = qaRailState(s);
   const g = qaRailGroup(s);
   if(g === "live") return st === "waiting_approval" ? "等审批" : "进行中";
   if(g === "failed") return "失败";
@@ -146,7 +160,7 @@ function qaRailRender(){
     box.innerHTML = rows.map((s) => {
       const g = qaRailGroup(s);
       const title = s.title || "(无标题会话)";
-      const sub = [s.engine, s.model].filter(Boolean).join(" · ");
+      const sub = [s.engine, qaModelName(s.model, s.engine)].filter(Boolean).join(" · ");
       const tip = [title, sub, s.workspace, s.sessionId || s.runId, s.updatedAt,
         noLog(s) ? "这条会话没有留下事件日志（引擎当时是非流式跑的），点开看不到历史" : ""]
         .filter(Boolean).join("\n");
@@ -194,36 +208,162 @@ function qaRailEnsureTask(s){
   t.engine = s.engine || t.engine || qaEngine;
   t.model = s.model || "";
   t.sessionId = s.sessionId || "";
-  t.status = qaRailGroup(s) === "live" ? "running" : (s.state === "failed" ? "error" : "done");
+  const st = qaRailState(s);
+  t.status = qaRailGroup(s) === "live" ? "running" : (st === "failed" ? "error" : "done");
+}
+
+/** 历史回放的渲染上下文：打开一条会话时建一份，**增量同步继续用同一份** ——
+ *  `h` 是当前这条应答块，`tools` / `agents` 是工具卡与委派卡的登记表。
+ *  分开建的话，tail 收到的 tool_result 会找不到自己那张卡（凭空多出一张「结果」卡）。 */
+function qaRailCtx(s){
+  return {
+    h: null, tools: new Map(), agents: new Map(), rid: 0, taskId: qaActiveId,
+    s: s, seq: 0, count: 0,
+  };
 }
 
-/** 历史回放：kind 与渲染层事件**同名词表**，所以逐条喂进 qaStreamApply 即可。
- *  `user` 那条不是渲染层事件（它是 core 补记的用户提问），走 qaRenderMine 画成用户气泡。 */
-function qaRailReplay(events, s){
+/** 逐条喂进 qaStreamApply（与实时同一条渲染管线）。
+ *  回放 / 增量都走这里；`user` 那条不是渲染层事件（core 补记的用户提问），
+ *  走 qaRenderMine 画成用户气泡，并把这一轮的应答块**收口**（下一轮另起一块）。
+ *  ⚠️ 只读：台账 / 会话绑定 / 收尾动作一律不落笔（历史不该改写现在）。
+ *  返回实际消费的事件条数（增量游标按它对齐）。 */
+function qaRailApply(ctx, events){
   const list = Array.isArray(events) ? events : [];
-  let h = null;
+  let n = 0;
   for(const ev of list){
     const kind = String((ev && ev.kind) || "");
     if(!kind) continue;
-    if(kind === "user"){ qaRenderMine(String(ev.text || ""), []); continue; }
-    if(!h){ h = qaRenderAnswer(); if(!h) break; }
+    n += 1;
+    const sq = Number(ev && ev.seq);
+    if(Number.isFinite(sq) && sq > ctx.seq) ctx.seq = sq;
+    if(kind === "user"){
+      ctx.h = null;
+      qaRenderMine(String(ev.text || ""), []);
+      continue;
+    }
+    if(!ctx.h){ ctx.h = qaRenderAnswer(); if(!ctx.h) break; }
     try{
       qaStreamApply(Object.assign({}, ev, { type: kind }), {
-        h, tools: new Map(), agents: new Map(), rid: 0, taskId: qaActiveId,
-        /* 回放是**只读**的：台账 / 会话绑定 / 收尾动作一律不落笔（历史不该改写现在） */
+        h: ctx.h, tools: ctx.tools, agents: ctx.agents, rid: 0, taskId: ctx.taskId,
         setMs(){}, onText(){}, onStep(){}, onSession(){}, onError(){}, onDone(){},
       });
     }catch(e){ console.warn("[rail] 回放事件失败 " + kind + "：", (e && e.message) || e); }
   }
-  if(!h && !list.some((e) => String(e.kind || "") === "user")){
+  ctx.count += n;
+  return n;
+}
+
+/** 全量回放。`live=true` 时不写「历史回放」收尾行 —— 这条会话还在跑，
+ *  收尾行由 tail 在终态那一刻补（见 qaRailTailStart）。返回上下文供 tail 续用。 */
+function qaRailReplay(events, s, live){
+  const list = Array.isArray(events) ? events : [];
+  const ctx = qaRailCtx(s);
+  qaRailApply(ctx, list);
+  if(!ctx.h && !list.some((e) => String((e && e.kind) || "") === "user")){
     qaRenderDone(true, "这条会话没有留下事件", $("#qa-stream"));
-    return;
+    return ctx;
   }
-  if(h){
+  if(ctx.h && !live){
     /* 收尾行按会话自己的状态给一句（历史是只读的，不显示「生成中」那种活状态） */
     const g = qaRailGroup(s);
-    qaRenderDone(g !== "failed", g === "failed" ? "上次调用失败" : (g === "live" ? "这条会话当时还在跑" : "历史回放"), $("#qa-stream"));
+    qaRenderDone(g !== "failed", g === "failed" ? "上次调用失败" : "历史回放", $("#qa-stream"));
   }
+  return ctx;
+}
+
+/* ---------- running 会话的进度同步（跨进程） ----------
+ * 用户 2026-10-21：「running 状态的就同步一下进度」—— 移动端 / CLI 起的会话，
+ * 在桌面这边点开时不能只看到点开那一刻的快照。
+ *
+ * 数据源仍是宿主的 `desk.agentSessionLog`（背后是 `magic-agent --session-log`，
+ * 读的是磁盘上那条 `<id>.jsonl`，**与跑它的进程无关**），所以本进程之外起的轮次
+ * 一样能追。宿主只给一次性全量读取，于是这里定时重读、按游标只喂新增的那几条：
+ *   · 宿主若把 `after` 透传给了 core（`--session-log --after <seq>`），回来的就是纯增量；
+ *   · 没透传／老 core → 回来是全量，按**条数**对齐（seq 在旧版 writer 里每轮会回落，不能当游标）。
+ * 停表的三种情形：收到终态事件（再补一拍，收尾行可能后到）／会话状态不再 live／
+ * 本机在这条会话上发了一轮（那一轮由本进程的实时管线自己画，别重复）。 */
+
+/** 全量回放之后再画一行「正在同步」，让「它还在跑」这件事在界面上有据可依。 */
+function qaRailLiveRow(text){
+  const box = $("#qa-stream"); if(!box) return null;
+  const d = document.createElement("div");
+  d.className = "qa-done qa-pin";
+  d.setAttribute("data-rail-live", "1");
+  d.innerHTML = `<span class="d"></span><span></span>`;
+  d.querySelector("span:last-child").textContent = text;
+  box.appendChild(d);
+  return d;
+}
+
+function qaRailTailStop(finishLabel){
+  const t = qaRailTail;
+  qaRailTail = null;
+  if(!t) return;
+  if(t.timer) clearInterval(t.timer);
+  if(t.marker && t.marker.parentNode) t.marker.remove();
+  if(t.notice && t.notice.parentNode) t.notice.remove();
+  if(finishLabel && qaActiveId === t.sid) qaRenderDone(true, finishLabel, $("#qa-stream"));
+}
+
+/** 从一次返回里挑出「还没画过」的事件。 */
+function qaRailTailFresh(ctx, list){
+  if(!list.length) return [];
+  const fseq = Number(list[0] && list[0].seq);
+  /* 纯增量：首条 seq 比已看到的还大（宿主把 after 透传下去了）。 */
+  if(ctx.seq > 0 && Number.isFinite(fseq) && fseq > ctx.seq) return list;
+  /* 全量：按条数对齐（只认物理顺序，与 seq 怎么编号无关）。 */
+  return list.length > ctx.count ? list.slice(ctx.count) : [];
+}
+
+function qaRailTailStart(s, ctx, notice){
+  qaRailTailStop();
+  const sid = String((s && s.id) || "");
+  if(!sid) return;
+  const tail = {
+    sid: sid, ctx: ctx, timer: null, busy: false, endAt: 0,
+    marker: qaRailLiveRow("这条会话正在运行 · 实时同步中"),
+    notice: notice || null,
+  };
+  qaRailTail = tail;
+
+  /* 读一次增量并落画。返回「这批里有没有终态事件」。读失败不掐连接（下一拍再试）。 */
+  const poll = async () => {
+    const d = window.desk;
+    if(!d || typeof d.agentSessionLog !== "function") return false;
+    let r = null;
+    try{ r = await d.agentSessionLog(sid, { after: ctx.seq }); }
+    catch(e){ return false; }
+    if(qaRailTail !== tail || qaActiveId !== sid) return false;
+    if(!r || !r.ok) return false;
+    const fresh = qaRailTailFresh(ctx, Array.isArray(r.events) ? r.events : []);
+    if(!fresh.length) return false;
+    if(tail.notice && tail.notice.parentNode){ tail.notice.remove(); tail.notice = null; }
+    qaRailApply(ctx, fresh);
+    /* 同步行永远压在队尾：新事件是 append 到 #qa-stream 的，不挪它会被压在下面。 */
+    if(tail.marker && tail.marker.parentNode) $("#qa-stream").appendChild(tail.marker);
+    qaScrollIntoView();
+    return fresh.some((ev) => QA_RAIL_TERM_KINDS.includes(String((ev && ev.kind) || "")));
+  };
+
+  const tick = async () => {
+    if(qaRailTail !== tail || tail.busy) return;
+    if(qaActiveId !== sid){ qaRailTailStop(); return; }
+    /* 本机正在这条会话上跑一轮：那一轮由实时管线自己画，tail 再画一遍就是双份。 */
+    if(typeof qaTaskRunning === "function" && qaTaskRunning(qaActiveId)){ qaRailTailStop(); return; }
+    tail.busy = true;
+    const final = !!tail.endAt && Date.now() >= tail.endAt;
+    let term = false;
+    try{ term = await poll(); } finally { tail.busy = false; }
+    if(qaRailTail !== tail) return;
+    if(final){ qaRailTailStop("已同步到最新"); return; }
+    if(term && !tail.endAt) tail.endAt = Date.now() + QA_RAIL_TAIL_MS;   // 下一拍补收尾行后停
+    if(!tail.endAt){
+      /* 登记表兜底：这一轮没发终态事件（被打断 / 进程被杀）时靠 state 收尾。 */
+      const row = qaRailAll.find((x) => x.id === sid) || null;
+      if(row && qaRailGroup(row) !== "live") tail.endAt = Date.now() + QA_RAIL_TAIL_MS;
+    }
+  };
+  tail.timer = setInterval(tick, QA_RAIL_TAIL_MS);
 }
 
 async function qaRailOpen(id){
@@ -233,7 +373,9 @@ async function qaRailOpen(id){
   const d = window.desk;
   if(!d || typeof d.agentSessionLog !== "function"){ toast("这一版没有会话历史通道"); return; }
   const box = $("#qa-stream"); if(!box) return;
+  const live = qaRailGroup(s) === "live";
 
+  qaRailTailStop();                                  // 换会话 → 上一条的同步停掉
   qaRailStowRun();
   qaActiveId = sid;
   qaRailEnsureTask(s);
@@ -248,7 +390,17 @@ async function qaRailOpen(id){
   catch(e){ r = { ok: false, error: String((e && e.message) || e) }; }
   if(qaActiveId !== sid) return;                     // 用户已经切走 → 丢弃这次结果
   box.innerHTML = "";
+
+  /* ⚠️ 这条会话还在跑时，「读不到 / 还没事件」都**不是**死路：
+     移动端刚起的那一轮，磁盘上可能连日志都还没建（core 先写登记表再开日志）。
+     如实说一句「在等」，然后把 tail 挂上 —— 第一批事件一到画面就长出来。 */
   if(!r || !r.ok){
+    if(live){
+      box.innerHTML = qaConvNoticeHtml("这条会话还在跑，暂时读不到事件（" +
+        ((r && r.error) || "未知原因") + "）—— 进度会自动接上。", "wait");
+      qaRailTailStart(s, qaRailCtx(s), box.firstElementChild);
+      return;
+    }
     box.innerHTML = qaConvNoticeHtml("读会话历史失败：" + ((r && r.error) || "未知原因") +
       "（老版 magic-agent 不认识 `--session-log`，设置里升级一下就好）", "lost");
     return;
@@ -257,18 +409,25 @@ async function qaRailOpen(id){
      引擎当时是**非流式**跑的，magic-agent 的事件日志只在流式调用时写。行上那个
      「无历史」标记说的就是这件事，这里把原因说得更细一点（会话本身还能继续追问）。 */
   if(!Array.isArray(r.events) || !r.events.length){
+    if(live){
+      box.innerHTML = qaConvNoticeHtml("这条会话正在运行 —— 等它产出第一批事件，这里会自动出现。", "wait");
+      qaRailTailStart(s, qaRailCtx(s), box.firstElementChild);
+      return;
+    }
     box.innerHTML = qaConvNoticeHtml(
       "这条会话没有留下事件日志（引擎当时是非流式跑的），所以看不到历史。" +
       "会话本身还在 —— 直接在这里追问，引擎会接着原来的上下文继续。", "lost");
     return;
   }
-  qaRailReplay(r.events, s);
+  const ctx = qaRailReplay(r.events, s, live);
+  if(live) qaRailTailStart(s, ctx, null);
   qaScrollIntoView();
 }
 
 /** 新建对话：把当前上下文清掉，下一句话就是**全新会话**（不带给引擎任何 --session）。 */
 function qaRailNew(){
   const box = $("#qa-stream");
+  qaRailTailStop();                                  // 上一条会话的同步别往清空后的画面里写
   qaRailStowRun();
   qaActiveId = null;
   if(box){ box.innerHTML = ""; box.hidden = true; }