dsh-hmm-wait — 思维链弹幕插件

当模型思维链（reasoning / thinking）里出现 hmm、wait、let me 等"犹豫词"时， 在 dsh Web GUI 上弹出可配置的弹幕动画：流动方向、速度、抖动提醒、颜色、区域等全部可调， 并集成 dsh 官方设置面板（开关 + 全部参数）。

结构说明见 docs/ARCHITECTURE.md。

---

功能特性

• 🎯 实时监听思维链：通过 dsh 官方 llm/stream waterfall 事件拦截流式推理输出（reasoning-delta）， 触发词一出现立即弹幕，无需等整条消息完成。
• 💬 弹幕动画：四种流动方向（右→左 / 左→右 / 上→下 / 下→上）、可调速（px/s）、 顶部/底部/全屏区域、多轨道防重叠。
• 📳 抖动提醒：弹幕出现瞬间附带可配置幅度的抖动动画，一眼注意到模型"卡壳"。
• ⚙️ 官方配置面板：设置 → 插件 → 可配置，开箱即用；所有修改 live 生效，无需重启。
• 🔌 无强版本依赖：运行时只依赖公开契约（事件名 + chunk 形状），SDK 均以宽松 peer 范围声明， 宿主 dsh 升级不影响本插件。
• 🧪 测试弹幕：面板一键发送模拟弹幕，端到端验证链路（不依赖真实思维链内容）。
• 🎮 Combo 连击 HUD：命中触发词 = 一击！连续命中累积连击数（游戏街机风：数字弹跳、分级变色、里程碑全屏播报、连击中断动画、最高纪录），位置可配置；连击状态在 host 计算（挂进程级），刷新/重连不丢。

快速开始（安装）

前置：dsh 已安装并启动（Web GUI 模式）。

# 1. 克隆仓库（或下载 GitHub Release 里的 dsh-hmm-wait-0.1.0.tgz）
git clone https://github.com/liceses/dsh-hmm-wait.git
cd dsh-hmm-wait

# 2. 构建（需要 node ≥ 20 与 npm）
npm install
npm run build

# 3. 装进 dsh 的 web profile（junction link，随 profile 重启自动装配）
dsh plugin --profile web add link:$(pwd)

# 4. 重启 dsh 或在设置页 → 插件 → 可配置 中找到 Hmm-Wait 卡片

从 Release 直接安装 tgz：dsh plugin --profile web add ./dsh-hmm-wait-0.1.0.tgz（file: 依赖）。

详细装配说明（bundle patch / dsh.client 声明 / 如何卸载）见 docs/ARCHITECTURE.md。

使用

1. 打开 设置 → 插件 → 可配置，找到 Hmm-Wait 思维链弹幕 卡片（官方折叠卡片风格：点标题栏展开字段表单；编辑先暂存，点"保存"生效，或"丢弃"还原）。
2. 开关：已启用 / 已停用（关闭后 host 完全停止监听，零开销）。
3. 点 测试弹幕 立即验证显示效果。
4. 正常使用：给模型发一条需要"想一想"的任务，思考链里出现 hmm / wait / let me 时弹幕飞过。

配置项一览

配置	默认	说明
开关 enabled	true	总开关（host 监听 + 弹幕层）
触发词 triggers	hmm, wait, let me	逗号分隔，正则自动转义
匹配位置 match	sentence-start	句子/段首（推荐）或任意位置
大小写敏感 caseSensitive	false	对英文触发词有效
冷却 cooldownMs	5000	同一触发词防重复弹幕
限流 maxPerSecond	3	全局限流
方向 direction	right-to-left	四种流动方向
速度 speed	120	px/s
区域 zone	top	顶部 / 底部 / 全屏
字号 fontSize	18	px
颜色 color	#ffd866	CSS 颜色
透明度 opacity	0.92	0.05–1
抖动 shake / shakeIntensity	on / 4px	出现时抖动提醒
同屏上限 maxOnScreen	12	超出挤掉最旧
弹幕文本 showContext / maxContextChars	所在句 / 80	或仅触发词
字体 fontFamily	风格化默认	CSS font-family；留空使用默认（Arial Black/Impact 粗体 + 黑描边）
框阴影 shadow	on	弹幕背景框阴影开关
连击 HUD comboEnabled	on	Combo 连击计数（街机风）
连击窗口 comboWindowMs	6000	两次命中间隔超过则中断连击
HUD 位置 comboPosition	右下	右下/左下/右上/左上
里程碑播报 comboMilestones	on	×10/×20/… 全屏提示

工作原理（30 秒版）

模型流式输出 (llm/stream)
        │
        ▼
host 插件 tap ── 扫描 reasoning-delta 文本 ── 命中 hmm/wait/let me
        │                                                 │
        │                                    检测器（句子边界/冷却/限流）
        │                                                 ▼
        │                                    combo 状态机（进程级，连击递增）
        ▼                                                 ▼
  SSE: /api/dsh-hmm-wait/events ◄─────── 广播 DanmakuEvent（含 combo）
        │
        ▼
浏览器：弹幕层（飞行+抖动） + Combo HUD（弹跳/变色/里程碑/中断动画）

• 事件源：llm/stream（dsh-llm 官方 waterfall 事件），监听器是"观察者"：不改写、不吞 chunk，检测异常也不影响模型流。
• 配置：host 注册 dsh-hmm-wait settings 命名空间；client 把快照镜像到页面，live 生效。
• 推送：SSE（GET /api/dsh-hmm-wait/events），断线自动 1s 重连 + 半开看门狗 + 重连补发最近 50 条；另有一个 POST /api/dsh-hmm-wait/test 用于测试。
• 连击：host 侧 combo 状态机（挂进程级根上下文，热重载不丢），每个事件携带 combo/comboMax，浏览器只负责渲染。

无强版本依赖

• peerDependencies 全部是宿主已有包（cordis / schemastery / dsh-settings / dsh-host-webserver / dsh-client-runtime / dsh-client-ui-slots / react），不打包、不锁定 dsh 版本。
• 运行时只依赖两个字符串契约：事件名 llm/stream 与 chunk 的 reasoning-delta 形状（均为 dsh-llm 公开流协议）。
• dsh 升级后，本插件无需重装；如宿主 API 变更导致契约失效，插件只"安静失效"（不拖垮会话），且设置面板与测试弹幕仍可用。

开发与扩展

完整开发文档：docs/ARCHITECTURE.md（含目录结构、构建、发布、扩展指南：加触发词算法、改弹幕动效、加新事件源等）。

npm run typecheck   # 类型检查
npm test            # 检测器回归测试（16 用例）
npm run build       # 构建 lib/（host ESM + client CJS bundle）
npm pack            # 产出可分发 tgz

许可证

BSD-3-Clause