dsh-notify-win

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

English | 中文

📸 截图

任务完成

上下文压缩完成

单选问题

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 off`r`ncorepack pnpm %*`r`n"
   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