DeepSeek Harness（DSH）的 Web profile 是智能体开发和调试的主要环境。在长时间的运行过程中，界面除了文字反馈外，往往缺乏可视化的动态元素。DSH 的插件体系支持扩展前端渲染能力，这款插件正是利用这一机制，将 Petdex 桌面宠物的视觉与交互功能引入 DSH 的 Web 界面。
插件简介¶
dsh-petdex-pet 是一款由 zenglihunter 维护的客户端插件。它将 Petdex 桌面宠物带进 DeepSeek Harness Web 界面，通过纯浏览器端渲染实现可视化陪伴。
核心功能¶
这款插件提供了以下具体功能：
- 右下角悬浮交互：宠物以悬浮形式出现在右下角，支持拖拽。点击可展开菜单，状态栏会根据 DSH 的活动实时切换（空闲、奔跑、跳跃、挥手、失败、等待批准等）。
- 行为动画：鼠标悬停时，宠物会随机挥手或进行「思考」问候；在奔跑状态下，会自动轮播左右跑方向。
- 设置与配置：提供独立的宠物设置页，支持调整宠物大小（40%–150%）、启用或关闭宠物、管理「我的宠物」列表、图库搜索预览。
- 一键安装：支持通过安装代码（如
npx petdex@latest install doraemon）或宠物链接/slug 一键安装新宠物。 - DSH 状态同步：宠物状态与 DSH 任务深度绑定，例如任务开始时跳跃、执行中奔跑、完成后挥手、失败或等待批准时显示对应动画。
- 开箱即用：内置 4 个全职猎人主角宠物包（Gon 小杰 / Killua 奇犽 / Kurapika 酷拉皮卡 / Leorio 雷欧力），包含精灵图与配置文件。
- 无桌面依赖：纯浏览器端渲染，不需要安装 Petdex 桌面端程序。
安装与启用¶
本插件仅适用于 DeepSeek Harness（DSH）的 web profile（默认路径 C:\Users\<你>\.dsh\profiles\web\）。
- 打开 DSH web profile 的目录，编辑
package.json文件。 - 在
dependencies中添加：
"@dsh-external/dsh-petdex-pet": "github:zenglihunter/dsh-petdex-pet"
- 在
dsh.profile.bundles数组末尾添加：
"@dsh-external/dsh-petdex-pet"
- 在该目录运行
pnpm install（或npm install）。 - 重启 DSH。设置页会出现「宠物」选项，右下角将显示宠物。
使用示例¶
安装并重启 DSH 后，插件会自动将内置的 4 个猎人宠物播种到 ~/.petdex/pets/ 目录（由 ~/.petdex/.dsh-petdex-bundled.json 标记，仅执行一次）。
若需安装外部宠物，可在设置页或命令行使用安装代码。例如，在终端中执行以下命令即可安装一只名为 doraemon 的宠物：
npx petdex@latest install doraemon
适用场景与注意事项¶
- 权限与范围：插件以 DSH 进程权限运行，需确保 DSH web profile 目录有写入权限。
- 文件共享：宠物文件存储在
~/.petdex/pets/<slug>/目录下，包含pet.json和精灵图文件（pet.spritesheet.webp或png），与 Petdex 桌面端共享。 - 内置宠物行为：如果目标机器上已存在同名宠物，内置宠物不会覆盖；用户手动删除后，内置宠物也不会复活。
- 开源再分发：内置的精灵图素材来源于 Petdex 社区图库。如需开源再分发，请务必确认素材授权条款，并在说明中注明来源与致谢。
总结¶
通过 dsh-petdex-pet，DSH 用户可以在 Web 界面获得与桌面端类似的宠物陪伴与状态反馈。如果你正在寻找一种方式让 DSH 的运行状态更加生动，可以访问 目录页 或 GitHub 仓库 获取更多信息。
