DSH(DeepSeek Harness)在处理任务调度、智能体交互和审批流程时,需要持续的状态反馈。传统的日志输出或简单的系统通知往往无法满足即时交互的需求。zeta987/dsh-notify-zeta 是一个社区插件,它为 DSH 提供了一个内置的通知中心,并支持通过原生 Windows 弹窗(WPF)实现单选、多选、文本输入和一次性审批。
功能概述¶
该插件主要包含以下能力:
-
DSH 内置通知中心
打开 Settings → Zeta Notify,可以查看最近的通知记录,按未读状态或类型进行过滤,标记为已读,或清除历史记录。 -
交互式 Windows 卡片
插件利用 Windows 的 WPF 和 PowerShell,原生弹出窗口而非简单的系统通知气泡。支持:- 单选、多选和自由文本输入。
- 一键允许或拒绝操作。
这些卡片在浏览器标签页关闭的情况下依然有效,前提是 DSH 进程在 Windows 主机上保持运行。
-
双通道通知
- 原生通道:直接调用 Windows 卡片,适合需要操作确认的场景。
- 浏览器通道:调用浏览器的系统通知 API,需在 HTTPS 或回环地址环境下,并获得浏览器权限。
-
精细化的控制
提供了 14 个事件开关(包括任务完成、错误、中断、审批、计划审查等),可控制声音、内容预览,以及是否在当前会话中屏蔽普通通知。 -
语言跟随
界面和通知文本自动跟随 DSH 的运行语言(英语或繁体中文)。配置项language设为auto时跟随 DSH,设为zh或en时固定语言。 -
内置测试工具
Settings 页面提供安全测试按钮,可模拟浏览器通知、原生卡片、问题和审批卡片,无需运行真实工具或调用模型。
安装与启用¶
插件使用 MIT 许可证,由社区维护。安装前请确保 DSH 已安装并初始化了 web 配置文件。
npx @deepseek-ai/dsh plugin --profile web add dsh-notify-zeta
安装完成后,必须重启 DSH 进程并刷新浏览器页面,然后进入 Settings → Zeta Notify 进行激活和配置。
使用说明¶
-
查看通知
进入通知中心,查看最近的通知记录。系统默认保留最近 200 条记录在内存中。 -
测试通知
点击浏览器和原生测试按钮,验证通知是否正常送达。浏览器声音需在页面交互后播放,原生卡片则依赖 Windows 主机上的 DSH 进程。 -
配置选项
- 事件开关:根据需要启用或禁用 14 种特定事件的通知。
- 语言设置:在插件配置行中修改
language字段(默认auto)。 - 预览控制:关闭内容预览会隐藏普通通知的详情,但交互式卡片仍会显示完整内容。
-
审批与回答
当收到审批或问题卡片时,插件会绑定具体的会话、原始智能体和请求。如果原生卡片不可用或失败,DSH 会回退到标准的审批对话框。
系统要求与注意事项¶
- Node.js 版本:必须安装 Node.js 22.19.0 或更高版本。
- 操作系统:原生 Windows 卡片功能仅支持 Windows 10 或 11。插件依赖 Windows 自带的 PowerShell 5.1 和 WPF,无需额外安装 .NET。
- 浏览器通知:若使用浏览器通知渠道,页面必须通过 HTTPS 或回环地址访问,且需授予浏览器对该源的权限。
- 隐私与安全:插件不包含遥测、外部推送传输或 Webhook 功能。设置以
zeta-notify.settings.前缀保存在当前 DSH 配置文件中。重启 DSH 会清除内存中的历史记录。 - 兼容性:DSH 版本需满足插件要求(通常为 0.1.5-rc.1 以上)。DSH 开发预览 API 可能有变化,其他版本可能存在兼容性问题。
总结¶
zeta987/dsh-notify-zeta 通过引入原生 Windows 交互层和中心化的通知管理,解决了 DSH 在长时间运行任务中状态反馈和人工干预的痛点。它是一个轻量级、无外部依赖的社区插件,适合需要在 Windows 环境下深度集成审批流程的开发者。
- 源码仓库: https://github.com/zeta987/dsh-notify-zeta
- 插件目录: https://www.skillhub.cn/plugins/zeta987/dsh-notify-zeta