在 DeepSeek Harness (DSH) Web 的開發與使用過程中，需要監控 API 賬戶餘額和實際消耗。DeepSeek 官方接口僅提供餘額查詢，但“今日花費”通常需要手動統計或等待賬單。dsh-deepseek-cost-live 解決了這一缺口，通過官方接口獲取餘額，並解析本地會話日誌估算今日花費。
這是一個社區開源插件（MIT 許可證），由 xtd1145 維護。它不修改 DSH 源碼，基於官方運行時能力開發。
核心功能¶
1. 餘額實時（官方接口）
插件調用 GET https://api.deepseek.com/user/balance 獲取餘額。API Key 僅在宿主進程內解析，絕不進入瀏覽器、日誌或請求參數。如果刷新失敗，會保留上次成功的數據並標記爲 stale。
2. 今日花費（本地估算）
插件監聽 DSH 本機會話日誌，將每次模型請求的 usage（緩存命中、未命中、輸出、推理）按分模型價格表（元/百萬 token）換算爲人民幣。由於 DeepSeek 官方不提供“今日已消費”查詢接口，因此花費爲本地估算口徑，非賬單。
3. 三處實時展示
可在三處同時啓用實時展示：
* 輸入框下方 composer dock 條：顯示餘額、今日花費及手動刷新按鈕。
* 右下角常駐懸浮徽標：可收起，狀態由 localStorage 記憶。
* 設置頁完整面板：餘額明細、今日/近7日 Token 與花費、分模型花費、價格表/時區/輪詢配置、歷史重掃。
4. 其他能力
* 支持中英雙語。
* 計數僅計入官方 DeepSeek 路由（默認 deepseek-official provider）。
* 支持歷史會話掃描與重掃。
安裝與啓用¶
使用官方安裝命令：
dsh plugin --profile web add <本倉庫路徑或 dsh-deepseek-cost-live.tgz>
安裝後需重啓服務以生效：
powershell -NoProfile -ExecutionPolicy Bypass -File $env:USERPROFILE.dshrestart-dsh-web.ps1
重啓後，在瀏覽器（建議無痕/強刷一次）打開 Web 界面，即可看到懸浮徽標與輸入框下方小條。訪問設置頁的「用量與餘額」可查看完整面板。
驗證安裝是否成功：
Invoke-WebRequest -Uri 'http://127.0.0.1:3080/dsh-deepseek-cost-live/stats' -UseBasicParsing | Select-Object -ExpandProperty Content
配置與數據¶
API Key 來源
插件通過以下優先級解析 API Key：
1. 插件配置文件 $DSH_HOME/dsh-deepseek-cost-live/config.json。
2. 環境變量（默認 DEEPSEEK_API_KEY，可在配置中修改 apiKeyEnv）。
3. DSH 憑據文件 $DSH_HOME/.credentials.yaml。
4. 官方 ctx.credentials 服務。
數據目錄
插件在 $DSH_HOME 下創建以下文件：
* dsh-deepseek-cost-live/ledger.json：用量記錄（sessionId:seq 冪等去重，保留 keepDays 天）。
* dsh-deepseek-cost-live/config.json：配置文件。
* dsh-deepseek-cost-live/balance.json：最近一次成功餘額快照。
HTTP 路由
僅限本機迴環訪問：
* GET /dsh-deepseek-cost-live/stats — 彙總數據。
* POST /dsh-deepseek-cost-live/refresh — 立即刷新余額。
* POST /dsh-deepseek-cost-live/scan — 立即重掃全部會話歷史。
注意事項¶
- 非官方產品：與 DeepSeek 官方無關，爲社區開源插件。
- 花費口徑：花費爲本地估算，非官方賬單，需按官網價目表覈對。
- 環境要求：需要 Node.js >= 22.19.0。
- 路由限制：HTTP 路由僅支持本機迴環訪問。
