magic-agent 2.4.3 → 2.6.0

package/README.md

@@ -17,7 +17,7 @@
 ```bash
 npm install -g magic-agent                      # 从 npmjs 全局安装（无需 Go）
 npm install -g ./magic-agent-<version>.tgz      # 从本地 tgz 安装（离线 / 内网）
-go build -o bin/magic-agent ./cmd/magic-agent   # 从源码构建（Go 1.26+）
+npm run build:current                           # 从源码构建当前平台（core + client，Go 1.26+）
 ```
 
 > ⚠️ 截至 2026-09-28，npmjs 上还查不到 `magic-agent`（首次正式发布尚未发生），
@@ -36,7 +36,7 @@ go build -o bin/magic-agent ./cmd/magic-agent   # 从源码构建（Go 1.26+）
 | claude | Claude Code | `MAGIC_AGENT_CLAUDE_BIN` → `/opt/homebrew/bin/claude` → PATH |
 | codebuddy | CodeBuddy Code CLI（`npm i -g @tencent-ai/codebuddy-code`） | `MAGIC_AGENT_CODEBUDDY_BIN` → PATH → npm 全局前缀 |
 | codebuddy-ai | 同上（**同一个 CLI 的第二个账号**） | `MAGIC_AGENT_CODEBUDDY_AI_BIN` → PATH → npm 全局前缀 |
