后续 PR 计划：动效收尾、刘海式圆滑交接与“灵动提示”

[Koooki3]

最近陆续提了几个 PR，这里汇总一下后续计划，方便大家提前了解，也欢迎对方向、拆分方式提意见。

已合入

• Claude 额度：保存最近一次联网读取，重启后被限流时仍显示 Fable 等额度 #34 Claude 额度：保存最近一次联网读取，重启后被限流时仍显示按模型的额度
• 动效基础：修正缓动曲线方向，统一曲线与时长 #35 动效基础：修正缓动曲线方向，统一曲线与时长

审核中（都基于 dev，CI 已通过）

• 安装到自定义目录时收紧目录权限 #37 安装到自定义目录时收紧目录权限
• 网易云完整控制：连接失败时如实说明调试端口仍开着 #38 网易云完整控制：连接失败时如实说明调试端口仍开着
• 自定义来源只允许 HTTPS，HTTP 仅限本机地址 #39 自定义来源只允许 HTTPS，HTTP 仅限本机地址
• 歌词查询只跟随同一主机的 HTTPS 重定向，并限制响应大小 #40 歌词查询只跟随同一主机的 HTTPS 重定向，并限制响应大小
• 读取会话记录时复用缓冲区，并限制单行长度 #41 读取会话记录时复用缓冲区，并限制单行长度
• 开关机动效与收起形态动效 #42 开关机动效与收起形态动效

#37–#41 是独立的小修复，改动的文件互不重叠，可以按任意顺序合入。

接下来（按依赖顺序，每个 PR 等前一个合入后再提，保证每个 PR 只包含自己的改动）

1. D：AI 用量页与媒体页动效（依赖 开关机动效与收起形态动效 #42）：切页、展开动效与系统监控页保持一致，并修复切页时画面被放大、下移的问题。
2. E：弹出层开合动效（依赖 D）
3. F：展开面板贴顶时的刘海式圆滑交接（依赖 开关机动效与收起形态动效 #42，可与 D 并行）：面板贴着屏幕顶边时，与屏幕边缘用圆弧过渡，看起来像从刘海里长出来。这是可选外观，默认行为不变；如果维护者觉得不适合放进主线，也可以不合。
4. 灵动提示（新功能，依赖 D、F）：把系统通知以岛的形式显示在屏幕顶部，并随当前主题变化外观。
   • 来源：Windows 通知、命令行工具 brim-notify（本机管道），以及 WSL 里 Linux 程序的通知（通过 WSL 内的小代理接收 D-Bus 通知）。
   • 功能：最近通知页（本地加密保存，可设置定期清空）、通知设置、快捷键与托盘入口；额度提醒和切歌提示也并入同一个调度。
   • 默认关闭，WSL 部分需要单独开启。
   • 改动较大（约 7,400 行，含测试），计划拆成 8 个依次叠加的小 PR，每个都能单独构建、测试全部通过，中间阶段功能默认关闭、没有入口，用户看不到：
     • N1 通知协议（帧、校验、命令行解析）
     • N2 通知核心（模型、调度、加密历史、几何、设置项）
     • N3 D-Bus 通知协议库
     • N4 WSL 通知代理（Linux 端）
     • N5 Windows 接收与存储（通知中心、Windows 来源、本地管道、brim-notify）
     • N6 岛上展示（通知窗口、主题外观、图标）
     • N7 最近通知页、设置页、快捷键与托盘
     • N8 WSL 桥接、可选身份包、安装与发布脚本、文档

想听听意见

• 灵动提示按 N1–N8 这样拆分是否方便审核？还是更希望少几个、每个稍大一些？
• F（刘海式圆滑交接）是否适合进主线，还是更适合作为可选主题效果？
• Linux版本是否实现？如何实现？这些问题目前也在考虑范围之内。
• 版本号由维护者决定：每个 PR 正文里附了建议的中英文发版条目，没有改动 releases/。

[MoFeng2223]

linux的版本我目前没有实现的打算 因为我平时并不爱使用linux 你可以开一个自己的仓库由你自己主要维护

[MoFeng2223]

不过wsl是可以支持的

[MoFeng2223]

版本号的话，我目前没有特别的计划，一般就是我觉得验得差不多了，我就会发一个版本出去。之前主要是因为你提交内容太快了，我没有时间拉到本地做详细验证，所以决定发一个测试的版本。

