前言¶

DeepSeek Harness（DSH）裏的智能體任務經常不是一次問答就結束。開發者在等待長任務執行、審批確認、錯誤處理或代碼審查時，需要一種更直觀的方式知道當前 agent 正處於哪個階段。

下面介紹 hellosz/dsh-pets。它是一個運行在 DSH Web GUI 中的 Cordis 插件，把 OpenAI Codex Pets 的寵物陪伴體驗帶進 DSH，用寵物的動畫狀態提示當前任務狀態。

這是什麼¶

hellosz/dsh-pets 由 hellosz 維護，許可證爲 MIT。

它解決的問題是：在 DSH Web GUI 中，用寵物的行爲狀態代替單純的進度提示，讓使用者更容易看出 agent 正在思考、等待確認、待審查、出錯或空閒。

核心功能¶

內置寵物¶

插件內置 10 只寵物：

• 皮卡丘
• 小火龍
• 妙蛙種子
• 傑尼龜
• 胖丁
• 伊布
• 夢幻
• 波加曼
• 木木梟
• 敲音猴

每隻寵物有獨立性格、臺詞和動畫節奏。

狀態動畫¶

插件提供 9 個狀態動畫：

idle
running
waiting
review
failed
waving
jumping
running-left
running-right

這些狀態用於表現 agent 當前所處階段，而不是簡單展示寵物形象。

浮動寵物¶

寵物會註冊到 shell.overlay，在右下角常駐。

它支持以下操作：

• 拖拽
• 點擊彈出菜單
• 一鍵隱藏

狀態氣泡和配置菜單會跟隨寵物位置。

設置頁¶

設置頁入口爲：

Settings → 寵物夥伴

在設置頁中可以：

• 切換寵物
• 調整縮放滑塊，範圍是 0.6x–2.5x
• 打開或關閉寵物功能

寵物包格式¶

插件支持 petdex 兼容寵物包格式：

pet.json
8×9 spritesheet

pet.json 包含：

{
  "id": "",
  "displayName": "",
  "description": "",
  "spritesheetPath": ""
}

spritesheet 爲 8 列 × 9 行，每幀尺寸爲 192×208。

對 DSH 流程的影響¶

插件只監聽 DSH 現有事件，不阻塞、不篡改任何流程。

它還提供 pet_say 工具，並通過 webServer 暴露以下接口：

GET /pet/state
GET /pet/asset

安裝與啓用¶

前置條件¶

先確認本機滿足以下條件：

• Node.js ≥ 22
• 已安裝 DeepSeek Harness CLI
• 已安裝 pnpm

dsh plugin 內部會調用 pnpm。如果沒有啓用，可以執行：

corepack enable

安裝 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh

安裝插件¶

官方安裝命令爲：

dsh plugin --profile web add @hellosz/dsh-pets

安裝完成後啓動 DSH Web GUI：

dsh web

如果使用 npx 啓動 dsh，則對應命令爲：

npx @deepseek-ai/dsh plugin --profile web add @hellosz/dsh-pets
npx @deepseek-ai/dsh web

安裝後驗證¶

可以檢查 web profile 配置中是否出現插件：

dsh --profile web --dump-config | grep -A2 'dsh-pets'

然後打開瀏覽器訪問：

http://localhost:3080

安裝成功且啓用後，寵物會出現在頁面右下角。

卸載插件¶

如需移除，執行：

dsh plugin --profile web remove @hellosz/dsh-pets

典型用法¶

使用設置頁¶

進入：

Settings → 寵物夥伴

可以先切換一隻內置寵物，再通過縮放滑塊調整大小。縮放範圍爲：

0.6x–2.5x

如果暫時不需要寵物提示，可以在設置頁關閉開關。

使用浮動寵物¶

寵物常駐在右下角。可以通過拖拽改變位置，也可以點擊寵物彈出菜單，或選擇一鍵隱藏。

使用接口¶

插件通過 webServer 暴露：

GET /pet/state
GET /pet/asset

pet_say 工具也可以用於寵物相關交互。

重新生成寵物包¶

如果需要重新生成寵物包，可以執行：

node scripts/generate-packs.js

該腳本依賴 ImageMagick 6+。

依賴與素材來源¶

插件的 peerDependencies 包括：

{
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-tools": "*",
  "react": "^18.2.0 || ^19.0.0"
}

素材來源包括：

• PokeAPI/sprites
• Pokemon Showdown 動畫精靈
• petdex 格式規範

許可證爲 MIT。

適用場景與注意¶

這個插件適合正在使用 DSH Web GUI，並且希望在長任務中用動畫狀態輔助判斷 agent 當前狀態的開發者。

使用插件前，建議先檢查源碼與許可證。插件會以當前 dsh 進程權限運行，安裝前應確認它符合本地使用要求。

鏈接¶

目錄頁：

https://www.skillhub.cn/plugins/hellosz/dsh-pets

GitHub 倉庫：

https://github.com/hellosz/dsh-pets