-| trae | trae-cli | `MAGIC_AGENT_TRAE_BIN` → `~/.local/bin/trae-cli` → PATH |
+| trae | TRAE CLI 2.0（`traex`） | `MAGIC_AGENT_TRAE_BIN` → `%LOCALAPPDATA%\Programs\TraeCLI\bin\traex.exe` / `~/.local/bin/traex` → PATH |
 | llm | [simonw/LLM](https://github.com/simonw/LLM) | `MAGIC_AGENT_LLM_BIN` → `~/.llm-venv/bin/llm` → `/opt/homebrew/bin/llm` → PATH |
 | codex | `@openai/codex` | `MAGIC_AGENT_CODEX_BIN` → `/opt/homebrew/bin/codex` → PATH |
 | openclaw | OpenClaw | `MAGIC_AGENT_OPENCLAW_BIN` → `/opt/homebrew/bin/openclaw` → PATH |
@@ -96,7 +96,7 @@ magic-agent --engines --no-models    # 跳过模型与版本探测（不启动
 | codex | `npm install -g @openai/codex` |
 | openclaw | `npm install -g openclaw@latest` |
 | dsh | `npm i -g @deepseek-ai/dsh` |
-| trae | `sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)"` |
+| trae | `sh -c "$(curl -fsSL https://trae.cn/trae-cli/install_v2.sh)"`（Windows: `irm https://trae.cn/trae-cli/install_v2.ps1 | iex`） |
 | llm | `python3 -m venv ~/.llm-venv && ~/.llm-venv/bin/pip install llm` |
 | codebuddy / codebuddy-ai / arkclaw / codebuddy-gateway / 具名 A2A agent | **无该字段**（桌面端 GUI 应用 / 网关，没有可执行的安装命令），怎么才能用见同行 `note` |
 
@@ -116,7 +116,7 @@ magic-agent --engines --no-models | jq -r '.[] | select(.install) | "\(.engine)\
 | claude | `~/.claude/settings.json`（顶层 `model` + env 里 `ANTHROPIC_*MODEL[*_NAME]`） |
 | codebuddy | 客户端模型选择器清单 ∩ 客户端合并配置缓存；回退 `codebuddy --help` 的 `Currently supported` |
 | codebuddy-ai | 同上（独立配置目录 `~/.workbuddy-ai`） |
-| trae | `trae-cli models --json` |
+| trae | `traex models --json` |
 | llm | `llm models` |
 | codex | `codex debug models` |
 | openclaw | `openclaw models list --json` |
@@ -151,7 +151,7 @@ magic-agent -o text -p "用一句话解释什么是熵"
 # 切引擎、切模型
 magic-agent -e codebuddy "写一首俳句"           # codebuddy 默认 hy3
 magic-agent -e codebuddy -m glm-5.3 "写一首俳句"
-magic-agent -e trae -m My-MiniMax-M3 "..."     # trae 无 --model，内部转 -c model.name=
+magic-agent -e trae -m My-MiniMax-M3 "..."     # 内部转 traex exec -m <model>
 magic-agent -e llm -m minimax-m3 "问题"        # llm 用自己注册的模型
 
 # 工具与权限（--tools 默认 off = 纯 chat）
@@ -387,12 +387,13 @@ npm 包**同时装着** core（`magic-agent`）和客户端插件（`magic-clien
 与 `/desk/*` 接口。手机要用它，就在装包的那台电脑上把插件跑成后台服务：
 
 ```bash
-magic-agent client start --lan    # 后台常驻（关掉终端也还在），打印手机可用的地址
-magic-agent client status         # 在不在、端口、手机地址、健康检查（--json 给脚本）
-magic-agent client stop           # 停掉（本来没跑也算成功）
+magic-agent client start         # 后台常驻（关掉终端也还在），默认手机可连
+magic-agent client status        # 在不在、端口、手机地址、健康检查（--json 给脚本）
+magic-agent client stop          # 停掉（本来没跑也算成功）
+magic-agent client start --local # 只给本机用（绑 127.0.0.1）
 ```
 
-`start --lan` 会打印每个网卡一条 `http://<局域网IP>:<端口>/?token=…`，以及 `/pair`
+`start` 默认绑 `0.0.0.0:9100`，会打印每个网卡一条 `http://<局域网IP>:9100/?token=…`，以及 `/pair`
 配对二维码页 —— 那条**在电脑上**打开，手机扫屏幕上的码（或把地址整行复制到手机 App）。
 
 | 事实 | 位置 / 说明 |
@@ -405,12 +406,12 @@ magic-agent client stop           # 停掉（本来没跑也算成功）
 
 要点：
 
-- **必须同一 Wi-Fi**。`--lan` 只是把监听从 `127.0.0.1` 改成 `0.0.0.0`，跨网不在本命令范围内。
-- `--lan` 时令牌是**唯一门锁**，短于 24 字符会被直接拒绝启动；默认生成的 32 位十六进制远超这条线。
+- **默认就绑 `0.0.0.0:9100`**，手机在同一 Wi-Fi 下可直接连；只想本机访问加 `--local`（绑 `127.0.0.1`）。跨网不在本命令范围内。
+- 局域网模式下令牌是**唯一门锁**，短于 24 字符会被直接拒绝启动；默认生成的 32 位十六进制远超这条线。
 - 令牌跨重启稳定是刻意的：手机里存的是「地址 + 令牌」，每次 `start` 换一个就等于配对作废。
 - `status` 的判据是「pid 活着 **且** `/desk/health` 答得上」，不是只看进程；不健康时退出码 3。
-- 端口是系统分配的（`0`），因为**每次 start 会变**，所以别把端口写死进任何配置 —— 以打印的地址为准。
-- 排障要看前台日志就跑 `magic-client serve --lan`（同一个二进制，`serve` 不脱离终端）。
+- 默认端口固定 `9100`（`--addr` 可覆盖），跨重启稳定；被占用时启动会明确报错，不会悄悄换端口。
+- 排障要看前台日志就跑 `magic-client serve`（同一个二进制，`serve` 不脱离终端）。
 - `magic-agent client …` 只是转发层：core **不依赖**插件（`internal/boundary` 钉着这条），
   所以参数集合由 `magic-client start --help` 定义。
 
@@ -471,7 +472,7 @@ magic-client serve --ui-dir magic-h5
 手机访问启动时打印的 `http://<局域网IP>/?token=...`。嵌进自己的服务同理：按上面的
 布局静态托管，令牌走 `?token=`。
 
-（`magic-client` 随 npm 包安装，也可以只跑 `magic-agent client start --lan` 把插件后台拉起来，
+（`magic-client` 随 npm 包安装，也可以只跑 `magic-agent client start` 把插件后台拉起来，
 界面资源会自动按包布局找到。）
 
 **② 拷进自己的构建**（App/工程内嵌）：把 `client-ui-mobile/` 内容与 `client-ui/shared/`

package/client-ui/pc/app.css

@@ -1921,6 +1921,36 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
 .qa-done .d{width:6px;height:6px;border-radius:50%;background:var(--jade)}
 .qa-done.err .d{background:var(--cinnabar-hi)}
 .qa-done.err{color:var(--cinnabar-hi)}
+
+/* 错误显示卡（终态失败）：朱砂描边 + 淡红底的卡片面（见 29-msg-variants 的 qaErrorCardNode）。
+   ⚠️ 根节点带 `.qa-done` 类（收尾行契约要数它），这里把它从「等宽灰字行」翻成「块级卡片」：
+      display:block 盖掉 `.qa-done` 的 flex 行布局；颜色交给子元素，根只留卡片面。 */
+.qa-errcard{display:block;margin:8px 0 4px;padding:10px 12px;
+  border:1px solid rgba(214,64,42,.38);border-radius:var(--r-md);background:rgba(214,64,42,.06)}
+
+.qa-errcard + .qa-errcard{margin-top:0}
+
+.qa-ec-hd{display:flex;align-items:center;gap:8px}
+
+.qa-ec-ico{width:16px;height:16px;flex:none;display:grid;place-items:center;color:var(--cinnabar-hi)}
+
+.qa-ec-ico svg{width:15px;height:15px;display:block;stroke:currentColor;fill:none;
+  stroke-width:1.8;stroke-linecap:round;stroke-linejoin:round}
+
+.qa-ec-tt{flex:1;min-width:0;font-family:var(--font);font-size:13px;font-weight:600;color:var(--cinnabar-hi)}
+
+.qa-ec-bd{margin-top:8px}
+
+.qa-ec-reason{margin:0;font-size:12.5px;line-height:1.6;color:var(--paper-dim);
+  white-space:pre-wrap;word-break:break-word}
+
+.qa-ec-meta{margin-top:6px;font-family:var(--mono);font-size:10px;letter-spacing:.04em;color:var(--paper-mute)}
+
+/* 卡片里的可展开详情（复用 .qa-mk 词汇）；把它的左缩进让出来，贴着卡片内边距更顺 */
+.qa-errcard .qa-mk{margin:8px 0 0}
+
+.qa-errcard .qa-mk-bd{padding-left:2px}
+
 /* 待验证那条对话末尾的**出路按钮**（人工确认完成 / 按审核意见返工重做，见 qaReqConvSnapshot）：
    与卡片脚注同一套颜色语言（玉色 = 就这么定了，朱砂 = 再跑一轮），但对话里宽度充足、用全称。
    **贴右**（justify-content:flex-end）：它作用于上面那一列审查内容（结论 + 报告都在右侧），
@@ -3912,6 +3942,8 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
 [data-theme="dark"] .qa-done .d{background:#34D399}
 [data-theme="dark"] .qa-done.err{color:#F87171}
 [data-theme="dark"] .qa-done.err .d{background:#F87171}
+[data-theme="dark"] .qa-errcard{background:rgba(248,113,113,.09);border-color:rgba(248,113,113,.42)}
+[data-theme="dark"] .qa-ec-reason{color:#E7E5E4}
 
 /* 委派卡 */
 [data-theme="dark"] .qa-agent-chip{color:#A8A29E;border-color:#3B3835;background:rgba(245,244,243,.05)}

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

@@ -129,10 +129,14 @@ function qaPermOf(id){ return QA_PERMS.find(x=>x.id === id) || QA_PERMS.find(x=>
 function qaModelName(id, engine){
   const key = String(id || "").replace(/^custom-local:/, "");
   if(!key) return "";
+  const eng = String(engine || "").trim().toLowerCase();
+  /* dsh 的模型 id 是 `route/model`：路由前缀只在 dsh 配置内部有区分意义，显示时只留
+     后面的模型名（`-m` 与落库仍用完整 id，见 internal/agent/dsh.go::dshResolveRoute）。 */
+  const bare = (eng === "dsh") ? key.replace(/^[^/]+\//, "") : key;
   const hit = (e)=> (e && e.modelLabels && e.modelLabels[key]) || "";
   return hit(qaEngines.find(x=>x.engine === (engine || qaEngine)))
       || qaEngines.map(hit).find(Boolean)
-      || key;
+      || bare;
 }
 /* ---------- 模型：链来自配置界面，选不选**两个实例都可以** ----------
    用户 2026-09-21 四次改口，**这一版是定稿**（前面几版都写在这里，免得下次又来回改）：

package/client-ui/pc/js/07-chat-stream-render.js

@@ -304,7 +304,7 @@ if(askAttBusy(from)){ toast("截图还在保存，稍等一下再发"); return f
       taskTitle: (curTask && curTask.title) || "" });
     if(!r || !r.ok){
       qaRunEnd(h);
-      qaRenderDone(false, "调用失败 · " + ((r && r.error) || "桥不可用"), qaRunHost(run));
+      qaRenderDone(false, "调用失败 · " + ((r && r.error) || "桥不可用"), qaRunHost(run), null, r);
       /* 失败原因也进消息台账（2026-09-22）：持久层只存消息，若这一轮一个字都没吐、
          失败原因又不记，点开历史就是「只有我说了话、引擎没反应」—— 与需求派发那边
          把失败原因当一条回答渲染是同一条口径（见 qaReqConvSnapshot）。 */
@@ -316,9 +316,9 @@ if(askAttBusy(from)){ toast("截图还在保存，稍等一下再发"); return f
     }
     run.rid = r.rid;
     qaRuns.delete(0); qaRuns.set(r.rid, run);  // 用真实 rid 换掉占位（end 事件按 rid 路由）
-  }catch(e){
+    }catch(e){
     qaRunEnd(h);
-    qaRenderDone(false, "调用失败 · " + String(e && e.message || e).slice(0, 80), qaRunHost(run));
+    qaRenderDone(false, "调用失败 · " + String(e && e.message || e).slice(0, 80), qaRunHost(run), null, e);
     run.msgText = "运行失败\n" + String((e && e.message) || e);
     qaSaveSnapshotFor(run.taskId, "error");
     qaRuns.delete(run.rid || 0);

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

@@ -54,6 +54,18 @@ function normalizeEngineRow(r){
     models: models,
     modelLabels: Object.assign(labels, r.modelLabels || {}),
     modelCredits: r.model_credits || r.modelCredits || {},
+    modelVendors: r.model_vendors || r.modelVendors || {},
+    /* 账号额度 / 每日签到 / 模型级套餐额度：必须在这里显式带过去，否则组件拿不到
+       （normalize 只透传白名单字段）。 */
+    creditLeft: r.credit_left || r.creditLeft || "",
+    creditSuffix: r.credit_suffix || r.creditSuffix || "",
+    modelQuota: r.model_quota || r.modelQuota || {},
+    checkinToday: (typeof r.checkin_today === "boolean") ? r.checkin_today : r.checkinToday,
+    checkinCredit: r.checkin_credit || r.checkinCredit || "",
+    /* 多账号引擎（codebuddy 系）：没登录的槽位不显示 —— 「登录几个账号就显示几个」。 */
+    loggedIn: (typeof r.logged_in === "boolean") ? r.logged_in : r.loggedIn,
+    /* 登录的账号昵称（如 Darren / 玲），选择器画在引擎名下面。 */
+    account: r.account || "",
     modelsNote: r.models_note || r.modelsNote || "",
     workspace: r.workspace || "",
     streaming: r.streaming,
@@ -68,6 +80,9 @@ function normalizeEngineRow(r){
   if (HOST_DESK) return;      // 宿主已经给了 desk，别覆盖它
   const subs = [];
   let ridSeq = 0;
+  /* 服务端 ask id（= SSE open 帧里的 id）。审批回 control 必须用它：
+     客户端自己的 rid 只是渲染编号，/desk/ask/{id}/control 认不出（2026-10-25）。 */
+  const askIds = new Map();   // rid → server ask id
   /* ⚠️ 事件**延后一个微任务**再推给订阅者 —— 这不是洁癖，是修一个真实的竞态：
      SSE 常把 `open` 与紧随其后的若干事件**放在同一个网络块**里回来（一次 write 合并成一段），
      transport 会在一个 forEach 里把它们连着派给 onEvent。若在此**同步**转发，
@@ -100,9 +115,9 @@ function normalizeEngineRow(r){
         const done = (r) => { if (!settled) { settled = true; resolve(r); } };
         try {
           transport.ask(payload, {
-            onOpen() { done({ ok: true, rid: rid }); },
+            onOpen(id) { if(id) askIds.set(rid, String(id)); done({ ok: true, rid: rid }); },
             onEvent(ev) { emit(rid, ev); },
-            onEnd(code) { emit(rid, { type: "end", code: code }); done({ ok: true, rid: rid }); },
+            onEnd(code) { askIds.delete(rid); emit(rid, { type: "end", code: code }); done({ ok: true, rid: rid }); },
             onError(e) {
               const msg = String((e && e.message) || e);
               emit(rid, { type: "error", reason: msg });
@@ -132,6 +147,19 @@ function normalizeEngineRow(r){
         .then(() => ({ ok: true }))
         .catch((e) => ({ ok: false, error: String((e && e.message) || e) }));
     },
+    /* 待授权（计划审批 / 工具授权）的裁决（2026-10-25）：引擎正阻塞在 control_response 上，
+       必须走 control 的 ask_answer 原地写回；当成一条新消息发进去它不会读。
+       id 要用**服务端 ask id**（open 帧带回的），客户端 rid 只是渲染编号。 */
+    askApprove(p) {
+      const q = p || {};
+      const id = (q.rid != null && askIds.get(q.rid)) || askIds.get(Number(q.rid)) || "";
+      if (!id) return Promise.resolve({ ok: false, error: "这一轮还没拿到轮次 id（open 事件未到）" });
+      return Promise.resolve(transport.control({
+        id: id, op: "ask_answer",
+        request_id: q.request_id || "", allowed: !!q.allowed,
+        message: q.message || "", tool_name: q.tool_name || "",
+      })).then(() => ({ ok: true }), (e) => ({ ok: false, error: String((e && e.message) || e) }));
+    },
     onAskEvent(cb) { subs.push(cb); return () => { const i = subs.indexOf(cb); if (i >= 0) subs.splice(i, 1); }; },
 
     /* 引擎清单：transport 给的是 CLI 原始行（可能带 snake_case）→ 归一成上游形状。 */
@@ -172,6 +200,13 @@ function normalizeEngineRow(r){
     },
     /* 任务本地库（SQLite）：magic-agent 没有本地库 —— 空清单 + 写入如实回「跳过」。
        04-task-list.js 的 qaDb* 会把这些结果当「桥不可用」，于是只走 localStorage。 */
+    /* 历史附件回读（2026-10-25）：历史会话里的参考图只有**绝对路径**（core 落盘 {path, mime}，
+       没有回读地址）—— 内核画历史缩略图要当场按路径换 URL（attHistUrl，19-attachments）。
+       fileUrl 按绝对路径回读本机媒体文件（/desk/media?path=…），上传目录内外的都通；
+       mediaUrl 只对上传目录内文件有效（/desk/uploads/<名字>）。与组件宿主的
+       installDeskProbe（shared/conversation.js）同一口径。 */
+    fileUrl(path) { return (transport && transport.fileUrl) ? transport.fileUrl(path) : ""; },
+    mediaUrl(path) { return (transport && transport.mediaUrl) ? transport.mediaUrl(path) : ""; },
     tasksList() { return Promise.resolve({ ok: true, tasks: [] }); },
     tasksCreate(t) { return Promise.resolve({ ok: true, task: t }); },
     tasksUpdate() { return Promise.resolve({ ok: true }); },

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

@@ -119,13 +119,27 @@ function qaMdlMenuBuild(){
   const e = qaEngines.find(x=>x.engine === qaEngine) || null;
   const credits = (e && e.modelCredits) || {};
   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 ids = qaModelsOrdered(qaEngines, qaEngine,
+    (e && Array.isArray(e.models) ? e.models : []).map(m=>String(m||"")).filter(Boolean));
+  /* dsh 的模型 id 是 `route/model`：选择器里补一层路由名（同名模型可能挂在多条路由下，
+     只给末段分不出来）—— 与移动端 `.pick__cd` 同一口径（见 shared/conv/03-chat-message.js）。 */
+  const routeOf = (id)=> (String(qaEngine).trim().toLowerCase() === "dsh" && String(id).indexOf("/") > 0)
+    ? String(id).split("/")[0] : "";
   const autoName = auto ? qaModelName(auto, qaEngine) : "引擎默认";
   const autoCr = auto ? crOf(auto) : "";
-  const opts = [{ id:"", name:"自动", note: autoCr ? autoName + " · " + autoCr : autoName }]
+  /* 第二层：dsh 是路由名，其余引擎是 core 给的供应商名（model_vendors）；
+     套餐额度（MiniMax token plan）与它们同一行（note 本来就是一行 · 拼接）。 */
+  const subOf = (id)=> routeOf(id) || qaModelVendor(qaEngines, qaEngine, id);
+  const quotaOf = (id)=> qaModelQuota(qaEngines, qaEngine, id);
+  const autoNote = [autoName, subOf(auto), quotaOf(auto), autoCr].filter(Boolean).join(" · ");
+  const opts = [{ id:"", name:"自动", note: autoNote }]
     .concat(ids.map(id=>{
       const bits = [];
       if(auto === id) bits.push("链首");
+      const sub = subOf(id);
+      if(sub) bits.push(sub);
+      const quota = quotaOf(id);
+      if(quota) bits.push(quota);
       const cr = crOf(id);
       if(cr) bits.push(cr);
       return { id, name: qaModelName(id, qaEngine), note: bits.join(" · ") };
@@ -354,8 +368,9 @@ function qaStreamBind(){
         },
         onSession: (sid)=>{ qaSessionBindFor(run.taskId, sid); },
         onError: (e)=>{
-          /* 显示哪一句：**优先根因**（reason），退回完整错误链（error）——理由同上游 */
-          qaRenderDone(false, "调用失败 · " + String(e.reason || e.error || "未知错误").slice(0, 80), qaRunHost(run));
+          /* 显示哪一句：**优先根因**（reason），退回完整错误链（error）——理由同上游。
+             把整份错误信封（e）作为 detail 传给收尾卡（见 29-msg-variants 的 qaErrorCardNode）。 */
+          qaRenderDone(false, "调用失败 · " + String(e.reason || e.error || "未知错误").slice(0, 80), qaRunHost(run), null, e);
           qaTaskMarkSidLostFor(run.taskId);
           qaSaveSnapshotFor(run.taskId, "error", { holder: run.holder });
           qaRuns.delete(run.rid);

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

@@ -53,13 +53,15 @@ function qaRailState(s){
  *    `waiting_approval` 必须算**进行中** —— 它没在跑，但也没结束；归到「已完成」的话，
  *    用户会看到「我还在等它回话，它却已完成」。
  *    `idle`（常驻会话本轮已结束、进程还在等追加）**不算进行中**，落到「已完成」—— 与
- *    PC 按事件流显示的口径一致（2026-10-21）。 */
+ *    PC 按事件流显示的口径一致（2026-10-21）。
+ *    `gone`（记录写着在跑、进程已不在）**不算失败**：服务重启 / 终端关闭把进程带走
+ *    就是这一档，与移动端同一口径（2026-10-24 用户：「会话全部断连 红色」）。 */
 function qaRailGroup(s){
   if(!s) return "done";
   const st = qaRailState(s);
   if(s.alive || st === "running") return "live";
   if(st === "waiting_approval") return "live";
-  if(st === "failed" || st === "gone") return "failed";
+  if(st === "failed") return "failed";
   return "done";
 }
 function qaRailGroupLabel(s){
@@ -68,7 +70,7 @@ function qaRailGroupLabel(s){
   if(g === "live") return st === "waiting_approval" ? "等审批" : "进行中";
   if(g === "failed") return "失败";
   if(st === "cancelled" || st === "stopped") return "已取消";
-  if(st === "interrupted") return "已打断";
+  if(st === "interrupted" || st === "gone") return "已打断";
   return "已完成";
 }
 /* 运行中的会话**自动临时置顶**（2026-10-22 用户：「运行中的会话自动临时置顶」）：
@@ -260,7 +262,11 @@ function qaRailApply(ctx, events){
       ctx.h = null;
       /* 移动端「会话托管」自动发的提问带 hosted:true：PC 回放同一条历史时也画成
          「托管发送」，否则同一会话在两端会长成两张脸。 */
-      qaRenderMine(String(ev.text || ""), [], { hosted: !!ev.hosted });
+      /* 历史附件（参考图）随 user 事件落盘（{path, mime}，见 internal/agent/attachments.go）：
+         透传下去由内核的 attHistUrl 按路径换回读地址 —— 硬编码 [] 的话点开历史会话
+         参考图整排消失（2026-10-25 用户报障）。 */
+      qaRenderMine(String(ev.text || ""),
+        Array.isArray(ev.attachments) ? ev.attachments : [], { hosted: !!ev.hosted });
       continue;
     }
     if(!ctx.h){ ctx.h = qaRenderAnswer(); if(!ctx.h) break; }
@@ -443,7 +449,12 @@ async function qaRailOpen(id){
   }
   const ctx = qaRailReplay(r.events, s, live);
   if(live) qaRailTailStart(s, ctx, null);
-  qaScrollIntoView();
+  /* 打开历史 = 从底部开始看（2026-10-25 用户：「历史会话也应该默认到最底部」）。
+     换 qaHistoryStickBottom（不再是裸 qaScrollIntoView）：回放那次贴底在缩略图 /
+     字体加载完成之前，图一到位画布就被撑高、停在半空 —— 三重兜底见内核；
+     它同时置 qaUserAway=false，切会话残留的「用户离开底部」也一并复位。 */
+  if(typeof qaHistoryStickBottom === "function") qaHistoryStickBottom();
+  else qaScrollIntoView();
 }
 
 /** 新建对话：把当前上下文清掉，下一句话就是**全新会话**（不带给引擎任何 --session）。 */

package/client-ui/shared/conv/02-media-kinds.js

@@ -21,8 +21,8 @@ const QA_IMG_LINE  = /^\[图片\]\s*(\S.*?)\s*$/;     // 飞书侧：一行一
       清单漂移的后果是「同一条路径在 PC 有缩略图、在手机没有」，最难查）。 */
 const QA_IMG_EXT_SRC = "png|jpe?g|gif|webp|bmp|svg|heic|avif";
 const QA_IMG_EXT   = new RegExp("\\.(?:" + QA_IMG_EXT_SRC + ")$", "i");
-const QA_ART_EXT = /\.(?:png|jpe?g|gif|webp|bmp|svg|heic|avif|mp4|mov|m4v|webm|mkv|avi|mp3|wav|m4a|aac|ogg|flac|md|markdown|txt|pdf|docx?|xlsx?|pptx?|csv|zip|glb|gltf|psd|fig)$/i;
-const QA_ART_EXT_SRC = "png|jpe?g|gif|webp|bmp|svg|heic|avif|mp4|mov|m4v|webm|mkv|avi|mp3|wav|m4a|aac|ogg|flac|md|markdown|txt|pdf|docx?|xlsx?|pptx?|csv|zip|glb|gltf|psd|fig";
+const QA_ART_EXT = /\.(?:png|jpe?g|gif|webp|bmp|svg|heic|avif|mp4|mov|m4v|webm|mkv|avi|mp3|wav|m4a|aac|ogg|flac|md|markdown|txt|pdf|docx?|xlsx?|pptx?|csv|zip|glb|gltf|psd|fig|html?|xhtml)$/i;
+const QA_ART_EXT_SRC = "png|jpe?g|gif|webp|bmp|svg|heic|avif|mp4|mov|m4v|webm|mkv|avi|mp3|wav|m4a|aac|ogg|flac|md|markdown|txt|pdf|docx?|xlsx?|pptx?|csv|zip|glb|gltf|psd|fig|html?|xhtml";
 /** 整行就是一个产物路径（可带 `- ` 列表前缀）→ 摘成卡。
  *  相对路径只在这一档认（必须带目录分隔符，光一个 `report.md` 太像正文了）。 */
 const QA_ART_PATH_SRC = "(?:file://|/|~/|[A-Za-z0-9_.@-]+/)";   // 绝对 / `~/` / `file://` / 相对（带目录）