前言¶
在 DSH Web 中部署模型調用後，餘額、今日消費、Tokens 和請求數通常需要分別查詢或估算。價格表估算也不能完全代表實際扣費。
dsh-api-usage 是一個 DSH Web 插件，把 DeepSeek API 餘額與用量集中到側邊欄底部，方便日常查看當前狀態。
dsh-api-usage 是什麼¶
dsh-api-usage 由 chenzhexii 維護，倉庫地址爲 github.com/chenzhexii/dsh-api-usage，許可證爲 MIT。
它面向 dsh web 的 Web profile，在側邊欄底部提供一個常駐小部件，展示餘額、今日消費、今日 Tokens、請求數和 24h 消費柱狀圖。
核心功能¶
- 常駐位置：側邊欄底部，設置按鈕上方。
- 餘額查看：每 60 秒查詢一次
/user/balance。 - 今日消費：按相鄰兩次餘額差值計算真實消費，精度
¥0.01。 - 用量統計：今日 Tokens 和請求數來自每次模型調用的
usage上報。 - 手動刷新：點擊「↻」強制刷新余額，並立即結算差值更新今日消費。
- 充值入口：藍色「充值」按鈕通過
window.open打開 DeepSeek 充值頁。 - 失敗兜底：餘額查詢失敗時顯示最近一次餘額，並在 10 秒內自動重試。
- 持久化：今日消費、Tokens、請求數和餘額基準落盤到
$DSH_HOME/.ds-api-usage-state.json。 - 響應式：側邊欄寬/摺疊兩態自適應，窄窗口自動精簡。
- 路由保護：
/ds-api-usage/snapshot僅限環回地址訪問。 - 數據保留：小時桶保留
48h，天桶保留14天，並自動滾動淘汰。
安裝與啓用¶
先確認環境滿足以下要求：
- DeepSeek Harness Web profile（
dsh web），dsh plugin可用pnpm - 宿主側
Node ≥ 20 - 已配置
DEEPSEEK_API_KEY憑據 - Host 上可用
curl，用於餘額接口，經subprocess seam調用
執行安裝命令：
dsh plugin --profile web add github:chenzhexii/dsh-api-usage
然後重啓 dsh web，刷新頁面。之後可在側邊欄底部看到小部件。
典型用法¶
- 查看即時面板：頁面刷新後，側邊欄底部顯示餘額、今日消費、今日 Tokens、請求數和 24h 消費柱狀圖。
- 手動同步：點擊「↻」強制刷新余額，並立即結算差值更新今日消費。
- 充值：點擊「充值」按鈕，打開
https://platform.deepseek.com/top_up。 - 調整輪詢間隔：修改
src/index.js中的ctx.interval(..., 60000)。 - 查看狀態文件：
$DSH_HOME/.ds-api-usage-state.json保存今日消費、Tokens、請求數和餘額基準。 - 語法檢查：在倉庫內執行
npm run check，用於語法檢查宿主與客戶端兩端。
適用場景與注意¶
適合已經部署 dsh web、配置了 DEEPSEEK_API_KEY，並希望在瀏覽器側邊欄常駐查看餘額和用量的使用者。
注意以下幾點：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與MIT許可證。 - 插件無需額外配置，開箱即用，複用部署已有的
DEEPSEEK_API_KEY憑據。 - 僅本地
0點按“今日”語義歸零。 /ds-api-usage/snapshot僅限環回地址訪問，跨網絡暴露前應先確認訪問控制邊界。
結尾¶
dsh-api-usage 的價值在於把餘額、消費和用量放到 DSH Web 的日常視圖中，減少頻繁切換接口或依賴價格估算的操作。
GitHub：https://github.com/chenzhexii/dsh-api-usage
目錄頁線索：https://www.skillhub.cn/plugins/chenzhexii/dsh-api-usage
