前言¶
在 DeepSeek Harness (DSH) 的 Web 环境中运行 Agent 或工作流时，任务往往在后台持续执行。当任务完成、需要人工审批、计划待确认或目标受阻时，如果浏览器处于关闭或后台状态，这些关键状态很容易被遗漏。dsh-task-notify 插件解决了这个问题，它利用 Windows 系统原生的通知机制和 PushPlus 微信推送，确保你在任何情况下都能及时收到任务反馈。
插件简介¶
该插件由开发者 V-Reason 维护，是一个开源的 DSH Web 客户端插件。它不依赖浏览器权限，而是通过 PowerShell 调用 Windows 通知中心。插件支持在任务完成、需要审批、询问用户、计划待确认以及目标受阻时发送通知，并提供独立的开关控制，支持持久化配置和布局自适应。
核心功能¶
-
系统级 Windows 通知
插件通过调用 PowerShell 7 的BurntToast模块，向 Windows 通知中心发送消息。这包括显示通知内容、播放系统提示音，并使用 DeepSeek 官方图标。 -
手机推送（PushPlus）
插件集成了 PushPlus 服务，支持将任务通知同步推送到微信。即便电脑不在身边，也能通过手机接收提醒。 -
通知内容与分类
- 内容：包含会话名（沿父链回溯到根会话）、时间、任务状态（完成/失败/中止等）。
- 分类触发：支持多种场景的独立提醒，包括需要审批（提权/越权）、询问用户（
ask_user_question）、计划待确认（/plan完成后提交计划）、目标受阻（持续阻塞停止）。
-
图标热更新
通知图标默认读取包内的deepseek.png。替换该文件后，下一条通知会自动使用新图标，无需重建插件或重启 DSH。 -
布局自适应
插件的配置面板会自动跟随dsh-better-sidebar的布局，在右侧面板和底部面板展开时进行高度让位，确保不遮挡界面。
安装与配置¶
安装命令
在 DSH 的 Web profile 环境下执行以下命令：
dsh plugin --profile web add git+https://github.com/V-Reason/dsh-task-notify.git
前置环境要求
确保系统满足以下条件：
* Windows 10/11。
* PowerShell 7 (pwsh)。
* 已安装 BurntToast 模块：
Install-Module BurntToast -Scope CurrentUser
重要配置说明
- 宿主行注入：本插件自带
cordis.patch.ymlbundle 补丁用于注入宿主行，不要在 profile 的cordis.patch.yml中手动再次写入dsh-task-notify，否则会导致启动报错。 - pnpm 构建限制：在 profile 的
pnpm-workspace.yaml中，必须确保allowBuilds: node-pty: true为true，否则安装会因ERR_PNPM_IGNORED_BUILDS失败。
使用说明¶
-
获取 PushPlus Token
访问 https://www.pushplus.plus 扫码登录，复制「一对一推送」的 Token。 -
配置手机推送
点击 DSH 界面标题栏右侧的铃铛图标，展开「手机推送」层，打开 PushPlus 开关并粘贴 Token。点击「保存 Token」（或按回车）。 -
测试通道
使用「通知类型」层的「测试 Windows 通知」与「手机推送」层的「测试手机推送」按钮验证推送是否正常。 -
调整通知类型
在「通知类型」层中，根据需求独立开关各类通知，例如「需要审批」、「询问用户」、「计划确认」或「目标受阻」。
注意事项¶
- 审批策略：当审批策略为
never（例如danger-full-access权限预设）时，审批请求会被自动拒绝，无需人工操作，因此不会发送审批提醒。 - 配置持久化：除 Token 文本输入需要点击保存外，所有开关调整均为即改即存，无需手动保存。
- 版本兼容：插件依赖 DSH 的 profile 插件机制，安装后需确保宿主环境满足相关依赖要求。
结语¶
dsh-task-notify 通过系统通知和微信推送，降低了 DSH Agent 运行时的信息获取成本。它提供了一套从安装到使用的完整方案，适合需要在后台稳定运行任务并希望实时获取状态的开发者。
- GitHub 仓库: https://github.com/V-Reason/dsh-task-notify
- 插件目录: https://www.skillhub.cn/plugins/V-Reason/dsh-task-notify
