在 DeepSeek Harness (DSH) 中开发智能体时,需要时刻监控 Web UI 中的交互状态。如果代理在后台运行或长时间未响应,开发者容易错过关键的通知信息。这个插件通过 Windows 系统级通知解决了这个问题,让回合结束的状态变得显性。
这是什么¶
这是一个名为 hxy113/dsh-turn-notify 的 DSH 插件,由开发者 hxy113 维护。它利用 Windows 原生的 Toast 机制,在智能体完成一个回合时提醒用户,并提供点击跳转功能。插件遵循 MIT 许可证。
核心功能¶
- Windows Toast 通知:当智能体回合结束时触发系统级通知。
- 点击跳转:点击通知可自动打开 Web UI 并定位到该会话。
- 会话过滤:仅对根会话(交互式会话)触发,避免子代理或工作流内部回合造成干扰。
安装与启用¶
安装插件并启动 Web UI:
dsh plugin --profile web add github:hxy113/dsh-turn-notify
dsh web
典型用法¶
- 启动 DSH Web UI。
- 运行智能体并完成一个回合。
- 右下角弹出 Windows Toast 通知。
- 点击通知,浏览器自动打开并定位到该会话。
适用场景与注意¶
- 环境要求:需要 Windows 10/11,且运行
dsh web。 - 通知拦截:通知可能被系统的“专注助手”或应用通知设置拦截,这是 Windows 自身行为,需检查设置。
- 卸载:如需移除,执行:
dsh plugin --profile web remove dsh-turn-notify
卸载时会自动清理注册表键值和遗留快捷方式。
- 技术细节:插件通过监听
agent/turn-stopping事件,使用powershell.exe -STA配合 WinRTToastNotificationManager发送通知。点击后通过注册的/jump-session路由恢复会话。
总结¶
这个工具让智能体开发过程中的状态追踪变得轻量且即时,适合需要频繁交互和监控的场景。插件源码位于 GitHub。