weekitmo/dsh-notify

README 摘要

dsh-notify English 简体中文 DeepSeek Harness 的任务状态通知插件。它在任务运行、完成或异常时，通过系统通知、浏览器 Tab 标题和左侧会话列表提供明确的状态提示。 功能 - 系统通知 ：仅在顶层任务全部收敛后发送完成、错误、中止、阻塞或 Token 限制结果；可在设置中单独关闭某一类。 - 钉钉机器人 ：配置 Access Token 与 Signing Secret，独立选择“成功 / 完成”或“失败 / 中止”消息，并支持免打扰和结束后错过消息汇总。 - Tab 状态 ：空闲时显示最近工作区会话标题；运行中显示 spinner 和会话数；完成或异常后显示未读结果计数。 - 侧栏状态灯 ：会话完成且尚未查看时显示绿色圆点；错误、中止、阻塞或 Token 限制显示红色圆点。打开会话后清除。 - 状态兼容 ：执行中的会话保留 DSH 自带 loading，等待审批或回答时保留原生警告状态。 - 可配置 ：可在 WebUI 的 设置 通知 中控制通知权限、Tab 动效、favicon、spinner、侧栏状态灯和结果类型。 架构 dsh-notify 是标准的 Cordis Host/Client 插件，不修改 DeepSeek Harness 核心。它使用 DSH 提供的 Session 事件、Session Projection、Client Runtime 和 UI Slot 扩展点；这里不是 packages/hooks/ 的外部 CLI hooks 适配器。 Host 入口通过 ctx.sessionProjections.register(...) 注册投影，并由协调器同时监听 Session、Agent 与 Job 生命周期；Client 入口订阅 sessions.list ，每次快照变化都重新评估候选。两端都用可取消的短收敛窗口处理 job settle 后同步 followup 唤醒主 Agent 的竞态。 子代理 Session 带有 origin: 'subagent' 。Host 的钉钉出口和浏览器端的系统通知、Tab 未读结果、侧栏状态灯都会在候选进入最终结果前过滤它，因此当前没有“子代理成功通知”开关。运行中的子代理仍折叠进可见父会话的运行计数。 turn/end 只产生待定候选，不直接表示完成。只有顶层主会话已 idle、该任务及其子代理后代没有 running/stopping job、没有运行中的子代理后代、没有 active 自动 goal，并且该轮没有未收敛异步委派时，候选才在短收敛窗口后发布。 de coi dispatch 、后台 subagent/bash、workflow/goal 等仍有未收敛委派的启动轮不会发布；如果同一轮已明确等待并收集全部终态，则该轮仍可作为最终汇总发布，…

分类