English

# 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](https://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（推荐，一条命令装完） ```bash # 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 克隆 ```bash 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