dsh-better-stats

DSH Web 输入框下方的增强统计条：官方人民币计价（峰谷时段、官方价目自动同步）、多模型分账、实时计时、子代理树合并、余额直连、预算预警、流式成本估算。

DeepSeek 官方 | 余额 ¥8.67 | 本轮 ¥0.1676 · 会话 ¥29.49 | 20 轮 · 345 步 | LLM 1h 12m · 工具 5m 6s | 首token平均 3.88s · 111.72tok/s | 缓存 103.98M · 命中 98.64% | 输入 1.44M · 输出 336.53K

功能

• 余额：host 直连 api.deepseek.com/user/balance（DEEPSEEK_API_KEY 走 DSH credentials seam，key 不进入浏览器），15s 缓存刷新；点击余额组可强制刷新（切换模型/API 后余额不会自动更新，点击即穿透缓存直查，host 端 2s 冷却防刷）；悬浮层显示赠送/充值拆分（字段缺失时优雅降级为总额）、可用天数估算（按今日消耗与历史日均 EWMA 平滑）与低余额时的充值链接
• 计价口径：输入（未命中/缓存命中）与输出按官方价目；outputTokens 已包含 reasoningTokens——reasoning 只是 output 的子集，仅用于明细统计，不再二次计费，结算累计 tok/s 的分子也只取 sum(outputTokens)（host 与客户端一致，坏数据计为无效步而非静默钳零）
• 消费：官方 CNY 价目表（api-docs.deepseek.com/zh-cn/quick_start/pricing），host 每 6h 自动抓取解析同步（失败回退内置价目；浮窗独立「价源」栏显示来源与更新时间，如 价源 DeepSeek 官方 2026-08-18 14:16）；峰谷分时段（高峰 = 北京 9:00-12:00 / 14:00-18:00，价格两倍），按每条消息的 model 分账（deepseek-v4-flash / deepseek-v4-pro 各用各的价目）
• 未知模型显式标记：检测不到的模型不再静默按 flash 计价——token 照常汇总但不计价，悬浮层「模型」组显示 未计价 并在花费处注明「含 N 步未定价 · 模型未知」
• 缓存分桶：未命中输入、缓存命中、缓存写入分开计价（命中价远低于未命中价），并显示缓存命中率
• 本轮：按整轮（turn）结算——精确部分 = 当前轮已落定步骤的事件级折叠（每步按各自事件时刻/模型计价），流式部分 = 当前步的字符级估算（按当前峰谷时段计价，密度由已结算步骤自适应校准：EMA 追踪真实字符/token 比；估算 × estAccuracy 的同一个修正值同时驱动金额、Tok 与速率）；多步 turn 内数字连续增长、不随 thinking 结束重算，usage 落地自动转精确，估算只进显示不入账；一轮结束后本轮保留最终值，下一轮开始才归零
• 会话：host 端按完整轨迹逐步结算（每秒），子代理整树合并（仅 origin: subagent 进入父会话树，普通 fork 独立成树；每个会话只折叠自己 seedLength 之后的事件，今日/本月汇总同样排除继承 seed）；实时跳动且与本轮同源——客户端以同一份事件做整会话精确折叠（含估算），在 host 轮询（1s /live、10s /cost 缓存）未追平时取最新精确值（首轮落定瞬间 会话 = 本轮，绝不再出现 会话 ¥0.0000 滞后），host 追平后仍以快照为准；悬浮层显示分模型明细与子会话数
• 账务契约：初始模型为 unknown（绝不默认 flash）；未知 token 照常汇总、成本显示「未计价」；合法 costCny: 0 是真实答案（缺失才是无答案）；部分读取/过期时金额旁显示 过期/部分 标记；价目为带 effectiveAt 的版本化 ledger，同一请求内整树共用同一价目快照，缓存按 pricingVersion 失效
• 预算预警（可选配置，默认关闭）：config: { dailyBudgetCny: 20, monthlyBudgetCny: 100 }——花费组超 80% 变琥珀色、超支变红加 ⚠；悬浮层显示 今日 ¥x · 日预算 ¥20 (85%) / 本月 ¥y · 月预算 ¥100 (30%)（今日/本月按北京时区午夜/月初滚动，host 60s 缓存折叠全会话）；不配置即不显示
• 余额告警（两档，默认 ≤¥20 琥珀 / ≤¥5 红色）：余额组变色加 ⚠，悬浮层提示，红色档附充值链接（跳官方充值页）；config: { balanceWarnCny, balanceCriticalCny } 调整阈值，对应档设 0 关闭
• 峰谷栏：独立「峰谷」组常驻显示当前时段与下次切换（如 高峰中 · 空闲 14:00 开始），悬浮层显示详情（高峰中（价格×2） · 空闲 14:00 开始（3h 20m 后），每秒随 /live 轮询刷新）
• 实时计时：LLM/工具耗时在步骤进行中每秒跳动（工具相位以模型工具调用决策消息为起点，host 侧 fold 完整日志）；有数据时显示首 token 平均耗时与解码速率（本轮 tok/s 按 API 官方口径实时计算：分子 = 已结算 outputTokens + 进行中步骤的逐 token 流式片段数（*-chunks 事件的 texts/args 数组，实测与真实 token 数一致率 ≈99%）× 片段因子（初始 1.01，仅大步结算校准）；分母 = 已结算 decodeMs + 进行中步骤的推送域时间跨度（最后 token 事件到达时刻 − 首 token 事件到达时刻——恒定推送延迟在首尾抵消，与结算的服务器域 decodeMs 同口径，批间分母停更无空涨尾巴）——首 token 即开始实时跳动，无成熟窗口；usage chunk 到达（消息前约 3ms）即把本步真实 token 折叠进结算，结算值与显示值一致，真实日志回放实测结算跳变中位数 0.00%；切换会话回来不飙升——重挂载时的历史回放不写入墙钟锚点，回放中开始的步骤全程走服务器时域窗口（真实经过时间），速率立即等于真实平均，而非只按停留在当前页面的时间暴涨再回落）
• 空会话占位：新窗口/新聊天从第一帧起即显示完整分组——无数据时以合法零或 - 占位（0 轮 · 0 步、LLM - · 工具 -、--、缓存 0 · 命中 0.00%、输入 0 · 输出 0、本轮 ¥0.0000 · 会话 ¥0.0000），数据到达后原位替换，不再等数据出现才渲染
• 实时浮窗：悬浮面板内所有可实时值（本轮/会话金额、Tok 分组与分模型行、耗时、缓存、轮次）随事件流与 100ms 心跳实时跳动（会话运行时）；模型占比与「会话」行同源计算（分子分母取同一份合计，永不超过 100%）；子代理拼接的转写不会劫持父轮次的模型归属（估算与 usage chunk 始终落在父轮次自己的模型上）；轮次一开始即显示「1 步」；终止后本轮行保留显示
• 布局：宽度与输入框（composer）一致、不超过对话框；换行时自动删除被拆到行首/行尾的孤立分隔符；最多两行，内容按顺序排列，放不下的部分落入末尾 ⋯（latex \cdots 样式）；省略决策基于缓存的自然宽度，与渲染状态无关，不会闪烁振荡；Token 组拆为「缓存命中」「输入输出」两组
• 浮窗：label 列对齐；运行中本轮括号常驻（本轮 ¥0.0364（精确 ¥0.0364 + 估算 ¥0.0000），步间估算为 0 也不闪）；会话为单一数字（历史+本轮一起跳动，无分账括号）；峰谷行内仅 高峰中/空闲中，详情在浮窗
• i18n：界面文案跟随浏览器语言（中文 / English）
• 精度规则：计算值（本轮/会话/今日）4 位小数、外部值（余额）跟随供应商精度、配置值（预算/告警阈值）2 位小数、浮窗保留 6 位明细

