在 DeepSeek Harness (DSH) 的开发流程中,Agent 的运行状态通常通过日志或进度条反馈。这种反馈虽然精确,但缺乏直观的视觉锚点。dsh-kun-pet 插件通过在 Web 界面右下角引入一个桌面宠物,将 Agent 的状态(空闲、工作、思考等)转化为具体的动画动作,增强了开发过程中的交互体验。
插件定位¶
该插件由 Practice019 维护,属于趣味换装类工具。它的核心价值在于将 Agent 的运行状态映射为视觉反馈,并在特定节点(如任务完成)触发声音交互。
核心功能¶
- 状态映射:支持 9 种动画状态,包括 idle、working、review、waiting、failed、celebrating、runRight、runLeft 和 wave。
- 语音反馈:任务完成时,Host 端通过 PowerShell 播放「你干嘛~哎哟」语音;点击交互时,浏览器端播放声音。
- 交互操作:支持拖拽移动和点击互动。
安装与启用¶
前置条件¶
- Windows 系统(依赖 PowerShell 和 PresentationCore 程序集)
- 已安装 pnpm
安装命令¶
dsh plugin --profile web add dsh-kun-pet
安装完成后需重启 DSH 才能生效,桌宠会自动出现在 Web 界面右下角。
典型用法¶
- 移动位置:按住桌宠拖动到屏幕任意位置。
- 互动:点击桌宠触发挥手动作。
- 状态观察:当 Agent 执行工具、思考或出错时,观察桌宠动作的变化。
- 任务完成:Agent 完成任务后,系统会自动播放语音。
注意事项¶
- 系统依赖:任务完成的声音播放依赖 Windows PresentationCore 程序集,需确保环境完整。
- 进程权限:插件在 DSH 进程内运行,安装前建议检查源码与许可证(MIT)。
总结¶
该插件通过视觉和听觉的双重反馈,为 DSH 的开发调试过程提供了一种轻量级的陪伴体验。开发者可以通过观察宠物的动作变化来快速感知 Agent 的当前状态。