deepseekplugins

DeepSeek Harness plugin

ds-turn-notify-reimucre

DSH 会话完成或索要权限时后台提醒 + 提示音（Windows）

Memory
Jump to install

Source facts

Repository
reimu-create/ds-turn-notify
Latest update
Aug 14, 2026
Category
Memory
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/reimu-create/ds-turn-notify
Plugin: ds-turn-notify-reimucre
Author: reimu-create

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

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

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

插件目录平台视觉提醒提示音
ds-turn-notify（Windows 版）仓库根目录Windowspowershell.exe → BurntToast / NotifyIcon 气泡notify.ps1 → SoundPlayer / Beep
ds-turn-notify-mac（macOS 版）[mac/](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）

键类型默认说明
enabledbooltrue插件总开关
soundbooltrue是否播放提示音
soundPathstring''自定义音频路径（Win: wav；Mac: afplay 支持 aiff/m4a/mp3 等）
toastbooltrue是否发送视觉提醒
onlyMainSessionbooltrue只提醒主会话
debounceMsnumber800同类事件防抖间隔（毫秒）
turnDonebooltrue是否在回合完成时提醒
approvalbooltrue是否在请求权限时提醒
notifyOnlyWhenHiddenbooltrue仅所有 DSH 页面都不可见时提醒
showTitlebooltrue提醒文案是否携带会话标题前缀
titlestringDSH 提醒提醒标题

安装

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
Back to searchOpen GitHub repository

More related plugins

View category