magic-agent 1.0.3 → 1.0.49

package/client-ui/{pc/js → shared/conv}/19-attachments.js

@@ -32,6 +32,13 @@ const ATT_EDGE = 1920;                    // 压缩后最长边（px）
 const ATT_TARGET = 1.5 * 1024 * 1024;     // 压缩目标（字节）
 const ATT_RE = /^image\/(png|jpeg|jpg|gif|webp|bmp)$/;
 
+/** 截图/产物路径扫描的单行长度上限 —— 超长行直接不扫。
+ *  ⚠️ 实测：一行 0.87MB 的 `data:image/png;base64,…` 在 qaShotInline 里单行要扫 78 秒
+ *     （每次正则命中都要 slice 前缀，超长行上退化成 O(n²)），主线程一冻就是几分钟，
+ *     表现就是「左栏 tab 点不动」。base64 流本来就摘不出可显示路径（紧贴在字母/数字后
+ *     一律不算，见 qaShotInline），放过它不影响观感；正常正文不会有 4KB 以上的单行。 */
+const QA_SCAN_MAX_LINE = 4096;
+
 const askAtts = {};                       // p → [att, ...]（按实例分开，与胶囊同款）
 let attSeq = 0;
 
@@ -360,10 +367,69 @@ function askAttBody(p, text){
       摘掉的只是屏幕上那几行，别把 askAttBody / 飞书桥写进去的东西改了。
    ⚠️ 摘不干净宁可**不摘**：标记后面没有能识别的图片路径时（历史数据 / 人手写的），
       原样保留 —— 静默吃掉用户写的字比显示得难看严重得多。 */
-const QA_SHOT_MARK = /^\[粘贴的截图\]\s*$/;        // 对话侧：标记独占一行
-const QA_SHOT_ITEM = /^[-*]\s*(\S.*?)\s*$/;        // 紧随其后的 `- <路径>`
-const QA_IMG_LINE  = /^\[图片\]\s*(\S.*?)\s*$/;     // 飞书侧：一行一条
-const QA_IMG_EXT   = /\.(png|jpe?g|gif|webp|bmp)$/i;
+
+/* ── 对话产物（2026-10-12）────────────────────────────────────────────────
+   用户原话：「现在对话ui上还不能显示对话的产物 图片视频等各自文件」。
+   图这一档早就有（上面那套 `.qa-atts` 缩略图），但引擎**产出的东西**不止图：成片
+   （mp4/mov）、音频、文档（md/pdf/xlsx）、模型（glb）……它们在正文里都只是一串路径，
+   一眼看不出是什么、也点不开。这里把**确实存在**的那些渲染成对应的卡：
+     · 图     → 缩略图（复用既有那一排 `.qa-atts`，点开看原图）
+     · 视频 / 音频 → 就地播放器（`<video>` / `<audio controls>`）
+     · 其它文件 → 一枚文件条（后缀徽标 + 名字 + 大小），点开在**右侧栏就地预览**、
+                 ⌥ 点（或右键）在访达里高亮
+   ⚠️ **存在性由主进程判**（`desk:path-probe`，一次批量问完，见 main.js 那三个口）：
+      只有真的落在盘上的文件才画 —— 正文里提到的 `app.js`、远端 URL、示例路径都不会
+      被误画成卡（宁可少画，不可画错）。
+   ⚠️ 相对路径按**这条会话的 workspace** 解析（引擎就是在那个目录里干活的，见 qaArtBase）；
+      相对路径**只认「独占一行」那一档**（行式误判面最小），行内的仍只认绝对路径。
+   ⚠️ 没有桥（浏览器预览）→ 一个新卡都不画，正文原样 —— 与既有「拼不出地址就不动」同一口径。 */
+
+/** 后缀 → 产物类型（图 / 视频 / 音频 / 文件）。**后缀表只有这一份**：主进程只回
+ *  「存在 / 绝对路径 / 大小」，类型由渲染层判（见 main.js 的 desk:path-probe 说明）。 */
+function qaArtKind(p){
+  const s = String(p || "").split(/[?#]/)[0];
+  if(QA_IMG_EXT.test(s)) return "image";
+  if(/\.(mp4|mov|m4v|webm|mkv|avi)$/i.test(s)) return "video";
+  if(/\.(mp3|wav|m4a|aac|ogg|flac)$/i.test(s)) return "audio";
+  if(QA_ART_EXT.test(s)) return "file";
+  return "";
+}
+/** 这条会话在哪干活（相对路径的基准）：任务的 workspace 优先，否则当前工作目录。
+ *  两者都拿不到就回空串 —— 那档只认绝对路径的候选（probe 里相对路径解析不出来自然不画）。 */
+function qaArtBase(){
+  try{
+    const arr = (typeof qaTasks !== "undefined" && Array.isArray(qaTasks)) ? qaTasks : [];
+    const t = arr.find(x=>x.id === qaActiveId);
+    if(t && t.workspace) return String(t.workspace);
+    if(typeof wsDirOf === "function"){
+      const d = String(wsDirOf() || "");
+      if(d) return d;
+    }
+    /* 组件宿主（PC 网页 / 移动端）没有任务表，wsDirOf 恒为空串 —— 但组件会把当前会话的
+       工作目录写回 `window.qaWorkspace`（conversation.js 的 syncHostState），拿它当基准。
+       没有这一档，回放里的**相对路径**产物一律探不到（用户报「会话产物不显示」）。 */
+    if(typeof window !== "undefined" && window.qaWorkspace) return String(window.qaWorkspace);
+  }catch(e){ /* 拿不到就当没有基准 */ }
+  return "";
+}
+/** 落盘地址：宿主给了回读通道（`window.desk.mediaUrl`，组件宿主走 /desk/media）就用它；
+ *  桌面壳的页面是 `file://` → 拼 `file://`（与 qaShotSrc 同一招）；
+ *  产物库里的（`~/.magic-test/images|pastes/…`）走内置后端，预览态也通。 */
+function qaArtUrl(abs){
+  const p = String(abs || "");
+  if(!p) return "";
+  try{
+    if(typeof window !== "undefined" && window.desk && typeof window.desk.mediaUrl === "function"){
+      const u = window.desk.mediaUrl(p);
+      if(u) return u;
+    }
+  }catch(e){ /* 宿主通道不通就退下面的 */ }
+  if(typeof qaShotSrc === "function"){
+    const u = qaShotSrc(p);
+    if(u) return u;
+  }
+  return "file://" + encodeURI(p).replace(/#/g, "%23");
+}
 
 /* ── 行内形态（2026-09-20 二次）─────────────────────────────────────────────
    用户原话：「用户的截图显示对了 bot回复中显示图片还不对」。
@@ -379,13 +445,13 @@ const QA_IMG_EXT   = /\.(png|jpe?g|gif|webp|bmp)$/i;
       markdown 图片/链接的地址（`![]()` / `[]()` —— 那条管线自己有渲染与尺寸口径）。
    ⚠️ 拼不出可显示地址的路径（预览态拿不到本机文件）**一个字都不动** —— 与 qaShotsMount
       末尾那条「摘不干净宁可不摘」同一口径。 */
-const QA_SHOT_PATH_RE = /(?:file:\/\/|\/|~\/)[^\s"'`<>()\[\]，。；：、）】]+?\.(?:png|jpe?g|gif|webp|bmp)(?![A-Za-z0-9])/gi;
 
 /** 一行里的「标记 + 路径」/「光秃秃的路径」→ 摘成缩略图。
  *  返回剩下的文字（shots 里收集被摘掉的路径，顺序与正文一致）。 */
 function qaShotInline(line, shots){
   const raw = String(line || "");
   if(!raw || raw.indexOf("/") < 0) return raw;        // 一行里连 `/` 都没有 → 没什么可摘的
+  if(raw.length > QA_SCAN_MAX_LINE) return raw;        // 超长行（base64 图流）扫它是 O(n²)，直接放过
   const codes = [];                                   // 行内代码先占位（里面的路径不是截图）
   let s = raw.replace(/`[^`]*`/g, (m)=>{ codes.push(m); return "\u0000" + (codes.length - 1) + "\u0000"; });
   const hits = [];
@@ -486,6 +552,287 @@ function qaThumbNode(src, title, alt){
   return im;
 }
 
+/* ── 对话产物：从正文里挑出「可能是产物」的路径（2026-10-12）───────────────
+   三条来源（都是模型/工具真会写出来的样子）：
+     ① 整行就是一个路径（可带 `- ` 列表前缀）；
+     ② markdown 图片 / 链接的地址（`![](out/x.mp4)` / `[成片](out/x.mp4)`）；
+     ③ 行内的路径（「成片在 out/x.mp4」「见 docs/campus/onboarding.md」这种半句话里的）。
+   三条都**认相对路径** —— 会不会误判成产物不由这里管：**存不存在由主进程探针判**
+   （所以「见 src/js/app.js」这类提法不会画成卡）。
+   ⚠️ 代码块整段跳过（那里面的路径是给人看的字，不是产物）。
+   ⚠️ 只**挑**不摘：正文一个字都不动，卡片画在正文下面（见 qaArtMount）。
+      与图片那一路（摘掉路径、只留缩略图）不同 —— 图是「一眼要看的东西」，
+      而视频/文档的路径本身也常是正文的一部分（「成片在 out/x.mp4」），摘掉反而读不通。
+   ⚠️ 挑多了不要紧：**是否真的存在由主进程判**（desk:path-probe，见 qaArtMount）。 */
+function qaArtCollect(text){
+  const out = [], seen = new Set();
+  const push = (p)=>{ const s = String(p || "").trim(); if(!s || seen.has(s) || !qaArtKind(s)) return; seen.add(s); out.push(s); };
+  let fence = false;
+  for(const raw of String(text || "").split("\n")){
+    if(raw.length > QA_SCAN_MAX_LINE) continue;           // 超长行（base64 图流）不扫，理由见 QA_SCAN_MAX_LINE
+    const ln = raw.trim();
+    if(/^(?:```|~~~)/.test(ln)){ fence = !fence; continue; }
+    if(fence) continue;
+    const one = QA_ART_LINE.exec(ln);                     // ① 整行一个路径（含相对路径）
+    if(one){ push(one[1]); continue; }
+    let m;
+    const md = /!?\[[^\]]*\]\(([^)\s]+)\)/g;               // ② markdown 地址
+    while((m = md.exec(raw))){
+      const href = m[1];
+      if(/^(?:https?|data|blob|mailto|#)/i.test(href)) continue;   // 远端 / 锚点不归这里管
+      push(href);
+    }
+    const abs = new RegExp(QA_ART_PATH_SRC + "[^\\s\"'`<>()\\[\\]，。；：、）】]+?\\.(?:" + QA_ART_EXT_SRC + ")(?![A-Za-z0-9])", "gi");
+    while((m = abs.exec(raw))){                            // ③ 行内路径（含相对路径 —— 存不存在由探针判）
+      const p = m[0];
+      if(/[(!]\s*$/.test(raw.slice(0, m.index))) continue;              // markdown 地址已在②处理
+      if(/[A-Za-z0-9_+/=:.-]$/.test(raw.slice(0, m.index))) continue;   // 紧贴字母/数字 → URL / base64
+      push(p);
+    }
+  }
+  return out.slice(0, 12);                                  // 一次最多画 12 张（多了就不是「产物」了）
+}
+
+/** 一张产物卡（按类型分流：图 / 视频 / 音频 / 其它文件）。 */
+function qaArtNode(it){
+  const kind = qaArtKind(it.abs) || "file";
+  const name = String((it.abs || "").split("/").pop() || "文件");
+  const card = document.createElement("div");
+  card.className = "qa-art qa-art-" + kind;
+  card.dataset.path = it.abs || "";
+  card.title = (it.abs || "") + "\n点击在右侧栏预览 · ⌥ 点击在访达中显示";
+  const sz = (typeof attSize === "function" && it.size) ? attSize(it.size) : "";
+  if(kind === "image"){                                    // 图：走既有缩略图形制（点开看原图那条链）
+    card.appendChild(qaThumbNode(qaArtUrl(it.abs), name + " · 点开看原图", name));
+    return card;
+  }
+  if(kind === "video" || kind === "audio"){                 // 视频 / 音频：就地播放
+    const m = document.createElement(kind);
+    m.controls = true; m.preload = "metadata"; m.src = qaArtUrl(it.abs);
+    if(kind === "video") m.playsInline = true;
+    card.appendChild(m);
+  }
+  const cap = document.createElement("div");
+  cap.className = "qa-art-cap";
+  if(kind === "file"){                                      // 其它文件：后缀徽标 + 名字 + 大小
+    const ext = document.createElement("span");
+    ext.className = "qa-art-ext";
+    ext.textContent = (name.split(".").pop() || "?").toUpperCase().slice(0, 4);
+    cap.appendChild(ext);
+  }
+  const nm = document.createElement("span");
+  nm.className = "qa-art-nm"; nm.textContent = name;
+  cap.appendChild(nm);
+  if(sz){
+    const s = document.createElement("span");
+    s.className = "qa-art-sz"; s.textContent = sz;
+    cap.appendChild(s);
+  }
+  const go = document.createElement("span");
+  go.className = "qa-art-go"; go.textContent = "查看";
+  cap.appendChild(go);
+  card.appendChild(cap);
+  return card;
+}
+
+/** 把挑出的产物路径画成一排卡（**只画真的落在盘上的**）。
+ *  ⚠️ 存在性问主进程（`desk:path-probe`，一次批量）——渲染层拿不到 fs。
+ *     正文里提到的 `app.js`、远端 URL、示例路径都不会被误画成卡。
+ *  ⚠️ 相对路径按**这条会话的 workspace** 解析（qaArtBase）；没有桥（浏览器预览）→ 一张不画。
+ *  `opts.label`（2026-10-15）＝ 在这一排卡上面先落一行小标题（「本轮产物」用，见 qaTurnArtsMount）；
+ *  `opts.detached` ＝ 允许画进**不在文档树上**的宿主：后台那一轮的画布被整份摘进 holder，
+ *     节点还在、只是不在树上（`isConnected` 为假）—— 收尾时往它末尾补产物正是这种情形。
+ *  返回画出来的张数（Promise）：收尾那条链要**等它画完**再落 HTML 快照（见 qaTurnArtsMount）。 */
+function qaArtMount(host, paths, opts){
+  const o = opts || {};
+  const api = (window.desk && typeof window.desk.pathProbe === "function") ? window.desk.pathProbe : null;
+  if(!host || !api || !Array.isArray(paths) || !paths.length) return Promise.resolve(0);
+  const list = paths.slice(0, 12);
+  return Promise.resolve(api({ base: qaArtBase(), paths: list })).then((r)=>{
+    const items = (r && r.ok && Array.isArray(r.items)) ? r.items : [];
+    const hit = items.filter((x)=> x && x.exists && x.abs);
+    if(!hit.length) return 0;                                // 一个都不存在 → 不画
+    if(!o.detached && !host.isConnected) return 0;           // 这条消息已经换掉了 → 不画
+    if(o.label){
+      const cap = document.createElement("div");
+      cap.className = "qa-arts-cap";
+      cap.textContent = String(o.label);
+      host.appendChild(cap);
+    }
+    /* 按类型分行（2026-10-20 用户：「按类型分类显示 要么就宽高一致」）——
+       同一排里图片是缩略图、视频是播放器、文档是胶囊卡，宽高天然不同，混在一起参差不齐。
+       这里按 图 / 视频 / 音频 / 文件 各起一行，行内格子尺寸再由 app.css 统一。 */
+    const buckets = new Map();
+    hit.forEach((x)=>{
+      const k = qaArtKind(x.abs) || "file";
+      if(!buckets.has(k)) buckets.set(k, []);
+      buckets.get(k).push(x);
+    });
+    ["image", "video", "audio", "file"].forEach((k)=>{
+      const arr = buckets.get(k);
+      if(!arr || !arr.length) return;
+      const row = document.createElement("div");
+      row.className = "qa-arts qa-arts-" + k;
+      arr.forEach((x)=> row.appendChild(qaArtNode(x)));
+      host.appendChild(row);
+    });
+    return hit.length;
+  }).catch(()=> 0);                                           // 探针失败 = 当作「都不是产物」，正文照旧
+}
+
+/* ── 会话产物 · 消息末尾的「本轮产物」（2026-10-15）─────────────────────────
+   用户原话：「会话有新的图片、视频文件产生 应该在消息结束时附加在末尾作为会话产物显示预览」。
+   正文里写出来的产物路径早就有渲染（qaShotsMount / qaArtMount：图变缩略图、视频变就地播放器），
+   但**没写进正文**的那些没人画：
+     · 工具在输出里报的落盘产物（`MEDIA: /…/x.png` 这类）只落在工具卡里，而工具卡默认收在
+       「任务耗时 · N 项过程」折叠组内 —— 跑完一眼看不见；
+     · 写类工具**参数 JSON** 里的 `file_path`（Write / Edit 改的是哪个文件，参数里最准）；
+     · 壳在 notice 里报的录屏 / 截屏（`recFiles` + `recDir`）与短视频成片
+       （`shortsFiles` + `shortsDir`）此前只有一句 toast。
+   于是这里补两件事：**收**（这一轮进来的产物路径记在 run 上）与**画**（收尾时补在消息末尾）。
+   ⚠️ 认图 / 视频 / 文件三档（2026-10-20 扩档：原先只认图与视频，用户反馈 md / pdf / glb 等文档与
+      模型文件在正文里只有路径、"本轮产物"里也不显示 —— 一起放开）。音频（mp3/wav）暂不搬，
+      那类大多是纯过程产物，不像文档那样需要点进去看。
+   ⚠️ 与正文里已经画过的**不重复**（按绝对路径与文件名双判）：用户要的是「正文没提的也看得见」，
+      正文里已经有的再画一遍就成了同一张图出现两次。
+   ⚠️ 只**收**不摘、只**补**不改：正文与工具输出原文一个字都不动。 */
+const QA_TURN_ART_KIND = /^(?:image|video|file)$/;
+/** 记一条候选路径进**这一轮**的产物集（去重；留图 / 视频 / 文件三档）。 */
+function qaTurnArtsNote(run, p){
+  const s = String(p == null ? "" : p).trim();
+  if(!run || !s) return;
+  if(!QA_TURN_ART_KIND.test(qaArtKind(s))) return;
+  if(!run.turnArts) run.turnArts = new Set();
+  run.turnArts.add(s);
+}
+/** 从一段**工具结果正文**里挑产物 —— 与正文那条同一个挑法（qaArtCollect）：
+ *  一次调用最多 12 条，代码块整段跳过，存不存在由探针判。 */
+function qaTurnArtsNoteText(run, text){
+  if(!run || !text) return;
+  try{ qaArtCollect(String(text)).forEach((p)=> qaTurnArtsNote(run, p)); }
+  catch(e){ /* 挑不出来不影响这一轮 */ }
+}
+/* 工具调用的**参数**（JSON）里本来就写着产物路径（2026-10-20 用户：「工具调用是json格式的啊
+   里面有文件路径」）。写类工具的 `file_path` / `path` / `output_path` 这一步落盘到哪儿，
+   参数里是**确定的**，比事后再从结果正文里猜可靠 —— 结果常常只有一句
+   「has been updated successfully」，路径根本不在结果里。
+   ⚠️ 只认**写文件**的工具：Read / Glob / Grep 的参数里也有路径，那是输入不是产物。 */
+const QA_TOOL_WRITE_NAME = /^(?:write|write_file|edit|multiedit|multi_edit|notebook_edit|notebookedit|create_file|str_replace_editor|filesystem_write_file|filesystem_edit_file)$/i;
+const QA_TOOL_PATH_KEY = /^(?:file_path|filepath|path|filename|file_name|file|output_path|output|target_file|target_path|dest|dst|destination|save_path|out)$/i;
+/** 从写类工具的**参数 JSON** 里挑产物路径（键名看着像路径 + 后缀认得出来才算）。
+ *  ⚠️ 参数不是 JSON（命令行文本）就不猜：那是结果正文那条链路的事。 */
+function qaTurnArtsNoteTool(run, name, args){
+  if(!run) return;
+  if(!QA_TOOL_WRITE_NAME.test(String(name || "").trim())) return;
+  let o = args;
+  if(typeof o === "string"){
+    const s = o.trim();
+    if(!s) return;
+    try{ o = JSON.parse(s); }catch(e){ return; }
+  }
+  if(!o || typeof o !== "object") return;
+  const walk = (v, depth)=>{
+    if(!v || depth > 2) return;
+    if(Array.isArray(v)){ v.forEach((x)=> walk(x, depth + 1)); return; }
+    if(typeof v !== "object") return;
+    Object.keys(v).forEach((k)=>{
+      const val = v[k];
+      if(typeof val === "string"){
+        if(QA_TOOL_PATH_KEY.test(k) && qaArtKind(val)) qaTurnArtsNote(run, val);
+        return;
+      }
+      walk(val, depth + 1);
+    });
+  };
+  walk(o, 0);
+}
+/** 从壳的 notice 里挑产物：录屏 / 截屏（`recDir` + `recFiles`）、短视频成片（`shortsDir` + `shortsFiles`）。
+ *  ⚠️ 壳给的是**目录 + 文件名**两截（绝对路径由这里拼）：拼法必须与主进程落盘的位置一致，
+ *     所以目录一律取 notice 上带的那一份，不自己按 kind 猜（见 main.js 的 recDir / shortsDir）。 */
+function qaTurnArtsNoteNotice(run, ev){
+  if(!run || !ev) return;
+  const dir = String(ev.shortsDir || ev.recDir || "").trim().replace(/\/+$/, "");
+  const files = Array.isArray(ev.shortsFiles) ? ev.shortsFiles
+    : (Array.isArray(ev.recFiles) ? ev.recFiles : []);
+  if(!dir || !files.length) return;
+  files.forEach((n)=>{ const b = String(n == null ? "" : n).trim(); if(b) qaTurnArtsNote(run, dir + "/" + b); });
+}
+/** 收尾时把这一轮的产物补在这条消息**末尾**（`.qa-bd` 的尾巴 = 正文之后、操作行之前）。
+ *  ⚠️ 调用方要**等这个 Promise**（收尾那条链用它落 HTML 快照）—— 补晚了产物卡就进不了历史。
+ *  ⚠️ 正文里已经画过的跳过：两条链（`.qa-atts` 缩略图 / `.qa-arts` 产物卡）都落在 `.qa-t` 里，
+ *     按**绝对路径**与**文件名**双判（正文那条链画的是探针回来的 abs，这里手上可能还是相对路径）。 */
+function qaTurnArtsMount(run, h){
+  const paths = (run && run.turnArts) ? [...run.turnArts] : [];
+  const el = h && h.el;
+  const host = (el && el.querySelector) ? el.querySelector(".qa-bd") : null;
+  if(!host || !paths.length) return Promise.resolve(0);
+  const seen = new Set();
+  const mark = (s)=>{ const t = String(s == null ? "" : s); if(t){ seen.add(t); seen.add(t.split("/").pop()); } };
+  try{
+    el.querySelectorAll(".qa-t .qa-art[data-path]").forEach((n)=> mark(n.dataset.path));
+    el.querySelectorAll(".qa-t .qa-atts img, .qa-t img").forEach((n)=>{ mark(n.getAttribute("src")); mark(n.getAttribute("alt")); });
+  }catch(e){ /* 取不到就当没画过 —— 顶多多画一张，不会漏 */ }
+  const want = paths.filter((p)=>{ const b = String(p).split("/").pop(); return !seen.has(p) && !seen.has(b); });
+  if(!want.length) return Promise.resolve(0);
+  return qaArtMount(host, want, { label: "本轮产物", detached: true });
+}
+/** 回放 / 续传专用（2026-10-20 方案 A）：按**轮**收产物，封口时补挂到这轮消息末尾。
+ *
+ *  为什么要有它：历史重画（`qaSessionPlayer` / 续传 `qaTailFeed`）把 `ctx.onStep` 桩成空函数，
+ *  实时那条链接在 `onStep` 上的 `qaTurnArtsNoteTool` / `qaTurnArtsNoteText` 一次也不会被调 →
+ *  重画出来的轮次末尾永远没有「本轮产物」（用户报的「开发壳不显示产物」就是这条路）。
+ *  这里直接吃事件本身，用**与实时完全同一套挑法**（写类工具参数 / 工具输出正文 / notice），
+ *  迟到的那一枚 `qaTurnArtsMount` 只补挂、不改正文、不影响回放速度。
+ *  @returns {{ note(ev):void, flush(h):void, settled(ms):Promise }}
+ *    note(ev)  喂一条回放事件（只认 tool_use / tool_result / notice）
+ *    flush(h)  一轮封口：把这一轮收到的产物挂到 `h.el` 的消息末尾（容器已不在树上也照挂）
+ *    settled() 等已排队的补挂画完（要取 innerHTML 存 `__convReplay` 时才需要） */
+function qaTurnArtsTrack(){
+  let run = null;
+  const pending = [];
+  const ensure = ()=> (run || (run = { turnArts: new Set() }));
+  const flush = (h)=>{
+    const r = run; run = null;                            // 无论挂不挂得上都换轮
+    if(!r || !r.turnArts || !r.turnArts.size) return;
+    const el = h && h.el;
+    if(!el) return;
+    /* 同一张卡可能被分页拼接过（qaConvJoinTurn 会搬子节点）：路径按卡累积，不漏也不重 */
+    const merged = new Set(Array.isArray(el.__qaTurnArts) ? el.__qaTurnArts : []);
+    r.turnArts.forEach((p)=> merged.add(p));
+    el.__qaTurnArts = [...merged];
+    if(typeof qaTurnArtsMount !== "function") return;
+    try{
+      pending.push(Promise.resolve(qaTurnArtsMount({ turnArts: new Set(el.__qaTurnArts) }, { el })).catch(()=> 0));
+    }catch(e){ /* 挂不上不影响回放 */ }
+  };
+  return {
+    note(ev){
+      const k = String((ev && ev.kind) || "");
+      if(k === "tool_use"){
+        if(typeof qaTurnArtsNoteTool === "function") qaTurnArtsNoteTool(ensure(), ev.name, ev.text);
+      }else if(k === "tool_result"){
+        if(typeof qaTurnArtsNoteText === "function") qaTurnArtsNoteText(ensure(), ev.text);
+      }else if(k === "notice"){
+        if(typeof qaTurnArtsNoteNotice === "function") qaTurnArtsNoteNotice(ensure(), ev);
+      }
+    },
+    flush,
+    settled(ms){
+      const p = Promise.all(pending.splice(0).map((x)=> Promise.resolve(x).catch(()=> 0)));
+      return (typeof qaTurnArtsSettled === "function") ? qaTurnArtsSettled(p, ms) : p;
+    },
+  };
+}
+
+/** 探针那一跑的**时间上限**（收尾链要等它画完再落快照，但绝不能被它拖住：
+ *  解锁撰写区、自动提交排队的那条都在同一个 settle 里）。到时按「没补上」处理，界面照常往下走。 */
+function qaTurnArtsSettled(p, ms){
+  return Promise.race([
+    Promise.resolve(p).catch(()=> 0),
+    new Promise((res)=> setTimeout(()=> res(0), ms || 1500)),
+  ]);
+}
+
 /** 气泡正文的统一落笔处：markdown（摘掉截图路径那几行/那几段）+ 下面一排截图缩略图。
  *  三条渲染器都走它 —— 实时那条用户气泡（qaRenderMine）、实时那条 bot 答复
  *  （qaRenderAnswer 的 flushClosed / finish / setResult）与派发快照那条（qaReqConvMsg）：
@@ -493,7 +840,9 @@ function qaThumbNode(src, title, alt){
  *  ⚠️ 2026-09-20 二次：bot / 审核引擎的答复也走这里了（用户：「用户的截图显示对了
  *     bot回复中显示图片还不对」）—— 引擎回话里带的是**它看到的引用**，同一串路径
  *     在用户气泡里是缩略图、在 bot 气泡里是文字，读起来就像「bot 没看见图」。
- *     摘的仍然只是**屏幕上那几个字符**：库里的正文 / 下发给引擎的 prompt 一个字不动。 */
+ *     摘的仍然只是**屏幕上那几个字符**：库里的正文 / 下发给引擎的 prompt 一个字不动。
+ *  ⚠️ 2026-10-12：出处再加一档 —— **对话产物**（视频 / 音频 / 文档 / 相对路径的图）
+ *     画成卡（见 qaArtMount），挑与画都在这一处，三条渲染器同样一起受益。 */
 function qaShotsMount(host, text){
   if(!host) return;
   const sp = qaShotSplit(text);
@@ -505,11 +854,12 @@ function qaShotsMount(host, text){
     : sp.text;
   try{ host.innerHTML = mdToHtmlOnly(rest); highlightIn(host); }
   catch(e){ host.textContent = rest; }
-  if(!srcs.length) return;
   const row = document.createElement("div");
   row.className = "qa-atts";
   srcs.forEach((x)=> row.appendChild(qaThumbNode(x.u, x.p.split("/").pop() + " · 点开看原图")));
-  host.appendChild(row);
+  if(srcs.length) host.appendChild(row);
+  /* 产物卡：在**摘完之后**的正文上挑（已经被摘走的图片路径不会再被挑一遍）。 */
+  qaArtMount(host, qaArtCollect(rest));
 }
 
 /** 附件条 + 粘贴 / 拖拽接线（逐实例各绑一次，与 ＋ 菜单同款） */
@@ -524,22 +874,18 @@ function askAttBind(p){
       else askAttDel(p, host.dataset.id);
     });
   }
-  /* 生成中（.is-busy）整块撰写区锁死（用户 2026-09-18）：图也不许再往里加 ——
-     加了也只有等这一轮结束才发得出去，中间那段时间缩略图挂在锁死的框上只会让人困惑。
-     一律拦在图片分支里，纯文本粘贴的默认行为照旧不碰。 */
-  const busyGate = (e)=>{
-    if(!box.classList.contains("is-busy")) return false;
-    e.preventDefault(); e.stopPropagation();
-    toast("正在生成中 · 等这一轮结束再加截图");
-    return true;
-  };
+  /* ⚠️ 生成中（.is-busy）**不再拦贴图**（2026-10-19 用户：「加截图没啥冲突 不应该限制」）。
+     改前这里有一道 busyGate：处理中粘贴 / 拖入一律挡下，提示「等这一轮结束再加截图」。
+     它与既有语义自相矛盾 —— 撰写区在生成中本来就**照常可写**，回车即排队（qaMsgQueue）；
+     图的落盘既不占这一轮的资源、也不改这一轮的 prompt，挂上去等着就行：
+     附件存在**实例**上（askAtts[p]），排队那条收尾后由 qaMsgFlush 走 qaSend 取走，
+     贴图与那条一起发出。纯文本粘贴的默认行为照旧不碰。 */
   /* 粘贴：只认「确实带图片文件」的剪贴板。没有图片时一行不拦 ——
      纯文本 / 富文本粘贴继续走浏览器默认行为（无差别 preventDefault 会吃掉文字粘贴，
      这是这类实现最常见的一处自伤）。 */
   box.addEventListener("paste", (e)=>{
     const files = attFromDataTransfer(e.clipboardData);
     if(!files.length) return;
-    if(busyGate(e)) return;
     e.preventDefault();
     askAttAdd(p, files);
   });
@@ -549,8 +895,7 @@ function askAttBind(p){
   ["dragenter", "dragover"].forEach((t)=>box.addEventListener(t, (e)=>{
     if(!attFromDataTransfer(e.dataTransfer).length) return;
     e.preventDefault(); e.stopPropagation();
-    if(box.classList.contains("is-busy")) return;      // 生成中不给落点反馈
-    box.classList.add("is-drop");
+    box.classList.add("is-drop");                       // 生成中同样给落点反馈（贴图不再受限）
   }));
   box.addEventListener("dragleave", (e)=>{
     if(!box.contains(e.relatedTarget)) box.classList.remove("is-drop");
@@ -563,7 +908,6 @@ function askAttBind(p){
       if(anyFile){ e.preventDefault(); e.stopPropagation(); toast("只支持图片（PNG / JPEG / WebP / GIF / BMP）"); }
       return;
     }
-    if(busyGate(e)) return;
     e.preventDefault(); e.stopPropagation();
     askAttAdd(p, files);
   });