dsh-ask-alert · 提问提醒

DSH 插件：助手向你提问、等待审批或一轮任务结束时，在桌面弹出置顶提醒卡片，并闪任务栏、响提示音；问题没回答会按间隔重复提醒。

English | 中文

为什么需要它

在 DeepSeek Harness 里，助手提问（ask_user_question）后会一直等你回答。如果你正在别的窗口看视频、看直播或者做饭，很容易整轮对话卡在那里。

常见的做法是弹 Windows 原生通知，但实际经常失效：

• 系统「通知」总开关被关掉时（ToastEnabled=0），toast 调用返回成功但什么都不显示；
• 「专注助手 / 免打扰」会把横幅静默掉；
• 不少通知类插件用 powershell -File x.ps1 拉起脚本，而 Windows PowerShell 默认执行策略是 Restricted，脚本直接被拒绝，插件静默失败，界面上没有任何报错。

本插件不依赖系统通知开关：它自己画一张置顶卡片放在屏幕右下角，不需要通知权限，也不会抢走当前窗口的焦点。

功能

• ✅ 提问提醒：助手调用 ask_user_question 时立即提醒
• ✅ 审批提醒：有操作等待批准/拒绝时提醒（可关）
• ✅ 任务完成提醒：一轮任务结束、助手转为空闲时提醒（可关）
• 🔁 重复提醒：提问/审批未回答时，每 20 秒再提醒一次，默认最多 5 次（可调）
• 🪟 置顶卡片：右下角圆角卡片，ShowActivated=false 不抢焦点，13 秒自动消失，点一下即可关闭
• 💡 任务栏闪烁：FlashWindowEx + FLASHW_TIMERNOFG，DSH 在后台时会一直闪到你切回去
• 🔔 提示音：系统通知音 + 独占音效，防止专注助手静音
• 🧹 不堆叠：新提醒会自动关掉上一条卡片

安装

dsh plugin --profile desktop add github:bgfhsnm/dsh-ask-alert

也可以走图形界面：插件 → 添加插件 → 填 github:bgfhsnm/dsh-ask-alert → 立即启用。

安装后无需重启即可生效（Host 半身只监听事件，不注册 service / tool / settings）。

需要 Windows 10/11 与桌面会话。插件本身不依赖 npm 依赖，无需构建。

工作方式

事件	触发内容
user-questions/request	助手提问 → 立即提醒，并在未回答期间重复
approval/request	等待批准/拒绝 → 提醒，并在未决期间重复
agent/status（idle，仅根会话）	一轮任务结束 → 单次提醒

提醒由 notify.ps1 执行（-ExecutionPolicy Bypass，兼容默认 Restricted 的机器）：WinRT toast（尽力）→ 任务栏闪烁 → 提示音 → 置顶卡片。

%TEMP%\dsh-ask-alert.pid 记录当前卡片进程，保证同一时间只有一张卡片。

配置

默认值即可直接使用。需要定制时，在 profile 的 cordis.patch.yml 里覆盖对应行：

- id: dsh-ask-alert
  config:
    askTitle: 'DSH · 有个问题等你回答'
    askBody: '助手在等你回复，请切回 DeepSeek Harness。'
    approveTitle: 'DSH · 需要你确认'
    approveBody: '有一个操作正在等你批准或拒绝。'
    doneTitle: 'DSH · 任务完成'
    doneBody: '这一轮任务已结束，可以回来查看结果了。'
    repeatSeconds: 20      # 重复提醒间隔，0 = 只提醒一次
    maxAlerts: 5           # 最多提醒次数（含第一次）
    onApproval: true       # 审批提醒开关
    onDone: true           # 任务完成提醒开关
    showProject: true      # 在正文前加会话目录名

修改后重启 DSH 生效。

只想保留提问提醒、不要「任务完成」打扰：

- id: dsh-ask-alert
  config:
    onDone: false

自测

node selftest.mjs   # 用 mock ctx 跑事件逻辑，10 项断言

直接验证提醒链路（会真的弹一张卡片）：

powershell -NoProfile -ExecutionPolicy Bypass -File notify.ps1 `
  -Kind ask -Title 'DSH · 测试' -Body '看到这张卡片说明链路正常' -Sound 1

已知限制

• 仅 Windows；依赖桌面会话（服务/无头会话里没有可显示的窗口）。
• 任务栏闪烁需要能找到标题包含 DeepSeek 的窗口；DSH 窗口标题被改掉时只会弹卡片、不闪任务栏。
• 卡片固定出现在主屏工作区右下角，双屏/自定义缩放下的位置未做单独适配。
• 中文 .ps1 必须以 UTF-8 with BOM 保存，否则 Windows PowerShell 5.1 会按 GBK 解码并报假语法错误（仓库内文件已带 BOM）。

License

MIT