dsh-pet-live2d 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # 更新日志
 
+## 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` 一访问就抛）

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

@@ -91,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;
+
   /**
    * 桌面端注册进来的"跟随处理器"。
    *
@@ -5390,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);
@@ -5432,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,

package/package.json

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