dsh-ui-cost：DeepSeek Harness Web UI 的实时 Token 使用量与成本预估插件

前言¶

DeepSeek Harness (DSH) 的 Web UI 提供了基础的对话统计信息。dsh-ui-cost 插件接管了这一行数据，为开发者提供实时的 Token 使用量统计和基于官方定价的预估成本。

插件介绍¶

这是一个由 uaapple 维护的纯 DSH 浏览器插件，遵循 MIT 许可证。它不修改 ui-conversation 核心代码，因此即便 DSH 或 DSH Desktop 进行升级并恢复默认核心，该插件仍能保持兼容。

插件注册在 conversation.composer.dock 单元格中，作为核心统计条目（id: 'stats'）的阴影条目存在，覆盖了整行数据。

核心功能¶

插件接管了统计行中的以下所有数据：

• 会话信息：轮次（turn）和步骤（step）计数。
• 性能指标：LLM 和工具的运行时间（wall time），TTFT（首字延迟）与解码吞吐量。
• 缓存状态：缓存命中率（cache-hit share）。
• 计费数据：计费 token 数量以及基于官方定价的预估成本。

成本计算逻辑：
插件会根据会话当前的模型选择，对耐久的 tokenUsage 投影进行定价。计算包含未缓存的输入、缓存写入（按缓存未命中输入率）、缓存读取（按缓存命中率）以及输出 token。

定价与时段：
价格来源于官方 Models & Pricing 页面（单位：CNY / 1M tokens）。费率会自动跟随官方宣布的峰/谷时段调度：高峰为北京时间 09:00–12:00 和 14:00–18:00，非高峰时段费率减半。

安装与启用¶

通过 DSH 命令行安装：

dsh plugin --profile web add github:uaapple/dsh-ui-cost

为确保安装的可重现性，建议将命令固定到完整的 commit SHA。

如果插件包声明了 dsh.bundle，上述命令会自动挂载该行。若需手动挂载，可在配置中写入：

- insert:
    - id: ui-cost
      name: dsh-ui-cost

注意事项¶

• 社区插件：该插件为社区项目，与 DeepSeek AI 无官方隶属关系。
• 稳定性：如果插件崩溃，阴影单元格会自动退役，恢复显示默认的统计条。
• 卸载：若通过 cordis.yml 组合该插件，移除组合后默认统计条将恢复显示。
• 运行环境：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。