deepseekplugins

DeepSeek Harness plugin

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 /

Workflow & Automation
Jump to install

Source facts

Repository
zenglihunter/dsh-petdex-pet
Latest update
Aug 19, 2026
Category
Workflow & Automation
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/zenglihunter/dsh-petdex-pet
Plugin: dsh-petdex-pet
Author: zenglihunter

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<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.json 的 name 改成自己的 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

Back to searchOpen GitHub repository

More related plugins

View category