前言¶
在 DeepSeek Harness（DSH）里长时间开着 Web 界面调试智能体时，界面本身偏工具向，缺少一点常驻的视觉反馈。若想在同一页面里顺手查看 DeepSeek 账户余额，通常要另开控制台或自己写脚本调 https://api.deepseek.com/user/balance。插件 dsh-live2d-pet（维护者 qqmqq，GitHub：qqmqq/dsh-live2d-pet）把 Live2D 桌宠挂在 DSH Web 右下角：可拖动、吸附边缘、滚轮缩放，单击即可读余额；在 SkillHub 社区目录中归类为「趣味换装」。
下面介绍它的定位、能力与安装用法。事实以仓库 README 与 package.json（版本 0.1.0，MIT）为准。
这是什么¶
dsh-live2d-pet 是面向 DSH Web 的界面插件：在页面右下角渲染一只 Live2D「桌面宠物」。模型为从游戏《冷たい目をした黒瀬さん》提取的 kouzhaomei（含 2 张图集），默认按游戏相机取景裁切（约 300×380 视口），与游戏内构图一致。除装饰与待机动画外，单击宠物会展示 DeepSeek 账户余额；余额由宿主插件代理请求官方接口，API Key 取自 DSH 凭据中的 DEEPSEEK_API_KEY 或同名环境变量。
插件在宿主 启动时挂载（cordis.patch.yml + dsh.bundle.patch），前端为原生 JS 挂件（assets/widget.js，无构建步骤），后端在 lib/index.js 提供路由、余额缓存与页面注入。
核心功能¶
桌宠交互与持久化¶
- 默认出现在 右下角；拖动移动，松手后自动 吸附到最近的左右边缘。
- 滚轮缩放，范围 0.5×–2.0×。
- 位置、大小、透明度 写入本地状态，重启 DSH Web 后保持。
- 悬停右上角 ⚙ 菜单：余额、大小 ±、透明度、归位、隐藏。
- 隐藏后右下角保留 🐾 浮标，可再次唤出桌宠。
余额展示¶
- 单击桌宠查看余额；数据经插件路由
/dsh-live2d-pet/balance.json提供，上游为https://api.deepseek.com/user/balance。 - 每 3 分钟 自动刷新一次；接口失败时显示 最近一次成功值，并标注「旧数据」。
待机动画¶
呼吸（ParamBreath）、眨眼（ParamEyeLOpen / ParamEyeROpen）、轻微摆头（ParamAngleX / ParamAngleZ），均使用模型自带 Cubism 参数，无需额外动作资源。
技术结构（便于自查）¶
宿主侧约 11 条路由，含 tapIndex 注入与余额缓存/重试/回退；静态资源含 Pixi、Live2D Core/Cubism、live2d-display 及 kouzhaomei.moc3 等。仓库提供 tools/smoke.mjs 做路由与状态往返的冒烟自测。
安装与启用¶
安装针对 web profile。从 GitHub 安装（插件市场收录后通常有同名条目）：
dsh plugin --profile web add github:qqmqq/dsh-live2d-pet
装完后 必须重启 dsh web，插件才会在宿主启动时加载。
卸载：
dsh plugin --profile web remove dsh-live2d-pet
本地开发可使用 README 中的 link: 形式指向本机路径；一般用户只需 GitHub 安装命令即可。
典型用法¶
- 按上一节安装并重启 DSH Web，打开 Web 界面，确认右下角出现 Live2D 桌宠。
- 拖动到习惯的位置，松手观察是否吸附到左或右边缘；用滚轮调整到合适的缩放比例。
- 确保 DSH 已配置
DEEPSEEK_API_KEY（或环境变量同名项），单击桌宠查看余额；需要时从 ⚙ 菜单再次打开余额或调整透明度/大小。 - 若暂时不想占用画面，用菜单 隐藏，之后点 🐾 浮标恢复。
维护者自测（在插件仓库根目录）：
node tools/smoke.mjs
期望：11 条路由均返回 200；state.json 的 PUT/GET 往返一致；tapIndex 注入幂等。
适用场景与注意¶
适合谁：长期在 DSH Web 上跑任务、希望界面有一点 Live2D 装饰、且想在同一页快速扫一眼 DeepSeek 余额的开发者。它不替代官方账单页或完整用量分析，只是把余额查询嵌进桌宠交互。
权限与安全：插件与当前 dsh 进程同权限 运行，会读取 DSH 中的 API Key 并请求 DeepSeek 余额接口。安装前请自行审阅 源码 与 MIT 许可证，确认模型提取与使用方式符合你的合规要求（模型来源说明见仓库 L2D_Extract/README.txt）。
生态说明：DSH 奉行「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，本文也不将其描述为官方应用商店条目。
结尾¶
dsh-live2d-pet 把 Live2D 桌宠与 DeepSeek 余额查询叠在 DSH Web 右下角：拖动吸附、滚轮缩放、待机动画与状态持久化均已写在 README 中，可按上文命令安装并在重启 Web 后使用。
