前言¶
在 DSH Web 裏跑 DeepSeek 模型時，費用不是一個簡單數字：輸入、輸出和緩存命中都會影響成本，高峯/空閒時段也會變化。如果只在事後翻日誌估算，容易漏項，也不方便導出。
dsh-token-billing 是一個 DSH 插件，把即時費用、價格來源、歷史賬本、統計和導出放進同一個設置入口。DSH 的插件生態以“一切皆插件”爲組織方式；這個插件是第三方擴展，與 DeepSeek/幻方沒有官方從屬關係，也不是 DeepSeek 官方應用商店。
這是什麼¶
2006spy/dsh-token-billing 是 DeepSeek Harness（dsh）即時 token 計費插件，許可證爲 MIT，資料中的分類爲聯網工具。
它面向 DSH Web，解決的是會話內費用不直觀、歷史費用難查詢、多 Provider 成本難分類的問題。
核心功能¶
下面介紹資料中列出的主要能力：
- DeepSeek 官網人民幣價直接計費：價格來源默認 DeepSeek 官網中文頁，英文頁兜底；外幣價可自動折算人民幣。
- 價格即時跟隨官網：價格表可隨官網變化更新，減少手工維護固定價格。
- 高峯/錯峯自動切換：插件會按官方計費規則區分高峯和空閒時段。
- 可視化自定義模型價格：在插件配置中維護模型價格覆蓋；模型價格覆蓋優先級最高，不參與高峯/錯峯。
- 多幣種兜底：外幣價格可折算，避免單一幣種顯示不完整。
- 持久化歷史賬本 + 多維統計：把結算結果保存爲歷史賬本，並用於後續統計。
- 賬戶餘額查詢：需要
DEEPSEEK_API_KEY；資料說明 key 不下發瀏覽器。 - CSV / JSON 導出：支持把賬本導出爲 CSV 或 JSON。
- 本地模型節省統計：用於把本地模型調用與 API 名義價格對照，統計節省額度。
- Provider 收費形式分類：支持訂閱、免費、本地等收費形式，用於區分實際花費與名義價值。
- Token 用量與緩存命中統計：可查看 Token 用量與緩存命中情況。
- 統計頁儀表盤：提供儀表盤式統計頁，用於概覽費用與用量。
安裝與啓用¶
安裝前先確認你是在 DSH 的 web profile 下操作。資料給出的安裝方式包括插件市場、pnpm 依賴和本地源碼鏈接。
插件市場（資料標註爲待上架）¶
資料給出的入口是：
1、打開 DSH
2、進入 設置 → 插件 → 市場
3、搜索 dsh-token-billing
4、點擊安裝
需要注意：資料中把該方式標註爲推薦但待上架，實際是否已上架未在已覈實資料中確認。如果搜索不到，可改用下面的依賴安裝方式。
在 web profile 目錄安裝依賴¶
這一步把插件作爲依賴加入 DSH web profile。在 web profile 目錄下執行：
pnpm add github:2006spy/dsh-token-billing#main
然後掛載插件。在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: token-billing
name: dsh-token-billing
完成後重啓 DSH，使插件加載生效。
本地源碼鏈接¶
如果你要讀源碼或改配置，可以先克隆倉庫：
git clone https://github.com/2006spy/dsh-token-billing.git
然後以 link 依賴方式接入 web profile。資料沒有給出更具體的本地鏈接字段示例，實際以 DSH 的依賴配置方式爲準。
啓用後的基本用法¶
1、打開 設置 → 插件 → Web UI 插件 → Token 計費，保存配置即時生效。
2、在 DSH Web 會話中發起一次 DeepSeek 請求，查看費用行是否出現。
3、進入統計頁，查看歷史賬本、Token 用量與緩存命中、餘額和導出入口。
4、如需調整價格，維護模型價格覆蓋；該配置優先級最高，不參與高峯/錯峯。
5、如使用本地或訂閱 Provider，配置 Provider 收費形式分類，以便區分實際花費與名義價值。
DSH 桌面端 2.0.2（核心 0.1.1-rc.1+）下，資料要求把插件更新到 v0.7.1 並重啓 DSH，否則費用行不顯示、賬本凍結。
適用場景與注意¶
適合以下使用方式：
- 在 DSH Web 中調用 DeepSeek 模型，希望即時看到會話費用。
- 需要查看歷史賬本，並導出 CSV / JSON。
- 使用本地模型、訂閱 Provider 或免費 Provider，希望區分“實際花費”和“名義價值”。
- 需要賬戶餘額查詢，並能接受
DEEPSEEK_API_KEY用於餘額查詢。
使用前注意：
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。本插件許可證爲 MIT。
- 資料中的目錄頁、GitHub 頁和插件線索來自第三方倉庫，不能替代 DeepSeek 官方價格頁。費用覈算應以你實際使用的價格源、配置和官方規則爲準。
- 賬戶餘額查詢依賴
DEEPSEEK_API_KEY；資料說明 key 不下發瀏覽器。 - 官方高峯/週末空閒規則自北京時間
2026-08-23 00:00生效；生效前週末仍按高峯價，歷史回看不減半。 - 插件市場入口是否可用尚未確認，資料標註爲待上架。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/2006spy/dsh-token-billing
- GitHub：https://github.com/2006spy/dsh-token-billing
