前言¶
在 DeepSeek Harness（DSH）的开发与调试过程中，会话的状态变化通常隐含在文本流和终端输出中。dsh-pets 插件旨在将 Codex Pets 的桌面宠物概念引入网页界面，通过一个透明、可拖动的悬浮层，将当前会话的“思考”、“工作”、“完成”等状态投影为可视化的动画，帮助开发者更直观地监控智能体的运行节奏。
插件简介¶
这是一个由 eivmosn 维护的客户端插件，采用 MIT 开源协议。它不涉及模型推理或提示词生成，仅作为前端展示组件，负责渲染本地 pets 目录中的精灵图，并根据 DSH 的会话状态驱动动画播放。
核心功能¶
- 透明悬浮与拖动：宠物以透明背景渲染，可拖动至视口内任意位置，位置会自动持久化保存。
- 状态映射：根据 Codex Pets 的标准格式（V1/V2 精灵图），映射以下状态：
- 思考中：显示
waiting动画。 - 工作中：轮播
running、review、running-right动画。 - 完成状态：挥手动画。
- 阻塞/失败：对应失败动画。
- 空闲状态：轮播小动作。
- 思考中：显示
- 状态气泡与芯片：宠物上方显示白色气泡（如“思考中”、“正在 {task}”），下方显示当前会话的 agent preset 芯片。
- 设置分区：提供专门的设置页面，支持从本地
pets目录选择宠物形象，并覆盖气泡文案。
典型用法¶
- 获取宠物形象：访问 codex-pets.net 发现并下载宠物包。
- 安装宠物：在终端执行命令将宠物添加到本地目录。
npx codex-pets add <pet-id>
- 重启服务：安装完成后需要重启 DSH 服务，插件才会读取到新的宠物资源。
- 启用与配置：在 DSH 网页界面的导航栏找到“宠物”设置分区，点击选中一只已安装的宠物即可生效。
技术实现与限制¶
- 无干扰机制：插件仅将会话快照投影为悬浮层，不产生提示词内容，也不写入任何会话事件，不会影响 AI 模型的思考过程。
- 性能影响：无 KV Cache 影响。
- 资源依赖：完全兼容 codex-pets 的 V1/V2 精灵图格式，无需额外配置即可离线渲染。
注意事项¶
- 本插件为客户端组件，运行在浏览器端。
- 使用前建议检查源码（GitHub）与许可证，确保符合你的使用场景。
总结¶
dsh-pets 为 DSH 提供了可视化的状态反馈机制。如果你需要通过直观的动画来观察智能体的工作流，或希望定制专属的桌面宠物，该插件是一个轻量且无侵入性的选择。
- 项目地址：eivmosn/dsh-pets
- 目录页：dsh-pets - SkillHub
