在使用 DeepSeek Harness (DSH) 進行智能體開發時，追蹤每次模型調用的成本、管理不同供應商的餘額以及區分高峯與低谷時段的計費，往往需要額外的工具或手動計算。這容易導致預算超支或計費口徑不一致。
dsh-token-feiyong 是一個用於 DeepSeek Harness 的 Token 計費與費用統計插件。它由 singei8 維護，旨在攔截並記錄每一次模型調用，按緩存命中/未命中/輸出三類分別計價，並提供本地持久化的賬本功能。
核心功能¶
- 逐筆計費：攔截模型調用，按緩存命中、緩存未命中、輸出三類分別計價。
- 高峯/低谷分時計價：高峯時段爲北京時間週一至週五 9:00–12:00、14:00–18:00，其餘爲低谷時段。
- 多檔單價匹配：按「用戶配置 -> 模型名 -> 內置官方表 -> default」的順序匹配單價。
- 輸入框徽標顯示：實時顯示高峯/低谷狀態、單次花費、本對話累計、今日累計及餘額/額度。
- 設置頁費用統計：提供賬戶、單次、今日、累計、按模型、最近請求等統計視圖。
- 按供應商的餘額/額度：支持 DeepSeek、智譜、火山方舟等供應商的餘額查詢與額度計量。
- 套餐額度計量（AFP）：火山方舟 Agent Plan 等預付費套餐按官方 AFP 抵扣係數計算消耗。
- 數據本地持久化：明細與累計數據合併讀回，累計不回退，存檔路徑爲
<DSH_HOME>/token-billing-ledger.。 - 子會話併入：側邊對話與子代理的花費默認併入所屬主對話的「本對話」與「單次」。
- 總開關：提供插件總開關，可獨立控制啓用狀態與餘額顯示。
安裝與啓用¶
dsh plugin --profile web add github:singei8/DSH-TOKEN-feiyong
安裝後重啓 DSH 即可生效。該插件是 npm 包形態，帶 dsh.bundle 清單，倉庫已包含預構建的 lib/，無需本地編譯。
典型用法¶
- 查看實時花費：輸入框下方常駐顯示費用信息，例如
● 高峯 · 單次 ¥0.012 · 本對話 ¥1.410 · 今日 ¥1.410 · 餘額 ¥32.31。這能讓你直觀地看到「這次調用花了多少錢」。 - 管理餘額與套餐：在設置頁 → 費用統計查看賬戶餘額。對於火山方舟 Agent Plan 等預付費模型，系統會按 AFP 抵扣係數計算消耗，並顯示剩餘的 5小時/周/月額度。
- 會話歸併統計：側邊對話與子代理的花費默認併入所屬主對話的「本對話」與「單次」，便於宏觀掌控整個工作流的成本。
適用場景與注意¶
- 依賴說明：插件對宿主能力是可選依賴。如果宿主缺少
webServer、llm、credentials、shell、fs、settings任一能力，對應功能會降級，不會導致插件崩潰。 - 安全與隱私：API Key 僅由 Host 側按
env→credentials服務解析，不進入命令行參數、不寫入日誌、不下發到前端。插件不發送任何遙測，除餘額查詢外不發起任何網絡請求。 - 數據存儲：存檔文件路徑爲
<DSH_HOME>/token-billing-ledger.。已知邊界：側邊對話與子代理默認併入統計，但底層仍按真實會話分開記錄，不會雙重計數。
總結¶
dsh-token-feiyong 通過本地持久化賬本和實時徽標顯示，解決了 DSH 環境下的成本追蹤問題。它支持 DeepSeek、智譜 GLM 等主流模型，並能處理預付費套餐的 AFP 計量。更多細節可查閱其 GitHub 倉庫。
