dsh-pet-live2d 3.1.0 → 3.1.2

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # 更新日志
 
+## 3.1.2（2026-09-30）
+
+### 修：官方桌面端（`dsh-app://` 外壳）里"贴图 404 / 加载失败"（issue #1 的真身）
+
+现象（用户在 DeepSeek Harness 官方桌面端里实测）：
+
+```
+[Loader.load] Failed to load dsh-app://api/live2d-pet/asset/ds-whale-girl/textures/texture_01.png
+Error: [WorkerManager.loadImageBitmap] Failed to fetch … 404 Not Found
+```
+
+注意地址里 **`api` 占了 host 的位置** ✗。根因有两条叠在一起：
+
+1. 官方桌面端的页面 origin 是 **`dsh-app://app`**（自定义协议，不是 http）；
+2. Live2D 引擎（Pixi）是在 **blob Worker** 里 `fetch` 贴图的，而 **blob Worker 里解析根相对
+   地址 `/api/...` 会把 host 丢掉** ⇒ 请求变成 `dsh-app://api/...` ⇒ 服务端收到的是
+   `/live2d-pet/asset/...`（少了 `/api`）⇒ 404 ⇒ 贴图全挂、模型加载失败。
+
+修法：凡是交给引擎的地址（模型 `modelUrl`、Cubism Core、vendor bundle）都先拼成
+**保住 host 的绝对地址** —— `<协议>//<host>/api/...`。http(s) 外壳下与相对地址等价
+（驱动全绿），`dsh-app://app` 下这正是页面自己那些相对请求能通的形式。
+
+（上一版 3.1.1 修的 `localStorage` 兜底是另一个真实问题：自定义协议 / opaque origin 下
+**光访问 `localStorage` 就会抛 `SecurityError`**，抛在组件第一帧 ⇒ 宠物与设置页一起白掉。
+两处都要有，才算真正"适配得了各种桌面外壳"。）
+
+## 3.1.1（2026-09-30）
+
+### 修：在某些桌面外壳里"宠物整个不出现"（`localStorage` 一访问就抛）
+
+有人反馈在 DeepSeek Harness 的**官方桌面端**里用不了（issue #1）。查下来最要命的一处是：
+客户端里有 20 多处**直接读写 `window.localStorage`**，而在**自定义协议 / opaque origin**
+的外壳里，**光是访问 `localStorage` 就会抛 `SecurityError`**（有些壳还会因为隐私设置直接
+禁用 storage）。它抛在组件的第一帧里 ⇒ **宠物和设置页一起白掉**，现象看起来就像"这个插件
+不支持我的桌面端"。
+
+现在所有读写都走一层带兜底的封装：
+
+- 先试着取一次原生引用（**连这一步都在 `try` 里** —— `typeof window.localStorage` 本身也会抛）；
+- 拿不到、或读写中途抛（配额/隐私模式），就退回**内存实现**：本次会话内位置 / 大小 / 装扮
+  照常工作，只是关掉窗口不留存。
+
+顺带确认了一条：前端**只走相对路径**（`/api/live2d-pet/*`），插件加载走官方机制
+（`dsh.bundle` / `dsh.client` / `slots`）—— 所以换成 `http://127.0.0.1:<端口>` 之外的外壳
+地址也不该受影响。
+
+### 改：macOS（arm64）平台子包进入主包声明
+
+`dsh-pet-live2d-desktop-darwin-arm64` 已在上一版发上 npm，这一版把主包的
+`optionalDependencies` 补上它 —— mac 用户装插件时会自动带上桌面端（在这之前只能从
+Release 下 zip）。
+
 ## 3.1.0（2026-09-29）
 
 这一轮的主线是**桌面端**：托盘的"没有她"查到底了 —— 根因是本项目自己给产物贴错了

package/README.md

