前言¶
在 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
