前言¶

DeepSeek Harness 本身不具备货币计费能力。随着 DeepSeek 在 2026 年调整价格并引入峰谷定价，开发者需要一个工具来追踪每次模型调用的真实成本。visol-456/dsh-cost-tracker 监听模型调用完成事件，按 provider 上报的 token 用量折算费用，并将记录持久化存储。

核心功能¶

• 监听与折算：监听调用完成事件，根据 provider 返回的 token 用量（输入、输出、缓存命中、缓存未命中）与价格表实时折算费用。
• 数据持久化：将每次调用记录保存到本地文件。
• 统计仪表盘：提供三层 UI 展示。
  • 调用级明细：在对话轨迹统计行中显示本次调用费用。
  • 会话级汇总：在同一统计带的“会话汇总”卡片中显示总费用及缓存命中率。
  • 全局统计页：提供主指标卡、详细指标卡、趋势折线图及请求日志/Provider 统计/模型统计 tabs。
• 峰谷定价：支持配置不同时段的价格，适配 DeepSeek 的高峰与半价策略。

安装与启用¶

1. 通过 npm 安装：

npm i @visol-456/dsh-cost-tracker

2. 在 cordis.yml 中挂载插件（裸机 node 部署）：

- name: '@visol-456/dsh-cost-tracker'
  config:
    dataDir: /path/to/cost-records  # 可选，默认为 <DSH_HOME>/cost-tracker

3. 安装到 web profile（推荐）：

dsh plugin --profile web add @visol-456/dsh-cost-tracker

典型用法¶

• 配置价格表：在会话页的“使用统计”中进入“价格配置”，修改价格表以支持峰谷定价，或直接修改 cordis.yml 中的 prices 配置。
• 查看数据：访问会话页的“使用统计” tab，查看成本趋势和详细日志。

注意事项¶

• 兼容性：仅兼容 DeepSeek Harness 0.1.5-rc.1。
• 纯节点运行：如果没有 webServer，插件仍可在纯 node 模式下运行并记录数据，只是 UI 不可用。
• 数据存储：数据文件默认存储在 <DSH_HOME>/cost-tracker/records.l。
• 插件定位：本插件为“计量/计费”插件，记录的是实际服务的 provider/model，与负责“路由/容灾”的 dsh-llm-fallbacks 插件互补使用。

结语¶

该插件为 DSH 开发者提供了成本监控能力，设计参考了 CC Switch 的 Usage Statistics 页面，通过自绘 SVG 图表实现轻量级统计。更多详情与源码请访问 GitHub。