magic-agent 1.0.2 → 1.0.46

package/client-ui/pc/js/18-askbox.js

@@ -1,120 +1,5 @@
-/* ===== 基础组件：融合输入框（askBox）=====
-   用户 2026-09-17 定稿：「令对话框变成 1 个基础组件，与工作台首页的要一样共用」+
-   「是要做成前端组件 改了大家都跟着变」。全应用**只此一份**标记与行为，
-   两处实例共用（此前是手抄三份，改一处漏两处）：
-     home2 → 工作台首页入口
-     home  → 任务对话视图
-   ＋ 菜单 = 5 个类型选项（需求 / 模拟测试 / 录屏 / 产品文档 / 测试用例），选中后以**胶囊**挂进对话框：
-   挂「需求」胶囊 → 发送 = 新建需求（正文存入待处理，不发起对话）；
-   挂「模拟测试」胶囊 → 发送 = 开一轮模拟测试（见 24-agent-test.js）；
-   挂「录屏」胶囊 → 发送 = 录屏模式（见 25-record.js）；
-   其余 / 没挂 = 普通对话。
-   需求管理页的那个输入框已下线 —— 新建需求的唯一入口在对话框的 ＋ 菜单里。
-   实例差异只走配置：id 前缀 p、占位文案。
-   挂载：askBoxMountAll() —— 按 ASK_INSTANCES 逐个替换宿主 innerHTML（box + 三只菜单）。
-   ⚠️ 改这里 = 改所有实例，不必再去各页面抄一遍；新增输入框请复用本组件而非复制标记。
-
-   ⚠️ 2026-09-21 第一版（用户：「对话窗口不选择模型了 直接使用配置界面的模型列表自动处理」）：
-   右下角只留一枚「引擎」选择器，模型按钮与它的菜单整体下线 —— 用哪个模型改由**配置界面**
-   （设置窗口「引擎配置」）里该引擎的**有序降级链**决定（链首 = 主选，其后是兜底候选，
-   执行侧按顺序自动试，见 src/js/04-task-list.js + desktop/chat-model.cjs）。
-   → 第二版（「不能选择 但是要显示用的是哪个」）：补一枚**只读模型标签**如实显示。
-   → 第三版（「工作台的对话框中可以选模型 在任务ui中只是显示」）：首页可选、任务对话只读。
-   → **第四版（2026-09-21 定稿，用户：「还是都可以选择模型 但是自动切换模型的时候 对话框下拉的
-     选中模型显示也要变」）：两个实例都恢复成可选的模型下拉**（按钮 + 菜单），
-     并且「自动切换模型」时下拉的选中项/文案**必须跟着变成实际在跑的那个**。
-   ⚠️ 别再按「只读标签」那两版改回去（只读标签 `-model-ro` / `.ag-mdl-ro` 已删干净）：
-   现在两处控件**同源同形态**，实例差异回到只有占位文案一条。
-   ⚠️ 与「两处真相」的关系：模型选择**是**允许的（用户要），但「这次到底下发哪个」仍只有一份
-   算法（`qaModelFor()`，见 04-task-list.js）—— 界面只负责把选择写回去、把实际值画出来。 */
-const ASK_ICON = {
-  plus: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round"><path d="M12 5v14M5 12h14"/></svg>',
-  access: '<svg class="i" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9"><circle cx="12" cy="12" r="9"/><path d="M12 8h.01M11 11.5h1v5h1" stroke-linecap="round"/></svg>',
-  engine: '<svg class="logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round"><rect x="7" y="7" width="10" height="10" rx="2"/><path d="M12 2.5v3M12 18.5v3M2.5 12h3M18.5 12h3M5.3 5.3l2.1 2.1M16.6 16.6l2.1 2.1M18.7 5.3l-2.1 2.1M7.4 16.6l-2.1 2.1"/></svg>',
-  /* 模型选择器上那枚「地球」小标（用图标而不是文字前缀，免得按钮变成「模型：xxx」那种表单感）。 */
-  model: '<svg class="logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" aria-hidden="true"><circle cx="12" cy="12" r="9.2"/><path d="M12 2.8c3.2 4.4 3.2 14 0 18.4M12 2.8c-3.2 4.4-3.2 14 0 18.4M3.4 9h17.2M3.4 15h17.2"/></svg>',
-  chev: '<svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 9l6 6 6-6"/></svg>',
-  arrow: '<svg class="ico-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 19V5M5 12l7-7 7 7"/></svg>',
-  stop: '<svg class="ico-stop" viewBox="0 0 24 24" fill="currentColor"><rect x="6.5" y="6.5" width="11" height="11" rx="2.4"/></svg>',
-};
-
-/** ＋ 菜单的**七种**「胶囊」类型（用户 2026-09-17 定稿 3 种；2026-09-21 依次加「模拟测试」「录屏」「截屏」；
- *  2026-09-23 加「短视频」：在工作台对话中增加新模式，通过集成调用 magic-shorts CLI 完成短视频制作）——
- *  ＋ 点开 = 7 个选项，选中哪类，哪类就以**胶囊**挂进对话框；
- *  发送语义由胶囊决定：**挂了「需求」胶囊 → 发送 = 新建需求**（正文存入待处理，不发起对话），
- *  挂「模拟测试」= 开测、挂「录屏」= 录屏模式、挂「截屏」= 截屏模式、挂「短视频」= 短视频流水线，
- *  否则 = 普通对话（胶囊随发送清掉）。
- *  ⚠️ 前五种（req / sim / rec / shot / shorts）是**改发送语义的模式**，后两种（doc / case）只是普通对话里挂个标记 ——
- *     排序不是随便排的，改发送语义的那几种必须靠前（见 19-attachments.js::askAddMenuBuild）。
- *  ⚠️ 键盘契约：**Enter = 发送 / 存入，Shift+Enter = 换行**。输入域是多行 textarea，
- *     所有「Enter 发送」处理器都必须判 `!e.shiftKey`（漏判会吃掉换行，多行输入形同虚设）。
- *     ⚠️ 且必须先过 `qaImeComposing`：**输入法合成中（候选词还没上屏）的那一下 Enter 归输入法，
- *        不是发送**（用户 2026-09-28：「输入时的 enter 不要发出去」）。
- *        合成态一律放行 —— 不 preventDefault、不提交，让候选词正常上屏；其余 Enter 一下即发，
- *        不做二次确认（用户 2026-09-29：「不需要两次 enter」）。 */
-const ASK_CHIP_LABEL = { req: "需求", sim: "模拟测试", rec: "录屏", shot: "截屏", shorts: "短视频", doc: "产品文档", case: "测试用例" };
-const ASK_CHIP_SIDE = { req: "发送即新建", sim: "发送即开测", rec: "发送即录屏", shot: "发送即截屏", shorts: "发送即短视频", doc: "普通对话", case: "普通对话" };
-
-/** 组件标记：返回 box + **四只菜单**（＋ / 引擎 / 模型 / 权限）的 HTML；菜单挂 box 之后，交由 qaMenuPlace 定位。
- *  ⚠️ 站内实例**必须渲染成同一个样子**（用户 2026-09-17 复查截图后强调）：
- *     同一个 box 类、同样的 ＋/权限胶囊、同样的引擎 + 模型下拉、同样位置的提示行、同样只有「一个发送钮」。
- *     实例之间只允许不同：① 占位文案。（2026-09-21 中途曾按实例分过模型控件形态 ——
- *     首页可选 / 任务对话只读 —— 用户随后定稿「还是都可以选择模型」，已还原成同源同形态。）
- *     曾经踩过：给某个实例省掉 ＋/权限、另加「取消」与一段说明文字 →
- *     用户一眼看出「两个对话框明显不一样，怎么会是共用」。别再按「上下文是否需要」去裁剪。
- *  输入域统一 textarea（rows=1 + field-sizing 自增高）—— 多行能力归组件本身。 */
-function askBoxMarkup(cfg){
-  const p = cfg.p;
-  const boxCls = cfg.boxCls || "home-box";
-  const ph = escHtml((cfg.ph && cfg.ph.ask) || "今天帮你做些什么？");
-  /* 待发队列行（用户 2026-09-18：「新需求排列在会话框上面」）：**会话框上方**的一行，
-     处理中提交的下一条排在这里等自动提交（见 qaMsgQueue 那段）。内容由 qaMsgQueueRender 现填。
-     ⚠️ 只给**会话框**（home 实例）画 —— home2 是新建对话入口，它提交的永远是「新会话」，
-        不排队，也不该挂一行永远空的 DOM。 */
-  const queueRow = cfg.p === QA_QUEUE_INSTANCE
-    ? `<div class="ag-queue" id="${p}-queue" data-testid="${p}-queue" hidden></div>` : "";
-  return `
-            <!-- 右上角吉祥物「大喵」= 应用图标抠图（用户 2026-09-17）；纯装饰，
-                 绝对定位在 .home-entry 里、框顶之上，不占布局也不拦点击（见 .ag-mascot 注释） -->
-            <img class="ag-mascot" id="${p}-mascot" src="assets/damiao-mascot.png"
-                 alt="" aria-hidden="true" draggable="false">
-            ${queueRow}
-            <div class="ag-box ${boxCls}" id="${p}-box" data-testid="${p}-box">
-              <div class="ag-atts" id="${p}-atts" data-testid="${p}-atts" hidden></div>
-              <div class="ag-top">
-                <!-- 胶囊在输入域**之前**、同一个 flex 行里 → 与文字同行（装不下才由 flex-wrap 折行） -->
-                <div class="ag-refs" id="${p}-refs" data-testid="${p}-refs" hidden></div>
-                <textarea id="${p}-input" data-testid="${p}-input" rows="1" placeholder="${ph}" autocomplete="off"></textarea>
-                <div class="ag-hints" id="${p}-hints"><span class="ag-hint" id="${p}-hint-at"><b>@</b>引用对话文件</span><span class="ag-hint-sep">，</span><span class="ag-hint" id="${p}-hint-slash"><b>/</b>调用技能与指令</span></div>
-              </div>
-              <div class="ag-bot">
-                <button class="ag-plus" id="${p}-plus" data-testid="${p}-plus" title="选择需求 / 模拟测试 / 录屏 / 产品 / 用例" aria-haspopup="listbox" aria-expanded="false" type="button">${ASK_ICON.plus}</button>
-                <!-- 访问权限 = **四档选择器**（2026-09-18 用户：「这个地方要选择」）。
-                     改造前是一枚二值胶囊（点一下在「允许完全访问 / 受限访问」间切换）——
-                     现在点开四档菜单，按钮文案 = 当前档位，选中态由 qaPermSync() 统一刷。
-                     ⚠️ 两个实例必须渲染成同一个样子：文案与选中态都来自**同一份** qaPerm。 -->
-                <button class="ag-access" id="${p}-access" data-testid="${p}-access" title="选择访问权限" aria-haspopup="listbox" aria-expanded="false" type="button">${ASK_ICON.access}<span class="txt">自动审批</span>${ASK_ICON.chev}</button>
-                <div class="ag-right">
-                  <span class="ag-busy" aria-hidden="true"></span>
-                  <button class="ag-model ag-engine" id="${p}-engine" data-testid="${p}-engine" type="button" title="选择引擎">${ASK_ICON.engine}<span class="txt">claude</span>${ASK_ICON.chev}</button>
-                  <!-- 模型 = **可选**（两个实例同款；用户 2026-09-21 定稿「还是都可以选择模型
-                       但是自动切换模型的时候 对话框下拉的选中模型显示也要变」）。
-                       文案与选中态由 qaModelPickSync() 现填；首帧给一个不撒谎的占位。 -->
-                  <button class="ag-model ag-mdl-pick" id="${p}-model" data-testid="${p}-model" type="button" title="选择模型">${ASK_ICON.model}<span class="txt">引擎默认</span>${ASK_ICON.chev}</button>
-                  <button class="ag-send" id="${p}-send" data-testid="${p}-send" title="发送" type="button">${ASK_ICON.arrow}${ASK_ICON.stop}</button>
-                </div>
-              </div>
-            </div>
-            <div class="ag-menu scroll-y" id="${p}-engine-menu" hidden><span class="ag-menu-cap">引擎</span><button class="ag-model-opt on" data-engine="claude" type="button">claude</button></div>
-            <div class="ag-menu scroll-y" id="${p}-model-menu" data-testid="${p}-model-menu" hidden></div>
-            <!-- 访问权限菜单：4 档，内容由 qaPermMenuBuild() 现填（见该函数注释） -->
-            <div class="ag-menu scroll-y ag-perm" id="${p}-perm-menu" data-testid="${p}-perm-menu" role="listbox" hidden></div>
-            <!-- ＋ 菜单：5 个类型选项（需求 / 模拟测试 / 录屏 / 产品文档 / 测试用例）—— 内容由 askAddMenuBuild 现填 -->
-            <div class="ag-menu scroll-y ag-add" id="${p}-add-menu" data-testid="${p}-add-menu" hidden></div>`;
-}
-
-/** 站内实例清单（唯一真相）：挂载、事件绑定、选择器数组都以它为准。
- *  ⚠️ 2026-09-17：需求管理页的「新建需求」输入框已下线（新建需求的唯一入口 = 对话框 ＋ 菜单）。 */
+/* 宿主半：输入框实例清单（ASK_INSTANCES / ASK_CFG）与授权档位菜单（qaPerm*）。
+   输入框标记与胶囊在内核：conv/18-askbox-markup.js。 */
 const ASK_INSTANCES = ["home2", "home"];
 /** 各实例配置 —— 允许不同的只有占位文案；尺寸/控件/结构一律相同
  *  ⚠️ 2026-09-21 中途曾在这里加过 `modelCtl`（首页可选 / 任务对话只读），用户随后定稿
@@ -201,62 +86,3 @@ function qaPermSet(id){
 }
 
 /** 实例运行态：已选的胶囊类型（按实例分开 —— 两个输入框互不干扰） */
