前言¶
用 DeepSeek Harness(DSH)跑長會話、多模型切換時,Token 消耗往往事後纔在賬單裏對上號:本會話花了多少、今天累計多少、峯谷時段有沒有踩到高價檔、Coding Plan 還剩幾成額度——這些數字分散在官方控制檯、各家訂閱後臺和腦子裏,很難在寫代碼的同一屏裏看見。
社區插件 dsh-cost-meter(維護者 Han-1413141)把費用統計嵌進 DSH Web 界面:會話徽章、側邊欄餘額與預算圖框、設置頁歷史與熱圖,並支持官方價格同步、峯谷計價提醒與中英雙語。項目在 GitHub 上約 184 stars、12 forks,MIT 許可,當前發佈版本 v1.5.45,在 SkillHub 插件庫 分類爲「聯網工具」。SkillHub 是面向 DSH 插件的社區目錄,與 DeepSeek / 幻方無官方從屬關係;DSH 本身遵循「一切皆插件」的擴展理念,這類工具由社區維護、自行審閱後安裝。
這是什麼¶
dsh-cost-meter 是 DeepSeek Harness 的 Web 端會話費用統計插件。它在宿主進程內包裹每次 LLM 調用,按 usage 與價格表即時入賬,並在瀏覽器側展示本會話費用、當日/月度彙總、預算進度、官方與自定義 Provider 餘額,以及 OpenCode Go、多家 Coding Plan 的額度窗口。
賬本持久化在 $DSH_HOME/storages/cost-meter/ledger.json;界面語言可選簡體中文、English 或跟隨瀏覽器。
核心功能與亮點¶
會話與賬本¶
- 本會話費用:顯示在輸入區下方或會話標題欄,含輸入/緩存/輸出 Token 與累計金額,位置可在設置中切換。
- 當日費用與歷史:側邊欄底部「今日 ¥x」徽章,設置頁提供今日/本月/累計彙總、按天曆史(默認保留 180 天)及今日各會話明細。
- 預算圖框:可設額度與週期(今日/本月/累計/自定義區間),≥80% 預警、≥100% 超支提示;僅提醒,不阻止調用。
- Token 熱圖:設置頁提供類 Codex 的 26 周每日用量方格熱圖,懸停可看當日明細。
- 安裝前歷史導入:首次啓動可回放宿主會話日誌,把未裝插件時期的對話補入賬本(冪等,不與即時計費重複)。
餘額與多源額度¶
- 官方餘額:查詢
api.deepseek.com總餘額/贈送/充值,支持三段進度條與手動刷新;API Key 複用 DSH 憑據,僅發往官方域名。 - 自定義 Provider 餘額:可配置任意 HTTP 端點(如 LiteLLM、NewApi),通過 JSON extract 規則解析剩餘額度。
- OpenCode Go 額度:展示滾動 5 小時/本週/本月用量與重置時間,Key 可自動發現或手動填寫。
- Coding Plan 額度:支持 Anthropic、Z.ai、MiniMax、Kimi、OpenRouter、SiliconFlow、CommandCode 等廠商訂閱窗口查詢;SCNet Token Plan 無公開 API 時由本地 Credits 表估算。
- 輸入框上方額度橫條:預算、Go、各 Coding Plan 用量以 chips 橫排顯示,點擊即刷新對應數據源。
計價與價格表¶
- 多模型計費:內置 90+ 模型參考價格目錄,支持 OpenAI、Anthropic、Google Gemini、Mistral 等 provider 的 input/output、緩存與 reasoning Token;未知模型 id 可模糊匹配或手動指定條目。
- 峯谷兩檔計價:UTC 01:00–04:00、06:00–10:00 爲峯時段,其餘按谷時價(約爲峯時一半);2026-08-23 起週末(北京時間週六、週日)全天按谷價,界面顯示「週末時段——全谷價」。
- 峯/谷切換提醒:進入峯/谷前可彈全屏色條或發送瀏覽器系統通知,提前量、位置、提醒類型可配,設置頁支持預覽。
- 官方價格同步:抓取官方定價頁 HTML 解析,一鍵寫入價格表;可選美元或人民幣官方頁,人民幣按展示匯率折算顯示。
體驗細節¶
- 側邊欄餘額/額度圖框支持點擊立即刷新;可單獨隱藏官方餘額或今日消耗,便於共享屏幕。
- 界面與服務器提示消息均支持中英雙語。
安裝與啓用¶
環境要求:Node.js ≥ 20,以及帶 dsh plugin 子命令的 DeepSeek Harness(例如 npm install -g @deepseek-ai/dsh)。
一鍵安裝(推薦)¶
npm 包名安裝,始終跟隨 registry 最新版:
dsh plugin --profile web add dsh-cost-meter
若需固定到當前發佈 tag(README 示例爲 v1.5.45),且本機已有 pnpm 與 git:
dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.45
沒有 git 時可用 tag 打包直鏈:
dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.45.tar.gz
安裝後重啓 Web 進程,插件行與客戶端 bundle 在啓動時掃描:
dsh web
卸載:
dsh plugin --profile web remove dsh-cost-meter
插件以當前
dsh進程權限運行,會訪問網絡查詢餘額與官方定價頁。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證,確認權限聲明(manifest 中列有api.deepseek.com、api-docs.deepseek.com等網絡域)符合你的安全策略。
典型用法示例¶
查看會話與當日費用¶
安裝並重啓 dsh web 後,打開任意會話即可在輸入區下方或標題欄看到本會話累計費用與 Token 拆分;側邊欄底部顯示今日總費用,懸停可見調用次數明細。無需額外配置即可開始記賬,價格默認按內置表與官方峯谷規則估算。
設置預算與同步官方價格¶
- 進入 設置 → 費用,在頂部「預算」面板填寫額度與週期。
- 在「數據與同步」區域點擊從官方文檔同步價格,按需選擇美元或人民幣官方頁。
- 在「顯示設置」中開啓餘額進度條、輸入框上方額度橫條,或切換界面語言。
預算超支時界面變色提示,但不會攔截模型請求。
配置自定義 Provider 餘額(NewApi 示例)¶
在 設置 → 費用 → 自定義 Provider 餘額 中展開配置,或編輯 storages/cost-meter/ledger.json 的 config.customBalance。以下片段來自官方 README,適用於以 quota 整數計量的 NewApi 端點(1 USD = 500000 quota):
{
"enabled": true,
"display": "both",
"refreshMinutes": 15,
"label": "NewApi",
"labelEn": "NewApi",
"unit": "USD",
"request": {
"url": "https://你的NewApi域名/api/usage/token",
"method": "GET",
"headers": { "Authorization": "Bearer {{NEWAPI_API_KEY}}" }
},
"extract": {
"remaining": { "op": "divide", "path": "data.total_available", "by": 500000 },
"maxBudget": { "op": "divide", "path": "data.total_granted", "by": 500000 },
"spend": { "op": "divide", "path": "data.total_used", "by": 500000 },
"unit": "USD"
}
}
{{NEWAPI_API_KEY}} 從 DSH 憑據庫或環境變量解析;配置保存後約 600ms 防抖自動持久化。
開發者本地調試¶
git clone https://github.com/Han-1413141/dsh-cost-meter.git
cd <克隆目錄的父目錄>
dsh plugin --profile web add link:./dsh-cost-meter
符號鏈接模式下修改 lib/client.js 後刷新頁面即可看到 UI 變化。
適用場景與注意事項¶
適合誰用
- 長期在 DSH Web 裏跑 Agent、子代理或多模型路由,需要同屏掌握 Token 與費用的開發者。
- 同時使用 DeepSeek 官方 API、OpenCode Go 或多家 Coding Plan,希望統一查看額度窗口的用戶。
- 關注 DeepSeek 峯谷計價規則,想在切換前收到彈窗或系統通知提醒的場景。
使用注意
- 會話徽章按當前價格檔位估算,精確金額以賬本爲準;官方定價頁結構變化時同步可能失敗,可手動改價格表兜底。
- 歷史按模型回填依賴宿主會話日誌仍在磁盤;日誌已清理的早期調用無法逐模型拆分。
- OpenCode Go 等第三方額度接口若變更,設置頁會顯示錯誤,可在顯示設置中關閉對應模塊。
- 刪除
$DSH_HOME/storages/cost-meter/ledger.json或使用設置頁「清除全部歷史」可清零本地賬本。
結尾¶
如果你已經在用 DeepSeek Harness,卻總覺得「花了多少」要靠事後對賬,dsh-cost-meter 把會話成本、預算、餘額和多源額度收進同一套 Web UI,並跟官方峯谷規則與價格表對齊,值得裝上去試一輪。