session-notify/CHANGELOG.md

变更记录

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

v1.0.8

• 修复：授权与提问两类提醒从来不会弹（只有「会话已完成」会弹）。原因不是判据写错了，而是投递前的「是否还值得提醒」那道闸门用错了事实：
  • stillWorth 原本对所有提醒都要求「会话已经不在运行」，可待处理请求恰恰出现在会话仍在运行的时候——客户端的 running 只镜像宿主的 api-session/status，和有没有待处理请求是两件独立的事（dsh-client-ui-session 的 observeRunning 就是这么写的），于是每条授权 / 提问提醒都在 400ms 确认窗口结束时被静默丢掉；
  • 更糟的是丢之前 pendingNotice 已经记下了这个请求，所以它再也不会被重新排进队列——同一请求只报一次的规则反而变成了"一次都不报"。
  • 现在两类提醒用各自该问的问题：待处理请求问「它还在等吗」（请求被你自己答掉就不提醒，还在就提醒，不看运行状态），完成提醒仍问「这一轮真的停下来了吗」（在确认窗口里又跑起来就不提醒）。
• 修复：计划确认（plan-review）的文案从 v1.0.1 起就是死代码——copyFor 先判断 kind === 'question'，而计划确认正是以 kind: 'question' 入队的，于是「计划正在等待你确认」永远走不到，实际显示的是提问那段文案。现在先看判别符，计划确认用自己的文案，与 README 的说明一致。
• 投递节流不再丢待处理提醒：1.5 秒的洪泛保护原本会直接吃掉被拦下的提醒，现在待处理请求被拦下时会回到队列、下一个 tick 重试（只有你能清掉它，所以它一直是欠你的）；完成提醒保持原有的丢弃语义，多个会话同时结束仍然不会刷屏。
• 重新设计插件页（插件 → 会话通知）：原来是一段孤立说明 + 四段标题与行标题同字号的段落，状态区把四句话和按钮挤在一行里。现在：
  • 顶部一句「提醒是怎么送出去的」，下面三组：提醒内容 / 系统通知权限 / 运行状态，组标题加粗，组内是「左侧对象 + 右侧唯一控件」的列表，行之间用细线分隔；
  • 权限状态带一个小圆点（绿=已开启，黄=未授权，红=被系统关掉，灰=当前环境不支持），下面一行按情况给出该去哪授权或该按钮验什么；
  • 运行状态改成键值对照表（窗口状态 / 会话监听 / 最近一次投递 / 待补发提醒），最近一次投递拆成「时间 · 通道」加下一行提醒类型，不再是四个句子堆在一个格子里；
  • 「测试提醒」独立成行右对齐，按钮区分主次（未授权时的「允许通知」是主按钮），行高与圆角统一。
  • 字典随之增删：新增 config.diag.watch、config.diag.replayValue，config.diag.replay 改成短标签「待补发提醒」、config.diag.replayNone 改成「没有」，两个字典键集合仍然完全一致，没有死键。
• 测试从 36 条增加到 39 条：新增「待处理请求放着 running: true 也照样该提醒」的回归用例（这条如果早就有，v1.0.7 之前就能发现上面那个 bug）、计划确认文案用例，并把页面渲染测试改到新的结构与文案上。

v1.0.7

• 重构：客户端源码拆成模块，client.js 从「手写文件」变成「构建产物」。原来的 client.js 是 1452 行单文件，通知引擎、轻弹窗、插件页、观察器、字典、样式、图标全塞在一个 apply 里，改任何一处都要在同一个文件里上下翻。现在：
  • src/client/core/ 是行为：observe（一轮派生）、delivery（通道决策、节流、400ms 确认窗口）、system-channel（系统通知与平台回执）、replay（回前台补发）、toasts（弹窗栈与计时）、actions（两个测试按钮、权限请求、开关）、以及 copy / session / storage / store / log；
  • src/client/ui/ 是界面：ToastLayer、KindRow、ConfigSection、NotifyObserver、icons、styles、hooks；
  • src/client/i18n/ 是字典与翻译器，src/client/platform.js 是浏览器与平台事实，src/client/plugin.js 是组合根（建 store、装配模块、注册三个 slot），src/client/index.js 是构建入口。
• client.js 仍然是包根那一个文件，安装路径与发布清单都没变：exports、files、main、icon、dsh 与 cordis.patch.yml、locale/ 全部原样，使用者依旧零依赖、零构建。
• 新增 scripts/build-client.mjs（esbuild）：把 src/client/** 打包成一个自包含单文件，并校验它仍然满足注册契约（只有一个 factory、require('react') 落在 factory 内、没有顶层 import/export、除了 react 不再向模块表要别的模块）。这一步无法省略：客户端模块系统只交给插件一个自包含 bundle，factory 里的 require 不能 require 同一个包里的相对文件。
• 新增 tests/（pnpm test，用 node --test，无第三方依赖）：26 个纯函数单测（文案、会话派生、存储、字典与翻译器）、4 个产物测试（注册 id、factory 返回值、apply 在没有 DOM 的 Node 里也能跑通、产物与 src/** 是否一致）、6 个渲染测试（用一份最小 React 替身渲染插件页与轻弹窗，验证重构后的 props 装配：开关的选中态、诊断行、按钮回调、观察器的健康上报）。以后改完源码忘了重新构建，测试会直接失败。
• 维护者现在需要跑一次 pnpm install（唯一 devDependency 是 esbuild）；使用者不需要。README 的安装说明按这个区分改写了，并新增「仓库结构」一节。
• 行为未改：三类提醒的判定、通道选择、节流与确认窗口、补发与去重、开关的存储键、CSS 全文与 dsn-* 类名、全部字典键与文案都逐字保持（构建产物与 v1.0.6 的字符串逐条比对通过，样式表 4615 字节完全一致）。
• 顺带记录一个本次没有修的既有缺陷：body.planReview（「计划正在等待你确认」）在 v1.0.6 里已是死代码——copyFor 先判断 kind === 'question'，而计划确认正是以 kind: 'question' 入队的，所以计划提醒实际显示的是提问那段文案。修它要调整判断顺序、属于行为变更，因此这次只把现状写进 src/client/core/copy.js 的注释，并在 tests/unit/copy.test.js 里钉住当前输出。

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。