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 plugin --profile web add dsh-away-notify
然后重启 dsh web 使插件生效（bundle 插件需要重启加载）。
从源码安装（开发用）
dsh plugin --profile web add link:../dsh-away-notify
# 或直接把本目录加入 profile 的 package.json 依赖 + dsh.profile.bundles
配置
配置保存在 ~/.dsh/plugins/away-notify.json（默认值如下）：
{
"enabled": true,
"includeSubagents": false
}
| 配置 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关。关闭后不再弹任何通知 |
includeSubagents |
false |
是否也提醒子代理（subagent）会话；默认只提醒主会话 |
也可通过设置卡片里的开关直接切换（会写回该文件）。
工作机制
浏览器（Client 半片） DSH 后台（Host 半片）
──────────────────── ──────────────────
visibilitychange 事件
↓ 上报 hidden 状态
POST /away-notify/visibility ──────► 维护 hidden 标志
监听 agent/status
running→idle 翻转 = 任务完成
且 hidden = true？
↓ 是
PowerShell 弹 Windows Toast
（右下角「DSH 任务完成」）
- 完成检测在 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 任务完成」；盯着页面时任务完成不打扰。
开发注意事项
- Client 半片改动生效方式：dsh web 从 profile 的实体拷贝伺服 client bundle（
~/.dsh/profiles/web/node_modules/dsh-away-notify/，file:依赖安装时被拷贝而非软链）。改lib/client.js后需同步拷贝到该路径，再刷新页面（服务端Cache-Control: no-cache，刷新即生效）。Host 半片改动需同步拷贝 + 重启 dsh web。 - Cordis
ctx.effect陷阱：ctx.effect(回调)立即执行回调，只有回调返回值才是卸载时的清理函数。注册 DOM 监听器必须写成ctx.effect(() => () => removeEventListener(...))，否则监听器注册即被移除（第一版曾因此导致切走上报失效，已修复）。 - 诊断日志：
%TEMP%\dsh-away-notify\notify.log（JSON 行，含 start/visibility/complete-hidden-false/notify/test/error 事件），排查先看它。
许可证
MIT
