Small-tailqwq/dsh-tps

在 DSH Web 运行状态行末尾显示实时 TPS（每秒生成 token 数）。

简体中文 | English

安装

适用于 DSH 0.2.2-alpha.3。在终端执行：

dsh plugin --profile web add 'github:Small-tailqwq/dsh-tps'

安装完成后，重启正在运行的 DSH：

dsh web

重新打开页面并发起一轮任务，开始流式输出后即可看到：

深度求索中，用时 24秒 ···  24.37

从 GitHub 安装时会自动构建插件。如果 pnpm 提示构建脚本被阻止，按提示配置 Web profile 的 allowBuilds 后重试。

安装本地包

如果拿到的是预构建 .tgz 文件，将路径替换为实际文件位置：

dsh plugin --profile web add './dsh-tps.tgz'

预构建包已包含运行时代码，不需要下载 Harness 源码或自行编译。

功能

• 实时速率：使用滚动 5 秒窗口统计流式输出，按文本与推理块的 UTF-8 字节数估算 token。
• 数字滚轮：每一位是一条 0–9 滚轮，按数值增减向上或向下滚动，跨圈（9→0、0→9）也不会瞬移。
• 自然显隐：随运行状态行出现，任务结束时一起消失；输出暂停约 1.5 秒后回到 00.00。
• 悬停淡出：鼠标停留 2 秒后淡出并允许点击穿透，移开后等待 3 秒恢复。
• 语言无关的挂载：通过语义 DOM 定位状态行，不匹配中文、英文文案或 CSS 哈希类名。
• 纯前端：读取 DSH 会话快照，无额外网络请求。平均速率、首 token 时延和总用量仍由原生统计栏提供。

插件界面

安装后，DSH 的插件管理与设置页显示标题「TPS 实时速率」、简介和图标，详情页附一张读数示意。界面语言为英文时显示 “TPS live rate”。

已安装但不显示

1. 确认任务正在运行。状态行只在运行中出现，徽标随之显示；运行中但尚无流式输出时显示 00.00。
2. 确认 TPS 已启用。如果使用 dshmarket，也需要在插件市场中启用 TPS：市场会恢复自己保存的禁用状态，仅修改 profile 配置不能覆盖它。
3. 安装或替换包后重启 DSH，再重新打开页面。
4. 确认宿主版本及当前皮肤保留聊天状态行。其他版本或改变页面结构的皮肤可能需要适配。

计数说明

TPS 按流式输出的 UTF-8 字节数估算（约每 5 字节 1 token），不等同于服务端计费用量，也不代表具体模型的精确 token 数。

估算只读取流式片段的文本与推理块，没有主线程分词开销。悬停和恢复时间目前为固定值，没有配置界面。

开发

普通安装不依赖 Harness 源码。开发时的类型检查和测试通过相邻 checkout 解析宿主接口：

<parent>/
  deepseek-harness/  # dsh-v0.2.2-alpha.3
  dsh-tps/

在本仓库执行：

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

pnpm run prepare 是 Git 安装使用的自包含构建，不读取相邻 checkout；它应与完整构建生成一致的运行时代码。pnpm run dev 可监听源码变化。

插件通过 conversation.composer.dock 获取会话上下文，再以 React Portal 挂到当前 [data-conversation-scroll] 内运行状态行 [data-chat-running] 的图标与用时行末尾。只管理插件自己的容器，不移动宿主节点。

许可

BSD-3-Clause。本插件从早期 Harness monorepo 的 packages/client/ui-tps 独立分发。