前言¶
DSH 的服務啓動、停止、狀態查看和 GUI 打開，通常分散在命令行與瀏覽器入口。dsh-whale-pet 將這些動作整合到一個 Windows 桌面寵物程序裏：先檢測 DSH 服務，未運行則後臺拉起，就緒後再打開 GUI。
下面介紹它的核心能力、安裝方式、典型用法和依賴。
這是什麼¶
dsh-whale-pet 是一個 Windows 桌面寵物程序，由 miku00039-01 維護。它把 DeepSeek Harness（下文稱 DSH）的服務啓動、停止、狀態監測和 GUI 喚起整合到一個零依賴的 .exe 裏。
適合需要在 Windows 桌面上用鼠標完成 DSH 服務啓停、狀態查看和 GUI 打開的人。
核心能力¶
- 一鍵啓動：檢測 DSH 服務；未運行則後臺拉起；就緒後打開 GUI。
- 人形桌寵：逐像素透明懸浮窗，可拖動、記住位置。
- 雙擊喚起：雙擊桌寵打開 GUI，複用同一 PWA 窗口，不堆標籤頁。
- 右鍵菜單：打開程序、關閉程序、查看狀態、退出。
- 關閉程序：只停 DSH 服務並關閉 GUI 應用窗口；按窗口標題精確匹配，不影響其他瀏覽器頁面。
- 托盤圖標：左鍵喚起，右鍵菜單作爲兜底入口。
- 狀態監測：僅綠/紅兩態；在線 5 秒、離線 2 秒自適應頻率。
- 狀態卡片：顯示服務狀態、地址、PID、運行時長，以及桌寵內存和 GDI 句柄。
- 單實例：重複雙擊不會開第二個實例。
- 崩潰日誌：未捕獲異常自動寫入
dsh-whale-pet-crash.log。 - DSH 插件：可作爲插件安裝，並在 DSH 中使用
/whalepet啓動。
安裝與啓用¶
可以作爲 DSH 插件安裝。執行：
dsh plugin --profile web add github:miku00039-01/dsh-whale-pet
安裝完成後，在 DSH 中運行：
/whalepet
即可啓動鯨魚娘桌寵。
也可以從 Releases 下載 DSH桌寵.exe，雙擊運行。首次運行會在 exe 同目錄生成 dsh-whale-pet.conf，可按需修改。
如果要從源碼構建，運行：
pwsh -File build.ps1
如果要觸發 CI 自動構建 Release，可以推送 v* 標籤，例如：
git tag v1.0.0
git push origin v1.0.0
典型用法¶
下面給出幾個可復現步驟。
1、安裝插件後，在 DSH 中輸入：
/whalepet
啓動桌寵。
2、雙擊桌寵，喚起 GUI。桌寵複用同一 PWA 窗口，不堆標籤頁。
3、右鍵桌寵，從菜單中選擇：
打開程序
關閉程序
查看狀態
退出
4、右鍵托盤圖標，也可以使用兜底入口。
5、如果 GUI 默認打開方式不符合預期，修改 dsh-whale-pet.conf 中的 pwaShortcut，指向別的 PWA 快捷方式；置空則始終用默認瀏覽器打開。
依賴與運行方式¶
必選依賴：
- Windows 10 / 11
.NET Framework 4.x- 正確安裝
DeepSeek Harness，包括Node.js、dsh CLI全局安裝、已配置DEEPSEEK_API_KEY
可選依賴：
Chrome，用於 PWA 獨立窗口；未安裝或未找到時，自動回落到默認瀏覽器打開
桌寵通過 node 拉起 DSH 服務，並監聽：
127.0.0.1:3080
啓動服務時，桌寵使用：
dsh web --no-open
這樣可以避免 DSH 默認自動打開瀏覽器造成雙窗口。
“關閉程序”只停 DSH 服務並關閉 GUI 應用窗口，不影響其他瀏覽器頁面。
注意事項¶
- 代碼許可證爲
MIT。 - 素材部分需遵循
assets/WHALE_ATTRIBUTION.md的授權說明；使用或分發前確認符合要求。 - 插件以當前
dsh進程權限運行。安裝前應先檢查源碼與許可證。 dsh-whale-pet是 DSH 插件生態中的第三方項目，不應視爲官方應用商店或官方組件。
鏈接¶
GitHub：
https://github.com/miku00039-01/dsh-whale-pet
可以訪問倉庫查看源碼、構建腳本和素材授權說明。
