喵叫提示音 nonmean/dsh-meow

dsh-meow

在 DSH 需要你时——或完成任务时——听到提示音。 一个 DeepSeek Harness Web 插件，会在四个时刻在浏览器中播放一段简短的合成喵叫声，并在 设置 → 通用 中提供启用/禁用开关。

插件不附带任何音频文件：每声喵叫都通过 Web Audio API 实时生成，因此无需下载任何内容，也没有需要信任的二进制资源。

兼容性

基于 DeepSeek Harness 0.1.7-alpha.2 与 Cordis 4.0.4，在 macOS 和 Node 24 上构建并验证。它仅使用已发布的扩展点——approval/request 与 user-questions/request 瀑布流、session/event、webServer 路由注册表、插槽注册表以及 dsh.client 打包格式——因此应能在各补丁版本间持续可用。

四个时刻

| 时刻 | 宿主观察点 | 喵叫特征 |
| 需要确认 | approval/request 瀑布流上前置的监听器 | 疑问式上扬，明亮 |
| 需要输入 | user-questions/request 瀑布流上前置的监听器 | 更柔和的三角波 |
| 出现问题 | turn/end 且原因为 error | 低沉而悠长 |
| 任务完成 | turn/end 且原因为 completed | 满足，音调略高 |

approval 监听器被前置，因此仅在实际咨询应答者时才会触发：approval 服务在分发前会先解析 never 策略，因此自动拒绝审批的会话保持静默。question 监听器被前置并通过 next() 委托，因此它观察请求，而不会从浏览器应答者那里抢占该请求。

设置

打开 设置 → 通用，找到 喵叫通知音。总开关即为启用/禁用控件。开启时，该行还提供：

- 每个时刻一个复选框（确认、输入、错误、完成）；
- 包含子代理会话——默认关闭，因此被委派的子会话的 turn 结束不会喵叫；
- 音量滑块；
- 测试，立即试听喵叫。

设置 → 通用中的喵叫通知音行

设置 → 通用行：总开关、每个时刻一个复选框、子代理选项、音量以及测试。

设置存储在插件自有的文件中，路径为 $DSH_HOME/dsh-meow.json（默认为 ~/.dsh/dsh-meow.json），因此切换无需重新加载配置文件。

安装

直接从 GitHub 安装（构建产物 lib/ 已提交，因此安装时不会运行构建步骤）：

pnpm dsh plugin --profile web add git+ssh://git@github.com/nonmean/dsh-meow.git

或者，从本地检出目录安装，将配置文件指向该目录：

pnpm dsh plugin --profile web add link:/path/to/dsh_meow

这会将 dsh-meow 追加到 web 配置文件的 bundle 列表，并挂载其 cordis.patch.yml 宿主行。浏览器部分通过 package.json 中的 dsh.client 声明提供，无需单独的名册行。

然后 重启 dsh web（如果配置文件 HMR 已拾取该行，则重新加载页面），并强制刷新浏览器，以便获取新的客户端 bundle。设置行会出现在通用下。

要移除它：

pnpm dsh plugin --profile web remove dsh-meow

工作原理

- 宿主端（lib/index.js）观察四个时刻，维护一个有界的、按类型去重的队列，并提供三个同源 JSON 路由： GET /meow/state、POST /meow/state 和 GET /meow/events?since=N。
- 浏览器端（lib/client.js）每 700 毫秒轮询一次 /meow/events，并为每个排队的事件播放一声合成的喵叫，同时注册设置行。首次轮询会采用宿主游标而不播放，因此重新加载页面时绝不会重放旧的积压事件。
- 路由会拒绝跨站调用者（Sec-Fetch-Site: cross-site）。

浏览器会阻止音频，直到用户做出手势。播放器会在首次指针或按键事件时恢复其 AudioContext，并且仅在上下文处于运行状态时进行调度，因此在你与页面交互后的第一个事件起就会播放喵叫。

开发

pnpm install # 或按下文所述为 node_modules 创建符号链接
pnpm build # tsdown -> lib/index.js + lib/client.js（已提交）
pnpm typecheck # tsc --noEmit
pnpm smoke # 宿主端和浏览器端的冒烟测试，无需 DSH 运行时

浏览器包以 DSH 客户端模块系统的惰性 CJS 工厂格式（window.__ModuleLoader__.load）生成，仅将冻结的平台模块表保留为外部依赖。
lib/ 是有意提交的，这样插件可以从检出目录或 git URL 安装，而无需构建步骤。

故障排除

| 症状 | 修复方法 |
| 完全没有声音 | 在页面中点击或输入一次（浏览器自动播放策略），然后测试。 |
| 设置行缺失 | 重启 dsh web 并强制刷新；确认该包位于 web 配置文件的 dsh.profile.bundles 中。 |
| 喵叫太频繁 | 关闭个别时刻，或保持“包含子代理会话”处于关闭状态。 |
| 每次工具错误都喵叫 | 该插件仅在以错误结束的回合中喵叫，而不是在可恢复的工具错误时；如果某个回合反复以错误结束，那就是信号。 |