magic-agent 2.6.0 → 2.6.3

package/client-ui/shared/conversation.js

@@ -178,12 +178,34 @@
         别去改 BOTTLE_CAVITY 的 d。 */
   /* 进选择器 / 参与「首个可用」判定的引擎：探测成功、**已登录**且能列出模型。
      没登录或取不到模型清单的（如 trae、登出后的 codebuddy-ai）不出现
-     （2026-10-25 用户要求：「登录了几个账号就显示几个」）。 */
+     （2026-10-25 用户要求：「登录了几个账号就显示几个」）。
+     ⚠️ 「取不到模型清单」必须分两种（core --engines 的 models_source）：
+       · none   —— 引擎**本身不提供**模型选择（arkclaw 按 claw_id 绑死模型、
+                   codebuddy-gateway 用网关进程的模型）。这不是故障，引擎完全可用，
+                   右列显示「引擎默认」即可 —— 以前按 models_note 一刀切，把它一起藏了。
+       · failed —— 有动态来源但探测失败（CLI 非 0 退出等），继续隐藏。
+     老 core 没有 models_source 时，按 ErrNoModelSource 的固定文案前缀兜底。 */
+  function modelsSourceOf(en) {
+    return en.models_source || en.modelsSource || '';
+  }
+  /* 「没有模型可选」的原因，翻成人话（core 的 models_note 是英文诊断串）。
+     arkclaw / MagicAI 的模型绑在网关的 claw_id 上，codebuddy-gateway 的绑在网关进程上 ——
+     两者都不是"选不了模型就不可用"，只是模型不在这台机器上选。 */
+  function noModelChoiceHint(en) {
+    var note = String(en.models_note || en.modelsNote || '');
+    if (/claw_id/i.test(note)) return '模型由网关的 claw_id 决定';
+    if (/gateway/i.test(note)) return '模型由网关进程决定';
+    return '不指定模型，由引擎自己挑';
+  }
   function pickableEngines(list) {
     return (list || []).filter(function (en) {
       if (!en || !en.ok) return false;
       if (en.logged_in === false || en.loggedIn === false) return false;
-      return (en.models || []).length > 0 || !en.models_note;
+      var src = modelsSourceOf(en);
+      if (src === 'none') return true;
+      if (src === 'failed') return false;
+      if (/^no dynamic model source/.test(en.models_note || en.modelsNote || '')) return true;
+      return (en.models || []).length > 0 || !(en.models_note || en.modelsNote);
     });
   }
   var BOTTLE_VB = { w: 64, h: 104, x: 16, y: 4 };
@@ -2427,6 +2449,21 @@
           left.appendChild(b);
         });
         var models = qaModelsOrdered(state.engines, cur.engine, cur.models || []);
