dsh-cost-meter:給 DeepSeek Harness 裝上會話費用儀表盤

前言

用 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.comapi-docs.deepseek.com 等網絡域)符合你的安全策略。

典型用法示例

查看會話與當日費用

安裝並重啓 dsh web 後,打開任意會話即可在輸入區下方或標題欄看到本會話累計費用與 Token 拆分;側邊欄底部顯示今日總費用,懸停可見調用次數明細。無需額外配置即可開始記賬,價格默認按內置表與官方峯谷規則估算。

設置預算與同步官方價格

  1. 進入 設置 → 費用,在頂部「預算」面板填寫額度與週期。
  2. 在「數據與同步」區域點擊從官方文檔同步價格,按需選擇美元或人民幣官方頁。
  3. 在「顯示設置」中開啓餘額進度條、輸入框上方額度橫條,或切換界面語言。

預算超支時界面變色提示,但不會攔截模型請求。

配置自定義 Provider 餘額(NewApi 示例)

設置 → 費用 → 自定義 Provider 餘額 中展開配置,或編輯 storages/cost-meter/ledger.jsonconfig.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,並跟官方峯谷規則與價格表對齊,值得裝上去試一輪。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