任务完成通知 Cocowwy/dsh-plugin-task-notification

DSH 原生任务通知

为 DeepSeek Harness 任务提供原生操作系统通知。通知包含已完成的任务、耗时、完成状态、声音以及一个内置图标。

当 DeepSeek Harness 中的一轮任务结束时，由 DSH Host 直接发送系统级通知。它不依赖浏览器 Notification API，也不需要在网页里授予通知权限。

通知内容

每条通知包含：

- 状态：任务已完成、执行异常、已中止或等待处理
- 任务：优先显示本轮用户输入，过长内容会自动压缩
- 用时：从本轮 turn/start 到 turn/end 的真实耗时
- 声音：使用系统通知声音
- 图标：仅显示一个插件内置的任务完成图标
- 交互：纯信息提示，不添加按钮、下拉菜单或重复确认操作

耗时显示规则：

不足 60 秒：12 秒不足 1 小时：3 分 18 秒 1 小时以上：2 小时 6 分

通知不等待任何自定义交互响应。macOS 的实际显示时长由系统通知策略控制，应用不能可靠指定秒数：

- “横幅”会自动消失
- “提醒”会持续显示，直到用户关闭

如需持续显示，请前往 系统设置 > 通知，找到发送通知的通知助手，将样式改为“提醒”。

环境要求

- DeepSeek Harness 0.1.0-rc.6 或更高版本
- Node.js 20 或更高版本
- macOS、Windows 或支持桌面通知服务的 Linux
- dsh 和 pnpm 可通过 PATH 调用

从 GitHub 安装

dsh plugin --profile web add "github:Cocowwy/dsh-plugin-task-notification"

然后停止并重新启动 dsh web，再刷新现有页面。仅刷新浏览器不会重新加载 Web profile 的 Host 插件。

更新

dsh plugin --profile web update dsh-plugin-task-notification

更新后重启 dsh web。

卸载

dsh plugin --profile web remove dsh-plugin-task-notification

卸载后重启 dsh web。如果提示 ERR_PNPM_CANNOT_REMOVE_MISSING_DEPS，说明插件当前未安装或已经卸载，不需要重复执行。

macOS 没有出现通知

1. 确认已经重启 dsh web，而不是只刷新页面。
2. 打开 系统设置 > 通知，允许通知助手显示通知。
3. 关闭“专注模式”，或允许通知助手在专注模式下通知。
4. 检查启动 dsh web 的终端中是否有 [task-notification] 错误。

macOS 原生通知由系统通知助手发送，因此系统设置中显示的发送者名称可能是通知助手，而不是浏览器。

架构

DSH session/event
-> turn/start 记录开始时间 -> user/message 记录本轮任务 -> turn/end 计算状态和耗时 -> Node Host 原生通知适配器 -> macOS / Windows / Linux 通知中心

插件完全在 DSH Host 中运行，不上传任务标题、会话标识或其他数据。

英文

该插件在一轮任务结束时从 DSH Host 发送原生操作系统通知。它不使用浏览器 Notification API，也不需要网站通知权限。

每条通知包含：

- 完成、错误、中断或阻塞状态
- 当前轮次的用户任务，必要时会缩短
- 从 turn/start 到 turn/end 的实际耗时
- 系统声音
- 一个内置的任务完成图标
- 仅作信息展示，不包含自定义按钮、下拉菜单或重复确认操作

安装

dsh plugin --profile web add "github:Cocowwy/dsh-plugin-task-notification"

重启 dsh web 并刷新现有页面。

更新

dsh plugin --profile web update dsh-plugin-task-notification

更新后重启 dsh web。

卸载

dsh plugin --profile web remove dsh-plugin-task-notification

卸载后重启 dsh web。

通知时长

通知不等待任何自定义交互响应。macOS 通过系统设置控制可见时长：横幅会自动消失，而提醒会一直保留，直到被关闭。应用程序无法可靠地覆盖这一用户级策略。

隐私该插件在 DSH Host 中本地运行，不会上传任务标题、会话标识符或通知数据。

许可证

MIT