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

> English: A DSH plugin that taps the model's streaming reasoning and flies configurable danmaku across the web GUI whenever it says "hmm", "wait" or "let me".

推理模型"想事情"的那几十秒里，界面上是空的 —— 你只能干等。这个插件把那段空白变成动静：
模型思维链（reasoning）里一出现 hmm / wait / let me，GUI 上就飞过一条弹幕；
连续命中还会在角上堆起一个街机风的连击计数。

效果实拍：左上角一条弹幕正在飞过（hmm… 让我再想想），右下角是连击计数 HUD（×1 / HMM）。这张是用配置卡片上的「测试弹幕」按钮触发的 —— 该按钮不需要模型参与，是插件自带的验证入口；飞过时的位置、速度、描边、抖动都按左侧那份配置生效。

它给你三样东西：

它不改变模型。 tap 挂在官方 llm/stream waterfall 上，是观察者：不改写 chunk、不吞 chunk，
自己的检测抛错也只吞自己（src/index.ts:181-207）。总开关关掉后 host 连监听都不挂，零开销。

一次命中在界面上是什么样（文字示意）

┌─ DSH Web GUI ───────────────────────────────────────────────┐
│                                                             │
│   hmm, wait — 这个报错看着不像网络问题…       ← 弹幕飞过      │
│   （触发词所在句，截断到 maxContextChars 字）                 │
│                                                             │
│                                              ┌───────────┐  │
│                                              │    ×3     │  │
│                                              │  COMBO    │  │
│                                              │   wait    │  │
│                                              │  BEST 7   │  │
│                                              └───────────┘  │
└─────────────────────────────────────────────────────────────┘

弹幕层是 shell.overlay 上的一层全屏 fixed 覆盖物（pointer-events: none），
点击穿透，不挡你操作；文字与位置全部来自设置快照，改一下立刻生效。

快速开始

前置条件（先确认这三条，再动手）：

1. dsh 已装好并能起 Web GUI（dsh 在 PATH 上）。本插件是 dsh 插件，不是独立应用。
2. Node ≥ 22.18（或 ≥ 24.11）—— 出处：package-lock.json 里构建链的 engines.node
   （tsdown@0.22.2 / rolldown-plugin-dts / dts-resolver 均为 ^22.18.0 || >=24.11.0）。
   package.json 没有 engines 字段，所以这条不会被 npm 强制拦住，只会在构建时报错。
   （本机 Node v24.12.0，npm test 实跑通过。）
3. 装完 host 半边要重挂插件才生效；只改浏览器半边时刷新页面即可。

git clone https://github.com/liceses/dsh-hmm-wait.git && cd dsh-hmm-wait
npm install && npm run build
dsh plugin --profile web add link:$(pwd)

> Windows：最后一行把 $(pwd) 换成绝对路径，例如
> dsh plugin --profile web add "link:D:\src\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。

跑起来之后你会看到：侧栏 「插件」→「已安装」→「查看 hmm-wait」，
配置卡片默认展开（defaultOpen），字段就是下面配置项一览那 25 个。

先别急着发消息 —— 点卡片底部的 「测试弹幕」：host 会广播一条模拟弹幕，弹幕层立刻飞一条。
这一步不需要模型、不需要思维链，用来确认"装上了、链路是通的"。

确认通了，再给模型发一条需要"想一想"的任务；思维链里出现触发词时，弹幕就会飞。

目录

触发词：它到底在听什么

默认三个触发词，都写在 src/schema.ts 的 DEFAULT_CONFIG.triggers 里：

> 这三条不是"关键词表"，是流式扫描：chunk 把词切成两半也认得（hm + m, let me check
> 照样命中 hmm）。回归测试 R5a/R5b 就是盯这件事的。

判定规则（四道闸，按顺序）

命中后还会重置句子缓冲，所以同一句不会弹第二次（src/detect.ts:152）。
另外每路 llm/stream 各建一个 detector 实例，句子状态不跨请求泄漏（src/index.ts:188）。

几个真实例子（都来自 scripts/run-detector-tests.mjs 的断言）：

