dsh-plugin-vrmpet3d
A VRM 3D desktop pet for DeepSeek Harness with task status integration, a separate floating window, model animations, and AI chatter.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-vrmpet3d@0.1.2
Plugin Vrmpet3d is published as dsh-plugin-vrmpet3d and currently resolves to version 0.1.2. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
为 DeepSeek Harness（DSH） 添加一只随任务状态活动的 3D 桌宠。支持应用内显示，以及 DSH Desktop 上独立的透明悬浮窗；任务进行、等待确认、完成或出错时，宠物会显示对应状态并播放配置的动作。
自带两款模型和 VRMA 动作包，安装后即可使用。可导入自己的模型，设置动作、表情、视线和物理效果，也可以让宠物说预设台词或使用 AI 生成碎碎念。
当前为早期版本，仍在修复和完善。3D 渲染会占用 GPU 与内存；遇到异常时，请附上 DSH 版本、显示方式和复现步骤反馈。
no runtime dependencies · works offline
空闲、工作中、等待确认与任务完成的状态展示合成图：
碎碎念与鼠标凝视的实机演示：
展示模型为 BlueFatFish / 蓝色小肥鱼Deepseek，作者 木子恶魔， 原始发布页。经作者授权随本插件分发，需注明来源与作者。 模型版权归原作者，其授权独立于插件代码的 MIT 许可证。模型选择页及首次引导的模型步骤也展示相同署名、授权与来源。
市场截图顺序由根目录 screenshots.json 声明，包含合成展示图和四张原始截图。
| 功能 | 说明 |
|---|---|
| 两种显示方式 | 应用内宠物；Desktop 端自动开启独立悬浮窗，支持置顶和透明区域鼠标穿透 |
| 任务状态联动 | 空闲、工作中、等待确认、完成、出错与离线；空闲保持 idle，不自动进入休眠 |
| 模型 | VRM 1.0 / 0.x，兼容普通 glTF/GLB；人体动作播放需要 VRM 骨架 |
| 动作 | 自带 VRMA 动作包，可按状态配置循环、单次、速度、表情、口型和凝视 |
| 跳支舞 | 右键随机播放一支舞蹈；播完、双击或开始工作时结束 |
| 互动 | 点击与长按部位触发表情和碎碎念；拖动、缩放、旋转视角、视线跟随和弹簧骨物理 |
| 碎碎念 | 内置台词、自定义台词，或使用 DSH 模型 / OpenAI 兼容接口生成 AI 台词 |
| 导入 | 模型以文件导入、动作包以文件夹导入，复制到插件存储后不依赖原路径 |
| 界面语言 | 全部界面中英双语，默认跟随系统 / DSH 自动识别；「通用设置 → 显示与外观」和初次引导欢迎页各有一个语言选择（自动 / 中文 / English） |
请使用本仓库的 main 分支安装。项目尚未发布到 npm。
在 DSH 插件管理器中添加本仓库；支持 GitHub 包来源时，使用：
github:drliuhuan/dsh-plugin-vrmpet3d#main
也可以下载 main 分支 ZIP，解压后在插件管理器中添加包含 package.json 的文件夹，或填写 link:<插件文件夹的绝对路径>。
确认插件已启用，然后重启 DSH。更新插件后也请重启，确保宿主代码和页面代码使用同一版本。
请先停用其他占用同一桌宠显示位置的插件，例如 dsh-plugin-fatfish-pet、dsh-plugin-whale-pet。卸载时从插件管理器移除本插件。
首次引导会依次配置偏好模型、桌宠界面和 AI 碎碎念。可稍后配置，也可在 通用设置 → 其他 → 重新运行引导 再次打开。
| 操作 | 效果 |
|---|---|
| 点击 / 原地长按 | 触发部位互动与碎碎念，保留正在播放的动作 |
| 左键拖动 | 移动宠物；开启对应界面的重力后，松开可触发抛掷和落地 |
| 滚轮经过宠物 | 调整宠物及其文字大小 |
| 滚轮经过文字 | 单独调整文字大小 |
| 右键拖动 | 旋转观察视角 |
| 右键点击 | 打开菜单：显示切换、模型切换、跳舞、重载、设置、重力和隐藏等 |
| 双击 | 结束当前跳舞 |
自带默认模型 蓝色小肥鱼Deepseek（木子恶魔），以及备用模型 ヴィータ（VRoid プロジェクト）。来源和授权见下方许可证说明及模型说明。
| 项目 | 信息 |
|---|---|
| 模型文件 | BlueFatFish.vrm.br（加载时解压为 VRM） |
| 模型名称 | 蓝色小肥鱼Deepseek |
| 作者 | 木子恶魔 |
| 来源 | Aplaybox 原始发布页 |
| 分发授权 | 经作者授权随本插件分发，需注明来源与作者 |
本项目的 MIT 许可证不替代模型作者的授权；其他用途仍以作者原始发布页的条款和另行授权为准。
模型支持 .vrm、.glb、.gltf，动作支持 .vrma；不支持 PMX/PMD 或 VMD。普通 glTF/GLB 没有 VRM 人体骨架时，不能播放 VRMA 人体动作。自带模型与动作使用 Brotli 压缩存储，加载时自动解压。
导入内容与配置保存在 DSH profile 的插件存储目录中。移除导入只删除插件持有的副本，不删除原文件。随包动作的默认设置按文件名解析，不依赖其他机器上的模型或动作 ID。
宠物通过任务状态、会话标识和计时信息判断当前状态，不需要读取会话正文、工具参数或附件。启用 AI 碎碎念后，所配置的人格、状态提示词和部位信息会发送给你选择的 AI 服务；费用与数据处理规则由该服务决定。
请通过 GitHub Issues 提交问题，附上 DSH 版本、操作系统、内置/外置显示方式、复现顺序与预期结果。请勿上传 API Key 或私人会话内容。
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 · Report an issue · MIT 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.
The composite shows the idle, working, waiting for confirmation and task completed states:
Pet in idle, working, waiting and completed states
Live demo of chatter and mouse gaze:
The model shown is BlueFatFish / 蓝色小肥鱼Deepseek, by 木子恶魔. See the original release. 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, which lists the composite and four original screenshots.
| 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 |
| Language | The whole interface is Chinese and English, auto-detected from the system or DSH by default; a chooser (Auto / 中文 / English) sits in General settings → Display, and on the first-run guide's welcome screen |
Install from this repository's main branch. The project is not published on npm yet.
Add this repository in the DSH plugin manager. If it accepts GitHub package sources, use:
github:drliuhuan/dsh-plugin-vrmpet3d#main
You can also download the main branch ZIP, extract it and add the folder containing package.json in the plugin manager, or enter link:<absolute path to the plugin folder>.
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.
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.
| 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 |
The bundled default model is 蓝色小肥鱼Deepseek by 木子恶魔. The alternate model is ヴィータ by VRoid プロジェクト. See the license notes below and the model documentation for their sources and terms.
| Item | Information |
|---|---|
| Model file | BlueFatFish.vrm.br (decompressed to VRM when loaded) |
| Model name | 蓝色小肥鱼Deepseek |
| Author | 木子恶魔 |
| Source | Original Aplaybox release |
| 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.
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.
Report issues through GitHub Issues. Include your DSH version, operating system, display mode, reproduction steps and expected result. Do not upload API keys or private conversation content.
插件代码与本项目原创动作采用 MIT 许可证。模型资源仍遵守各自作者的授权，不因随本仓库分发而自动改为 MIT。
MIT — see LICENSE. It bundles other MIT-licensed software as one generated file
(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 | 蓝色小肥鱼Deepseek | 木子恶魔 | https://www.aplaybox.com/details/model/ayXkRzVflmnd | 经作者授权分发 — credited here as the author asks |
| 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.