前言¶

在 DeepSeek Harness（DSH）里長時間跑任務、盯日誌，界面往往只有任務流和工具狀態，缺少一點「有人在旁邊」的反饋。常見做法是開第二個窗口放視頻或靜態壁紙，但那和當前任務沒有聯動，也容易分散注意力。

dsh-whale-musume（社區稱「鯨魚娘」）是面向 DSH 的桌面看板娘插件：懸浮在頁面一角，待機時做小動作，檢測到工具運行就切到「抱筆記本工作」姿勢，還能摸頭、養成、玩小遊戲。資源與狀態默認都在本機，README 寫明無遙測、無外部請求；天氣功能可選聯網，城市留空則零聯網。下面介紹它是什麼、能做什麼，以及兩種官方安裝方式怎麼選。

這是什麼¶

dsh-whale-musume 由維護者 Sutera-Diffusus 發佈，當前版本 1.4.1，MIT 許可證，適配 DSH 0.1.0-rc.6 或同系列版本。在 SkillHub 社區目錄中歸類爲「趣味換裝」，GitHub 倉庫約 32 stars。

一句話定位：純前端注入的 DSH 桌寵插件——不改動 DSH 業務 DOM，通過腳本或 bundle 把樣式、腳本和 90+ 張立繪掛進 Web 界面，在右下角（或你拖到的任意位置）陪伴寫代碼。

核心功能¶

看板娘本體與工作狀態聯動¶

默認 200px 懸浮形態，支持拖拽；拖拽時切換「被拎起來」立繪，身體隨光標方向搖擺。待機時隨機喝咖啡、伸懶腰等小動作；待機與工作狀態之間用「下壓 → 換圖 → 彈起」過渡，避免疊影或閃黑。

當頁面檢測到工具運行（data-running / data-state="ongoing"）時，鯨魚娘自動切到抱筆記本姿勢，帶淡藍光暈和「工作中」標籤。工作狀態下點擊會隨機出現害羞或偷喫內存條等反應，不打斷 running 姿勢，也不隨機切小劇場。

立繪、臺詞與互動¶

立繪覆蓋待機、工作、思考、離開，以及摸頭 / 戳肚子 / 戳尾巴分區互動；另有成長、遊戲四態、天氣三態、節日換裝（聖誕 / 萬聖 / 中秋 / 春節 / 情人節），以及 13 種梗關鍵詞觸發的表情包變身。

臺詞庫 530+ 條，5–8 分鐘按任務內容本地貼題閒聊；工作態不插嘴。分時問候覆蓋白天各時段，深夜 23:00–5:59 不主動打擾。心情與羈絆等級（Lv3 / Lv5 / Lv7）解鎖不同臺詞。

單擊摸頭觸發臉紅與粒子；三連擊星星眼慶祝；右鍵菜單提供投餵、戳一下、誇誇、小遊戲、回到原位、打開設置。

小遊戲與養成¶

小遊戲「戳泡泡·泡泡派對」：4×4 網格，普通 / 星星 / 炸彈三種泡泡，30 秒一局；支持鼠標與方向鍵 + Enter / Esc。每日 3 局計入養成獎勵，超出只計分。

養成維度包括心情、好感、飽食、等級、連續簽到、陪伴時長。每日 3 個任務槽、周簽到板、39 個成就，設置面板內有成就牆。羈絆 Lv3 解鎖新待機動作，Lv5 稱號「鯨汐守護者」，Lv7 隱藏彩蛋。

天氣與設置¶

路徑：DSH 設置 → 看板娘。分組包括陪伴表現、天氣、日常與養成、成就牆、數據與重置。膠囊開關可單獨關閉看板娘、臺詞氣泡、粒子、小遊戲、關鍵詞感知、摸魚提醒、深夜模式、天氣特效等。

天氣在設置裏填城市（API Key 選填）；Open-Meteo 免費且無需 Key，城市留空則不聯網。開啓天氣特效後，雨 / 雪 / 雷等全屏氛圍隨真實天氣切換，工作態自動降檔。

工程側特點¶

核心狀態機（whale-moe-core.js）與 DOM 表現層分離；安裝腳本自帶備份與回滾；資源 URL 帶版本號便於刷新緩存。倉庫含 97 個單元測試，另有 CDP 與動效 QA 腳本供二次開發參考。

安裝與啓用¶

