DeepSeek Harness 的核心设计理念是「一切皆插件」。在开发或运行智能体任务时,任务可能在后台静默执行,开发者难以实时掌握任务状态(如正在运行、等待审批或出错)。dsh-notify-yimit 插件旨在解决这一状态断层问题,通过系统通知或桌面浮窗,在任务关键节点提醒用户,并提供跳转会话的入口。
插件简介¶
- 名称:
yimlt/dsh-notify-yimit - 维护者:YiMlT
- 定位:DeepSeek Harness 任务状态通知插件
- 核心能力:在任务完成、出错、运行中、等待审批、等待回答时发送提醒。支持 Windows 系统原生通知与自定义桌面浮窗,点击可跳转至对应会话。
核心功能¶
插件通过集成到 DSH 设置页提供配置能力,主要包含以下功能:
- 通知方式选择:在设置页「通知」分节中,提供三种模式:
- Windows 系统通知
- 插件自定义桌面浮窗(默认关闭)
- 关闭(默认)
- 桌面浮窗特性:
- 常驻宿主架构:插件加载时启动一个 PowerShell 宿主进程,使用 WPF 创建浮窗。所有浮窗在该进程内管理,通知创建延迟从约 1 秒降低至约 10 毫秒。
- 多浮窗堆叠:屏幕右下角无边框置顶显示,多个浮窗自动向上堆叠。
- 实时更新:运行中通知支持 400ms 节流原地更新文本,不重弹、不闪烁。
- 状态性通知:运行中、等待审批、等待回答的状态性通知,在状态结束前不会自动消失。
- 自定义样式:支持配置每种通知类型的背景色和文字色(完成=绿、出错=红、运行中=蓝、待审批=黄、待回答=紫),以及浮窗显示数量上限和显示时长。
- 跳转功能:支持选择跳转浏览器(Chrome/Edge/Firefox 等),通过 URL hash
#dsh-notify-yimit/session=<id>定位到对应会话。
安装与启用¶
- 执行安装命令:
dsh plugin --profile web add dsh-notify-yimit
- 重启
dsh web进程,使插件生效。 - 打开 DSH 界面,前往 设置 → 通知。
- 开启插件总开关,并选择通知方式(系统通知或自定义浮窗)。
配置说明¶
- 系统通知:点击设置页中的按钮可一键申请浏览器通知权限。
- 自定义浮窗:在开启插件总开关后,可配置显示数量、显示时长及颜色。
- 标题处理:若对话标题尚未生成(LLM 异步生成),浮窗将显示占位符“(未命名会话)”,待标题事件到达后会原地更新。
注意事项¶
- 运行环境:插件依赖 Windows 平台及 PowerShell 5.1+ 环境。
- 默认状态:插件默认关闭,需手动开启。
- 通知行为:
- 运行中:实时更新活动文本,直到任务结束。
- 等待审批/回答:不做防抖,多条信息会直接替换更新。
- 完成/出错:达到配置的显示时长后自动消失。
- 系统通知依赖:使用系统通知功能需要浏览器授予相应的通知权限。
总结¶
dsh-notify-yimit 通过常驻 PowerShell 宿主进程实现了低延迟的桌面浮窗体验,并针对 DeepSeek Harness 的运行场景(如工具调用、审批流)进行了优化。对于需要长时间运行或复杂审批流程的智能体任务,该插件能有效提升开发者的掌控感。
- GitHub 仓库:https://github.com/YiMlT/dsh-notify-yimit
- 插件目录:https://www.skillhub.cn/plugins/YiMlT/dsh-notify-yimit