MIT 授權的 DSH 桌面寵物外掛，以官方 bundle 形式透過 `dsh plugin --profile web add` 安裝，顯示在 DSH Web 介面右下角。
DSH 整合
相容
作者聲明
安全稽核
未稽核
最後核實
2026-08-21
授權條款
MIT
01它能幫你完成什麼？
Add a persistent desktop pet companion to the DeepSeek Harness Web GUI
A draggable, feedable, playable pet floating bottom-right, with animated states that react to sessions, tasks and approvals
DSH Web GUI users who want a fun resident companion while running agent sessions
Grow a companion that accrues seniority across your DSH usage
Seniority levels, titles and memories accumulated from completed tasks, sessions and companionship time
Long-term DeepSeek Harness users who want their usage history reflected in a companion
Keep the whale girl resident on your OS desktop, outside the browser
A standalone companion app (Node engine + Tauri shell) that stays on the desktop, connected to a local or remote DSH
Users who want the pet on their OS desktop instead of the DSH web page
02如何將外掛接入 DeepSeek Harness？
先決條件
- DeepSeek Harness (dsh) with the web profile — the plugin is managed via `dsh plugin --profile web`
- Optional desktop companion: Node ≥18 and Rust (cargo) for the Tauri rendering shell
安裝步驟
- 01
Run `dsh plugin --profile web add "github:vlln/whale-girl#main"` (single-line git source, build artifacts committed)
$ dsh plugin --profile web add "github:vlln/whale-girl#main"
- 02
Alternative sources: `dsh plugin --profile web add whale-girl@0.1.0` (npm) or `dsh plugin --profile web add <path-to-whale-girl>` (local directory)
$ dsh plugin --profile web add whale-girl@0.1.0
- 03
Restart web — bundle layers compose at startup
- 04
Optional desktop companion: `npm install -g whale-girl-desktop`, run `whale-girl-desktop --headless` or build the Tauri shell via `cargo build --release` in `src-tauri`
$ npm install -g whale-girl-desktop
- 05
Update via `dsh plugin --profile web update whale-girl` (or switch the git ref), then restart
$ dsh plugin --profile web update whale-girl
驗證整合成功
- After restarting web, the pet appears bottom-right: click for its menu (🍗 feed / 🎾 play), drag to move, hover for the status bar (seniority level / task count / recent shared memories)
03DSH 整合程度與能力邊界
Official DSH bundle plugin installed via the `dsh plugin --profile web` CLI and rendered inside the DSH Web GUI
Event-driven pet state machine
DSH session / task events (task done, failure, approval, new session, idle ≥60s)→15 animated states — celebrate, error, disappointed, joy, eat, play, drag, walk, sleep, wake, welcome, think, working, wait, idle
Accrual-based growth (seniority, titles, memories)
Completed tasks, sessions and companionship time→Seniority levels, titles and shared memories shown in the hover status bar
XP / title thresholds are sealed and not configurable, to protect the accumulation ledgerLive configuration & character switching
`whale-girl:` section in `<dshHome>/settings.yaml` (or the settings UI); `whale-girl:character` in localStorage→Size / opacity / wandering / sleep toggles applied live without restart; cycling between characters
Setting `enabled: false` disables the in-page pet while a desktop companion runsStandalone desktop companion (optional)
whale-girl's public endpoints (`/state`, `/events`, `/presence`, `/interact`, `/config`, `/assets`)→Transparent always-on-top desktop pet connected to a local or remote DSH (Tauri v2 shell ~12MB, legacy Electron shell kept)
Not installed via `dsh plugin` — enabled manually (npm global install + cargo build)The in-page pet hides while the companion runs (presence contract) and returns after exit/crash (TTL 45s)
04適合誰？何時不該用？
適合
- DSH Web GUI users who want a fun resident companion while running agent sessions
- Long-term DeepSeek Harness users who want their usage history reflected in a companion
- Users who want the pet on their OS desktop instead of the DSH web page
不適合
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
05相容性、維護與安全提醒
- The optional desktop companion requires Node ≥18 plus Rust (cargo), and the first Tauri build takes about 5–15 minutes; it is not installed via `dsh plugin`.
- Growth semantics (XP and title thresholds) are sealed and not configurable — changing them would break the accumulation ledger.
- The in-page pet lives only in the DSH Web GUI and is hidden on onboarding pages; while the desktop companion runs, the in-page pet hides (presence contract).
MIT · actively maintained (last push 2026-08-18)
06常見問題
如何把 whale-girl 安裝到 DeepSeek Harness？
它是透過官方 profile 管理的官方 bundle 外掛：執行 `dsh plugin --profile web add "github:vlln/whale-girl#main"`（也相容 npm 來源 `whale-girl@0.1.0` 或本機目錄），然後重新啟動 web。bundle 層在啟動時組合完成後，寵物就會出現在右下角。
它是 DSH 原生外掛還是 MCP 服務？
兩者都不是——它採用官方 bundle 外掛格式（根目錄 `package.json` 中的 `dsh.bundle` + `dsh.client`），直接顯示在 DSH Web 介面內，不依賴 MCP。
桌面常駐版需要什麼前置條件？
桌面版是可選的，不透過 `dsh plugin` 安裝：需要 Node ≥18 和 Rust（cargo）來建置 Tauri 殼（首次建置約 5–15 分鐘）。它呼叫 whale-girl 的公開端點，預設連接本機 3080 埠的 DSH，也可用 `WHALE_GIRL_BASE_URL` 指向遠端 DSH。
成長資料從哪裡來？可以自訂成長規則嗎？
資歷等級、頭銜與回憶來自完成的工作、工作階段與陪伴時間的累積。XP 與頭銜門檻被刻意封存、不可設定，因為更動它們會破壞累積帳本。
如何調整寵物大小、透明度或閒逛行為？
編輯 `<dshHome>/settings.yaml` 中的 `whale-girl:` 區段（或用設定介面），修改立即生效、不必重新啟動。角色可透過 🎭 按鈕或 localStorage 裡的 `whale-girl:character` 切換。
07相關的 DSH 工作流程
dsh-pet
作者 pc2005-cloud
DSH 桌面寵物：一行命令裝好即用的透明動畫小桌寵，支援多開、大小位置隨心配置；還內建 DIY 素材鏈，能用 AI 影片自造專屬寵物
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飛魚陪伴外掛，即時展示智慧體狀態，Windows 上置頂顯示。
dsh-tavern
作者 flizzywine
基於 DeepSeek Harness（DSH）的 SillyTavern 類文字遊戲 Agent，支援候選項生成、對話式人物卡編輯、劇本模式與素材抽取。
dsh-kun-like-pet
作者 liyupi
Kun Like 桌寵 —— DeepSeek Harness 桌面寵物外掛：右下角小坤寵隨 Agent 工作狀態切換 9 種動作，任務完成播放「你幹嘛~哎喲」
08資料與來源
Official **bundle plugin** (`dsh.bundle` + `dsh.client` in root `package.json`), managed via the official profile:
dsh plugin --profile web add "github:vlln/whale-girl#main" # single-line git source (build artifacts committed)
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-21。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。