之后对于release不用特别维护，我会在发版本之前统一整理一遍。

如果需要你自己写版本描述的话我会在pr或者讨论中告诉你，你觉得这个方式怎么样？

[MoFeng2223]

提示的功能可以少放几个PR
N1 通知协议（帧、校验、命令行解析）
N2 通知核心（模型、调度、加密历史、几何、设置项）
N3 D-Bus 通知协议库
比如这几个就可以合在一起 从功能上划分PR就好了 比如说接管哪些来源的通知 这样的话功能比较好验证 比如说最开始的时候合并windows通知的功能 我会着重看它的通信怎么样实现 用户的权限怎么样请求 设置页面怎么样设计 然后再增加wsl brim-notify之类的 反正可以最新所欲一点，只要是作为完整的功能就可以

[Koooki3]

谢谢回复，几点都明白了：

发版说明
这个方式很好。之后 PR 正文里就不再附建议的发版条目，也不会动 releases/；需要我写版本描述时你在 PR 或讨论里说一声就行。

Linux / WSL
我这边也没有做 Linux 版 BrimDeck 的打算。之前提到的 Linux 部分只是 WSL 桥接：在 WSL 里跑一个小代理，把 Linux 程序发出的通知（D-Bus）转给 Windows 上的 BrimDeck 显示，本身不在 Linux 上运行界面。

灵动提示的拆分
按你的建议改成按功能划分，每个 PR 都是可以单独验证的完整功能，依次提交：

1. Windows 通知：读取 Windows 系统通知并在岛上显示。包括：
   • 通知核心（调度、最近通知加密保存）；
   • 读取通知的权限请求流程（Windows 的“通知访问”授权，以及没授权时怎么提示）；
   • 岛上的通知外观（跟随当前主题），配额提醒和切歌提示并入同一个调度，不会互相打断；
   • 最近通知页、设置页、快捷键和托盘入口。
     功能默认关闭，在设置里打开。
2. brim-notify 命令行：本机命名管道和 brim-notify.exe，脚本、构建工具等可以直接往岛上发通知。
3. WSL 通知：上面说的 WSL 桥接，WSL 部分需要在设置里单独开启。

想先确认一点：Windows 通知目前用轮询读取（约每 2.5 秒检查一次）。另外我做了一个可选的“事件模式”：注册一个身份包后可以即时收到通知，但注册需要打开 Windows 的开发者模式，有一定安全代价。这个你希望放进第 1 个 PR、单独提，还是先不要？

#46（刘海式圆滑交接）
理解，展开面板用直角和收起的刘海做区分这个思路很清楚，我会关掉 #46，也不做成开关。

[MoFeng2223]

另外我做了一个可选的“事件模式”：注册一个身份包后可以即时收到通知，但注册需要打开 Windows 的开发者模式，有一定安全代价。这个你希望放进第 1 个 PR、单独提，还是先不要？

可以先提PR，然后我目前还没有研究这个东西，我得看一看是不是必须得这么做，有没有更好的实现方式

[MoFeng2223]

我先简单体验了一下，整体感觉有些奇怪，就是推出这个功能用户体验会不太好

1. Windows 通知会重复提示。所以同一条通知 Windows 右下角弹一次，BrimDeck 又弹一次，两处同时提示，体验有点重复，这会让提出这个功能的必要性有下降。如果把应用的 Windows 通知关掉，BrimDeck 也就收不到了。虽然可以在系统设置里按应用只关闭"通知横幅"、保留"在通知中心显示"，但要逐个应用设置，普通用户很难想到。

2. brim-notify 和 WSL 通知需要发送方主动适配。我主要看了一下Claude Code、Codex 这类工具，他们运行在WSL里面的时候提醒，是发给终端窗口的，不经过 Linux 通知服务，而且 Claude Code 在 Windows Terminal 里默认不发提醒。要让 BrimDeck 收到，都需要用户自己配置 hook 调用 brim-notify。

就是，如果是给ai工具用的可以专门出一个功能，就是会自动去各个工具植入hook在需要审批、回答结束这种场景下提示。但是我们是个通用的提示，这个提示出现和windows右下角的弹窗提示功能几乎重叠。

