前言¶
在 DSH 裏做 DeepSeek 相關開發或日常對話時，餘額、峯谷時段和今日用量往往要切到別的頁面或插件面板才能看到。社區裏已有「小鯨魚 + 餘額掛件」一類客戶端插件，功能完整但界面與交互偏臃腫。下面介紹維護者 Cdkgfp 發佈的 dsh-whale-pro：在保留鯨魚掛件與餘額能力的前提下，用常駐信息欄和內聯設置頁收攏冗餘部分，面向 DSH Desktop 爲主的使用場景。
這是什麼¶
dsh-whale-pro 是 DSH 的 bundle 插件，包名、掛載 id 與 GitHub 倉庫名均爲 dsh-whale-pro。簡介爲：DSH 桌面端小鯨魚簡潔版——常駐梁文峯 / 梁文谷 / 時間線 / 餘額信息欄，並大幅優化原插件冗餘部分。
本倉庫是 DeepSeek-Balance-Whale-Widget 的簡潔分支（fork），基於上游 0.4.2 改造；當前正式版爲 0.4.4（含認證安全修復）。代碼部分爲 MIT 許可；美術與音頻素材按倉庫內 PROVENANCE.md 說明提供，版權歸上游作者及貢獻者所有。
分類上屬於 客戶端 插件；GitHub 星標以目錄頁展示爲準（抓取時爲 0）。倉庫尚未發佈到 npm，安裝以 GitHub 源或桌面端 plugin_manager 爲主。
核心功能¶
常駐信息欄與峯谷時間線¶
右下角鯨魚頭頂顯示緊湊信息欄：餘額、贈金、充值餘額、今日已用等。梁文峯 / 梁文谷 / 時間線連續展示爲峯谷進度條，並標出當前時間線。
自動提示泡泡¶
餘額變化、提問、每輪消耗、授權、餘額預警、今日預算等場景可分別配置：每種有獨立開關、內容編輯和預覽。點擊鯨魚不再打開舊的大泡泡；自動提示泡泡保留。
內聯設置頁¶
通過菜單按鈕打開設置（可在「行爲」裏隱藏菜單按鈕，此時右鍵鯨魚喚出；移動端長按約 1.5 秒）。設置分爲四類，橫線分隔、膠囊開關，修改即時生效：
- 外觀：角色、大小、角色圖管理。
- 行爲：避讓滾動條、隱藏菜單按鈕、文字框顯示開關。
- 音效：總開關、按壓 / 任務結束 / 提問 / 授權四類音量與試聽；音頻片段導入、試聽、刪除；音效組選擇（音量滑條 0–100，默認 100%）。
- 自動提示泡泡：總開關、六種場景、泡泡圖片庫。
兩處「總開關」關閉後，對應分組整體變灰且不可操作。
本地記賬與憑據¶
餘額變化按觀測累計「今日已用」；賬本與設置保存在本機 $DSH_HOME（通常爲 ~/.dsh），例如 .dshw-usage.json、.dshw-size.json 等。API 密鑰通過 DSH 憑據服務讀寫，不寫入插件配置文件；未配置憑據時掛件仍會加載，餘額與今日已用可能爲空或顯示 —，不影響 DSH 本身。
餘額取數優先使用憑據中的 DEEPSEEK_API_KEY；若只登錄 DeepSeek 賬號而未配置 API key，較新的 DSH 會使用賬號登錄態。
安裝與啓用¶
安裝前請知悉：插件以當前 DSH 進程權限運行，管理類寫操作依賴宿主認證與（默認可選的）迴環地址檢查；遠端管理須配置 DSHW_ADMIN_HOSTS 且不能關閉認證。安裝前應自行查看倉庫源碼與 LICENSE。
DSH Web / CLI¶
在 Web 或 CLI 形態下執行：
dsh plugin --profile web add github:Cdkgfp/dsh-whale-pro
安裝後重啓 dsh web，再按 Ctrl+F5 刷新頁面。
官方桌面客戶端¶
桌面端讀取 desktop profile；dsh plugin 按設計拒絕直接操作 desktop profile，不要照搬上面的 --profile web 命令。
在桌面端會話裏使用宿主內置的 plugin_manager 安裝：
github:Cdkgfp/dsh-whale-pro
也可將倉庫克隆到固定目錄後，用 plugin_manager 的本地 link: 方式指向該目錄；掛載 id 與包名均應爲 dsh-whale-pro。若已安裝舊包 dsh-whale-compact 或同名插件，應先報告來源與版本，用宿主支持的方式卸載再裝，勿刪除用戶賬本、設置、角色圖、音頻或憑據。
首次安裝後若界面未出現，請完全退出 DSH（含托盤）再重新打開。當前 npm 未發佈時，Web 側仍用 github:Cdkgfp/dsh-whale-pro；發佈後 Web 可改爲 dsh plugin --profile web add dsh-whale-pro。
與舊安裝、憑據名的關係¶
升級前若使用過非 DSHW_ 前綴的自定義憑據名，需在模型設置中改用 DSHW_ 開頭名字（最多 64 個字母、數字或下劃線）並重新配置密鑰；插件不會自動改名或刪除舊憑據。
典型用法¶
- 安裝並重啓或刷新後，在界面右下角找到小鯨魚與頭頂信息欄，確認峯谷條與餘額字段是否符合預期。
- 打開設置頁：調整外觀中的角色與大小；在「行爲」中按需隱藏菜單按鈕或開啓文字框顯示。
- 在「自動提示泡泡」中爲餘額預警、今日預算等場景打開開關並編輯文案，用預覽確認後再使用。
- 在「音效」中調節四類提示音量，或導入音頻片段並選擇音效組；需要靜音時關閉音效總開關即可。
- 憑據與餘額：在 DSH 模型設置中配置
DEEPSEEK_API_KEY或依賴較新宿主的賬號登錄態；本地今日已用由插件在本機$DSH_HOME內累計，無需手動導出。
適用場景與注意¶
適合誰：主要在 DSH Desktop 上工作、希望一眼看到 DeepSeek 餘額、峯谷時段與今日用量，又不需要舊版大泡泡交互的用戶。Web 模式也可安裝，但桌面端請走 plugin_manager。
宿主能力：0.4.4 通過運行時檢查強制要求宿主提供 connection.requestRejection(req) 等准入接口；缺少該能力的舊宿主需升級 DSH。README 記錄桌面開發環境曾爲 DSH Desktop 0.2.1-rc.3，0.4.4 的隔離後端迴歸尚未在真實桌面會話中複測，升級後建議自行驗證管理頁與餘額拉取。
安全與網絡：自定義餘額/探活接口不跟隨重定向；雲元數據、link-local 等危險地址會被拒絕。反向代理部署時應在代理入口限制管理訪問，插件不信任 X-Forwarded-For 等頭證明本機身份。
生態說明：DSH 社區插件目錄（如 skillhub、dshbase、dsh-plugin.org 等）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本倉庫帶 dsh-plugin topic 可被市場掃描收錄，但未發 npm 時不會出現在僅列出 npm 一條命令安裝的內置 Plugin Hub 中。
結尾¶
dsh-whale-pro 把鯨魚掛件上的峯谷、時間線與餘額收成常駐欄，並用內聯設置與可選自動泡泡替代冗餘交互，適合在 DSH 桌面端長期開着看用量。進一步瞭解可訪問插件目錄頁與 GitHub 倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/Cdkgfp/dsh-whale-pro
- GitHub：https://github.com/Cdkgfp/dsh-whale-pro
