SeverusZh/dsh-notify-windows

插件Plugin ⭐ 5 MIT social

> DeepSeek Harness(DSH)插件:当 Agent 需要你关注时,向 Windows 发送系统桌面通知。

catalog 简介 / catalog descriptioncatalog description:—

编辑导读Editor's Brief

## 核心特性
- 该插件可在 DeepSeek Harness 中发送 Windows 桌面通知,当 agent 会话完成、失败、达到输出限制、请求审批或向用户提问时触发。
- 它监听 turn/end 事件以识别会话结束,并在通知标题中使用会话标题,同时在正文中显示结束原因和轮次。
- 它监听 approval/asked 事件,并在会话审批策略设置为 never 时自动跳过通知。
- 它会检测 run_code 程序源码中的 tools.ask_user_question( 调用,并提取问题文本用于通知正文。
- 它默认忽略 subagent 会话,并可通过配置选择将其包含在内。

## 使用场景
- 用户可以在 agent 任务运行期间离开屏幕,并在主会话完成或因错误停止时收到通知。
- 用户可以在操作等待审批时收到提醒,而不必持续盯着 DSH 界面。
- 当 agent 提出需要回答的问题时,用户可以收到通知,包括通过 run_code 工具调用发出的问题。

## 技术细节
- 通知通过 Windows PowerShell 5.1 的 WinRT Toast API 发送,插件会在 HKCU 下注册 AppUserModelId,无需管理员权限。
- 安装使用 dsh.bundle 机制,其中 npm 包提供 cordis.patch.yml,在执行 dsh plugin add 后挂载 dsh-notify 条目。
- 配置通过在 profile 的 cordis.patch.yml 中覆盖 dsh-notify 条目来应用,运行中的 DSH 进程会监听该文件。
- 可点击的 toast 可通过 dshnotify:// 协议处理程序打开 DSH Web GUI,在可用时聚焦已有窗口,或回退到默认浏览器。

## 注意事项
- README 标明支持 Windows 10 或 Windows 11 平台,通知送达取决于 Windows 通知设置和 Focus Assist 行为。
- 手动为 dsh-notify 添加 - insert: 条目会导致 loader 条目重复错误。
- DSH 0.1.0-rc.8 前端不会使用 ?session=<id> 参数,因此点击 toast 会打开 DSH 界面,而不是直接定位到目标会话。

## Core Features
- The plugin sends Windows desktop notifications from DeepSeek Harness when an agent session completes, fails, reaches an output limit, requests approval, or asks the user a question.
- It listens to turn/end events for session endings and uses the session title in the notification title while showing the ending reason and round in the body.
- It listens to approval/asked events and skips notifications automatically when the session approval policy is set to never.
- It detects tools.ask_user_question( calls inside run_code program source and extracts the question text for the notification body.
- It ignores subagent sessions by default and can optionally include them through configuration.

## Use Cases
- Users can leave the screen while an agent task runs and receive a notification when the main session finishes or stops with an error.
- Users can receive a prompt when an operation is waiting for approval instead of watching the DSH interface continuously.
- Users can be notified when an agent asks a question that requires an answer, including questions issued through run_code tool calls.

## Technical Details
- Notifications are sent through the Windows PowerShell 5.1 WinRT Toast API, and the plugin registers an AppUserModelId under HKCU without requiring administrator rights.
- Installation uses the dsh.bundle mechanism, where the npm package provides cordis.patch.yml to mount the dsh-notify entry after dsh plugin add.
- Configuration is applied by overriding the dsh-notify entry in the profile cordis.patch.yml, and the file is watched by the running DSH process.
- Clickable toasts can open the DSH Web GUI through a dshnotify:// protocol handler, focus an existing window when available, or fall back to the default browser.

## Notes
- The README identifies Windows 10 or Windows 11 as the platform, and notification delivery depends on Windows notification settings and Focus Assist behavior.
- Manual - insert: entries for dsh-notify cause a duplicate loader entry error.
- DSH 0.1.0-rc.8 front end does not consume the ?session=<id> parameter, so clicking a toast opens the DSH interface rather than directly locating the target session.

安装Install

dsh plugin --profile web add dsh-notify-windows

SeverusZh/dsh-notify-windows 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev oss-prompt-optimizer 下一个 Next dsh-plugin-subagent-director