@captain1275/dsh-live-stats

English | 中文

DSH Web 的实时输入/输出 token 估算与生成吞吐显示。它供给内置的会话状态行：响应流式输出时实时更新输入/输出 token 总量，生成吞吐组（TPS 31.4 tok/s）渲染在步骤计数之后、计费组之前：

1 turns · 3 steps TPS 31.4 tok/s Input ~7.9K tok · Output ~12 tok

~ 表示启发式估算。当 provider 用量到达时，估算值会被真实用量替换；精确的缓存统计始终来自 DSH 的持久化 token 用量投影。重试会替换该步骤先前的估算，被中止的回合会移除其未结算的估算。

功能

• 宿主侧：注册可重放的 liveTokenUsage 会话投影（ctx.sessionProjections）。该折叠从表面日志加上 header/工具框架估算输入 token，从流式 chunk 估算输出 token，并在 usage chunk 或最终消息落地后立即用 provider 用量替换估算。TPS 由活跃步骤的输出 token 除以墙钟耗时得出，且速率是常驻的：一旦某个步骤测得速率，投影就会持续上报（新步骤尚未产生输出或遇到无速率步骤时回退到最近一次测得值），状态行不会闪烁消失。
• 客户端：仅为 roster 兼容保留。TPS 组渲染在会话统计行内部——ui-conversation 直接读取 liveTokenUsage 投影——因此客户端不再挂载任何内容。

安装

推荐直接安装全家桶聚合包 @captain1275/dsh-web-ui-all（一个包装齐全部功能插件与皮肤），或单独安装本插件：

# 推荐：直接从 npm 安装
dsh plugin --profile web add @captain1275/dsh-live-stats

# 或从仓库安装（开发调试）
git clone https://github.com/zhu1090093659/dsh-web-ui.git
cd dsh-web-ui
pnpm install && pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-live-stats

安装后重启 dsh web，会话状态行出现 TPS 组。

另一种方式：作为普通 overlay 行加入个人 DSH overlay（~/.dsh/config.yaml），保存即热加载：

- insert:
    - id: live-stats
      name: '@captain1275/dsh-live-stats'
      config:
        charsPerToken: 4
        blockOverhead: 4
        roleOverhead: 4

三个估算参数均可选（默认值如上）。

配置

键	类型	默认值	含义
charsPerToken	number	4	一个 token 大致对应的文本字符数
blockOverhead	number	4	每个内容块分配的固定框架 token 数