前言¶

在 DeepSeek Harness（DSH）裏跑 Agent 時，界面往往只有會話流和 token 統計，缺少一個能反映「正在幹活 / 收工」狀態的常駐元素；用量和花費分散在多處，也不直觀。社區插件 dsh-whale-girl-pet 在 Web 界面右下角放置一隻 Q 版藍髮鯨魚女僕桌寵，把工作狀態動畫、任務完成氣泡、餘額與分時段花費看板、以及可選的任務結束語音播報綁在一起。YEJASONJIEXIN/dsh-whale-girl-pet 是在 yanzwzz/dsh-whale-girl-pet 0.3.2 基礎上的 fork（npm 包名仍爲 dsh-whale-girl-pet，當前版本 0.3.2-fork.1），在保留原有用量與動畫能力的同時，增加了可拖拽調節的桌寵大小、16 種角色音色任務播報，並把天氣與餘額查詢改爲宿主進程內直連，避免受會話沙箱與審批策略限制。

下面按定位、能力、安裝與配置、典型用法和注意事項說明。

這是什麼¶

dsh-whale-girl-pet 是面向 DeepSeek Harness Web 的 Cordis 插件：宿主半側註冊路由與計費邏輯，瀏覽器半側渲染透明 WebM 動畫與交互按鈕。維護者 YEJASONJIEXIN，在 SkillHub 社區目錄中歸類爲 趣味換裝；源碼與說明見 GitHub 倉庫，目錄頁見 SkillHub 插件頁。許可證爲 MIT。

核心功能¶

工作鏈路與動畫¶

桌寵會跟隨 Agent 狀態切換動畫：開工時進入「開始工作」；運行中約每 10.5 秒在認真工作、摸魚、思考等狀態間隨機輪播；任務結束時播放收工慶祝。長任務超過閾值（默認 10 分鐘，可在設置中調整）會觸發「看錶」動畫；忙時點擊桌寵會播放「被打擾」反應。資源爲 46+ 透明 WebM（VP9 alpha），支持 prefers-reduced-motion。

用量、花費與看板¶

任務結束時頭頂氣泡會給出用時、token 消耗與花費估算，並按 緩存命中 / 緩存未命中 / 輸出 三桶拆分；計價按 DeepSeek 官方價目與事件時間選檔，含北京時間峯谷（工作日 9:00–12:00、14:00–18:00 高峯爲空閒價 2 倍）。側邊 數據看板（📊 按鈕）用手寫內聯 SVG 展示今日分時或近 N 天（1–30 天可配）的花費或 token，三桶堆疊柱、高峯底紋與緩存命中率彙總；數據來自 session/event 增量統計，啓動時可通過 sessionPersistence 補掃歷史會話。只讀接口爲 GET /api/whale-pet/usage（可選 ?hours=1..24&days=1..30）。

輸入框下方與會話內動作行還會顯示 會話累計 與 單輪 費用 pill，口徑與氣泡、餘額按鈕共用 lib/usage.js；DSH 0.1.6-alpha.2 起官方 composer dock 改爲橫向 flex 行後，本插件費用項已按新佈局註冊爲行內 flex 項。

餘額、天氣與互動¶

餘額（💰）調用官方餘額接口，展示餘額與今日消耗/花費（同樣三桶與峯谷拆分），並播放「翻錢包」動畫。明日天氣（☁️）支持中文城市名或留空自動定位，宿主內直接 fetch，僅 Node 出網失敗時退回 PowerShell 兜底路由 /api/whale-pet/weather-shell。投餵（🍪）爲 TOKEN 小魚乾互動（30 秒冷卻）。另有睡眠系統（空閒 5 分鐘入睡）、時間感知（如 12:00 盒飯、深夜犯困）及可選番茄鍾、深夜關懷、隨機小劇場、漫遊開關等，均在設置面板可調。

本 fork 的增量能力¶