@@ -39,6 +39,14 @@ git clone https://github.com/A8Chann/dsh-pet-live2d
 dsh plugin --profile web add "link:./dsh-pet-live2d/dsh-live2d-pet"
 ```
 
+> **装到哪个 profile？** 取决于你在哪里用它：
+>
+> - 浏览器里跑的 `dsh web` ⇒ **`--profile web`**（上面几条都是这个）；
+> - **DeepSeek Harness 官方桌面客户端** ⇒ 它用的是 **`--profile desktop`**，例如
+>   `dsh plugin --profile desktop add dsh-pet-live2d`。
+>
+> 装完**重启一次**（插件在启动时加载，客户端 bundle 也不做热重载）。
+
 ### Cubism Core：不用手动装
 
 `live2dcubismcore.min.js` 是 Live2D 株式会社的**专有运行时**，不能随插件分发 —— 但**你也不

package/lib/client.js

@@ -31,6 +31,57 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
 
   const API = "/api/live2d-pet";
   const STORAGE_KEY = "dsh-live2d-pet.state.v1";
+
+  // ---- 存储：`localStorage` 要裹起来用 ----
+  //
+  // 为什么不能直接 `window.localStorage.getItem(...)`：**有些桌面外壳里访问它就抛异常**
+  // （自定义协议 / opaque origin 下是 `SecurityError: The operation is insecure`，
+  // 有的壳还会因为隐私设置直接禁用 storage）。一抛就是**在组件第一帧里**，整个宠物
+  // 连带设置页一起白掉 —— 而这种外壳（官方 desktop / 各家 Tauri、Electron 打包版）
+  // 恰恰是本插件最常见的运行环境之一。
+  //
+  // 拿不到就退回内存实现：这一次会话内照样能存（位置、大小、装扮），只是关掉窗口不保留。
+  // 注意**不能**用 `typeof window.localStorage` 判断 —— 那个 getter 本身就会抛，
+  // 所以连"取一次引用"都要裹在 try 里。
+  const nativeStorage = (() => {
+    try {
+      return window.localStorage;
+    } catch {
+      return null;
+    }
+  })();
+  const memoryStorage = new Map();
+  const storage = {
+    getItem(key) {
+      if (nativeStorage !== null) {
+        try {
+          return nativeStorage.getItem(key);
+        } catch {
+          /* 读也抛（配额/隐私模式）⇒ 退回内存那份 */
+        }
+      }
+      return memoryStorage.has(key) ? memoryStorage.get(key) : null;
+    },
+    setItem(key, value) {
+      memoryStorage.set(key, String(value));
+      if (nativeStorage === null) return;
+      try {
+        nativeStorage.setItem(key, value);
+      } catch {
+        /* 写不进去也别抛：内存那份已经存了 */
+      }
+    },
+    removeItem(key) {
+      memoryStorage.delete(key);
+      if (nativeStorage === null) return;
+      try {
+        nativeStorage.removeItem(key);
+      } catch {
+        /* 同上 */
+      }
+    },
+  };
+
   const ROOT_ATTR = "data-dsh-live2d-pet-root";
   const PET_ATTR = "data-dsh-live2d-pet";
   const LEGACY_ATTR = "data-dsh-live2d-pet-container";
@@ -40,6 +91,26 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
   /** 显示层轮询间隔：桌面端接管/让位要在一秒内被看见。 */
   const LAYER_POLL_MS = 1000;
 
+  // ---- 交给引擎的地址必须是"保住 host 的绝对地址" ----
+  //
+  // 症状（2026-09-30 官方桌面端实测）：贴图全挂在
+  //   `dsh-app://api/live2d-pet/asset/ds-whale-girl/textures/texture_01.png` 404
+  // —— 注意 host 位置被 `api` 占了：官方桌面端的页面 origin 是 `dsh-app://app`，
+  // 而 Pixi 是在 **blob Worker** 里 `fetch` 贴图的（`WorkerManager.loadImageBitmap`），
+  // blob Worker 里解析 `/api/...` 这种根相对地址会把 host 丢掉。
+  //
+  // 所以凡是交给引擎（`Live2DModel.from` / 脚本注入）的地址，都先拼成
+  // `<协议>//<host>/api/...`。http(s) 外壳下结果与相对地址等价（只是更长），
+  // 自定义协议外壳下这正是能通的那一种写法。
+  const URL_BASE = (() => {
+    const { protocol, host } = window.location;
+    if (host) return protocol + "//" + host;
+    const { origin } = window.location;
+    return typeof origin === "string" && origin !== "null" ? origin : "";
+  })();
+  const absolutize = (url) =>
+    typeof url === "string" && url.startsWith("/") && URL_BASE !== "" ? URL_BASE + url : url;
+
   /**
    * 桌面端注册进来的"跟随处理器"。
    *
@@ -3010,7 +3081,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
 
   function loadStored() {
     try {
-      const raw = window.localStorage.getItem(STORAGE_KEY);
+      const raw = storage.getItem(STORAGE_KEY);
       if (raw === null) return {};
       const parsed = JSON.parse(raw);
       return typeof parsed === "object" && parsed !== null ? parsed : {};
@@ -3021,7 +3092,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
 
   function saveStored(patch) {
     try {
-      window.localStorage.setItem(STORAGE_KEY, JSON.stringify(Object.assign(loadStored(), patch)));
+      storage.setItem(STORAGE_KEY, JSON.stringify(Object.assign(loadStored(), patch)));
     } catch {
       /* storage is best-effort */
     }
