返回目錄

dsh-pet-whale

精選清單收錄維護狀態: 活躍

nzl153/dsh-pet-whale

桌寵小鯨魚:DSH(DeepSeek Harness)桌寵外掛,桌面端和網頁端都能用,隨 agent 狀態切換動畫,純 DOM 零依賴

前往 GitHub專案首頁
$ dsh plugin --profile web add link:/path/to/pet-whale

14

星數

3

Fork

JavaScript

語言

MIT

授權條款

2026-08-14

建立於

2026-10-02

最近推送

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`

安裝步驟

  1. 01

    編輯 profile 的 `package.json`:在 `dependencies` 裡加 `"pet-whale": "^1.2.7"`,並把 `"pet-whale"` 加進 `dsh.profile.bundles` 清單中原有項目旁邊

  2. 02

    在該 profile 目錄執行 `pnpm install`,然後重新啟動 DSH——桌面端要從系統匣結束再啟動

  3. 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 整合原生執行環境

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。
2026-08-142026-10-02v1.2.7

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` 偏好,例如位置、大小、色盤、靜音和隱藏狀態。

08資料與來源

  • 作者聲明github.com231a1936c427…

    DeepSeek Harness(DSH)的桌宠插件,桌面端和网页端都能用:右下角一只**官方轮廓版小鲸鱼**,随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖,WebAudio 合成音效无音频文…

  • 作者聲明github.com231a1936c427…

    在你正在用的 profile 目录(桌面端和网页版各用各的 profile,网页版一般是 `~/.dsh/profiles/web`)的 `package.json` 里加上依赖和 bundle:

  • 作者聲明github.com231a1936c427…

    "dependencies": { "pet-whale": "^1.2.7" }, "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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