gbeta/dsh-token-speed

dsh-token-speed

DSH 客户端插件：固定在 Web GUI 右下角的可拖拽环形表盘，实时显示模型输出速度（tok/s），点击展开详情面板。

纯浏览器端插件，不修改任何宿主状态，只读订阅会话数据。

功能

- 实时速度：生成期间，表盘指针 + 中央数字随流式输出实时爬升（按输出文本量 × 实测字符/token 比率估算）。
- 每步精确校准：每一步结束后，用 provider 上报的 usage.outputTokens 和 timing（firstToken → completed）计算真实 tok/s，并据此校准字符/token 比率。
- 详情面板（点击表盘展开）：
- 实时速度（估算）
- 上一步（精确）
- 上一步输出（tokens）
- 上一步 TTFT
- 累计输出（当前加载窗口内）
- 状态指示：生成中 / 工具执行中 / 空闲。
- 可拖拽：按住表盘拖动调整位置，位置记忆在 localStorage。

安装

插件以 link: 依赖安装进 DSH profile（以 desktop profile 为例）：

// ~/.dsh/profiles/desktop/package.json
{
"dependencies": {
"dsh-token-speed": "link:/Users//Documents/DSH/dsh-token-speed"
}
}

cd ~/.dsh/profiles/desktop
pnpm install

cordis.patch.yml 里的 insert 行由 profile 的 HMR watcher 热加载；改 lib/client.js 源码后整页刷新（Cmd+R）即可生效。

卸载

从 profile 的 package.json 删除 dsh-token-speed 依赖，删除 cordis.patch.yml 里对应的 insert 行，然后 pnpm install。不留任何残留。

结构

dsh-token-speed/
├── package.json        # 插件清单（name/version/exports/dsh 配置）
├── cordis.patch.yml    # 挂载补丁（声明插件 id）
├── lib/
│   ├── index.js        # host 侧入口（no-op，插件纯浏览器端）
│   └── client.js       # 浏览器端主体：UI + 速度采样器 + 数据订阅
└── README.md

数据源（关键架构）

root 作用域的 slot 插件不能读 session snapshot（它只有 .subagent/.queue/.value，没有 .partial/.nodes），也不能用 session 作用域的 useChat/useProjection。

正确入口（与 host Chat 视图同一份数据）：

const target = ctx.uiConversation.binding(sessionId).target('chat');
target.getSnapshot();   // { legacy: { partial, nodes, runningCalls, ... } }
target.subscribe(fn);   // 返回 unsubscribe

- legacy.partial — 进行中的步骤 {turn, step, blocks}，blocks 为 {kind:'text'|'reasoning', text}，随流式增长 → 实时速度来源。
- legacy.nodes — 已结算节点；assistant 节点带 usage.outputTokens + timing{stepStartTime, firstTokenTime, completedTime} → 精确 tok/s 来源。
- legacy.runningCalls 非空 = 工具执行中。

useSessions 是全局 hook，root/session 作用域都可用，用来取当前会话 id。

依赖服务

- slots — 槽位注册（shell.overlay）
- uiConversation — 会话聊天数据（dsh-client-ui-conversation）

package.json 的 dsh.client.inject 声明到达顺序依赖：
@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-client-ui-conversation。

License

MIT