在使用 DeepSeek Harness (DSH) 进行智能体开发或日常对话时，实时监控 token 用量与成本至关重要。DeepSeek 官方提供峰谷定价策略，手动计算容易出错且不直观。下面介绍一个插件，它能够实时监听会话 token 用量，严格对齐官方定价计算费用，并在 TUI 状态行或通过 /billing 命令生成鲸鱼 ASCII 账单小票。
插件介绍¶
该插件由 ethanz11-creat 维护，核心价值在于将 DeepSeek 的峰谷计费逻辑落地到 DSH 环境中。它不仅能实时显示费用，还能生成可视化的收银台风格账单，支持 Agent 工具调用。
核心功能¶
- 峰谷分时计费：严格对齐 DeepSeek 官方计价页，高峰时段收全价，空闲时段打五折。
/billing命令：在 TUI 对话流中持久打印鲸鱼 ASCII 账单小票。- TUI 状态行：状态栏实时显示当前会话累计费用与高峰/空闲状态。
- Agent 工具：提供
show_billing（查费用）与check_pricing_period（查当前峰谷时段）。 - 会话继承：切换模型 fork 出新会话时继承父会话用量。
- 去重防堆叠：连续多次
/billing若没有新的输入/输出，不会重复贴票。 - 只计 DeepSeek 模型：仅识别
deepseek-v4-flash/deepseek-v4-pro，其它模型返回 null。
安装与启用¶
插件通过 dsh plugin 的 bundle 机制安装，安装后开箱即用，无需额外配置。
dsh plugin --profile demo add dsh-billing-tui
使用方式¶
安装完成后，可以通过以下方式使用：
1. 在对话流中运行 /billing 打印账单小票。
2. 查看 TUI 状态行实时显示的费用。
3. Agent 调用 show_billing 工具查询费用。
4. Agent 调用 check_pricing_period 工具查询当前时段。
定价与规则¶
插件严格对齐 DeepSeek 官方定价页，单位为 元 / 百万 tokens。高峰时段为北京时间 9:00–12:00、14:00–18:00（每天，含周末），其余时间为空闲时段，价格为高峰的 50%。
计费逻辑包含：
* 缓存命中：对应 DeepSeek API 返回的 prompt_cache_hit_tokens。
* 推理 token：与输出 token 合并后按输出档位计费。
* 模型支持：仅 deepseek-v4-flash 和 deepseek-v4-pro 会被计费，其他模型（如 Claude、GPT）或未知型号返回 null，不计费。
注意事项¶
- 时区：时段判断使用固定
Asia/Shanghai时区，不依赖本机时区。 - 可选配置：可在
cordis.patch.yml中配置currency（默认 CNY）和pricing_source（默认 deepseek_official）。
生态背景¶
DeepSeek Harness (DSH) 理念是「一切皆插件」。该插件属于社区插件，与 DeepSeek 或幻方无官方从属关系。
