dsh-pet-live2d 3.1.1 → 3.1.3

package/CHANGELOG.md

@@ -1,30 +1,40 @@
 # 更新日志
 
-## 3.1.1（2026-09-30）
+## 3.1.3（2026-10-01）
+
+### 修：设置里选「桌面」后，桌面上什么都没有（手动双击同一个 exe 却正常）
+
+插件拉起的桌面端会以「挂载模式」去 DSH 那里取宠物数据，而它拿到的地址一直退回默认端口
+3080 —— 在官方桌面客户端下那个端口没人听，于是桌面上空的。现在改成同时看请求的 `Host`
+头（官方客户端的页面地址是 `dsh-app://`，这种外壳下只有 `Host` 是真实地址）。
+
+### 修：官方桌面客户端里贴图全 404、宠物加载失败（issue #1）
+
+官方客户端的页面地址是 `dsh-app://`，而引擎在 Worker 里按相对地址取贴图时，地址里的
+`/api` 会被当成主机名 ⇒ 贴图全部 404。现在交给引擎的地址一律拼成保住主机名的绝对地址。
 
-### 修：在某些桌面外壳里"宠物整个不出现"（`localStorage` 一访问就抛）
+### 修：某些桌面外壳里宠物和设置页一起白掉
 
-有人反馈在 DeepSeek Harness 的**官方桌面端**里用不了（issue #1）。查下来最要命的一处是：
-客户端里有 20 多处**直接读写 `window.localStorage`**，而在**自定义协议 / opaque origin**
-的外壳里，**光是访问 `localStorage` 就会抛 `SecurityError`**（有些壳还会因为隐私设置直接
-禁用 storage）。它抛在组件的第一帧里 ⇒ **宠物和设置页一起白掉**，现象看起来就像"这个插件
-不支持我的桌面端"。
+自定义协议或隐私设置下，**一访问 `localStorage` 就会抛异常**，而插件原来到处直接用它。
+现在全部走带兜底的封装：拿不到就退回内存存储 —— 本次会话内位置、大小、装扮照常工作，
+只是关掉窗口不留存。
 
-现在所有读写都走一层带兜底的封装：
+### 改：macOS（arm64）的桌面端进了主包声明
 
-- 先试着取一次原生引用（**连这一步都在 `try` 里** —— `typeof window.localStorage` 本身也会抛）；
-- 拿不到、或读写中途抛（配额/隐私模式），就退回**内存实现**：本次会话内位置 / 大小 / 装扮
-  照常工作，只是关掉窗口不留存。
+装插件时会自动带上 mac 桌面端（在这之前只能从 Release 下 zip）。
+
+## 3.1.2（2026-09-30）
+
+### 修：官方桌面客户端里"加载失败"（issue #1）
+
+`dsh-app://` 外壳下引擎取贴图的地址会丢主机名 ⇒ 404。现已改为传给引擎的地址保住主机名。
+
+## 3.1.1（2026-09-30）
 
-顺带确认了一条：前端**只走相对路径**（`/api/live2d-pet/*`），插件加载走官方机制
-（`dsh.bundle` / `dsh.client` / `slots`）—— 所以换成 `http://127.0.0.1:<端口>` 之外的外壳
-地址也不该受影响。
+### 修：某些桌面外壳里宠物与设置页一起白掉
 
-### 改：macOS（arm64）平台子包进入主包声明
+这些外壳里访问 `localStorage` 会抛异常；现已加兜底，拿不到就用内存存储。
 
-`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

@@ -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/lib/index.js

@@ -1392,8 +1392,18 @@ function layerRoute(display) {
         return
       }
       // 页面自己报来的地址就是 DSH 的地址（端口是配置的，猜会猜错）。
+      //
+      // ⚠️ 但**官方桌面客户端的页面 origin 是 `dsh-app://app`**（自定义协议）—— 那个值
+      // 进不了 `setDshUrl`（它只收 `http(s)://`），于是会一直退回 3080 兜底：
+      // 壳以挂载模式连上一个没人听的端口 ⇒ 桌面上什么都没有（用户 2026-09-30 报的
+      // "插件里点桌面打开的 exe 显示不出宠物，直接双击倒是能出"就是这个）。
+      // 所以**同时看 `Host` 头** —— 自定义协议下应用会把请求转给本地服务，Host 才是真的。
       const origin = request.headers?.origin
       if (typeof origin === 'string') display.setDshUrl(origin)
+      const host = request.headers?.host
+      if (typeof host === 'string' && /^[\w.\-]+(:\d+)?$/.test(host)) {
+        display.setDshUrl('http://' + host)
+      }
       // 每次读状态都顺手 reconcile 一次：设置页点完马上能看到结果，不用等下一个 tick。
       const status = display.reconcile()
       sendJson(response, 200, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pet-live2d",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "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.3",
+    "dsh-pet-live2d-desktop-win32-x64": "3.1.3"
   },
   "devDependencies": {
     "esbuild": "^0.25.10",