前言¶
在 DeepSeek Harness（DSH）的 Web 會話裏，一個很常見的問題是：今天大概用了多少額度，賬戶裏還剩多少。已有做法通常是打開控制檯、查餘額接口，或手工記錄餘額變化。
下面介紹一個 DSH Web 插件：arslan-jh/deepseek-harness-usage。它會在對話輸入區下方顯示今日消費和總餘額，並把今日消費明確標記爲估算值。
這是什麼¶
這是一個由 Arslan-jh 維護的 DeepSeek Harness Web 插件，License 爲 MIT。當前資料標註其面向 DeepSeek Harness 0.1.0-rc.6 的 Web profile，並要求 Node.js 22+。
它解決的是賬戶級用量可見性：在 DSH Web 會話中直接回答“我今天用了多少 DeepSeek 額度，賬戶還剩多少”。它不展示每個會話、模型或工具的逐請求消耗，也不替代 Token 分析儀表盤。
核心功能¶
- 今日消費：從當天賬戶餘額變化估算出的人民幣消費額，界面上用
≈表示。 - 總餘額：來自 DeepSeek 官方餘額接口的賬戶級可用餘額。
- 充值識別：充值或贈送額度增加時，不會把當天消費錯誤清零。
- 自動刷新：DSH 宿主和瀏覽器每 3 分鐘更新一次。
- 複用 DSH 憑據：使用 DSH 已配置的
DEEPSEEK_API_KEY，不需要在網頁裏再次填寫 API Key。 - 今日消費校準：可輸入官網數字重新校準。
- 平臺 token：可選實驗功能，嘗試讀取 DeepSeek 官網頁面使用的內部用量接口。
- 刪除平臺 token：隨時清除已保存的平臺 token，恢復餘額差估算。
- 餘額查詢：直接調用 DeepSeek 公開餘額接口查詢賬戶級餘額。
- 日誌補齊：讀取本機 DSH 會話的 Token 記錄，補上午夜到第一次餘額採樣之間可能遺漏的消費。
安裝與啓用¶
如果本機已使用 dsh 命令，執行：
dsh plugin --profile web add github:Arslan-jh/deepseek-harness-usage
dsh --profile web
如果電腦只通過 npx 使用 DSH，執行：
npx @deepseek-ai/dsh plugin --profile web add github:Arslan-jh/deepseek-harness-usage
npx @deepseek-ai/dsh --profile web
安裝後，刷新 DSH Web。打開一個已有會話，或在新會話發送第一條消息後，用量行會出現在對話輸入區下方。
設置與校準¶
進入：
設置 → 通用設置 → DeepSeek 用量顯示
可配置項包括：
- 今日消費校準：如果官網顯示的今日消費與插件估算值不同，可以輸入官網數字重新校準。
- 平臺 token：可選實驗功能。它會嘗試讀取 DeepSeek 官網頁面使用的內部用量接口。
- 刪除：隨時清除已經保存的平臺 token，恢復餘額差估算。
平臺 token 不是必需項。資料說明內部接口不是公開 API，可能隨官網更新失效；失敗時插件會顯示警告，但不會影響總餘額查詢。
今日消費怎麼估算¶
總餘額直接調用 DeepSeek 的公開餘額接口，因此是賬戶級餘額。
今日消費默認可以理解爲：
今日消費 ≈ 今日開始時的餘額 + 今日充值/贈送 - 當前餘額
插件會寫入：
$DSH_HOME/storages/deepseek-usage-day.json
用於保存當天餘額基線。每天第一次運行時，還會讀取本機 DSH 會話的 Token 記錄，補上午夜到第一次餘額採樣之間可能遺漏的消費。
內置價格只採用有公開依據的固定單價；沒有公開文檔支持的未來價格或峯谷規則不會寫進代碼。
使用邊界¶
≈很重要：今日消費是估算值，不是官方賬單明細。- 如果同一個 DeepSeek 賬戶還被其他電腦或應用使用，它們造成的消費也會反映在餘額變化中。
- 本機日誌只用於補齊當天第一次採樣前的空白，不會假裝知道其他客戶端的逐請求明細。
- 本項目的包標識是
@arslan-jh/deepseek-harness-usage；目前請使用 README 中的 GitHub 安裝命令。
隱私與權限¶
插件會執行以下操作：
- 通過 DSH 憑據服務讀取
DEEPSEEK_API_KEY。 - 訪問
api.deepseek.com查詢餘額。 - 讀取本機 DSH 會話統計，用於當天第一次啓動時的日誌回放。
- 寫入
$DSH_HOME/storages/deepseek-usage-day.json保存當天餘額基線。 - 只有主動配置時，才保存並使用
DEEPSEEK_PLATFORM_TOKEN。
資料說明插件不會把 API Key 或平臺 token 返回給瀏覽器，也不包含遙測；配置接口僅接受同源 JSON 請求，並限制請求正文大小。
安裝前注意¶
這個插件會讀取本機 DSH 會話統計，並通過 DSH 憑據服務訪問 DEEPSEEK_API_KEY。它由 DSH 宿主加載，可以視爲以當前 dsh 進程權限運行的本地擴展。安裝前建議先檢查 GitHub 倉庫源碼、package.json、依賴和 MIT 許可證，確認符合本機使用要求。
卸載¶
dsh plugin --profile web remove @arslan-jh/deepseek-harness-usage
相關鏈接¶
- GitHub 倉庫：https://github.com/Arslan-jh/deepseek-harness-usage
- 社區目錄線索：https://www.skillhub.cn/plugins/Arslan-jh/deepseek-harness-usage。該 URL 來自插件線索，未作爲已抓取資料確認；社區目錄不代表 DeepSeek 或幻方官方應用商店。
