前言¶
DeepSeek Harness（DSH）支持通过插件扩展 Web 界面功能。开发者在调试或日常使用中，常希望在浏览器侧增加一点「陪伴感」或「桌面趣味性」。dsh-k-on-pet 插件将原版 Windows 桌宠《K-ON! 轻音少女》移植到 DSH，让五位角色以桌宠形式悬浮在右下角，与当前会话同时存在。
是什么¶
dsh-k-on-pet 是一个 DSH 客户端插件，维护者为 sunjay-lee。它不修改 DSH 源码，也不另起窗口，而是通过 DSH 的插件机制，将角色渲染层挂载到 Web GUI 的 overlay 槽位。安装后，五位角色会出现在右下角，通过点击、拖动、双击等交互与用户互动，并在 DSH 设置里提供独立的开关与配置。
核心功能¶
- 角色与语音：五位角色（平泽唯、秋山澪、田井中律、琴吹䌷、中野梓）共 137 条原版语音。每张 96×96 精灵图集，包含待机、被点击、打瞌睡、被拎起等动作。
- 点击交互：单击切换
react动作并随机播一条语音，气泡显示台词。 - 双击交互：比心动作 + 随机台词。
- 拖动与抛出：按住拖动会播放
held动作，松手后根据速度做抛物线运动，落地后恢复待机。拖出可视区会被自动拉回。 - 闲置与关怀：约 4 分钟无操作进入
sleep状态，再久一点冒Zzz气泡。每 2.5–5 分钟随机闲聊一句，每 50 分钟提醒喝水 / 起身 / 看远处。 - 角色设置：在 DSH 设置 → K-ON! 桌宠 里独立开关五位角色，可同时显示；支持全部显示 / 全部隐藏。
- 茶桌功能：默认常驻界面底部偏上（聊天输入框上方），可在设置里关闭。拖动桌面可移动茶桌位置，右键桌面可固定位置、让全部角色入座或离座。将角色拖到茶桌范围内会自动坐到自己的固定座位，从座位拖出即离座。唯、律、䌷入座后播放 4×2 的坐姿动画，澪、梓为静态坐姿。
- 外观与行为：统一大小（1.0–2.4×）、语音、随机闲聊、关怀提醒开关，以及一键恢复默认。
- 右键菜单：隐藏这只、把这只重置回右下角。菜单为页面内浮层，不依赖浏览器弹窗。
- 记忆与持久化：角色显隐、大小、语音/闲聊/关怀开关、每个角色各自的坐标保存在浏览器
localStorage，刷新后恢复。设置页和宠物右键菜单读写同一份偏好。 - 不挡操作：只有宠物本体接收指针事件，其余区域点击穿透。
- 无网络、无模型调用：不请求外部接口，不上传任何数据。
安装与启用¶
要求：DSH Web profile（桌面端或 dsh web），DSH 0.2.x。当前在 0.2.1-rc.2 上实测通过。
方式一：插件面板（推荐）¶
在 DSH 的「插件 / 插件市场」里搜索 dsh-k-on-pet，安装并启用。面板会同时处理依赖和 bundle 注册。
方式二：命令行¶
dsh plugin --profile web add dsh-k-on-pet
安装后，需要让 profile 加载它。打开 $DSH_HOME/profiles/web/package.json（默认 ~/.dsh/profiles/web/package.json），把 "dsh-k-on-pet" 加进 dsh.profile.bundles 数组：
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-k-on-pet"]
}
}
}
然后重启 dsh web / 桌面端。
方式三：从 GitHub 安装¶
dsh plugin --profile web add github:sunjay-lee/dsh-k-on-pet
同样把 dsh-k-on-pet 加入 dsh.profile.bundles 后重启。
卸载¶
从 dsh.profile.bundles 移除 dsh-k-on-pet，然后：
dsh plugin --profile web remove dsh-k-on-pet
典型用法¶
- 单击角色，观察动作切换与语音播放。
- 拖动角色，观察被拎起与抛出效果。
- 将角色拖到茶桌范围，观察自动入座与坐姿动画。
- 在 DSH 设置 → K-ON! 桌宠 里调整大小、开关语音或关怀提醒。
- 右键角色，使用「隐藏这只」或「回到右下角」。
适用场景与注意¶
- 适合希望在 Web 调试或使用过程中增加一点桌面陪伴感的开发者。
- 插件以当前 dsh 进程权限运行，安装前建议查看源码与许可证（代码 MIT，角色素材为同人资源，详见 THIRD_PARTY_NOTICES.md）。
- 设置保存在浏览器
localStorage，换浏览器或清空站点数据会恢复默认（仅唯、1.5×、右下角）。 - 不依赖 TUI / headless profile，仅支持
webprofile。
短结尾¶
dsh-k-on-pet 将《K-ON! 轻音少女》桌面宠物移植到 DSH Web 界面，通过点击、拖动、茶桌入座等交互提供陪伴感。代码 MIT，角色素材为同人资源。安装方式见上方命令，详细配置与使用在 DSH 设置 → K-ON! 桌宠 分区。
- 插件市场：https://www.skillhub.cn/plugins/sunjay-lee/dsh-k-on-pet
- GitHub：https://github.com/sunjay-lee/dsh-k-on-pet
