用 dsh-cost-meter 給 DeepSeek Harness 網頁界面補上會話費用賬本

DeepSeek Harness 插件 DeepSeek DSH dsh-cost-meter 費用統計 工具與能力 2026-08-17 159 閱讀

前言

用 DeepSeek Harness（以下簡稱 DSH）寫代碼，賬單跟的是 Token，不是會話條數。一次調用會拆成未命中輸入、緩存命中、輸出；子代理、壓縮、標題生成這些輔助調用也會進用量。2026 年 8 月 16 日 16:00 UTC 起，官方定價又按峯時 / 谷時分檔：同一段對話，上午和晚上的單價可以差一倍。只看 Token 數字，很難立刻回答「這一輪花了多少錢」「今天已經用了多少」「賬戶還剩多少」。

DSH 官方倉庫把架構寫成「一切皆插件」：界面、工具、計費展示都可以在配置層裝卸，不必改 Harness 源碼。社區裏有人專門給 Web 界面加了一本費用賬本：本會話即時累計、當日合計、預算進度、官方餘額，以及和官方定價頁對齊的價格表。這個插件叫 dsh-cost-meter，收錄在獨立的社區插件目錄 deepseek-harness-plugin.com 中。該目錄與 DeepSeek / 幻方沒有官方從屬關係，不是官方應用商店。

本文按插件目錄頁、GitHub 倉庫 README、package.json、CHANGELOG，以及 DeepSeek 官方定價頁交叉覈對後整理：它是什麼、裝哪條命令、網頁裏怎麼看賬，以及安裝前要看清的權限邊界。

這是什麼

dsh-cost-meter 是一款面向 DeepSeek Harness Web UI 的會話費用統計插件，目錄分類爲「工具與能力」，由 GitHub 用戶 Han-1413141 維護，倉庫地址爲 Han-1413141/dsh-cost-meter。許可證爲 MIT，主要語言是 JavaScript。目錄頁收錄日期爲 2026-08-15。倉庫 package.json 與 README 徽章、CHANGELOG 均標明當前版本爲 1.3.1（發佈於 2026-08-16）。截至 2026-08-17 查詢 GitHub API，倉庫顯示 58 stars；目錄頁當時標註爲 23，星標以 GitHub 一手數據爲準。

package.json 裏的兼容聲明是：DSH >=0.1.0-rc.5、Node.js >=20。客戶端聲明爲 "platform": "web"，也就是說它掛在網頁界面上，不是終端 TUI 插件。

目錄頁給它的一句話是：本會話費用、當日費用、歷史記錄，與官方價格同步。倉庫 README 把能力寫得更完整：會話徽章上的即時費用和 Token 分列、側邊欄官方餘額與預算圖框、設置頁的彙總與按天曆史、峯谷計價、官方定價頁一鍵同步，以及中英雙語界面。1.3.0 起還增加了 OpenCode Go 訂閱額度顯示；1.3.1 又在設置頁加了類 Codex 的 26 周 Token 用量熱圖。

它要填的坑很具體：Token 用量已經發生了，但金額要按模型、緩存是否命中、調用發生在峯時還是谷時來算。插件把每次模型調用的 usage 塊記進本地賬本，再按價格表折成美元；界面上的人民幣等幣種只是按匯率顯示。

核心功能

下面幾條都來自當前倉庫 README、package.json 與 CHANGELOG，不額外發揮。

1. 本會話費用徽章

會話費用可以出現在兩個位置，設置裏切換：

  • 輸入區下方
  • 會話標題欄

徽章顯示本會話即時累計費用，以及輸入 / 緩存 / 輸出 Token。計費來源是每次模型調用的 usage 塊，含子代理、壓縮、標題等輔助調用。README 寫明：會話徽章按當前價格檔位估算；當日、本月、累計和預算則按調用實際時刻精確入賬。兩邊不一致時，以賬本爲準。

2. 官方餘額與當日費用

側邊欄可以顯示官方開放平臺餘額：總餘額、贈送、充值，支持自動刷新和手動刷新。位置可配在側邊欄頂部、設置頁，或兩處都顯示。餘額接口是官方 GET {baseURL}/user/balance，複用模型請求同一把 API Key。

