YuMo226/dsh-task-notify

English | 中文

一个 DeepSeek Harness (DSH) 插件：每当任务完成时（目标完成或 Agent 结束一轮），在 Windows 弹出原生系统通知（通知中心横幅）。

特性

• Windows 原生系统通知 — 右下角真实通知横幅，非模态弹窗，不打断你的工作。
• 两个「任务完成」触发（可分别开关）：
  • 目标（goal）进入 complete 状态
  • Agent 一轮正常结束
• CJK 安全 — 通知文本通过 UTF-8 临时文件传给 PowerShell，中文/日文/韩文不会被损坏。
• 零运行时依赖 — 仅用 Node 内置模块 + PowerShell。
• 防刷屏 — 两次通知之间可设置最小间隔。

工作原理（Windows）

1. 首次通知时注册 AppUserModelID（dsh.tasknotify）到 HKCU\Software\Classes\AppUserModelId，使 CreateToastNotifier 能投递到交互桌面。
2. 任务完成时，把标题/正文写入 UTF-8 临时文件，运行一段小 PowerShell 脚本，通过 ToastNotificationManager 展示 WinRT ToastText02 通知。
3. 之后删除临时文件；失败只写入日志、绝不抛错，不影响 Agent 运行。

每次通知（及失败）都会记录到审计日志 <home>/task-notify.log。

安装

作为 dsh bundle，可通过 profile 插件管理器安装：

dsh plugin --profile web add dsh-task-notify

或直接安装该仓库：

dsh plugin --profile web add github:YuMo226/dsh-task-notify

手动安装（无 pnpm）

把本包复制到 profile 的 hoisted node_modules，并添加 loader entry：

- insert:
    - id: notify
      name: dsh-task-notify
      config:
        onGoalComplete: true
        onTurnEnd: true
        title: 'DeepSeek Harness'
        minIntervalMs: 4000

安装后请重启 dsh web 以便插件挂载。

配置

键	类型	默认	说明
onGoalComplete	boolean	true	目标完成时通知
onTurnEnd	boolean	true	Agent 一轮正常结束时通知
title	string	DeepSeek Harness	通知标题
minIntervalMs	number	4000	相邻两次通知的最小间隔（防刷屏）

常见问题

• 请确认系统通知中心已开启，且专注助手未处于「仅闹钟」/「仅优先事项」模式。
• 若未弹通知，查看 <home>/task-notify.log 是否有 toast exit=... 记录，并可提交 issue。

License

MIT