dfkai / dsh-board

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 已并入输出
• 本会话成本按主导模型计价；累计成本按各会话最近活跃时刻对应的峰谷价与该会话的主导模型计价（未知模型回落默认模型 v4-pro）
• 未知模型回落当前时刻价表中默认模型的费率

数据与隐私

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

FAQ

为什么总 token 是亿级？

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

成本准吗？

按官方价目估算（峰谷自动切换、推理 token 已计入），不是计费凭证。累计成本按各会话主导模型与其活跃时刻估算（宿主半仅注册一个只读的 dominantModel 投影，无任何写入），具体金额以 DeepSeek 平台账单为准。

数据会外发吗？

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

开发

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