前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的架构。对于开发者而言，在使用 DeepSeek API 进行开发时，实时掌握 API 调用成本和账户余额是必要的。moyunlee/deepseek-ai-dsh-api-cost 插件挂载在 DeepSeek Harness Web profile 上，提供实时费用监控功能。
该插件直连官方余额接口，不依赖第三方服务。它不仅提供余额展示，还支持消耗统计、趋势分析以及对账功能。安装后，开发者可以在 Web 界面直观地看到每次对话产生的费用和 Token 消耗。
功能¶
该插件主要包含以下功能：
- 实时余额：直连官方
get-user-balance接口，API Key 不出服务器。 - 消耗统计：支持本对话、今日、本月及全局的消耗统计，按模型拆分 Token 与金额。
- 7 日趋势：展示 V4 Pro / V4 Flash 双模型的消耗趋势，支持金额与 Token 切换。
- CSV 对账：导入 DeepSeek 平台官方导出的
amount-*.csv，按官方单价重算本地金额后进行对比。 - 价格校准：从官方 CSV 自动提取单价，写入本地价表。
- 预算告警：设置月度限额，超限可配置 webhook 推送通知。
- 一键充值：面板内直达 DeepSeek 用量页。
- 明暗主题：跟随系统自动切换，支持手动锁定白天或夜晚模式。
- 数据不丢：每次调用落盘为 JSONL 账本，重启后按当前价表重算历史金额。
安装与启用¶
安装命令如下。装完即自动激活，无需修改配置文件。
pnpm dsh plugin --profile web add ./deepseek-ai-dsh-api-cost-0.1.0.tgz
安装完成后，启动 Web 服务：
pnpm dsh web
配置¶
配置文件位于 $DSH_HOME/profiles/web/cordis.patch.yml。该文件与内置默认值合并，只写需覆盖的字段即可。
- id: api-cost
config:
# 模型价格配置（¥/百万 token）
prices:
my-model:
input: 3.0
cacheRead: 0.1
cacheWrite: 3.0
output: 9.0
# 峰谷计费（默认关闭；北京时间高峰 9:00–12:00、14:00–18:00，谷时段半价）
peak:
enabled: true
peakHours: [[9, 12], [14, 18]]
peakMultiplier: 1.0
offpeakMultiplier: 0.5
# 月度预算告警
budget:
monthlyLimit: 50
webhookUrl: 'https://example.com/hook'
# 余额校准
calibration:
enabled: true
initialBalance: 100
deviationThreshold: 0.05
插件内置了 deepseek-v4-flash 和 deepseek-v4-pro 的默认价表。若官方定价调整，可在对账时使用 CSV 自动校准。
使用方法¶
- 查看余额：打开
http://127.0.0.1:3080，左下角显示「余额 / 花费」徽章。 - 查看详情：悬停徽章可查看完整详情，包括余额、本对话/今日/本月费用、Token 详情、7 日趋势等。
- 跳转设置：点击徽章可直接跳转到设置页的「用量与消耗」仪表盘。
- CSV 对账：在设置页点击「核对官方 CSV」，选择官方导出的
amount-*.csv文件。本地金额会先按 CSV 中的官方单价重算，再与官方金额对比。 - 导出与重置：支持一键导出本地账本 CSV；重置功能会清空全部累计记录（需确认）。
注意事项¶
- 统计范围：插件只统计启用之后产生的调用，历史会话不回溯。已有账本会按当前价表重算金额。
- 未配置模型：未在
prices中配置的模型按 0 元计费，Token 仍照常累计。 - 余额缓存：余额接口每分钟缓存一次，减少请求频率。
- 安全性：API Key 通过凭据服务解析，不会进入浏览器。重置/校准接口要求自定义头
x-dsh-api-cost: confirm以防 CSRF。 - 时区：峰谷计费按北京时间（UTC+8）判断，不依赖本机时区。
- 兼容性：点击徽章跳转设置页通过设置面板的 DOM 触发实现，若 Harness 后续改动该面板结构，此跳转可能失效，但设置页本身仍可正常访问。
结语¶
该插件为 DSH 用户提供了从余额监控到账单对账的完整链路，帮助开发者控制成本。插件源码托管在 GitHub，遵循 MIT 许可证。