能自己加吗？能，但只支持字面量

面板上有一行 「触发词（逗号分隔）」 输入框（src/client/panel.tsx:217-225）：

• 英文逗号 , 和中文逗号 ， 都能当分隔符，两头空白会被去掉，空项忽略（panel.tsx:54-59）；
• 支持含空格的词组（let me 就是），所以能加 hold on、等一下 这类；
• 不支持正则：每个触发词在编译前都会过 escapeRegExp（src/detect.ts:38-40），
  .* 进去就是字面的 .*。想写正则触发词得改源码 —— 见
  docs/ARCHITECTURE.md §4.1（那里写了怎么把 triggers 的语义放开成正则片段）；
• 输入框清空后点保存会回退成默认三个词（panel.tsx:143），不会变成"没有触发词"。

> 中文触发词也能用：嗯 配 sentence-start 在 好的，接下来。嗯，我想想 上正常命中（测试 R13）。

配置项一览

全部 25 个字段，默认值来自 src/schema.ts 的 DEFAULT_CONFIG，面板标签与控件范围来自
src/client/panel.tsx。配置命名空间是 dsh-hmm-wait，host 侧注册为 applies: 'live'，
所以保存即生效，不用重启。

触发与节奏

弹幕外观与动效

Combo 连击 HUD

Combo HUD 的具体表现

连击数由 host 侧状态机算（src/combo.ts），挂进程级根上下文，所以刷新页面、热重载、
重装插件都不丢；浏览器只负责画。

里程碑文案（src/client/combo.tsx:18-24）：10 热身完毕！ · 20 脑内风暴！ ·
30 CPU 燃烧中！ · 50 模型宕机边缘！ · 100 AI の 沉思极限！

> 一个要说清楚的实现细节：代码是「连击数 ≥ 某档阈值就播报，文案取已达到的最高档」，
> 不是「只在 10 的倍数播报」——combo.tsx:17 的注释与
> docs/ARCHITECTURE.md §2.3 的"×10/×20/…"都写得比实际严格。
> 行为以 milestoneText()（同文件 35-41 行）为准。

工作原理（30 秒版）

一句话：它监听模型流式输出里的 reasoning-delta 分片，扫触发词，命中就把一条事件推给所有打开的页面，页面负责画。

模型流式输出（dsh-llm 的 llm/stream waterfall）
│
│  chunk: { type: 'reasoning-delta', index, text }
▼
┌───────────────────────────────────────────────────────────────┐
│ host 半边（node 进程）                                         │
│                                                               │
│  观察者 tap ── 逐 chunk 原样透传，顺手扫 reasoning-delta        │
│       │                                                       │
│       ├─ 每路流一个 Detector（句子状态互不污染）                 │
│       │    ├─ 词边界  (?:^|[^\p{L}\p{N}])(触发词)              │
│       │    ├─ 句首判定 sentence-start / anywhere                │
│       │    ├─ 冷却    同一触发词 cooldownMs 内只弹一次           │
│       │    └─ 限流    maxPerSecond 每秒滑动窗口                 │
│       │                    │ 命中                             │
│       │                    ▼                                  │
│       ├─ Combo 状态机（挂 ctx.root，进程级，热重载不丢）          │
│       │                    │ DanmakuEvent { id, ts, trigger,   │
│       │                    │               text, combo,        │
│       │                    ▼               comboMax, sessionId}│
│       └─ SSE Hub（环形缓冲最近 50 条；新连接立即补发）            │
│                            │                                  │
│  webServer 路由：GET /api/dsh-hmm-wait/events   （SSE 订阅）     │
│                  GET /api/dsh-hmm-wait/stats    （诊断）        │
│                  POST /api/dsh-hmm-wait/test    （测试弹幕）     │
└────────────────────────────┬──────────────────────────────────┘
│ SSE: event: danmaku / ping
▼
┌───────────────────────────────────────────────────────────────┐
│ 浏览器半边（dsh Web GUI）                                      │
│  shell.overlay（全屏 fixed、点击穿透）                          │
│    ├─ 弹幕层：按 id 分轨道 → Web Animations 飞行 → 抖动          │
│    └─ Combo HUD：×N 弹跳 / 分级变色 / 里程碑 / COMBO END        │
└───────────────────────────────────────────────────────────────┘