安装（其他机器 / 其他端）

方式一：npm（推荐，一条命令装完）

# 1. 在 profile 目录安装包（等价于 dsh plugin --profile web add dsh-better-stats）
cd ~/.dsh/profiles/web
pnpm add dsh-better-stats

# 2. 把它登记为 bundle（让包内 cordis.patch.yml 自动注册 better-stats 行）：
#    package.json 的 dsh.profile.bundles 数组里加一行 "dsh-better-stats"

# 3. 重启 dsh web，硬刷新浏览器

包内自带 cordis.patch.yml（dsh.bundle.patch），登记为 bundle 后无需手改任何配置；默认行为 = 余额告警两档（≤¥20 琥珀 / ≤¥5 红）、无日/月预算。如需自定义，在 cordis.patch.yml 的 config 里设置（均可省略）：balanceWarnCny / balanceCriticalCny（余额两档阈值，对应档 0 关闭）、dailyBudgetCny / monthlyBudgetCny（日/月预算，配置即启用）。

方式二：GitHub 克隆

git clone https://github.com/null5069/dsh-better-stats.git
cd dsh-better-stats          # 无运行时依赖，不需要 npm install

ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-better-stats
# profile package.json 加依赖: "dsh-better-stats": "link:/绝对路径/dsh-better-stats",
# 再按方式一的第 2、3 步登记 bundle 并重启

架构

所有路由响应统一携带 pricing: { source: "official"|"builtin"|"stale", fetchedAt, tables } 与可选 budget，客户端不再硬编码价目数字。

已知边界

• 余额是整个 DeepSeek 账号的（官网聊天/其他程序/其他机器共用 key 都会扣）；统计只覆盖本工作区，且余额接口本身有结算延迟——对比时用"长窗口两端"口径
• 高峰/空闲时段按事件时间戳计价；官方调价后 host 会在 6h 内自动跟上，期间悬浮层会标注价目来源
• 工具执行期间的实时计时以"模型工具调用决策消息"为起点（tool/call 事件在工具完成后才落库），结束瞬间并入精确累计值
• 流式估算为显示级启发式：初始密度（reasoning ≈3.5、正文+工具 JSON ≈2.5、中文 ≈1 字/token）随每个已结算步骤 EMA 自适应校准，usage 落地后自动被精确值取代；估算按当前峰谷时段的输出价计价；日志中 *-delta 事件仅为抽样，完整流式文本取自 reasoning-chunks / text-chunks / tool-call-chunks 批量事件

License

MIT