前言¶
DeepSeek Harness (DSH) 在運行智能體時，頁面彈出的確認請求或任務完成狀態常被用戶忽略，尤其是在掛機或切換窗口時。此外，手動監控 GPU/CPU 佔用率通常需要打開任務管理器。鯨寶語音桌寵是一個 DSH 插件，它通過語音播報確認與提問、任務完成提醒，以及實時顯示系統資源佔用，解決了上述問題。它基於 MiniMax H3 圖生視頻技術，提供流暢的動畫效果，是一個兼具工具屬性與陪伴功能的桌面組件。
核心功能¶
插件主要包含以下能力：
-
語音提醒與播報
- 確認與提問：當頁面彈出“需要確認”的請求框或 Agent 提問時，鯨寶會通過氣泡和語音播報提醒。語音使用專屬聲線（Qwen3-TTS），處理完彈窗後會自動安靜，且能智能識別彈窗關閉和自動審批，防止重複播報。
- 任務完成：檢測到對話回合結束頁腳（
data-turn-tail）時，自動播報“任務完成啦”。這是基於真實任務結束標誌觸發的，不會誤報會話統計或後臺任務卡片。
-
實時性能監測
- 通過右鍵菜單開啓“性能監測”功能，鯨寶會顯示 CPU、內存、GPU 的實時佔用率（1秒刷新）。
- GPU 佔用率被用作任務“心跳”指標：數值波動表示任務進行中，數值靜止通常表示任務完成或卡死。監測服務內置在插件內，隨 DSH 自動啓停。
-
H3 真動畫與交互
- 使用 MiniMax H3 圖生視頻技術，生成首尾幀無縫、無殘影的流暢動畫。包含揮手、眨眼、比心、打哈欠、瞌睡等動作。
- 支持點擊/拖拽/縮放交互：左鍵點擊觸發賣萌語音與愛心特效；按住拖拽觸發被抓動畫；滾輪縮放大小（128~512）。
-
情感陪伴與狀態機
- 瞌睡狀態機：3分鐘無操作後，鯨寶會打哈欠、頭頂飄💤、歪頭瞌睡；鼠標移動後會醒來。
- 報時與關懷：支持整點報時、節日祝福、連續工作50分鐘提醒休息、深夜22點後提醒睡覺。
安裝與配置¶
注意：v1.8.0 版本起，插件改爲官方組合包結構，無需手工複製目錄或配置文件。素材存放位置由前端 dist 改爲包內 assets，以支持桌面端只讀文件系統。
安裝命令¶
使用官方 CLI 進行安裝：
# 網頁版安裝
dsh plugin --profile web add github:windfind-02/jingbao-voice-pet
# 桌面端安裝（必須使用桌面端專屬 CLI）
& 'C:\...\DeepSeek harness桌面端\resources\runtime\cli\bin\dsh.cmd' `
plugin --profile desktop add github:windfind-02/jingbao-voice-pet
安裝後需要重啓對應宿主（網頁版按 Ctrl+F5，桌面端需從托盤退出後重啓）。
升級說明¶
如果你是從 v1.7.0 或更早版本升級，必須先卸載舊版再安裝新版。v1.8.0 做了破壞性結構調整（改爲官方組合包），舊版代碼無法直接更新。刪除舊安裝的路徑通常爲：
Remove-Item "$env:USERPROFILE\.dsh\profiles\node_modules\@local\dsh-pet" -Recurse -Force
並從各 profile 的 cordis.patch.yml 中移除相關插件 ID。
使用方法¶
安裝完成後，鯨寶會出現在對話頁面中。
- 開啓監測：在桌寵上點擊右鍵，選擇“開啓性能監測”，即可查看 CPU、內存、GPU 佔用。
- 交互操作：
- 點擊：觸發賣萌語音和愛心特效。
- 拖拽：按住移動位置，位置會被記住。
- 縮放：使用鼠標滾輪調整大小（128~512）。
- 音量控制：通過右鍵菜單的音量條調節，支持靜音和語音總開關。
注意事項¶
- 桌面端限制：桌面端沒有刷新快捷鍵（Ctrl+R/F5 被攔截）。修改配置後，必須通過托盤圖標右鍵 → 退出，然後重新打開程序。臨時刷新可在開發者工具 Console 中執行
location.reload()。 - 硬件依賴：GPU 監測功能需要 NVIDIA 顯卡。
- 舊版兼容性：舊版本與新版結構不兼容，無法直接通過右鍵菜單“立即更新”升級，必須卸載重裝。
