前言¶
在 DSH 中調用 DeepSeek 時，常見需求是查看當前會話累計用了多少 token，並粗略估算對應費用。dsh-token-cost-meter 是一個 DSH 插件：在 Web GUI 輸入框下方即時顯示當前會話累計 token 消耗與估算費用（人民幣），價格從 DeepSeek 官方價格頁動態獲取。
下面先介紹它做什麼，再給安裝和啓用步驟。
這是什麼¶
倉庫名是 dsh-token-cost-meter，owner 爲 YZz-S，許可證爲 MIT。
它支持兩種使用形態：
- 可安裝
dsh.bundle包； - 動態
cordis_define用法。
安裝版適合長期啓用；動態用法適合在當前 DSH 進程中臨時運行。
核心功能¶
- 在 DSH Web GUI 輸入框下方顯示當前會話累計 token 消耗與估算費用。
- 讀取會話投影
tokenUsage，包含未命中輸入、緩存命中、輸出。 - Host 端每 6 小時抓取並解析 DeepSeek 官方價格頁，含峯谷價表，並按北京時間自動切換時段。
- 官方價格頁抓取失敗時，回退到內置價格快照；金額前加
≈，並在懸停提示中標註原因。 - 模型識別採用三級回退：最近請求
provenance、requestConfig、Hostagents.options.model。 - 懸停時可查看計價模型、輸入分桶、輸出、計價模式、價格來源與抓取時間。
費用計算¶
價格單位爲 CNY / million tokens。
計費公式爲：
Cost (CNY) = cache-miss input × miss price + cache-hit input × hit price + output × output price
這裏的輸入和輸出來自會話投影 tokenUsage，價格來自 DeepSeek 官方價格頁。2026-08-17 起，插件會按官方峯谷時段表自動切換價格。
安裝與啓用¶
安裝 dsh.bundle¶
前提：
- DSH Web 模式；
- 安裝版 Host 進程需要 Node ≥ 18 的 native
fetch； - 資料驗證環境爲 DSH 0.1.0-rc.6 + Node.js v22 + Windows。
執行安裝命令：
dsh plugin --profile web add github:YZz-S/dsh-token-cost-meter
安裝後重啓 DSH，輸入框下方費用統計行會自動生效。
動態 cordis_define¶
動態插件是會話級的，DSH 進程重啓後需要重新定義並運行。步驟如下：
- 打開 DSH Web，並進入一個會話。
- 在會話中調用
cordis_define，提交host.js全文作爲code.host，提交client.js全文作爲code.client。 - 對
cordis_run返回的pluginId/packageId執行運行。 - 在 Run 卡片批准後刷新頁面。
經過上面的步驟，輸入框下方會顯示費用統計行。
注意：動態形式中 host.js 的價格抓取命令爲 PowerShell 語法，默認 Windows 可用；Linux/macOS 需要把 NODE_FETCH 替換爲對應 shell 語法。
典型用法¶
啓用後，輸入框下方會出現類似讀數：
費用 ¥0.13 · 43.2K tokens
也可以看到英文格式：
Cost ¥0.13 · 43.2K tokens
懸停提示會顯示明細，包括計價模型、輸入分桶、輸出、計價模式、價格來源與抓取時間。
適用場景與注意¶
適合需要在 DSH Web 會話中查看 DeepSeek 當前會話 token 消耗與估算費用的開發者。該插件以當前 DSH 進程權限運行；安裝前建議檢查倉庫源碼和 LICENSE。
需要注意：
- 費用是估算，不是官方賬單；實際收費以 DeepSeek 平臺爲準。
- 內置價格快照抓取於 2026-08-15，可能滯後官方價格變化；只在動態抓取失敗時用於回退。
- 動態插件爲會話級；DSH 進程重啓後需重新定義並運行，或改用安裝方式。
- 動態形式
host.js默認適合 Windows；Linux/macOS 需要替換NODE_FETCH。 - 平臺要求：DSH Web 模式且支持動態 Cordis 插件；資料驗證於 DSH 0.1.0-rc.6 + Node.js v22 + Windows。
- 唯一出站請求爲 DeepSeek 官方公開價格頁；token 用量僅本地展示，不上傳、不落盤。
鏈接¶
- GitHub：
https://github.com/YZz-S/dsh-token-cost-meter - 目錄頁 URL 未在已抓取資料中提供，無法確認。