當日費用出現在側邊欄底部（設置按鈕上方），文案是「今日 ¥x」這類徽章；懸停可以看到調用次數和 Token 明細。未啓用預算時，這個位置就留給當日費用。

CHANGELOG 1.3.0 還寫過一個實際問題：側邊欄數據曾會凍在頁面加載時刻。當前版本用約 60 秒的週期輪詢（頁面隱藏時跳過），切回標籤頁會立即刷新。

3. 預算圖框：提醒，不攔截

啓用預算後，側邊欄底部會出現圓角圖框：預算額度、已用百分比、進度條、今日費用與佔預算百分比、已用 / 額度。閾值寫在 README 裏：

  • 已用 ≥ 80%：預警
  • 已用 ≥ 100%：超支

預算週期可以選今日、本月、累計，或自定義日期區間。窄欄（rail）模式會收成百分比方塊。

務必看清一句：預算與超支提示只提醒，不阻止調用。額度用完後，模型請求照樣會發出去。

4. 設置頁賬本：今日、本月、歷史

設置 → 費用 這一頁是總覽，README 列出的內容包括：

  • 彙總卡片：今日 / 本月 / 累計費用與調用次數
  • 今日會話明細：每個會話的調用次數、輸入 / 緩存 / 輸出 Token 與費用
  • 歷史記錄：按天彙總，保留天數可配，默認 180 天
  • 價格表：每個模型三檔價格（基礎 / 谷時 / 峯時），可增刪改
  • 顯示設置：徽章位置、語言、圖框詳細信息等

賬本存在 $DSH_HOME/storages/cost-meter/ledger.json，原子寫入並帶防抖。設置修改即時自動保存（README 寫的是 600ms 防抖），沒有單獨的「保存」按鈕。清零可以刪這個文件，也可以用設置頁的「清除全部歷史」。每日最多保留 200 條會話明細。

5. 峯谷計價與官方價格同步

價格單位與官方文檔一致：美元 / 1M tokens。成本公式按 README：

未命中輸入 × cache-miss + 輸出 × output +（緩存讀 + 緩存寫）× cache-hit。

緩存寫入沿用官方歷史規則，按命中價計費。賬本金額恆以美元存儲；幣種和匯率隻影響顯示，默認 1 USD = 7.2 CNY，可改。

峯谷門控的默認生效時間是 peakEffectiveAt：2026-08-16 16:00 UTC。生效前一律按基礎價；生效後：

  • 峯時段：01:00–04:00、06:00–10:00 UTC，用峯時價
  • 其餘時間用谷時價

這與 2026-08-17 打開的 DeepSeek 官方定價頁 一致：谷時爲峯時的一半，峯時段同樣是上述兩個 UTC 窗口。設置頁會顯示當前檔位（未生效 / 峯時段 / 谷時段）。

「從官方文檔同步價格」會抓取官方定價頁（Docusaurus 服務端預渲染），解析基礎表、峯谷表、生效時間和峯時段窗口，再寫入本地價格表。頁面結構改版時同步會報錯並保留原價格，可以手動改表兜底。同步會覆蓋官方頁面列出的同名模型價格，自定義模型條目不受影響。

倉庫另外提供 docs/AI-PRICE-SYNC-PROMPT.md（及英文版）：把提示詞交給任意 AI，讓它讀取官方定價後輸出多模型、分時價格 JSON，人工覈對後再應用到設置頁、RPC 或文件。這是備用同步路徑，不是自動扣費。

6. 中英雙語界面

界面（會話徽章、側邊欄、設置頁全部文案）支持簡體中文、English，以及跟隨瀏覽器。默認跟隨瀏覽器：zh* 走中文，其餘走英文，探測結果會寫回配置。服務端提示（餘額刷新、價格同步、校驗錯誤）跟界面語言一致。切換入口在 設置 → 費用 → 顯示設置 → 界面語言，即時生效並自動保存。

7. OpenCode Go 額度與 Token 熱圖

