MIT 開源的 DSH 桌寵:零相依的 DOM 小鯨魚,在桌面端與網頁端同步 idle / think / working / celebrate / error / wait 狀態,靠 profile 的 `package.json` 相依加 `dsh.profile.bundles` 安裝。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-13
授權條款
MIT
01它能幫你完成什麼?
一眼看出 DeepSeek Harness 正在做什麼——閒置、思考、工作中、等待、出錯還是慶祝——靠角落裡的一隻桌寵
鯨魚的表情和動畫跟隨工作階段狀態機(idle / think / working / celebrate / error / disappointed / wait,優先順序 error > celebrate > think > working > idle),桌面端和網頁端都一致
會跑很長 agent 回合、希望有個常駐狀態指示而不是一直盯著對話紀錄的 DSH 使用者
同時盯住多個並行工作階段,並在其中一個跑完時收到提醒
別的工作階段在跑時鯨魚照樣工作,頭上氣泡徽章顯示正在執行的工作階段數量,某個工作階段完成時牠會慶祝並報出是哪一個,還會提醒你哪個工作階段正在等輸入
習慣同時開多個 DSH 工作階段的人(此能力需要 DSH 0.1.7 以上)
把漫長的 DSH 工作階段變成可以戳、可以換裝、也可以收起來的東西
戳一戳、摸摸頭、雙擊翻滾、拖曳貼邊壓扁、7 套色盤換膚、0.8–1.6 倍縮放、WebAudio 音效、收起到右下角並留下可拖曳的狀態按鈕,以及跟隨亮/暗主題
希望這個 harness 更像桌面應用、不那麼像終端機的人
02如何將外掛接入 DeepSeek Harness?
先決條件
- 需要 DSH `>=0.1.5-alpha.2 <0.3.0` 與 Node.js `^22.19.0 || >=24.0.0`
- 你實際在用的那個 profile 目錄——桌面端和網頁端各用各的 profile,網頁版一般是 `~/.dsh/profiles/web`
安裝步驟
- 01
編輯 profile 的 `package.json`:在 `dependencies` 裡加 `"pet-whale": "^1.2.7"`,並把 `"pet-whale"` 加進 `dsh.profile.bundles` 清單中原有項目旁邊
- 02
在該 profile 目錄執行 `pnpm install`,然後重新啟動 DSH——桌面端要從系統匣結束再啟動
- 03
另一種做法:不用 npm 安裝——本機儲存庫用 `dsh plugin --profile web add link:/path/to/pet-whale`(儲存庫已包含建置產物 `lib/`),git 直裝用 `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"`
$ dsh plugin --profile web add link:/path/to/pet-whale
驗證整合成功
作者未說明
03DSH 整合程度與能力邊界
DSH 外掛套件:用戶端部分(`lib/client.js`)負責在 DSH 介面裡繪製鯨魚並跟隨工作階段狀態,主機端部分(`lib/index.mjs`)負責主機側邏輯;安裝時將它加入 profile 的 `dsh.profile.bundles` 清單
Agent 狀態機
DSH 工作階段快照與 chat 投影(`running`、`lastAgentError`、`partial`、`runningCalls`、`turnEnds`)→idle / think / working / celebrate / error / disappointed / wait 動畫,優先順序 error > celebrate > think > working > idle
跟隨所有工作階段
來自 `ctx.uiSession.sessionStatus` 的每個工作階段執行狀態與待核准狀態→顯示正在執行工作階段數量的氣泡徽章、完成工作階段的慶祝與點名,以及哪個工作階段正在等待的提醒(不含子 agent)
思考流氣泡
狀態為 `think` 時模型最近的思考文字→最近約 200 字在鯨魚上方緩慢捲動,可在右鍵選單裡開關
互動與外觀
點擊、雙擊、拖曳、游標靠近和右鍵選單選項→戳一戳/摸摸頭的反應、360° 翻滾、貼邊壓扁、7 套色盤、0.8–1.6 倍大小、六種 WebAudio 音效、收起到右下角並留下可拖曳的狀態按鈕
把位置、隱藏狀態和偏好記在 `localStorage` 裡除非靜音,否則播放合成音效多語言、主題與省電行為
DSH 的 locale 服務、DSH 亮/暗主題以及頁面可見性→跟隨 DSH locale 的中文/英文文案,跟隨主題的氣泡與陰影,以及頁面切到背景時暫停動畫、並在 `prefers-reduced-motion` 下退化為靜態顯示
04適合誰?何時不該用?
適合
- 會跑很長 agent 回合、希望有個常駐狀態指示而不是一直盯著對話紀錄的 DSH 使用者
- 習慣同時開多個 DSH 工作階段的人(此能力需要 DSH 0.1.7 以上)
- 希望這個 harness 更像桌面應用、不那麼像終端機的人
不適合
- 外掛鎖定 DSH `>=0.1.5-alpha.2 <0.3.0`,而且有幾項行為取決於主機版本——跟隨所有工作階段需要 DSH 0.1.7,README 還記錄了 1.1.0 在 0.1.5 下會拋例外、1.1.2 在 0.1.7 下一直待機。
- 安裝是改 profile,而不是一行指令加裝:把相依和 `pet-whale` bundle 加進 profile 的 `package.json`,在該目錄執行 `pnpm install` 再重新啟動 DSH(桌面端必須從系統匣結束)。桌面端和網頁端各有自己的 profile,所以每個 profile 都要改一遍。
05相容性、維護與安全提醒
- 外掛鎖定 DSH `>=0.1.5-alpha.2 <0.3.0`,而且有幾項行為取決於主機版本——跟隨所有工作階段需要 DSH 0.1.7,README 還記錄了 1.1.0 在 0.1.5 下會拋例外、1.1.2 在 0.1.7 下一直待機。
- 安裝是改 profile,而不是一行指令加裝:把相依和 `pet-whale` bundle 加進 profile 的 `package.json`,在該目錄執行 `pnpm install` 再重新啟動 DSH(桌面端必須從系統匣結束)。桌面端和網頁端各有自己的 profile,所以每個 profile 都要改一遍。
- 鯨魚輪廓使用 DeepSeek 官方 FishLogo 路徑,README 把它當作品牌素材,重複使用時必須註明出處。
- 只有在 profile 以 `link:` 方式安裝本儲存庫、且 DSH `>=0.1.5-alpha.2` 時熱重載才有效;改動 `package.json` 結構、`cordis.patch.yml`、主機端部分或 bundle 清單仍然需要重新啟動 DSH。
MIT · 最新版本 v1.2.7(2026-10-02),僅有 README 證據,未做安全稽核
06常見問題
怎麼把 pet-whale 裝進 DeepSeek Harness?
開啟你實際在用的 profile 目錄(桌面端和網頁版各一個,網頁版一般是 `~/.dsh/profiles/web`),編輯其中的 `package.json`:在 `dependencies` 裡加 `"pet-whale": "^1.2.7"`,並在 `dsh.profile.bundles` 清單裡把 `"pet-whale"` 加在原有項目旁邊。然後在該目錄執行 `pnpm install`,重新啟動 DSH——桌面端要從系統匣「結束」再開啟。
不改 package.json 能裝嗎?
有本機儲存庫或想走 git 時可以:本機目錄用 `dsh plugin --profile web add link:/path/to/pet-whale`(儲存庫已包含建置產物 `lib/`,不需先建置),git 直裝用 `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"`。也只有 `link:` 方式才支援 README 裡的熱重載流程。
支援哪些 DSH 版本?
要求 DSH `>=0.1.5-alpha.2 <0.3.0` 與 Node.js `^22.19.0 || >=24.0.0`。部分能力要更新的宿主:「跟隨所有工作階段」需要 DSH 0.1.7;README 還記錄了 1.1.0 在 0.1.5 下會拋例外、1.1.2 在 0.1.7 下一直待機,1.1.3 起改為讀取主檢視持有的工作階段才修好。
桌寵會讀我的工作階段內容嗎?
它讀工作階段狀態來決定動畫:工作階段快照(`running`、`lastAgentError`)與 chat 投影(`partial`、`runningCalls`、`turnEnds`);處於 think 狀態時,會把模型最近約 200 字思考內容捲動顯示在鯨魚上方(右鍵可關)。所有渲染都在 DSH 頁面本機完成,位置、隱藏狀態和偏好存在 `localStorage` 裡。
它會寫哪些檔案?需要音訊資源嗎?
純 DOM 實作、零 React、零執行階段第三方相依,六種音效全部由 WebAudio 合成,所以沒有任何音訊檔案。使用者端只存 `localStorage` 偏好,例如位置、大小、色盤、靜音和隱藏狀態。
07相關的 DSH 工作流程
ds-harness-remote
作者 liguobao
基於 DeepSeek Harness 外掛機制構建的遠端訪問方案,通過低延遲、端到端加密的 P2P 網路,支援使用 PC、移動端 和 Web 隨時訪問本地裝置上的DSH 、CodeX、Cursor、Claude Code等工作區。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自動化外掛,將 CursorTouch/Windows-MCP 接入內建 MCP 客戶端橋接。提供預設關閉的 Computer Use 開關和應用內依賴安裝器。
dsh-desktop
作者 anywhere-labs
為 DeepSeek Harness (DSH) 外掛生態打造的現代化桌面端解決方案。萬物皆「外掛」,桌面本身也是「外掛」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 裝進口袋:手機本機執行,也能遙控你的電腦。
08資料與來源
DeepSeek Harness(DSH)的桌宠插件,桌面端和网页端都能用:右下角一只**官方轮廓版小鲸鱼**,随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖,WebAudio 合成音效无音频文…
在你正在用的 profile 目录(桌面端和网页版各用各的 profile,网页版一般是 `~/.dsh/profiles/web`)的 `package.json` 里加上依赖和 bundle:
"dependencies": { "pet-whale": "^1.2.7" }, "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-13。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
