前言¶
DeepSeek Harness (DSH) 采用插件化架构。在 Agent 运行过程中，开发者往往需要更直观的状态反馈。现有的浏览器内 UI 虽然功能丰富，但在后台运行时往往难以捕捉或被遮挡。
dsh-ronaldo-pet 插件提供了一种解决方案：它不仅存在于 Web 界面右下角，更通过原生 Windows 窗口常驻桌面，实时感知 Agent 的运行状态。通过精灵动画和交互反馈，将 Agent 的工作流（工作、思考、等待、出错、完成）具象化。
基本信息¶
- 插件名称：dsh-ronaldo-pet
- 维护者：Stellum-Waq
- 分类：趣味换装
- 许可证：MIT
- Star 数：5
核心功能¶
原生桌面窗口¶
插件使用 WPF 技术构建，生成一个无边框、背景透明且永远置顶的桌面窗口。
* 独立性：不依赖浏览器内核，终端关闭或浏览器最小化时窗口依然存在（只要终端进程在运行）。
* 生命周期：插件加载时自动拉起，当宿主进程无响应超过 15 秒或进程结束时自动退出。
* 交互方式：
* 悬停：显示当前工作区、对话标题及 Agent 状态。
* 单击：冒出对话气泡并播放点击音效。
* 快速连点三下：触发摔倒动画。
* 双击：用 Microsoft Edge 打开 Harness 网页。
* 拖动/滚轮：改变位置和窗口大小（32～1024 DIP）。
* 右键菜单：提供切换宠物、调整大小、隐藏、设为默认、系统音开关等选项。
Agent 状态感知¶
插件通过轮询 agents 服务，监听 tools/execute、approval/request 等接口，实时推导并切换 Agent 的状态，对应不同的动画帧：
* 工作：专注状态。
* 思考：回合中思考。
* 等待：等待审批。
* 出错：戏剧性摔倒。
* 空闲：待机。
* 完成：SIU 庆祝跳跃 + 全机播放提示音。
精灵动画与分辨率¶
- 动画规格：支持 8 列 × 11 行的精灵图集。
- 分辨率：不限单格尺寸。无论是像素风、精细立绘还是写实素材，插件均支持，显示时会等比缩放。
一句话生成宠物¶
配合 dsh-pet-forge 技能，可以通过自然语言描述生成新宠物。该流程整合了生图模型、Blender 3D 建模、动作/音效设计。
* 生成流程：环境自检 -> 生成 -> 校验 -> 安装。
* 注册：生成并安装后，宠物会立即出现在界面右下角。
从视频生成（v2.2 新增）¶
支持将视频素材（尤其是绿幕或纯色幕布拍摄）转化为桌宠动作。
* 流程：抽帧 -> 抠幕布 -> 按时间段/运动切分动作 -> 合成图集。
* 参数：支持调整抠像参数（key, similarity, blend, spill, erode）。
* 解码引擎：优先使用 ffmpeg，其次 OpenCV，最后支持直接导入抽好的 PNG 帧。
宠物社区（v2.1 新增）¶
基于 DPSL-1.0 开放共享协议，支持将生成的宠物发布到 GitHub 并收录进插件内置的「宠物社区」。
* 共享流程：生成完宠物后，插件会询问是否按 DPSL-1.0 发布。选择同意后，插件会生成分享包，但不会自动上传（需要用户手动执行脚本或操作），也不执行仓库内的脚本。
* 权限：插件仅被授权收录、展示、下载和本机安装，不得商业销售或用于训练模型。
安装与启用¶
安装插件¶
通过 DSH CLI 安装：
# 从 GitHub 安装
dsh plugin --profile web add github:Stellum-Waq/dsh-pet-ronaldo
# 本地开发安装
dsh plugin --profile web add D:\代码\桌宠\dsh-ronaldo-pet
安装配套技能¶
安装用于生成新宠物的 dsh-pet-forge 技能：
Copy-Item -Recurse -Force .\skill\dsh-pet-forge $env:USERPROFILE\.agents\skills\
卸载¶
dsh plugin --profile web remove dsh-ronaldo-pet
注意事项¶
- 权限范围：插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。
- 默认行为：默认只开启一只宠物（默认为内置 C罗）。新生成的宠物会自动接管默认位，其他宠物自动收起。如需多宠物并排，需在设置中手动打开。
- 隐私与安全：插件不会替你上传任何东西，也不执行仓库里的脚本，不会读取你的 GitHub 凭据。
总结¶
dsh-ronaldo-pet 通过原生窗口和状态感知，解决了 Agent 运行过程中的视觉反馈问题。配合视频生成和社区分享功能，它为开发者提供了一个可扩展的桌宠生态，既提升了使用体验，也丰富了 Agent 的表现形式。