-const askChips = {};                      // p → ["req" | "sim" | "rec" | "doc" | "case", ...]
-const askInputOf = (p)=> $("#" + p + "-input");
-const askHasReq = (p)=> (askChips[p] || []).includes("req");
-/** 挂了「模拟测试」胶囊吗（2026-09-21 新增的模式，发送即开测 —— 见 24-agent-test.js）。
- *  与「需求」胶囊同一套机制：语义由胶囊决定，拦截点在 qaAddBind 的捕获阶段。 */
-const askHasSim = (p)=> (askChips[p] || []).includes("sim");
-/** 挂了「录屏」胶囊吗（2026-09-21 新增的模式，发送即录屏 —— 见 25-record.js）。
- *  与前三枚同一套机制；⚠️ 拦截顺序是 rec → shot → sim → req（改发送语义的四枚里，越"重"的越先判，
- *  见 09-ask-event.js 的注释）。 */
-const askHasRec = (p)=> (askChips[p] || []).includes("rec");
-/** 挂了「截屏」胶囊吗（2026-09-21 新增的模式，发送即截屏 —— 见 25-record.js）。
- *  与「录屏」是**兄弟**（同一套前置体检 / MCP 工具 / 兜底），只差「要一帧还是要一段」。 */
-const askHasShot = (p)=> (askChips[p] || []).includes("shot");
-/** 挂了「短视频」胶囊吗（2026-09-23 新增的模式，发送即跑短视频流水线 —— 见 28-shorts.js）。
- *  与「录屏 / 截屏」同一套拦截机制（捕获阶段截发送 → desk.ask{ mode }），但它**不碰浏览器**：
- *  引擎只产任务单（```shorts-task 围栏块），壳逐阶段执行 magic-shorts CLI（选题 → 脚本 → 配音 → 成片）。 */
-const askHasShorts = (p)=> (askChips[p] || []).includes("shorts");
-
-/** 胶囊行渲染（＋ 菜单选中后出现在对话框里的胶囊，可单个摘掉） */
-function askChipsSync(p){
-  const el = $("#" + p + "-refs"); if(!el) return;
-  const list = askChips[p] || [];
-  el.hidden = !list.length;
-  el.innerHTML = list.map(kind=>
-    `<span class="ag-ref" title="${escHtml(ASK_CHIP_LABEL[kind] || kind)}">` +
-      `<span class="rk">${escHtml(ASK_CHIP_LABEL[kind] || kind)}</span>` +
-      `<button class="rx" data-kind="${kind}" type="button" aria-label="移除${escHtml(ASK_CHIP_LABEL[kind] || kind)}胶囊">×</button>` +
-    `</span>`).join("");
-}
-function askChipToggle(p, kind){
-  if(!ASK_CHIP_LABEL[kind]) return;
-  const list = askChips[p] || (askChips[p] = []);
-  const i = list.indexOf(kind);
-  if(i >= 0){ list.splice(i, 1); toast(`已移除${ASK_CHIP_LABEL[kind]}胶囊`); }
-  else {
-    list.push(kind);
-    toast(kind === "req" ? "已挂需求胶囊 · 发送即新建需求"
-      : kind === "sim" ? "已挂模拟测试胶囊 · 发送即开测（数字分身 ↔ 默认引擎，按判据打分）"
-      : kind === "rec" ? "已挂录屏胶囊 · 发送即录屏（引擎驱动内嵌浏览器录一段，产物落「浏览器工具 → 产物」）"
-      : kind === "shorts" ? "已挂短视频胶囊 · 发送即跑流水线（选题 → 脚本 → 配音 → 成片，几分钟）"
-      : `已挂${ASK_CHIP_LABEL[kind]}胶囊`);
-  }
-  askChipsSync(p);
-}
-function askChipDrop(p, kind){
-  const list = askChips[p] || [];
-  const i = list.indexOf(kind);
-  if(i < 0) return;
-  list.splice(i, 1);
-  askChipsSync(p);
-  toast(`已移除${ASK_CHIP_LABEL[kind] || kind}胶囊`);
-}
-/** 清空胶囊（发送后调用） */
-function askChipsClear(p){
-  if(!(askChips[p] || []).length) return;
-  askChips[p] = [];
-  askChipsSync(p);
-}
-

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

