MIT 许可的宠物画廊、CLI 与桌面应用：用 `npx petdex install` 一键安装动画宠物，再在桌面应用中一键连接编码代理，让宠物对每次工具调用做出反应。
DSH 适配
兼容
自动推断
安全审计
未审计
最后核验
2026-08-21
许可证
MIT
01它能帮你完成什么？
Add an animated desktop pet that reacts to your coding agent's activity while you work with DeepSeek Harness
A pet floating above your workspace that animates on every tool call your agent makes, driven by activity hooks mapped to nine animation states
Developers running DeepSeek Harness (dsh) or other coding agents who want playful real-time visual feedback of agent activity
Browse, install and switch animated pets from the community gallery
Pet folders under ~/.petdex/pets/<slug>/ (pet.json + spritesheet) installed with one npx command; the active mascot is switched from the desktop app Settings
Coding-agent users who want to pick, install or switch community mascots without manual setup
02如何接入 DeepSeek Harness？
前置条件
- An npx-capable Node.js environment on PATH (the CLI is invoked as `npx petdex`)
- The desktop app downloaded from petdex.dev/download — it runs on macOS, Linux and Windows
安装步骤
- 01
Install a known pet: `npx petdex install <slug>` (README example: `npx petdex install boba`)
$ npx petdex install <slug>
- 02
Get the desktop app from petdex.dev/download (macOS, Linux and Windows)
- 03
Open it, press Cmd+, over the pet to open Settings, pick your pet under Pets, and connect your coding agents under Agents with one click each
验证接入成功
- After `npx petdex install boba`, you should see `~/.petdex/pets/boba/` with `pet.json` and a spritesheet
03DSH 适配与能力边界
Standalone CLI + desktop mascot that floats an animated pet over your workspace and reacts to coding-agent activity via activity hooks; DeepSeek Harness is listed as a supported agent in the repo metadata/topics, while the README documents a generic one-click agent connection (dsh is not named in the README itself)
One-command pet install from the public gallery
a pet slug from the petdex.dev gallery→a pet folder at ~/.petdex/pets/<slug>/ containing pet.json and a spritesheet
writes pet files to ~/.petdex/pets on your machinedownloads pet assets from petdex.dev over the networkDesktop floater reacting to coding-agent activity
coding-agent activity hooks→a floating pet animating across nine state rows: idle, running-right, running-left, waving, jumping, failed, waiting, running and review
the desktop app runs an in-process Zig hook server bound to 127.0.0.1:7777Pet submission to the community gallery
a local pet folder (pet.json + spritesheet)→a submission reviewed and published to the petdex.dev gallery (`npx petdex submit ./my-pet/` or the web submitter)
authenticates via Clerk OAuth + PKCEuploads pet assets to cloud storage (zip → presigned R2)
04适合谁？何时不该用？
适合
- Developers running DeepSeek Harness (dsh) or other coding agents who want playful real-time visual feedback of agent activity
- Coding-agent users who want to pick, install or switch community mascots without manual setup
不适合
- Installing and submitting pets requires network access to petdex.dev — the manifest API serves every approved pet, submissions authenticate via Clerk OAuth + PKCE and upload assets to cloud storage — so offline use is not supported.
05兼容性、维护与安全提示
- Installing and submitting pets requires network access to petdex.dev — the manifest API serves every approved pet, submissions authenticate via Clerk OAuth + PKCE and upload assets to cloud storage — so offline use is not supported.
- The floater experience requires the separate desktop app (macOS, Linux, Windows); the CLI alone only installs pet files, and the quick-start flow is centered on Codex, with other agents connected generically via the app's Agents settings.
- The README does not name DeepSeek Harness explicitly; DSH support is indicated by the repository's description ('for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more') and its dsh-plugin topic, while the README only documents a generic agent-hook connection.
MIT · actively maintained (latest release desktop-v0.8.0, 2026-08-14)
06常见问题
Petdex 如何与 DeepSeek Harness 集成？
README 描述的是通用代理连接方式：打开桌面应用的设置（Cmd+,），在 Pets 中选择宠物，再在 Agents 中逐个一键连接你的编码代理。之后宠物会悬浮在工作区上方，对代理的每次工具调用做出动画。DeepSeek Harness 出现在该项目的描述和 topics 的支持代理列表中，但 README 主要围绕 Codex 及受支持代理的活动钩子来描述。
Petdex 是 DeepSeek Harness 原生插件还是 MCP 工具？
两者都不是。Petdex 是独立的 CLI 加桌面应用：桌面应用内置运行在 127.0.0.1:7777 的 Zig 钩子服务（没有 WebView 或 Node 边车进程），编码代理将活动钩子映射到九种动画状态，全程不涉及 MCP 服务器。
安装前需要什么前置条件？
需要支持 npx 的 Node.js 环境来运行 CLI，以及从 petdex.dev/download 下载的桌面应用，支持 macOS、Linux 和 Windows。
宠物安装在哪里？如何验证安装成功？
`npx petdex install <slug>` 会把每只宠物写入 ~/.petdex/pets/<slug>/。README 的示例说明：执行 `npx petdex install boba` 后，应能看到 ~/.petdex/pets/boba/ 目录，其中包含 pet.json 和精灵图（spritesheet）。
我的数据会流向哪里？
宠物目录通过 petdex.dev 的公开 manifest API 获取；提交宠物时会通过 Clerk OAuth + PKCE 认证，并经由预签名 R2 端点上传宠物压缩包；本地钩子服务只监听 127.0.0.1。
07相关的 DSH 工作流
dsh-web
作者 zhu1090093659
DeepSeek Harness（dsh）插件聚合生态，万物皆插件，通过创意工坊分发。
j-space-cognition-suite-v3.7
作者 tiger3807861189
J-Space Cognition Suite V3.7 - AI cognitive-enhancement Skills based on Anthropic's J-space global workspace research. | 哔哩哔哩：Tiger380 (UID 3494375382321675) — https://space.bilibili.com/3494375382321675
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 适用于 DeepSeek Harness 的，鲸鱼娘系列皮肤。
deepseek-balance-whale-widget
作者 meteornox
DeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着DeepSeek账户余额。QQ弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的dsh安装
08数据与来源
Pick your pet under **Pets**, and connect your coding agents under **Agents** with one click each. No terminal involved.
Codex and the supported coding agents map their activity hooks to these states.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-21。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。