前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。對於習慣在 Web 界面長期運行智能體的開發者而言，界面往往是靜態的。dsh-whale-girl-pet 插件在 DSH Web 界面右下角部署了一隻藍髮鯨魚女僕，通過工作鏈路動畫、費用統計和日常互動，爲長時間的開發會話提供一種可視化的陪伴與狀態反饋。
工作鏈路與互動¶
插件內置 46+ 透明動畫（WebM VP9 alpha），覆蓋多種場景：
- 工作鏈路：包括開工（出現電腦桌敲鍵盤）、工作輪播（認真工作/摸魚/思考/摸魚被抓）、收工慶祝、被打擾等狀態。
- 時間感知：根據當前時間觸發不同狀態，例如 8:00–10:00 睡眼惺忪，12:00 喫盒飯，23:00–3:00 迷糊犯困。
- 睡眠系統：空閒 5 分鐘後自動入睡，被操作時喚醒。
- 互動：支持投餵（喫 Token 小魚乾，30 秒冷卻）。
費用統計與看板¶
該插件提供了一套完整的費用追蹤體系，數據來源統一。
任務完成氣泡與 Pill¶
每輪任務結束時，會彈出包含用時、消耗和花費的氣泡。花費按三桶拆分：緩存命中、緩存未命中、輸出。在輸入框下方和每條回覆的動作行中，也提供了本會話累計費用和本輪費用的 Pill，點擊可查看緩存命中/未命中/輸出的明細。
數據看板¶
點擊看板按鈕（📊）可打開一個內聯 SVG 看板，支持今日分時和近 7 天視圖。Y 軸支持花費和 Token 兩種指標切換，圖表按緩存命中（藍）、未命中（橙）、輸出（紫）三段堆疊。
看板底部顯示緩存命中率（計算口徑爲 cacheRead / (input + cacheWrite + cacheRead)），並附帶彙總數據（近 24 小時、今日、均值、輸入、輸出）。
數據來源：實時數據來自 ctx.on('session/event') 增量摺疊，歷史數據來自啓動時 sessionPersistence 的補掃。數據去重通過「每會話已見 seq 集合」和「調用身份」雙重校驗。
日常功能¶
餘額與用量¶
點擊餘額按鈕可查詢當前餘額、今日 Token 消耗與花費。費用計算基於 DeepSeek 官方價目，2026-09-10 起針對 Flash 系列進行了新調價（空閒/高峯價），週末全天按空閒計價。
天氣與設置¶
點擊天氣按鈕可查看明日天氣，支持中文城市名或自動定位。在 DSH 設置面板的「桌寵配置」中，可調整番茄鍾提醒、深夜關懷、漫遊開關、按鈕位置、看板歷史補掃開關、看板窗口天數、長任務閾值及天氣城市。
安裝與配置¶
- 運行安裝命令：
dsh plugin --profile web add dsh-whale-girl-pet
- 重啓
dsh web進程。修改客戶端 bundle 後必須重啓，否則新代碼不生效。 - 刷新瀏覽器頁面，桌寵將出現在右下角。
注意事項¶
- 重啓要求：插件更新或修改
lib/文件後，必須重啓dsh web才能生效，僅刷新瀏覽器頁面不夠。 - 計費規則：價格基於 DeepSeek 官方價目，Flash 系列有新的調價（2026-09-10 起），週末全天按空閒計價。
- 接口限制：數據看板使用只讀接口
GET /api/whale-pet/usage。 - 數據來源：數據完全依賴宿主提供的
sessionPersistence和事件流，不依賴外部數據庫。
總結¶
dsh-whale-girl-pet 通過可視化的桌寵、精確的費用分桶統計以及 SVG 數據看板，將 DeepSeek Harness 的使用體驗從單純的命令行交互擴展到了桌面陪伴層面。其計費口徑與官方保持一致，適合需要精細監控 Token 消耗和會話費用的開發者使用。
