前言¶
DeepSeek Harness（DSH）里的智能体任务经常不是一次问答就结束。开发者在等待长任务执行、审批确认、错误处理或代码审查时，需要一种更直观的方式知道当前 agent 正处于哪个阶段。
下面介绍 hellosz/dsh-pets。它是一个运行在 DSH Web GUI 中的 Cordis 插件，把 OpenAI Codex Pets 的宠物陪伴体验带进 DSH，用宠物的动画状态提示当前任务状态。
这是什么¶
hellosz/dsh-pets 由 hellosz 维护，许可证为 MIT。
它解决的问题是：在 DSH Web GUI 中，用宠物的行为状态代替单纯的进度提示，让使用者更容易看出 agent 正在思考、等待确认、待审查、出错或空闲。
核心功能¶
内置宠物¶
插件内置 10 只宠物：
- 皮卡丘
- 小火龙
- 妙蛙种子
- 杰尼龟
- 胖丁
- 伊布
- 梦幻
- 波加曼
- 木木枭
- 敲音猴
每只宠物有独立性格、台词和动画节奏。
状态动画¶
插件提供 9 个状态动画：
idle
running
waiting
review
failed
waving
jumping
running-left
running-right
这些状态用于表现 agent 当前所处阶段，而不是简单展示宠物形象。
浮动宠物¶
宠物会注册到 shell.overlay，在右下角常驻。
它支持以下操作：
- 拖拽
- 点击弹出菜单
- 一键隐藏
状态气泡和配置菜单会跟随宠物位置。
设置页¶
设置页入口为：
Settings → 宠物伙伴
在设置页中可以：
- 切换宠物
- 调整缩放滑块，范围是
0.6x–2.5x - 打开或关闭宠物功能
宠物包格式¶
插件支持 petdex 兼容宠物包格式：
pet.json
8×9 spritesheet
pet.json 包含：
{
"id": "",
"displayName": "",
"description": "",
"spritesheetPath": ""
}
spritesheet 为 8 列 × 9 行，每帧尺寸为 192×208。
对 DSH 流程的影响¶
插件只监听 DSH 现有事件，不阻塞、不篡改任何流程。
它还提供 pet_say 工具，并通过 webServer 暴露以下接口：
GET /pet/state
GET /pet/asset
安装与启用¶
前置条件¶
先确认本机满足以下条件：
- Node.js ≥ 22
- 已安装 DeepSeek Harness CLI
- 已安装
pnpm
dsh plugin 内部会调用 pnpm。如果没有启用，可以执行：
corepack enable
安装 DeepSeek Harness CLI：
npm install -g @deepseek-ai/dsh
安装插件¶
官方安装命令为：
dsh plugin --profile web add @hellosz/dsh-pets
安装完成后启动 DSH Web GUI：
dsh web
如果使用 npx 启动 dsh，则对应命令为：
npx @deepseek-ai/dsh plugin --profile web add @hellosz/dsh-pets
npx @deepseek-ai/dsh web
安装后验证¶
可以检查 web profile 配置中是否出现插件：
dsh --profile web --dump-config | grep -A2 'dsh-pets'
然后打开浏览器访问：
http://localhost:3080
安装成功且启用后，宠物会出现在页面右下角。
卸载插件¶
如需移除，执行：
dsh plugin --profile web remove @hellosz/dsh-pets
典型用法¶
使用设置页¶
进入：
Settings → 宠物伙伴
可以先切换一只内置宠物，再通过缩放滑块调整大小。缩放范围为：
0.6x–2.5x
如果暂时不需要宠物提示，可以在设置页关闭开关。
使用浮动宠物¶
宠物常驻在右下角。可以通过拖拽改变位置，也可以点击宠物弹出菜单，或选择一键隐藏。
使用接口¶
插件通过 webServer 暴露：
GET /pet/state
GET /pet/asset
pet_say 工具也可以用于宠物相关交互。
重新生成宠物包¶
如果需要重新生成宠物包，可以执行：
node scripts/generate-packs.js
该脚本依赖 ImageMagick 6+。
依赖与素材来源¶
插件的 peerDependencies 包括：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "*",
"react": "^18.2.0 || ^19.0.0"
}
素材来源包括：
- PokeAPI/sprites
- Pokemon Showdown 动画精灵
- petdex 格式规范
许可证为 MIT。
适用场景与注意¶
这个插件适合正在使用 DSH Web GUI，并且希望在长任务中用动画状态辅助判断 agent 当前状态的开发者。
使用插件前，建议先检查源码与许可证。插件会以当前 dsh 进程权限运行，安装前应确认它符合本地使用要求。
链接¶
目录页：
https://www.skillhub.cn/plugins/hellosz/dsh-pets
GitHub 仓库：
https://github.com/hellosz/dsh-pets