@@ -35,7 +35,7 @@ const HOST_DESK = (window.desk && typeof window.desk.ask === "function") ? windo
 const MAGIC_TOKEN = window.MAGIC_TOKEN
   || new URLSearchParams(location.search).get("token") || "";
 const MAGIC_BASE = (window.MAGIC_BASE || "").replace(/\/+$/, "");
-const transport = HOST_DESK ? null : window.MagicTransportHttp({ base: MAGIC_BASE, token: MAGIC_TOKEN });
+const transport = HOST_DESK ? null : window.MagicTransportHttp({ base: MAGIC_BASE, token: MAGIC_TOKEN, client: "pc" });
 
 /* ---------- 引擎行归一 ----------
    上游 magic-test 的 engines.cjs 会把 CLI 输出规范化；组件这一版直接吃 CLI 的原始行，

package/client-ui/pc/js/91-workbench-stubs.js

@@ -88,15 +88,8 @@ function qaEngHintSync(){
   });
 }
 
-/* 27-conv-log.js：找不到历史时那句说明（如实）。原样保留。 */
-function qaConvNoticeHtml(text, kind){
-  return `<div class="qa-hist-note${kind ? " " + kind : ""}">${escHtml(text)}</div>`;
-}
-function qaConvLostText(t){
-  const hasSid = !!(t && t.sessionId);
-  return "这条对话的历史没有留存下来（这一版还没有本地消息库）。"
-    + (hasSid ? "会话本身还在 —— 直接在这里追问，引擎会接着原来的上下文继续。" : "这一轮没有拿到会话 id，追问会新起一段上下文。");
-}
+/* 27-conv-ledger.js 的「找不到历史」两句文案已在**内核**（那是纯文案，与宿主无关）——
+   这里不再各留一份：重复顶层声明会让整个脚本 SyntaxError。 */
 
 /* ================= ② 诚实桩（这条能力这一版没有） ================= */
 
