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 sidecar 處理程序），編碼代理將活動掛鉤對應到九種動畫狀態，全程不涉及 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 個值得優先安裝的外掛，涵蓋各個分類。