四件事值得单独说：

• 事件源：llm/stream 是 dsh-llm 的官方 waterfall 事件，每次流式调用都会走
  ctx.waterfall(llm, 'llm/stream', options, next)，监听器签名 (options, next) => stream。
  本插件返回的是 next() 的包装流，逐 chunk yield 原样透传，检测逻辑全在 try/catch 里。
  chunk 形状只做鸭子类型判断（type === 'reasoning-delta' 且 text 是字符串），
  不 import dsh-llm 的运行时符号。
• 推送：SSE（不是 EventSource，用 fetch + ReadableStream 手解帧，兼容性更好）。
  断线 1s 重连；45s 收不到任何数据（含 30s 心跳 ping）判定半开、主动掐断重连；
  页面从后台回前台立即查一次。重连时 host 会把环形缓冲里的最近 50 条补发，
  客户端按事件 id 去重（保留最近 500 个 id），所以不会重复弹。
• 配置：host 注册 dsh-hmm-wait settings 命名空间（schemastery schema，applies: 'live'）；
  浏览器半边 ctx.settingsScope.bind({ namespace }) 订阅，把快照镜像进模块 store，
  弹幕层与 HUD 通过 useSyncExternalStore 消费。弹幕订阅与配置镜像解耦 ——
  配置链路卡住也不会导致"页面活着但弹幕全无"。
• 连击在 host 算：DanmakuEvent 自带 combo / comboMax，浏览器纯渲染。
  所以连击状态跨刷新、跨重连、跨插件热重载都在。

文件地图

它长在哪（座位表）

排障

面板里找不到 Hmm-Wait 卡片

host 没装配上这一行。查两处：

dsh plugin --profile web ls          # 确认 hmm-wait 行存在

以及 cordis.patch.yml 是否被当作 profile bundle 层应用（它通过 package.json 的
dsh.bundle.patch 字段生效）。装完 host 半边必须重挂插件，只刷新页面没用。

测试弹幕正常，但真实对话里一条弹幕都没有

测试弹幕走的是 POST 路由，绕过了检测器 —— 它只证明"SSE 链路通"。真实弹幕不出现，按顺序查：

1. 模型有没有吐 reasoning？ 非推理模型（或关闭了思考）根本没有 reasoning-delta chunk，
   检测器拿不到输入。换个会输出思维链的模型试。
2. 触发词是不是在句首？ 默认 sentence-start 只认句首/段首。
   临时把「匹配位置」改成 anywhere 验证一下。
3. 冷却与限流是不是压住了？ cooldownMs 默认 5000、maxPerSecond 默认 3。
4. 触发词是不是被词边界挡了？ await 不会命中 wait。

连测试弹幕都不出现

SSE 订阅失败。打开浏览器 DevTools → Network，看 events 请求：

curl http://127.0.0.1:19387/api/dsh-hmm-wait/stats
# {"ok":true,"subscribers":1,"connections":[…],"events":N,"ts":…}

subscribers 是 0 → 页面的 SSE 没连上（路由没注册，或代理吞了流式响应）。
events 一直是 0 → host 根本没广播（tap 没装上，或 enabled 是关的）。

改了配置没反应

• 卡片是编辑先暂存的：改完必须点 「保存」（顶部会出现「未保存」徽章）。
  点「丢弃」会还原。
• 确认 host 侧 ctx.settings.register 成功（同一命名空间重复注册会报错）。
• 浏览器半边只刷新页面即可；host 半边改动要重挂插件。

和别的插件（比如重试类）一起用会不会打架

不会。tap 是观察者，多个监听器可以叠加；重试会重新触发流，冷却机制兜底。

已知限制

• 只对"会输出思维链的模型"有意义。 非推理模型、或把 thinking 关掉的会话里，
  reasoning-delta 不存在，本插件就只是"装了个安静的面板"。
