dsh-plugin-vrmpet3d 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,43 @@
+MIT License
+
+Copyright (c) 2026 FatFish pet project contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Third-party notice
+
+This project's own source is under the MIT License above. It ships one generated
+file, `lib/client.vendor.js`, which bundles other MIT-licensed software:
+
+  * three.js                (c) 2010-2025 three.js authors      MIT
+  * @pixiv/three-vrm        (c) pixiv Inc.                      MIT
+  * @pixiv/three-vrm-animation (c) pixiv Inc.                   MIT
+
+(@moeru/three-mmd and mmd-parser were bundled until 2026-10-12, when this project
+became VRM-only and the MMD stack left both the chunk and `vendor/package.json`.)
+
+Their license texts are preserved inline in that file's banner and comments.
+
+It also ships ONE 3D model file, `assets/models/SampleModel.vrm`, whose own
+embedded metadata allows redistribution, modification and commercial use with no
+attribution required — see `assets/models/README.md`, and `check-docs.mjs` asserts
+those terms on the committed bytes. Every other model is supplied by the user and
+remains under its own author's terms.

package/README.md

@@ -1,3 +1,250 @@
-# Temporary Holding Version
+# 桌宠 3D · VRM Pet 3D
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+为 **DeepSeek Harness（DSH）** 添加一只随任务状态活动的 3D 桌宠。支持应用内显示，以及 DSH Desktop 上独立的透明悬浮窗；任务进行、等待确认、完成或出错时，宠物会显示对应状态并播放配置的动作。
+
+自带两款模型和 VRMA 动作包，安装后即可使用。可导入自己的模型，设置动作、表情、视线和物理效果，也可以让宠物说预设台词或使用 AI 生成碎碎念。
+
+[安装与使用](#安装) · [问题反馈](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/issues) · [MIT 许可证](LICENSE)
+
+[English](#english)
+
+> 当前为早期版本，仍在修复和完善。3D 渲染会占用 GPU 与内存；遇到异常时，请附上 DSH 版本、显示方式和复现步骤反馈。
+
+```
+no runtime dependencies · works offline
+```
+
+## 效果展示
+
+空闲、工作中、等待确认与任务完成的状态展示合成图：
+
+![桌宠空闲、工作中、等待确认与任务完成](assets/screenshots/states-overview.png)
+
+碎碎念与鼠标凝视的实机演示：
+
+![碎碎念与鼠标凝视演示](assets/screenshots/chatter-gaze.gif)
+
+展示模型为 **BlueFatFish / 蓝色小肥鱼Deepseek**，作者 **木子恶魔**，
+[原始发布页](https://www.aplaybox.com/details/model/ayXkRzVflmnd)。**经作者授权随本插件分发，需注明来源与作者。**
+模型版权归原作者，其授权独立于插件代码的 MIT 许可证。模型选择页及首次引导的模型步骤也展示相同署名、授权与来源。
+
+市场截图顺序由根目录 [screenshots.json](screenshots.json) 声明，包含合成展示图和四张原始截图。
+
+## 功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 两种显示方式 | 应用内宠物；Desktop 端自动开启独立悬浮窗，支持置顶和透明区域鼠标穿透 |
+| 任务状态联动 | 空闲、工作中、等待确认、完成、出错与离线；空闲保持 idle，不自动进入休眠 |
+| 模型 | VRM 1.0 / 0.x，兼容普通 glTF/GLB；人体动作播放需要 VRM 骨架 |
+| 动作 | 自带 VRMA 动作包，可按状态配置循环、单次、速度、表情、口型和凝视 |
+| 跳支舞 | 右键随机播放一支舞蹈；播完、双击或开始工作时结束 |
+| 互动 | 点击与长按部位触发表情和碎碎念；拖动、缩放、旋转视角、视线跟随和弹簧骨物理 |
+| 碎碎念 | 内置台词、自定义台词，或使用 DSH 模型 / OpenAI 兼容接口生成 AI 台词 |
+| 导入 | 模型以文件导入、动作包以文件夹导入，复制到插件存储后不依赖原路径 |
+
+## 运行要求
+
+- 已在 DeepSeek Harness **0.2.0-rc.2** 上验证；其他版本尚未验证，不代表无法使用。本项目是 DSH 插件，不能作为独立应用运行。
+- 支持 WebGL2 的图形环境。独立悬浮窗需可用的 Electron 运行时，由启动器从 DSH 安装目录复用；无法启动时回退到应用内显示。
+- 无需安装运行时 npm 依赖。默认台词和模型动画可离线使用；AI 碎碎念取决于所选服务的网络与额度。
+
+## 安装
+
+请使用本仓库的 **main 分支**安装。项目尚未发布到 npm。
+
+1. 在 DSH 插件管理器中添加本仓库；支持 GitHub 包来源时，使用：
+
+   ```text
+   github:drliuhuan/dsh-plugin-vrmpet3d#main
+   ```
+
+2. 也可以[下载 main 分支 ZIP](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/archive/refs/heads/main.zip)，解压后在插件管理器中添加包含 `package.json` 的文件夹，或填写 `link:<插件文件夹的绝对路径>`。
+3. 确认插件已启用，然后重启 DSH。更新插件后也请重启，确保宿主代码和页面代码使用同一版本。
+
+请先停用其他占用同一桌宠显示位置的插件，例如 `dsh-plugin-fatfish-pet`、`dsh-plugin-whale-pet`。卸载时从插件管理器移除本插件。
+
+## 首次使用
+
+首次引导会依次配置偏好模型、桌宠界面和 AI 碎碎念。可稍后配置，也可在 **通用设置 → 其他 → 重新运行引导** 再次打开。
+
+- **切换显示方式**：Desktop 的通用设置最上方可选“内置宠物”或“自动”；自动优先使用独立悬浮窗。右键菜单也可以切换。
+- **切换模型**：右键 → 切换模型，点击缩略图；可拖入自己的模型文件，加载进度结束后再继续切换。
+- **设置动作**：通用设置 → 状态与动作。默认映射、表情和播放方式已随动作包提供，可以自行修改。
+- **设置台词**：通用设置 → 碎碎念。选择内置、自定义或 AI 来源；AI 模式需要先选择可用服务和模型。
+- **设置表情与部位**：右键 → 当前模型参数设置。模型结构不同，可用表情、部位和弹簧骨链也会不同。
+
+### 鼠标操作
+
+| 操作 | 效果 |
+| --- | --- |
+| 点击 / 原地长按 | 触发部位互动与碎碎念，保留正在播放的动作 |
+| 左键拖动 | 移动宠物；开启对应界面的重力后，松开可触发抛掷和落地 |
+| 滚轮经过宠物 | 调整宠物及其文字大小 |
+| 滚轮经过文字 | 单独调整文字大小 |
+| 右键拖动 | 旋转观察视角 |
+| 右键点击 | 打开菜单：显示切换、模型切换、跳舞、重载、设置、重力和隐藏等 |
+| 双击 | 结束当前跳舞 |
+
+## 模型、动作与数据
+
+自带默认模型 **蓝色小肥鱼Deepseek（木子恶魔）**，以及备用模型 **ヴィータ（VRoid プロジェクト）**。来源和授权见下方许可证说明及[模型说明](assets/models/README.md)。
+
+### BlueFatFish 模型署名与授权
+
+| 项目 | 信息 |
+| --- | --- |
+| 模型文件 | `BlueFatFish.vrm.br`（加载时解压为 VRM） |
+| 模型名称 | 蓝色小肥鱼Deepseek |
+| 作者 | 木子恶魔 |
+| 来源 | [Aplaybox 原始发布页](https://www.aplaybox.com/details/model/ayXkRzVflmnd) |
+| 分发授权 | 经作者授权随本插件分发，需注明来源与作者 |
+
+本项目的 MIT 许可证不替代模型作者的授权；其他用途仍以作者原始发布页的条款和另行授权为准。
+
+模型支持 `.vrm`、`.glb`、`.gltf`，动作支持 `.vrma`；不支持 PMX/PMD 或 VMD。普通 glTF/GLB 没有 VRM 人体骨架时，不能播放 VRMA 人体动作。自带模型与动作使用 Brotli 压缩存储，加载时自动解压。
+
+导入内容与配置保存在 DSH profile 的插件存储目录中。移除导入只删除插件持有的副本，不删除原文件。随包动作的默认设置按文件名解析，不依赖其他机器上的模型或动作 ID。
+
+### AI 与隐私
+
+宠物通过任务状态、会话标识和计时信息判断当前状态，不需要读取会话正文、工具参数或附件。启用 AI 碎碎念后，所配置的人格、状态提示词和部位信息会发送给你选择的 AI 服务；费用与数据处理规则由该服务决定。
+
+### 常见问题与反馈
+
+- **没有宠物**：检查插件管理器里是否仍已启用，重启 DSH，并确认未被其他桌宠插件占用显示位置。
+- **没有独立窗口**：在通用设置中选择“自动”；若运行时不可用，仍可使用内置宠物。
+- **模型不播放动作**：确认使用 VRM 模型，状态下选有动作，并开启模型动作。反馈时请附上完整错误提示。
+- **AI 不说话**：检查台词来源、服务、模型和访问额度；可以先切回内置台词确认气泡显示正常。
+
+请通过 [GitHub Issues](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/issues) 提交问题，附上 DSH 版本、操作系统、内置/外置显示方式、复现顺序与预期结果。请勿上传 API Key 或私人会话内容。
+
+## English
+
+Add a 3D desktop pet to **DeepSeek Harness (DSH)**. The pet follows task states and can appear inside the app or in a separate transparent floating window on DSH Desktop. It shows the current state and plays its assigned motion while a task is running, waiting for confirmation, completed, or has failed.
+
+Two models and a VRMA motion pack are included. You can import your own models, configure motions, expressions, gaze and physics, and let the pet speak preset lines or generate AI chatter.
+
+[Installation and usage](#installation) · [Report an issue](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/issues) · [MIT license](LICENSE)
+
+> This is an early release and is still being improved. 3D rendering uses GPU and memory. When reporting a problem, include your DSH version, display mode and reproduction steps.
+
+### Screenshots and demo
+
+The composite shows the idle, working, waiting for confirmation and task completed states:
+
+![Pet in idle, working, waiting and completed states](assets/screenshots/states-overview.png)
+
+Live demo of chatter and mouse gaze:
+
+![Chatter and mouse gaze demo](assets/screenshots/chatter-gaze.gif)
+
+The model shown is **BlueFatFish / 蓝色小肥鱼Deepseek**, by **木子恶魔**. See the [original release](https://www.aplaybox.com/details/model/ayXkRzVflmnd). **The author authorized distribution with this plugin, provided the source and author are credited.** The model remains the author's work and is covered separately from the plugin's MIT license. The same attribution, authorization and source are shown in the model picker and the first-run guide.
+
+The marketplace screenshot order is declared in the root [screenshots.json](screenshots.json), which lists the composite and four original screenshots.
+
+### Features
+
+| Feature | Description |
+| --- | --- |
+| Two display modes | In-app pet, or an automatically opened floating window on Desktop with always-on-top and transparent-area click-through support |
+| Task state tracking | Idle, working, waiting for confirmation, completed, failed and offline; idle stays in the idle state and does not automatically sleep |
+| Models | VRM 1.0 / 0.x and regular glTF/GLB; humanoid VRM bones are required for character motions |
+| Motions | Included VRMA pack with per-state loop, one-shot, speed, expression, lip-sync and gaze settings |
+| Dance | Right-click to play a random dance; it ends when the motion finishes, on double-click, or when work starts |
+| Interaction | Click or hold body parts for expressions and chatter; drag, resize, rotate the view, follow the pointer and use spring-bone physics |
+| Chatter | Built-in or custom lines, or AI-generated lines using a DSH model or an OpenAI-compatible service |
+| Import | Import models as files and motion packs as folders. Imported files are copied into plugin storage and no longer depend on their original paths |
+
+### Requirements
+
+- Verified with DeepSeek Harness **0.2.0-rc.2**. Other versions have not been verified; this does not mean they cannot work. This is a DSH plugin and cannot run as a standalone application.
+- A graphics environment with WebGL2. The floating window requires an available Electron runtime, which the launcher reuses from the DSH installation. If it cannot start, the pet falls back to the in-app display.
+- No runtime npm dependencies are required. Built-in lines and model motions work offline. AI chatter depends on the selected service's network access and usage quota.
+
+### Installation
+
+Install from this repository's **`main` branch**. The project is not published on npm yet.
+
+1. Add this repository in the DSH plugin manager. If it accepts GitHub package sources, use:
+
+   ```text
+   github:drliuhuan/dsh-plugin-vrmpet3d#main
+   ```
+
+2. You can also [download the `main` branch ZIP](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/archive/refs/heads/main.zip), extract it and add the folder containing `package.json` in the plugin manager, or enter `link:<absolute path to the plugin folder>`.
+3. Make sure the plugin is enabled, then restart DSH. Restart after updates as well so the host and page code use the same version.
+
+Disable other plugins that use the same pet display position first, such as `dsh-plugin-fatfish-pet` and `dsh-plugin-whale-pet`. Uninstall this plugin through the plugin manager.
+
+### First run
+
+The first-run guide configures your preferred model, pet display and AI chatter. You can finish setup later, or reopen it from **General Settings → Other → Run setup guide again**.
+
+- **Choose a display mode:** On Desktop, select “Built-in pet” or “Automatic” at the top of General Settings. Automatic mode prefers the separate floating window. You can also switch modes from the right-click menu.
+- **Choose a model:** Right-click → Switch model, then select a thumbnail. You can also drop in a model file; wait for loading to finish before switching again.
+- **Configure motions:** General Settings → States and motions. Default state mappings, expressions and playback settings are included and can be changed.
+- **Configure lines:** General Settings → Chatter. Choose built-in, custom or AI lines. AI mode requires an available service and model.
+- **Configure expressions and body parts:** Right-click → Current model settings. Available expressions, body parts and spring-bone chains depend on the model.
+
+#### Mouse controls
+
+| Action | Result |
+| --- | --- |
+| Click / hold in place | Trigger body-part interaction and chatter while preserving the current motion |
+| Drag with left button | Move the pet; when gravity is enabled for that display, release to throw it and let it land |
+| Scroll over the pet | Resize the pet and its text |
+| Scroll over text | Resize the text only |
+| Drag with right button | Rotate the view |
+| Right-click | Open the menu for display and model switching, dancing, reloading, settings, gravity, hiding and more |
+| Double-click | End the current dance |
+
+### Models, motions and data
+
+The bundled default model is **蓝色小肥鱼Deepseek by 木子恶魔**. The alternate model is **ヴィータ by VRoid プロジェクト**. See the license notes below and the [model documentation](assets/models/README.md) for their sources and terms.
+
+#### BlueFatFish model attribution and authorization
+
+| Item | Information |
+| --- | --- |
+| Model file | `BlueFatFish.vrm.br` (decompressed to VRM when loaded) |
+| Model name | 蓝色小肥鱼Deepseek |
+| Author | 木子恶魔 |
+| Source | [Original Aplaybox release](https://www.aplaybox.com/details/model/ayXkRzVflmnd) |
+| Distribution authorization | The author authorized distribution with this plugin, provided the source and author are credited |
+
+The project's MIT license does not replace the model author's authorization. Other uses remain subject to the terms on the original release page and any separate authorization from the author.
+
+Models support `.vrm`, `.glb` and `.gltf`; motions support `.vrma`. PMX/PMD and VMD are not supported. Regular glTF/GLB files without a VRM humanoid skeleton cannot play VRMA character motions. Bundled models and motions are stored with Brotli compression and decompressed automatically when loaded.
+
+Imported files and settings are stored in the plugin storage directory in the DSH profile. Removing an import deletes only the plugin's copy, not the original file. Default settings for bundled motions are resolved by filename and do not depend on model or motion IDs from another machine.
+
+#### AI and privacy
+
+The pet uses task state, session identifiers and timing information to determine its current state. It does not need to read conversation text, tool arguments or attachments. When AI chatter is enabled, the configured personality, state prompt and body-part information are sent to the AI service you select. That service determines its own fees and data handling rules.
+
+#### Troubleshooting and feedback
+
+- **The pet is missing:** Check that the plugin is enabled, restart DSH, and make sure another pet plugin is not using the same display position.
+- **The floating window is missing:** Select “Automatic” in General Settings. The in-app pet remains available if the runtime cannot start.
+- **The model does not move:** Confirm that you are using a VRM model, that a motion is assigned to the current state, and that model motions are enabled. Include the full error message when reporting the issue.
+- **AI is silent:** Check the line source, service, model and usage quota. Switch to built-in lines to confirm that the speech bubble works.
+
+Report issues through [GitHub Issues](https://github.com/drliuhuan/dsh-plugin-vrmpet3d/issues). Include your DSH version, operating system, display mode, reproduction steps and expected result. Do not upload API keys or private conversation content.
+
+
+## License
+
+插件代码与本项目原创动作采用 MIT 许可证。模型资源仍遵守各自作者的授权，不因随本仓库分发而自动改为 MIT。
+
+MIT — see [LICENSE](LICENSE). It bundles other MIT-licensed software as one generated file
+([lib/client.vendor.js](lib/client.vendor.js)): three.js, `@pixiv/three-vrm` and `@pixiv/three-vrm-animation`. It
+ships exactly two 3D model files, and both may be redistributed with it:
+
+| file | model | author | source | terms |
+| --- | --- | --- | --- | --- |
+| [assets/models/BlueFatFish.vrm.br](assets/models/BlueFatFish.vrm.br) | 蓝色小肥鱼Deepseek | 木子恶魔 | <https://www.aplaybox.com/details/model/ayXkRzVflmnd> | 经作者授权分发 — credited here as the author asks |
+| [assets/models/SampleModel.vrm.br](assets/models/SampleModel.vrm.br) | ヴィータ | VRoid プロジェクト | <https://vroid.com/en/studio> | its own embedded licence: redistribution, modification and commercial use allowed, no attribution required |
+
+The first is what a fresh profile resolves to; the second is the fallback. Every other model is the user's and stays
+under its own author's terms.

package/assets/models/README.md

@@ -0,0 +1,99 @@
+# assets/models/
+
+Drop your own `.vrm`, `.glb` or `.gltf` files here (or point the
+plugin at a folder elsewhere with the `modelDirs` config). This build is **VRM and plain glTF/GLB only**
+(2026-10-12): a `.pmx`/`.pmd` is recognised by its magic bytes and refused by name, and a `.vmd` motion
+likewise, so neither belongs here.
+
+## What ships here: two models, and both may be redistributed with the plugin
+
+`BlueFatFish.vrm` is the model a fresh profile resolves to; `SampleModel.vrm` is the fallback. Each ships for a
+reason named here, and each is credited below with its **source and author** — the operator asked for that on
+2026-10-13 (「需要注明来源和作者」). The picker prints the same two credits under its grid, on 切换模型 and on the guide's
+② 偏好模型 step, because both mount one component and the credit comes from the host
+(`BUNDLED_MODEL_CREDITS` in `lib/index.js`).
+
+### `BlueFatFish.vrm` — 蓝色小肥鱼Deepseek, by 木子恶魔
+
+| | |
+| --- | --- |
+| model | 蓝色小肥鱼Deepseek |
+| author | 木子恶魔 |
+| source | <https://www.aplaybox.com/details/model/ayXkRzVflmnd> |
+| terms | 经作者授权分发，需注明来源与作者 — it ships inside this plugin with the author's permission, and this credit travels with it |
+| file | VRM 1.0 (`VRMC_vrm`), 18 480 432 bytes, 152 nodes, 6 meshes, 53 humanoid bones, 18 preset expressions plus one custom (`TiePen`), 22 spring chains |
+
+It became the plugin's default model on 2026-10-13 (「把BlueFatFish作为默认模型」). The permission covers distribution as
+part of this plugin and nothing else: a copy taken from this repository is still the author's work, under the
+author's terms, credited above.
+
+**授权说明：** BlueFatFish / 蓝色小肥鱼Deepseek 的作者为 **木子恶魔**，来源为上方 Aplaybox 原始发布页。
+本项目获得的是随本插件分发模型的授权，并保留来源与作者署名；模型不因收录于本仓库而改用 MIT 许可证。
+其他用途以模型作者的原始条款和另行授权为准。README 展示区、模型选择页和首次引导的模型步骤均保留这些信息。
+
+### `SampleModel.vrm` — ヴィータ, by VRoid プロジェクト
+
+**Committed on purpose** since 2026-10-10, and the reason it can be shipped is the file's own embedded licence — not
+a judgement call made here. Its `extensions.VRM.meta.otherLicenseUrl` is a VRoid Hub licence query string that
+reads:
+
+| term | value |
+| --- | --- |
+| `redistribution` | `allow` |
+| `modification` | `allow` |
+| `personal_commercial_use` | `profit` |
+| `corporate_commercial_use` | `allow` |
+| `credit` | `unnecessary` |
+| `allowed_to_use_user` | `everyone` |
+| `characterization_allowed_user` | `everyone` |
+| `sexual_expression` / `violent_expression` | `allow` |
+
+So it may be redistributed, modified, used commercially by individuals and
+corporations, and **needs no attribution**. It also has what a bundled model needs
+in order to exercise this plugin: a standard VRM humanoid rig, 15 expressions, and 18
+spring chains (hair and skirt), which is why the settings window has something real
+to show on a fresh install.
+
+Source: <https://vroid.com/en/studio> sample models / VRoid Hub. Author
+`VRoidプロジェクト`, title `ヴィータ`, 14 159 872 bytes.
+
+## Every OTHER file here
+
+The rule below is unchanged for anything you add, and it is why the assertion in
+`scripts/check-docs.mjs` now names the one bundled file instead of requiring the
+folder to be empty:
+
+* **No other model file may be committed here.** Most VRM models on the
+  internet forbid redistribution, and many forbid commercial use; committing one
+  would make this repository undistributable.
+* Read [`../../docs/ASSET-CONTRACT.md`](../../docs/ASSET-CONTRACT.md) before adding
+  anything: check the model's **embedded** metadata (`extensions.VRMC_vrm.meta`) as
+  well as the author's published rules, and when the two disagree take the
+  conservative reading.
+* Do **not** commit a model whose licence you have not read, and do not commit
+  frames rendered from one.
+
+## Prefer a folder outside the repo
+
+For your own models, `modelDirs` in the plugin config is the better route: it keeps
+licensed third-party assets out of version control entirely, and it lets you keep
+several collections in their own folders.
+
+```yaml
+- id: vrmpet3d
+  name: dsh-plugin-vrmpet3d
+  config:
+    modelDirs:
+      - D:/models/vrm
+      - F:/models/mine
+```
+
+## How the default is chosen
+
+`preferences.modelId` ships EMPTY, which means "resolve one". `core.resolveModelId`
+picks the catalogued model named `BlueFatFish.vrm` first — the bundled one, or yours
+if you have a file by that name — then `SampleModel.vrm`, then the first VRM, then the first model of any
+kind (and the kinds it catalogues are `.vrm`, `.glb` and `.gltf`; a `.pmx`/`.pmd` is left out of the
+catalogue entirely since 2026-10-12). With nothing catalogued at all the pet shows nothing and says so; it
+does not fall back to a stand-in avatar (that was removed on 2026-10-10), and `lib/placeholder.js` survives
+only as the fixture the geometry probes and the browser suite build an avatar with.

package/assets/models/vrmpet3d-models.json

@@ -0,0 +1,116 @@
+{
+  "springs": {
+    "BlueFatFish.vrm.br": {
+      "DaiMao": {
+        "stiffness": 0.4,
+        "dragForce": 0.2,
+        "gravityPower": 0.05
+      },
+      "LiuHai": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "LiuHai.R": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "LiuHai.L": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "FaBing.L": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "FaBing.R": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "ErDuo.L": {
+        "stiffness": 1,
+        "dragForce": 0.2,
+        "gravityPower": 0.05
+      },
+      "ErDuo.R": {
+        "stiffness": 1,
+        "dragForce": 0.2,
+        "gravityPower": 0.05
+      },
+      "Hou_hair": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Hou_hair.L": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Hou_hair.R": {
+        "stiffness": 0.05,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Z_QunZi": {
+        "stiffness": 1,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Q_QunZi.L": {
+        "stiffness": 1,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "QunZi.L": {
+        "stiffness": 1.5,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "H_QunZi.L": {
+        "stiffness": 1.5,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Z_HouQunZi": {
+        "stiffness": 1.5,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "H_QunZi.R": {
+        "stiffness": 1.5,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "QunZi.R": {
+        "stiffness": 1.5,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "Q_QunZi.R": {
+        "stiffness": 1,
+        "dragForce": 0.2,
+        "gravityPower": 0.5
+      },
+      "WeiBa": {
+        "stiffness": 0.5,
+        "dragForce": 0.5,
+        "gravityPower": 0.0484
+      },
+      "WeiBa.L": {
+        "stiffness": 0.5,
+        "dragForce": 0.5,
+        "gravityPower": 0.05
+      },
+      "WeiBa.R": {
+        "stiffness": 0.5,
+        "dragForce": 0.5,
+        "gravityPower": 0.05
+      }
+    }
+  }
+}