会话遥测胶囊 ags-neto/dsh-status-telemetry

status-telemetry — 为 DSH composer dock 提供丰富的会话状态

DSH 客户端插件包，向 conversation.composer.dock 插槽贡献一个会话状态胶囊。它紧挨内置的聊天统计入口，就地展开为完整的遥测面板。

它不替换任何东西：随包发布的 stats 入口保留自己的 id，继续渲染。禁用这个包会精确还原之前的 UI。

显示什么

折叠态 —— 一行，沿用宿主自己的字体与配色语言：

◔ ● 12 turns · 41 steps · 634k tok · 84% cached · 150 tok/s

字形圆点是实时健康读数，由解码速度推导（ok / warn / bad）。

展开态 —— 四个分区：

| 分区 | 读数 |
| Conversation | 轮次、步数、吞吐、输出 token |
| Token usage | 总量、计费输入、未缓存输入、缓存输入、缓存写入、缓存命中占比 |
| Performance | LLM 耗时、工具耗时、平均首 token、解码速度、工具占工作比重 |
| Context | 占用率（占公布窗口的比例）、窗口大小、预计提示词、实际上报提示词，外加 system / tools / messages 的构成条 |

每个读数都推导自宿主计算好的投影 —— 不做客户端日志折叠，不轮询，不调用模型。当前配置档缺少某项能力时，面板会直接说明，而不是渲染一个误导性的零。

数据来源

| 投影 | 归属包 | 用途 |
| sessionStats | @deepseek-ai/dsh-session-stats | 轮次、步数、LLM/工具/TTFT/解码墙钟时间 |
| tokenUsage | @deepseek-ai/dsh-token-meter | 未缓存/缓存/缓存写入输入、输出 |
| contextPressure | @deepseek-ai/dsh-token-meter | 占用率、窗口、预计与实际上报提示词 |
| contextBreakdown | @deepseek-ai/dsh-token-meter | system / tools / messages 构成 |

所有数据都通过插槽框架的标准会话套件（useProjection）和 locale 服务抵达组件。这个包从浏览器模块表里只导入一个模块：react。

目录结构

| 文件 | 用途 |
| package.json | 包清单：dsh.bundle.patch 加 dsh.client（platform: web） |
| cordis.patch.yml | 插入 status-telemetry 的 Loader 行 |
| index.js | 宿主侧；可挂载，不贡献任何宿主行为 |
| client.js | 浏览器侧：ModuleLoader 工厂、组件、样式、locale |
| test/client.test.mjs | 离线测试套件：格式化器、渲染输出、注册契约 |
| install.sh | 配置档的 root 安装 / 卸载 |

安装

插件装进 DSH 配置档，不是装进 /opt/dsh。在这台主机上 / 以只读方式挂载，所以安装需要一次 root：

sudo /srv/workspaces/infra/status-telemetry/install.sh

脚本把 / 重新挂载为读写，把包复制到 $DSH_PROFILE_DIR/node_modules/@local/dsh-status-telemetry，把包追加到 dsh.profile.bundles，恢复属主，再重新挂载为只读。它幂等，--uninstall 会移除它加过的所有东西，逐字节还原配置档的 package.json。

只会改动 bundle 列表。 配置档由它的 bundle 加上自己的 cordis.patch.yml 组合而成，列出一个 bundle 就会应用该 bundle 的 dsh.bundle.patch——所以这个包的 cordis.patch.yml 提供了 status-telemetry 的 Loader 行。如果再把这一行也加到配置档补丁里，插件会被加载两次，而第二次以相同 id 和 priority 注册槽位就会抛错。

然后硬刷新页面。配置档监听器会实时重新组合；dsh-client-hmr 会在约 500 ms 内重新提供编辑过的 client.js。只有当这一行没有出现时才需要重启：

sudo systemctl restart dsh.service # rotates the web token; re-fetch on 401

测试

cd /srv/workspaces/infra/status-telemetry
node --test test/client.test.mjs

这台主机的 Node 侧没有 React（浏览器从启动模块表里解析它），所以测试套件通过一个小的 React 替身来跑组件，这个替身模拟钩子分发和元素创建；唯一一处对真实 React 的交叉校验在 React 不可用时会自行跳过。测试套件无法验证实时 GUI 里的视觉效果。

设计说明

- 独立条目，而非影子。 conversation.composer.dock 是 list 槽位，id 唯一：以相同 priority 第二次注册会抛错，而复用 id: "stats" 则需要 priority: -1 做影子覆盖。新增一个 id 可以保持内置条目不变，并且只要禁用一行就能让改动可逆。
- 样式随组件走。 样式表作为 元素渲染在条目内部，所以卸载时它会被移除，模块工厂也保持无副作用。
- 只用主题 token。 每个颜色、圆角和阴影都来自 --dsw-* token，所以面板会跟随浅色/深色切换以及未来的主题变化。
- 不导入 Harness 包。 只依赖 react；条目通过 props 读取数据，并渲染自己的控件。