dsh-taskdone-notify

DSH 会话提醒插件 / Session alerts for the DSH web GUI.

在两个关键时刻提醒你:

时刻	触发条件
任务完成	根 agent(交互式会话,不含 subagent 子代理)由运行中转为空闲——这一轮任务已完成,正在等你
等你回答(v1.1 新增)	agent 调用 ask_user_question 工具提问——轮次阻塞中途,agent/status 仍是 running,完成提醒不会覆盖此场景

每个时刻都走三个通道:

通道	机制	覆盖场景
Windows 系统通知	Host 侧直接调用 Windows PowerShell + WinRT Toast API 弹系统通知(进入 Windows 通知中心)	浏览器全部关闭也有效
浏览器通知	Web Notification API;页面右下角有一次性「开启系统通知」授权按钮	浏览器开着、DSH 页面在后台标签
页面内 toast	右下角提醒卡片:任务完成为绿点/10 秒消失,等你回答为黄点/20 秒消失	页面正打开时

点击任一提醒即可跳转到对应会话。

安装 / Install

dsh plugin --profile web add link:D:/AICODING/DSH/dsh-taskdone-notify

然后重启 web 服务(重启后生效)。

安装到其他机器:把本目录放过去,改用路径安装,或发布到 npm 后:

dsh plugin --profile web add @muziixzx/dsh-taskdone-notify

组合配置 / Composition config

cordis.patch.yml 中的插件行支持一个开关:

键	默认	说明
osToasts	true	是否从 Host 进程弹 Windows 系统通知(浏览器通道不受影响)

工作原理 / How it works

• Host 半(lib/index.js,标准 Cordis 插件)
  • 任务完成:监听 agent/status 事件;仅统计「先见过 running 再转 idle」的根 agent,避免 agent 创建时的初始 idle 误报、避免工作流子代理刷屏;激活时对已在运行的 agent 做快照,插件随服务启动时也能正确补报进行中的轮次;
  • 等你回答:挂 tools/execute 环绕分发钩子,识别 ask_user_question 调用——该钩子在 pre-execute 审批之后、真正分发之前触发,此时问题卡片必然出现,不误报;通知后立即 next(),绝不阻塞或改写分发;从 arguments.questions[0] 取问题标题作为提醒正文;
  • 通过 sessionQuery.readTitle 取会话标题(仅提取叶子字段);
  • OS 通知以 argv 数组调用 PowerShell,正文经注入安全处理(剥除引号/控制字符、截断 80 字符);
  • GET /api/taskdone-notify/poll?since=<游标> 提供游标式轮询(环形缓冲 50 条,条目带 kind: task|question):每个浏览器各自维护游标,服务端重启后客户端自动重新基线,局域网多访问端互不抢通知。
• 浏览器半(lib/client.js,shell module-loader 格式,零依赖纯 DOM)
  • 每 2 秒轮询;首次轮询只基线不回放(打开页面不会重播历史完成);
  • toast 卡片按 kind 区分视觉(绿点/黄点)与停留时长(10s/20s)、浏览器通知区分标题(tag 常量去重,多标签页不叠加)、授权引导 pill;
  • 点击经 sessions 服务跳转会话;挂载/轮询失败只记日志,绝不拖垮页面。

限制 / Notes

• OS 系统通知弹在 DSH 服务端所在机器(dsh-lan 瘦终端模型下即服务器本机);局域网访问端请用浏览器通知通道(点一次授权)。
• Windows 专注助手/勿扰模式可能拦截系统通知,请在系统设置中放行。
• 后台标签页的浏览器通知受浏览器节流(约每分钟一次),近实时通知由 OS 通道与页面内 toast 保证。
• 「任务完成」判定为该会话本轮 agent 转入空闲,无论以正常回复、出错还是中止结束。

License

Apache-2.0