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) Web 外掛聚合生態 · 萬物皆外掛,通過創意工坊分發||DeepSeek Harness (DSH) Web Plugin Aggregation Ecosystem · Everything is a plugin, distributed via the Creative Workshop
dsh-wallpaper-engine
作者 elysia395
把本機 Wallpaper Engine 的桌布搬進 DSH 網頁介面:場景桌布由內建 MIT 開源引擎 WebWallGL 即時 WebGL 渲染(粒子 / puppet 骨骼 / SceneScript / 音訊反應 / 滑鼠互動),失敗自動降級內嵌 MP4 與場景靜態幀;Web 桌布嚴格沙箱 + WE API;iOS 風格液態玻璃 UI 高度自定義,遮擋暫停省電、ffmpeg 幀率上限轉碼、系統音訊頻譜與 Now Playing、自定義上傳與自動輪播;設定存宿主端,對 agent 零 token 開銷。Windows / macOS / Linux 三平臺原生(同一個包、同一條命令)。
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 適用於 DeepSeek Harness 的,鯨魚娘系列皮膚。
dsh-pocket
作者 shaobeichen
把 DeepSeek Harness 裝進你的口袋:電腦上跑 dsh web,手機掃碼即同步訪問(區域網 + 公網,即時同屏)Put DeepSeek Harness in your pocket: run dsh web on your computer and access it synchronously by scanning a QR code on your phone (LAN + public network, real‑time screen mirroring)
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 個值得優先安裝的外掛,涵蓋各個分類。
