dsh-usage-card：DSH Web 侧边栏用量卡片

在 DeepSeek Harness 的 Web 界面开发中，频繁查看 token 消耗和余额是一个常见需求。手动切换页面或查看后台数据效率较低。dsh-usage-card 插件将用量卡片直接嵌入侧边栏，提供 7 天/30 天的用量统计与余额查询，节省切换窗口的时间。

是什么¶

这是一个由用户 kazma258 维护的 DSH 插件，用于在 DeepSeek Harness Web 侧边栏上方显示用量信息，包括 token 消费、花费金额和剩余额度。它遵循 MIT 许可证。

核心功能¶

侧边栏显示：在 Web 侧边栏的设置按钮上方展示用量卡片。
时间范围：支持查看近 7 天或近 30 天的 token 用量与消费。
余额查看：支持查看剩余额度。
数据源切换：支持在“官方数据”（需登录 token）和“估算数据”模式之间切换。
侧边栏适配：侧边栏收起时，卡片会显示为小图标，点击仍可查看详情。
自定义配置：支持自定义价格与币种配置。

安装与启用¶

确保你使用的是 DeepSeek Harness Web 介面（0.1.x）。

执行安装命令：

dsh plugin --profile web add github:kazma258/dsh-usage-card

重启 dsh web 服务，并在浏览器中刷新页面以激活插件。

典型用法¶

切换数据模式¶

卡片默认显示估算数据。点击卡片右上角的按钮，可以在“估算”、“官方”和“无数据”模式间切换。

若需查看官方数据，需要提供平台登录 token。

获取官方数据 Token¶

在浏览器中打开 platform.deepseek.com 并登录，然后打开浏览器开发者工具的 Console 面板，输入以下命令获取 userToken：

JSON.parse(localStorage.getItem('userToken')).value

自定义价格与币种¶

在对应的 profile 配置文件 cordis.patch.yml 中覆写价格与币种配置。注意，价格配置项是整行替换，不会只修改其中某一个字段。

- id: usage-card
  name: dsh-usage-card
  config:
    estimatePrices:
      inputUncached: 0.28
      cacheRead: 0.07
      cacheWrite: 0.28
      output: 1.1
    estimateCurrency: USD
    officialCurrency: USD

适用场景与注意¶

环境要求：插件仅适用于 DeepSeek Harness Web 介面（0.1.x）。
Token 类型：查看官方数据需要平台登录 token (userToken)，而非 API Key。
配置细节：价格配置采用整行替换方式，修改时需提供完整的配置行。
自动更新：卡片会在对话结束、切回分页、每 60 秒或点击刷新时自动更新。

DSH 的设计理念是“一切皆插件”。该插件通过侧边栏集成，让用量监控变得触手可及。