dsh-deepseek-usage：DeepSeek 平台用量面板

在 DeepSeek Harness（DSH）的开发环境中，实时监控 API 调用次数、Token 消耗和账户余额是必要的。手动在网页端查看不仅效率低下，而且容易打断工作流。dsh-deepseek-usage 插件将 DeepSeek 平台的用量数据集成到 DSH 的 Web 界面侧边栏中，提供统一的监控入口。

该插件由社区开发者 scientisbo 维护，遵循 MIT 许可证。它通过读取 DeepSeek 平台的公开接口和私有 Dashboard 接口，在本地生成可视化的用量面板。

核心功能¶

账户余额与用量展示：显示账户余额、今日/本月 Token 数量、花费、请求数、缓存命中/未命中情况、Top 模型排名。
可视化热力图：提供每日用量热力图，按月翻页与单日明细。
侧边栏集成：在侧边栏底部提供入口，支持徽标显示当前余额；点击打开浮动面板，收起侧边栏时变为圆形图标按钮。

安装与启用¶

使用以下命令安装插件。若通过文件安装，请替换路径为实际的文件路径。

dsh plugin --profile web add "file:/绝对路径/dsh-deepseek-usage"
# 或者发布到 npm 后：dsh plugin --profile web add dsh-deepseek-usage

安装完成后，重启 dsh web 并在浏览器中硬刷新（Ctrl+Shift+R），侧边栏底部会出现「DeepSeek 用量」入口。

配置凭据¶

插件依赖两个凭据：API Key 用于获取余额，Platform Token 用于获取平台用量详情。

数据类型	凭据名	说明
余额	`DEEPSEEK_API_KEY`	默认读取 ref，可在配置中指定 `apiKeyRef`
平台用量	`DEEPSEEK_PLATFORM_TOKEN`	默认读取 ref，可在配置中指定 `platformTokenRef`

获取 userToken¶

浏览器登录 https://platform.deepseek.com。
打开浏览器开发者工具（F12），进入 Application（应用）选项卡。
在 Local Storage 中找到 platform.deepseek.com 域名。
复制 userToken 的值。

配置方式¶

面板内粘贴：在插件面板的「配置会话 token」区域直接粘贴 userToken（推荐，即时生效）。
写入配置文件：在 ~/.dsh/.credentials.yaml 中写入：

    refs:
      DEEPSEEK_PLATFORM_TOKEN: <userToken>

未配置 userToken 时，面板仍显示余额，用量区会给出配置引导。

可选配置¶

通过 cordis.patch.yml 的 insert 条目，可以调整插件的运行参数。

- insert:
    - id: deepseek-usage
      name: dsh-deepseek-usage
      config:
        apiKeyRef: DEEPSEEK_API_KEY        # 默认
        platformTokenRef: DEEPSEEK_PLATFORM_TOKEN  # 默认
        refreshMs: 300000                  # 服务端缓存 TTL，默认 5 分钟
        timeoutMs: 15000                   # 上游请求超时，默认 15s

接口与安全¶

插件内置了两个服务端接口，用于获取数据。

端点	说明
`GET /api/deepseek-usage/summary?month=&year=`	余额 + 指定月份用量聚合（带缓存）
`GET /api/deepseek-usage/refresh?month=&year=`	强制刷新上述数据

安全说明：
* 服务端接口仅接受本机回环（localhost）的 GET 请求。
* userToken 仅存储在浏览器的 localStorage 中，仅随请求头发送给本机 dsh 服务，绝不会落盘保存。

生态背景¶

DeepSeek Harness 的核心理念是「一切皆插件」。该插件依赖 DeepSeek Harness Web 客户端环境运行。作为社区目录中的独立项目，它不隶属于 DeepSeek 或幻方官方，由开源社区维护。