Kevin87654/dsh-away-notify

README 摘要

dsh-away-notify DeepSeek Harness（DSH）插件： 当任务完成、而你又不在 DSH 界面时，向 Windows 发送系统通知（右下角 Toast）。 场景：你给 DSH 派了一个长任务，然后切去别的网站刷视频或把窗口最小化。任务做完时，Windows 右下角会弹出「DSH 任务完成」，不用再盯着界面干等。 如果你正盯着 DSH 界面，任务完成时 不会 打扰你 —— 只有你离开界面时才通知。 功能 - ✅ 只在离开界面时通知 ：页面隐藏（切走/最小化）且任务完成 → 弹系统 Toast；你正在看页面 → 不弹 - ✅ 任务完成检测 ：监听 agent/status （running → idle 翻转），浏览器后台节流也不影响 - ✅ Windows 原生通知 ：PowerShell 5.1 + WinRT Toast API，右下角标准样式，自动注册 AUMID，零依赖 - ✅ 设置卡片 ：设置 → 通用 →「任务完成通知（离开界面时）」，含总开关与「测试」按钮 - ✅ 可配置 ：总开关、是否提醒子代理会话（ /.dsh/plugins/away-notify.json ，改配置即时生效） 安装 然后重启 dsh web 使插件生效（bundle 插件需要重启加载）。 从源码安装（开发用） 配置 配置保存在 /.dsh/plugins/away-notify.json （默认值如下）： 配置 默认 说明 enabled true 总开关。关闭后不再弹任何通知 includeSubagents false 是否也提醒子代理（subagent）会话；默认只提醒主会话 也可通过设置卡片里的开关直接切换（会写回该文件）。 工作机制 - 完成检测在 Host：不依赖浏览器 JS 是否在跑（最小化/后台节流均无影响）。 - 可见性检测在 Client：只有浏览器知道 visibilityState ；页面每次切换可见/隐藏时上报一次。 - 通知在 Host 执行：浏览器最小化、切到别的应用、甚至锁屏都能弹。 日志 诊断日志写入 %TEMP%\dsh-away-notify\notify.log （JSON 行），记录启动、可见性上报、通知触发等事件。 测试 ✅ 2026-08-18 全链路测试通过 ：测试通知、设置卡片、Host 完成检测、页面可见性上报、端到端（切走 + 任务完成 → 弹通知）均验证通过。 - 设置卡片里的「测试」按钮：立即弹一条「DSH 任务完成」测试通知（需插件已启用）。 - 或命令行： Invoke-RestMethod -Method Post http://127.0.0.1:3080/away-notify/test - 端到端：给 DSH 派任务 → 切走页面（切标签页/最小化）→ 任务完成时右下角弹「DSH…

分类