dsh-client-ui-usage — DeepSeek Harness 用量分析插件
🌐 Languages: 中文 · English · 日本語 · 한국어 · Español · Français · Deutsch
演示
给 DeepSeek Harness Web（dsh web）输入框下方加一行峰谷计费坞，点击展开完整的用量分析仪表盘：跨会话的 token / 成本 / 模型 / 峰谷数据自动落盘，并提供全局筛选与多维图表。
用量分析仪表盘
功能特性
-
峰谷分时计费：按北京时间峰时（9:00–12:00 / 14:00–18:00，仅工作日）与谷时（半价）计价；周末（周六、周日）全天按谷时计费（DeepSeek 新规，2026-08-23 起生效，历史账单自动修复重算）。坞上实时显示当前时段、进度条、距下次调价倒计时（周末显示「周末谷时」徽章，倒计时直达周一 9:00 峰时）、会话累计 / 本轮成本与账户余额（60 秒自动刷新，走官方 /user/balance 代理，API Key 不出浏览器）。
折叠坞
-
历史落盘：每一步 token / 成本 / 模型 / 峰谷自动写入 ~/.dsh/storages/usage-history.jsonl，跨会话、跨重启保留（软上限 4 万条自动裁旧）。
-
全局筛选：面板顶部的全局选项，所有图表与统计卡实时联动——
- 时间范围：今天 / 7 天 / 30 天 / 90 天 / 全部
- 会话范围：全部会话 / 本会话
- 模型筛选：全部模型 / 单个模型
-
按日期查看：点击成本趋势图上的任意一天，仪表盘即下钻到该日——统计卡、模型分布、峰谷对比、Token 结构、最近记录全部切到当日，并额外给出分时分布（24 小时成本柱状图，峰时区间底色标记）与当日会话排行；日期条支持前一天/后一天切换，到「今天」为止，并可一键退出按日期视图。切换日期走客户端摘要缓存，即时渲染不闪烁。
-
统计卡：成本（含峰/谷拆分）、Tokens（含输入/输出）、轮次（含峰/谷）、缓存命中率、谷时节省、单步均值。
-
分析图表：
- 成本趋势折线（支持悬浮查看当天成本、峰谷拆分，点击下钻到当日）
- 分时分布柱状图（按日期视图，24 小时成本，峰谷配色）
- Token 结构环形图（支持「全部 / 按模型」切换）
- 模型分布条形图（完整模型名 + 成本占比）
- 峰谷对比与谷时节省
-
最近记录：最近 20 轮的全部步骤（默认折叠、按轮分组，轮标题带模型徽章、峰谷与成本，支持展开/收起全部，区域内滚动）；按日期视图显示当日全部轮次（最多 60 轮），跨会话时轮标题带会话标签。
最近记录
-
点外部关闭：面板通过 React portal 渲染，点击面板外任意位置或按 Esc 关闭。
要求
- DeepSeek Harness（dsh）
0.1.1-rc.1 的 web profile
- 余额显示需要在模型设置页配置过 DeepSeek API Key（未配置时余额显示「—」，其余功能不受影响）
安装
方式一：一键安装（推荐）
需要 pnpm（dsh plugin 把参数原样转发给 pnpm，在 profile 目录里执行）。
没有的话先装：corepack enable pnpm（Node 自带 corepack）或 npm install -g pnpm。
一条命令，直接安装 GitHub Release 里的 tarball（实测可用）：
dsh plugin --profile web add https://github.com/woosh2010/dsh-usage-dashboard/releases/download/v0.4.0/deepseek-ai-dsh-client-ui-usage-0.4.0.tgz
包声明了 dsh.bundle.patch，dsh plugin 会自动把 @deepseek-ai/dsh-client-ui-usage 写进 profile 的 dsh.profile.bundles 列表并挂载为 ui-usage 条目。然后重启 dsh web 并刷新浏览器。
从方式二/三切换过来：先删掉 ~/.dsh/profiles/web/cordis.patch.yml 里手工添加的 ui-usage insert 行，否则 bundle patch 与手工 insert 的条目 id 会重复冲突。
方式二：先下载再安装（离线/内网）
-
下载安装包（Releases 里的 tgz，或 curl -LO <上面的 URL>；也可以 git clone 后 npm pack 自建）。
-
在 tgz 所在目录执行（注意路径前的 ./ 或绝对路径，直接写文件名会被 pnpm 当成 npm 包名）：
dsh plugin --profile web add ./deepseek-ai-dsh-client-ui-usage-0.4.0.tgz
方式三：手动安装
-
解压 tarball 到 profile 的解析路径：
mkdir -p ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-usage
tar -xzf deepseek-ai-dsh-client-ui-usage-0.4.0.tgz --strip-components=1 \
-C ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-usage
-
在 ~/.dsh/profiles/web/cordis.patch.yml 增加条目：
- insert:
- id: ui-usage
name: '@deepseek-ai/dsh-client-ui-usage'
-
重启 dsh web，刷新浏览器。
从源码目录直接使用：lib/client.js 由服务器按文件直读，客户端改动刷新浏览器即生效；lib/index.js（host 端路由/存储）改动需要重启 dsh web。
验证
部署后运行：
node verify.mjs # 默认 http://127.0.0.1:3080，可传 baseUrl 参数
脚本会检查：下发的客户端文件与部署文件一致、modelsAll 与每模型 token 结构、会话/模型过滤、最近 20 轮、各模型 mix 求和等于总量、day 参数按日期下钻（24 小时分时桶 + 当日会话聚合）。
数据与计价说明
- 历史存储：
~/.dsh/storages/usage-history.jsonl，软上限 4 万条自动裁旧；模型未知的记录会在投影缓存可用后自动修复（重新计价）；2026-08-23 起周末按谷时计价，历史周末账单自动重算。
- 价格表：内置于
lib/client.js 与 lib/index.js 的 PRICE_TABLE（元/百万 tokens，峰谷两档；缓存命中按命中价、写入按输入价），以及峰谷时段规则（工作日 9:00–12:00 / 14:00–18:00 峰时，其余与周末全天谷时）。DeepSeek 调价后同步改这两处即可。
- 谷时节省：谷时按峰时半价计，
谷时节省 = 谷时累计成本。
重新生成截图
docs/screenshots/ 里的截图来自真实运行中的 dsh web（余额数字已打码）。重新生成：
# 1. 启动无头 Chrome（调试端口 9222）
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--headless=new --remote-debugging-port=9222 --remote-allow-origins=* \
--user-data-dir=/tmp/dsh-shot-profile --window-size=1440,900 about:blank
# 2. 截取（可设置 DSH_CONV 指定侧栏会话名）
node scripts/screenshots.mjs dock
node scripts/screenshots.mjs dashboard
node scripts/screenshots.mjs recent
版本历史
- 0.5.0：按日期下钻——点击成本趋势图任意一天查看当日明细（分时分布 24 小时柱状图、当日会话排行、当日全部轮次记录），日期条前后切换/一键退出；修复跨会话轮次合并问题（按
会话+轮次 分组）；客户端摘要缓存，切换日期即时渲染；周末全天谷时计费（DeepSeek 2026-08-23 新规）：周末显示「周末谷时」徽章、倒计时直达周一峰时、历史周末账单自动重算。
- 0.4.0：全局筛选（时间范围 5 档 / 全部·本会话 / 模型筛选）、Token 结构按模型切换、模型分布显示全名、最近 20 轮（
turns 参数）、统计卡副信息与更紧凑布局、点击外部关闭（portal + 遮罩）、最近记录默认折叠。
- 0.3.3 / 0.1.0：初始峰谷计费坞、账户余额代理、JSONL 历史与聚合图表。
License
MIT
