DeepSeek Harness (DSH) 支持插件化扩展,当智能体在后台运行时,开发者通常需要一个直观的方式来确认当前状态。dsh-fritia-pet 提供了一个桌面宠物,通过可视化的行为来反映 Harness 的运行状态。
插件介绍¶
- 名称: dsh-fritia-pet
- 一句话介绍: 右下角的小人。左键互动、右键看余额、长按/拖动可以抓起,Harness 干活时它会左右走。
- 维护者: dzy1571315598
- 类别: 趣味换装
- 许可证: MIT
核心功能¶
- 右下角显示桌宠: 小人默认贴在视口右下角,窗口缩放会重新校正位置。
- 左键互动: 触发高兴、困惑、生气、彩蛋等状态。
- 右键查看余额: 切换到余额面板,自动读取 DeepSeek 账户余额。
- 抓起与拖动: 长按(260ms 不动)或按住拖动可以抓起桌宠,松手后停在原地。
- Harness 工作反馈: Harness 干活时,小人会在右下角区域内左右走动。
- 状态切换: 支持待机、困、钓鱼、走路等状态切换。
- HTTP 服务: 暴露立绘路由与忙碌状态。
- 素材数量: 20 张 256×256 透明立绘。
安装与启用¶
通过官方插件管理器安装,不要手动修改配置文件。
# 由 plugin_manager 完成安装(不要手改 profile 的 package. / cordis.patch.yml)
注意: 必须重启一次 DSH 桌面端才会加载 Host 代码。运行中的进程缓存了已导入的模块,重新启用插件行、重装 bundle 都不会重新导入它。
典型用法¶
- 抓起桌宠: 长按鼠标左键 260ms 不动。
- 触发生气: 在 1 秒内连续点击鼠标左键 3 次。
- 查看余额: 右键点击桌宠。
- 检查 Host 状态: 浏览器访问
http://127.0.0.1:19387/fritia-pet/health。
技术细节¶
- 立绘加载: 素材路由不稳定,使用
exact+ 查询参数,路径为/fritia-pet/sprite?f=<文件名>。 - 余额获取: 优先走 Remote 命名空间,失败时回落到 Host 路由。
- 状态机: 包含待机切换、10 秒转困/钓鱼、走路四帧动画、点击反馈等逻辑。
- 自检: Host 就绪时会返回 JSON,包含插件名、素材数量及具体立绘状态。
注意事项¶
- 本插件只走同源 HTTP,Host 半的
/fritia-pet/*用于读取素材与忙碌状态/余额兜底。 - 余额金额较长时(例如 18 位小数)会完整显示,板子上的字号按比例缩放。
- 拖动过之后,桌宠会停在鼠标松手的位置,不再跟随窗口校正。
- 120 秒无互动的模拟结果会触发困或钓鱼状态。