dsh-board

简体中文 · English

给 DeepSeek Harness（DSH） 的 侧栏用量与成本面板：把 DeepSeek 后台风格的用量统计装进 Web GUI 左下角。

特性

• 💰 计费估算：官方价目 + 2026-08-17 起北京时间峰谷自动切价（高峰 09:00–12:00、14:00–18:00，闲时半价）；推理 token 按输出价计入；口径详见下文
• 🧠 1M 上下文：占用 %、剩余预算、系统/工具/消息构成堆叠条、子代理耗时
• 📈 可视化：每轮输入/输出走势、累计输出曲线、12 周日热力图、分模型统计、全局会话榜
• 🏆 「词勋」段位：十级谐音梗阶梯（🌱 未醒词芽 → 🧲 万词王 → ⚡ 万亿词神），会员卡式展示：进度条、解锁 ETA、每级权益
• 🔥 成就：连续打卡天数 + 9 枚数据驱动徽章
• 🎨 视觉：Geist 克制风、明暗主题适配、中英双语、零装饰动画
• 🖼 横版徽章：收起为菜单宽瓷砖（段位标签 + ¥ 花费 + 总 token + 今日本周）；点击后徽章升到面板顶部展开，再点收起

安装

# npm（推荐）
dsh plugin --profile <profile> add dsh-board@0.2.0
# 或从 GitHub 直装
dsh plugin --profile <profile> add github:dfkai/dsh-board@v0.1.0

装完重启该 profile（或新起 dsh --profile <profile>），左侧栏底部即可看到徽章。验证：

dsh --profile <profile> --dump-config   # 应出现 # == dsh-board 层

harness 版本要求：推理 token 按输出价计入用量需要 harness 的 token-meter 修复。补丁已提交官方社区（discussions/2338，可合并分支 dfkai/deepseek-harness@fix/token-meter-reasoning-output）。旧 harness 上分模型/每轮图表仍会计入推理 token，但累计总量与成本会少算推理部分。

禁用与配置

插件层按 id: board 寻址，可用 patch 关闭或改配置。在你的 profile 的 cordis.patch.yml 里追加：

- id: board
  disabled: true   # 关闭本面板

disabled 支持 !!js 表达式，也可以按条件开关。价格表等常量为源码级配置（见下方计费口径），改价后重新构建。

计费口径

面板显示的是估算值，不是计费凭证，以 DeepSeek 平台账单为准。

标准价（¥ / 1M tokens，2026-08-15 抓取自官方价目）：

模型	缓存命中	缓存未命中	输出
deepseek-v4-pro	0.025	3	6
deepseek-v4-flash	0.02	1	2
deepseek-chat（旧）	0.5	2	8
deepseek-reasoner（旧）	1	4	16

峰谷价（2026-08-17 00:00 北京时间生效，高峰 09:00–12:00、14:00–18:00，闲时为高峰一半）：

模型	时段	缓存命中	缓存未命中	输出
deepseek-v4-pro	高峰	0.30	9.0	27
	闲时	0.15	4.5	13.5
deepseek-v4-flash	高峰	0.10	3.0	9
	闲时	0.05	1.5	4.5

口径说明：

• 推理 token 按输出价计入（DeepSeek 官方计费口径），reasoningTokens 已并入输出
• 成本由宿主侧投影按每笔用量发生时刻的价目逐笔累加（与平台逐请求计费同口径）；未取得投影的历史会话回落为按主导模型估算
• 未知模型回落当前时刻价表中默认模型的费率

数据与隐私

全部数据来自本机 DSH 的公开接口（session.list 投影 + session.history RPC）。插件不发起任何第三方网络请求，唯一持久化是浏览器 localStorage 里的面板折叠状态；宿主半仅注册一个只读会话投影（dominantModel），不写入任何数据。

FAQ

为什么总 token 是亿级？

账单口径与 DeepSeek 后台一致：每轮对话都会对上下文前缀按「缓存命中」价计费。1M 窗口的会话聊几十轮就会累计到亿级命中 token——它们单价极低（¥0.025/M），面板副行显示「缓存命中 N%」帮你区分便宜账与真实消耗。

成本准吗？

按官方价目逐笔估算（每笔用量按发生时刻的峰谷档计价、推理 token 已计入），与平台逐请求计费同口径，但仍非计费凭证，以 DeepSeek 平台账单为准。宿主半仅注册只读投影（dominantModel、sessionCost），无任何写入。

数据会外发吗？

不会。全部统计在本机完成，无任何网络外发请求。

开发

pnpm install
pnpm build                  # 构建 lib/
pnpm sync -- <profile 目录>  # 同步到已安装副本，HMR 自动热刷

• 改 src/ → build → sync → 浏览器热更；只有改 manifest（package.json / cordis.patch.yml）才需要重装重启
• 无头验证（可选）：

python3 -m playwright install chromium
python3 test/e2e.py                 # 徽章/面板挂载 + 控制台错误检查
python3 test/drive-turn.py '...'    # 驱动真实对话读面板数值

架构

只依赖 DSH 公开 seam：

面	内容
宿主半 src/index.ts	注册一个只读的 dominantModel 会话投影（让累计成本按真实模型计价）；零写入、零外发
浏览器半 src/client/*	ctx.slots.inject('sidebar.footer.action', …) 注册横版徽章；数据 = session-list store 的 projectionValues + session.history RPC 折叠
构建 tsdown.config.ts	CJS 闭包工厂（window.__ModuleLoader__.load）+ 平台白名单 externals

License

MIT