前言¶

DSH 強調「一切皆插件」。在 DSH Web 界面使用 DeepSeek 模型時，查看賬戶餘額和退出本地服務可以不必離開頁面。dsh-balance-float 是一個 Web 插件，在右上角增加一個懸浮窗，用於顯示 DeepSeek 模型賬戶餘額、手動刷新余額，並在確認後關閉本地 DSH 服務。

這是什麼¶

下面介紹這個插件的定位和邊界。

• 插件名：dsh-balance-float
• 類型：DSH Web 插件
• 維護者：x2802490130-prog
• 許可證：MIT
• GitHub 倉庫：https://github.com/x2802490130-prog/dsh-balance-float

它屬於 DSH 社區插件生態中的 Web 插件。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解爲官方應用商店應用。

核心功能¶

先說它能做什麼：

• 右上角懸浮窗顯示 DeepSeek 模型賬戶餘額
• 懸浮窗每 60 秒自動刷新，展示 總餘額 / 贈送 / 充值 明細
• 點擊 ↻ 按鈕手動刷新余額
• 點擊 ⏻ 按鈕觸發優雅退出，按 Y 確認，按 N 或 Esc 取消
• 退出後關閉本地 DSH 服務與 http://127.0.0.1:3080 網頁
• 提供本地 HTTP 接口：GET /api/dsh-balance 與 POST /api/dsh-exit

環境要求¶

安裝前先確認環境：

1、已安裝 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh

2、Node.js 版本滿足：

Node.js >=18

3、已配置 DeepSeek API Key。未配置時，懸浮窗會顯示「獲取失敗」紅點。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add dsh-balance-float

安裝後重啓 dsh，或硬刷新網頁：

Ctrl+F5

經過上面的步驟，DSH Web 頁面右上角會出現餘額懸浮窗。

典型用法¶

下面是可復現的操作路徑：

1、點擊懸浮窗主體，展開餘額明細，包括 總 / 贈送 / 充值 / 更新時間。
2、點擊 ↻，立即刷新余額。
3、點擊 ⏻，彈出退出確認框。
4、按 Y，確認退出；本地 DSH 服務與 http://127.0.0.1:3080 網頁會被關閉。
5、按 N 或 Esc，取消退出。
6、再次點擊 ⏻，關閉確認框。

配置餘額查詢¶

餘額查詢依賴 DeepSeek API Key。可以配置環境變量，或配置 credentials 文件中的 DEEPSEEK_API_KEY。

配置項：

DEEPSEEK_API_KEY

credentials 文件示例：

DEEPSEEK_API_KEY: <你的 Key>

API Key 僅用於服務端請求，不會出現在網頁響應中。

本地 HTTP 接口¶

兩個接口只掛在本地 dsh 服務上，不對外暴露：

GET /api/dsh-balance
POST /api/dsh-exit

GET /api/dsh-balance 用於餘額查詢。
POST /api/dsh-exit 用於優雅退出：執行 SIGINT 關閉 dsh，並有 6 秒兜底強殺。

適用場景與注意¶

適合已經使用 DSH Web 界面、希望直接在頁面內查看 DeepSeek 餘額並退出本地服務的場景。

注意以下幾點：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證。
• 未配置 API Key 時，餘額區域會顯示「獲取失敗」紅點。
• 退出接口會關閉本地服務和網頁，適合明確要結束當前 DSH Web 會話時使用。
• 本地接口不對外暴露，但不代表可以隨意調用退出接口，因爲它會終止當前 dsh 服務。

結尾¶

dsh-balance-float 把 DeepSeek 餘額查看、手動刷新和本地 DSH 服務退出收進 Web 界面。如果你已經在用 DSH Web，它可以作爲右上角的一個輕量入口。

GitHub 倉庫：

https://github.com/x2802490130-prog/dsh-balance-float