@@ -3637,7 +3708,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
 
   const readLocal = (key) => {
     try {
-      const raw = window.localStorage.getItem(key);
+      const raw = storage.getItem(key);
       return raw === null ? null : JSON.parse(raw);
     } catch {
       return null;
@@ -3645,8 +3716,8 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
   };
   const writeLocal = (key, value) => {
     try {
-      if (value === null || value === undefined) window.localStorage.removeItem(key);
-      else window.localStorage.setItem(key, JSON.stringify(value));
+      if (value === null || value === undefined) storage.removeItem(key);
+      else storage.setItem(key, JSON.stringify(value));
     } catch {
       /* 无痕模式之类：这次生效，下次不记得 */
     }
@@ -3912,7 +3983,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
     FLAGS[key] = value === true;
     if (key === "outfitArchive" && FLAGS[key] === false) {
       try {
-        window.localStorage.removeItem(OUTFIT_KEY);
+        storage.removeItem(OUTFIT_KEY);
       } catch {
         /* 无痕模式：本来也没存下 */
       }
@@ -3952,7 +4023,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
     let saved = given === undefined ? null : given;
     if (saved === undefined || saved === null) {
       try {
-        saved = JSON.parse(window.localStorage.getItem(OVERRIDE_KEY) ?? "null");
+        saved = JSON.parse(storage.getItem(OVERRIDE_KEY) ?? "null");
       } catch {
         saved = null;
       }
@@ -4304,7 +4375,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
     let saved = given === undefined ? null : given;
     if (saved === undefined || saved === null) {
       try {
-        saved = JSON.parse(window.localStorage.getItem(TUNING_KEY) ?? "null");
+        saved = JSON.parse(storage.getItem(TUNING_KEY) ?? "null");
       } catch {
         saved = null;
       }
@@ -5339,13 +5410,13 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
       layoutRef.current = layout;
 
       const boot = async () => {
-        if (!await ensureCore(catalog.coreUrl)) {
+        if (!await ensureCore(absolutize(catalog.coreUrl))) {
           if (!disposed) setCoreMissing(true);
           return;
         }
         if (disposed) return;
         setCoreMissing(false);
-        const vendor = await ensureVendor(catalog.vendorUrl);
+        const vendor = await ensureVendor(absolutize(catalog.vendorUrl));
         if (disposed) return;
         if (vendor === undefined) throw new Error("vendor bundle unavailable");
         configureVendor(vendor);
@@ -5381,7 +5452,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
         app.canvas.style.height = "100%";
         stage.appendChild(app.canvas);
 
-        const loaded = await vendor.Live2DModel.from(pet.modelUrl, {
+        const loaded = await vendor.Live2DModel.from(absolutize(pet.modelUrl), {
           autoUpdate: false,
           autoHitTest: true,
           autoFocus: false,
@@ -5985,7 +6056,7 @@ window.__ModuleLoader__.load({ id: "dsh-pet-live2d", factory: (require) => {
     const readOutfit = () => {
       if (!FLAGS.outfitArchive) return null;
       try {
-        const parsed = JSON.parse(window.localStorage.getItem(OUTFIT_KEY) ?? "null");
+        const parsed = JSON.parse(storage.getItem(OUTFIT_KEY) ?? "null");
         return parsed !== null && typeof parsed === "object" ? parsed : null;
       } catch {
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pet-live2d",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "Live2D 桌宠插件：为 DSH Web GUI 挂一只可拖动、会跟随鼠标、能换动作与表情的 Live2D 宠物。",
   "type": "module",
   "main": "lib/index.js",
@@ -49,7 +49,8 @@
     }
   },
   "optionalDependencies": {
-    "dsh-pet-live2d-desktop-win32-x64": "3.1.0"
+    "dsh-pet-live2d-desktop-darwin-arm64": "3.1.2",
+    "dsh-pet-live2d-desktop-win32-x64": "3.1.2"
   },
   "devDependencies": {
     "esbuild": "^0.25.10",