dsh-pet-live2d 3.1.2 → 3.1.3

package/CHANGELOG.md

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