這兩項是較新的能力，目錄頁短簡介沒有展開，倉庫 README 與 CHANGELOG 寫得很清楚。

OpenCode Go 訂閱額度（1.3.0）：讀取 opencode.ai 的滾動 5 小時 / 本週 / 本月用量百分比和重置時間。Key 按「顯式配置 → DSH 憑據庫 OPENCODE_GO_API_KEY → 環境變量 → opencode 登錄態」自動發現，也可以手動填寫。側邊欄圖框、設置頁面板、右下角 chips 都可以顯示；Go 與預算同時開啓時會合併成一張卡片。未訂閱或 Key 無效時給出中性提示，可在設置裏關掉，避免一直報錯。接口被 README 標明爲「opencode.ai 官方端點（社區文檔）」；結構變化時設置頁會報錯。

Token 用量統計（1.3.1）：設置頁展示歷史累計 Token（輸入 / 緩存 / 輸出 / 調用次數），以及類 Codex 的 26 周每日用量方格熱圖。無用量日是半透明格子，有用量按四檔藍色着色，懸停看當日明細。

沒有 OpenCode Go 訂閱、也不需要熱圖時，這兩塊可以忽略；會話費用、餘額、預算和官方價格同步仍然可用。

安裝與啓用

插件目錄頁給出的安裝命令是：

dsh plugin add github:Han-1413141/dsh-cost-meter

目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。若需要可復現安裝，固定 commit 哈希：

dsh plugin add github:Han-1413141/dsh-cost-meter#<commit>

把 <commit> 換成倉庫裏實際的提交哈希，不要照抄佔位符。

倉庫 README 把安裝目標寫成 Web profile，並推薦釘到發佈 tag v1.3.1（與當前 package.json 版本一致）。機器上需要已有 pnpm 與 git：

dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.3.1

沒有 git 時，README 給出 GitHub tag 打包直鏈：

dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.3.1.tar.gz

環境要求按 README：Node.js ≥ 20，以及帶 dsh plugin 命令的 DeepSeek Harness（npm install -g @deepseek-ai/dsh）。DSH 本體當前仍是 developer preview，官方 README 寫明會有破壞性變更。

安裝後必須重啓 dsh web。README 的原因是：插件行、Typert 清單和客戶端 bundle 都在啓動時掃描。

dsh web

卸載按 README：

dsh plugin --profile web remove dsh-cost-meter

Windows 用戶還可以看到倉庫裏的 install.ps1 一鍵腳本（irm … | iex，腳本內固定到 tag）。README 自己寫了「建議先下載審閱再運行」。能用上面的 dsh plugin 命令時，不必走遠程管道執行。

開發者本地調試用符號鏈接，改 lib/client.js 後刷新頁面即可：

git clone https://github.com/Han-1413141/dsh-cost-meter.git
cd <克隆目錄的父目錄>
dsh plugin --profile web add link:./dsh-cost-meter

典型用法

下面步驟均來自倉庫 README 的界面說明，不另編操作。

1. 看本會話花了多少

重啓 Web UI 後打開一個會真實打模型的會話。輸入區下方或標題欄應出現費用徽章。發幾輪請求後，費用和 Token 分列會跟着 usage 更新。若徽章位置不合適，到 設置 → 費用 → 顯示設置 裏改到另一個位置，或關掉。

2. 看餘額、今日消耗和預算

主頁面側邊欄底部，README 給出的默認順序是：官方餘額 → 額度 / 預算圖框 → 設置按鈕。

  1. 確認本機可以訪問 api.deepseek.com，並且 DSH 裏已配置有效的官方 API Key。
  2. 餘額行懸停可看贈送 / 充值拆分；需要立刻刷新時，到設置頁餘額面板點手動刷新。
  3. 若要控制開支，在設置頁頂部打開預算，填額度、選週期。圖框出現後，已用百分比會隨賬本增長；≥80% 和 ≥100% 只改變提示樣式，不會切斷對話。

3. 把價格表對齊官方文檔