+        if (!models.length) {
+          /* 引擎不提供模型清单（models_source = none：arkclaw 按 claw_id 绑模型、
+             codebuddy-gateway 用网关进程的模型）。必须给一个「引擎默认」落定项 ——
+             否则左列能选中、右列却是空的，用户无从"确定"，notifyPick 也永远不触发。 */
+          var d = el('button', 'pick__citem' + (state.engine === cur.engine && !state.model ? ' is-on' : ''));
+          d.type = 'button';
+          d.appendChild(el('span', 'pick__cl', '引擎默认'));
+          d.appendChild(el('span', 'pick__cd',
+            modelsSourceOf(cur) === 'none' ? noModelChoiceHint(cur) : '不指定模型，由引擎自己挑'));
+          d.onclick = function () {
+            state.engine = cur.engine; state.model = '';
+            syncPickers(); notifyPick(); Sheet.close();
+          };
+          right.appendChild(d);
+        }
         models.forEach(function (mm) {
           var b = el('button', 'pick__citem' + (state.engine === cur.engine && state.model === mm ? ' is-on' : ''));
           b.type = 'button';

package/client-ui-mobile/apps.css

@@ -0,0 +1,16 @@
+/* ══════════ 应用页（「发现 → 应用」子页面）══════════
+   从 index.html 拆出：选择器只服务这一页（别的页面不引用）。
+   一级清单（应用 + 启停徽标）、二级详情（启动 / 停止 / 在内置浏览器打开）。
+   清单行沿用 `.plugin*` 那一套（与「插件」「脚本」两页同形），这里只补本页特有的东西。
+   CSS 变量（--ink / --muted / --faint / --border / --subtle / --primary-action /
+   --running / --tint-run / --stop / --tint-stop / --error-text）仍由 index.html 的 :root 统一提供。
+   ⚠️ 本页**不定义任何颜色令牌** —— 颜色全走 var()，
+      否则 tests/check-ui-spec.mjs 的金标比对会红。 */
+
+/* 地址那一行：等宽字、一行省略（长路径不该把整行撑成两行）。 */
+.app__url{font:12px/1.5 var(--mono);color:var(--ink-soft);white-space:nowrap;overflow:hidden;
+  text-overflow:ellipsis}
+/* 主按钮一排三个时的次级动作：同样吃 .btn，只调宽度，保证小屏上也能并排放。 */
+.app__acts{display:flex;flex-wrap:wrap;gap:8px;margin-top:14px}
+.app__acts .btn{flex:1;min-width:96px;margin-top:0}
+/* 进行中（启动 / 停止）时按钮上的文字由 JS 换，禁用态由 .btn[disabled] 管。 */

package/client-ui-mobile/apps.js

@@ -0,0 +1,406 @@
+/* 应用页（移动端「发现 → 应用」）—— 独立子页面模块。
+ *
+ * 为什么单独一个文件：跟脚本页（scripts.js）、需求页（reqs.js）同一条纪律 ——
+ * 这一页的 DOM、渲染、启停、状态轮询全在一处，不往 index.html 里塞。
+ *
+ * 这一页回答的是「magic-shorts / magic-video 的工作台，现在跑着没有、能不能打开」。
+ * 工作台跑在**这台桌面**上（不是手机上）：服务端负责起进程 / 杀进程组，
+ * 手机只发起，然后在**内置浏览器**里打开（走桌面端的网络，见 apps.go 文件头）。
+ *
+ * ⚠️ 不假装成功：状态一律以服务端探活的结果为准（state.running / state.managed），
+ *    本页不根据「我点过启动」自己推断「在跑」。
+ *
+ * 与宿主（index.html）的边界：只通过 mount(host) 注入的能力交互 ——
+ *   getBase / getToken（切环境后是活的，必须 getter，不能传快照）、
+ *   hEl / elSpan / svgUse / toast / openSheet / closeSheet /
+ *   showRoot（回清单）/ showDetail（进详情）/ backToDiscover / openInBrowser。
+ *
+ * 数据形状见 CLIENT-CONTRACT §2（/desk/apps）：
+ *   GET  /desk/apps → {apps:[{id,name,tagline,description?,homepage?,cli,command,port,
+ *                            installed,sourcePath?,note?,openUrl?,
+ *                            state:{state,running,managed,pid?,port?,url,localUrl?,
+ *                                   logTail?,startedAt?,error?}}], notes:[…]}
+ *   POST /desk/apps/{id}/{start|stop} → SSE
+ *        event: open {id,action}
+ *        event: end  {ok,code,error?,app}
+ */
+(function () {
+  'use strict';
+
+  var H = null;               // 宿主（index.html 注入）
+  var els = {};               // 本页内部元素
+  var ITEMS = [];             // 最近一次清单
+  var DETAIL = null;          // 二级视图：{id}
+  var BUSY = {};              // id → 正在做的动作（start / stop），防重复点
+  var LAST_LOG = {};          // id → 上次失败的输出尾巴（收尾重画后仍看得到）
+  var POLL = null;            // 详情页的轮询定时器
+
+  /* 状态徽标：与脚本页同一套语义（运行中=绿、已停止=石褐）。
+     「运行中但不可托管」（桌面端起的）另给一个主色徽标：能打开、但停不了。 */
+  function stateText(st) {
+    var s = (st && st.state) || 'stopped';
+    if (s === 'running') return st && st.managed ? '运行中' : '运行中 · 外部';
+    if (s === 'starting') return '启动中';
+    return '已停止';
+  }
+  function stateBadge(st) {
+    var s = (st && st.state) || 'stopped';
+    if (s === 'running') return st && st.managed ? 'pbadge--run' : 'pbadge--new';
+    if (s === 'starting') return 'pbadge--new';
+    return 'pbadge--stop';
+  }
+
+  function hEl(tag, cls, text) { return H.hEl(tag, cls, text); }
+  function elSpan(cls, text) { return H.elSpan(cls, text); }
+  function svgUse(id, size) { return H.svgUse(id, size); }
+  function toast(msg) { return H.toast(msg); }
+
+  function api(path) { return H.getBase() + path; }
+  function headers() {
+    return H.getToken() ? { 'X-Magic-Token': H.getToken() } : {};
+  }
+
+  function byId(id) {
+    for (var i = 0; i < ITEMS.length; i++) if (ITEMS[i].id === id) return ITEMS[i];
+    return null;
+  }
+
+  /* ── 一级：应用清单 ── */
+  function renderList() {
+    if (!els.list) return;
+    var frag = document.createDocumentFragment();
+    if (!ITEMS.length) {
+      els.list.replaceChildren(hEl('div', 'history__hint',
+        '桌面端没有返回任何应用。'));
+      return;
+    }
+    frag.appendChild(hEl('div', 'history__group', '工作台'));
+    ITEMS.forEach(function (it) {
+      var st = it.state || {};
+      var row = hEl('button', 'plugin'); row.type = 'button';
+      var ico = hEl('span', 'plugin__ico' + (st.running ? ' is-on' : ''));
+      ico.appendChild(svgUse('#i-grid', 22));
+      var col = hEl('span', 'plugin__col');
+      col.appendChild(hEl('span', 'plugin__t', it.name));
+      col.appendChild(hEl('span', 'plugin__s', it.tagline || ''));
+      row.appendChild(ico); row.appendChild(col);
+      row.appendChild(elSpan('pbadge ' + stateBadge(st),
+        BUSY[it.id] ? (BUSY[it.id] === 'start' ? '启动中…' : '停止中…') : stateText(st)));
+      row.onclick = function () { openDetail(it.id); };
+      frag.appendChild(row);
+    });
+    frag.appendChild(hEl('div', 'pd__note',
+      '工作台在「这台桌面」上跑（不是手机上）；打开时用内置浏览器，走桌面端的网络。'));
+    els.list.replaceChildren(frag);
+  }
+
+  function loadList(quiet) {
+    if (!els.list) return;
+    if (!quiet) els.list.innerHTML = '<div class="history__hint">读取中…</div>';
+    return fetch(api('/desk/apps'), { headers: headers() })
+      .then(function (r) {
+        if (r.status === 404) throw new Error('当前桌面端没有应用能力（需要较新版本）');
+        if (!r.ok) throw new Error('HTTP ' + r.status);
+        return r.json();
+      })
+      .then(function (j) {
+        ITEMS = (j && j.apps) || [];
+        renderList();
+        /* 详情页开着时，顺手刷一次（从启动状态变成运行中要靠它）。 */
+        if (DETAIL) renderDetail(true);
+      })
+      .catch(function (e) {
+        if (quiet && ITEMS.length) return;
+        els.list.innerHTML = '';
+        els.list.appendChild(hEl('div', 'history__hint',
+          '读取应用列表失败：' + ((e && e.message) || e)));
+      });
+  }
+
+  /* ── 二级：详情（启动 / 停止 / 在内置浏览器打开）── */
+  function openDetail(id) {
+    DETAIL = { id: id };
+    H.showDetail();
+    renderDetail(false);
+    loadList(true);
+    startPoll();
+  }
+
+  function backToList() {
+    stopPoll();
+    DETAIL = null;
+    H.showRoot();
+    loadList(true);
+  }
+
+  /* 启动中 / 运行中的时候轮询一次清单：启动是服务端等端口应答，手机这边
+     只需要看它什么时候变过来（以及外部实例是否自己退了）。 */
+  function startPoll() {
+    stopPoll();
+    POLL = setInterval(function () { if (DETAIL) loadList(true); }, 2500);
+  }
+  function stopPoll() {
+    if (POLL) { clearInterval(POLL); POLL = null; }
+  }
+
+  function renderDetail(keepScroll) {
+    if (!els.detailBody || !DETAIL) return;
+    var it = byId(DETAIL.id);
+    var box = els.detailBody;
+    var logBox = box.querySelector('#appLog');
+    var keepLog = keepScroll && logBox ? logBox.scrollTop : 0;
+    box.innerHTML = '';
+    if (!it) {
+      box.appendChild(hEl('div', 'history__hint', '这个应用不在清单里了（可能桌面端换了环境）。'));
+      return;
+    }
+    var st = it.state || {};
+    var wrap = hEl('div', 'pd');
+
+    var head = hEl('div', 'pd__head');
+    head.appendChild(hEl('span', 'pd__name', it.name));
+    head.appendChild(elSpan('pbadge ' + stateBadge(st), stateText(st)));
+    wrap.appendChild(head);
+    wrap.appendChild(hEl('p', 'pd__tag', it.tagline || ''));
+
+    /* 状态说明：服务端说的原话（为什么是这个状态），本页不自己编。 */
+    if (it.note) wrap.appendChild(hEl('div', 'pd__note', it.note));
+    if (st.running && st.localUrl) {
+      wrap.appendChild(hEl('div', 'pd__note', '桌面端地址：' + st.localUrl));
+    }
+    if (st.running && st.managed && st.pid) {
+      wrap.appendChild(hEl('div', 'pd__note', '进程 PID ' + st.pid + '（随工作台起的子进程一起走）'));
+    }
+
+    /* 动作：运行中主角是「在内置浏览器打开」，没跑时主角是「启动」。 */
+    var acts = hEl('div', 'app__acts');
+    var busy = BUSY[it.id];
+    if (st.running) {
+      var openBtn = hEl('button', 'btn btn--filled', '在内置浏览器打开');
+      openBtn.type = 'button';
+      openBtn.onclick = function () { openApp(it); };
+      acts.appendChild(openBtn);
+
+      var stopBtn = hEl('button', 'btn btn--outlined',
+        busy === 'stop' ? '正在停止…' : (st.managed ? '停止' : '停止（到桌面端）'));
+      stopBtn.type = 'button';
+      stopBtn.disabled = !!busy || !st.managed;
+      if (!st.managed) stopBtn.title = '这个工作台不是从手机启动的，请到桌面端停止';
+      stopBtn.onclick = function () { if (st.managed) runAction(it, 'stop'); };
+      acts.appendChild(stopBtn);
+    } else {
+      var startBtn = hEl('button', 'btn btn--filled',
+        busy === 'start' ? '正在启动…' : (st.state === 'starting' ? '启动中…' : '启动'));
+      startBtn.type = 'button';
+      startBtn.disabled = !!busy || st.state === 'starting';
+      startBtn.onclick = function () { runAction(it, 'start'); };
+      acts.appendChild(startBtn);
+    }
+    wrap.appendChild(acts);
+
+    /* 输出尾巴：起不来时原因就在这几行里（stderr 原样），不让人去桌面翻日志。 */
+    var logLines = (LAST_LOG[it.id] && LAST_LOG[it.id].length) ? LAST_LOG[it.id] : (st.logTail || []);
+    if (logLines.length) {
+      var logSec = hEl('div', 'pd__sec');
+      logSec.appendChild(hEl('div', 'pd__h', '最近输出'));
+      var pre = hEl('pre', 'pd__log pd__log--script', logLines.join('\n'));
+      pre.id = 'appLog';
+      pre.hidden = false;
+      pre.scrollTop = keepLog;
+      logSec.appendChild(pre);
+      wrap.appendChild(logSec);
+    }
+
+    /* 介绍 / 怎么起 / 主页。 */
+    wrap.appendChild(pdSection('介绍', hEl('p', 'pd__p', it.description || '')));
+
+    var cmdSec = hEl('div', 'pd__sec');
+    cmdSec.appendChild(hEl('div', 'pd__h', '等价命令（在桌面端执行）'));
+    cmdSec.appendChild(hEl('pre', 'pd__code', it.command || ''));
+    var copyBtn = hEl('button', 'btn btn--outlined', '复制命令');
+    copyBtn.type = 'button';
+    copyBtn.onclick = function () { copyText(it.command || '', '命令已复制'); };
+    cmdSec.appendChild(copyBtn);
+    wrap.appendChild(cmdSec);
+
+    if (!it.installed) {
+      var miss = hEl('div', 'pd__note',
+        'PATH 上没有 ' + it.cli + '。装法：' + (it.install || '见项目主页') +
+        '（「发现 → 插件」那一页可以直接点安装）。');
+      missingStyle(miss);
+      wrap.appendChild(miss);
+    }
+
+    if (it.homepage) {
+      var home = hEl('button', 'setrow');
+      home.appendChild(hEl('span', 'setrow__l', '项目主页'));
+      home.appendChild(hEl('span', 'setrow__v', it.homepage));
+      home.onclick = function () { H.openInBrowser(it.homepage); };
+      var card = hEl('div', 'setcard'); card.appendChild(home);
+      wrap.appendChild(card);
+    }
+
+    box.appendChild(wrap);
+    if (els.detailTitle) els.detailTitle.textContent = it.name;
+  }
+
+  function missingStyle(node) { node.style.color = 'var(--error-text)'; }
+
+  function pdSection(title, node) {
+    var sec = hEl('div', 'pd__sec');
+    sec.appendChild(hEl('div', 'pd__h', title));
+    sec.appendChild(node);
+    return sec;
+  }
+
+  /* 打开工作台：交给宿主的内置浏览器。
+     openUrl 是**相对地址**（/workbench/{id}/）：先到入口探活 + 跳转，再由服务端
+     把根路径请求转给工作台（页面用 '/api/…'，必须在根下跑）。 */
+  function openApp(it) {
+    var u = (it && it.openUrl) || ((it && it.state && it.state.url) || '');
+    if (!u) { toast('这个应用没有给出地址'); return; }
+    if (!H.openInBrowser) { toast('当前界面不支持内置浏览器'); return; }
+    /* landscape：工作台自己声明「按桌面宽屏排版」（magic-video 是 true）。
+       宿主据此在竖屏下先转横屏 —— 让浏览器去量页面宽度是量不出来的（它是响应式的，
+       只溢出十几个像素，恰好切掉顶栏那排 tab）。 */
+    H.openInBrowser(u, { id: it.id, landscape: !!it.landscape });
+  }
+
+  /* ── 启停（SSE）──
+     手解 SSE（跟脚本页、插件页同一套写法）：fetch + ReadableStream，
+     因为要带自定义头 X-Magic-Token，EventSource 带不了。 */
+  function runAction(it, action) {
+    if (BUSY[it.id]) return;
+    BUSY[it.id] = action;
+    delete LAST_LOG[it.id];
+    renderDetail(false);
+    renderList();
+
+    var ctrl = (typeof AbortController !== 'undefined') ? new AbortController() : null;
+    var opts = { method: 'POST', headers: headers() };
+    if (ctrl) opts.signal = ctrl.signal;
+    /* 等端口应答最多 20 秒（服务端侧），这里给足，避免长轮询被当成失败。 */
+    var timer = setTimeout(function () { if (ctrl) ctrl.abort(); }, 45000);
+
+    function finish(errText) {
+      clearTimeout(timer);
+      delete BUSY[it.id];
+      if (errText) {
+        toast((action === 'start' ? '启动失败：' : '停止失败：') + errText);
+      } else {
+        toast(action === 'start' ? '已启动' : '已停止');
+      }
+      loadList(true);
+      if (DETAIL) renderDetail(true);
+    }
+
+    fetch(api('/desk/apps/' + encodeURIComponent(it.id) + '/' + action), opts)
+      .then(function (resp) {
+        if (!resp.ok || !resp.body) {
+          return resp.text().then(function (t) {
+            throw new Error((t || ('HTTP ' + resp.status)).slice(0, 300));
+          });
+        }
+        var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
+        var ended = false;
+        return (function pump() {
+          return reader.read().then(function (chunk) {
+            if (chunk.done) return null;
+            buf += dec.decode(chunk.value, { stream: true });
+            var blocks = buf.split('\n\n');
+            buf = blocks.pop();
+            blocks.forEach(function (b) { if (!ended) ended = handleBlock(it.id, b, finish); });
+            return ended ? null : pump();
+          });
+        })();
+      })
+      .then(function () { if (!ended) finish(''); })
+      .catch(function (e) {
+        if (e && e.name === 'AbortError') {
+          /* 超时多半是工作台在起（20 秒 + 预热）；不报失败 —— 让轮询去拿真实状态。 */
+          finish('');
+          loadList(true);
+          return;
+        }
+        finish((e && e.message) || String(e));
+      });
+  }
+
+  /* 解析一个 SSE 块；收到 end 帧 → 收尾并返回 true（调用方停止继续读）。 */
+  function handleBlock(id, block, finish) {
+    var name = '', data = '';
+    block.split('\n').forEach(function (ln) {
+      if (ln.indexOf('event: ') === 0) name = ln.slice(7).trim();
+      else if (ln.indexOf('data: ') === 0) data += ln.slice(6);
+    });
+    if (!data) return false;
+    var ev; try { ev = JSON.parse(data); } catch (e) { return false; }
+    if (name !== 'end') return false;
+    /* end 帧带完整的最新状态：先落到 ITEMS 里，再收尾重画。 */
+    if (ev && ev.app && ev.app.id) {
+      var replaced = false;
+      for (var i = 0; i < ITEMS.length; i++) {
+        if (ITEMS[i].id === ev.app.id) { ITEMS[i] = ev.app; replaced = true; break; }
+      }
+      if (!replaced) ITEMS.push(ev.app);
+      var tail = (ev.app.state && ev.app.state.logTail) || [];
+      if (tail.length) LAST_LOG[ev.app.id] = tail;
+    }
+    if (ev && ev.ok) { finish(''); return true; }
+    var msg = (ev && ev.error) ? String(ev.error) : '服务端没有说明原因';
+    /* 409（已在启动 / 外部实例）不是故障，原样提示即可。 */
+    finish(msg);
+    return true;
+  }
+
+  function copyText(text, okMsg) {
+    try {
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        navigator.clipboard.writeText(text).then(function () { toast(okMsg); },
+          function () { toast('复制失败'); });
+        return;
+      }
+    } catch (e) {}
+    toast('当前环境不支持复制');
+  }
+
+  /* ── 挂载 ── */
+  function mount(host) {
+    H = host;
+    var root = H.rootEl, detail = H.detailEl;
+    if (!root || !detail) return;
+    root.innerHTML =
+      '<div class="history__top">' +
+        '<button class="topbar__icon" id="btnAppsBack" aria-label="返回"><svg width="20" height="20"><use href="#i-back"/></svg></button>' +
+        '<span class="history__title">应用</span>' +
+      '</div>' +
+      '<div class="history__list" id="appList"></div>';
+    detail.innerHTML =
+      '<div class="history__top">' +
+        '<button class="topbar__icon" id="btnAppDetailBack" aria-label="返回"><svg width="20" height="20"><use href="#i-back"/></svg></button>' +
+        '<span class="history__title" id="appDetailTitle">应用</span>' +
+      '</div>' +
+      '<div class="history__list" id="appDetailBody"></div>';
+    els.list = root.querySelector('#appList');
+    els.detailBody = detail.querySelector('#appDetailBody');
+    els.detailTitle = detail.querySelector('#appDetailTitle');
+    var back = root.querySelector('#btnAppsBack');
+    if (back) back.onclick = function () { H.backToDiscover(); };
+    var dback = detail.querySelector('#btnAppDetailBack');
+    if (dback) dback.onclick = function () { backToList(); };
+  }
+
+  /* 进入「发现 → 应用」：拉一次清单（只读，不启动任何东西）。 */
+  function show() {
+    DETAIL = null;
+    stopPoll();
+    loadList(false);
+  }
+
+  window.MagicApps = {
+    mount: mount,
+    show: show,
+    /* 给测试与调试用：当前清单快照（只读）。 */
+    items: function () { return ITEMS.slice(); }
+  };
+})();