dsh-pref-kit

DSH 性能插件：在数据流源头合并模型流式输出的相邻文本增量，减少会话事件量，
缓解长会话与多 agent 并发下的卡顿与资源占用。不改任何接口与协议。

功能

• 流式合并（默认开启）：把同一文本块内的相邻 text/reasoning 增量合并后再写入
  会话日志与推送，事件量下降 11–56%（短回复 −45.6%、长回复 −53.5%、6 并发 −55.6%，
  复杂长会话 −11%），内存 / 磁盘 / 带宽同步下降；windowMs = 0 即完全透传，
  与未装插件逐事件等价。
• 设置卡片：Settings → Plugins 提供配置卡片（与内置卡片同款样式），修改保存后
  即时生效、跨重启保留。
• 实验开关（默认全关）：
  • 替换轨迹视图：用轻量轨迹页接管官方轨迹入口（需先禁用官方 ui-trajectory 行），
    消除轨迹页在流式期间的每帧全量重算（基准模型实测 ×239–×184.9k 工作降幅）；
  • 聊天区渲染提示：让浏览器跳过视口外消息的绘制（画面不变）；
  • 运行时行管理：按白名单禁用/启用官方插件行（如遥测、token 统计），即时生效并持久化。

安装

cd dsh-pref-kit
npm run build                                       # 构建
dsh plugin --profile web add "file:$(pwd)"          # 装入目标 profile（自动挂载插件行）
# 重启 DSH 生效（启动日志出现 [dsh-pref-kit] llm/stream coalescer active）

更新：npm run build 后先 dsh plugin --profile web remove dsh-pref-kit 再 add。
卸载：dsh plugin --profile web remove dsh-pref-kit。

配置

配置项	默认	说明
windowMs	30 ms	合并窗口（0–200ms）；0 = 关闭合并（逐 token 透传）。窗口越大事件削减越多，首个字延迟 ≈ 窗口

实验项（Settings → Plugins → dsh-pref-kit 卡片 → 实验组）：

配置项	默认	说明
experimental.replaceTrajectoryView	false	替换轨迹视图；需同时把 ui-trajectory 加入下方行管理的禁用列表（或手工禁用该行）
experimental.chatContainment	false	聊天区渲染提示（画面不变，浏览器少画视口外内容）
experimental.rowManager.enabled / disabledRows	false / []	运行时禁用官方行（白名单：ui-trajectory、session-telemetry-otel、token-meter、session-stats、session-projection-cache、session-query-sqlite）；Host 即时生效并持久化，客户端需刷新页面

基准测试

离线可复现（固定种子 + 虚拟时钟，不连接 DSH；含逐块协议等价断言与复杂长会话生成器，
任何人可逐位复现）：

场景	事件数（基线 → 合并 30ms）	首块延迟
短回复	810 → 441（−45.6%）	16 → 40ms
长回复	9674 → 4501（−53.5%）	20 → 28ms
复杂长会话（生成器）	12210 → 10869（−11.0%）	30 → 60ms
6 并发 agent	35592 → 15788（−55.6%）	18 → 50ms

运行：npm run benchmark。详细分析与实验性策略消融见性能分析报告。

许可证

MIT