MIT 開源的 DSH 桌面寵物外掛程式：右下角小坤寵隨 Agent 工作狀態切換 9 種動畫，任務完成播放系統級「你幹嘛~哎喲」；以 `cordis_define` 動態外掛程式形式接入，設定集中在 `src/host.js` 頂端 CONFIG。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-27
授權條款
MIT
01它能幫你完成什麼？
在 DeepSeek Harness 的 Web 介面右下角放一隻會跟著 Agent 狀態反應的桌面寵物
一隻會切換 9 種狀態動畫（沿用 Codex 精靈圖契約 8 列 × 9 行）的桌寵，任務完成時在全機範圍播放「你幹嘛~哎喲」完成音
使用 DeepSeek Harness（DSH）的開發者與使用者，想要一隻可愛寵物陪伴、並直觀反映 Agent 目前在幹嘛
把 Agent 的即時狀態（執行中 / 思考 / 等待 / 出錯 / 閒置）變成桌寵動畫
以輪詢 agents 服務加上 tools/execute、approval/request、agent/request-error 事件推導出的五種模式，對應到各自的精靈圖行與氣泡文案
想一眼看出 Agent 正在執行、卡住等待還是已經完成的 DSH 使用者
不安裝到 DSH 也能先預覽全部動畫
獨立的 demo/index.html 展示頁，可查看全部 9 種動畫並拖曳互動
想先看看桌寵長什麼樣、好不好玩，再決定是否裝進 DSH 的使用者
02如何將外掛接入 DeepSeek Harness？
先決條件
- 支援動態外掛程式的 DeepSeek Harness（DSH）工作階段——桌寵透過 `cordis_define` 安裝、`cordis_run` 啟動
- 已克隆的儲存庫目錄，包含 src/host.js、src/client.js 與 assets/ 底下的精靈圖與語音素材（路徑需在 CONFIG 中修改）
- 符合目前系統的播放指令——macOS 預設用 afplay；Windows / Linux 需要改成對應指令
安裝步驟
- 01
克隆儲存庫：`git clone https://github.com/liyupi/dsh-kun-like-pet.git`
$ git clone https://github.com/liyupi/dsh-kun-like-pet.git
- 02
修改 `src/host.js` 頂端 CONFIG 中的素材路徑（spritePath / voicePath / playCommand）
- 03
產生一鍵安裝的 JSON 載荷：`node scripts/build-kunpet-package.mjs -`
- 04
把產生的 JSON 載荷貼給 `cordis_define` 工具（kind 為 new 建立新外掛程式；之後更新用 kind 為 existing 加 pluginId）
- 05
用 `cordis_run` 啟動，Web 介面右下角即出現桌寵
驗證整合成功
- 執行儲存庫完整性校驗：`node scripts/validate.mjs`
03DSH 整合程度與能力邊界
以 DSH 動態外掛程式的形式原生整合：在 DSH 工作階段中透過 `cordis_define` 安裝、`cordis_run` 啟動；host 半負責狀態機、素材路由與系統音，client 半透過 shell.overlay 注入渲染動畫
9 種狀態動畫渲染
Agent 工作狀態（執行中 / 思考 / 等待 / 出錯 / 閒置，外加拖曳、點擊、任務完成）→對應到精靈圖行的 9 種狀態動畫（Codex 桌寵精靈圖契約，8 列 × 9 行、每格 192×208）
任務完成全機可聞的系統音
任意視窗 / 任意工作階段的任務完成事件→宿主程序用系統指令播放「你幹嘛~哎喲」，本機必響，與瀏覽器靜音無關
透過宿主程序依設定的系統指令播放音訊拖曳與點擊互動
用滑鼠拖曳桌寵或點擊桌寵→跑步動畫（方向跟隨拖曳方向）；點擊觸發揮手（2.4s 反應）
內建除錯工具
呼叫 kun_pet_debug 工具→隨時查看狀態機內部計數與輪詢健康度
即時感知 Agent 狀態（輪詢 agents 服務）
按 pollMs（預設 500）輪詢 agents 服務，搭配 tools/execute、approval/request、agent/request-error 事件→推導執行中 / 思考 / 等待 / 出錯 / 閒置五種模式並驅動桌寵動畫
依設定的間隔（預設 500ms）輪詢 agents 服務
04適合誰？何時不該用？
適合
- 使用 DeepSeek Harness（DSH）的開發者與使用者，想要一隻可愛寵物陪伴、並直觀反映 Agent 目前在幹嘛
- 想一眼看出 Agent 正在執行、卡住等待還是已經完成的 DSH 使用者
- 想先看看桌寵長什麼樣、好不好玩，再決定是否裝進 DSH 的使用者
不適合
- 動態外掛程式是工作階段層級綁定：桌寵介面只注入到啟動它的工作階段頁面；若要讓桌寵出現在所有視窗，需要升級為宿主組合級外掛程式套件。
- 素材版權受限：assets/voice.mp3 為網路公開的二創梗語音片段（含公眾人物聲音），精靈圖為粉絲二創像素形象，均僅供個人學習交流使用，請勿用於商業用途；商用需替換為無版權素材。
05相容性、維護與安全提醒
- 完成音依賴系統播放指令且因平台而異：macOS 預設用 afplay，Windows / Linux 需要在 CONFIG 中改成各自的指令（如 SoundPlayer / ffplay）。
- 動態外掛程式是工作階段層級綁定：桌寵介面只注入到啟動它的工作階段頁面；若要讓桌寵出現在所有視窗，需要升級為宿主組合級外掛程式套件。
- 素材版權受限：assets/voice.mp3 為網路公開的二創梗語音片段（含公眾人物聲音），精靈圖為粉絲二創像素形象，均僅供個人學習交流使用，請勿用於商業用途；商用需替換為無版權素材。
- 不能依賴事件監聽：部分部署中 agent/status、agent/turn-stopping 等 Agent 狀態事件不會流經動態外掛程式所在匯流排（831 次事件觀測中 status 類事件為 0），因此桌寵採用輪詢 agents 服務這個最可靠的跨部署方案。
MIT · 尚無 Release（儲存庫建立於 2026-08-14）
06常見問題
要怎麼把這隻桌寵裝進 DeepSeek Harness？
它以 DSH 動態外掛程式形式開發並完成運行驗證（`cordis_define`）：克隆儲存庫後，修改 `src/host.js` 頂端 CONFIG 中的素材路徑，執行 `node scripts/build-kunpet-package.mjs -` 產生 JSON 載荷，貼給 `cordis_define` 工具，再用 `cordis_run` 啟動，Web 介面右下角即出現桌寵；也可以在 DSH 工作階段中讓 Agent 直接執行整個流程。
為什麼桌寵只在某一個視窗裡？
動態外掛程式是工作階段層級綁定：桌寵介面只注入到啟動它的工作階段頁面。不過 v5 起完成音由宿主程序以系統層級播放，任何視窗、任何工作階段完成任務本機都會響；若要讓桌寵出現在所有視窗，需將外掛程式升級為宿主組合級外掛程式套件。
想調整輪詢間隔或音效，要去哪裡改？
所有可調項目都集中在 `src/host.js` 頂端 CONFIG：spritePath、voicePath、playCommand，以及 pollMs（預設 500）、celebrateMs（預設 4800）、failedMs（預設 2600）等。
不裝 DSH 可以先看效果嗎？
可以。開啟 `demo/index.html`（建議起個靜態伺服器，如 `npx serve .` 或 `python3 -m http.server`），即可查看全部 9 種動畫並拖曳互動，不需要 DSH。
語音和精靈圖素材可以商用嗎？
不行。`assets/voice.mp3` 為網路公開的二創梗語音片段（含公眾人物聲音），版權歸原作者所有，僅供個人學習交流使用，請勿用於商業用途；如需商用請自行替換為無版權素材。精靈圖同樣為粉絲二創的像素形象。
07相關的 DSH 工作流程
dsh-pet
作者 pc2005-cloud
DSH 桌面寵物：一行命令裝好即用的透明動畫小桌寵，支援多開、大小位置隨心配置；還內建 DIY 素材鏈，能用 AI 影片自造專屬寵物
dsh-tavern
作者 flizzywine
基於DSH的Agent酒館。類酒館文字遊戲Agent。相容SillyTavern生態，人物卡直接匯入就能玩。更快、更穩、更鮮活。所有模型都能用。手機也能玩。
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飛魚陪伴外掛，即時展示智慧體狀態，Windows 上置頂顯示。
whale-girl
作者 vlln
DSH Web GUI 桌面寵物外掛（QQ 寵物形態）：右下角懸浮、可拖拽/投餵/玩耍的積累型夥伴。
08資料與來源
桌宠以 **DSH 动态插件** 形式开发并运行验证（`cordis_define`）。在 DSH 会话里让 Agent 执行，或手动调用 `cordis_define` 工具：
4. 用 `cordis_run` 激活，Web 界面右下角即出现桌宠。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-27。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。