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 / deepseek-v4-flash-vision-exp 各用自己的官方价目）
• 未知模型显式标记：检测不到的模型不再静默按 flash 计价——token 照常汇总但不计价，悬浮层「模型」组显示 未计价 并在花费处注明「含 N 步未定价 · 模型未知」
• 缓存分桶：未命中输入、缓存命中、缓存写入分开计价（命中价远低于未命中价），并显示缓存命中率
• 本轮：按整轮（turn）结算——精确部分 = 当前轮已落定步骤的事件级折叠（每步按各自事件时刻/模型计价），流式部分 = 当前步的字符级估算（按当前峰谷时段计价，密度由已结算步骤自适应校准：EMA 追踪真实字符/token 比；估算 × estAccuracy 的同一个修正值同时驱动金额、Tok 与速率）；多步 turn 内数字连续增长、不随 thinking 结束重算，usage 落地自动转精确，估算只进显示不入账；一轮结束后本轮保留最终值，下一轮开始才归零
• 会话 / Agent Team 实时树：host 的 /live 每秒发布一份按 session id 与事件修订号组成的一致整树快照。主代理、直接子代理和嵌套子代理的精确用量/金额/模型会立即合入主对话框；正在输出的子代理还会同步流式输出估算、轮/步、首 token 与 tok/s，usage 到达时原位替换估算，不等待 10s /cost 缓存，也不要求浏览器持有子会话 binding。本轮 仍只表示所选会话当前轮；会话 的账务、用量和产出表示完整 agent-team 树，但 LLM/工具耗时只统计所选会话自身，避免并行子代理让时间成倍增长。仅 origin: subagent 进入父树，普通 fork 独立；每个会话只折叠自己 seedLength 后的事件，父日志中临时拼接的子代理转写不会双计
• 账务契约：初始模型为 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 轮询刷新）；周五收盘后和周末会直接倒计时到周一 09:00
• 实时计时：时间组只显示当前所选会话自身的 LLM/工具耗时；子代理即使并行运行也不会叠加到父框，所以墙钟 1 秒不会跳成数秒。所选会话内部的工具相位从模型作出工具调用决定时开始，并对并行调用分别累计。有数据时，整树的首 token 平均耗时与解码速率仍会实时更新。主代理的本轮 tok/s 继续使用完整 *-chunks 片段与自适应因子；不可见子代理由 host 发送不含正文的 token-fragment 摘要（初始因子 1.01），usage 到达即切换为精确值。异常结束会在 dispose 边界冻结 host 树内计时并清除估算，连续 5s 收不到新 /live 时也会停止旧边缘，避免永久空涨
• 空会话占位：新窗口/新聊天从第一帧起即显示完整分组——无数据时以合法零或 - 占位（0 轮 · 0 步、LLM - · 工具 -、--、缓存 0 · 命中 0.00%、输入 0 · 输出 0、本轮 ¥0.0000 · 会话 ¥0.0000），数据到达后原位替换，不再等数据出现才渲染
• 实时浮窗：悬浮面板内所有可实时值（本轮/会话金额、Tok 与分模型行、所选会话耗时、缓存、轮次）随事件流与 100ms 心跳更新；父框选择主会话时，agent-team 子代理的消费、产出、模型与活动状态同样更新，但不会叠加到 LLM/工具时间。模型占比与「会话」账务行来自同一整树快照，分子分母一致且不超过 100%；usage/final/persistence 之间按 session 修订号替换而非相加
• 布局：宽度与输入框（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 并重启

架构

| 部分 | 文件 | 说明 | |---|---|---| | host 半身 | lib/index.js | /plugins/better-stats/balance（余额+赠送/充值拆分）、/cost（10s 整树基线）、/live（每秒一致的主/子代理实时树：用量、计价、模型、计时、流式摘要与修订向量）、/today（北京时区今日/本月）；官方价目 6h 抓取同步 | | client 半身 | lib/client.js | conversation.composer.dock 槽位统计条；本轮增量计价 + 流式估算；/live 每秒轮询；预算/峰谷倒计时悬浮层；分隔符换行自适应；余额点击刷新（闪烁反馈）；可用天数估算；i18n（中/英） | | 测试 | test/client-regression.test.mjs、test/host-apply.test.mjs、test/host-fold.test.mjs、test/host-live-tree.test.mjs | 无依赖 Node 回归：账务折叠、客户端 UI、agent-team 实时树与生命周期交接 |

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

已知边界

• 余额是整个 DeepSeek 账号的（官网聊天/其他程序/其他机器共用 key 都会扣）；统计只覆盖本工作区，且余额接口本身有结算延迟——对比时用"长窗口两端"口径
• 高峰/空闲时段按事件时间戳计价；高峰仅限北京时间周一至周五 09:00-12:00 / 14:00-18:00，周末为空闲；官方对上述三个受支持模型调价后，host 会按表头列在 6h 内自动跟上，期间悬浮层会标注价目来源；其他模型仍会显式标为未计价，直至插件增加支持
• 所选会话自身的工具实时计时以“模型工具调用决策消息”为起点；其内部并行调用分别累计，最后一个 result 到达后由 open 边缘原位切换为已结算耗时；后代子代理的工具时间不加入父框
• 流式估算为显示级启发式：主会话用完整 reasoning-chunks / text-chunks / tool-call-chunks 批量事件与自适应密度；子代理用 host 可见的 token delta 片段数 × 1.01，不传正文。两者都按当前输出价估算并在 usage 落地后被精确值替换

License

MIT