前言¶
在使用 DeepSeek Harness（DSH）时，当一轮任务完成或模型阻塞等待输入时，缺乏直接的视觉或听觉反馈。dsh-task-ask-notify 是一个 DSH 宿主侧插件，它通过原生 Windows 11 通知和 WAV 提示音，解决了这一问题。当模型交还控制权或调用 ask_user_question 时，插件会立即发出提醒，不走过抖延迟。
核心功能¶
该插件提供以下能力：
- Windows 11 通知：弹出真实的系统通知，进入操作中心，并遵循你的 Windows 专注助手设置。
- WAV 提示音：播放提示音，支持自定义音效目录和等概率随机播放。
- 配置方式：支持通过配置文件或 DSH 插件界面进行配置。
- 自检工具：提供适配器自检工具，用于验证基础功能是否正常。
安装与启用¶
安装过程通过 DSH 的插件管理器完成。插件本身不需要 Node.js 运行，Node.js 仅用于随包附带的工具。
-
准备代码
将代码放置在 DSH 插件目录下。示例路径为：
%USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify
放置位置不影响功能，DSH 会通过plugin_manager读取信息。 -
安装 Bundle
在 DSH 中运行以下命令将 Bundle 装入当前 Profile：
plugin_manager install_bundle %USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify
执行后若返回 `application: "applied"` 则生效；若返回 `restart-required` 则需重启 DSH。
- 验证安装
运行自检工具确认基础能力：
node tools/win-alert-selftest.mjs
退出码为 `0` 表示自检通过。随后起一个任务并让其完成，或让模型提问，观察是否收到通知和提示音。
典型用法¶
插件附带了一些 Node.js 工具用于管理音效和测试：
- 运行自检：
node tools/win-alert-selftest.mjs - 导入音效：将外部音效包复制到插件数据目录：
node tools/import-audio.mjs --source "<你的素材包路径>"
导入工具会对文件进行 SHA-256 校验，且默认写入 `%DSH_HOME%\plugin-data\dsh-task-ask-notify\`，修改后无需重装即可生效。
- 生成默认提示音：生成用于兜底的
audio/_default/chime.wav：
node tools/gen-default-chime.mjs --check
环境与注意事项¶
使用前需确认环境满足以下要求：
- 操作系统：Windows 10 2004+ 或 Windows 11。
- DSH 版本：0.2.0-rc.2 或更新（需要宿主插件的
Config与session/event接口）。 - PowerShell：系统自带的 Windows PowerShell 5.1。
- Node.js：20+，仅用于运行测试和随包工具，插件本身运行不需要 Node.js。
已知注意事项：
- 静默失败：若完全没反应，可能是 AUMID 未在开始菜单注册。此时 Windows 会接受 Toast 但不显示。
- 适配器启动方式：适配器不能使用
detached: true启动，否则 Windows 会丢弃通知。
结尾¶
该插件为 DSH 增加了系统级的通知能力，使任务状态反馈更加明确。更多配置选项、音效目录结构说明及排错方法，请参考 GitHub 仓库。
