前言¶
調用 DeepSeek API 時，有幾件事要反覆人工確認：餘額還剩多少、今天已經花了多少、現在是不是峯段計價。官方平臺能查到這些數據，但需要切出開發環境單獨去看。dsh-plugin-api-usage-monitor 把這三件事搬進 DeepSeek Harness 的 Web 側邊欄。下面介紹它的功能、安裝與日常用法。
這是什麼¶
dsh-plugin-api-usage-monitor（版本 1.9.0-rc.4）是一個爲 DeepSeek Harness Web 側邊欄設計的 API 用量、餘額與費用監控插件，由 ninedaywoo-web 維護。它把 API 餘額做成血條，把當天消耗做成架勢條，並用「樑子 / 梁聖」提示峯谷時段。
需要先說明兩點：這是非官方社區插件，與 DeepSeek 官方無隸屬或背書關係；文檔截圖中的金額爲演示數據。代碼採用 MIT License。
核心功能¶
插件提供的能力如下：
- 餘額血條：顯示當前餘額相對滿血上限的比例，正常消費只扣血，不會莫名回滿
- 今日架勢條：顯示當天消費相對每日預算的比例，充值或刷新血條不會清零
- 峯谷狀態：峯段顯示「樑子」，谷段顯示「梁聖」，點擊可展開價格時段、倒計時、餘額與計價分桶詳情
- 充值與刷新：點擊血瓶前往 DeepSeek 官方充值頁，充值完成後可手動刷新血條上限
- 一鍵重啓：從側邊欄重啓當前 Harness，Windows 使用最小化監督終端，macOS 使用後臺監督器
- 狀態持久化：重啓 Harness 後保留血條基準和當天消費狀態
- API 用量、每日費用與 token 跟蹤
- 狀態欄可拖動臨時移位，雙擊歸位
安裝與啓用¶
先確認使用條件：
- 已配置
DEEPSEEK_API_KEY且能正常運行的 DeepSeek Harness（0.1.0-rc.6或兼容版本） - Node.js
^22.19.0或>=24.0.0
插件不負責安裝 Harness，也不會替 Harness 配置 API Key。
然後從 GitHub 的 Releases 頁面下載最新的 dsh-plugin-api-usage-monitor-*.tgz，運行下面的命令完成安裝，把路徑換成你下載的文件：
dsh plugin --profile web add "/absolute/path/to/dsh-plugin-api-usage-monitor-1.9.0-rc.4.tgz"
這條命令把插件加入 web profile。接着運行：
dsh web
啓動或重啓 Web profile 後，刷新 Harness 網頁即可看到側邊欄組件。插件會保留在 web profile 中，之後不需要每次重新安裝。
平臺支持方面：Windows 10/11 已完成隔離安裝測試；macOS 爲候選支持，仍需真機驗收。macOS 的重啓監督器在後臺運行，監督日誌寫入 $DSH_HOME/logs/dsh-balance-bar-supervisor.log。
典型用法¶
經過上面的步驟，插件已經在側邊欄運行，日常操作集中在組件本身：
1、點擊血瓶，展開「前往官方充值」和「刷新血條」兩個操作。充值完成後點擊「刷新血條」，當前餘額會成爲新的滿血上限，今日架勢條不會清零。
2、點擊「樑子 / 梁聖」，查看當前峯谷狀態、倒計時、餘額、今日消費和計價分桶。
3、點擊圓形箭頭，重啓當前 Harness。網頁會等待新的 Harness 實例真正啓動後再恢復。
4、拖動狀態欄可以臨時移位，雙擊歸位。
其中 Windows 的重啓監督器使用一個最小化常駐終端，目的是避免週期性彈出 PowerShell 窗口。
狀態存儲與卸載¶
插件自己的血條狀態存儲於 $DSH_HOME/storages/balance-bar-day.json，這也是重啓 Harness 後狀態能保留的原因。卸載命令如下：
dsh plugin --profile web remove dsh-plugin-api-usage-monitor
卸載不會刪除 Harness 會話。如需完全清理，可在 Harness 停止後手動刪除上述狀態文件。
隱私與安全¶
- API Key 只由 Harness 憑據模塊在宿主端讀取，不發送到瀏覽器
- 插件直接向 DeepSeek 官方餘額接口讀取餘額，不上傳遙測數據
- 重啓接口只接受本機環回地址發出的同源請求
- 安裝包不含安裝腳本
適用場景與注意¶
它適合這樣一類 DSH 用戶：同時跑多個會話、關心峯谷計價和每日預算，希望餘額扣減在寫代碼時一眼可見，而不是每次都切去官方平臺查賬。
安裝前注意兩點。第一，插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證：倉庫提供 npm test、npm run preflight、npm pack --dry-run 三條命令用於開發與驗證，代碼採用 MIT License，但角色圖片不在 MIT 授權範圍內，詳見倉庫中的 ASSET-NOTICE.md。第二，macOS 支持尚未完成真機驗收，目前以 Windows 10/11 的測試結論爲準。
小結¶
dsh-plugin-api-usage-monitor 把餘額、每日消費和峯谷時段做成一眼可讀的血條與架勢條，配合充值跳轉和一鍵重啓，減少了在官方平臺和開發環境之間的來回切換。DSH 的理念是「一切皆插件」，這類側邊欄組件是社區在補齊使用體驗上的一個例子。
- GitHub 倉庫：https://github.com/ninedaywoo-web/DSH-Plugin-API-Usage-Monitor
- 社區目錄頁（獨立站點，與 DeepSeek / 幻方無官方從屬關係）：https://www.skillhub.cn/plugins/ninedaywoo-web/DSH-Plugin-API-Usage-Monitor
