dsh-typewriter-blip
助手回答流式输出时播放语音提示音——即使窗口在后台也能听到——支持更换语音和自定义语音。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:nsswkj/dsh-typewriter-blip#66b7286c45197ce5be1c967fa77f4713e26968bcTypewriter Blip 以 dsh-typewriter-blip 发布，当前版本为 1.1.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
模型回答时逐字发出音效，音色可换，也可以自己调。 进入对话时不发声，模型说完立刻停；窗口最小化、被挡住、或者切到别的标签页时照常发声。
插件市场（dshmarket）里搜说话音效，点一下安装；或者直接装 npm 包：
dsh plugin --profile desktop add dsh-typewriter-blip
也可以从仓库装源码（内容和 npm 包一致）：
dsh plugin --profile desktop add github:nsswkj/dsh-typewriter-blip
装完刷新一次 Harness 页面即可，无需重启。
desktop），刷新一次 Harness 页面。| 控件 | 作用 |
|---|---|
| 启用 | 总开关（关闭后不再发声，也不排队） |
| 音色 | 柔和（三角波，默认）/ 打字机（锯齿 + 噪声瞬态）/ 自定义 |
| 自定义音色 | 两种来源：合成音色（波形 方波/三角/锯齿/正弦 + 基频 + 音长 + 亮度）或音频文件（本地 audio/*，可调播放速度，每个字最多播 0.6 秒）。动这里的任何一项会自动切到「自定义」 |
| 音高 / 音量 | ±12 半音升降调；0–100% 音量 |
| 最小间隔 | 两个音之间的最小毫秒数；流式输出很快时用它控制密度 |
| 说完即停 | 最后一个字之后多久掐掉还响着的音（默认 140 ms，且不会短于一次唤醒的间隔）。还没播的队列不会整段丢掉：前台最多 6 个字、不到三分之一秒就播完；后台按下面「后台也要发声」的规则只留最后 0.3 秒 |
| 跳过空格 | 空格、换行不发声 |
| 只对回答发声 | 只对助手回答的文字发声；工具调用、思考过程（reasoning）和你的消息都不响。默认开 |
| 随机音高 | 每个音随机偏移的半音数，让声音更自然。滑条到 2，右边的输入框可以直接填到 24；自定义音频也生效——音频文件没法改音高，插件用同一份半音偏移换算成播放速度（重采样），所以调高时那个音也会短一点 |
| 随机音量 | 每个音随机改变多少音量，滑条到 ±50%，输入框可以直接填到 ±100%。随机量加在每个音自己的增益上，不动总音量开关 |
| 试听 | 连播几个字试听当前音色。一次只能听一遍：按下后按钮变灰显示「试听中…」，最后一个字播完才解锁，中途再点无效 |
| 恢复默认 | 回到出厂设置 |
设置即时生效并自动保存（localStorage，键 dsh:typewriter-blip:v1）。
按钮上只有 ♪ 说话音效 两个元素，不再显示发声计数。
「随机音高」和「随机音量」右边的数值框可以直接输入，超过滑条上限也照收（上限是
settings.js 里的 JITTER_MAX / VOLUME_JITTER_MAX）；输入即生效，还解析不出数字的
半截文本（空框、只有一个 -）不会被写进设置。
面板开在按钮上方（输入框贴着窗口底边，下方没有地方放），并且高度只取按钮上方
到窗口顶边之间的空间，内容多就在面板里滚动；只有按钮靠近窗口顶部、上方确实放不下时
才会翻到下方。出现时用 ease-out 缓动淡入（180 ms，从按钮那一侧滑进来），关闭时先播
完 140 ms 的淡出再从 DOM 里移除，prefers-reduced-motion 下两个动画都会关掉。
用户要的是"说话"的感觉，而浏览器里只有一个越来越长的 DOM，所以下面三件事必须分开：
反向的两个规则让声音跟得上说话：
cut() 掉所有
已排程的音——否则队列里剩下的字会继续说，用户听到的就是"说完了还在响"。队列本身
不丢，只裁到还剩最后 0.3 秒（PLAYOUT_MS）：前台队列最多 6 个字（MAX_PENDING），
按「最小间隔」算不到三分之一秒就播完，所以一个字都不会少；以前一次性丢掉整个队列，
才是"换完音效第一句断断续续、只响了一半"的根因。lead 放宽）。队列长了不会让声音更丰富，只会让声音落后文本一两秒——而这份落后迟早
会被整段丢掉。data-chat-flow-kind 必须是 assistant-step，且 data-chat-group-part
不是 reasoning；代码块、JSON 块、按钮、时间戳等 UI 部分一律不计入。最小化、被别的窗口盖住、或者切到别的标签页时，浏览器会停止产生动画帧（requestAnimationFrame
一次都不再触发），并把定时器压到大约一秒一次。排程原来完全挂在动画帧上，所以窗口一进后台就彻底
没声了。现在：
lead（提前排到音频时钟上的秒数），队列容量
也由它决定——前台的 lead 是 0.02 秒（⇒ 6 个字），后台是 1.25 秒（⇒ 30 个字，上限 MAX_QUEUE 48）。
音频时钟不受页面可见性影响，所以只要声音已经排在它上面，就一定响得出来。PLAYOUT_MS）再播完。前台队列本来
就短于 0.3 秒，所以「换完音效第一句断断续续」那个 bug 不会因为这次改动回来；掐音的窗口也不会短于
一次唤醒的间隔——一秒宽的时钟判断不了 140 毫秒的安静，否则 chunk 之间的每个停顿都会被当成"说完了"，
把刚填好的缓冲整段掐掉。内置音色由 src/voices.js 的 PRESETS 决定波形、基频、时长、滤波与按字符类别的移调：
柔和 是三角波、打字机 是锯齿加一段高通噪声瞬态。
"自定义"音色由设置里的 custom 字段决定（CUSTOM_DEFAULTS 是出厂值）：
source: "synth" 时用 wave/freq/duration/filter 合成，source: "sample" 时播放用户载入的音频。
要加一个内置音色：在 PRESETS 里加一条，再把 id 加进 PRESET_ORDER（PRESET_ORDER[0] 就是新装
默认音色）；删掉一个音色不用管旧设置，normalizeSettings 会把认不出来的 id 收回默认值。
package.json 清单：dsh.bundle.patch + dsh.client（web）
cordis.patch.yml 插入 id 为 typewriter-blip 的 Loader 行
index.js Host 半：空实现（功能全在页面里）
src/settings.js 设置与 localStorage 持久化（含自定义音色）
src/voices.js 音色预设表 + 自定义音色的出厂值与波形表
src/audio.js Web Audio 合成、采样播放、cut()
src/observer.js 回答文字 → 字符增量 → 排程发声 → 说完即停（音频时钟 + 自适应唤醒间隔）
src/client.js 输入框上方的按钮与面板（React）
build.mjs 把 src/ 拼成单文件 client.js
client.js 生成产物（浏览器模块图每个包只加载一个 ./client）
test.mjs 离线测试台
LICENSE MIT
页面里的模块图每个包只加载一个 ./client 产物，所以 client.js 是生成文件：
改 src/，然后
node build.mjs # 重新生成 client.js
node test.mjs # 离线检查（语法、设置、音色、音频、观察器、节奏、端到端）
node build.mjs --check # 只检查产物是否过期
本机没有独立的 Node 时，可用 Electron 当 Node：
$env:ELECTRON_RUN_AS_NODE=1
& "C:\Program Files\DSH Desktop\DSH Desktop.exe" build.mjs
改完 client.js 需要刷新页面（或重启 DSH Desktop）才会加载新产物。
conversation.composer.dock 这个 slot 把按钮挂到输入框上方，样式只用
Harness 的 --dsw-alias-* / --dsw-specific-* 主题变量，跟随明暗主题。--dsw-specific-menu
（浅色 #f8f9fa94、深色 #43454a73）+ 同一支 --dsw-menu-backdrop-filter
（blur(40px) saturate(150%)）毛玻璃 + --dsw-elevation-prominent 投影，和 DSH 的
stats 面板、各种菜单完全一致。原先用的 --dsw-alias-bg-overlay 是徽标底色
（浅色 #e9ecf2、深色 #61666b），深色主题下面板会是一块偏亮的灰板，跟界面里其它
表面都对不上——"背景色不随主题"就是这么来的。随机音高 / 随机音量 是逐字生成的：src/audio.js 的 pitchJitter() 给每个音一份
随机半音，volumeScale() 给每个音一份随机增益（加在这个音自己的 gain 上，不碰总音量）。
合成音色直接改频率/峰值；音频文件没法改音高，用的是同一份半音偏移换出来的
playbackRate（重采样）——"随机音高对自定义音频没用"就修在 #playSample 里。
blipSeconds() 取最慢的那一档，所以试听的锁定时间不会短于任何一次实际发声。.twb-root 里的 position:absolute，所以 top/left 必须是相对按钮
的偏移。一旦把窗口坐标当成局部偏移写进去，等于又叠了一次按钮自身的偏移——面板就会
掉到屏幕外面去。这段换算抽成了纯函数 placePanel()，离线测试直接钉住它的算术。offsetWidth/offsetHeight（布局盒），不能用
getBoundingClientRect()：入场动画带 scale(.97)，rect 返回的是动画中的视觉盒，
拿它算位置会让面板低约 3%（底部压住按钮），直到下一次重新摆放才弹回去——就是"点一下
面板才回到该在的位置"那个 bug。measurePanel() 固定了这条规则。conversation.chat.node 的 props 里
hookContext 只有 { turnData, disclosureReset }，拿不到流式文本，所以插件观察
Conversation 层已经打好的 data-chat-flow-kind 容器。最小间隔，一次唤醒最多补满 lead 那么长的
一段（可见时是一帧的量，后台是一整秒），所以既不会在长时间隐藏后炸出一串音，也不会在两次唤醒
之间静音。driver 不假设帧率，它只按自己观测到的唤醒间隔调整。voices——它们都还没轮到结束。因此
"超额就掐掉最旧的一个"是错的（最旧的那个正是此刻在响的，会被拉成一秒长的音）：#reap 只回收
音频时钟已经越过的音，onended 照旧负责正常回收。BlipDriver.hold(秒)
在试听期间压住这个掐音；试听时长由 BlipAudio.blipSeconds()（单个音最长多久）加上
排程跨度算出，同一段时间也用来锁住试听按钮。window.__ModuleLoader__.load({ id, factory(require) })，
factory 的第一个参数才是加载器的 require（react 只能从这里拿）。factory 里的任何
异常都会落在启动批次里，会白屏整页，所以 build.mjs 给整段加载套了 try/catch。