前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構。對於開發者而言，在使用 DeepSeek API 進行開發時，實時掌握 API 調用成本和賬戶餘額是必要的。moyunlee/deepseek-ai-dsh-api-cost 插件掛載在 DeepSeek Harness Web profile 上，提供實時費用監控功能。
該插件直連官方餘額接口，不依賴第三方服務。它不僅提供餘額展示，還支持消耗統計、趨勢分析以及對賬功能。安裝後，開發者可以在 Web 界面直觀地看到每次對話產生的費用和 Token 消耗。
功能¶
該插件主要包含以下功能：
- 實時餘額：直連官方
get-user-balance接口，API Key 不出服務器。 - 消耗統計：支持本對話、今日、本月及全局的消耗統計，按模型拆分 Token 與金額。
- 7 日趨勢：展示 V4 Pro / V4 Flash 雙模型的消耗趨勢，支持金額與 Token 切換。
- CSV 對賬：導入 DeepSeek 平臺官方導出的
amount-*.csv，按官方單價重算本地金額後進行對比。 - 價格校準：從官方 CSV 自動提取單價，寫入本地價表。
- 預算告警：設置月度限額，超限可配置 webhook 推送通知。
- 一鍵充值：面板內直達 DeepSeek 用量頁。
- 明暗主題：跟隨系統自動切換，支持手動鎖定白天或夜晚模式。
- 數據不丟：每次調用落盤爲 JSONL 賬本，重啓後按當前價表重算曆史金額。
安裝與啓用¶
安裝命令如下。裝完即自動激活，無需修改配置文件。
pnpm dsh plugin --profile web add ./deepseek-ai-dsh-api-cost-0.1.0.tgz
安裝完成後，啓動 Web 服務：
pnpm dsh web
配置¶
配置文件位於 $DSH_HOME/profiles/web/cordis.patch.yml。該文件與內置默認值合併，只寫需覆蓋的字段即可。
- id: api-cost
config:
# 模型價格配置（¥/百萬 token）
prices:
my-model:
input: 3.0
cacheRead: 0.1
cacheWrite: 3.0
output: 9.0
# 峯谷計費（默認關閉；北京時間高峯 9:00–12:00、14:00–18:00，谷時段半價）
peak:
enabled: true
peakHours: [[9, 12], [14, 18]]
peakMultiplier: 1.0
offpeakMultiplier: 0.5
# 月度預算告警
budget:
monthlyLimit: 50
webhookUrl: 'https://example.com/hook'
# 餘額校準
calibration:
enabled: true
initialBalance: 100
deviationThreshold: 0.05
插件內置了 deepseek-v4-flash 和 deepseek-v4-pro 的默認價表。若官方定價調整，可在對賬時使用 CSV 自動校準。
使用方法¶
- 查看餘額：打開
http://127.0.0.1:3080，左下角顯示「餘額 / 花費」徽章。 - 查看詳情：懸停徽章可查看完整詳情，包括餘額、本對話/今日/本月費用、Token 詳情、7 日趨勢等。
- 跳轉設置：點擊徽章可直接跳轉到設置頁的「用量與消耗」儀表盤。
- CSV 對賬：在設置頁點擊「覈對官方 CSV」，選擇官方導出的
amount-*.csv文件。本地金額會先按 CSV 中的官方單價重算，再與官方金額對比。 - 導出與重置：支持一鍵導出本地賬本 CSV；重置功能會清空全部累計記錄（需確認）。
注意事項¶
- 統計範圍：插件只統計啓用之後產生的調用，歷史會話不回溯。已有賬本會按當前價表重算金額。
- 未配置模型：未在
prices中配置的模型按 0 元計費，Token 仍照常累計。 - 餘額緩存：餘額接口每分鐘緩存一次，減少請求頻率。
- 安全性：API Key 通過憑據服務解析，不會進入瀏覽器。重置/校準接口要求自定義頭
x-dsh-api-cost: confirm以防 CSRF。 - 時區：峯谷計費按北京時間（UTC+8）判斷，不依賴本機時區。
- 兼容性：點擊徽章跳轉設置頁通過設置面板的 DOM 觸發實現，若 Harness 後續改動該面板結構，此跳轉可能失效，但設置頁本身仍可正常訪問。
結語¶
該插件爲 DSH 用戶提供了從餘額監控到賬單對賬的完整鏈路，幫助開發者控制成本。插件源碼託管在 GitHub，遵循 MIT 許可證。
