session-notify/CHANGELOG.md

变更记录

版本说明按倒序排列。提交信息遵循 CONTRIBUTING.md 的单行规范，因此每次改动"为什么这样改、影响面是什么"记在这里，而不是提交信息里。

v1.0.6

• 修复：窗口不在前台时，提醒有可能一次都看不到。排查证据：一次真实投递（会话 17:52:29 结束）在插件页留下 09:52:30 · 系统通知——09:52:30 是 UTC，本机时间是 17:52:30；而 Windows 的通知平台记录 LastNotificationAddedTime 停在 70 分钟前。也就是说 new Notification() 没抛错，但构造函数成功不等于通知真的弹出来了，加上系统通知的气泡只存在几秒，人不在电脑前时它等于没送达。这一版不再把"发出去"当成"收到了"：
  • 每条系统通知都订阅 show / error：系统是否确认显示会写进插件页的「最近一次投递」，不再只报"系统通知"三个字；
  • 凡是在窗口不在前台时投递的提醒，都会在窗口回到前台的那一刻用应用内轻弹窗补发一次。同一会话同一类只保留最新一条，超过 30 分钟不再补发；"正在看的会话不打扰"这条规则不适用于补发，因为它发生的时候你并不在看。唯一的例外是系统确认气泡已弹出、且你在 20 秒内就回到窗口（气泡还在屏幕上，不再重复）；
  • 点掉系统通知本身（click）会取消对应的补发，不重复打扰。
• 修复「最近一次投递」的时间显示成 UTC（比本地时间早 8 小时，17:52 显示成 09:52）的问题，现在显示本机时间。
• 修复确认窗口的队列会把提醒永久卡住的问题：一次确认窗口只投递一条，剩下没轮到的会自己再排一次（以前排完之后队列里再没人触发，后面的提醒就被吞了）。
• 系统通知对象改为有界持有引用：防御性改动，避免显示还没落定时对象被回收（实测中保留引用与否都能送达，所以这不是那次丢失的原因）。
• 插件页「运行状态」新增一行：还有几条提醒在等你回到窗口时补发。

v1.0.5

• 修复：应用在后台时不发系统通知。前台/后台以前只靠 window 的 focus/blur 事件记住，桌面外壳里 blur 可能不到，插件就一直以为窗口在前台，于是走了轻弹窗分支（而用户没在看，表现就是完全没有通知）。现在每次投递都现读 document.visibilityState 与 document.hasFocus()，任一表示不可见即走系统通知；观察器订阅的事件只是让重算更及时，不再决定通道。
• 系统通知构造失败时降级：改用轻弹窗，并把被拒原因写进插件页，不再静默失败。
• 插件页新增诊断：窗口当前状态（前台/后台，即会走哪条通道）、观察器健康、最近一次投递的通道与时间；「测试系统通知」按钮直接走系统通道（前台也照发），用来单独验证系统通知是否可用。
• 修掉日志前缀重复（session-notify: session-notify:）。

v1.0.4

• 配置块去掉重复：插件页顶部已经有 DSH 渲染的插件标题与描述，原配置块又写了一遍标题和几乎一样的说明。现在这一段直接用一句「提醒是怎么送出去的」开头，随后进入设置项。
• 移除未使用的字典键 config.title / config.note，保证字典里没有死键。

v1.0.3

• 设置从「设置 → 通用」移到插件自己的介绍页：注册 plugins.bundle.config（key 取包名），与官方 dsh-experimental-voice-input-bundle 用的是同一个口子；通用设置里不再有本插件的行。
• 应用内轻弹窗改成标题 + 描述两行：标题是提醒类型（会话已完成 / 需要授权 / 需要回答），描述是会话题目与细节；关闭按钮从 18px 放大到 28px 的方形热区，「查看」改成有 hover 背景的文字按钮，整条浮窗 hover 时暂停自动消失。
• 三个开关改为存浏览器本地（localStorage），重开页面、重装插件都保留；仍然不写 DSH 的配置文件。
• 插件页配置分四段：说明、提醒内容（三个开关）、系统通知权限、运行状态。

v1.0.2

• 补上 ctx.locale.register('session-notify', { zh, en })：没有注册时 locale.bind(ns) 会把 key 原样返回，界面上就显示成 settings.title 这样的原始键。
• 字典兜底与 locale 兜底同时保留：缺框架的 t、或 locale 服务没保存注册，都不会显示原始键。
• 快照语言字段改为真实字段 snapshot.active。

v1.0.1

• 首个发布版本：会话完成 / 需要授权 / 需要回答三类提醒。
• 窗口不在前台走系统通知（Windows / macOS / Linux 同一条渲染进程通道，无平台分支）；窗口在前台走应用内轻弹窗；正在看的那个会话完成时不打扰。
• 只对「运行中 → 空闲」的转变提醒，同一会话同一轮只报一次，同一待处理请求只报一次；子智能体会话与空白会话跳过；多个会话同时完成有 1.5 秒节流，完成提醒前有 400ms 确认窗口。
• 修复：无渲染观察器原先挂在 sidebar.panellist，而该 slot 的宿主会把每个条目的 id 当作一个左侧面板按钮，导致左侧多出一行空面板并挤坏侧边栏；现改挂通用浮层 shell.overlay。