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。

配置

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

基准测试

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

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

许可证

MIT