在 DeepSeek Harness (DSH) Web 界面中开发或调试时，需要了解当前会话、整个项目以及账户余额的 API 成本。omdsh-usage 插件在 Chat 和 Work 模式的会话头部、以及 Code 模式的角落提供这些信息，以便快速监控消耗。
核心功能¶
插件在界面上添加了三位数字的消耗徽章，显示当前的 API 花费。
- 位置显示：在 Chat 和 Work 模式下，徽章显示在会话头部，紧邻模式芯片。在 Code 模式下，由于没有头部，徽章显示在框架的角落。
- 数据范围：显示当前会话的消耗、当前项目的总消耗以及账户余额。
- 详细信息：将鼠标悬停在徽章上，可以看到详细的令牌分解（包括缓存命中/未命中、输出、峰值/夜间费率）和成本计算。
- 技术实现：插件提供了
omdshUsage投影单元，用于按模型统计令牌。同时提供了GET /omdsh-usage/summary端点。价格计算在主机端进行，浏览器端只接收格式化后的数字。
配置¶
插件提供了一套可配置的参数，用于控制显示的货币、费率、夜间折扣以及低余额阈值。
- 配置入口：可以通过 DSH 界面的“Settings -> Plugins -> Plugin hub -> Usage”进行配置，也可以直接在
cordis.yml中写入。 - 配置项：
currency：货币单位，如 CNY 或 USD。rates：定义不同模型的费率表，格式为<cache hit>/<cache miss>/<output>，单位为每百万 tokens 的峰值价格。支持default默认行。offPeakDiscount：夜间折扣比例，例如0.5表示夜间价格为峰值的一半。lowBalance：余额低于此阈值时，所有图标变红。apiKeyEnv：用于获取余额的 API Key 环境变量名，默认为DEEPSEEK_API_KEY。baseURL：余额查询的 API 地址。
技术细节与注意事项¶
- 依赖项：插件依赖
omdsh-sidepanel插件来提供 Files 和 Terminal UI 上下文。 - 高峰时段：夜间折扣的时间窗口是硬编码的，为北京时间 09:00-12:00 和 14:00-18:00。
- 缓存机制：账户余额每分钟缓存一次。
- 运行环境：插件要求 Node.js 版本为
^22.19.0或>=24.0.0。 - 费率校验：在写入
cordis.yml时，费率行必须由三个非负数字组成，否则会被拒绝。
总结¶
omdsh-usage 插件通过投影单元和 API 端点，将 DeepSeek Harness 的 API 消耗集中在界面显眼位置，便于开发者实时监控成本。它支持自定义费率和夜间折扣，并在主机端进行价格计算。
