skr311/dsh-codex-pet
50最近提交 2026年8月14日
dsh-codex-pet DSH 插件
dsh-codex-pet 为 DSH Web GUI 添加桌面宠物。支持序列帧播放、拖拽交互、点击挥手，并与 DSH Agent 状态联动自动切换动画。宠物浮层常驻右下角，可通过设置页面管理图库。
如何安装 dsh-codex-pet DSH 插件
dsh plugin --profile web add dsh-codex-pet复制不会执行命令。安装 dsh-codex-pet DSH 插件前请核对仓库和版本。
dsh-codex-pet DSH 插件数据来源
dsh-codex-pet DSH 插件快照日期：2026年8月16日
discovered
dsh-codex-pet DSH 插件能做什么
- 播放精灵图序列帧（单 WebP 图，行分别对应 idle、running、waiting、review、failed、移动、挥手、跳跃动画）。
- 悬浮浮层，可拖拽（视口钳制 + 位置持久化），点击挥手，空闲时随机小动作。
- 图库管理：zip 上传 / URL 导入 / 启用 / 停用 / 删除 / 首帧预览。
- Agent 状态联动：工作中→跑动（常驻）；审批/提问→等待（脉冲）；任务完成→得意（脉冲）；任务失败→沮丧（脉冲）。
- 自动适配深/浅主题（通过 --dsw-* 主题令牌）。
dsh-codex-pet DSH 插件适合哪些场景
- 为 DSH Web 界面增加趣味性，显示桌面宠物。
- 通过宠物动画直观了解 Agent 当前工作状态，无需查看主界面。
- 上传或导入自定义精灵图，个性化 DSH 界面。
- 当 Agent 等待用户输入时，宠物作为微妙的提示信号。
- 为 DSH 增添复古风格的游戏宠物体验。
dsh-codex-pet DSH 插件适合谁
- 希望界面更活泼、更有交互感的 DSH 用户。
- 喜欢桌面宠物或虚拟角色互动的开发者。
dsh-codex-pet DSH 插件的限制
- 仅支持资产规范中描述的特定 WebP 精灵图格式（格式 A）。
- 需要 DSH Web GUI 环境，且宿主半改动后需要重启才能生效。
- 仓库不附带示例精灵图，用户需自行提供或生成。
- 测试脚本使用运行时合成的 WebP，并非真实精灵图。
dsh-codex-pet DSH 插件的仓库 README 摘录
以下文字摘自 dsh-codex-pet DSH 插件的上游仓库 skr311/dsh-codex-pet 的 README，版权归原作者，仅作引用。
DeepSeek Harness（DSH）桌面宠物插件：导入/上传 codex 风格的**精灵图序列帧宠物**，在 DSH Web GUI 以 `shell.overlay` 悬浮浮层渲染，含图库管理、基础交互与 Agent 状态联动。 [](https://awesome-dsh-plugin.com) [](https://www.npmjs.com/package/dsh-codex-pet) [](LICENSE) ## 📸 预览 <!-- 截图占位 ①：WebUI 页 —— 宠物浮层显示在 DSH Web GUI 右下角（放一张 1280×800 截图） -->  <!-- 截图占位 ②：设置页 —— 宠物图库（列表 / 上传 / 启用 / 停用 / 删除 / URL 导入） -->  ## ✨ 核心特性 - **序列帧播放**：单 WebP 精灵图（格式 A），逐帧毫秒时长，行=动画（idle / running / waiting / review / failed / 移动 / 挥手 / 跳跃）。 - **悬浮浮层交互**：右下角常驻，可拖拽（视口钳制 + 位置持久化）、点击挥手、空闲随机小动作。 - **图库管理**：设置 → 宠物图库——zip 上传 / URL 导入 / 启用 / 停用 / 删除 / 首帧预览。 - **Agent 状态联动**：订阅 DSH 会话状态——工作中→跑动（常驻）；审批/提问→等待（脉冲一次）；任务完成→得意（脉冲一次）；任务失败→沮丧（脉冲一次）。 - **深/浅主题**：全部样式走 `--dsw-*` 主题令牌，自动适配 DSH 主题。 ## 🎮 操作指南 1. 打开 DSH Web GUI（默认 http://127.0.0.1:3080）。 2. **设置 → 宠物图库** → 上传/导入宠物 zip（或从 URL 导入）→ 点「启用」。 3. 右下角出现宠物浮层： - **拖拽**：按住移动，松手后位置自动保存。 - **点击**：宠物挥手。 - **Agent 联动**：Agent 干活时宠物跑动；等你
阅读完整 README仓库许可: MIT
dsh-codex-pet DSH 插件常见问题
如何安装 dsh-codex-pet？
在终端中执行命令 `dsh plugin --profile web add dsh-codex-pet`。安装完成后，需要重启 DSH Web GUI（宿主半改动需要重启），然后刷新页面即可。也可以克隆仓库后使用本地路径安装。
安装后宠物没有显示，怎么办？
首先确认已重启 DSH Web GUI。然后进入设置 → 宠物图库，上传或导入宠物精灵图（zip 文件或 URL），并点击「启用」激活宠物。如果仍未显示，请检查浏览器控制台是否有错误，或确认精灵图格式是否符合规范（单 WebP 图，每行对应一种动画）。
我可以使用自己的精灵图吗？
可以，通过设置 → 宠物图库页面上传你自己的精灵图。精灵图必须是单张 WebP 图片，行对应支持的动画：idle、running、waiting、review、failed、move、wave、jump。每行包含等时长的帧。具体格式要求请参考资产规范文档（docs/asset-spec.md）。
宠物会与 DSH Agent 的状态联动吗？
是的，宠物会订阅 DSH 会话状态变化。当 Agent 工作时，宠物会跑动；当等待用户输入（审批/提问）时，宠物会发呆一次；任务完成时，宠物会得意一次；任务失败时，宠物会沮丧一次。无需额外配置即可看到这些效果。
如何禁用或移除宠物？
进入设置 → 宠物图库，点击当前激活宠物的「停用」按钮，即可隐藏浮层。要完全移除插件，可以执行 `dsh plugin --profile web remove dsh-codex-pet`，然后重启 DSH Web GUI。