magic-agent 1.0.0 → 1.0.2

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

@@ -0,0 +1,212 @@
+/* 适配层：让**逐字复制过来的** magic-test 对话框代码在两种宿主下都能跑起来。
+ *
+ *  ── 只做两件事 ──
+ *   ① 保证 `window.desk.*` 存在（上游代码只认这个接口）：
+ *        · 宿主已经注入了 desk（掌天瓶 Electron 壳的 preload）→ **直接用宿主的**；
+ *        · 没有宿主桥（浏览器直开 / 静态预览）→ 这里装一个同名的适配，把通道接到 transport：
+ *            desk.ask(payload)         → transport.ask，事件按 rid 回推给 onAskEvent 订阅者
+ *            desk.askStop(rid)         → transport.control({op:'interrupt'})
+ *            desk.askAppend({id,text}) → transport.control({op:'answer', text})
+ *            desk.onAskEvent(cb)       → 订阅（返回退订函数）
+ *            desk.engines()            → transport.listEngines()，并把 CLI 的 snake_case 归一成
+ *                                        上游约定的 {ok, engines:[{modelsNote, …}]}
+ *   ② 挂载：askBoxMountAll（输入框）→ qaComposerInit（菜单 + 发送 + 流）。
+ *
+ *  ── 关于「补丁函数」──
+ *    凡是**复制文件里已经带了实现**的，这里绝不重复声明（会直接撞成
+ *    "Identifier has already been declared"）；只有真的没人定义的，才补最小实现，
+ *    且一律「如实说」——不假装成功、不静默失败。它们就是后面找增强点的清单。
+ *
+ *  ⚠️ 维护提醒：往这儿加符号前，先确认复制文件里没有同名顶层声明。
+ */
+
+/* ---------- 宿主桥优先 ----------
+ *  ⚠️ 这一段是**集成时唯一要认的规矩**：
+ *    · 页面被**宿主**打开（掌天瓶 Electron 壳就是），宿主 preload 已经注入了 `window.desk`
+ *      → 直接用它。宿主那份是 IPC 直连 CLI，链路更短，而且有几个能力只有宿主给得了：
+ *      附件落盘 `desk.pasteImage`、按会话 id 追加 `desk.askAppend`、SQLite 任务库
+ *      `desk.tasksList`。自己再包一层 transport 会把这些**顶掉**，症状是「附件贴不上、
+ *      作答变成新起一轮」。
+ *    · 没有宿主桥（浏览器直接开 / 静态预览）→ 才自建：把 desk 的四个通道接到 transport。
+ *  两种情形下，下面的渲染层代码一个字都不用改（它只认 window.desk）。 */
+const HOST_DESK = (window.desk && typeof window.desk.ask === "function") ? window.desk : null;
+
+/* ---------- 传输层（仅无宿主桥时用） ---------- */
+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 });
+
+/* ---------- 引擎行归一 ----------
+   上游 magic-test 的 engines.cjs 会把 CLI 输出规范化；组件这一版直接吃 CLI 的原始行，
+   所以在这里对齐字段名（`models_note` → `modelsNote` 等），其余原样透传。 */
+function normalizeEngineRow(r){
+  const models = Array.isArray(r.models) ? r.models.map((m)=> (typeof m === "string" ? m : (m && m.id) || "" )).filter(Boolean) : [];
+  const labels = {};
+  (Array.isArray(r.models) ? r.models : []).forEach((m)=>{
+    if(m && typeof m === "object" && m.id) labels[m.id] = m.name || m.id;
+  });
+  return {
+    engine: r.engine,
+    ok: r.ok !== false,
+    bin: r.bin || "",
+    note: r.note || "",
+    models: models,
+    modelLabels: Object.assign(labels, r.modelLabels || {}),
+    modelCredits: r.model_credits || r.modelCredits || {},
+    modelsNote: r.models_note || r.modelsNote || "",
+    workspace: r.workspace || "",
+    streaming: r.streaming,
+    attachments: r.attachments || "",
+    permission: r.permission || "",
+    capabilities: r.capabilities || [],
+  };
+}
+
+/* ---------- desk 适配（只在没有宿主桥时安装） ---------- */
+(function installDeskAdapter() {
+  if (HOST_DESK) return;      // 宿主已经给了 desk，别覆盖它
+  const subs = [];
+  let ridSeq = 0;
+  /* ⚠️ 事件**延后一个微任务**再推给订阅者 —— 这不是洁癖，是修一个真实的竞态：
+     SSE 常把 `open` 与紧随其后的若干事件**放在同一个网络块**里回来（一次 write 合并成一段），
+     transport 会在一个 forEach 里把它们连着派给 onEvent。若在此**同步**转发，
+     渲染层此时还在 `await desk.ask(...)` 里没恢复（run 尚未按 rid 登记），
+     `qaRuns.get(ev.rid)` 一律取不到 → **整轮事件被当过期事件丢光**：画面只剩用户气泡。
+     推到微任务队列后，onOpen 触发的那个 Promise 续体（它才会 `qaRuns.set(rid, run)`）
+     排在前面先跑，事件随后必被认领。顺序仍严格保持（逐个入队，FIFO）。 */
+  const emit = (rid, ev) => {
+    Promise.resolve().then(() => {
+      /* ⚠️ 订阅者抛错**要吭声**：静默 catch 会让「整轮画面不动」变成没有任何线索的哑故障
+         （事件明明推到了、渲染层却什么都没画 —— 排查时最费时间的一类）。 */
+      subs.forEach((fn) => {
+        try { fn(Object.assign({ rid: rid }, ev)); }
+        catch (e) { console.error("[desk] 事件订阅者处理失败", ev.type, e); }
+      });
+    });
+  };
+
+  window.desk = {
+    /* 起一轮。上游约定：**立即**回 {ok, rid}（渲染层据此登记 run），事件随后经 onAskEvent 推进来。
+       所以这里等到 transport 的 onOpen（或失败）才 resolve —— 但**不阻塞**事件回推。 */
+    ask(payload) {
+      /* ⚠️ rid 必须是**数字**，不能图省事用 "r1" 这种字符串：上游代码拿它做 `Number.isFinite(rid)`
+         判断（提问卡的答案要走 `--append` 追加回同一条会话，见 06-ask-answer.js 的 qaAskSend），
+         字符串会判 false → 答案被降级成「排队，等这一轮结束再发」，而不是当场追加。
+         `0` 是上游的「占位 rid（尚未到手）」，所以从 1 起编号。 */
+      const rid = ++ridSeq;
+      return new Promise((resolve) => {
+        let settled = false;
+        const done = (r) => { if (!settled) { settled = true; resolve(r); } };
+        try {
+          transport.ask(payload, {
+            onOpen() { done({ ok: true, rid: rid }); },
+            onEvent(ev) { emit(rid, ev); },
+            onEnd(code) { 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 });
+              done({ ok: false, error: msg });
+            },
+          });
+        } catch (e) {
+          const msg = String((e && e.message) || e);
+          emit(rid, { type: "error", reason: msg });
+          emit(rid, { type: "end", code: 1 });
+          done({ ok: false, error: msg });
+        }
+        /* 兜底：有些 transport 不回调 onOpen（一轮没有 open 帧）。给个上限，
+           别让 qaSend 卡在 `await desk.ask` 上 —— 事件照旧按 rid 路由。 */
+        setTimeout(() => done({ ok: true, rid: rid }), 2000);
+      });
+    },
+    askStop(rid) { return transport.control({ id: rid, op: "interrupt" }); },
+    /* append = 往这条还活着的会话追加一条用户消息（引擎把它当下一轮）。
+       在 core 那边就是 --control 的 answer。
+       ⚠️ 必须回 `{ok}` 形状：上游 qaSend 拿的是 `ar.ok`（见 07-chat-stream-render.js 的
+       `if(ar && ar.ok)`）。而 transport 的 control 只回一个裸 true —— 不归一的话，
+       提问卡的答案会被判成「追加未送达」，白白回落成「新起一轮 + --session」，
+       多一次冷启动（答案还是送得到，只是慢且费）。 */
+    askAppend(p) {
+      return Promise.resolve(transport.control({ id: p.id, op: "answer", text: p.text }))
+        .then(() => ({ ok: true }))
+        .catch((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）→ 归一成上游形状。 */
+    engines() {
+      return Promise.resolve()
+        .then(() => transport.listEngines())
+        .then((r) => {
+          const list = Array.isArray(r) ? r : (r && Array.isArray(r.engines) ? r.engines : null);
+          if (!list || !list.length) return { ok: false, engines: [] };
+          return { ok: true, engines: list.map(normalizeEngineRow) };
+        })
+        .catch(() => ({ ok: false, engines: [] }));
+    },
+
+    /* 附件落盘：上游是 Electron 的 pasteImage（把图写进磁盘并回路径）。
+       这里没有本地壳，**不假装成功** —— 明说这一版还不支持粘贴落盘。 */
+    pasteImage() {
+      return Promise.reject(new Error("这一版（浏览器宿主）还不支持粘贴截图落盘：需要宿主提供 pasteImage 通道"));
+    },
+    /* 任务本地库（SQLite）：magic-agent 没有本地库 —— 空清单 + 写入如实回「跳过」。
+       04-task-list.js 的 qaDb* 会把这些结果当「桥不可用」，于是只走 localStorage。 */
+    tasksList() { return Promise.resolve({ ok: true, tasks: [] }); },
+    tasksCreate(t) { return Promise.resolve({ ok: true, task: t }); },
+    tasksUpdate() { return Promise.resolve({ ok: true }); },
+    tasksDelete() { return Promise.resolve({ ok: true }); },
+    convList() { return Promise.resolve({ ok: true, messages: [] }); },
+    convAppend() { return Promise.resolve({ ok: true }); },
+    settingsGet() { return Promise.resolve({ ok: true, config: {} }); },
+    /* 模型链（配置界面那份「主选 + 兜底」的有序链）：这一版没有配置界面 → 空链。
+       ⚠️ 必须给这个通道：04-task-list.js 的 qaModelChainLoad 在没有它时会去 fetch
+       `/api/settings/model-chain`（那是 magic-test 内置后端的路），本版没有那个端点 →
+       每次都留一条 404 噪音。空链的语义是「用引擎自带默认」，与 04 的注释一致，不编数据。 */
+    settingsModelChain() { return Promise.resolve({ ok: true, chain: [] }); },
+  };
+})();
+
+/* ---------- 工作台侧符号的最小实现 ----------
+   只补「复制文件里确实没有」的那些。真被走到时如实说，不静默。 */
+function notHere(what) {
+  return function () {
+    toast(what + "：这一版（magic-agent 基础对话 UI）还没接上");
+    console.warn("[conv] 未实现：" + what);
+  };
+}
+/* 视图切换：这里只有对话视图，所以是恒等操作（上游发送时会调它跳转到 chat） */
+function showView(v) { state.view = v || "chat"; }
+function createTask() { return { id: "conv-" + Date.now() }; }
+function openPanel() { /* 上游：打开流水线督造面板；这一版没有 */ }
+function syncWebviewViewport() { /* 上游：内嵌浏览器等比缩放；这一版没有 */ }
+function isDockOpen() { return false; }
+function openBrowserDock() { notHere("浏览器侧栏")(); }
+function wsDirOf() { return ""; }
+function genCasesFromDoc() { notHere("生成测试用例")(); }
+function reqFeatPaneHint() { /* 上游：右栏文档阅读器的提示；无右栏 */ }
+function reqShotsPaneHint() { /* 同上 */ }
+function bindAsk() { /* 上游：提问卡选项的事件绑定；askCard 内部已自带 */ }
+function agentCall() { notHere("模拟测试")(); }
+function notify() { /* 上游：系统通知；无壳，忽略 */ }
+
+/* ---------- 挂载 ---------- */
+(function boot() {
+  try {
+    /* 输入框：上游的挂载入口，注入标记到 #ask-home */
+    if (typeof askBoxMountAll === "function") askBoxMountAll();
+    else throw new Error("askBoxMountAll 不存在（19 是否加载？）");
+    /* 菜单 + 发送 + 流：撰写区总装（92-composer.js） */
+    if (typeof qaComposerInit === "function") qaComposerInit();
+    else throw new Error("qaComposerInit 不存在（92 是否加载？）");
+    /* 左栏会话清单（93-rail.js）：数据来自 magic-agent 的 --sessions / --session-log */
+    if (typeof qaRailInit === "function") qaRailInit();
+  } catch (e) {
+    document.body.insertAdjacentHTML("beforeend",
+      '<div style="position:fixed;left:16px;bottom:16px;padding:12px 14px;border:1px solid #F4C7C7;'
+      + 'background:#FFF4F4;color:#B42318;border-radius:10px;font:13px/1.5 system-ui">'
+      + "对话界面挂载失败：" + escHtml((e && e.message) || e) + "</div>");
+    throw e;
+  }
+})();

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

@@ -0,0 +1,134 @@
+/* 工作台侧符号 —— 对话渲染层会引用，但它们属于**工作台**（需求看板 / 文档阅读器 /
+ * 消息库 / 截图相册），magic-agent 这一版只有对话。
+ *
+ *  ── 两类，别混 ──
+ *   ① **纯函数**：与工作台无关、只跟对话状态有关的（wsMatch / qaReqOfId / qaTaskStatusOf /
+ *      qaEngHintSync / qaRefreshRunning）—— 从 magic-test 原样搬来，语义一字不改。
+ *   ② **诚实桩**：这条能力这一版没有 —— 一律**明说**（toast / console.warn），
+ *      不假装成功、不静默吞掉。这些桩就是「还没接上」的清单，也是后续增强点的来源。
+ */
+
+/* ================= ① 纯函数（原样搬自 magic-test） ================= */
+
+/* 02-docs-data.js：qaRunning 是派生量（由 qaRefreshRunning 重算），qaUnsub 是事件订阅句柄 */
+let qaRunning = false, qaUnsub = null;
+/* 引擎清单是否已从 CLI 取回（true = qaEngines 是真实清单；false = 还是内置兜底表）。
+   跨文件共享状态：92-composer.js 的 qaEnginesFetch 写它，04-task-list.js 的 qaPermSupported 读它。
+   两侧都只在**运行时**访问（不在脚本加载期），所以归到这份共享状态里最清楚。 */
+let qaEnginesReal = false;
+/** 07/03 都读它：当前有没有在跑的轮次。**唯一算法**，别各处自己数 qaRuns。 */
+function qaRefreshRunning(){ qaRunning = qaRuns.size > 0; qaSyncBusy(); }
+
+/* 02-docs-data.js：消息图标常量。**纯常量**（没有一条与工作台相关）—— 原样搬来。
+   03-chat-message.js 的提问卡（askCard）读 QA_ICONS.ask；漏了它 → 审批卡整张抛
+   ReferenceError（画面表现：引擎问了、界面什么都没出现）。 */
+const QA_ICONS = {
+  quote: '<svg viewBox="0 0 24 24"><path d="M4 6h16M4 11h10M4 16h13"/></svg>',
+  reply: '<svg viewBox="0 0 24 24"><path d="M21 12a8 8 0 01-8 8H5l-2 2V12a8 8 0 018-8h2a8 8 0 018 8z"/></svg>',
+  tool: '<svg viewBox="0 0 24 24"><path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg>',
+  agent: '<svg viewBox="0 0 24 24"><path d="M12 3v3M8 6h8a3 3 0 0 1 3 3v6a3 3 0 0 1-3 3H8a3 3 0 0 1-3-3V9a3 3 0 0 1 3-3z"/><path d="M9.5 11.5h.01M14.5 11.5h.01M9.5 15h5"/></svg>',
+  ask: '<svg viewBox="0 0 24 24"><path d="M21 11.5a8 8 0 0 1-8 8H7l-4 3v-9a8 8 0 0 1 8-8h2a8 8 0 0 1 8 6z"/><path d="M9.6 9.3a2.5 2.5 0 1 1 3.1 2.4c-.5.2-.8.6-.8 1.1v.5"/><path d="M12 16.2h.01"/></svg>',
+};
+
+/* 12-req-board.js：工作目录归属判定。本版没有「工作目录切换器」，wsDirOf() 恒为 ""
+   → 第一行 `if(!d) return true` 直接放行（= 不按目录过滤）。整段保留，语义与上游一致。 */
+const WS_DEMO_PLACEHOLDER = "__DEFAULT__";
+let qaWsDefaultDir = "";
+function wsMatch(recWs){
+  const d = wsDirOf();
+  if(!d) return true;                                 // 「不记录需求（仅浏览）」= 不按目录过滤
+  let rec = String(recWs || "");
+  if(rec === WS_DEMO_PLACEHOLDER) rec = qaWsDefaultDir || "";
+  if(rec) return rec === d;
+  return !!(qaWsDefaultDir && d === qaWsDefaultDir);
+}
+
+/* 12-req-board.js：会话 id ↔ 需求 id。本版不派发需求，但 id 前缀解析是通用的，原样保留。 */
+const REQ_TASK_PREFIX = "qa-req-";
+function qaReqOfId(id){
+  const s = String(id || "");
+  return s.startsWith(REQ_TASK_PREFIX) ? s.slice(REQ_TASK_PREFIX.length) : "";
+}
+/* 需求**侧**那条 —— 需要需求看板。本版没有看板 → 查不到（如实返回 null，
+   于是 qaTaskStatusOf 走「普通对话」兜底分支，显示会话自己的 status）。 */
+function qaReqItemOf(){ return null; }
+function qaReqBoardLoaded(){ return false; }
+
+/* 12-req-board.js：会话状态口径。因 qaReqItemOf 恒 null，实际走的是下面这段兜底
+   （与上游逐字一致 —— 兜底词表与需求侧同一批状态名）。 */
+function qaTaskStatusOf(t){
+  const raw = String((t && t.status) || "done");
+  const st = raw === "queued" ? "pending" : raw;            // 老值兼容
+  const it = qaReqItemOf(t && t.reqId);
+  if(it && typeof qaReqStatusOf === "function") return qaReqStatusOf(it);
+  const label = st === "running" ? "处理中"
+    : st === "verify" ? "待验证"
+    : st === "pending" ? "排队中"
+    : st === "stopped" ? "已停止"
+    : st === "error" ? "失败"
+    : "已完成";
+  const detail = st === "running" ? "流式输出，命令行退出即完成"
+    : st === "verify" ? "等审查结论"
+    : st === "pending" ? "等前一条结束（同一工作目录串行执行）"
+    : st === "stopped" ? "你自己喊的停"
+    : st === "error" ? "上次调用失败"
+    : "";
+  return { st, phase: "", label, detail, live: st === "pending" || st === "running", manual: false };
+}
+
+/* 12-req-board.js：＋ 菜单底部「派发引擎 / 模型 / 工作目录」那行说明。原样保留。 */
+function qaEngHintSync(){
+  const dir = wsDirOf();
+  const ws = !dir ? ""
+    : (qaWorkspaceSupported() ? ` · 工作目录 ${dir}` : " · 该引擎不支持指定工作目录");
+  ASK_INSTANCES.forEach(p=>{
+    const el = $("#" + p + "-eng-hint"); if(!el) return;
+    const mdl = (typeof qaModelFor === "function") ? qaModelFor(p, qaActiveId) : qaModel;
+    el.textContent = `派发引擎 ${qaEngine}${mdl ? " · " + qaModelName(mdl, qaEngine) : ""}${ws}`;
+  });
+}
+
+/* 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，追问会新起一段上下文。");
+}
+
+/* ================= ② 诚实桩（这条能力这一版没有） ================= */
+
+/* 内置后端基址：magic-test 靠它取引擎清单 / 上传截图。magic-agent 走 transport，
+   不需要它 —— 声明成空串，所有 `if(prdBackendBase)` 分支自然短路到相对路径 / 直接失败。 */
+var prdBackendBase = "";
+
+/* 需求看板（12-req-board.js）—— 本版无看板 */
+function reqHas(){ return false; }
+function reqBoardFetch(){ return Promise.resolve(null); }
+function reqBoardAddFromChat(){ return Promise.resolve(null); }
+function qaReqConvMsg(){ return ""; }
+function qaReqEngineMsg(){ return ""; }
+function qaReqStreamApply(){ return false; }
+function qaReqConvSnapshot(){ return ""; }
+function qaReqConvSync(){ /* 无看板可同步 */ }
+function qaReqConvDropMark(){ /* 无看板可标记 */ }
+function qaTaskHistoryRecover(){ return Promise.resolve(""); }
+
+/* 消息库 / 对话归档（27-conv-log.js）—— 本版无持久层。
+   ⚠️ 这意味着**刷新页面历史就没了**：左栏条目来自 localStorage 的 qaTasks（04-task-list.js），
+   点开时靠 t.snapshot 还原当前会话画面；其余（逐轮消息表）没有。持久化 = 增强点之一。 */
+function qaMsgLogLoad(){ return Promise.resolve([]); }
+function qaConvTurnSync(){ /* 无消息库可写 */ }
+
+/* 截图相册 / 文档阅读器（右栏）—— 本版无右栏 */
+function reqShotUrl(){ return ""; }
+function reqFeatOpenInDock(){ notHere("打开功能点文档")(); }
+function reqShotsOpen(){ notHere("截图相册")(); }
+
+/* 产品文档页的数据源（10-markdown.js 的文档阅读器读它们）—— 本版无文档页，留空即死路径。 */
+let prdData = [];
+let prdDetailIndex = {};
+let prdRowsAll = [];
+const prdStateText = {};