Andyqwe44/dsh-notify-win

dsh-notify-win

DeepSeek Harness（DSH）Windows 通知插件：任务完成或需要你回答时，弹出原生 toast 并闪烁任务栏图标。

platform
license
version

📸 截图

任务完成

任务完成 toast

上下文压缩完成

上下文压缩完成 toast

单选问题

单选问题 toast

toast 超时 → 任务栏闪烁

截图来自 Windows 11。任务栏闪烁是动态效果，截图展示的是 DSH 任务栏按钮被系统暖色高亮的状态。

✨ 功能

- 🔔 原生 Windows toast（右下角，Win10/11 系统样式）
- 💡 任务栏闪烁（FlashWindowEx），DSH 在后台时提醒你切回
- 🖱️ 点击跳转 — 点击 toast 自动打开 DSH 并切换到对应会话
- ✅ 任务完成时触发（根 agent 进入 idle）
- 🗜️ 上下文压缩完成时触发（session/event → compaction/end）
- ❓ 需要你回答时触发（审批 / ask_user_question）
- 📋 单选问题 toast：原生下拉框（最多 5 个选项）+ “自定义答案”输入框 + 取消 / Send
- ⏰ 超时闪烁兜底：交互 toast 被忽略并超时关闭后，任务栏闪烁提醒你还有待处理的问题
- 🖼️ toast 顶部显示 DeepSeek Harness hero 大图（自动适配浅色/深色主题）
- 🚀 即发即忘：不注册服务、不经过模型审批、不占用 settings 命名空间

🚀 一行安装

dsh plugin --profile web add dsh-notify-win

需要 pnpm 在 PATH 中（没有就先 corepack enable）。详见 安装。

安装

1. 前置：pnpm

corepack enable

没有管理员权限时，在 PATH 目录放一个用户级 shim：

Set-Content -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\pnpm.cmd" -Value "@echo offrncorepack pnpm %rn"
corepack pnpm --version

2. 安装插件

从 npm 安装（推荐）
dsh plugin --profile web add dsh-notify-win

或从 GitHub 直接安装：
dsh plugin --profile web add github:Andyqwe44/dsh-notify-win

若 github: 失败（网络受限），改用 SSH：
dsh plugin --profile web add git+ssh://git@github.com/Andyqwe44/dsh-notify-win.git

3. 验证

dsh --profile web --dump-config   # 找到：# == dsh-notify-win / - id: dsh-notify-win

4. 重启并测试

dsh web

随便完成一个任务即可。第一条通知会自动完成品牌身份注册（开始菜单快捷方式 + AppUserModelID，一次性）。若 toast 标题仍显示 DeepSeekHarness 且没有图标，重启一次资源管理器：

Stop-Process -Name explorer -Force; Start-Process explorer

环境要求

- Windows 10/11
- DeepSeek Harness，任意 profile（推荐 web）
- PowerShell 7 或 Windows PowerShell 5.1（5.1 会自动作为兜底）
- .NET 10 Desktop Runtime（x64）— 仅交互式问题 toast（ask_user_question）需要；任务完成/压缩完成 toast 走 PowerShell，不需要 .NET

配置

编辑 $env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml：

- id: dsh-notify-win
config:
doneTitle: 'DeepSeek Harness · 任务完成'
doneBody: '任务已完成，可以查看结果。'
compactTitle: 'DeepSeek Harness · 上下文已压缩'
compactBody: '上下文压缩完成，可以继续。'
questionTitle: 'DeepSeek Harness · 需要你确认'
questionBody: '有操作需要你批准或拒绝。'
askTitle: 'DeepSeek Harness · 有问题等你回答'
askBody: '助手向你提了一个问题，请切换到 DeepSeek Harness 查看。'
dedupMs: 1500              # 两次通知之间的去重窗口（毫秒）
showProject: true          # 正文前缀显示项目标识

禁用插件：

- id: dsh-notify-win
disabled: true

安装/禁用后需重启（web profile 默认关闭 HMR）。

工作原理

| 环节 | 实现 |
| --- | --- |
| 「完成」触发 | agent/status 事件 status: 'idle'（仅根 agent） |
| 「压缩完成」触发 | session/event → compaction/end（无 error） |
| 「待回答」触发 | approval/request 瀑布 + ask_user_question 的 tools/execute |
| 完成/压缩 toast | WinRT Windows.UI.Notifications，经 notify.ps1，顶部 hero 大图，失败回退 NotifyIcon 气泡 |
| 交互问题 toast | .NET 辅助程序 dsh-toast-question.exe（读取下拉框/输入框并回传答案给宿主） |
| 任务栏闪烁 | EnumWindows + FlashWindowEx（FLASHW_TRAY \| FLASHW_TIMERNOFG = 14） |
| 执行方式 | 即发即忘子进程（powershell / dsh-toast-question.exe） |

插件不注册服务、工具或 settings 命名空间——普通消费者行，任何 profile 都安全。

已知限制

- 原生 toast 文本很紧凑，大约只能显示 4 行，长内容会被截断。
- 原生下拉框弹出列表时，鼠标移到弹层上可能导致 toast 收起；如果随后 toast 超时关闭，任务栏闪烁仍会提醒你。
- FlashWindowEx 使用系统自带暖色脉冲，无法自定义颜色。
- Windows 不会闪烁前台窗口——只有 DSH 在后台时任务栏按钮才会闪。
- 取消正在运行的一轮同样会进入 idle，所以取消任务也会触发「完成」通知。
- 通知按会话在 dedupMs（默认 1500ms）内去重。
- 交互式问题 toast 需要机器上安装 .NET 10 Desktop Runtime。

开发

npm run check     # 语法检查
npm test          # 逻辑冒烟测试（mock ctx）

单独测试通知脚本（会真的弹出 toast + 闪烁任务栏）：
powershell -NoProfile -File lib/notify.ps1 -Kind done -Title "test" -Body "test"

重新构建交互问题辅助程序：
dotnet publish src/DshToastQuestion/DshToastQuestion.csproj -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true -o lib

项目结构

dsh-notify-win/
├── lib/
│   ├── index.js               # 宿主半：事件监听 → 拉起子进程
│   ├── client.js              # 浏览器侧：点击跳转 / 答案轮询
│   ├── notify.ps1             # 完成/压缩 toast + 任务栏闪烁
│   ├── focus-dsh.ps1          # 聚焦/启动 DSH Edge PWA
│   ├── focus-dsh.vbs          # focus-dsh.ps1 的隐藏启动器
│   ├── dsh-toast-question.exe # 交互问题 toast 辅助程序（C#）
│   └── dsh-.png / dsh-*.ico  # 品牌素材
├── src/DshToastQuestion/
│   ├── Program.cs             # C# 辅助程序源码
│   └── DshToastQuestion.csproj
├── test/
│   ├── smoke.mjs              # 插件逻辑冒烟测试
│   └── headless-overlay.yml
├── docs/
│   └── assets/screenshots/    # README 截图
├── cordis.patch.yml           # DSH bundle 补丁
├── package.json               # dsh.bundle 声明
├── README.md
└── README.zh.md

链接

- 🌐 落地页：https://Andyqwe44.github.io/dsh-notify-win/

Roadmap

- V1（已实现）：完成 + 压缩 + 问题 toast；单选下拉框 + 自定义答案；取消 / Send；超时 → 任务栏闪烁兜底。
- V1.1（实验性 / 尚未稳定）：多选问题 toast（编号输入）。
- V2（计划中）：完全自包含打包（无需安装 .NET 运行时）和/或后台激活，让 toast 按钮无需前台激活即可直接提交。

License

MIT