前言¶

在 DeepSeek Harness（DSH）中，随着会话变长，上下文占用增加，缓存读取的成本往往占据账单的绝大部分。开发者在决策是否保留上下文、如何优化提示词时，往往缺乏精确的实时数据。

插件介绍¶

dsh-axia-cachebilling（虾算账）是一个 DSH Web 插件，由 Animal2404 维护。它将计费与缓存监控功能直接挂载到 DSH 自带的“上下文占用弹层”中，无需额外页面，也不遮挡聊天主界面。

核心功能¶

该插件提供以下能力：

1. 三档账单统计
   - 提供当前步、当前轮、本会话三档账单。
   - 每档明细包含：命中、未命中、输出三部分的费用与统计。
   - 底部显示当前使用的模型胶囊（包含供应商/模型、谷价/峰价、货币）。

2. 上下文统计（8项指标）
   - 基于会话日志事件的真实计数，而非估算或占比推算。
   - 指标包括：轮次、步数、工具调用、图片、剪枝、注入、压缩等，并附带预估费用。

3. Token 统计
   - 展示总 Token、缓存输入 Token、未缓存输入 Token、输出 Token。
   - 同时提供绝对量与百分比展示。

4. 计费与汇率
   - 多币种自动统一：支持元与美元，通过实时汇率取自 open.er-api.com 统一折算，取不到时退化为并列展示。
   - 峰谷价支持：支持按峰谷时段分别计价。
   - 价目目录自动填价：内置 Open Code / Command Code / GLM / Kimi / MiniMax / MiMo 等模型价格，新增或修改模型时自动填价，也可手动刷新。

5. 配置集成
   - 供应商与模型列表直接从 DSH 已配置的列表中拉取。
   - 设置页支持自定义条目（一口价、峰谷价、货币），修改即时生效，无需重启 DSH。

安装与启用¶

执行以下命令安装插件：

dsh plugin --profile web add github:Animal2404/dsh-axia-cachebilling

安装完成后重启 DSH，打开任意会话的“上下文占用弹层”即可看到实时账单。

注意事项¶

• 源码与构建：插件的构建流程仅在 GitHub Actions 中执行，本地无需构建环境。
• 汇率来源：实时汇率数据取自 open.er-api.com。
• 权限与许可：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。