dsh-usage-chart

DeepSeek 用量 / 成本 / 余额仪表盘 · DSH Web 插件

English · 问题反馈

界面预览：左侧为浅色英文界面，右侧为深色简体中文界面。两者均会跟随 DSH 的主题与语言设置。

浅色主题 · English

深色主题 · 简体中文

图片仅使用虚构演示数据：不含真实会话内容、Token、成本、余额或 API Key。

在 DeepSeek Harness Web UI 的输入框下方实时显示 token 用量、成本估算、模型与账户余额；点击展开用量可视化图表面板（参考 DeepSeek 开发者平台的用量页组织方式），全部使用零依赖 SVG 自绘，不引入任何图表库。

▸ 输入 12.4M · 输出 86.2K · 缓存 72% · 成本 ≈$0.042 · demo-model · 余额 --

点击 ▸ 展开面板：

• 会话用量汇总 — 输入（未命中/命中）、输出、缓存命中率、上下文占用（均来自官方 adapter 上报的 tokenUsage / contextPressure 投影）
• 成本估算 — 按官方刊例价（USD/1M tokens）估算，标注「估算，非账单」
• 轮次用量 — 支持“总量 / 构成”视图与悬浮详情；从宿主会话日志折叠完整历史，不可用时回退到本页观测增量
• 账户余额 — 官方 GET /user/balance 接口实时查询（经宿主侧代理，密钥不暴露给浏览器）
• 中英双语 — 自动跟随 DSH 应用内语言设置，支持运行时切换 zh / en

特性

数据	来源	准确性
token 用量	DSH 官方 adapter 上报的会话投影（tokenUsage / contextPressure）	✅ 官方真实数据，实时更新
成本	官方刊例价 × adapter 上报用量	⚠️ 估算值，非官方账单
余额	官方 GET https://api.deepseek.com/user/balance	✅ 官方实时数据
模型名	adapter 上报的请求 provenance	✅ 官方真实数据

技术栈

• 语言：TypeScript 源码，发布为 DSH 可加载的 JavaScript bundle
• 框架：Cordis 插件模型 + React 18
• 构建：esbuild（host 半区 = Node ESM；client 半区 = window.__ModuleLoader__.load({id, factory}) 工厂包，外部依赖与 DSH web 的 PLATFORM_MODULES 完全一致）
• 可视化：零依赖手写 SVG（DSH web 未内置图表库；自绘与平台渲染方式一致、体积最小、最稳定）

安装

前置要求：DSH ≥ 0.1.0-rc.6 · Node.js ≥ 20 · PATH 上有 pnpm（dsh plugin 会把安装命令转发给 pnpm）。

若提示 dsh: command not found（或 PowerShell 无法将“dsh”项识别为…），说明只通过 npx @deepseek-ai/dsh 临时运行过、未安装全局命令——按 FAQ 第一条解决 （全局安装后重开终端，或每条 dsh ... 前加 npx --yes @deepseek-ai/dsh）。

方式一：npm 仓库安装（推荐，预构建产物，无需构建工具）

dsh plugin --profile web add dsh-usage-chart   # 安装并自动登记为 profile 插件层
dsh web --profile web                          # 启动 DSH Web（已在运行时先停止再启动）

更新（升级到新版本）：pnpm 对已安装的依赖重新 add 可能显示 Already up to date 而不升级，请用显式版本（推荐）或先卸载再安装：

### 配置余额查询

余额查询需要 DeepSeek API Key，按以下优先级解析（每次请求实时解析，改后无需重启）：

1. **DSH 网页端配置（推荐，需插件 ≥ 0.1.1）**：在 DSH Web 的「设置 → 模型」中配置
   DeepSeek API Key。插件经 DSH 凭据服务读取同一密钥（`.credentials.yaml` 用户层），
   无需额外操作；
2. **环境变量**：启动 `dsh web` 前导出 `DEEPSEEK_API_KEY=sk-...`（凭据服务的 env 层，同样生效）；
3. **插件配置**：在 profile 的 `cordis.patch.yml` 中覆盖（Key 会以明文落盘，仅建议用于受保护的本机 profile）：

```yaml
- insert:
    - id: dsh-usage-chart
      name: dsh-usage-chart
      config:
        apiKey: 'sk-...'        # 留空则回退到网页端/环境变量
        baseUrl: 'https://api.deepseek.com'

插件版本 < 0.1.1 时不读取网页端密钥：请用环境变量或上面的 config.apiKey 配置。

未配置 Key 时，指示器显示 余额 –，点击可重试；面板内会提示如何配置。