返回目錄

petdex

維護狀態: 活躍

crafter-station/petdex

面向 Codex、Claude Code、DeepSeek Harness 等智慧體的動效寵物公共相簿。

前往 GitHub專案首頁
$ npx petdex install <slug>

4,374

星數

218

Fork

TypeScript

語言

MIT

授權條款

2026-05-02

建立於

2026-11-19

最近推送

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

安裝步驟

  1. 01

    Install a known pet: `npx petdex install <slug>` (README example: `npx petdex install boba`)

    $ npx petdex install <slug>

  2. 02

    Get the desktop app from petdex.dev/download (macOS, Linux and Windows)

  3. 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 整合程度與能力邊界

DSH 整合相容

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 network
  • Desktop 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:7777
  • Pet 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.
2026-05-022026-08-19desktop-v0.8.0

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。

dsh-web

作者 zhu1090093659

DeepSeek Harness (DSH) Web 外掛聚合生態 · 萬物皆外掛,通過創意工坊分發||DeepSeek Harness (DSH) Web Plugin Aggregation Ecosystem · Everything is a plugin, distributed via the Creative Workshop

精選已評估Web 介面與前端TypeScript
10.6K648

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 三平臺原生(同一個包、同一條命令)。

精選已評估Web 介面與前端JavaScript
7,696122

dsh-deep-whale

作者 small-tailqwq

Whale Girl skin series for DeepSeek Harness. 適用於 DeepSeek Harness 的,鯨魚娘系列皮膚。

精選已評估Web 介面與前端TypeScript
3,129103

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)

精選已評估Web 介面與前端JavaScript
3,090133

08資料與來源

  • 自動推斷github.com310004f0fa30…

    Pick your pet under **Pets**, and connect your coding agents under **Agents** with one click each. No terminal involved.

  • 自動推斷github.com310004f0fa30…

    Codex and the supported coding agents map their activity hooks to these states.

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-08-21。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。