前言¶
用 DeepSeek Harness（下稱 DSH）跑任務時，一個常見的麻煩是：任務在後臺執行，你得切窗口、刷頁面才能知道它是在等你輸入、出了錯，還是已經跑完。dsh-nba-pets 用另一種方式解決這個問題：在 DSH 頁面上放一隻籃球主題的桌面寵物，用不同的動畫直接表達任務狀態，需要輸入時它會等你，出錯時它顯示受阻動作，空閒時它就在那裏練習投籃。
下面介紹這個插件的定位、功能和安裝方法。
這是什麼¶
dsh-nba-pets 是由 lijian-888 維護的籃球桌面寵物合集，專爲 DSH 打造，許可證爲 MIT，倉庫 package.json 中標註的版本號爲 0.1.2。它是非官方粉絲項目，與 NBA、任何球隊或球員本人無隸屬或背書關係。
它不會替換 DSH 的會話、側欄或輸入區，只是在 Web 界面上增加一個能表達任務狀態、可交互的浮動寵物。
核心功能¶
- 兩個可切換角色：Curry 30 與原創致敬形象 King 23，一鍵切換。
- 任務狀態一目瞭然：需要輸入、受阻、已就緒、執行中、待機分別使用不同動畫。
- 點擊查看任務：點擊寵物即可查看活動任務，並直接進入對應的 DSH 會話。
- 桌面寵物的基本能力：自由拖動、角色與位置記憶、收起和喚醒。
- 豐富的動畫：待機投籃、跑步、招手、跳躍、等待、受阻、工作、審閱，以及 16 向光標追蹤。
- 尊重系統設置：開啓系統“減少動態效果”後，自動改用靜態幀。
- 構建時嵌入素材：兩套 1536×2288 RGBA WebP v2 動畫圖集在構建時嵌入 DSH 客戶端包，安裝後不依賴本地素材路徑，也不需要額外的 HTTP 服務。
狀態規則¶
任務狀態的優先級遵循 Codex Pets 的狀態語義，同一時刻多個狀態並存時，按優先級從高到低取第一個：
| DSH 狀態 | 寵物表現 | 優先級 |
|---|---|---|
pendingInteraction |
等待用戶輸入 | 1 |
lastAgentError |
顯示受阻或錯誤動作 | 2 |
completed |
顯示已就緒或審閱動作 | 3 |
running |
顯示任務執行動作 | 4 |
| 無活動 | 投籃待機或看向光標 | 5 |
也就是說，只要任務出錯或需要你輸入，寵物一定會優先表現出來，不會被“執行中”的動畫掩蓋。
安裝與啓用¶
環境要求：Node.js 22+、DeepSeek Harness 0.1.0-rc.5 至 <0.2.0、DSH web profile（首次安裝時會自動創建）。
方式一：npm 安裝（最簡單，推薦）¶
已經有 dsh 命令的用戶，直接執行：
dsh plugin --profile web add dsh-nba-pets
這會從公共 npm 倉庫安裝已構建、已測試的版本。
如果 npm 鏡像尚未同步該包，可指定官方源：
dsh plugin --profile web add dsh-nba-pets --registry=https://registry.npmjs.org
方式二：從 DSH 源碼目錄安裝（適合 DSH 開發者）¶
如果你直接從 DSH 源碼倉庫運行、沒有全局 dsh 命令：
cd /path/to/deepseek-harness
corepack pnpm dsh plugin --profile web add dsh-nba-pets
方式三：從 GitHub 安裝最新源碼¶
dsh plugin --profile web add github:lijian-888/dsh-nba-pets
GitHub 安裝會在本地構建源碼。pnpm 10 及以上版本首次可能要求放行構建，需要在 profile 的 pnpm-workspace.yaml 中加入：
allowBuilds:
dsh-nba-pets: true
然後重新執行安裝命令。如需穩定復現，建議固定可信提交：
dsh plugin --profile web add github:lijian-888/dsh-nba-pets#<commit-sha>
啓動與驗證¶
安裝後先重啓 DSH，讓它重新讀取 profile，再啓動 Web profile：
dsh --profile web
刷新 DSH 頁面後，Curry 30 會作爲浮動寵物出現。點擊寵物即可切換角色或查看任務動態。
要確認插件已寫入配置，執行：
dsh --profile web --dump-config
輸出中應包含 # == dsh-nba-pets 和 id: nba-pets。
卸載¶
dsh plugin --profile web remove dsh-nba-pets
本地開發¶
如果你想改代碼或參與貢獻，從源碼跑起來：
git clone https://github.com/lijian-888/dsh-nba-pets.git
cd dsh-nba-pets
npm install
npm run check
dsh plugin --profile web add .
常用開發命令：
npm run build
npm test
npm run check
適用場景與注意¶
適合的場景：長期在 DSH Web 界面工作、經常同時跑多個任務、希望不切窗口就能掌握任務進度的用戶。它也適合想要一點陪伴感的開發者，但狀態表達是它的核心價值，不只是裝飾。
使用前注意幾點：
1、這是瀏覽器內插件，寵物只能浮動在 DSH Web 應用窗口內，無法創建跨操作系統窗口的全局置頂寵物。
2、這是非官方粉絲項目，不包含 NBA 或球隊標誌；King 23 是原創致敬形象，並非真人精確肖像，詳細說明見倉庫的 THIRD_PARTY_NOTICES.md。
3、和其他 DSH 插件一樣，插件以當前 dsh 進程的權限運行。安裝前建議檢查源碼與許可證（本項目爲 MIT），從 GitHub 安裝時可固定可信提交。
結尾¶
dsh-nba-pets 做的事情很集中：把 AI 任務狀態翻譯成一眼能看懂的寵物動畫，同時給 DSH 工作區增加一點籃球味。如果你已經在用 DSH 的 web profile，一條命令就能裝上試試。
