Suef-666/dsh-tab-alert

README 摘要

dsh-tab-alert —— dsh 任务栏提醒插件 + 实时事件源（中间件） 双重角色 ： 1. 任务栏提醒 ：当 dsh 在后台工作时需要你处理某事，让浏览器在 操作系统 任务栏 上提醒你——页面失焦/隐藏时弹一条 静音 系统通知，Chrome/Edge 在 Windows 上随即把任务栏图标闪烁成橙色；Linux 下表现为通知 + Dock 脉冲。 2. 实时事件源 / 中间件 ：订阅全量会话事件流，把归一化的实时任务状态通过 WebSocket（/tab-alert/stream）转发给外部消费方—— 推荐与 dsh-pet 桌宠 插件搭配食用 ，也可供其它插件 / 独立客户端复用（见下「作为中间件使用」）。 触发场景（仅这些"需要用户操作"的行为，普通回复不提醒） 事件 来源（官方快照） 模型提问 SessionSummary.pendingInteraction === 'question' （ask user） 授权请求 pendingInteraction === 'approval' 方案审查 pendingInteraction === 'plan-review' （exit plan mode 评审） 目标完成 goal 投影 phase → 'complete' 目标失败/阻塞 goal 投影 phase → 'blocked' 后台任务完成 jobsBySession[].status → 'completed' 后台任务失败 jobsBySession[].status → 'failed' 会话在别处完成 SessionSummary.completed false→true（未查看的已完成会话） dsh 完成当前回合 SessionSummary.running true→false（普通任务干完活停下） 所有触发都是 边沿检测 （状态迁移瞬间触发一次，去重直到条件解除）， 首帧只做基线，连接重连不会追发刷屏。 工作机制 - 为什么能触发任务栏闪烁 ：后台标签页弹出 Web Notification 时，浏览器 （Chrome/Edge）会显示系统通知并闪烁任务栏图标——这是浏览器标准行为， 无需修改浏览器；本插件只负责在正确的时机触发它。 - 权限 ：首次触发时请求一次 Notification 权限（授权框本身在后台也会闪一次）； 用户拒绝后插件静默（仅控制台一条提示）， 不做页内降级 。 - 去重 ：同一提醒（ tag = 事件 id ）只闪一次；新事件才再次闪烁。 - 用户回页面 ：视为已看到，不再提醒。 - 不越界 ：只订阅官方快照、只创建 Notification、不改标题/图标/其它插件状态， 卸载即清理；同时把事件发布为旁观式 tab-alert/attention （cordis 事件）， 其它插件可观察…

分类