DeepSeek Harness 插件

dsh-petdex-pet

Petdex pet in the DSH web GUI: floating bottom-right, draggable, sprite-animated by agent activity, with a live settings page (size / enable / switch / delete / gallery search + previews /(英文原文)

跳到安装方式

来源信息

GitHub 仓库
zenglihunter/dsh-petdex-pet
最近更新
2026年8月19日
分类
自动化与任务
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/zenglihunter/dsh-petdex-pet
插件名:dsh-petdex-pet
作者:zenglihunter

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

<p align="center"> <img src="img/banner.jpg" alt="dsh-petdex-pet · Pixel Adventure: Hunter × Hunter & DeepSeek"> </p>

📖 English documentation: README_EN.md

dsh-petdex-pet

Petdex 桌面宠物带进 DeepSeek Harness Web 界面: 右下角悬浮、可拖拽,跟随 DSH 的智能体活动实时切换精灵动画(空闲 / 奔跑 / 跳跃 / 挥手 / 失败 / 等待批准…), 带完整的设置页和互动。

纯浏览器端渲染,无需安装 Petdex 桌面端;宠物数据读取 ~/.petdex/pets/,与桌面端兼容共享。

![dsh-petdex-pet 主界面 - 宠物菜单可预览 4 个默认猎人主角](img/screenshot.png)

更多界面截图:

宠物菜单一键安装 & 在线获取宠物
![宠物菜单](img/menu.png)![一键安装和在线获取宠物](img/install.png)

内置宠物(开箱即用)

插件自带 4 个全职猎人主角宠物包(Gon 小杰 / Killua 奇犽 / Kurapika 酷拉皮卡 / Leorio 雷欧力,含精灵图与 pet.json)。 安装并重启 DSH 后,插件首次激活会自动把它们播种~/.petdex/pets/——新电脑装上插件就有宠物可用,不用再去图库一个个添加。

  • 播种是每只一次的(由 ~/.petdex/.dsh-petdex-bundled.json 标记文件记录);
  • 如果目标机器上已经有同名宠物,不会覆盖(保留已有文件);
  • 用户手动删除某只内置宠物后,不会复活(尊重删除操作)。

> ⚠️ 开源再分发提示:内置精灵图来自 Petdex 社区图库,公开发布前请确认其素材授权条款,并在项目说明中注明素材来源与致谢(见「致谢」)。

功能一览

  • 🐾 右下角悬浮宠物:可拖拽、点击展开菜单;状态栏随 DSH 活动同步(工具调用、任务完成、等待批准、失败等),同一状态持续 5 秒自动隐藏。
  • ✨ 互动动画:鼠标悬停随机挥手或「思考」问候;奔跑时自动轮播左右跑方向。
  • ⚙️ 设置 → 宠物(独立设置页):

- 调整宠物大小(40%–150%)与启用/关闭 - 我的宠物:缩略图列表、一键切换、🗑 删除 - 图库:搜索(名称/类型)、精灵图预览、总数显示、加载更多 - 按安装代码一键安装:粘贴 npx petdex@latest install doraemon、宠物链接或 slug 即可安装 - 状态预览:全部 9 种动作逐行动画展示

  • 🔌 与 DSH 深度集成:任务开始(跳跃)、执行中(奔跑)、完成(挥手)、失败、等待批准(等待)…

精灵状态(9 行精灵图)

状态精灵图行触发时机
空闲 idle0无活动时
向右跑 running-right1奔跑时轮播
向左跑 running-left2奔跑时轮播
挥手 waving3任务完成 / 悬停互动(随机)
跳跃 jumping4开始执行任务
失败 failed5任务失败
等待 waiting6等待批准 / 被阻塞
奔跑 running7工具调用、工作流、步骤执行
思考 review8悬停互动随机展示(暂无 DSH 事件映射)

安装(DSH web profile)

本插件仅适用于 DeepSeek Harness(DSH),需装进 DSH 的 web profile(默认 C:\Users\<你>\.dsh\profiles\web\)。

从 GitHub 安装(推荐,一键式)

1. 打开 web profile 目录,编辑 package.json: - dependencies 增加: ``json "@dsh-external/dsh-petdex-pet": "github:zenglihunter/dsh-petdex-pet" ` - dsh.profile.bundles 数组末尾增加 "@dsh-external/dsh-petdex-pet"; 2. 在该目录运行 pnpm install(或 npm install`); 3. 重启 DSH。设置页出现「宠物」项,右下角出现宠物。

> cordis.patch.yml 会由 DSH 自动组合(dsh.bundle.patch),无需手动改 profile 的 cordis.patch.yml

其他方式(可选)

  • 本地 tgz:在插件目录 npm pack 生成 dsh-external-dsh-petdex-pet-<version>.tgz,拷到 profile 目录,依赖写 "@dsh-external/dsh-petdex-pet": "file:./xxx.tgz"
  • npm 发布:把 package.jsonname 改成自己的 scope,再 npm publish,目标机器直接依赖包名即可。

数据与兼容

  • 宠物文件在 ~/.petdex/pets/<slug>/pet.json + spritesheet.webp|png),与 Petdex 桌面端共用;
  • 图库 manifest 来自 https://petdex.dev/api/manifest(5 分钟缓存),预览图走插件内网代理(/petdex-pet/preview/<slug>),避免浏览器外链被拦;
  • 安装宠物走插件内置下载器,不需要执行 npx petdex

开发

  • lib/index.js — DSH 服务端半部:路由(状态/宠物/图库/安装/删除/预览代理/SSE)、会话事件 → 宠物状态机、设置持久化(owner 侧 settings scope);
  • lib/client.js — 浏览器端 bundle(__ModuleLoader__ 格式):悬浮宠物渲染/动画/拖拽/悬停、设置 → 宠物页面(slots 注册 settings.section)。

> 注意:客户端改动走 DSH 的 client HMR(stat-poll + SSE),改 lib/client.js 保存即热更新;改 lib/index.js 需要重启 DSH 生效。

致谢

  • Petdex — 宠物精灵图、状态定义与图库;内置猎人宠物为 Petdex 社区作者提交的高质量 Codex 素材(Gon / Killua / Kurapika / Leorio)
  • DeepSeek Harness 插件体系(client bundle / settings / slots)

License

MIT