1. 桌寵大小：拖拽右下角斜槓把手，或在 DSH 設置 → 桌寵配置 中用滑塊/預設（小 180、中 260、大 360、特大 480）；範圍 80–600px，寫入 settings.yaml 的 size。側邊按鈕尺寸隨 --wb-scale 等比縮放，鼠標移入桌寵才顯示按鈕（查詢/看板/拖拽時保持可見；觸屏常顯）。

2. 任務播報語音：任務完成、中斷（turn/end 且 reason.kind: 'aborted'）、失敗時朗讀，並帶上本輪第一條人類提問作爲任務名（超長截斷至 24 字）。默認使用 Edge 神經網絡 TTS（宿主合成 MP3，無需 API Key，實現見 lib/edge-tts.js）；失敗時退到瀏覽器 speechSynthesis。內置 16 個角色預設（胡桃、派蒙、鍾離、納西妲、可莉、東北大姨、陝西妹子、港風/臺妹等），可在設置中試聽並切換；總開關 voiceEnabled 默認開啓。

3. 天氣與餘額：由 fork 說明改爲 宿主側直連，不再依賴會話內 shell，從而不受沙箱與審批策略阻擋。

安裝與啓用¶

在已安裝 DSH CLI 的環境中，從 npm 安裝（資料原文命令如下）：

# 從 npm 市場安裝（推薦）
dsh plugin --profile web add dsh-whale-girl-pet

# 或從本地 tarball 安裝
dsh plugin --profile web add dsh-whale-girl-pet-0.3.0.tgz

安裝後需 重啓 dsh web，再刷新瀏覽器；桌寵默認出現在右下角。修改插件客戶端 bundle 或 lib/ 下宿主邏輯後也必須重啓進程，僅刷新頁面無法加載新代碼。

兼容性：README 標明 0.3.2 系在 DSH 0.1.6-alpha.2 上驗證；peerDependencies 爲 ^0.1.6-alpha.2。DSH alpha 線變更時 peer 範圍可能需要隨宿主更新，否則包管理器可能提示 peer 未滿足（一般爲警告，不影響運行）。

典型用法¶

1. 安裝並重啓 dsh web 後，在 Web UI 右下角觀察桌寵隨 Agent running / idle 切換動畫。
2. 跑完一輪任務，查看頭頂 任務完成 氣泡中的用時、token 與三桶花費；需要細查時點擊 📊 打開分時段看板，或點擊輸入框旁的 會話費用 pill 看累計明細。
3. 需要聽播報時，打開 DSH 設置 → 桌寵配置，確認「任務播報語音」開啓、引擎選 edge，點選角色（默認胡桃）試聽；關閉語音則只保留氣泡。
4. 查餘額或明日天氣：鼠標移入桌寵，點 💰 或 ☁️；天氣城市可在設置中填寫，留空則自動定位。
5. 調整觀感：拖桌寵右下角把手改大小，或在設置裏改「按鈕位置（左/右）」、關閉「漫遊走動」讓桌寵固定位置。

適用場景與注意¶

適合長期在 DSH Web 界面開發、希望用桌寵感知任務節奏，並希望在同一處查看 峯谷與緩存三桶 花費的開發者。語音角色音色爲 Edge TTS 音調語速近似，並非遊戲原聲錄音。

插件以 當前 dsh web 進程權限 運行：會註冊 /api/whale-pet/* 等路由、讀取會話持久化數據做用量補掃、並在宿主內請求餘額與天氣。安裝前建議在 GitHub 查閱源碼與 MIT 許可證；社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，屬於 DSH「一切皆插件」生態中的第三方條目。

結尾¶

dsh-whale-girl-pet（YEJASONJIEXIN 胡桃語音 fork）把桌寵動畫、用量看板、餘額天氣與可選 16 角色任務播報集中在 Web 右下角，並針對 DSH 0.1.6-alpha.2 的 composer 佈局做了費用 pill 適配。安裝命令見上文；詳情與配置表以倉庫 README 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/YEJASONJIEXIN/dsh-whale-girl-pet
• GitHub：https://github.com/YEJASONJIEXIN/dsh-whale-girl-pet