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