• 只认字面量触发词。 正则触发词要改源码（src/detect.ts 的 escapeRegExp），
  面板做不到。
• 只监听 reasoning-delta。 最终回答正文里的 hmm 不会触发 —— 这是设计：
  弹幕的意义是"模型正在想"，正文阶段已经想完了。想加别的源（比如工具调用开始）见
  docs/ARCHITECTURE.md §4.3。
• package.json 没有 engines 字段。 所以 Node 版本要求只写在文档里，
  npm 不会拦住低版本 Node；真正的约束来自构建链（见快速开始）。
• peer 范围是 ^0.1.0-rc.7（= >=0.1.0-rc.7 且 <0.2.0）。0.1.x 内升级不用管；
  跨到 0.2 时 npm 会提示 peer 不匹配 —— 但插件运行时的依赖全部从宿主解析，
  不会因此装出第二份实例。
• Electron / file:// 形态下 SSE 是否可用取决于 client-connection 桥
  （docs/ARCHITECTURE.md §6 的仓库自述）。桥不支持流式时，
  功能静默降级：面板与配置照常，只是没有弹幕。
• 音效可能被浏览器自动播放策略拦掉。 Web Audio 需要用户交互过（sticky activation）才能
  resume()；被拦时静默跳过，不影响其他功能。
• 弹幕文本是思维链原文的片段。 它会在屏幕上显示模型思考时的那句话
  （截断到 maxContextChars）。介意的话把「弹幕文本」改成 仅触发词。
• 动画依赖 Web Animations API（element.animate），极老的浏览器内核不支持。

开发

npm run typecheck   # tsc --noEmit（strict）
npm test            # 检测器回归测试（18 条断言，R1–R15）
npm run build       # tsc 出 d.ts + tsdown 出双 bundle（lib/index.js + lib/client.js）
npm pack            # 产出可分发 tgz（files: lib/ + src/ + cordis.patch.yml）
bash scripts/build.sh   # 等价入口（typecheck + build）

测试怎么跑起来的：scripts/run-detector-tests.mjs 直接 import '../src/detect.ts'，
不预先编译（靠 Node 的原生类型剥离），所以改完 detect.ts 立刻 npm test 就能看到结果。
断言覆盖：边界在触发词之后、句中不命中、句首/换行/引号句首、流式拆词、中文句子后的英文句首、
anywhere 模式、await 不误命中、同句双词只弹一次、冷却、限流、中文触发词、超长流防膨胀、缩进段首。

三个扩展点（细节见 docs/ARCHITECTURE.md §4）：

浏览器半边的纪律：src/client/** 不能 import schema-def.ts（会把 schemastery 打进
浏览器 bundle）。配置类型与默认值从 schema.ts 拿，schema 本体留在 host 侧。

热重载边界：SSE hub 与 combo 状态机挂在 ctx.root 上（APP_HUB_KEY / APP_COMBO_KEY），
所以插件重装时已订阅的页面不会断、连击也不会归零；路由与样式跟随 fiber 的 ctx.effect 拆除。
docs/ARCHITECTURE.md §2.3 有卸载命令。

验证记录

本文档里所有字段默认值、枚举取值、面板范围、判定规则逐条对着源码写的，
出处标在每张表旁边；命令全部来自仓库文件（package.json scripts、cordis.patch.yml 注释、
docs/ARCHITECTURE.md、scripts/build.sh）。

许可

BSD-3-Clause —— 声明见 package.json 的 license 字段。

> 仓库根目录没有 LICENSE 文件（GitHub 因此识别不到许可证，licenseInfo 为 null）。
> 要不要补一个 LICENSE 文件、版权署名怎么写，得仓库主人定 —— 本次改写没有代加。

相关

• docs/ARCHITECTURE.md —— 开发文档（包结构 / 运行架构 / 装配 / 扩展 / 排障）
• docs/dsh-0.1.6a2-plugin-config-panel-migration.md —— 0.1.6a2 插件配置面板迁移记录