我不知道怎么表达，这个功能我体验下来目前的感受是没有什么必要性，起码它并不吸引我，我也同样认为让它接管通知是一个很好的方向，但是就目前的功能设计来看，我个人感觉并不好用。

如果能抑制windows的通知就会好一些。

另外还有就是很多常用的应用不走系统通知，这些有什么办法对接吗。

还有目前设置页面的页面设计还有展开面板的设计我觉得也不太美观。不过这是排在第二位的，还是先把用户旅程设计明白。

目前你用这个功能最主要是拿它来干嘛？对于这个功能我还没太想明白，你说说你的用法我也参考参考下？

[MoFeng2223]

https://github.com/WinIslandProject/WinIsland 参考下它的做法呢 这个做法貌似不需要用户打开开发者模式

[Koooki3]

我逐条说说想法和能改的方向。

1. 和 Windows 右下角的横幅重复

这个确实是最大的问题。我做了原型并在实机上试了两种办法：

• 改 Windows 里“显示通知横幅”的开关：行不通。我直接改了 Windows 保存的那项设置，但这个设置不会被立即读取。改完马上发通知，以及 40 秒后再发，横幅都照样弹出。系统设置页面改这个开关时，显然还另外通知了通知平台，这条路没有公开接口。
• 岛上显示后，从 Windows 撤下这条通知：可行，原型已做好并实测。BrimDeck 读到通知、在岛上显示后，用读取通知的同一个接口把它从 Windows 撤下，右下角的横幅随即消失。实机两次测试：一次横幅完全没被录到（250 ms 一帧），一次只露出一帧，岛上都照常显示。

代价有两点：

• 这条通知也会从 Windows 通知中心消失，之后要在 BrimDeck 的“最近通知”里找；
• 因为要先读到才能撤下，横幅仍可能闪现一下，实测在 0.25 秒以内，最坏情况下约 1 秒。

所以原型做成了按应用勾选的选项“收到后从 Windows 撤下”，默认关闭。只有通知真的在岛上显示了才撤下：暂停、锁屏、专注、勿扰、演示，或应用被设为关闭、静音时，通知照常留在 Windows 里。BrimDeck 不改任何 Windows 设置。

2. brim-notify / WSL 需要发送方适配；AI 工具的提醒走的是终端

同意，通用的命令行对普通用户门槛太高。可以按你说的思路，为 AI 工具单独做一个“一键接入”：检测到 Claude Code、Codex 等工具后，替用户在它们的 hook 配置里写入调用 brim-notify 的那一行，覆盖“需要审批”“回答结束”这几种场景，可以随时撤销。brim-notify 保留为底层通道，不再作为面向普通用户的卖点。

3. 很多常用应用不走系统通知（比如微信、QQ）

这类应用来新消息时，一般会让任务栏图标闪烁。Windows 会把“某个窗口在请求注意”广播给 shell 钩子（HSHELL_FLASH），这是公开的接口。BrimDeck 可以在岛上提示“微信 有新消息”，点击打开该应用。拿不到消息内容，但能解决“没注意到”的问题，隐私上也更干净。个别应用（例如有托盘未读数的）以后可以再做专门适配。

4. 不开开发者模式也能即时收到通知（参考 WinIsland）

看了 WinIsland 的源码，它即时收到通知靠的不是身份包：

• 订阅系统的事件日志频道 Microsoft-Windows-PushNotification-Platform/Operational，每发一条 toast，Windows 都会写一条事件；
• 收到事件后，再用 UserNotificationListener 读取这条通知。

它还用了一个未公开的 WNF 信号做补充，这个我没用。

我按这个思路做了原型，并在实机上验证：

• 普通账户就能订阅，不需要开发者模式，也不需要管理员权限；BrimDeck 的状态里显示为 EventLog 模式。
• 延迟：从通知发出到 BrimDeck 读到，中位数约 1 秒（最快 0.1 秒、最慢约 1.2 秒）。事件日志服务大约每秒才把新记录交给订阅者一次，所以没法真正“即时”，但比现在每 2.5 秒轮询一次快。
• 空闲时不耗 CPU。连续来 10 条只读一次，10 条都能读到。
• 风险：这些事件编号不是公开承诺的接口，以后的 Windows 版本可能会变；管理员也可以关闭这个频道。所以保留了兜底：频道被关或出错时，自动退回现在的轮询。

