dsh-mobile-plugin 0.5.19 → 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/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/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 };