桌面应用【免费下载链接】alt-tab-macosWindows alt-tab on macOS项目地址https://gitcode.com/gh_mirrors/al/alt-tab-macos点击查看免费下载WsEventRouting是 alt-tab-macos 中负责将 WindowServerSkyLight/CGS原始通知 id 解码为已知Notification、再映射为模型Action的纯决策内核。它不持有状态、不做任何 IPC是「事件感知 → 模型变更」链路中唯一负责分类与路由判定的组件。读完本文你将掌握这份 id→含义映射表是如何通过反向工程得到的、每个通知 id 的确切语义与 payload 结构、最小化为何不是独立事件、以及它如何与WindowServerEvents形成「纯决策 / 不纯执行」的分层架构。背景为什么需要一层纯事件路由alt-tab-macos 的窗口状态来源经历过一次架构升级早期通过 AXAccessibility事件路由层把kAXWindowCreated等 AX 通知映射到模型动作在 WindowServer 成为窗口状态的主要来源后旧的 AX 事件路由层被WsEventRouting取代。与它同模式的SelectionResolver一样这是一个pure-decision-kernel纯决策内核组件。从 windowserver/README.md 可以看到整个分层设计物理平面physical plane→ WindowServer窗口的存在、几何、z-order/level、Space 归属、ordered-in、最小化、全屏以及标题回退全部来自 SLS 事件加批量查询语义平面semantic plane→ 每进程一个 app 级 AX observer焦点/主窗口通知与标题变化是推送信号WsEventRouting负责把 WindowServer 连接通知 id 分类为模型动作并暴露一个 dispatcher 需要的事实——payload 是否携带 Space id。它在架构中的角色可以从 windowserver/README.md 的组件表中看出../events/WindowServerEvents.swift是**不纯impure部分负责安装 SLS notify-proc 钩子WsEventRouting三元组WsEventRouting.swiftWsEventRoutingSpecs.mdWsEventRoutingTests.swift则是纯pure**部分只做「通知 id → 模型动作」的决策。反向工程得到的 id 映射表证据WsEventRouting的整套映射并非来自任何公开文档——SkyLight 是私有框架其通知 id 的语义只能实测。规格文档记录了验证方法在 macOS 26 上注册SLSRegisterConnectionNotifyProc覆盖一个很宽的 id 范围然后逐一驱动窗口生命周期/焦点/Space 变化从而确认每个 id 的真实含义。验证方式的具体实现位于 SkyLight.framework.swiftSLSRegisterConnectionNotifyProc注册每连接通知回调SLSRequestNotificationsForWindows把连接订阅到指定窗口。文档与源码共同确认了以下 11 个可行动通知 id原始 idNotification case含义实测确认806windowMoved窗口移动807windowResized窗口缩放811windowCreated窗口创建804windowDestroyed窗口销毁815windowOrderedIn窗口被置入屏幕ordered-in816windowOrderedOut窗口被移出屏幕ordered-out808windowFocused前/焦点窗口变化跨 app 与 app 内均已确认1325windowAddedToSpace窗口被加入某个 Space1326windowRemovedFromSpace窗口被移出某个 Space1329spaceCurrentChanged当前 Space 变化1401activeSpaceChanged活跃 Space 变化这些 case 在 WsEventRouting.swift 中定义为一个UInt32原始值的枚举并声明CaseIterable以便WindowServerEvents在安装钩子时遍历注册全部通知。通知如何映射为模型 Action每个Notification都对应一个明确的模型Action。映射函数action(for:)是纯函数——同一输入永远得到同一输出无状态、无副作用完整逻辑见 WsEventRouting.swiftNotificationAction模型层含义windowCreatedacquireAndDiscriminatewid 可能是未跟踪的必须先取得其 AX element再运行WindowAdmissionResolver判断它是否为真正的窗口然后才展示windowDestroyedremove窗口已消失windowMoved/windowResizedupdateGeometry刷新 boundswindowFocusednoteFocusEventWindowServer 声明该窗口来到了前台windowOrderedIn/windowOrderedOutrefreshVisibility重新读取 minimized/visible 状态windowAddedToSpace/windowRemovedFromSpaceupdateSpaceMembershippayload 携带(spaceId, wid)spaceCurrentChanged/activeSpaceChangedspaceTransition当前/活跃 Space 发生变化解码函数notification(_:)直接利用 Swift 枚举的rawValue构造返回Optional——未注册的 id如心跳 1502/1503、列表变化脉冲 1322、0、999自然解码为nil见 WsEventRouting.swift。三个塑造 Action 的关键发现规格文档用 Notes 记录了对映射决策影响最大的三个实测事实最小化不是独立事件最小化发出的是 816ordered-out与隐藏hide完全相同。因此该通知映射为refreshVisibility随后由WsWindowState读取最小化位minimizedTag即 tags 字段的1 60来区分最小化与真正的关闭/移出。这一定义与 WsWindowState.swift 中的位解码设计相互印证——attributes的visibleAttribute0x2只表示 ordered-in/on-screentags的minimizedTag才是精确的最小化信号。Space 通知1325/1326在 payload 中携带(spaceId, wid)Space 成员关系是免费获得的无需再发查询。这对应notifyProc中同步读取的三个字段w0wid、s0space、w8widInSpace见 WindowServerEvents.swift。创建811⇒acquireAndDiscriminate创建时 wid 可能是未跟踪的必须先获取其 AX element 并运行WindowAdmissionResolver才能展示——这正是物理平面与语义平面衔接点。纯决策与不纯执行的分层协作WsEventRouting自己不做任何 IPC——「WindowServerEvents把这些决策变成模型变更」是规格文档明确划定的边界。实际调用链如下注册WindowServerEvents.observe()遍历WsEventRouting.Notification.allCases为每个 id 调用SLSRegisterConnectionNotifyProc注册notifyProc回调WindowServerEvents.swift回调notifyProc同步从 payload 中解出 wid/space/widInSpace 三个整数payload 指针只在本次调用内有效随后跳回主线程执行handle解码handle首先调用WsEventRouting.notification(event)nil直接返回不行动作命中后先处理 Space 转换的**前沿leading edge**逻辑——同一个时钟既用于静默转换期间创建/销毁的窗口风暴也用于标记突发的前沿路由route调用WsEventRouting.action(for:)按 Action 分支派发对应的ReducerInputWindowServerEvents.swift。可以看到WsEventRouting只贡献两个纯决策点notification(_:)解码与action(for:)映射。它与ReducerInput的对应关系记录在 TrackedWindowState.swift811 →windowCreated(wid:now:inSpaceTransition:)804 →windowDestroyed(wid:)806/807 →windowMovedOrResized(wid:inSpaceTransition:)815 →windowOrderedIn(wid:now:inSpaceTransition:)816 →windowOrderedOut(wid:inSpaceTransition:)808 →windowFocused(wid:now:)1325/1326 →spaceMembershipChanged(wid:spaceId:added:...)1329/1401 → 前沿spaceTransitionStarted/ 防抖后spaceChangeSettled最终这些输入由纯编排内核 WindowEventReducer.swift 消化——例如windowCreated会立即触发对该 wid 的非节流发现discoverWindowSpace 转换期间则被守卫忽略以避免把动画/快照窗口误判为真实窗口。一个值得注意的工程决策不在回调中打日志WindowServerEvents.swift 特意说明原始通知不在这里记录日志因为每个通知都会路由到 reducerreducer 会把「输入 全部决策」作为单行日志输出经TrackedWindowStateBridge.dispatch在这里再打一行等于每个事件重复两遍——这正是--logsdebug曾经变成洪流的根源。唯一到不了 reducer 输入的是 Space 转换它被防抖了因此只有它在route里单独记录。测试验证把反向工程结果钉死在测试里规格文档的 Test scenarios 一节明确说明它 1:1 镜像 WsEventRoutingTests.swift测试被设计为「如果未来 macOS 重新编号这些 id或重构删掉了某个 case测试就会失败」。A. 通知解码testKnownIdsDecode逐一断言 811→.windowCreated、804→.windowDestroyed、806→.windowMoved、807→.windowResized、815→.windowOrderedIn、816→.windowOrderedOut、808→.windowFocused、1325→.windowAddedToSpace、1326→.windowRemovedFromSpace、1329→.spaceCurrentChanged、1401→.activeSpaceChangedtestUnknownIdsAreNil对心跳/其他 id——1502、1503心跳、1322列表变化脉冲、0、999——断言解码结果为nil。B. Action 映射testActionForEachNotification覆盖全部 11 个 case 到 7 种 Action 的映射包括同类合并moved/resized 同归updateGeometryorderedIn/orderedOut 同归refreshVisibility两个 Space 成员通知同归updateSpaceMembership两个 Space 转换通知同归spaceTransition。这套测试还出现在更高层的场景测试中例如 RealWorldScenariosTests.swift 验证「从 Space 移出风暴」中每一个 1326 都路由到.updateSpaceMembership这正是 churn 触发器并确认其 payload 携带(spaceId, wid)成员关系更新无需再发查询。纯内核三元组的工程约定WsEventRouting遵循仓库对纯内核的统一约定见 windowserver/README.md纯内核是共置的三元组Foo.swiftFooSpecs.mdFooTests.swift同时编译进 app 和unit-tests目标不持有状态、不做 IPC不纯的执行器tap、query、acquisition负责 IPC在运行时验证设计文档写在Specs.md里而不是代码注释里。这套约定的收益在WsEventRouting身上体现得尤为明显id→含义映射这类极易因 OS 版本漂移而失真的知识被同时固化在规格文档供人阅读、枚举定义供机器执行和单元测试供持续验证三处任何一个 macOS 重新编号都能被测试立即捕获。小结WsEventRouting是 alt-tab-macos 从「AX 事件驱动」迁移到「WindowServer 事件驱动」架构中的关键纯决策层它以 11 个实测确认的通知 id 为输入产出 7 种模型动作并通过「纯决策内核 不纯执行器」的分层与WindowServerEvents搭档保证决策可测试、可回放、无副作用。反向工程得来的 id 映射表、payload 结构语义特别是(spaceId, wid)携带与最小化无独立事件这两个发现以及 1:1 镜像的测试套件共同构成了这个组件可长期依赖的事实基础。进一步阅读物理平面的整体设计见 windowserver/README.md通知 id 的底层私有 API 绑定见 SkyLight.framework.swift事件流落地为模型变更的完整过程见 WindowServerEvents.swift 与 WindowEventReducer.swift。赞分享桌面应用【免费下载链接】alt-tab-macosWindows alt-tab on macOS项目地址https://gitcode.com/gh_mirrors/al/alt-tab-macos点击查看免费下载相关推荐Midscene.js终极指南5分钟让AI成为你的跨平台自动化助手Midscene.js终极指南5分钟让AI成为你的跨平台自动化助手 还在为复杂的UI自动化测试头疼吗Midscene.js让一切变得简单——这个革命性的视觉人工智能AI Agent测试GUI 自动化浏览器控制测试智能体macOS窗口切换革命alt-tab-macos让你的工作效率翻倍macOS窗口切换革命alt tab macos让你的工作效率翻倍 你是否曾经在macOS上打开十几个窗口却找不到想要的那个在多个应用间来回切换时是否感桌面应用macOS窗口管理革命AltTab如何将Windows高效切换体验带到MacmacOS窗口管理革命AltTab如何将Windows高效切换体验带到Mac 还在为macOS原生的窗口切换方式感到效率低下吗 AltTab 这款开源工具为桌面应用上一篇Gopeed下载器五阶段上手全攻略HTTP、磁力与ed2k多协议下载从安装玩到多端联动下一篇未来荧黑字体从零掌握实战指南开源参数化中文字体的完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考