这样就可以去掉需要开发者模式的“事件模式”，或者只把它留给高级用户。

5. 设置页和展开面板的设计

收到，等用户旅程定下来以后，再一起重新整理设置页的结构和展开面板里通知页的样式。

---

如果方向上你觉得可以，我打算按这个顺序调整 #50：

1. 事件日志触发，替换开发者模式的事件模式（原型已实机验证）；
2. 收到后从 Windows 撤下（原型已实机验证）；
3. 任务栏闪烁提示；
4. AI 工具一键接入（也可以单独成一个 PR）。

[MoFeng2223]

我发现了一个好办法 就正常做就好了 不用抑制应用的通知

让用户去这里打开免打扰，就完事了

[MoFeng2223]

还有，你之前说错了

“改 Windows 里“显示通知横幅”的开关：行不通。”这句话不对，windows里面关了就是立即生效的，不会弹出横幅

你那里失败了可能是你的claude code改的沙箱环境里面的通知横幅开关。

还是用这个方案吧，就是brimdeck里面做个开关，是否统一关闭其它应用的系统通知横幅，大概就这个意思，默认关闭，用户打开的话会先保留一份当前应用的通知横幅开关，然后等用户回来关闭brimdeck里面这个开关的时候，帮用户恢复。当然了 中途要是用户自己手动打开了，或者安装了新应用，暂时没想到更好的方案，不过问题不大。

你在你自己电脑再试试呢，

[Koooki3]

确实

我在自己电脑上重新试了一遍，用的是一个测试应用：在 Windows 设置里只关掉它的“显示通知横幅”，保留“在通知中心显示”，右下角就立即不弹了。通知照样进通知中心，BrimDeck 也照常读到，在岛上显示。所以“关横幅、由 BrimDeck 显示”这条路是通的。

之前失败的原因是我改错了地方。我改的是注册表里的 Notifications\Settings\<应用>\ShowBanner。现在的 Windows 11 已经把每个应用的通知设置迁到了系统的通知数据库（wpndatabase.db 的 HandlerSettings 表）里，注册表那份只是迁移前留下的旧数据，改了不会生效。设置页面关横幅，改的是数据库里那一项（s:banner）。

不过这也带来一个问题：BrimDeck 很难替用户批量关横幅，再在关闭开关时恢复。我查到的情况是：

• 设置页面通过系统内部的 Windows.Internal.Notifications.WpnClient 改数据库，这个接口没有公开，签名也查不到，我没找到任何开源项目在用。
• 直接改数据库文件也不行。文件被系统通知服务占着，网上能找到的做法都要先停掉服务，表结构也可能随版本变化。

这两条路放进产品都不太稳。

所以我想了两个可行的做法，你看哪个更合适：

1. 引导用户自己关：BrimDeck 设置里加一个“减少重复提示”的入口，说明要关的是“显示通知横幅”而不是整个通知，然后一键打开 Windows 的通知设置页。也可以只列出 BrimDeck 最近收到过通知的应用，方便用户逐个去关。不改任何系统设置，最稳。
2. 用“请勿打扰”：就是你前面说的办法。打开后所有应用都不弹横幅，通知照样进通知中心，BrimDeck 照样能读到、在岛上显示。BrimDeck 里的开关可以负责打开它、并在关闭开关时恢复用户原来的状态。我还在确认程序能不能用稳定的方式切换“请勿打扰”；如果不能，就退回到引导用户手动打开。还有一点要处理：BrimDeck 现在默认在“请勿打扰”时也不显示通知，需要区分“用户自己开的”和“为了接管通知而开的”。

我倾向于 1 和 2 都做：默认引导，2 作为可选项。你觉得呢？

[MoFeng2223]

问题在于BrimDeck 在我的电脑上没办法控制请勿打扰开还是关 只能读取不能控制 你可以在你电脑试下 反正我的不行

Windows 11 26200.9711我的版本是这个，我的还可以修改注册表生效关闭横幅 你再确认一下呢

下面是AI帮我生成的总结：

我在自己电脑上按你说的情况专门做了对照，结论和你的不一样：注册表里的 ShowBanner 仍然有效，改了立即生效，不需要改通知数据库。

