magic-agent 1.0.49 → 1.0.108

package/client-ui/shared/transport-http.js

@@ -14,6 +14,7 @@
  *    GET  /desk/ask/{id}/events?after=<seq>           断线续传：按 seq 增量补拉本轮事件
  *    GET  /desk/session/{id}/messages                 全量历史
  *    GET  /desk/session/{id}/events?after=<seq>       增量续读
+ *    GET  /desk/session/{id}/follow                   持续尾随（SSE，跨进程看别人在跑的轮次）
  *    POST /desk/upload                                原子化上传附件（返回本机路径 + 回读 url）
  *    GET  /desk/uploads/{name}?token=…                回读附件（缩略图；<img> 只能走 ?token=）
  *    GET  /desk/media?path=<abs>&w=<px>               按绝对路径回读媒体（w = 移动端缩略图宽度）
@@ -27,6 +28,13 @@
 (function () {
   'use strict';
 
+  /* 引擎清单缓存（2026-10-21）：`/desk/engines?models=1` 在 core 侧要逐个引擎探测
+     （实测 ~1s；`--no-models` 才 <10ms），而结果只随「本机装了 / 卸了哪个引擎」变化。
+     以前每挂载一次对话组件就重拉一次 —— 移动端「返回列表 → 再点进来」每次白等 1s。
+     缓存 5 分钟，按端点（base + token）区分；`listEngines(true)` 强制重探。 */
+  var ENGINES_TTL = 5 * 60 * 1000;
+  var enginesCache = { key: '', at: 0, list: null, p: null };
+
   function MagicTransportHttp(opts) {
     opts = opts || {};
     var BASE = String(opts.base || '').replace(/\/+$/, '');
@@ -41,12 +49,15 @@
       return h;
     }
 
-    /* 移动端慢网取图统一走 720 宽缩略图（服务端按需缩放；解不了 / 非图片自动回原文件）。
-       返回 '' 或 '<sep>w=720'：由调用方拼在已有 query 之后。 */
+    /* 移动端慢网取图统一走 480 宽缩略图（服务端按需缩放；解不了 / 非图片自动回原文件）。
+       2026-10-21 用户：「再压缩一下 可打开看大图」—— 缩略图只负责「看清是什么」，
+       宽取 480 已够产物卡（200px 宽）在 2~2.4 倍屏上不糊，流量再砍一半；
+       要看细节走大图浮层（移动端 imgview 打开时把 w 去掉，服务端就发原文件）。
+       返回 '' 或 '<sep>w=480'：由调用方拼在已有 query 之后。 */
     function thumbQuery(path, sep) {
       if (CLIENT !== 'mobile') return '';
       if (!/\.(?:png|jpe?g|gif|bmp|webp)$/i.test(String(path))) return '';
-      return sep + 'w=720';
+      return sep + 'w=480';
     }
     function api(path, o) {
       o = o || {};
@@ -58,18 +69,46 @@
       }
       return fetch(BASE + path, o).then(function (r) {
         if (!r.ok) {
-          var err = new Error(r.status + ' ' + r.statusText);
-          err.status = r.status;   // 调用方要区分 404（无法续传）和网络抖动
-          throw err;
+          /* 非 2xx 的正文是服务端的真实原因（writeErr → {"error":"中文原因"}）：
+             400 团队路由非法、501 core 不支持团队模式、503 引擎不可用都在这里。
+             只抛状态码会把原因彻底丢掉（「未能启动 为什么」问不出来就是这个坑），
+             所以读一次正文，取 error 字段挂到 err.detail 并拼进 message。 */
+          return r.text().then(function (txt) {
+            var detail = '';
+            try { var j = JSON.parse(txt); detail = (j && (j.error || j.message)) || ''; } catch (e) {}
+            if (!detail) detail = String(txt || '').trim().slice(0, 300);
+            var err = new Error(r.status + ' ' + r.statusText + (detail ? '：' + detail : ''));
+            err.status = r.status;   // 调用方要区分 404（无法续传）和网络抖动
+            err.detail = detail;
+            throw err;
+          });
         }
         return r;
       });
     }
 
     return {
-      /* 引擎清单：带模型（选择器要用），所以固定 ?models=1。 */
-      listEngines: function () {
-        return api('/desk/engines?models=1').then(function (r) { return r.json(); });
+      /* 引擎清单：带模型（选择器要用），所以固定 ?models=1。
+         `force` = 跳过缓存重新探测（见模块顶部的 enginesCache）。 */
+      listEngines: function (force) {
+        var key = BASE + '|' + TOKEN;
+        if (!force && enginesCache.key === key) {
+          if (enginesCache.list && Date.now() - enginesCache.at < ENGINES_TTL) {
+            return Promise.resolve(enginesCache.list);
+          }
+          /* 同一端点正在探测（宿主连开两次组件）→ 共用同一个请求，别叠加 1s。 */
+          if (enginesCache.p) return enginesCache.p;
+        }
+        var p = api('/desk/engines?models=1').then(function (r) { return r.json(); })
+          .then(function (list) {
+            enginesCache = { key: key, at: Date.now(), list: list, p: null };
+            return list;
+          }, function (e) {
+            if (enginesCache.p === p) enginesCache.p = null;   // 失败不缓存，下次重探
+            throw e;
+          });
+        enginesCache = { key: key, at: 0, list: null, p: p };
+        return p;
       },
 
       /* 上传附件：返回 {path, name, size, mime, url}。path 是 core 所在机器的绝对路径，
@@ -134,6 +173,61 @@
         return api('/desk/path-read', { json: body }).then(function (r) { return r.json(); });
       },
 
+      /* 插件目录（magic-shorts / magic-video 两个工程 CLI 的介绍、安装状态、安装/升级命令）。
+         返回 {plugins:[{id,name,cli,tagline,description,requirements,homepage,
+                        installed,version,bin,sourcePath,sourceExists,
+                        install,upgrade,examples,usePrompt,note}]}。
+         ⚠️ 命令串只用于**展示与复制**；真正执行要调 pluginAction（服务端按固定表执行）。 */
+      listPlugins: function () {
+        return api('/desk/plugins').then(function (r) { return r.json(); });
+      },
+
+      /* 在**桌面端**执行某个插件的安装/升级：SSE 逐行回，形状与 ask 同构。
+         入参：{id, action:'install'|'upgrade', onOpen(cmds), onLine(line), onStep(index,cmd), onEnd(result)}
+         onEnd 的那个 result 就是 SSE 里 end 事件的整份负载（ok/code/error/plugin）。
+         老服务端没有这个接口 → 404，调用方要如实说「需要较新版本」，不要假装成功。 */
+      pluginAction: function (req, h) {
+        var r = req || {};
+        var hs = h || {};
+        var ended = false;
+        var done = function (out) {
+          if (ended) return;
+          ended = true;
+          if (hs.onEnd) { try { hs.onEnd(out); } catch (e) {} }
+        };
+        return api('/desk/plugins/' + encodeURIComponent(r.id) + '/' + encodeURIComponent(r.action || 'install'),
+          { method: 'POST' })
+          .then(function (resp) {
+            if (!resp.body) throw new Error('服务端没有返回流');
+            var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
+            return (function pump() {
+              return reader.read().then(function (chunk) {
+                if (chunk.done) { done({ ok: false, code: null, error: '连接提前结束' }); return; }
+                buf += dec.decode(chunk.value, { stream: true });
+                var blocks = buf.split('\n\n');
+                buf = blocks.pop();
+                blocks.forEach(function (b) {
+                  var name = '', data = '';
+                  b.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;
+                  var ev; try { ev = JSON.parse(data); } catch (e) { return; }
+                  try {
+                    if (name === 'open' && hs.onOpen) hs.onOpen(ev);
+                    else if (name === 'step' && hs.onStep) hs.onStep(ev);
+                    else if (name === 'line' && hs.onLine) hs.onLine(ev);
+                    else if (name === 'end') done(ev);
+                  } catch (e) {}
+                });
+                return pump();
+              });
+            })();
+          })
+          .catch(function (e) { done({ ok: false, code: null, error: (e && e.message) || String(e) }); });
+      },
+
       /* 会话标题覆盖表 {sid: title}（插件侧持久化，重命名用）。 */
       listTitles: function () {
         return api('/desk/titles').then(function (r) { return r.json(); });
@@ -150,10 +244,13 @@
         var aborted = false;
         var ctl = typeof AbortController !== 'undefined' ? new AbortController() : null;
         var ended = false;
-        var finish = function (code) {
+        /* ev = 收尾那一帧的原文。end 帧带 code + stderr（core 的真实失败原因，
+           见 internal/client/service.go 的 send("end", …)），调用方要拿它解释失败，
+           所以原样透传；不给就只有数字 code，用户看不懂也查不到。 */
+        var finish = function (code, ev) {
           if (ended) return;
           ended = true;
-          if (h && h.onEnd) h.onEnd(code);
+          if (h && h.onEnd) h.onEnd(code, ev);
         };
         api('/desk/ask', { json: body, signal: ctl ? ctl.signal : undefined })
           .then(function (resp) {
@@ -176,7 +273,7 @@
                     if (h && h.onOpen) h.onOpen(ev && (ev.id || ev.ask || ev.run));
                     return;
                   }
-                  if (name === 'end') { finish(ev && ev.code); return; }
+                  if (name === 'end') { finish(ev && ev.code, ev); return; }
                   if (h && h.onEvent) h.onEvent(ev);
                 });
                 if (ended) return;
@@ -239,6 +336,61 @@
         }
         return api('/desk/session/' + encodeURIComponent(id) + '/messages?lean=1')
           .then(function (r) { return r.json(); });
+      },
+
+      /* 持续尾随一条会话的进度（SSE，跨进程）。
+         `/desk/asks` 只认**本插件进程里**跑起来的轮次；掌天瓶桌面壳直接 exec core，
+         它起的一轮在这里从来不存在。这个接口读的是磁盘上那条会话日志（谁跑的都一样），
+         服务端按 ~500ms 增量读盘推送，客户端一次连接跟到终态。
+         帧形状与 /desk/ask 同一套（各端已有解析器）：
+           event: open      data: {session, after}
+           data: <事件>      增量事件，一条一帧（与 readSession 的 events 同形）
+           event: snapshot  data: {session, after, lastSeq}   游标超前 → 重拉历史
+           event: end       data: {session, after, state, reason}  reason ∈ terminal / max_duration
+         h.onOpen(open) / h.onEvent(ev) / h.onSnapshot(snap) / h.onEnd(end) / h.onError(err)。
+         返回 {cancel}：换会话 / 组件销毁时调它断流。老服务端没有这个路由 → onError(404)。 */
+      followSession: function (id, after, h) {
+        var ctl = typeof AbortController !== 'undefined' ? new AbortController() : null;
+        var ended = false;
+        var finish = function (info) {
+          if (ended) return;
+          ended = true;
+          if (h && h.onEnd) h.onEnd(info || {});
+        };
+        var q = '?lean=1' + (after == null ? '' : '&after=' + encodeURIComponent(after));
+        api('/desk/session/' + encodeURIComponent(id) + '/follow' + q, { signal: ctl ? ctl.signal : undefined })
+          .then(function (resp) {
+            var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
+            return (function pump() {
+              return reader.read().then(function (chunk) {
+                if (chunk.done) return finish({ reason: 'closed' });
+                buf += dec.decode(chunk.value, { stream: true });
+                var blocks = buf.split('\n\n');
+                buf = blocks.pop();
+                blocks.forEach(function (b) {
+                  var name = '', data = '';
+                  b.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;                       // `: ping` 心跳注释帧
+                  var ev; try { ev = JSON.parse(data); } catch (e) { return; }
+                  if (name === 'open') { if (h && h.onOpen) h.onOpen(ev); return; }
+                  if (name === 'snapshot') { if (h && h.onSnapshot) h.onSnapshot(ev); return; }
+                  if (name === 'end') { finish(ev); return; }
+                  if (h && h.onEvent) h.onEvent(ev);
+                });
+                if (ended) return;
+                return pump();
+              });
+            })();
+          })
+          .catch(function (e) {
+            if (ended) return;
+            if (h && h.onError) h.onError(e);
+            finish({ reason: 'error' });
+          });
+        return { cancel: function () { if (ctl) ctl.abort(); } };
       }
     };
   }