dsh-mobile-plugin 0.5.18 → 0.5.20

package/lib/client.js

@@ -508,7 +508,10 @@ window.__ModuleLoader__.load({
         nav: '移动端',
         heading: '移动端',
         cardPanel: '配置页面',
+        cardCanvas: '画布',
         openPanel: '打开配置页面',
+        openCanvas: '打开画布',
+        canvasHint: '在浏览器里打开无限画布；它的库与手机共用同一份。',
         openHint: '配对、网络配置与插件更新都在这个页面里。',
         panelPending: '正在读取页面地址…',
         panelMissing: '宿主还没给出页面地址，稍后再打开这一页试试。',
@@ -566,7 +569,10 @@ window.__ModuleLoader__.load({
         nav: 'Mobile',
         heading: 'Mobile',
         cardPanel: 'Configuration page',
+        cardCanvas: 'Canvas',
         openPanel: 'Open the configuration page',
+        openCanvas: 'Open the canvas',
+        canvasHint: 'Open the infinite canvas in your browser; it shares one library with your phone.',
         openHint: 'Pairing, network settings and plugin updates all live on this page.',
         panelPending: 'Reading the page address…',
         panelMissing: 'The host has not reported a page address yet — reopen this item in a moment.',
@@ -794,6 +800,23 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * 画布页在**这个页面自己**的同源地址上（与面板同一台宿主、同一个前缀）。
+     *
+     * 桌面用户在 DSH 里点「打开画布」，就是跳到浏览器打开这一页；页面由插件托管，库与手机共用。
+     */
+    function sameOriginCanvasUrl() {
+      try {
+        const base = typeof document !== 'undefined' && document.baseURI
+          ? document.baseURI
+          : (typeof location !== 'undefined' ? location.href : '');
+        if (!base) return '';
+        return new URL('api/relay/canvas', base).href;
+      } catch {
+        return '';
+      }
+    }
+
     /**
      * 一次「打开配置页面」的完整拨号：取地址、必要时开两小时窗口、把地址交出去。
      *
@@ -1557,6 +1580,10 @@ window.__ModuleLoader__.load({
       }
 
       const hint = url === null ? t('panelPending') : url === '' ? t('panelMissing') : t('openHint');
+      // 画布页与面板同源同宿主，地址从面板地址换尾巴；拿不到面板地址就按页面自身推。
+      const canvasUrl = typeof url === 'string' && url
+        ? url.replace(/\/panel(?:\/(?:setup|settings))?$/, '/canvas')
+        : sameOriginCanvasUrl();
       return h('div', { className: 'dshm_root' },
         h('h2', { className: 'dshm_heading' }, t('heading')),
         h('div', { className: 'dshm_card' },
@@ -1574,7 +1601,19 @@ window.__ModuleLoader__.load({
           failure
             ? h('p', { className: 'dshm_error' },
               `${failure.kind === 'load' ? t('loadFailed') : t('openFailed')}：${failure.message}`)
-            : null));
+            : null),
+        // 画布单独一张薄卡：点「打开画布」跳到浏览器打开插件托管的画布页（库与手机共用），
+        // 不嵌在桌面端里。跟面板同源同宿主，地址从面板地址换尾巴拿。
+        h('div', { className: 'dshm_card' },
+          h('h3', { className: 'dshm_cardTitle' }, t('cardCanvas')),
+          h('p', { className: 'dshm_note' }, t('canvasHint')),
+          h('div', { className: 'dshm_actions' },
+            h('a', {
+              className: 'dshm_btn dshm_btnPrimary',
+              href: canvasUrl || undefined,
+              target: '_blank',
+              rel: 'noreferrer',
+            }, t('openCanvas')))));
     }
 
     return {

package/lib/host-compat.cjs

@@ -8,6 +8,9 @@
  * 所以启动时先问运行时那棵树要同代的那一份，拿到就把行的 `name` 换成它的入口绝对路径，
  * 绕开按裸名解析；拿不到就保持原样，让官方检查去禁用并打印原因。
  *
+ * 还有另一种形状：入口本身没了（0.2.2 把 `list_agents` 并进主包，子路径随之下线）。
+ * 那一条换成哪一份都没用，只能整行从预设副本里拿掉 —— 见 `dropRows`。
+ *
  * 这里只放纯函数：`host.js` 一 import 就 `boot()` 整个宿主，测试碰不得。
  */
 
@@ -76,21 +79,64 @@ function rewriteToolNames(source, targets) {
  * @param {string} presetDir 包内 `config/agent-presets`
  * @param {string} outDir 宿主可写的目标目录
  * @param {Record<string, string>} targets 行 id → 入口绝对路径
+ * @param {{ dropIds?: string[] }} [options] 这一代运行时里不再有独立入口的行
  * @returns {string} 真正该交给 `agent-presets` roots 的目录
  */
-function syncPresetDir(presetDir, outDir, targets) {
+function syncPresetDir(presetDir, outDir, targets, options = {}) {
   fs.rmSync(outDir, { recursive: true, force: true })
   fs.cpSync(presetDir, outDir, { recursive: true })
-  if (Object.keys(targets).length === 0) return outDir
+  const dropIds = options.dropIds ?? []
+  if (Object.keys(targets).length === 0 && dropIds.length === 0) return outDir
   for (const entry of fs.readdirSync(outDir, { recursive: true, withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith('.yml')) continue
     const file = path.join(entry.parentPath ?? entry.path, entry.name)
-    const { text, changed } = rewriteToolNames(fs.readFileSync(file, 'utf8'), targets)
-    if (changed.length > 0) fs.writeFileSync(file, text)
+    const original = fs.readFileSync(file, 'utf8')
+    const trimmed = dropRows(original, dropIds)
+    const { text, changed } = rewriteToolNames(trimmed, targets)
+    if (changed.length > 0 || trimmed !== original) fs.writeFileSync(file, text)
   }
   return outDir
 }
 
+/**
+ * 去掉预设里指定的整行（含它下面缩进更深的配置）。
+ *
+ * 给「这一代运行时里已经没有这个独立入口」的行用：留着它，Loader 会按裸名去 import
+ * 一个不存在的子路径，那一行起不来；能力本身可能已经并进主包，所以不是缺工具，
+ * 只是多了一条注定失败的行。
+ *
+ * @param {string} source 预设文件内容
+ * @param {string[]} ids 要整行删掉的入口 id
+ * @returns {string} 删完的文本（没命中就原样返回）
+ */
+function dropRows(source, ids) {
+  if (ids.length === 0) return source
+  const targets = new Set(ids)
+  const lines = source.split('\n')
+  const indentOf = (line) => line.length - line.trimStart().length
+  const kept = []
+  let dropping = false
+  let dropIndent = 0
+  for (const line of lines) {
+    const id = ROW_ID.exec(line)
+    if (dropping) {
+      // 同级的下一行或更浅的一行就是这条的边界；更深的仍是它的配置。
+      if (id || (line.trim() !== '' && indentOf(line) <= dropIndent)) dropping = false
+    }
+    if (id && targets.has(id[2])) {
+      dropIndent = indentOf(line)
+      // 紧挨着这一行上方的注释块是在说它，跟着一起删；留下会说反话的说明。
+      while (kept.length > 0 && kept[kept.length - 1].trim().startsWith('#') && indentOf(kept[kept.length - 1]) >= dropIndent) {
+        kept.pop()
+      }
+      dropping = true
+      continue
+    }
+    if (!dropping) kept.push(line)
+  }
+  return kept.join('\n')
+}
+
 /**
  * 把 patch 层里命中目标的 `name` 换成入口绝对路径。
  *
@@ -115,6 +161,7 @@ module.exports = {
   TOOL_ROWS,
   DIRECTORY_PICKER_ROW,
   rewriteToolNames,
+  dropRows,
   syncPresetDir,
   pinInsertedRows,
 }

package/lib/mobile/attachment-store.js

@@ -25,6 +25,10 @@ const path = require('node:path');
 
 const { dshHome } = require('../shared/paths.js');
 const { chunksHeaders, pipeEncrypted } = require('../shared/e2ee-chunks.js');
+const { imageSizeOf, sniffMediaType } = require('./local-images.js');
+
+/** 量宽高只需要文件头；JPEG 的 SOF 段可能在几百字节之后，64KB 覆盖绝大多数实拍图。 */
+const HEAD_BYTES = 64 * 1024;
 
 /** 一个会话最多记多少个附件 id（会话里几千张图也不该无限涨）。 */
 const MAX_IDS_PER_SESSION = 4096;
@@ -36,29 +40,52 @@ const TTL_MS = 30 * 60 * 1000;
 /** sessionId -> { at, entries: Map<attachmentId, { mediaType, at }> } */
 const SESSIONS = new Map();
 
-/** 内容哈希是 64 位小写十六进制；别的形状一律不认（顺带挡住路径穿越）。 */
-const OBJECT_ID = /^[0-9a-f]{64}$/;
+/**
+ * 宿主附件编号的形状：`sha256:<64 位小写十六进制>`（见宿主 `attachment-local` 的 `ID_PATTERN`）。
+ *
+ * **前缀不能省**：宿主发的编号带 `sha256:`，磁盘上的文件名却是去掉前缀的那段哈希。以前这里
+ * 只认裸哈希，于是每个真实编号都被当成「不是我们发过的」，直读这条路一次都没生效过。
+ */
+const OBJECT_ID = /^sha256:([0-9a-f]{64})$/;
 
 function nowMs() {
   return Date.now();
 }
 
+/** 从附件编号里取出裸哈希（磁盘文件名那段）；形状不对回 null。 */
+function hexOf(attachmentId) {
+  if (typeof attachmentId !== 'string') return null;
+  const match = OBJECT_ID.exec(attachmentId);
+  return match ? match[1] : null;
+}
+
 /**
  * 附件 id → 宿主附件库里的绝对路径。
  *
- * 形状不对（不是 64 位小写十六进制）直接回 null：这条路径要拼进 `createReadStream`，
- * 校验放在这里、而不是靠调用方记得先校验。
+ * 宿主 `normalizedImagePath` 的落盘形状是 `objects/<前两位>/<完整 64 位哈希>` —— 子目录取前两位、
+ * **文件名仍是完整哈希**（不是去掉前两位的那段）。曾经拼成 `objects/<前两位>/<其余>`，于是每一份
+ * 真实附件都找不到、直读与现量元数据全部落空（取图恒 404）。
+ *
+ * 形状不对（不是 `sha256:<64 位小写十六进制>`）直接回 null：这条路径要拼进
+ * `createReadStream`，校验放在这里、而不是靠调用方记得先校验。
  */
 function objectPathOf(attachmentId) {
-  if (typeof attachmentId !== 'string' || !OBJECT_ID.test(attachmentId)) return null;
+  const hex = hexOf(attachmentId);
+  if (!hex) return null;
   const root = path.join(dshHome(), 'attachments', 'v1', 'objects');
-  return path.join(root, attachmentId.slice(0, 2), attachmentId.slice(2));
+  return path.join(root, hex.slice(0, 2), hex);
 }
 
-/** 记账：这个附件我们刚在 `sessionId` 的消息里下发过（手机接下来就可能来取字节）。 */
-function remember(sessionId, attachmentId, mediaType) {
+/**
+ * 记账：这个附件我们刚在 `sessionId` 的消息里下发过（手机接下来就可能来取字节）。
+ *
+ * 顺手把**完整引用**（媒体类型 / 字节数 / 宽高 / 名字）也记下来。回退去问宿主时，宿主新版
+ * 的取附件接口要的是整份 `ImageAttachmentRef`，只有编号它不收。取字节本身宿主只用到编号，
+ * 但请求形状这五个字段都必填。
+ */
+function remember(sessionId, attachmentId, ref) {
   if (typeof sessionId !== 'string' || !sessionId) return;
-  if (typeof attachmentId !== 'string' || !OBJECT_ID.test(attachmentId)) return;
+  if (!hexOf(attachmentId)) return;
   const at = nowMs();
   let slot = SESSIONS.get(sessionId);
   if (!slot) {
@@ -72,11 +99,16 @@ function remember(sessionId, attachmentId, mediaType) {
     }
   }
   slot.at = at;
-  slot.entries.delete(attachmentId);
-  slot.entries.set(attachmentId, {
+  const entry = {
     at,
-    mediaType: typeof mediaType === 'string' && mediaType ? mediaType : 'application/octet-stream',
-  });
+    mediaType: ref && typeof ref.mediaType === 'string' && ref.mediaType ? ref.mediaType : 'application/octet-stream',
+  };
+  if (ref && Number.isFinite(ref.bytes)) entry.bytes = ref.bytes;
+  if (ref && Number.isFinite(ref.width)) entry.width = ref.width;
+  if (ref && Number.isFinite(ref.height)) entry.height = ref.height;
+  if (ref && typeof ref.name === 'string' && ref.name) entry.name = ref.name;
+  slot.entries.delete(attachmentId);
+  slot.entries.set(attachmentId, entry);
   while (slot.entries.size > MAX_IDS_PER_SESSION) {
     const oldest = slot.entries.keys().next().value;
     if (oldest === undefined) break;
@@ -84,7 +116,9 @@ function remember(sessionId, attachmentId, mediaType) {
   }
 }
 
-/** 这个 id 是不是我们为这条会话下发过的；是就带上当时的媒体类型。 */
+/**
+ * 这个 id 是不是我们为这条会话下发过的；是就带上当时的完整引用（少 `attachmentId` 与时间戳）。
+ */
 function lookup(sessionId, attachmentId, now = nowMs()) {
   if (typeof sessionId !== 'string' || !sessionId) return null;
   if (typeof attachmentId !== 'string' || !attachmentId) return null;
@@ -100,7 +134,8 @@ function lookup(sessionId, attachmentId, now = nowMs()) {
     slot.entries.delete(attachmentId);
     return null;
   }
-  return { mediaType: hit.mediaType };
+  const { at: _at, ...ref } = hit;
+  return ref;
 }
 
 /** 打开一条只读流（调用方自己负责在连接关掉时 destroy）。 */
@@ -139,6 +174,66 @@ async function streamIfRemembered(req, res, sessionId, attachmentId) {
   return true;
 }
 
+/**
+ * 从盘上这份附件对象量出它的真实元数据（类型 / 字节数 / 宽高）。
+ *
+ * 宿主取附件时会读同一份对象文件、用 sharp 探一遍，再跟我们递过去的引用**逐字段比对**：
+ * 类型、字节数、宽高任一对不上就回 `Stored attachment metadata does not match its reference.`
+ * （400）。所以引用不能瞎填占位值，必须和盘上那份字节对上。
+ *
+ * 附件存的是**归一化后**的字节（携带 EXIF 的图会被重编码、朝向烘进像素），因此文件头读出来的
+ * 就是宿主 `probeImage` 会量到的同一组数；`imageSizeOf` 本就按 EXIF 5–8 对调，口径一致。
+ * 读不出（不是位图 / 文件不在）回 null，由调用方决定怎么回。
+ */
+function probeObject(attachmentId) {
+  const target = objectPathOf(attachmentId);
+  if (!target) return null;
+  let stat;
+  try {
+    stat = fs.statSync(target);
+  } catch {
+    return null;
+  }
+  if (!stat.isFile() || stat.size <= 0) return null;
+  let fd = null;
+  let head;
+  try {
+    fd = fs.openSync(target, 'r');
+    const length = Math.min(stat.size, HEAD_BYTES);
+    head = Buffer.alloc(length);
+    fs.readSync(fd, head, 0, length, 0);
+  } catch {
+    return null;
+  } finally {
+    if (fd !== null) {
+      try { fs.closeSync(fd); } catch { /* 关不上就算了，元数据已经读到 */ }
+    }
+  }
+  const mediaType = sniffMediaType(head);
+  const size = imageSizeOf(head);
+  if (!mediaType || !size || !(size.width > 0) || !(size.height > 0)) return null;
+  return { mediaType, bytes: stat.size, width: size.width, height: size.height };
+}
+
+/**
+ * 给宿主取附件接口拼一份完整 `ImageAttachmentRef`。
+ *
+ * 记过账的用记下的整份引用；没记到的（过期 / 超上限 / 插件重启后没重新登记 / 排队条里透传的图）
+ * 就从盘上那份对象现量一遍 —— 宿主校验要的就是盘上这份字节的真实元数据，占位值一定对不上。
+ * 对象文件不在或量不出时回 null（调用方回 404），不再拿假引用去碰宿主的那条校验。
+ */
+function refFor(sessionId, attachmentId) {
+  const known = lookup(sessionId, attachmentId);
+  if (known && Number.isFinite(known.bytes) && Number.isFinite(known.width) && Number.isFinite(known.height)) {
+    return { attachmentId, ...known };
+  }
+  const probed = probeObject(attachmentId);
+  if (probed) {
+    return { attachmentId, ...probed, ...(known && typeof known.name === 'string' ? { name: known.name } : {}) };
+  }
+  return known ? { attachmentId, ...known } : null;
+}
+
 /** 测试用：清空记账。 */
 function reset() {
   SESSIONS.clear();
@@ -151,6 +246,7 @@ module.exports = {
   objectPathOf,
   remember,
   lookup,
+  refFor,
   openObject,
   streamIfRemembered,
   reset,

package/lib/mobile/attachments.js

@@ -58,12 +58,16 @@ async function resolveEventAttachments(ctx, sessionId, event, opts = {}) {
       if (referencesOnly) {
         // 顺便记一笔：手机接下来就可能拿着这个 id 来取字节。记下来之后那条路可以直接从
         // 宿主附件库流给它，不必再等宿主把整张图读成 base64（见 attachment-store.js）。
-        attachmentStore.remember(sessionId, attachmentId, block.attachment.mediaType || block.mediaType);
+        // 记的是**整份引用**：回退问宿主时要的正是这个形状，光有 id 不够。
+        attachmentStore.remember(sessionId, attachmentId, {
+          ...block.attachment,
+          mediaType: block.attachment.mediaType || block.mediaType,
+        });
         return block;
       }
       let result;
       try {
-        result = unwrap(await callSessions(ctx, 'attachment', { sessionId, attachmentId }));
+        result = unwrap(await callSessions(ctx, 'attachment', { sessionId, attachment: block.attachment }));
       } catch {
         return dataUnavailableBlock(block);
       }

package/lib/mobile/cli/config-prefs.js

@@ -3,27 +3,10 @@
 /**
  * 「这个 CLI 该按哪一套配置跑」—— 一台电脑每个 CLI 记一份。
  *
- * 为什么要有它（用户 2026-11-04：「每次对话都要先去改权限再去发对话，习惯根本调不过来」）：
- * ACP 的配置是**会话级**的 —— `session/new` 之后才有 `configOptions`，`set_config_option` 只对
- * 那一条会话生效。于是每开一条新对话都回到 CLI 自己的默认档：权限松到「完全放开」、或者紧到
- * 「每动一下都弹审批」，两种都得人再调一次。而调不了的时候最难受：AI 正在跑、审批卡挂着，
- * 这一轮没结束就改不动配置 —— 用户说的「得等这一轮结束才能去调权限」正是这个。
- *
- * 所以这里做的是「**记住，然后开局就套上**」：用户在配置页里定的那一套（权限档 / 模型 /
- * 思考档位 / 其它会话级下拉）存在这台电脑上，按 `agentId` 记；新建会话握手完、第一次发消息之前
- * 逐项套过去。ACP 没有「一次设置管所有会话」的开关，但对用户来说效果就是全局的。
- *
- * 三条口径：
- *
- *   1. **只记用户显式选过的项**（`values`）。没选过的不记，新会话就让 CLI 用它自己的默认 ——
- *      替用户猜一个档位，等于悄悄改了它的行为。
- *   2. **选项表也记一份**（`options`）。配置页要在**没开会话**的时候就能画出「权限档有哪几个」，
- *      而那是 CLI 握手之后才给的东西；不缓存就只能等开一条对话才看得见。缓存只用于显示，
- *      真正写的时候仍然按新会话自己给的那张表校验（CLI 升级换了档位名这类情况就不会写错）。
- *   3. **写不进去不算错**。新会话里那一项不存在（换了名字 / 这一版没这个选项）就跳过它，
- *      停在 CLI 自己的默认上，别让一条过期的偏好把整条会话建不起来。
- *
- * 文件：`$DSH_HOME/storages/mobile-plugin/cli-config.json`。
+ * ACP 的配置是**会话级**的：`session/new` 之后才有 `configOptions`，`set_config_option` 只对那一条
+ * 会话生效，每开一条新对话都回到 CLI 默认档。所以这里把用户定的那套按 `agentId` 存下来，新会话
+ * 握手完、第一次发消息之前逐项套过去。只记用户显式选过的项、没选过的不猜；选项表缓存一份供没开
+ * 会话时画，但写入仍按新会话校验；写不进去不算错。文件：`$DSH_HOME/storages/mobile-plugin/cli-config.json`。
  */
 
 const fs = require('node:fs');

package/lib/mobile/cli/mobile.js

@@ -488,6 +488,24 @@ function createCliMobile(deps) {
   const states = new WeakMap()
   /** rpcId → { session, requestId }：`/approval/respond` 靠它找回 ACP 的挂起项。 */
   const approvals = new Map()
+  /**
+   * 投递去重账：`${sessionId}:${clientMessageId}` → 收下的时刻。
+   *
+   * CLI 这条发送没有宿主那本日志，`/session/delivery` 早先恒回 `delivered:false` —— 于是 App
+   * 在一发超时后会认为「没送到」再发一次；若这一轮刚好结束，就会真的把同一句喂给模型两遍。
+   * 这里记一笔：`/session/send` 见到同一个投递 id 直接按成功收（幂等），`/session/delivery`
+   * 照实回「早就收下了」。只留最近若干条，旧的自然淘汰。
+   */
+  const deliveries = new Map()
+  const DELIVERIES_MAX = 300
+  function rememberDelivery(key) {
+    deliveries.set(key, Date.now())
+    while (deliveries.size > DELIVERIES_MAX) {
+      const oldest = deliveries.keys().next().value
+      if (oldest === undefined) break
+      deliveries.delete(oldest)
+    }
+  }
 
   function stateOf(session) {
     let state = states.get(session)
@@ -556,8 +574,10 @@ function createCliMobile(deps) {
       cwd: session.cwd,
       // 侧栏按 workspaceId 分组：给不准就会把 CLI 会话扔进「未分组」。
       workspaceId: session.workspaceId,
-      // 对话页「⋯ → 终端」靠这两格：哪个 CLI、在哪个目录。
+      // 对话页「⋯ → 终端」靠这几格：哪个 CLI、展示名、在哪个目录。
       cliAgent: session.agentId,
+      // 展示名（`Codex CLI` 之类）：终端页 / 模型管理页标题用它，别把 id 直接摆给用户看。
+      ...(session.label ? { cliAgentLabel: session.label } : {}),
       updatedAt: session.updatedAt || 0,
       // 置顶与宿主同一个字段：App 的行尾图钉读它（排序见 mergeList）。
       ...(state.pinned ? { pinned: true } : {}),
@@ -1005,9 +1025,13 @@ function createCliMobile(deps) {
       case '/session/goal':
         sendJsonQuiet(res, {})
         return
-      case '/session/delivery':
-        sendJsonQuiet(res, { delivered: false })
+      case '/session/delivery': {
+        // App 的离线发件箱超时后回查这一发到底收下没有（见 useOutboxFlush）：照实回答，
+        // 免得它再发一遍。没有 clientMessageId 的老客户端只能回「不知道」。
+        const cid = textOf(queryOf(req).get('clientMessageId'))
+        sendJsonQuiet(res, { delivered: Boolean(cid && deliveries.has(`${session.id}:${cid}`)) })
         return
+      }
       case '/session/rename': {
         const title = textOf(body && body.title).trim()
         if (title) setTitle(session, title)
@@ -1025,6 +1049,13 @@ function createCliMobile(deps) {
       case '/session/send': {
         const content = Array.isArray(body && body.content) ? body.content : []
         const message = textOf(body && body.text) || textOfContent(content)
+        // 同一个投递 id 再来一次就是重发：早就收下了，直接按成功回（幂等），别再喂模型一遍。
+        const clientMessageId = textOf(body && body.clientMessageId)
+        const deliveryKey = clientMessageId ? `${session.id}:${clientMessageId}` : ''
+        if (deliveryKey && deliveries.has(deliveryKey)) {
+          sendJson(res, 200, { ok: true, accepted: true })
+          return
+        }
         // 这一发带的图：先认下字节（手机发上来时已经落在收件箱里），块表里只记元数据。
         const sent = await saveImages(content)
         // 图的毛病先说清楚（上传过期 / 读不出来），比「这一发没有正文」有用得多。
@@ -1054,6 +1085,7 @@ function createCliMobile(deps) {
         }
         const result = runPrompt(session, message, sent.images)
         if (!result.ok) return sendJson(res, 409, { ok: false, error: { code: 'cli-busy', message: result.error || '这一轮还没结束' } })
+        if (deliveryKey) rememberDelivery(deliveryKey)
         sendJson(res, 200, { ok: true, accepted: true })
         return
       }
@@ -1063,7 +1095,7 @@ function createCliMobile(deps) {
       case '/subagents':
         sendJsonQuiet(res, { entries: [], parentAvailable: true })
         return
-      case '/extension-cards':
+      case '/extension/cards':
         sendJsonQuiet(res, { cards: [] })
         return
       default:

package/lib/mobile/host-bridge/endpoints.js

@@ -57,7 +57,13 @@ const ENDPOINTS = {
   'sessions.create': inv('session', 'create'),
   'sessions.search': inv('session', 'search'),
   'sessions.selectModel': inv('session', 'selectModel'),
-  'sessions.attachment': inv('session', 'attachment'),
+  // 宿主 `SessionAttachmentRequest` 是 `{ sessionId, attachment: ImageAttachmentRef }`，
+  // `attachment` 必填且内含 attachmentId / mediaType / bytes / width / height。只传
+  // `{ sessionId, attachmentId }` 会在 strict codec 的 parse 那一步被挡回
+  // `wire field "request" failed boundary validation`（400），App 把 400 catch 掉后图片就没了。
+  'sessions.attachment': inv('session', 'attachment', (p) => ({
+    request: { sessionId: p && p.sessionId, attachment: p && p.attachment },
+  })),
   'sessions.updateQueue': inv('session', 'updateQueue'),
   // 宿主的 fork 请求体只有 sessionId / atSeq，increaseTitle 在 0.2.0 已删除。
   'sessions.fork': inv('session', 'fork', (p) => ({ request: pick(p, ['sessionId', 'atSeq']) })),

package/lib/mobile/local-images.js

@@ -467,4 +467,4 @@ function inRanges(index, ranges) {
   return false;
 }
 
-module.exports = { inlineTextImages, createTextImageBudget, localImagePathOf, hasRelativeImage, localImageOf, registerLocalImage, imageSizeOf, clearLocalImages };
+module.exports = { inlineTextImages, createTextImageBudget, localImagePathOf, hasRelativeImage, localImageOf, registerLocalImage, imageSizeOf, sniffMediaType, clearLocalImages };