前言¶
DeepSeek Harness (DSH) 的核心架构基于插件化设计。在调试或运行智能体时，仅通过日志和界面文本观察 Agent 的状态往往不够直观。dsh-codex-compatible-pet 插件旨在解决这一问题，它引入了 Codex 风格的桌面宠物，通过可视化的动画反馈 Agent 的运行状态。这是一个双端客户端插件：Node 端负责托管宠物资源文件，Browser 端负责渲染精灵图和提供交互页面。
核心功能¶
-
Agent 状态驱动动画
宠物会根据 Agent 的运行状态实时改变动作。支持的状态包括running（运行中）、waiting（等待确认）、review（审查中）、idle（空闲）以及failed（失败）。状态切换时，宠物会自动播放相应的帧动画。 -
Codex 兼容模型
宠物模型移植自 Codex 的源码，支持标准的精灵图格式。兼容 8x9 或 8x11 的网格精灵图。只要 Manifest 文件符合pet.json格式（包含id、spritesheetPath、animations等字段），即可直接使用。 -
多源资源管理
插件内置了来自 Codex CDN 的宠物资源，同时也支持在本地$DSH_HOME/pets目录下放置自定义宠物。 -
交互与详情展示
- 交互：点击宠物可触发交互轨道（如wave、bounce）；支持鼠标拖拽改变位置。
- 详情：悬停在宠物上会显示一个 Codex 风格的详情卡片，展示当前会话的最新用户提示、工具调用及助手输出摘要。 -
持久化设置
宠物的选择、尺寸选项以及拖拽偏移量会保存在浏览器的localStorage中，刷新页面后状态依然保留。
安装与启用¶
通过官方 CLI 安装插件。
dsh plugin add github:youzhoujiMrLiu/dsh-codex-compatible-pet
安装完成后，刷新 DeepSeek Harness 的 Web GUI 页面。宠物会默认出现在屏幕右下角。此时在设置页面中会出现“Pet”选项，用于管理宠物目录和导入自定义宠物。
典型用法¶
- 观察状态：在 Agent 运行或等待确认时，观察宠物对应的动作变化（如运行时奔跑、等待时站立）。
- 触发交互：点击宠物可播放挥手、弹跳等互动动画。
- 移动位置：按住鼠标左键拖拽宠物，可将其放置在屏幕任意位置。
- 导入宠物：在设置页面的宠物目录中，导入
.codex-pet格式的目录文件。
注意事项¶
- 纯展示插件：该插件不注册 Prompt、工具或 Schema，也不影响 KV Cache 的生成或向 Provider 发送请求，仅提供视觉展示。
- 状态来源：宠物的状态完全来源于 DSH 的会话列表。目前失败回合会回退到
idle或review动画，没有专门的失败动画。 - 内置资源下载：内置的 Codex 宠物在首次选择时需要从 CDN 下载资源，下载完成前不会显示。
- 卸载方式：卸载插件需要使用
dsh plugin remove命令，这会移除插件所在的层。
结语¶
dsh-codex-compatible-pet 为 DeepSeek Harness 提供了直观的 Agent 状态反馈。对于需要长时间观察智能体行为的开发者，它是一个实用的视觉辅助工具。
