ds-turn-notify

ds-turn-notify（含 Windows 版与 macOS 版）

DSH（DeepSeek Harness）Web 会话的背景提醒插件，两个独立插件共存于本仓库：

两个插件功能一一对应，仅通知通道不同，各自独立安装、独立配置：

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）

安装

Windows 版（仓库根目录）：

git clone https://github.com/237229953-create/ds-turn-notify.git
cd ds-turn-notify
dsh plugin --profile web add .

macOS 版（mac/ 子目录）：

git clone https://github.com/237229953-create/ds-turn-notify.git
cd ds-turn-notify/mac
dsh plugin --profile web add .

安装后重启 dsh（dsh web）生效。

macOS 通知权限

首次触发提醒时，macOS 可能弹出「终端/iTerm 想发送通知」的授权提示——请允许，否则 osascript display notification 不会显示。

目录结构

ds-turn-notify/
├── package.json        # Windows 版 bundle 元数据
├── cordis.patch.yml    # Windows 版挂载层
├── lib/                # Windows 版主体(index.js / notify.ps1 / client.js)
├── test/               # Windows 版逻辑测试
└── mac/                # macOS 版(独立插件,原 ds-turn-notify-mac 仓库)
    ├── package.json
    ├── cordis.patch.yml
    ├── lib/            # index.js / client.js
    └── test/

测试

node test/harness.mjs       # Windows 版
node mac/test/harness.mjs   # macOS 版

版本

• Windows 版：0.1.0
• macOS 版：0.1.0