前言¶
在 DeepSeek Harness（dsh）的網頁端使用 DeepSeek API 時，常見問題不是“有沒有 token 統計”，而是統計之後還缺幾步：當前會話大概花了多少錢、餘額還剩多少、今天是否接近預算、哪個模型花得最多、官方賬單裏的真實扣費能不能對上。
下面介紹一個針對 dsh web 的社區插件：fancr-code/dsh-plugin-usage-meter。它把用量、費用、餘額、預算提醒和官方賬單放到輸入框下方的按鈕式用量條裏，適合長期在 Harness 中跑 DeepSeek 任務的開發者使用。
這是什麼¶
dsh-plugin-usage-meter 是一個 MIT 許可的純 Web 插件，由社區維護，通過 dsh 的官方 profile 機制掛載，不修改 dsh 源碼，卸載後還原。
已覈實資料描述其體積約 0.6MB，無 Electron、無獨立進程、無遙測、無第三方運行時依賴。它不是獨立應用，而是嵌入 dsh web 的前端插件。
核心功能¶
插件在輸入框下方提供按鈕式用量條，點擊後展開面板。已覈實的主要能力如下：
- 即時顯示當前會話 token 用量，並按官方刊例價估算費用；配置 API Key 後顯示賬戶餘額。
- 顯示當日和近 7 天按模型堆疊的柱狀圖，以及模型費用分佈。
- 支持峯谷計價，支持 CNY/USD 雙幣種官方報價，不做匯率換算。
- 可選接入官方賬單，讀取
platform.deepseek.com的按日賬單，顯示官方真實扣費。 - 歷史費用按刊例價生效區間計價，支持官方調價自動識別。
- 預算提醒：每日預算進度，達到 80% 以上顯示黃色，超支顯示紅色。
- 上下文壓力三檔預警：30%、50%、85%，並支持一鍵
/compact。 - 顯示消耗段位，並生成梁祖分享卡片，可通過 canvas 導出 PNG。
- 面板內檢查更新和一鍵更新。
- 跨會話賬本本地持久化。
安裝與啓用¶
先確認本地已安裝 DeepSeek Harness，並且 dsh web 能正常啓動。插件的環境要求爲 node >=22，peerDependencies 要求 react ^18.2.0。
從 npm 安裝：
dsh plugin --profile web add dsh-plugin-usage-meter
安裝後重啓 dsh web 並刷新頁面。輸入框下方出現按鈕式用量條，即表示生效。
也可以從 GitHub 安裝：
dsh plugin --profile web add github:fancr-code/dsh-plugin-usage-meter
或者克隆後本地安裝：
git clone https://github.com/fancr-code/dsh-plugin-usage-meter.git
dsh plugin --profile web add ./dsh-plugin-usage-meter
插件自帶 dsh.bundle.patch，dsh plugin 會自動把它註冊進 profile 的 bundle 層，無需手動編輯 cordis.patch.yml。
驗證掛載狀態：
dsh --profile web --dump-config
確認輸出中存在 usage-meter 層即可。
卸載：
dsh plugin --profile web remove dsh-plugin-usage-meter
然後重啓 dsh web。
典型用法¶
基本顯示¶
不配置額外信息時，插件也能提供除餘額外的主要功能：會話 token 用量、刊例價費用估算、當日和近 7 天柱狀圖、預算提醒、上下文壓力預警、檢查更新等。
餘額查詢需要 DeepSeek API Key，通常是在 Web「模型」頁寫入的 DEEPSEEK_API_KEY。
配置文件¶
編輯 $DSH_HOME/settings.yaml 的 usage-meter 節。已覈實資料中給出的可配置項包括 currency、budget、pricing，可寫成類似形式：
usage-meter:
currency: USD
budget: 50
# pricing: 可覆蓋某模型單價
字段含義如下：
currency：計費幣種，可爲 CNY 或 USD。budget：每日預算金額；設爲 0 或省略表示關閉預算提醒。pricing：用於覆蓋某模型單價。
價格優先級爲：settings.yaml 覆蓋 > 官方生效區間/即時 > 內置快照；內置 2026-08-17 快照兜底。
官方賬單¶
官方賬單爲可選功能。接入後，面板可以顯示 platform.deepseek.com 的按日賬單和官方真實扣費。
方式一：從本機瀏覽器自動導入 userToken。需要本機瀏覽器保持登錄 platform.deepseek.com。可用環境變量禁用自動導入：
USAGE_METER_AUTO_PLATFORM_TOKEN=0
方式二：將 DEEPSEEK_PLATFORM_TOKEN 寫入 $DSH_HOME/.credentials.yaml：
DEEPSEEK_PLATFORM_TOKEN: <userToken>
如果平臺 token 過期，且平臺返回 40002 或 40003，插件會退回刊例價估算，並冷卻 30 分鐘後自動重試或重掃。
峯谷與歷史計價¶
官方高峯規則爲：UTC 01:00–04:00、06:00–10:00，即北京時間 09:00–12:00、14:00–18:00，且僅週一至週五。高峯價格爲空閒價格的 2 倍。
歷史費用按刊例價生效區間計價。插件會識別官方調價，調價前後的用量分別按當時生效的刊例價估算。
適用場景與注意¶
這個插件適合以下場景：在 dsh web 中持續使用 DeepSeek API，需要即時查看會話費用、賬戶餘額、每日預算、模型費用分佈，並願意接入官方賬單核對真實扣費。
使用前建議確認以下幾點：
- 許可證爲 MIT，源碼可在 GitHub 檢查。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 賬本位置爲
$DSH_HOME/usage-meter/ledger.json，只存 token 桶、模型名與刊例價生效區間快照，不含對話內容。 - 賬本寫入使用 2s 防抖和原子寫入（臨時文件 + rename），並自動清理。
- 不配置 API Key 時，餘額查詢不可用，其他功能仍可使用。
- 不配置官方賬單 token 時，賬單功能不可用，插件退回刊例價估算。
本文基於已覈實資料；資料中 README 的“已知限制”與“數據與隱私”部分不完整，因此本文不展開這些未完整提供的內容。
結尾¶
dsh-plugin-usage-meter 的價值是把 dsh web 的用量信息從單純的 token 統計，擴展爲費用估算、餘額、預算、模型分佈、官方賬單和上下文壓力提醒。它輕量、可卸載、可配置，適合放在日常開發環境中長期觀察 DeepSeek API 的消耗情況。
GitHub：https://github.com/fancr-code/dsh-plugin-usage-meter。目錄頁未給出可覈實的 URL；如需從社區目錄安裝，可按插件名 dsh-plugin-usage-meter 檢索。
