前言¶
在 DSH web 表面运行多个 session 时，开发者通常需要查看哪些线程在忙、各自在调用什么工具，以及当前事件处于哪个阶段。直接看日志可以，但信息比较散。
dsh-pet-shura 把这部分信息放到一个动画桌面宠物上：宠物上方显示事件气泡，双击或右键可以打开线程状态卡，宠物周围还能显示忙碌线程对应的工具节点。
下面介绍它的能力、安装方式和典型用法。
这是什么¶
dsh-pet-shura 是 brittanistrehlowll-oss 维护的 DeepSeek Harness (DSH) web 表面动画桌面宠物，中文名为“修罗小脑斧”。许可证为 MIT。
它基于 v2 spritesheet：
1536×2288
8 列 × 11 行
192×208 cells
package.json 版本为 1.5.0，type 为 module，主入口为 lib/index.js。README 声明它是零依赖宿主插件，并声明 “Nothing touches your model traffic”。
核心功能¶
事件气泡与线程概览¶
- SSE 气泡：通过
/pet/events在宠物上方显示 Codex 风格气泡。 - 线程概览：跟踪忙碌线程（session），每 15 秒刷新。
- 中文台词库：按
user/work/done/error/ask/reply/turn-end/workflow/goal等事件类型变化，并有 45–90 秒空闲自说。
动画、光标跟随与状态表达¶
- 完整 v2 动画：覆盖 11 行精灵表，包括
idle、running left/right、waving、jumping、failed、waiting、task-running、review和 16 方向环视。 - Look-at-mouse：以 16 方向帧跟随光标（240px radius）。
- 拖放并记住位置：保存于
localStorage['dsh.pet.pos']。 - 随机动作：每 7–16 秒进行挥手、跳跃、翻滚或走动，空闲 22 秒进入等待姿势。
- 状态符号：思考时显示
?，错误时出现红色 shake!，成功时对勾闪烁，等待时显示Zzz。 - 插件环：宠物周围半圆工具环，最多 6 个节点对应忙碌线程，由
GET /pet/status驱动。 - 核心光晕：工作时增强，呈现可见能量核心状态。
线程状态卡、设置与右键菜单¶
- 线程状态卡：双击宠物或右键选择“线程状态”，由
GET /pet/status提供忙碌线程和工具信息。 - 设置面板：右键选择“设置”，可调整大小（60/75/100%）、随机动作、look-at-mouse、重置位置，保存于
localStorage['dsh.pet.settings']。 - 右键菜单：宠物信息、隐藏/召回、线程状态、设置。
- 安全失败：spritesheet 不可用时脚本移除自身，不打扰宿主页面。
安装与启用¶
先运行安装命令：
dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-pet-shura"
然后重启 dsh web，并刷新页面。
卸载时运行：
dsh plugin --profile web remove dsh-pet-shura
然后重启 dsh web。
典型用法¶
1、双击宠物，或右键选择“线程状态”，查看忙碌线程及其工具。
2、右键宠物选择“设置”，调整大小、随机动作、look-at-mouse 或重置位置。
3、如果要做小改动，通常只需编辑 lib/pet-client.js；该文件由 tapIndex 内联到 index.html，无需构建步骤。
适用场景与注意¶
适合需要在 dsh web 表面保持对多个线程状态可见性的开发者。它会把位置设置写入浏览器：
localStorage['dsh.pet.pos']
localStorage['dsh.pet.settings']
运行时使用 /pet/events SSE、GET /pet/status 以及专用 spritesheet 路由。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证，只启用可信的插件。
相关页面¶
- 目录页：https://www.skillhub.cn/plugins/brittanistrehlowll-oss/dsh-pet-shura
- GitHub：https://github.com/brittanistrehlowll-oss/dsh-pet-shura
