前言¶

在使用 DeepSeek Harness（DSH）的 Web UI 生成长文本或长推理链时，开发者需要直观地掌握当前模型的解码速度。默认状态栏只会在一轮对话结束后显示该轮的平均速度，无法反映正在流式生成过程中的实时吞吐。

是什么¶

dsh-tokmeter 是一个 DSH 客户端插件，为 Web UI 添加一个实时解码速度指示器（tok/s），显示在对话编辑器 dock 的状态栏中。该插件由 Toximiner 维护，开源 MIT 许可证，无需构建步骤，直接通过 DSH 插件命令安装。

核心功能¶

• 在模型流式生成过程中，实时显示当前解码速度（tok/s）
• 指示器为一个小的闪电图标 pill，显示在状态栏中
• 采样间隔为 250 ms，基于字符增长估算 token 数（约 4 字符/ token）
• 使用指数移动平均平滑数值：rate = 0.7 * previous + 0.3 * (Δchars / 4) / Δt
• 生成结束后约 2.5 秒淡出
• 自动跟随 Light/Dark 主题（使用 --dsw-alias-* 主题 token）

安装与启用¶

前提条件：

• DSH 版本 ≥ 0.2.1-rc
• 已启用 Web UI bundle（@deepseek-ai/dsh-web-app）
• 聊天客户端（@deepseek-ai/dsh-client-ui-chat）已包含在当前会话配置中

安装命令（来自 README）：

# 从 git 检出或已发布的 registry 安装
dsh plugin --profile web add <your-url-or-package>

安装后，DSH 会将包链接到当前 profile，并在 package.json 的 dsh.profile.bundles 中追加 @local/dsh-tokmeter。重启 Web UI 服务即可生效；客户端模块的修改支持热重载，无需完全重启。

典型用法¶

安装完成后，打开 Web UI 并发起一个长文本或长推理链的请求，状态栏会显示类似：

[ 1 turns 33 steps · 76 tok/s ] [ ⚡ 75.9 tok/s ]   ← live, updates every stream delta

在模型生成过程中，闪电 pill 会持续更新；停止生成约 2.5 秒后自动淡出。

适用场景与注意¶

• 适合需要实时监控模型解码吞吐的开发者与调试场景
• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证
• 仅在包含聊天视图的会话中渲染；无流式生成时不可见
• 显示的是基于字符增长的估算值，与提供方侧的指标可能存在细微差异

短结尾¶

dsh-tokmeter 为 DSH Web UI 增加了一层实时解码速度的可见性，方便在流式生成过程中把握模型表现。更多细节与源码见：

• 目录页：https://www.skillhub.cn/plugins/Toximiner/dsh-tokmeter
• GitHub：https://github.com/Toximiner/dsh-tokmeter