前言¶
在 DeepSeek Harness（DSH）裏跑智能體，模型調用是持續發生的：提示 token、補全 token 和模型 id 分散在日誌裏，很難回答「今天花了多少」「這個月會不會超支」。自己寫腳本彙總既費事，又容易和 DSH 的調用路徑脫節。
下面介紹社區插件 dsh-cost-track（維護者 hj01857655）。它在每次模型調用後按價目表計價，寫入本地只增不改的賬本，並支持月度預算告警與可選的調用攔截；設置頁裏還能查看花費面板。DSH 生態強調「一切皆插件」；SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝前仍以包內文檔與源碼爲準。
這是什麼¶
dsh-cost-track 是面向 DSH 的用量與預算追蹤插件：對每一次模型調用記錄 prompt / completion token 與 model id，換算成金額並落盤，便於按日、按月或按會話回溯花費。
維護者爲 hj01857655，npm 包採用 MIT 許可證。社區目錄頁：https://www.skillhub.cn/plugins/hj01857655/dsh-cost-track。目錄線索中的 GitHub 倉庫 https://github.com/hj01857655/dsh-cost-track 在 2026-10-21 訪問時返回 404，且預先抓取的 README 未成功；下文功能與命令以 npm 包 dsh-cost-track 公佈的 README 爲準（見 registry.npmjs.org/dsh-cost-track）。
核心功能¶
經覈對 npm README，插件目前提供這些能力：
- 調用記賬：每次模型調用的 prompt tokens、completion tokens、model id 經計價後追加寫入
.cost/ledger.jsonl（append-only）。 - 內置定價：自帶 DeepSeek 模型費率表；自定義模型可通過
.cost/pricing.json覆蓋單價（按每百萬 token）。 - 預算：可設月度支出上限；累計花費越過閾值時告警；配置
enforce: true時，後續模型調用會被阻斷。 - 時間範圍查詢：支持按今天、本週、本月或任意日期範圍篩選花費。
- 按會話彙總：查看哪次對話消耗 token 最多。
- 設置頁 Cost 面板：展示今日 / 本月花費、分模型明細、近期會話與預算進度條；宿主註冊
GET /api/cost-track.panel，每次請求從賬本重建數據。無 Web 連接的 headless 宿主會跳過該路由。 - CLI：不依賴 DSH 進程也可做彙總、設預算或手動補錄一條記錄（見下文示例）。
安裝與啓用¶
插件面向 web profile（README 中的 dsh.client.platform 爲 web）。先用 npm 分發安裝：
dsh plugin --profile web add dsh-cost-track
README 還給出從 GitHub 源碼安裝的方式（與目錄線索中的倉庫 slug 一致）：
dsh plugin --profile web add github:hj01857655/dsh-cost-track
若上述 GitHub 地址不可用，以 dsh plugin --profile web add dsh-cost-track 爲準。安裝後可在 DSH 設置中確認插件已加載；需要 Node >= 20（npm 包 engines 字段）。
典型用法¶
自動記賬¶
啓用插件後，DSH 側的模型調用會由插件側記錄，一般無需爲每次調用手工操作。
CLI¶
README 中的示例：
dsh-cost-track summary # show spend summary
dsh-cost-track budget --monthly 50 --enforce # set $50/month budget with enforcement
dsh-cost-track record --model deepseek-chat --prompt-tokens 1000 --completion-tokens 500 --session s1
budget 用於設定月度上限及是否強制攔截；record 適合腳本補錄或對齊外部統計。
默認定價與覆蓋¶
默認費率（每百萬 token，USD）：
| Model | Prompt | Completion |
|---|---|---|
| deepseek-chat | $0.14 | $0.28 |
| deepseek-reasoner | $0.55 | $2.19 |
非 DeepSeek 或需自定義單價時，在項目下寫入 .cost/pricing.json：
{
"my-model": { "promptPerMillion": 1.0, "completionPerMillion": 2.0 }
}
保存後，面板與賬本按新費率計算。
面板¶
在 DSH Settings 中打開 Cost 頁，可查看今日 / 本月花費與預算進度、分模型 token 與費用、按費用排序的近期會話，以及預算狀態（OK / warning / exceeded）與 enforcement 開關。
適用場景與注意¶
適合誰：長期在 DSH 裏調試智能體、需要把 token 花費換算成金額、或要對月度 API 支出設上限的團隊與個人。
使用注意：
- 插件以當前 dsh 進程權限讀寫
.cost/ledger.jsonl等本地文件；安裝前應閱讀 npm 包內源碼與 MIT 許可證，自行評估是否滿足安全與合規要求。 - 預算強制攔截需顯式開啓（如 CLI 的
--enforce或配置中的enforce: true）；默認以告警爲主。 - 目錄頁與 GitHub 線索倉庫可能滯後於 npm 發佈；功能變更以包內 README 爲準。
- 社區目錄星標等元數據以站點展示爲準（線索中 GitHub 星標爲 0），不代表質量背書。
結尾¶
dsh-cost-track 把 DSH 每次模型調用的 token 消耗落到可審計的賬本，並在設置頁與 CLI 裏提供彙總與預算能力，適合需要「看得見、控得住」調用成本的 DSH 開發者。
- 社區目錄：https://www.skillhub.cn/plugins/hj01857655/dsh-cost-track
- 目錄線索 GitHub（訪問時 404）：https://github.com/hj01857655/dsh-cost-track
- npm 包與 README：https://www.npmjs.com/package/dsh-cost-track