DeepSeek 調價或峯谷窗口變化後，不要只改自己的心理價位。設置頁「數據與同步」裏可以一鍵抓取官方定價頁。成功後，價格表裏的同名模型會換成頁面上的基礎 / 谷時 / 峯時三檔。解析失敗時保留舊錶，再按官方文檔手工改。自定義加進去的模型不會被這次同步清掉。

4. 查今天哪些會話在燒錢

打開 設置 → 費用：

  • 彙總卡片看今日 / 本月 / 累計
  • 「今日會話」表看每一會話的調用次數和三類 Token
  • 「歷史記錄」按天回溯

Token 熱圖適合看過去幾周的疏密，不適合替代官方賬單。需要換界面語言時，同一頁的顯示設置裏切換即可。

使用 OpenCode Go 的人，可以在設置頁最頂部看三檔額度，或打開右下角 chips。沒有訂閱就關掉該面板，避免無效請求。

適用場景與注意事項

比較適合這些情況：

  • 已經在用 DSH 的 Web UI，希望會話進行中就能看到金額，而不只是 Token
  • 需要把今日、本月、累計和按天曆史留在本地，方便自己做預算
  • 官方峯谷計價已經生效，希望價格表能跟定價頁同步，而不是手抄一份過期數字
  • 同時看官方賬戶餘額，確認贈送額度還沒用完

使用前注意下面幾條，均來自目錄頁或倉庫 README，不是額外發揮：

  1. 先看源碼和許可證再裝。 目錄頁寫明：插件以當前 dsh 進程權限運行，安裝時可能執行代碼。這是社區插件，不是 DeepSeek 官方組件。
  2. 它只覆蓋 Web profile。 package.json 聲明客戶端平臺爲 web；不要按網頁截圖去終端 TUI 裏找徽章和圖框。
  3. 徽章是估算，賬本纔是精確口徑。 會話上的數字按當前檔位估；跨峯時的會話以按調用時刻入賬的 ledger 爲準。官方扣費仍以 DeepSeek 賬單爲準。
  4. 預算不會停機。 超支只變色提醒。真正要停調用，得自己停手或改 Harness 側策略，這個插件不做閘門。
  5. 餘額查詢有域名限制。 API Key 只會發往官方域名 api.deepseek.com。baseURL 指到非官方地址時，餘額查詢會拒絕，模型請求不受影響。本機還要能訪問該域名。
  6. 官方頁面解析會過期。 定價頁改版後，「從官方文檔同步價格」可能失敗。手動改價格表，或用倉庫提供的 AI 同步提示詞，再人工覈對。
  7. OpenCode Go 是可選項。 額度接口走 opencode.ai，結構變化時會報錯，設置裏可以關閉。沒有 Go 訂閱不必開。
  8. 裝完要重啓。 只 plugin add 不重啓 dsh web，界面掃描不到新 bundle。
  9. 不要把目錄頁當成官方商店。 deepseek-harness-plugin.com 是社區目錄；DSH 本體以 deepseek-ai/deepseek-harness 爲準。安裝命令以目錄頁原文和倉庫 README 爲準，不要憑插件名自行拼接路徑。

小結

dsh-cost-meter 做的事情很集中：在 DSH 網頁界面裏把 Token 用量折成錢，並留下本會話、當日、歷史和預算。價格按官方的美元 / 1M tokens 和峯谷窗口計算，也可以從定價頁一鍵同步；餘額走官方 user/balance 接口。它提醒超支，但不攔截請求。當前倉庫版本是 1.3.1，界面中英雙語，賬本在本地 $DSH_HOME/storages/cost-meter/ledger.json。

目錄頁與倉庫：

  • 插件目錄：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-cost-meter/
  • GitHub：https://github.com/Han-1413141/dsh-cost-meter
  • DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness
  • 官方定價：https://api-docs.deepseek.com/quick_start/pricing

相關文章

快速從零部署一個DeepSeek-R1服務 2025-04-05 使用 dsh-anchored-standard 爲 DeepSeek Harness 配置兩階段 Agent 預設 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 網頁界面補成工作臺 2026-08-17 用 modlens 給 DeepSeek Harness 的純文本模型補上視覺 2026-08-17 用 dsh-TUI 給 DeepSeek Harness 補上全屏終端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

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

小夜