环境：Windows 11 家庭版 26200.9711。注册表都是在 AI 工具的沙箱外修改的（用 explorer.exe 启动脚本）；横幅有没有弹出，由脚本在发送后 1.5 秒截屏判断；测试时“请勿打扰”是关闭的。

1. 注册表和数据库设成相反的值

发送方	数据库 s:banner	注册表 ShowBanner	横幅
PowerShell	1	0	不弹，通知照常进入通知中心
命令提示符（对照）	1	无	弹出

数据库是从沙箱外复制出来后只读查询的。数据库写着“开”，注册表写着“关”，结果是不弹，说明注册表这一项仍然有效，不只是迁移前留下的旧数据。

2. 商店打包应用

以 Claude 桌面版（Claude_pzs8sxrjxfjjc!Claude）的身份发通知，数据库里它的 s:banner 是 1：

注册表 ShowBanner	横幅
无（原状）	弹出
0	不弹，有送达记录
删除这一项	立即重新弹出

3. 从没发过通知的应用

PowerShell ISE 之前从没发过通知，注册表里没有它的设置项。提前替它建好设置项并写入 ShowBanner = 0 后，它的第一条通知也不弹横幅。所以新安装的应用也可以在第一次发通知之前处理好：开始菜单的应用列表（shell:AppsFolder）能直接读出每个应用的标识，和通知设置项的名称一致。

你那边不生效的可能原因

1. 修改时在 Claude 桌面版或 Codex 这类打包应用的沙箱里运行，写入注册表被重定向到了它们的私有副本。我在 Claude 的沙箱里改，读回来的值变了，但系统实际的值没变，横幅也不受影响。
2. 系统版本不同，处理方式也不同。

可以用 explorer.exe 在沙箱外运行脚本再试一次吗？也麻烦告诉我你的系统版本号（winver 里的版本和内部版本号）。

需要注意的地方

• 这个注册表项没有写进微软文档，以后的 Windows 版本可能会变，所以要保留兜底方案。
• BrimDeck 修改前要记录每个应用原来的值（包括“原来没有这一项”），关闭这个功能或退出时恢复；崩溃时来不及恢复，下次启动时再整理。
• 关掉横幅后提示音是否一起关掉，还没有验证。

[Koooki3]

okok，是我这边测试的问题

命令一直跑在 Claude 桌面版这个打包应用里。就算关掉了命令沙箱，注册表写入也会被转到它的私有副本，系统真正的设置没变。我在 Claude 外面（explorer.exe 启动 Windows 自带的 PowerShell）重新试了一次，结果和你的一样：

• 不写 ShowBanner：横幅弹出；
• 写入 ShowBanner = 0 后紧接着发：不弹，通知照常进通知中心，BrimDeck 照常读到。

我的系统是 Windows 11 26H2，内部版本 26300.9711。上一条里说“注册表只是迁移前的旧数据”是错的，请忽略。数据库里的 s:banner 也会生效，两边是“任一关闭就不弹”的关系；我们只改注册表这一边就够了。

请勿打扰那条路就不做了。按你的方案改：

• BrimDeck 设置里加一个开关“统一关闭其他应用的通知横幅”，默认关闭。
• 打开时：
  • 逐个记录应用原来的 ShowBanner，包括“原来没有这一项”的情况，存在 BrimDeck 自己的设置里；
  • 然后写 0；
  • BrimDeck 自己和用户在 BrimDeck 里设为“关闭/静音”的应用不动，那些通知只在 Windows 里显示。
• 应用列表来自开始菜单的应用列表（shell:AppsFolder）加上已有的通知设置项，所以还没发过通知的应用也能提前处理。新安装的应用在 BrimDeck 下次启动、或收到它的第一条通知时补上。
• 关闭开关时，按记录逐个恢复：原来没有的就删掉，原来有的就写回原值。用户中途手动改过的不覆盖，即当前值不是我们写的 0，就保留用户的。
• 崩溃或强制结束后来不及恢复的，下次启动时检查记录再收尾。
• 设置页写明这是 Windows 未公开文档的设置，以后的系统版本可能失效。失效时（写入后仍检测到横幅）给出提示，并引导用户到 Windows 设置里手动关。
• 提示音是否随横幅一起关，我实测后在 PR 里写清楚。

这部分我会放进第一个 Windows 通知的 PR 里。

[MoFeng2223]

好