magic-agent 2.4.3 → 2.6.3

package/client-ui/shared/conv/19-attachments.js

@@ -62,6 +62,52 @@ function attErrText(err){
 /** 缩略图地址：落盘后用真实 URL，落盘途中用本地 objectURL */
 function attThumbUrl(a){ return a.remoteUrl || a.objectUrl || ""; }
 
+/* ── 历史附件（2026-10-25 用户报障：「点击历史会话时发送的参考图没了」）──────────
+   根因：core 落盘的附件只有 **path + mime** 两个字段（internal/agent/attachments.go 的
+   Attachment），既没有 remoteUrl 也没有 objectUrl —— attThumbUrl 对它恒回空，
+   qaRenderMine 里「拿不到地址就跳过」的分支把整排缩略图全吞了。
+   这里给历史那档一条**独立的取址链**，与实时附件互不干扰：
+     ① 实时字段（remoteUrl / objectUrl）优先 —— 两档同形时行为不变；
+     ② 宿主回读通道（desk.fileUrl / desk.mediaUrl。组件宿主在 installDeskProbe 里把
+        mediaUrl 挂成 transport.fileUrl = /desk/media?path=…，按绝对路径回读，上传目录
+        内外的本机媒体文件都通）；
+     ③ qaShotSrc（file:// 壳内直接拼 file://；产物库路径走内置后端）；
+     ④ 都没有 → 空串，上层跳过 —— 宁可没有图，也不画一个必然裂的框（与 qaShotSrc
+        预览态的口径一致）。 */
+/** 附件显示名：实时那档有 name；历史附件只有 path → 取 basename，并去掉上传时
+ *  服务端加的 <UnixNano>- 前缀，还原成用户上传时的文件名（与组件宿主 attNode 同一口径）。 */
+function attHistName(a){
+  const n = a && a.name ? String(a.name) : "";
+  if(n) return n;
+  const p = String((a && a.path) || "");
+  const base = p.split(/[\\/]/).pop() || "";
+  return base.replace(/^\d{13,}-/, "") || "截图";
+}
+/** 这条附件是不是图（历史附件只有 mime/path；QA_IMG_EXT 与缩略图同一份后缀表）。 */
+function attHistIsImage(a){
+  if(!a) return false;
+  const mime = String(a.mime || "");
+  if(mime) return /^image\//i.test(mime);
+  return QA_IMG_EXT.test(attHistName(a));
+}
+/** 历史附件 → 可显示地址（取址链见上）。实时附件请继续走 attThumbUrl。 */
+function attHistUrl(a){
+  if(!a) return "";
+  if(a.remoteUrl) return a.remoteUrl;
+  if(a.objectUrl) return a.objectUrl;
+  const p = String(a.path || "").trim();
+  if(!p) return "";
+  const via = (name)=>{
+    const f = qaDeskFn(name);
+    if(typeof f !== "function") return "";
+    try{ return f(p) || ""; }catch(e){ return ""; }
+  };
+  const u = via("fileUrl") || via("mediaUrl");
+  if(u) return u;
+  if(typeof qaShotSrc === "function"){ try{ return qaShotSrc(p) || ""; }catch(e){} }
+  return "";
+}
+
 /** 落盘返回的 url → 浏览器可直接用的绝对地址。
  *  壳内与预览态都拿得到 prdBackendBase（同一个内置后端）；
  *  file:// 直开且后端未就绪时返回空 —— 那种情况继续用 objectURL，
@@ -393,6 +439,9 @@ function qaArtKind(p){
   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(/\.(?:html?|xhtml)$/i.test(s)) return "html";      // HTML 产物：产物卡里嵌 iframe 预览
+                                                        //（是否「自包含可预览」由 qaHtmlStandalone
+                                                        //  按内容判，见 qaArtMount 的换卡逻辑）
   if(QA_ART_EXT.test(s)) return "file";
   return "";
 }
@@ -608,10 +657,34 @@ function qaArtCollect(text){
   return out.slice(0, 12);                                  // 一次最多画 12 张（多了就不是「产物」了）
 }
 
-/** 一张产物卡（按类型分流：图 / 视频 / 音频 / 其它文件）。 */
-function qaArtNode(it){
-  const kind = qaArtKind(it.abs) || "file";
-  const name = String((it.abs || "").split("/").pop() || "文件");
+/** HTML 产物是否「自包含、可独立预览」（2026-10-24 用户：「index.html这种非静态页面要排除
+ *  不需要预览」「按文件名区分不行」→ 改**内容**判据）：
+ *  读文件头（`/desk/path-read`，512KB 上限）扫 `<script src>` / `<link href>` ——
+ *  引用了**外部 js / css**（相对 / 绝对路径，非 data: / 远端）的就是应用入口或页面壳，
+ *  单塞一个 iframe 里预览出来是白板或半个页面 → 返 false，退回普通文件卡。
+ *  ⚠️ 通道拿不到 / 读失败 / 太大读不了 → 返 true（宁可照画，不凭猜把卡降级）。 */
+function qaHtmlStandalone(p){
+  const rd = qaDeskFn("pathRead");
+  if(!rd) return Promise.resolve(true);
+  return Promise.resolve(rd({ path: String(p), base: qaArtBase() })).then((r)=>{
+    if(!r || !r.ok || typeof r.text !== "string") return false;   // tooBig / 读不到：多半是应用入口
+    const t = r.text.slice(0, 65536).toLowerCase();
+    const re = /(?:src|href)\s*=\s*["']([^"']+)["']/g;
+    let m;
+    while((m = re.exec(t))){
+      const u = m[1].trim();
+      if(!u || /^(?:data:|https?:|\/\/|#|mailto:)/i.test(u)) continue;
+      if(/\.(?:m?js|css)(?:[?#]|$)/i.test(u)) return false;       // 引了外部脚本 / 样式 → 不自包含
+    }
+    return true;
+  }).catch(()=> true);
+}
+
+/** 一张产物卡（按类型分流：图 / 视频 / 音频 / HTML / 其它文件）。
+ *  `force`（2026-10-24）＝ 强制按这一档画（HTML 换卡逻辑用：入口页降级成普通文件卡）。 */
+function qaArtNode(it, force){
+  const kind = force || 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 || "";
@@ -627,6 +700,15 @@ function qaArtNode(it){
     if(kind === "video") m.playsInline = true;
     card.appendChild(m);
   }
+  if(kind === "html"){                                      // HTML：iframe 就地预览（2026-10-24 用户：
+    const f = document.createElement("iframe");             // 「会话产物如果有html 现在没显示预览效果」）
+    f.src = qaArtUrl(it.abs);
+    f.title = name;
+    f.setAttribute("sandbox", "allow-scripts allow-same-origin allow-popups allow-forms");
+    f.setAttribute("loading", "lazy");
+    f.setAttribute("draggable", "false");
+    card.appendChild(f);
+  }
   const cap = document.createElement("div");
   cap.className = "qa-art-cap";
   if(kind === "file"){                                      // 其它文件：后缀徽标 + 名字 + 大小
@@ -726,7 +808,7 @@ function qaArtMount(host, paths, opts){
       if(!buckets.has(k)) buckets.set(k, []);
       buckets.get(k).push(x);
     });
-    ["image", "video", "audio", "file"].forEach((k)=>{
+    ["image", "video", "audio", "html", "file"].forEach((k)=>{
       const arr = buckets.get(k);
       if(!arr || !arr.length) return;
       const row = document.createElement("div");
@@ -734,6 +816,22 @@ function qaArtMount(host, paths, opts){
       arr.forEach((x)=> row.appendChild(qaArtNode(x)));
       host.appendChild(row);
     });
+    /* HTML 产物卡是**异步定形**的：先按 html 画（iframe 预览），随后读文件头判「自包含」，
+       引用了外部 js / css 的（index.html 这类应用入口）降级成普通文件卡 —— 内容判据，
+       不按文件名（2026-10-24 用户：「index.html这种非静态页面要排除」「按文件名区分不行」）。 */
+    hit.forEach((x)=>{
+      if(qaArtKind(x.abs) !== "html") return;
+      qaHtmlStandalone(x.abs).then((ok)=>{
+        if(ok) return;
+        const cards = host.querySelectorAll(".qa-art-html");
+        for(const c of cards){
+          if(qaArtCanon(c.dataset.path) === qaArtCanon(x.abs)){
+            c.parentNode.replaceChild(qaArtNode(x, "file"), c);
+            break;
+          }
+        }
+      }).catch(()=>{ /* 换不了就保持原样 */ });
+    });
     return hit.length;
   }).catch(()=> 0);                                           // 探针失败 = 当作「都不是产物」，正文照旧
 }
@@ -803,6 +901,59 @@ function qaArtDrop(card){
   }, true);
 })();
 
+/* ── HTML 产物 · 点击打开（2026-10-24 用户：「预览是缩略效果了 要支持点击查看」
+   → 「现在有内置浏览器啊 点击跳转打开啊」）────────────────────────────────
+   点卡片：宿主有内置浏览器（`MagicHost.openBrowser`，移动端已挂）就**跳内置浏览器**；
+   没有的宿主退回**内核自画的全屏预览层**（不依赖宿主能力，PC / magic-test 通吃），
+   Esc / 关闭按钮退出。
+   ⚠️ 缩略 iframe 设 `pointer-events:none`（CSS）：iframe 内部的点击不会冒泡到卡片，
+      不设的话「点卡片」只有边条能点中；代价是缩略态不能滚里面内容 —— 反正要看就点开。
+   ⚠️ 页面级一次性挂载，与上面 error 收尾同一个形制。 */
+(function(){
+  if(typeof document === "undefined" || window.__qaArtHtmlPeek) return;
+  window.__qaArtHtmlPeek = true;
+  let layer = null;
+  const close = ()=>{
+    if(layer){ layer.parentNode && layer.parentNode.removeChild(layer); layer = null; }
+    document.removeEventListener("keydown", onKey);
+  };
+  function onKey(e){ if(e && e.key === "Escape") close(); }
+  function openPeek(p, u){
+    close();
+    layer = document.createElement("div");
+    layer.className = "qa-art-html-peek";
+    const bar = document.createElement("div");
+    bar.className = "qa-art-html-peek-bar";
+    const t = document.createElement("span");
+    t.className = "qa-art-html-peek-t";
+    t.textContent = String(p).split(/[\\/]/).pop() || p;
+    const x = document.createElement("button");
+    x.type = "button"; x.className = "qa-art-html-peek-x"; x.textContent = "关闭";
+    x.addEventListener("click", close);
+    bar.appendChild(t); bar.appendChild(x);
+    const f = document.createElement("iframe");
+    f.src = u; f.title = t.textContent;
+    f.setAttribute("sandbox", "allow-scripts allow-same-origin allow-popups allow-forms");
+    layer.appendChild(bar); layer.appendChild(f);
+    document.body.appendChild(layer);
+    document.addEventListener("keydown", onKey);
+  }
+  document.addEventListener("click", function(e){
+    const card = e.target && e.target.closest ? e.target.closest(".qa-art-html") : null;
+    if(!card || layer) return;
+    const p = String(card.dataset.path || "").trim();
+    if(!p || typeof qaArtUrl !== "function") return;
+    const u = qaArtUrl(p);
+    if(!u) return;                                          // 拼不出地址（预览态）→ 不动
+    e.preventDefault();
+    try{
+      const ob = (typeof window !== "undefined" && window.MagicHost) ? window.MagicHost.openBrowser : null;
+      if(typeof ob === "function"){ ob(u); return; }        // 有内置浏览器 → 跳浏览器
+    }catch(err){ /* 宿主通道不通 → 退全屏层 */ }
+    openPeek(p, u);
+  }, false);
+})();
+
 /* ── 会话产物 · 消息末尾的「本轮产物」（2026-10-15）─────────────────────────
    用户原话：「会话有新的图片、视频文件产生 应该在消息结束时附加在末尾作为会话产物显示预览」。
    正文里写出来的产物路径早就有渲染（qaShotsMount / qaArtMount：图变缩略图、视频变就地播放器），
@@ -819,7 +970,7 @@ function qaArtDrop(card){
    ⚠️ 与正文里已经画过的**不重复**（按绝对路径与文件名双判）：用户要的是「正文没提的也看得见」，
       正文里已经有的再画一遍就成了同一张图出现两次。
    ⚠️ 只**收**不摘、只**补**不改：正文与工具输出原文一个字都不动。 */
-const QA_TURN_ART_KIND = /^(?:image|video|file)$/;
+const QA_TURN_ART_KIND = /^(?:image|video|file|html)$/;
 /** 记一条候选路径进**这一轮**的产物集（去重；留图 / 视频 / 文件三档）。 */
 function qaTurnArtsNote(run, p){
   const s = String(p == null ? "" : p).trim();

package/client-ui/shared/conv/27-conv-ledger.js

@@ -313,7 +313,10 @@ function qaSessionPlayer(){
         }catch(e){ /* 收尾失败不影响回放 */ }
         h = null;
       }else if(arts){ arts.flush(null); }        // 没有答复卡的一轮：清掉残留，别串到下一轮
-      qaRenderMine(String(ev.text || ""), [], { hosted: !!ev.hosted });
+      /* 历史附件（参考图）随 user 事件落盘（{path, mime}）：透传给内核的 attHistUrl
+         按路径换回读地址 —— 与 93-rail 同一口径（2026-10-25 用户报障修复）。 */
+      qaRenderMine(String(ev.text || ""),
+        Array.isArray(ev.attachments) ? ev.attachments : [], { hosted: !!ev.hosted });
       t0 = atMs(ev);
       continue;
     }
@@ -349,7 +352,7 @@ function qaSessionPlayer(){
       qaRenderDone(!failed && !stopped,
         failed ? "调用失败 · " + String(ev.reason || ev.error || "未知错误").slice(0, 200)
           : stopped ? "已停止" : "已完成",
-        null, turnMs || null);
+        null, turnMs || null, failed ? ev : null);
       if(arts) arts.flush(h);                   // 终态之后这一轮的产物补在消息末尾（与实时 onDone 同位）
       t0 = 0;                                   // 这一轮收尾了：下一轮（若没有 user 事件）重新起算
       /* ⚠️ 句柄必须一起置空（2026-10-21 用户：「同一轮对话 显示成了两个」）：

package/client-ui/shared/conv/29-msg-variants.js

@@ -255,6 +255,223 @@ function qaMarkerNode(opts){
   return wrap;
 }
 
+/* ---------- 错误显示卡（终态失败的统一落笔）----------
+   用户 2026-10-23：「没有设计错误显示卡 现在是普通的 json 文本」—— 失败那一轮原来只落一行
+   `.qa-done.err` 等宽灰字（「调用失败 · <reason>」），没有卡片形态。这里补一张**真正的卡**：
+   朱砂描边 + 淡红底的卡片面，抬头是告警图标 + 「调用失败」标题 + 「失败」状态徽章，
+   主体是**根因**（reason，没被截断，人话那一句），底部可展开「错误详情」（完整错误链 /
+   JSON，走 qaCodeFrameNode，可复制）。
+
+   ⚠️ 与标记行（qaMarkerNode）的分工：control_error / command / notice 那种**过程性**的失败
+       仍落标记行（它们不是这一轮的终态，只是过程里的一次失败通知）；这张卡只给**这一轮真的
+       以失败收场**的终态（error / turn_failed / 桥不可用 / 回放失败）。两条形态不重叠。
+   ⚠️ 快照重建安全：整张卡的状态（开合）都靠 class / data-*，点击走 #qa-stream 事件委托
+       （见 07-stream-delegation 的 `.qa-mk-row` 分支）—— 展开详情那块直接复用 `.qa-mk`
+       那套词汇，所以委托不用为这张卡单独加逻辑，快照恢复出来的卡照样能点开。
+   ⚠️ 根节点**保留 `.qa-done` 类**：收尾行契约（`tests/check-conv-shared-host.mjs` 数 `.qa-done`）
+       只认这个类，改类名会让那条断言失守。卡片形态靠 `.qa-errcard` 额外类实现。 */
+function qaErrorCardNode(opts){
+  const o = opts || {};
+  const t = o.elapsedMs || "";
+  const det = o.detail;
+  let reason = "";
+  let chain = null;
+  /* 优先从结构化错误信封取根因与完整链（reason 是最内层原因、error 是带引擎包装的整条链）；
+     没有信封（桥异常 / 抛错）就退回 label 里那段，再不行给「未知错误」。 */
+  if(det && typeof det === "object"){
+    reason = String(det.reason || "").trim();
+    chain = det.error != null && String(det.error).trim() ? det.error
+          : det.message != null && String(det.message).trim() ? det.message
+          : null;
+  }
+  if(!reason && typeof o.label === "string"){
+    reason = String(o.label)
+      .replace(/^调用失败\s*·\s*/, "")
+      .replace(/\s*·\s*总耗时[\s\S]*$/, "")
+      .trim();
+  }
+  if(!reason) reason = "未知错误";
+
+  const wrap = document.createElement("div");
+  wrap.className = "qa-done err qa-errcard";
+
+  const hd = document.createElement("div");
+  hd.className = "qa-ec-hd";
+  hd.innerHTML =
+    '<span class="qa-ec-ico">' + (QA_V_ICONS.alert || "") + '</span>'
+    + '<span class="qa-ec-tt">调用失败</span>'
+    + qaStatusBadgeHtml("failed");
+  wrap.appendChild(hd);
+
+  const bd = document.createElement("div");
+  bd.className = "qa-ec-bd";
+  const rp = document.createElement("p");
+  rp.className = "qa-ec-reason";
+  rp.textContent = reason;
+  bd.appendChild(rp);
+  if(t){
+    const mt = document.createElement("div");
+    mt.className = "qa-ec-meta";
+    mt.textContent = "总耗时 " + t;
+    bd.appendChild(mt);
+  }
+  /* 完整错误链：复用 `.qa-mk` 词汇（行 + 明细），点击开合走委托，快照安全 */
+  if(chain != null && String(chain).trim()){
+    const mk = document.createElement("div");
+    mk.className = "qa-mk";
+    const row = document.createElement("div");
+    row.className = "qa-mk-row";
+    row.dataset.tog = "1";
+    row.innerHTML = '<span class="qa-mk-chev">' + (QA_V_ICONS.chev || "") + '</span>'
+                  + '<span class="qa-mk-tt">错误详情</span>';
+    mk.appendChild(row);
+    const mkbd = document.createElement("div");
+    mkbd.className = "qa-mk-bd";
+    const isStr = typeof chain === "string";
+    mkbd.appendChild(qaCodeFrameNode("error", isStr ? String(chain) : JSON.stringify(chain, null, 2)));
+    mk.appendChild(mkbd);
+    bd.appendChild(mk);
+  }
+  wrap.appendChild(bd);
+  return wrap;
+}
+
+/* ---------- 额度 / 限流提示卡（2026-10-25）----------
+   用户报障原话：「没额度了，设计一个提示卡」—— 截图里那一轮引擎把供应商的 429 通告
+   **当正文**发了回来，气泡里铺着一大段英文原文，上下还挂着「任务耗时 1m 26s」与复制/重试
+   图标行，整体观感像「这一轮正常完成了」。这比普通报错糟得多：用户既看不出没跑成，
+   也不知道该等还是该换模型。
+
+   ⚠️ **界面不解析通告原文**（判据只在 core：`internal/agent/limitnotice.go` 分类 + 取恢复时刻，
+       事件上带 `error_kind` / `error_code` / `reset_at`）。这里只做展示：认不出 kind 就退回
+       普通失败卡 —— 把「工具报错」画成「额度不足」比不画更糟。
+   ⚠️ 与 qaErrorCardNode 的关系：同一骨架（`.qa-errcard` / `.qa-ec-hd` / `.qa-ec-bd`），
+       只换色与信息层次（加一行「什么时候恢复」+ 一行建议）。所以 `.qa-done` 收尾行契约、
+       `.qa-mk` 展开委托两条都照旧成立，不必为这张卡单独加逻辑。 */
+const QA_QUOTA_KINDS = {
+  quota: {
+    title: "额度用尽", badge: "额度不足",
+    lead: "引擎账号的额度已用尽，这一轮没有跑完。",
+    hint: "建议：等额度恢复后再试，或切换到其它模型继续。",
+  },
+  rate_limit: {
+    title: "请求太频繁", badge: "已被限流",
+    lead: "请求过于频繁，引擎暂时拒绝了这一轮。",
+    hint: "建议：隔几分钟再试；这不是配置问题，不必改设置。",
+  },
+};
+
+/* 恢复时刻的展示文案：{clock:"15:07", rel:"约 2 小时后", past:false}；取不到回 null。
+   ⚠️ 只用 `new Date()` 解 core 给的 **RFC3339**（带偏移的确定形状），不做宽松解析 ——
+      V8 会把 `CST` 当美国中部时间（偏 14 小时，实测过），所以含糊的拼法在 core 侧就挡掉了。 */
+function qaQuotaReset(at){
+  const s = String(at || "").trim();
+  if(!s) return null;
+  const t = new Date(s);
+  if(isNaN(t.getTime())) return null;
+  const now = new Date();
+  const pad = (n)=> (n < 10 ? "0" : "") + n;
+  const sameDay = t.getFullYear() === now.getFullYear() && t.getMonth() === now.getMonth()
+    && t.getDate() === now.getDate();
+  const clock = (sameDay ? "" : (t.getMonth() + 1) + "月" + t.getDate() + "日 ")
+    + pad(t.getHours()) + ":" + pad(t.getMinutes());
+  const diff = t.getTime() - now.getTime();
+  if(diff <= 0) return { clock: clock, rel: "", past: true };
+  /* 相对时间只做「大致」参考，**不跨档乱除**：超过一天就说天（额度按 5 小时一档重置，
+     真通告基本都落在「几分钟 / 几小时」这一档；算出「约 639910 小时后」是捅了马蜂窝的写法）。 */
+  const min = Math.round(diff / 60000);
+  const rel = min < 1 ? "不到 1 分钟"
+    : min < 60 ? "约 " + min + " 分钟后"
+    : min < 60 * 24 ? "约 " + Math.round(min / 60) + " 小时后"
+    : "约 " + Math.round(min / 60 / 24) + " 天后";
+  return { clock: clock, rel: rel, past: false };
+}
+
+/* 事件信封 → 额度卡要的全部文案；**不是**额度/限流就回 null（调用方退回普通失败卡）。
+   纯函数（不碰 DOM）：单测与「这张卡该不该出现」的判定都只看它。 */
+function qaQuotaInfo(det){
+  if(!det || typeof det !== "object") return null;
+  const kind = String(det.error_kind || "").trim();
+  const k = QA_QUOTA_KINDS[kind];
+  if(!k) return null;
+  return {
+    kind: kind, code: String(det.error_code || "").trim(),
+    raw: String(det.reason || det.error || "").trim(),
+    title: k.title, badge: k.badge, lead: k.lead, hint: k.hint,
+    reset: qaQuotaReset(det.reset_at),
+  };
+}
+
+function qaQuotaCardNode(opts){
+  const o = opts || {};
+  const q = o.info || qaQuotaInfo(o.detail);
+  if(!q) return qaErrorCardNode(opts);            // 兜底：形状一样，只是不出额度卡
+
+  const wrap = document.createElement("div");
+  wrap.className = "qa-done err qa-errcard qa-quota";
+
+  const hd = document.createElement("div");
+  hd.className = "qa-ec-hd";
+  hd.innerHTML =
+    '<span class="qa-ec-ico">' + (QA_V_ICONS.alert || "") + '</span>'
+    + '<span class="qa-ec-tt"></span>'
+    + '<span class="qa-qc-badge"></span>';
+  hd.querySelector(".qa-ec-tt").textContent = q.title;
+  hd.querySelector(".qa-qc-badge").textContent = q.badge;
+  wrap.appendChild(hd);
+
+  const bd = document.createElement("div");
+  bd.className = "qa-ec-bd";
+  const lead = document.createElement("p");
+  lead.className = "qa-ec-reason";
+  lead.textContent = q.lead;
+  bd.appendChild(lead);
+
+  /* 恢复时刻：时刻本身加粗（用户此刻只想知道「几点能再用」），相对时间跟在后面；
+     已经过了恢复时刻就说「可以重试」—— 这时候再写「将于…恢复」就是假话。 */
+  if(q.reset){
+    const rp = document.createElement("p");
+    rp.className = "qa-qc-reset";
+    const b = document.createElement("b");
+    b.textContent = q.reset.clock;
+    if(q.reset.past){
+      rp.appendChild(document.createTextNode("已过恢复时刻（"));
+      rp.appendChild(b);
+      rp.appendChild(document.createTextNode("），可以重试。"));
+    }else{
+      rp.appendChild(document.createTextNode("将于 "));
+      rp.appendChild(b);
+      rp.appendChild(document.createTextNode(" 恢复" + (q.reset.rel ? "（" + q.reset.rel + "）" : "")));
+    }
+    bd.appendChild(rp);
+  }
+
+  const hint = document.createElement("p");
+  hint.className = "qa-qc-hint";
+  hint.textContent = q.hint;
+  bd.appendChild(hint);
+
+  /* 原文：留一条可展开的明细（排障要它 —— 谁限流的、request id 是多少）。
+     复用 `.qa-mk` 词汇 → 点击走 #qa-stream 委托，快照重建后照样能展开。 */
+  if(q.raw){
+    const mk = document.createElement("div");
+    mk.className = "qa-mk";
+    const row = document.createElement("div");
+    row.className = "qa-mk-row";
+    row.dataset.tog = "1";
+    row.innerHTML = '<span class="qa-mk-chev">' + (QA_V_ICONS.chev || "") + '</span>'
+                  + '<span class="qa-mk-tt">原文</span>';
+    mk.appendChild(row);
+    const mkbd = document.createElement("div");
+    mkbd.className = "qa-mk-bd";
+    mkbd.appendChild(qaCodeFrameNode(q.code ? "HTTP " + q.code : "原文", q.raw));
+    mk.appendChild(mkbd);
+    bd.appendChild(mk);
+  }
+  wrap.appendChild(bd);
+  return wrap;
+}
+
 /* ---------- ④ 分隔条（anywhere Marker variant="separator"）----------
    用在「横切整条会话」的事件上 —— anywhere 那边是**会话压缩**（`MarkerContentKind="compact"`，
    进行中/已完成两种文案）。分隔条不是谁说的话，形状本身就在说「这里是一条分界」。