@@ -120,7 +113,8 @@ function qaTaskHistoryRecover(){ return Promise.resolve(""); }
    ⚠️ 这意味着**刷新页面历史就没了**：左栏条目来自 localStorage 的 qaTasks（04-task-list.js），
    点开时靠 t.snapshot 还原当前会话画面；其余（逐轮消息表）没有。持久化 = 增强点之一。 */
 function qaMsgLogLoad(){ return Promise.resolve([]); }
-function qaConvTurnSync(){ /* 无消息库可写 */ }
+/* qaConvTurnSync（台账写入）在内核 27-conv-ledger.js —— 本版无消息库，内核那份已经会
+   安全地「写进内存台账」，这里不必再挡一道。 */
 
 /* 截图相册 / 文档阅读器（右栏）—— 本版无右栏 */
 function reqShotUrl(){ return ""; }

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

@@ -81,13 +81,20 @@ async function qaRailLoad(quiet){
     if(!r || !r.ok){ qaRailErr = (r && r.error) || "会话清单读不到"; }
     else {
       const all = Array.isArray(r.sessions) ? r.sessions : [];
-      /* ⚠️ 判据只有一条：**有没有 `session_id`**（有 = 一条真会话，能续接、能回放）。
-         · 没有 `session_id` 的是一次性调用（归纳 / 判定 / 派发里的一轮），不是会话，不列；
+      /* ⚠️ 判据（2026-10-18 起分两档）：**有 `session_id` 的一律列**；还没有 `session_id` 的
+         （引擎还没报上来）只在「在跑 或 有日志」时列。
+         原先第一档就是「有没有 `session_id`」，于是这类会话被整条丢掉 —— **正在跑的那条会从
+         列表里消失**（用户 2026-10-18：「掌天瓶左栏显示的不对」，同一条会话移动端有、左栏没有）。
+         core 的落盘本来就是 `<run_id>.jsonl`（拿到 session_id 才改名），`--session-log` 认 run_id，
+         所以这类行点开是有历史的，不是「点了没东西」的死行。真死行（跑完了、没 id、没日志）不列。
          · 有 `session_id` 但 `hasLog=false` 的**照样列** —— 引擎当时是非流式跑的，没留下事件
            日志，可它仍然是一条 bot 会话（**审查轮就是这一类**：用户 2026-09-29「是审查也是
            bot，所以应该显示在对话 ui 的左边」）。早先我按 hasLog 把它们筛掉了，结果是审查
            在列表里整个消失。这类行会带「无历史」标记，点开也如实说清为什么没有。 */
-      qaRailAll = all.filter((s) => String(s.sessionId || "").trim());
+      qaRailAll = all.filter((s) => {
+        if (String(s.sessionId || "").trim()) return true;   // 有会话 id：照旧一律列（无历史那类带标记）
+        return !!(s.alive || s.hasLog);                      // 还没有会话 id：在跑 / 有日志才列
+      });
       qaRailSkipped = all.length - qaRailAll.length;
       qaRailNoLog = qaRailAll.filter((s) => !s.alive && !s.hasLog).length;
       qaRailErr = "";

package/client-ui/shared/conv/01-dom.js

@@ -0,0 +1,52 @@
+/* DOM 选择器与幂等写 —— 对话内核的公共基座（唯一实现）。
+   ⚠️ 宿主不要再各留一份同名实现：重复声明会让整个脚本 SyntaxError（见 tests/check-conv-shards.mjs）。
+   宿主半（按需包加载器 / 首屏字体 / 工作台 state）留在 magic-test 的 01-core.js 与 magic-agent pc 的 00-base.js。 */
+const $  = (s,el=document)=>el.querySelector(s);
+const $$ = (s,el=document)=>[...el.querySelectorAll(s)];
+
+/** 幂等写 innerHTML：**渲染结果字符串没变就不碰 DOM**，返回是否真的写了。
+ *
+ *  为什么需要（2026-09-19 用户报障：「处理中的任务显示一直在变 一会消失一会又显示在第一条」）：
+ *  左栏任务列表与需求看板都是靠「整份 innerHTML 重建」来刷新的，而**运行中每 700ms**
+ *  就有一次 output 增量落库（reqboard.cjs 的 LIVE_FLUSH_MS）→ 广播 update → 两侧各重建一次。
+ *  需求看板的卡片带入场动画（reqCardPop 的 0% 是 opacity:0），于是「处理中」那张卡每 0.7s
+ *  闪一下；左栏虽无动画，但整份重建会打散 hover 态与行尾菜单锚点，并让条目在「最新 5 条」
+ *  折叠线上反复进出 —— 两条链路的观感都是「列表一直在变」。
+ *  而这些重建绝大多数是**白做**：output / 会话快照这些高频变化的字段根本不上卡片和列表行。
+ *
+ *  判据用**最终 HTML 字符串**而不是逐个字段比对：字符串相同 ⇒ DOM 必然相同；
+ *  以后往卡片/行里加字段也不用回来补白名单 —— 漏一个字段就又会闪。
+ *  ⚠️ 别把「随渲染时刻变化的量」（如用 Date.now() 算出的已运行秒数）拼进 HTML：
+ *     那样每次字符串都不同，幂等直接失效（已运行秒数由 reqTickStart 就地改文本）。 */
+function htmlWrite(el, html){
+  if(!el) return false;
+  if(el.__html === html) return false;     // 与上次写进去的完全一致 → 跳过
+  el.__html = html;
+  el.innerHTML = html;
+  return true;
+}
+
+/* ---------- 输入法合成守卫（2026-09-28）----------
+   用户：「在工作台的对话框中输入文字时的 enter 不要马上一按就发出去」。
+   中文输入法里，**选词那一下按的 Enter 不是提交** —— 它归输入法，用来把候选词上屏。
+   对话框里的回车提交（home2 首页新建 / home 任务对话）原先只判 `e.key === "Enter"`，
+   于是拼音打到一半敲回车选词，消息先发走了。
+   判据两条：
+     ① `e.isComposing` —— 合成期间的 keydown 自带这个标记（选词那一下也是 true）；
+     ② `keyCode === 229` 兜底 —— 合成中按下的键在所有浏览器里都报 229。
+   合成态一律**放行**：不 preventDefault、不提交、不吞事件，输入框照常收字。
+   ⚠️ 本工程只跑 Chromium（Electron 壳 + <webview>），`isComposing` 在选词那一下是可靠的；
+      真要兼容旧 WebKit 才需要再挂一份 compositionstart/end 的元素级标记。 */
+function qaImeComposing(e){
+  return !!e && (e.isComposing === true || e.keyCode === 229);
+}
+
+/** 转义动态插值：域名、文件名这些来自外部（Chrome cookie / 磁盘 / 引擎输出），
+ *  拼进 HTML 前必须转义，否则一个带 < 的名字就能注入标记。
+ *  ⚠️ 它以前长在**宿主**里（magic-test 的 15-layout / pc 的 00-base），四个宿主各留一份，
+ *     组件宿主还得再抄 —— 而内核多个分片都要用它。阶段三收进内核：**全站只有这一份**。 */
+function escHtml(s){
+  return String(s == null ? "" : s)
+    .replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}

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

@@ -0,0 +1,34 @@
+/* 媒体类型与「产物路径」的**常量表**（纯声明，零宿主依赖）—— `QA_IMG_EXT_SRC` /
+   `QA_ART_EXT_SRC` / `QA_IMG_EXT` / `QA_ART_EXT` / `QA_SHOT_MARK` / `QA_SHOT_ITEM` /
+   `QA_IMG_LINE` / `QA_SHOT_PATH_RE` 都长在这儿。
+ *
+ *  ── 为什么单独一片（2026-10-16 阶段三）──
+ *  `19-attachments.js` 还带着**宿主耦合**的渲染与探测（qaShotsMount / qaArtMount /
+ *  desk:path-probe / toast），而**组件宿主**（移动端 / PC 对话页）只要这张表 ——
+ *  引整片 19 会被要求提供 toast / wsDirOf 那批它根本用不到的宿主符号。
+ *  拆开之后：桌面/工作台引 19（连带这张表），组件宿主只引这一片。
+ *
+ *  ⚠️ **后缀清单只此一份**：谁要加后缀就改这里 —— PC 宿主、移动宿主、magic-test 三处
+ *     的行内缩略图与产物台账都跟着变（清单漂移的症状是「同一张图这边有、那边没有」）。
+ */
+const QA_SHOT_MARK = /^\[粘贴的截图\]\s*$/;        // 对话侧：标记独占一行
+const QA_SHOT_ITEM = /^[-*]\s*(\S.*?)\s*$/;        // 紧随其后的 `- <路径>`
+const QA_IMG_LINE  = /^\[图片\]\s*(\S.*?)\s*$/;     // 飞书侧：一行一条
+/* 图片后缀（2026-10-12 加 svg / heic / avif）：这一档有缩略图，是既有行为。
+   ⚠️ 与 QA_ART_EXT 是**包含关系**：`qaArtKind` 先认图，其余才轮到视频 / 音频 / 文件。
+   ⚠️ 2026-10-16（阶段三）：后缀清单**只此一份** —— `QA_IMG_EXT` 与行内识别的
+      `QA_SHOT_PATH_RE` 都由 `QA_IMG_EXT_SRC` 派生（组件宿主也引这两个，别再各写一套；
+      清单漂移的后果是「同一条路径在 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";
+/** 整行就是一个产物路径（可带 `- ` 列表前缀）→ 摘成卡。
+ *  相对路径只在这一档认（必须带目录分隔符，光一个 `report.md` 太像正文了）。 */
+const QA_ART_PATH_SRC = "(?:file://|/|~/|[A-Za-z0-9_.@-]+/)";   // 绝对 / `~/` / `file://` / 相对（带目录）
+const QA_ART_LINE = new RegExp("^(?:[-*]\\s*)?(" + QA_ART_PATH_SRC + "[^\\s\"'`<>()\\[\\]，。；：、）】]*?\\.(?:" + QA_ART_EXT_SRC + "))$", "i");
+/* ⚠️ 后缀清单由 `QA_IMG_EXT_SRC` 派生（只此一份，见上）：以前这里硬写着
+   `png|jpe?g|gif|webp|bmp` —— 少 svg/heic/avif，于是「正文里那张 svg 在 PC 有缩略图、
+   在手机只剩一串路径」。 */
+const QA_SHOT_PATH_RE = new RegExp(
+  "(?:file://|/|~/)[^\\s\"'`<>()\\[\\]，。；：、）】]+?\\.(?:" + QA_IMG_EXT_SRC + ")(?![A-Za-z0-9])", "gi");