dsh-monitor：DeepSeek Harness 会话计费与用量查询插件

DeepSeek Harness（DSH）的核心理念是“一切皆插件”。在使用过程中，会话的实时费用和不同模型提供方的配额状态是常见的痛点。dsh-monitor 插件旨在解决这两个问题：提供精确的会话费用角标，以及按模型提供方配置的用量查询面板。

核心功能¶

• 会话费用角标：在会话头部实时显示成本，包含输入、缓存命中、缓存未命中和输出的 Token 详情，刷新后依然准确。
• 按提供方用量面板：点击模型切换器旁的仪表盘图标，查看当前会话提供方的配额状态。
• 三种预设配置：
  • DeepSeek 官方：内置，直接查询 api.deepseek.com 的余额。
  • OpenCode：查询 5 小时/周/月套餐的用量百分比和重置时间。
  • 自定义 HTTP：支持任意 HTTP 用量端点，配置 URL、Headers 和 JSON 路径。
• 官方价格同步：一键从 DeepSeek 官方定价页同步价格表和峰谷时段。

安装与启用¶

通过官方安装命令将插件加入 web profile 的 bundle 层：

dsh plugin --profile web add https://github.com/Coco-king/dsh-monitor.git#v0.3.1

插件会声明 dsh.bundle.patch，因此会自动加入 bundle 层。修改代码后需重新运行上述命令以应用更改。

使用方法¶

1. 配置提供方：进入 Settings -> Usage -> Provider usage config，点击添加提供方。提供方 ID 为下拉菜单，可选项包括 Settings -> Models 中配置的模型提供方，以及已在此处配置的提供方。选择预设并填入字段即可。
2. 查看用量：在 Composer 中，点击模型切换器左侧的仪表盘图标。面板会显示当前会话提供方的配额：提供方名称、预设徽章以及右上角的刷新图标。
3. 管理价格：进入 Settings -> Usage -> Billing prices。可以手动编辑价格，或从官方文档同步。价格表会自动同步峰谷时段配置。
4. 首次启动：插件首次启动时，会将历史会话数据回填到本地 SQLite 账本中。此过程可能需要几秒钟，控制台会显示进度条或日志，页面在此期间保持可用。

注意事项¶

• DeepSeek 官方余额：无需额外配置，插件会自动复用 Settings -> Models 中的 API Key 查询官方余额。
• 更新代码：修改代码后必须重新运行安装命令才能生效。
• 数据回填：首次运行时会有一次性的数据回填操作，之后增量同步非常快。
• 许可证：插件遵循 MIT 许可证。

总结¶

dsh-monitor 通过 SQLite 本地账本和事件溯源的会话投影，实现了费用的精准计算。适合需要精细化管理 DeepSeek 及第三方 API 成本和配额的开发者。更多信息请参考插件目录或 GitHub 仓库。