在使用 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 仓库。
