dsh-plugin-notify

⚠️ AI 生成项目声明

本项目（代码、脚本、文档）由 AI 辅助生成，仅用于学习和参考。 使用前请自行阅读、审查并充分测试代码，按需修改后再部署到你的环境。

dsh Web GUI 的 Windows 通知插件：当 agent 不再运行时（任务完成 / 被停止 / 出错 / 停下来等你选择 / 会话被关闭），弹一条 Windows 原生 Toast 提醒你回来看结果。适合发起绘画、生成等长任务后离开电脑的场景。

• 纯 host 端插件：零运行时依赖、零构建步骤，普通 ESM；
• 通知常驻：scenario="reminder"，直到你手动关闭；
• 位置标注：通知正文显示 工作区「…」 · 会话「…」，一眼看出是哪个工作区的哪个会话；
• 系统托盘：任务栏右下角常驻 dsh 鲸鱼图标，双击/右键「打开 dsh」、右键「关闭进程」终止 dsh 后台，dsh 退出后图标自动消失。

目录

• 触发条件
• 安装
• 配置
• 测试
• 排障
• 相关文档

触发条件

场景	信号	通知
任务正常完成	agent/status running→idle + turn/end: completed	「dsh · 任务完成」
你点了停止 / 被中止	turn/end: aborted	「dsh · 任务已停止」
执行出错	turn/end: error	「dsh · 任务出错」
达到输出上限	turn/end: max-tokens	「dsh · 达到输出上限」
agent 停下来让你选择	未配对的 ask_user_question 工具调用	「dsh · 在等你选择」
运行中的会话被关闭	agent/disposed	「dsh · 会话已关闭」

位置标注说明：每条通知正文带一行 工作区「…」 · 会话「…」。 工作区取 workspaceRegistry 中该会话的归属标题（兜底用会话 cwd 的目录名）， 会话取 sidebar 显示的会话标题（无标题时兜底用会话 id 短号，如 #a1b2c3d4）。 两个服务都不可用时该行自动省略，不影响通知。