安裝前確認：Windows 10 / 11（官方開發與測試環境）、Node.js 18+（腳本安裝需要）、Edge / Chrome 最新版。腳本方式會改寫 DSH 安裝目錄中的前端資源，建議先關閉 DSH 頁面並記錄當前 DSH 版本；安裝腳本輸出裏的 Backup: 路徑請保留到驗證無誤。

DSH 安裝目錄通常含 DeepSeekHarness-Launcher.exe 和 node_modules；不確定時可讀啓動器配置中的 workDir：

Get-Content "<DSH_INSTALL_DIR>\DeepSeekHarness-Launcher.cfg"

方式一：組合包安裝（零侵入，推薦新用戶）¶

插件聲明瞭 dsh.bundle.patch，可直接用 DSH 插件命令安裝，無需腳本改內置包：

dsh plugin --profile web add github:Sutera-Diffusus/dsh-whale-musume

安裝後重啓 dsh web，在瀏覽器打開 DSH（默認 http://127.0.0.1:3080），強制刷新（Ctrl + F5），右下角應出現鯨魚娘。此模式下宿主只註冊 /api/dsh-whale-musume/assets 靜態資源路由，瀏覽器側注入本體；齒輪菜單與 localStorage（鍵名 whale-moe:）管理開關與養成數據。

方式二：Release 腳本安裝（主題集成場景）¶

先做第 1 步，從 Releases 下載 dsh-whale-musume-plugin-vX.Y.Z.zip 並解壓，例如 D:\dsh-whale-musume。

再做第 2 步，在插件目錄執行兩條安裝命令：

node scripts/apply-theme.mjs --assets-only --target "<DSH_INSTALL_DIR>"
node scripts/apply-theme.mjs --mascot-settings --target "<DSH_INSTALL_DIR>"

也可用環境變量指定目錄：

$env:DSH_INSTALL_DIR = "<DSH_INSTALL_DIR>"
node scripts/apply-theme.mjs --assets-only
node scripts/apply-theme.mjs --mascot-settings

經過上面的步驟，刷新 DSH 頁面並驗證：單擊有臉紅特效、三連擊星星眼、拖拽切換拎起姿勢、設置頁出現「看板娘」欄目。

兩種安裝方式二選一，不要混用。臨時關閉可在設置裏關掉「看板娘」開關，資源仍保留。

典型用法¶

拖拽與位置¶

按住鯨魚娘移動，鬆手後位置寫入 localStorage；右鍵 → 回到原位 恢復默認右下角。

右鍵菜單¶

更新與回滾¶

更新：下載新版 zip，覆蓋 assets/ 和 scripts/，重新執行腳本安裝的兩條命令，再強制刷新。

回滾示例：

node scripts/apply-theme.mjs --rollback "<backup dir>"

卸載腳本注入時，對設置與資源各執行一次帶 --rollback 的 apply-theme.mjs；bundle 模式按 DSH 插件管理流程移除即可。

適用場景與注意¶

適合希望在 DSH Web 界面裏獲得輕量陪伴、又不想開額外窗口的開發者。工作狀態與 DSH 任務流聯動，摸魚小遊戲和成就係統適合長時間掛機場景；需要剋制打擾時可關臺詞氣泡、深夜模式或整個看板娘開關。

務必注意：

1. 插件隨 DSH 進程與瀏覽器上下文運行，安裝前應閱讀源碼與 MIT 許可證，確認接受腳本改寫前端資源或 bundle 注入的方式。
2. 官方測試環境爲 Windows；其他系統需自行驗證腳本與 bundle 是否可用。
3. 隱私方面，README 聲明默認不發送遙測、不上傳數據；養成數據在 localStorage（whale-moe: 前綴），不含 API Key 或憑據。僅在你主動配置天氣城市或 API Key 時纔會發起天氣相關請求。
4. 刷新後看不到鯨魚娘：確認安裝輸出含 Applied、強制刷新、檢查「看板娘」開關；設置頁無欄目時需確認 DSH 版本兼容並執行 --mascot-settings。

結尾¶

dsh-whale-musume 把看板娘、任務狀態聯動、本地養成和小遊戲收進 DSH 同一頁面，用 bundle 或腳本兩種路徑接入。若你正在 SkillHub 或 GitHub 瀏覽 DSH 插件，可以把它當作「趣味換裝」類裏功能較完整的一款桌寵方案。

• 社區目錄：SkillHub - dsh-whale-musume
• 源碼與文檔：GitHub - Sutera-Diffusus/dsh-whale-musume