前言¶

在 DSH 的「一切皆插件」扩展方式下，web 客户端可以通过插件增加面板、统计和用量分析能力。对使用 DeepSeek API 的 DSH 开发者来说，一个具体问题是：API 余额在哪里看，今天的 token 花费是多少，外部视觉模型调用有没有被计入成本。

dsh-usage-dashboard-plus 针对这些问题，在 DSH web 侧边栏底部显示 余额 ¥xx · 今日 ¥xx，并提供完整用量面板。

这是什么¶

dsh-usage-dashboard-plus 是 1HelloMan1 维护的 DSH web 插件，许可证为 MIT。资料说明它是 dsh-usage-dashboard 的 fork，原仓库也是 MIT。

它的主要定位是：

• 在侧边栏底部显示 DeepSeek API 余额与今日花费。
• 支持外部视觉模型调用统计与完整用量面板。
• 继承 Stats 实现，提供调用日志、按模型统计和 CSV 导出。
• 无构建步骤：通过 dsh.client 机制提供 host half (lib/index.js) 和 browser bundle (lib/client.js)。

核心功能¶

侧边栏底部 widget¶

widget 显示：

余额 ¥xx · 今日 ¥xx

点击后打开详情卡片。详情卡片可查看调用量、token、按模型拆分和定价说明。

API 余额¶

插件通过 DSH credentials service 解析 DeepSeek key，并查询余额端点。查询带缓存，balanceCacheMs 用于配置缓存时长。

今日花费（估算）¶

今日花费为估算值。插件扫描会话日志，以及可选的外部 usage log，按价格表估算 token 花费。

外部视觉模型调用统计¶

插件通过可选 JSONL usage log，将外部视觉模型调用计入今日花费。它内置 mimo-v2.5 定价条目，可用于成本估算，并支持通过 prices 覆盖。

峰谷定价计划¶

支持 date-gated 的 DeepSeek 费率表。资料提到 2026-08-17 起的峰谷价格表，相关配置项为 priceSchedule。

完整用量面板¶

完整用量面板按 provider/model 显示：

• 调用量
• 延迟
• TTFT
• 吞吐
• input/output/cache tokens
• cache rate
• 估算成本

调用日志分析¶

调用日志支持按 session、provider、model 过滤和搜索，查看近期调用，并导出过滤后的 CSV。调用日志有 500 行上限。

继承 Stats 实现¶

Plus 包含以下继承的 Stats 实现：

• usageDashboard session projection
• 500 行调用日志上限
• 整 session 模型聚合
• replay-safe 历史统计

安装与启用¶

在 web profile 中安装：

dsh plugin --profile web add dsh-usage-dashboard-plus

安装后重启 dsh web。这是因为 profile patch layer 不会热加载。

验证配置：

dsh --profile web --dump-config

预期输出中出现 usage-dashboard-plus row。

随后硬刷新 GUI，例如 Cmd+Shift+R。底部 widget 会出现在 设置/Settings 旁。

从 dsh-stats-dashboard 迁移¶

旧 dsh-stats-dashboard 已合并到 Plus。迁移时：

1、在 web profile 中移除或禁用旧 dsh-stats-dashboard 插件。
2、安装 dsh-usage-dashboard-plus。
3、重启 dsh web，并硬刷新 Settings 页。

不要在同一 profile 同时安装/启用两个统计插件。

典型用法¶

配置 usage-dashboard namespace¶

配置放在 ~/.dsh/settings.yaml 的 usage-dashboard 命名空间。资料说明 usage-dashboard 配置项支持热加载。

示例：

usage-dashboard:
  apiKeyRef: DEEPSEEK_API_KEY
  baseURL: ""
  prices:
    "mimo-v2.5": { input: 2, cacheRead: 0.05, output: 8 }
  priceSchedule: []
  balanceCacheMs: 60000
  sessionsRoot: ""
  scanWindowMs: 172800000
  externalUsageLog: ""

各配置项：

• apiKeyRef：余额查询使用的 DeepSeek key credential ref。
• baseURL：余额查询使用的 base URL。
• prices：按模型的价格条目；可覆盖内置 mimo-v2.5 条目。
• priceSchedule：date-gated 峰谷价格表。
• balanceCacheMs：余额查询缓存时长。
• sessionsRoot：会话日志目录。
• scanWindowMs：会话日志扫描窗口。
• externalUsageLog：外部模型调用 JSONL 日志路径。

配置外部 usage log¶

externalUsageLog 可配置为 JSONL 日志路径。默认路径为 <dsh home>/vision-fallback/usage.jsonl。如果不需要外部 usage log，可设置为 off 禁用。

一行 JSONL 示例：

{ "ts": 1755000000000, "model": "mimo-v2.5", "inputTokens": 1200, "outputTokens": 320, "cacheReadTokens": 0, "cacheWriteTokens": 0 }

适用场景与注意¶

适合在 DSH web 客户端中查看 DeepSeek API 余额、今日花费、外部视觉模型调用统计、完整用量面板和 CSV 导出的人使用。

需要注意：

• 今日花费为估算值，基于会话日志与外部 usage log 的价格表计算。
• 余额查询使用 DeepSeek key ref 和余额端点，且存在缓存。
• 调用日志有 500 行上限。
• 峰谷价格表是 date-gated，资料提到 2026-08-17 起。
• profile patch layer 安装后不热加载，需要重启 dsh web；usage-dashboard 配置项支持热加载。
• 旧 dsh-stats-dashboard 已合并到 Plus；不要在同一 profile 同时启用两个统计插件。
• 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证；该插件为 MIT 许可证，资料说明其 fork 的原仓库也是 MIT。

链接¶

• GitHub：1HelloMan1/dsh-usage-dashboard-plus
• 社区目录页：dsh-usage-dashboard-plus

上面的目录页是社区插件目录，不是官方应用商店；与 DeepSeek / 幻方无官方从属关系。