reimu-create/ds-turn-notify

README 摘要

ds-turn-notify（含 Windows 版与 macOS 版） DSH（DeepSeek Harness）Web 会话的背景提醒插件，两个独立插件共存于本仓库： 插件 目录 平台 视觉提醒 提示音 ds-turn-notify （Windows 版） 仓库根目录 Windows powershell.exe → BurntToast / NotifyIcon 气泡 notify.ps1 → SoundPlayer / Beep ds-turn-notify-mac （macOS 版） mac/ macOS /usr/bin/osascript → 通知中心 /usr/bin/afplay 两个插件功能一一对应，仅通知通道不同，各自独立安装、独立配置： 1. 回合完成 （主会话 turn/end ）——提醒一次； 2. 索要权限 （ approval/asked ）——立即提醒（文案含工具名）。 默认只提醒主会话；子会话（subagent / fork / workflow， header.origin === 'subagent' ）不提醒。 功能 - 零第三方依赖：只用 Node 内置模块 + 系统自带命令； child process.spawn fire-and-forget（ stdio: 'ignore' 、 unref() ），不阻塞 agent turn。 - 仅页面在后台时提醒 （ notifyOnlyWhenHidden ）：浏览器 client 半检测页面可见性（ document.hidden / 失焦）并经同源路由上报 host，所有 DSH 页面都不可见时才提醒；盯着页面时安静。 - 提醒文案携带当前会话标题 （ showTitle ）： 「标题」第 N 回合完成 / 「标题」会话请求权限：工具名 ；无标题自动回退。 - 防抖：同一会话同一类事件在 debounceMs 内合并为一次； approval/asked 与 turn/end 分开计时。 - 任何提醒失败均不影响会话本身（仅 logger.warn ）。 配置项（各插件 cordis.patch.yml → config ） 键 类型 默认 说明 enabled bool true 插件总开关 sound bool true 是否播放提示音 soundPath string '' 自定义音频路径（Win: wav；Mac: afplay 支持 aiff/m4a/mp3 等） toast bool true 是否发送视觉提醒 onlyMainSession bool true 只提醒主会话 debounceMs number 800 同类事件防抖间隔（毫秒） turnDone bool true 是否在回合完成时提醒 approval bool true 是否在请…

分类