dsh-simple-tps
在 DSH 网页聊天操作栏中、内置用量标签旁显示每轮 TTFT / TPS 读数。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:flyxiu/dsh-simple-tps#73388535ce6dd6e46ed04bece811e002a53841f5Simple Tps 以 dsh-simple-tps 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 网页版的每轮回答下方显示该轮的首 token 延迟与输出速度。读数位于分支按钮之后、自带用量胶囊之前，点击展开明细弹窗。
点击读数展开明细：
插件由宿主与前端两部分组成。宿主持有一个会话投影，在完整事件日志上折叠出每轮指标；前端负责读取与呈现。
一轮对话可能包含多个助手步骤，工具调用会把一轮拆成若干次模型请求。因此：
任一项取不到就省略该项，全部取不到则整条不渲染。
浏览器侧的会话快照只覆盖当前已加载的窗口，且首 token 时刻依赖 assistant/live-chunk 事件。该事件仅存在于实时流中，不写入持久日志。
持久日志里首 token 时刻另有来源。每条 assistant/message 携带 data.stream，其中的文本、推理与工具调用增量以「基准时刻 time0 加逐 token 间隔 dt[]」的形式压缩存放：整块 chunk 自带时间戳，成串的增量则只记录首项时刻与逐项间隔，靠累加还原。重放这份记录即可得到任意 token 的出现时刻，包括第一个。这一做法与 DSH 自带的 sessionStats 投影使用同一套事件语义，两者对首 token 的判定规则也一致。
投影因此能够覆盖完整日志，分页与压缩都不影响结果；刷新页面后历史轮次依然精确，不会退化为估算值。
前端保留窗口折叠作为兜底：投影不可用时退回读取节点的 timing 字段，速度改按整步时长计算，显示为 ≈45.0 tok/s 并标注为下界。
DSH 版本不低于 0.2.1-rc.2。宿主侧依赖 sessionProjections 服务，投影未注册时插件自身不激活。
插件未发布到 npm，需要按 GitHub 仓库安装。
网页端和桌面客户端自带插件管理，在「设置 → 内置插件 → 添加插件」里填入仓库地址即可。
https://github.com/flyxiu/dsh-simple-tps
命令行等价，add 之后的参数原样转给 pnpm：
dsh plugin --profile web add https://github.com/flyxiu/dsh-simple-tps
github:flyxiu/dsh-simple-tps 是 pnpm 针对 GitHub 简写的同义写法，两种写法装出来一样。
本地目录方式用于开发调试，改完代码不必推送即可生效：
dsh plugin --profile web add link:/path/to/dsh-simple-tps
区别在更新：仓库源会在插件市场显示更新按钮，link: 本地链接被排除在在线更新之外。
插件市场比对仓库 HEAD 与用户 lockfile 中的 commit 判断是否有更新，因此在插件市场点击更新即可升级，不需要重新安装。link: 方式安装的副本不参与该检查。
lib/client.js 是手写的模块加载器格式，无构建步骤：
window.__ModuleLoader__.load({ id: 'dsh-simple-tps', factory: (require) => { ... } })
id 必须与包名一致。require 只能取平台模块表内的包，目前用到 react、react-dom 与 @deepseek-ai/dsh-client-ui-primitives；三者缺失时降级为纯文本显示，不阻断加载。
修改后的生效方式取决于改动位置：
dsh-restart # 改动 lib/index.js（宿主投影）
# Ctrl+F5 # 改动 lib/client.js（前端）
没有热更新。客户端的 HMR 只在从源码 checkout 运行 pnpm run dev:web 时重建 bundle。
宿主与前端各自独立生效，改动其中一侧不影响另一侧。
两套离线测试，不依赖运行中的 DSH：
node tests/run.mjs # 前端：注册、折叠、投影优先、窄屏降级、数字格式化
node tests/host.mjs # 宿主：流还原、多步折叠、真实日志比对
tests/host.mjs 在本机存在真实会话日志时会跑完整折叠，断言绝大多数轮次都能取到精确 TTFT。
用真实事件载荷验证，比构造假数据更能反映字段实情。
读数通过 conversation.chat.assistant-actions 列表插槽注册。
该插槽在 DOM 上只能落在复制按钮之后、分支按钮之前，落不到用量与时间之间。那一格由 MessageIconActions 内联渲染，没有对外插槽。
视觉位置由 CSS order 调整。这里必须使用后代选择器而非子选择器：
[data-clock=end] .dsh-simple-tps-root { margin-right: -8px; order: 5 }
[data-clock=end] > :last-child { order: 10 }
插槽会在动作行与读数之间插入一层 display: contents 的容器，读数因此是孙节点，子选择器无法命中。display: contents 的元素不生成盒子，但不影响选择器匹配，后代选择器可以穿过它；这也是最初把位置改错的原因，写成 > 时规则始终不生效。
-8px 抵消用量组自带的左边距。
交互沿用自带用量胶囊的形态：默认只显示速度，点击展开明细。弹窗复用 useAnchoredPosition 与 useDismissOnOutsidePointer 两个原语，配色取自 --dsw-specific-menu、--dsw-elevation-prominent 等语义令牌，与自带的「本轮用量」弹窗同一套视觉。
位于动作行内，历史轮次上的读数与用量胶囊一样需要悬停才淡入。
会话运行期间，当前流式输出的速度以「字/s」显示在「深度求索中」之后。该项独立于每轮读数，随回合结束消失。
客户端只能观察到增量文本，拿不到 token 计数——token 数要等整轮结束才随 usage 返回。实时项因此以字符数计速并标注单位为「字/s」，每轮读数仍为精确的 token 口径。
采样窗口取最近 1.2 秒。
输出停顿或计算条件不足时保留上一次读数，避免跳变。
dsh plugin --profile web remove dsh-simple-tps
dsh-restart
MIT