magic-agent 1.0.3 → 1.0.49

package/client-ui/pc/app.css

@@ -2181,7 +2181,9 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
 /* 运行态：**输入域不再锁**（2026-09-18 用户：「改成支持输入」）—— 照常可写、可回车提交，
    提交即排队（见 qaMsgQueue）。故这里既没有 opacity 降调、也没有 not-allowed 光标；
    占位文案由 qaBusyEx 换成「排队」说明，颜色走常态（锁已不存在，朱砂占位会误读成「不许写」）。
-   ⚠️ ＋（附件）仍锁：处理中贴图没有意义（要等下一轮才发得出去），见 askAttBind 的 busyGate。 */
+   ⚠️ ＋ 菜单（模式胶囊）仍锁：处理中挂胶囊 = 换这一条的发送语义，与「排队」那条路冲突。
+      贴图**不再受限**（2026-10-19 用户：「加截图没啥冲突 不应该限制」）—— 附件条照常可加，
+      与排队的那条一起发出，见 askAttBind。 */
 .ag-box.is-busy .ag-plus:disabled{opacity:.4;cursor:not-allowed}
 .ag-box.is-busy .ag-plus:disabled:hover{background:none}
 /* ---- 待发队列行（会话框上方）----
@@ -4850,9 +4852,44 @@ body::after{content:"";position:fixed;inset:0;z-index:60;pointer-events:none;opa
   animation:qaHistPulse 1.2s ease-in-out infinite}
 .qa-hist-note.lost{border-left-color:var(--cinnabar-hi)}
 @keyframes qaHistPulse{0%,100%{opacity:1}50%{opacity:.55}}
+/* ----- 读历史时的骨架屏（2026-10-20）：点（还活着）/ 扫光条（在推进）/ 占位行（内容要来了）。
+   只动 transform·opacity，配合分片回放让帧，主线程忙时也不会整块冻住。 */
+.qa-hist-note.qa-hist-loading{animation:none;padding:10px 12px 11px;overflow:hidden}
+.qa-hist-head{display:flex;align-items:center;gap:8px}
+.qa-hist-dots{display:inline-flex;align-items:center;gap:3px;flex:none}
+.qa-hist-dots i{width:5px;height:5px;border-radius:50%;background:var(--indigo);opacity:.3;
+  animation:qaHistDot 1s ease-in-out infinite}
+.qa-hist-dots i:nth-child(2){animation-delay:.15s}
+.qa-hist-dots i:nth-child(3){animation-delay:.3s}
+.qa-hist-bar{position:relative;height:1px;margin:9px 0;background:var(--line);overflow:hidden}
+.qa-hist-bar::after{content:"";position:absolute;inset:0;transform:translateX(-100%);
+  background:linear-gradient(90deg,transparent,var(--indigo),transparent);
+  animation:qaHistSweep 1.6s ease-in-out infinite}
+.qa-hist-lines{display:flex;flex-direction:column;gap:6px}
+.qa-hist-lines span{position:relative;display:block;height:8px;border-radius:4px;overflow:hidden;
+  background:rgba(28,25,23,.06)}
+.qa-hist-lines span:nth-child(1){width:72%}
+.qa-hist-lines span:nth-child(2){width:90%}
+.qa-hist-lines span:nth-child(3){width:54%}
+.qa-hist-lines span::after{content:"";position:absolute;inset:0;transform:translateX(-100%);
+  background:linear-gradient(90deg,transparent,rgba(255,255,255,.75),transparent);
+  animation:qaHistShimmer 1.8s ease-in-out infinite}
+.qa-hist-lines span:nth-child(2)::after{animation-delay:.12s}
+.qa-hist-lines span:nth-child(3)::after{animation-delay:.24s}
+@keyframes qaHistDot{0%,100%{transform:translateY(0);opacity:.28}40%{transform:translateY(-3px);opacity:1}}
+@keyframes qaHistSweep{0%{transform:translateX(-100%)}60%,100%{transform:translateX(100%)}}
+@keyframes qaHistShimmer{0%{transform:translateX(-100%)}55%,100%{transform:translateX(100%)}}
 [data-theme="dark"] .qa-hist-note{background:rgba(255,255,255,.04)}
 [data-theme="dark"] .qa-hist-note.wait{color:#525252}
 [data-theme="dark"] .qa-hist-note.lost{border-left-color:#F87171}
+[data-theme="dark"] .qa-hist-lines span{background:rgba(255,255,255,.09)}
+[data-theme="dark"] .qa-hist-lines span::after{
+  background:linear-gradient(90deg,transparent,rgba(255,255,255,.16),transparent)}
+@media (prefers-reduced-motion:reduce){
+  .qa-hist-dots i,.qa-hist-bar::after,.qa-hist-lines span::after{animation:none}
+  .qa-hist-dots i{opacity:.7}
+  .qa-hist-bar::after{transform:none;opacity:.55}
+}
 
 /* ===== M6b. 历史消息里的**思考块 / 工具卡**（.qa-hist-step · 2026-09-23）=====
    27-conv-log.js 的 qaConvMsgsHtml 按 kind 分流：thinking / tool 两类消息不再是纯文本
@@ -5052,6 +5089,52 @@ 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}
+
+/* ---- 助手图片块（KindImage / P0-1）----
+   正文区（.qa-t）与委派卡嵌套区（.qa-sub）共用同一张图卡：细边 + 圆角、宽度自适应
+   不撑爆气泡；data URI 直接进 src，不走 markdown 管线。 */
+.qa-img{display:block;margin:6px 0;max-width:min(360px,100%);border:1px solid var(--line);
+  border-radius:var(--r-md);overflow:hidden}
+.qa-img img{display:block;width:100%;height:auto}
+.qa-sub .qa-img{margin:4px 0;max-width:240px}
+
 /* ---- V5 工具明细改成「段栈面板」（anywhere ToolDetailPanel）----
    原写法：虚线顶边 + 裸段落 + `.qa-tool-sec+.qa-tool-sec{margin-top:7px}`。
    新写法：外框 1px + 段间 border-top —— 段与段的分界由**结构**给出，不再靠各自的内外边距，
@@ -5088,6 +5171,11 @@ 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)}
 [data-theme="dark"] .qa-st{background:rgba(245,244,243,.05);border-color:#3B3835}

package/client-ui/pc/index.html

@@ -131,21 +131,31 @@ body { overflow: hidden; background: var(--bg-page); }
 
 <div id="toast" role="status"><span id="toast-msg"></span></div>
 
-<script src="vendor/marked.min.js"></script>
-<script src="vendor/purify.min.js"></script>
+<!-- 第三方库已归口 `shared/vendor/`（内核与各宿主共用一份，别再往 pc/ 里存副本）：
+     marked（markdown）/ purify（消毒）/ highlight（代码高亮，由内核按需加载 → 地址在下面给） -->
+<script src="../shared/vendor/marked.min.js"></script>
+<script src="../shared/vendor/purify.min.js"></script>
+<script>window.QA_HLJS_URL = "../shared/vendor/highlight.min.js";</script>
+<!-- 对话内核（唯一实现，见 client-ui/shared/conv/README.md）：宿主只按 manifest 的顺序引它，别在这里改顺序 -->
+<script src="../shared/conv/01-dom.js"></script>
+<script src="../shared/conv/02-media-kinds.js"></script>
 <script src="js/00-base.js"></script>
 <script src="js/04-task-list.js"></script>
 <script src="js/91-workbench-stubs.js"></script>
+<script src="../shared/conv/10-markdown-render.js"></script>
 <script src="js/10-markdown.js"></script>
-<script src="js/03-chat-message.js"></script>
-<script src="js/29-msg-variants.js"></script>
-<script src="js/08-ask-event-map.js"></script>
-<script src="js/09-stream-apply.js"></script>
+<script src="../shared/conv/03-chat-message.js"></script>
+<script src="../shared/conv/29-msg-variants.js"></script>
+<script src="../shared/conv/08-ask-event-map.js"></script>
+<script src="../shared/conv/09-stream-apply.js"></script>
 <script src="js/07-chat-stream-render.js"></script>
-<script src="js/06-ask-answer.js"></script>
+<script src="../shared/conv/07-stream-delegation.js"></script>
+<script src="../shared/conv/06-ask-answer.js"></script>
 <script src="js/05-task-list-render.js"></script>
-<script src="js/19-attachments.js"></script>
+<script src="../shared/conv/19-attachments.js"></script>
+<script src="../shared/conv/18-askbox-markup.js"></script>
 <script src="js/18-askbox.js"></script>
+<script src="../shared/conv/27-conv-ledger.js"></script>
 <script src="../shared/transport-http.js"></script>
 <script src="js/92-composer.js"></script>
 <script src="js/93-rail.js"></script>

package/client-ui/pc/js/00-base.js

@@ -1,36 +1,14 @@
-/* 基础助手（从 magic-test 的 01-core.js / 15-layout.js 原样搬来）。
+/* 基础助手：`escHtml` / `toast` / 工作台 `state`（**宿主专属**的那几样）。
  *
- *  这一份是为了让**逐字复制过来的对话框代码**能跑起来 —— 它们按 magic-test 的全局函数风格写的
- *  （`$("#home-input")` 这类），所以这里保持同名同义，不去改那些文件里的调用点。
- *  改动请优先改上游（magic-test 的 src/js/），再同步到这里，避免两份漂移。
- */
+ *  ⚠️ `$` / `$$` / `htmlWrite` / `qaImeComposing` 已随阶段二收敛进**对话内核**
+ *     （`client-ui/shared/conv/01-dom.js`）—— 这里不再各留一份（重复顶层声明 = 整脚本 SyntaxError）。
+ *  这份文件是为了让**逐字复制过来的对话框代码**能跑起来 —— 它们按 magic-test 的全局函数风格写的
+ *  （`$("#home-input")` 这类），所以保持同名同义，不去改那些文件里的调用点。
+ *  toast 要宿主的 #toast 节点（见 index.html），所以它只能留在宿主这一侧。 */
 
-/* −− 选择器 −−
-   ⚠️ 注意是 **CSS 选择器**版，不是 id 版：调用点写的是 `$("#home-input")`。 */
-const $  = (s, el = document) => el.querySelector(s);
-const $$ = (s, el = document) => [...el.querySelectorAll(s)];
 
-/** 幂等写 innerHTML：渲染结果字符串没变就不碰 DOM。
- *  上游为「运行中列表每 700ms 重建一次导致闪动」而写；对话框的流式重绘也吃这条。 */
-function htmlWrite(el, html) {
-  if (!el) return false;
-  if (el.__html === html) return false;
-  el.__html = html;
-  el.innerHTML = html;
-  return true;
-}
-
-function escHtml(s) {
-  return String(s == null ? "" : s)
-    .replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-}
-
-/** 输入法合成守卫：中文输入法里「选词那一下按的 Enter」归输入法，不是提交。
- *  对话框的回车提交必须先过它，否则拼音打到一半敲回车会把半截消息发出去。 */
-function qaImeComposing(e) {
-  return !!e && (e.isComposing === true || e.keyCode === 229);
-}
+/* ⚠️ `escHtml` 也进了内核（`client-ui/shared/conv/01-dom.js`）—— 它是纯函数、零宿主依赖，
+   而内核多个分片都要用它。这里不再定义（重复顶层声明 = 整脚本 SyntaxError）。 */
 
 let toastTimer = null;
 function toast(msg, asHtml) {

package/client-ui/pc/js/05-task-list-render.js

@@ -405,7 +405,10 @@ function qaSessionBindFor(taskId, sessionId){
   qaTaskPersist(); qaDbUpdate(t, { sessionId });
 }
 /* 本轮结束（成功/失败/被停）后仍没有会话 id → 记一笔 sidLost。
-   为什么要记：`session_id` 只在 CLI 的 result 行里给，中途被停/超时的那轮永远拿不到它；
+   ⚠️ 「session_id 只在 result 行里给」这句写于 `--events` 之前：现在 core 一拿到 id 就**每行都带**
+   （internal/cli/events.go 的 eventAttrs），PC 也在每个事件上当场绑锚点（09-stream-apply.js 开头的
+   sidAny，2026-10-15 起）—— 所以中途被停 / 超时的那轮通常已经拿到 id，不会再走到这里。
+   这条兜底留给「整轮真的一条 id 都没带」的情形（老 CLI、非 --events 形态、引擎自己没回 id）。
    没有这个标记，下一轮追问就只能从零开一个新会话（引擎失忆 = 用户看到的「没了 session」）。
    有这个标记 → 追问时下发 `-c`，续接该目录最近一次会话（引擎自己那条），至少接得回去。 */
 function qaTaskMarkSidLost(){ qaTaskMarkSidLostFor(qaActiveId); }

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

@@ -1,88 +1,5 @@
-/* ---------- #qa-stream 事件委托：工具卡 / 思考条的开合 / 提问卡点选 ----------
-   为什么必须委托：快照恢复（qaTaskSwitch / qaDbLoad / 启动恢复）走的是
-   `s.innerHTML = t.snapshot` —— DOM 节点被整份重建，绑在卡片上的监听随旧节点消失。
-   表现就是「点侧栏历史任务后，WebSearch 这类工具卡点了没反应」（2026-09-16 用户报障）。
-   委托挂在容器 #qa-stream 上（它从不被替换，只换 innerHTML），历史卡片照样可开合。
-   ⚠️ 提问卡（⑤ .qa-ask）同理：恢复出来的历史提问卡也要能点选 —— 它比工具卡更怕丢监听。
-   幂等：重复调用只绑一次。 */
-let qaStreamDelegated = false;
-function bindQaStreamDelegation(){
-  const s = $("#qa-stream");
-  if(!s || qaStreamDelegated) return;
-  qaStreamDelegated = true;
-  s.addEventListener("click", e=>{
-    // ⑤ 提问卡：选项 / 提交 / 「其他」确认（先于工具卡判定 —— 卡里没有 .qa-tool-head，互不干扰）
-    const askOpt = e.target.closest && e.target.closest(".qa-ask-opt");
-    if(askOpt){ const c = askOpt.closest(".qa-ask"); if(c) qaAskPick(c, askOpt); return; }
-    const askSub = e.target.closest && e.target.closest(".qa-ask-sub");
-    if(askSub){
-      const c = askSub.closest(".qa-ask");
-      if(c && !qaAskAnswered(c) && qaAskAllDone(c)) qaAskMark(c, qaAskText(c));
-      return;
-    }
-    const askGo = e.target.closest && e.target.closest(".qa-ask-go");
-    if(askGo){
-      const c = askGo.closest(".qa-ask");
-      const inp = c && c.querySelector(".qa-ask-other input");
-      if(c) qaAskFree(c, inp && inp.value);
-      return;
-    }
-    const toolHead = e.target.closest && e.target.closest(".qa-tool-head");
-    if(toolHead){
-      const card = toolHead.closest(".qa-tool"); if(!card) return;
-      card.dataset.touched = "1";               // 记「用户手动开合过」，自动收起让位
-      card.classList.toggle("open");
-      return;
-    }
-    /* ②③ 复制按钮（代码面板帧 / 工具明细段，2026-09-28）：
-       要复制的原文落位是**固定的** —— 面板里是 `.qa-cf-bd pre`，明细段里是 `.qa-tool-sec pre`
-       （见 29-msg-variants 的 qaCodeFrameNode / QA_COPY_BTN）。按这个约定取文本，
-       所以按钮本身不带任何 data-*，快照重建后照样能复制。
-       点完切成对勾 1.2s：原来没有反馈，用户会怀疑没复制上、连点好几次。 */
-    const cpBtn = e.target.closest && e.target.closest(".qa-cf-copy");
-    if(cpBtn){
-      const host = cpBtn.closest(".qa-cf, .qa-tool-sec");
-      const pre = host && host.querySelector("pre");
-      if(typeof qaCopyText === "function") qaCopyText(pre ? pre.textContent : "");
-      cpBtn.classList.add("copied");
-      setTimeout(()=>cpBtn.classList.remove("copied"), 1200);
-      return;
-    }
-    /* ② 单行标记行开合（图标 + 人话标题 + 状态徽章 + 可展开明细）。
-       ⚠️ 没有明细（data-tog="0"）时不可点 —— 否则点了一下什么都没有，像坏了。 */
-    const mkRow = e.target.closest && e.target.closest(".qa-mk-row");
-    if(mkRow){
-      if(mkRow.dataset.tog !== "1") return;
-      const mk = mkRow.closest(".qa-mk"); if(!mk) return;
-      mk.dataset.touched = "1";
-      mk.classList.toggle("open");
-      return;
-    }
-    const thinkTg = e.target.closest && e.target.closest(".qa-think-toggle");
-    if(thinkTg){
-      const th = thinkTg.closest(".qa-think"); if(!th) return;
-      th.dataset.touched = "1";
-      th.classList.toggle("open");
-      return;
-    }
-    const toolsTg = e.target.closest && e.target.closest(".qa-tools-toggle");
-    if(toolsTg){
-      const ts = toolsTg.closest(".qa-tools"); if(!ts) return;
-      ts.dataset.touched = "1";
-      ts.classList.toggle("open");
-    }
-  });
-  // 「其他」行的回车确认（input 的 Enter 不会走 click；同样挂在容器上才不怕快照重建）
-  // ⚠️ 合成中（输入法选词那一敲）不算确认，见 qaImeComposing —— 这行输入框同样要吃中文。
-  s.addEventListener("keydown", e=>{
-    if(qaImeComposing(e)) return;
-    if(e.key !== "Enter") return;
-    const inp = e.target.closest && e.target.closest(".qa-ask-other input");
-    if(!inp) return;
-    e.preventDefault();
-    const c = inp.closest(".qa-ask"); if(c) qaAskFree(c, inp.value);
-  });
-}
+/* 宿主半：左栏任务绑定 + 发送 / 停止 / 忙碌锁。
+   「#qa-stream 事件委托」在内核：conv/07-stream-delegation.js。 */
 function bindNavTasks(){
   const box = $("#nav-tasks"); if(!box) return;
   box.addEventListener("click", e=>{

package/client-ui/pc/js/10-markdown.js

@@ -1,176 +1,8 @@
-/* ---------- 完整 Markdown 渲染器（专业栈：marked + DOMPurify + highlight.js）----------
-   解析：marked（GFM）——表格对齐 / 任务列表 / 删除线 / 自动链接 / 围栏语言标签，
-        远超手写正则的边界正确性（嵌套列表、松散列表、行内混排等）。
-   净化：DOMPurify——文档正文多来自网页采集（不可信源），渲染后必须消毒，
-        防脚本 / 事件属性注入；放行 title / target / align / class 等阅读必需属性。
-   高亮：highlight.js——代码块按 ```lang 自动着色（hljs.highlightElement）。
-        ⚠️ 它是**按需加载**的（2026-09-19）：129KB，只有真渲染出代码块时才注入，
-        见下方 loadHljs()，不要在 index.html 里同步引它。
-   保留契约：仍返回 { html, anchors }。anchors 为标题索引（level/text/id），
-        供右侧目录（.md-toc）点击定位；标题锚点 id 稳定（h-1 / h-2 …），
-        悬停显示「#」。与既有的 .md-body 版式 / .doc-reader 结构完全对接。 */
-
-const MD_STACK_READY = (typeof marked !== "undefined") && (typeof DOMPurify !== "undefined");
-let _mdAnchors = [], _mdHSeq = 0;
-
-/** 取纯文本（去行内标记），用于目录标题 */
-function mdPlainText(s){
-  return String(s||"")
-    .replace(/!\[([^\]]*)\]\([^)]*\)/g,"$1")
-    .replace(/\[([^\]]*)\]\([^)]*\)/g,"$1")
-    .replace(/`([^`]*)`/g,"$1")
-    .replace(/\*\*([^*]+)\*\*/g,"$1").replace(/__([^_]+)__/g,"$1")
-    .replace(/\*([^*]+)\*/g,"$1").replace(/_([^_]+)_/g,"$1")
-    .replace(/~~([^~]+)~~/g,"$1")
-    .replace(/\s+/g," ").trim();
-}
-
-/* 一次性配置 marked 渲染器：
-   - heading  → 稳定锚点 id + 收集目录 + 「#」锚点（.h-anc，::before 出 # 号）
-   - code     → 保留 code-lang 角标 + hljs 类，随后由 highlightElement 上色
-   - listitem → GFM 任务项改写成既有 .task-li 结构；普通项回退默认渲染
-   - link     → 外链加 target=_blank rel=noopener，防钓鱼落页 */
-if(MD_STACK_READY){
-  marked.use({
-    gfm:true,
-    breaks:false,
-    renderer:{
-      heading(tok){
-        const inner = this.parser.parseInline(tok.tokens||[]);
-        const id = "h-" + (++_mdHSeq);
-        _mdAnchors.push({ level:tok.depth, text:mdPlainText(tok.text), id });
-        return `<h${tok.depth} id="${id}">${inner}<a class="h-anc" href="#${id}" title="定位此标题" aria-hidden="true"></a></h${tok.depth}>\n`;
-      },
-      code(tok){
-        const lang = String(tok.lang||"").split(/\s+/)[0];
-        const cls = "hljs" + (lang ? " language-" + lang : "");
-        // 转义代码正文：既保证 <tag> 原样显示，也避免消毒阶段误删
-        const body = String(tok.text||"")
-          .replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");
-        return `<pre>${lang?`<span class="code-lang">${lang}</span>`:""}<code class="${cls}">${body}</code></pre>\n`;
-      },
-      listitem(tok){
-        if(tok.task){
-          const body = this.parser.parse(tok.tokens||[], !!tok.loose);
-          return `<li class="task-li${tok.checked?" done":""}"><span class="bx">✓</span><span class="tx">${body}</span></li>\n`;
-        }
-        return false;   // 回退 marked 默认（保留嵌套 <ul>/<ol>）
-      },
-      link(tok){
-        const text = this.parser.parseInline(tok.tokens||[]);
-        const href = String(tok.href||"");
-        const ti = tok.title ? ` title="${tok.title}"` : "";
-        const ext = /^https?:/i.test(href);
-        return `<a href="${href}"${ext?' target="_blank" rel="noopener"':""}${ti}>${text}</a>`;
-      },
-    },
-  });
-}
-
-/** 手写兜底：vendor 未加载时仍能阅读（仅线性块级，极端降级） */
-function mdFallback(src){
-  const esc = (s)=>String(s??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");
-  let html = "", inCode = false, buf = [];
-  const flushPara = ()=>{ if(buf.length){ html += "<p>" + esc(buf.join(" ")) + "</p>"; buf = []; } };
-  String(src||"").split(/\r?\n/).forEach((ln)=>{
-    if(/^\s*```/.test(ln)){ flushPara(); if(inCode){ html += `<pre><code>${esc(buf.join("\n"))}</code></pre>`; buf=[]; } inCode=!inCode; return; }
-    if(inCode){ buf.push(ln); return; }
-    const hm = /^(#{1,6})\s+(.*)$/.exec(ln);
-    if(hm){ flushPara(); const lv=hm[1].length, id="h-"+(++_mdHSeq);
-      _mdAnchors.push({level:lv,text:mdPlainText(hm[2]),id});
-      html += `<h${lv} id="${id}">${esc(hm[2])}</h${lv}>`; return; }
-    if(/^\s*$/.test(ln)){ flushPara(); return; }
-    buf.push(ln.trim());
-  });
-  flushPara();
-  return html;
-}
-
-/** 把「独占一行的图片路径」变成 markdown 图片，让对话里**直接看到图**（2026-09-19）。
- *
- *  为什么需要：引擎产出/引用的截图通常写成**一行绝对路径**（或本项目入库时的 `[图片] <路径>`），
- *  不是 markdown —— 不转的话对话里只有一行字，看不到图；而飞书那边的完成回执也会把同一批图
- *  上传成内联图（见 feishu-bridge.cjs::extractImageRefs），两边口径对齐。
- *
- *  ⚠️ 只认**独占一行**的绝对路径 + 常见图片扩展名：
- *    · 不碰行内路径（正文里提到 `src/js/xxx.png` 不该变成图）；
- *    · 路径里不含空格 / 引号 / 括号（含了就不转，免得把 markdown 语法拼坏）；
- *    · alt 也填路径 —— 图加载不出来时还能看见它指向哪。 */
-function mdLocalizeImagePaths(src){
-  const EX = "png|jpe?g|gif|webp|bmp";
-  return String(src||"")
-    // 本项目入库时给飞书图片的写法：`[图片] /abs/x.png`
-    .replace(new RegExp("^[ \\t]*\\[图片\\][ \\t]*(/\\S+\\.(?:" + EX + "))[ \\t]*$", "gim"),
-      (_a, p) => `![${p}](${p})`)
-    // 裸路径独占一行
-    .replace(new RegExp("^[ \\t]*(/[^\\s`'\"()<>]+\\.(?:" + EX + "))[ \\t]*$", "gim"),
-      (_a, p) => `![${p}](${p})`);
-}
-
-/** 渲染 Markdown → { html, anchors } */
-function mdToHtml(src){
-  _mdAnchors = []; _mdHSeq = 0;
-  src = mdLocalizeImagePaths(src);
-  if(!MD_STACK_READY){ return { html: mdFallback(src), anchors: _mdAnchors }; }
-  let raw;
-  try{
-    raw = marked.parse(String(src||""));
-  }catch(e){
-    console.warn("[md] marked 解析失败，回退简易渲染：", e && e.message);
-    return { html: mdFallback(src), anchors: _mdAnchors };
-  }
-  // 消毒：放行阅读必需的属性 / 标签；禁 script、事件属性、javascript: 协议
-  const html = DOMPurify.sanitize(raw, {
-    ADD_ATTR: ["target", "rel", "align", "class", "id", "title", "disabled", "checked", "type"],
-    FORBID_TAGS: ["script", "style", "iframe", "form", "input"],
-    FORBID_ATTR: ["onerror", "onload", "onclick", "style"],
-  });
-  return { html, anchors: _mdAnchors };
-}
-
-/** 只取 HTML（兼容旧调用） */
-function mdToHtmlOnly(src){ return mdToHtml(src).html; }
-
-/* ---------- highlight.js 按需加载（2026-09-19）----------
-   129KB，比 marked + purify + floating-ui 加起来还大 —— 但只有真渲染出代码块时才用得到。
-   原来它在 index.html 里同步加载，每次启动都白解析一遍。现在首次需要时才注入；
-   注入完成前代码块以纯文本呈现（下面的 typeof hljs 分支本来就兜住了，不影响功能）。
-   流式渲染每闭合一段都会调一次 highlightIn → 加载期间可能登记多个根节点，
-   用 Set 去重，加载完统一补扫一遍。 */
-let _hljsLoading = false;
-const _hljsPending = new Set();
-function loadHljs(){
-  if(typeof hljs !== "undefined" || _hljsLoading) return;
-  _hljsLoading = true;
-  const s = document.createElement("script");
-  s.src = "vendor/highlight.min.js";
-  s.onload = () => {
-    _hljsLoading = false;
-    _hljsPending.forEach((r)=>{ try{ highlightIn(r); }catch(e){ /* 节点可能已卸载，忽略 */ } });
-    _hljsPending.clear();
-  };
-  s.onerror = () => { _hljsLoading = false; };   // 加载失败就一直纯文本，不影响功能
-  document.head.appendChild(s);
-}
-
-/** 对已插入 DOM 的代码块执行语法高亮；hljs 还没就绪就先登记，加载完补扫。
- *  ⚠️ 先查有没有代码块再决定要不要惊动 129KB —— 渲染普通文档（无 ``` 块）时
- *  highlightIn 照样会被调一次，不能让它把 highlight.js 白拉下来。 */
-function highlightIn(root){
-  if(!root) return;
-  const blocks = root.querySelectorAll("pre code");
-  if(!blocks.length) return;
-  if(typeof hljs === "undefined"){ _hljsPending.add(root); loadHljs(); return; }
-  blocks.forEach((el)=>{
-    if(el.dataset.hl) return;
-    try{ hljs.highlightElement(el); el.dataset.hl = "1"; }catch(e){ /* 未知语言静默跳过 */ }
-  });
-}
-
 /* ---------- 右栏多标签系统 ----------
-   tab 形态：{ id, kind:'browser'|'doc', docId?, el, paneEl }
+   tab 形态：{ id, kind:'browser'|'doc'|'features'|'shots'|'artifact', docId?/path?, el, paneEl }
    - 浏览器工具标签常驻、不可关闭
-   - 每份产品文档直接就是一个标签页（不经任何索引层、无弹窗），内容即完整 Markdown 阅读器 */
+   - 每份产品文档直接就是一个标签页（不经任何索引层、无弹窗），内容即完整 Markdown 阅读器
+   - 对话产物（图 / 视频 / 音频 / 文档 …）点开也是一枚标签（openArtifactTab），可就地预览 */
 let dockTabs = [];          // 全部标签（含常驻浏览器）
 let activeDockTab = null;   // 当前激活 tab id
 let docTabSeq = 0;