c-ling/dsh-plugin-pet
30最近提交 2026年8月15日
dsh-plugin-pet DSH 插件
该插件在 DeepSeek Harness Web GUI 右下角添加一个桌面宠物，其心情根据 agent 的实时状态（思考、工作、报错、等待等）变化。支持内置 SVG 形象、自定义图片上传和 Codex 风格精灵图导入。所有配置都会跨会话持久化保存。
如何安装 dsh-plugin-pet DSH 插件
dsh plugin --profile web add "github:c-ling/dsh-plugin-pet#v1.0.3复制不会执行命令。安装 dsh-plugin-pet DSH 插件前请核对仓库和版本。
dsh-plugin-pet DSH 插件数据来源
dsh-plugin-pet DSH 插件快照日期：2026年8月16日
discovered
dsh-plugin-pet DSH 插件能做什么
- 6 个内置 SVG 形象（blob / cat / duck / robot / axolotl / ghost），纯 CSS 动画
- 自定义图片上传（PNG / JPEG / GIF / WebP），动图原样播放
- Codex 风格精灵图导入（V1 1536×1872，V2 1536×2288），自动检测版本
- 通用网格精灵图支持，可配置列数、行数、fps 和心情行映射
- 实时心情动画，由 agent 会话状态驱动（空闲、思考、工作中、难过、等待、抚摸）
- 拖拽重新定位、单击抚摸、双击隐藏、爪印按钮重新显示
- HTTP API 用于读取、上传和删除图片及精灵图
- 通过 GUI 设置面板访问宠物配置
dsh-plugin-pet DSH 插件适合哪些场景
- 在开发 DeepSeek Harness Web GUI 时添加一个有趣的陪伴伙伴
- 通过宠物心情直观地了解 agent 状态（如思考、工作中、出错），无需查看日志
- 使用个人图片或 Codex 风格精灵图定制宠物，用于团队展示或品牌宣传
- 在演示或展示 DeepSeek Harness 时作为装饰元素
dsh-plugin-pet DSH 插件适合谁
- 使用 DeepSeek Harness Web GUI 的开发者，希望拥有有趣且信息丰富的 UI 元素
- 喜欢在开发环境中使用桌面宠物或虚拟伴侣的用户
dsh-plugin-pet DSH 插件的限制
- 每页只有一个全局宠物（根作用域浮层），不按会话区分
- 宠物位置存储在浏览器 localStorage 中，不跨设备同步
- 激活插件需要重启 `dsh web` 宿主进程
- 未实现 Codex「尾部空帧」自动检测，帧数来自规格默认值或手动配置
dsh-plugin-pet DSH 插件的仓库 README 摘录
以下文字摘自 dsh-plugin-pet DSH 插件的上游仓库 c-ling/dsh-plugin-pet 的 README，版权归原作者，仅作引用。
DeepSeek Harness Web GUI 的桌面电子宠物插件：由实时 agent 状态驱动心情动画，支持内置形象、自定义图片与 Codex 风格多帧精灵图导入。 [English](README-en.md) [](https://github.com/topics/dsh-plugin) [](LICENSE) 一个为 **DeepSeek Harness Web GUI** 打造的桌面电子宠物插件，灵感来自 Codex companion 与 Claude Code Buddy。宠物常驻页面右下角，实时响应 agent 的状态（思考 / 调用工具 / 报错 / 完成 / 等待你操作），并支持改名、缩放、隐藏与完全换肤： - **6 个内置形象**（blob / cat / duck / robot / axolotl / ghost，内联 SVG，纯 CSS 动画） - **自定义图片上传**（PNG / JPEG / GIF / WebP；动图会原样播放） - **Codex 风格多帧精灵图**——导入 Codex 宠物包（`pet.json` + `spritesheet.webp`，V1 1536×1872 与 V2 1536×2288，见 [Codex pet package spec](https://codexpet.xyz/spec/)）， 或配置通用网格（列数 / 行数 / fps / 各心情状态行） 所有状态都保存在 `$DSH_HOME/storages/dsh-plugin-pet/` 下，重启 `dsh web` 后仍然保留。 ## 结构 | 文件 | 作用 | | --- | --- | | `lib/index.js` | 宿主插件：宠物持久化 + 挂在 harness `webServer` 服务上的 HTTP 路由 | | `lib/client.js` | 浏览器 bundle（手写 factory-CJS，无构建步骤）：宠物浮层与设置面板 | | `test/` | `node --test` 测试套件，覆盖宿主路由与零依赖图片嗅探器 | 本包是双面插件：宿主半边是普通 Cordis 插件；客户端半边通过 `"dsh": { "client": { "platform": "web", "inject": [], "immediately": true } }` 加 `"./client"` 导出声明，因此 harness 的 cl
阅读完整 README仓库许可: MIT
dsh-plugin-pet DSH 插件常见问题
如何安装 dsh-plugin-pet？
运行 `dsh plugin --profile web add "github:c-ling/dsh-plugin-pet#v1.0.3"` 命令。如果 `pnpm` 不在路径中，可以先进入 `~/.dsh/profiles/web` 目录，然后使用 `corepack pnpm add "github:c-ling/dsh-plugin-pet#v1.0.3"`。安装后需要在 `cordis.patch.yml` 中添加插件加载行，并重启 `dsh web`。
可以使用自己的图片作为宠物形象吗？
可以。支持上传 PNG、JPEG、GIF 或 WebP 格式的图片，动图会原样播放。图片上传后存储在服务器中，并在宠物浮层中显示。你可以通过设置面板或 HTTP API（`POST /dsh-plugin-pet/image`）上传图片。
如何导入 Codex 宠物精灵图？
进入设置 → 宠物 → 精灵图 → 导入 Codex 宠物包。先上传精灵图文件（V1 必须是 1536×1872，V2 必须是 1536×2288），然后可选上传 `pet.json` 文件，它会应用显示名称并校验版本。心情到行的映射是预定义的。
重启 Web GUI 后宠物配置会丢失吗？
不会。所有配置和上传的图片/精灵图都保存在 `$DSH_HOME/storages/dsh-plugin-pet/` 目录下，重启 `dsh web` 后仍然保留。但宠物位置存储在浏览器 localStorage 中，因此不会跨设备同步。
宠物有哪些心情状态？如何触发？
宠物有：空闲、思考、工作中（显示工具名称气泡）、完成时跳跃、出错时难过、等待用户操作、被抚摸时冒爱心。这些状态由 agent 会话实时驱动。