OmniWM 工作原理深度解析四阶段反应式管线与 WorldStore 单写者架构完整指南【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWMOmniWM 是一款运行在 Apple Silicon Mac 上的免费开源平铺窗口管理器提供 Niri 风格的滚动容器与 Hyprland 风格的 Dwindle BSP 布局。它的核心是一套四阶段反应式管线与WorldStore 单写者架构——所有窗口状态变更都经过唯一入口处理从根源上避免了并发冲突与状态不一致。下面带你从零理解这套架构的设计思路。 第一阶段事件接收Intake所有能改变窗口状态的事件——键盘快捷键、鼠标操作、窗口创建/销毁、IPC 命令——都汇入同一个单一有序缓冲区。这是整条管线的入口。三个核心组件各司其职组件职责一句话理解EventIntake有序缓冲区 单调递增seq所有事件排队每轮主循环只排空一次EventInterpreter纯分发器把带序号的事件路由到对应子处理器IntentLedger焦点回显分类区分我自己的操作和用户真实操作关键设计事件接收阶段只做排队和分发不做任何分类或提交。这样保证了管线的单向流动。 源码位置EventIntake.swiftEventInterpreter.swiftIntentLedger.swift 第二阶段WorldStore 单写者架构核心创新这是 OmniWM 架构的灵魂。WorldStore是整个系统中唯一的同步写者所有语义状态变更都必须通过commit()方法完成。任何子处理器都不能直接修改窗口模型、焦点、工作区或布局引擎。commit() 的七步流程seq → 应用窗口变更 → 事件规范化 → 纯函数 reduce → 解析计划 → 不变量检查 → 记录交易步骤操作说明1递增seq单调递增的变更计数器用于检测过期计划2应用窗口变更例如model.upsert插入/更新窗口记录3事件规范化EventNormalizer填充缺失的 monitor/workspace 字段4纯函数 reduceStateReducer.reduce生成ActionPlan状态差异5解析/增强计划调用方补充计划细节6不变量检查InvariantChecks.validate验证快照一致性7记录交易ReconcileTxn写入 256 条环形缓冲区含诊断报告 源码位置WorldStore.swiftStateReducer.swiftInvariantChecks.swiftWMEvent.swift为什么单写者如此重要无锁安全WorldStore标记为MainActor可变的窗口注册表是私有的外部只能通过只读ReadView访问过期检测每个EffectPlan盖上plannedSeq戳应用前用isSeqCurrent检查——如果世界已经变了直接丢弃过期计划引擎沙箱布局引擎被WorldStore私有持有只能在 commit 范围内修改withEngineMutationScope否则触发断言失败⚡ 第三阶段执行器EffectorLayoutRefreshController把世界状态转化为实际的窗口帧分三步走调度单槽调度器activeRefreshpendingRefresh并发请求自动合并计划构建在layout_buildcommit 内运行布局引擎输出[WindowToken: CGRect]帧映射帧应用通过AXManager按应用分组在每应用的专属线程上写入并验证帧⚙️ 刷新路由不同的RefreshReason映射到不同路由fullRescan/relayout/immediateRelayout/visibilityRefresh/windowRemoval各有独立的防抖策略。 源码位置LayoutRefreshController.swiftWMController.swift 第四阶段表面同步Surface ReconciliationSurfaceReconciler从只读的WorldView门面统一派生所有辅助界面焦点边框每显示器工作区栏标签栏Niri 列标签 / Dwindle 分组标签原生全屏占位面板停靠边缘遮罩它先构建期望场景DesiredSurfaceScene再与已应用场景做值相等 diff只更新有变化的部分——避免无谓的 AppKit 操作。 源码位置SurfaceReconciler.swiftSurfaceDerivation.swiftWorldView.swift 三层窗口身份系统身份层类型用途WindowToken值类型pid windowId字典键跨重布局存活WindowHandle引用类型布局树持有者rekey 时重新指向AXWindowRefAX 桥接持有AXUIElement用于读写当应用销毁并重建窗口时WindowModel.rekeyWindow会把所有引用从旧 token 重指到新 token身份不变——窗口的工作区、模式和位置完整保留。 双布局引擎纯状态机引擎风格核心结构源码目录Niri方向感知滚动容器NiriRoot→NiriContainer列→NiriWindow叶Core/Layout/Niri/DwindleBSP 二叉分割DwindleNodesplit/leaf→DwindleTile分组Core/Layout/Dwindle/两个引擎遵循同一契约✅ 只计算帧映射绝不直接操作窗口无 AX 调用、无帧写入✅ 只被WorldStore私有持有只在 commit 范围内可变✅ 接收工作区快照 显示器几何 间隙参数输出[WindowToken: CGRect] 完整数据流一次窗口创建的全过程macOS 窗口服务器创建窗口 │ ▼ CGSEventObserver → EventIntake.post(.cgs(.created)) 【第一阶段】 │ ▼ EventInterpreter → AXEventHandler → WindowRuleEngine 【规则判定】 │ 输出.managed / .floating / .unmanaged ▼ WorkspaceManager.addWindow → WorldStore.commit 【第二阶段】 │ seq, upsert, reduce, invariants ▼ LayoutRefreshController.requestRelayout 【第三阶段】 │ 构建 EffectPlan → AXManager.applyFramesParallel ▼ SurfaceReconciler.noteWorldChanged 【第四阶段】 │ 派生表面场景 → diff → 只更新变化的部分 ▼ 窗口出现在正确位置 ✅ 架构设计的三个核心原则1. 一个缓冲区一次排空一个写者参与语义管线的所有传输层汇入同一个EventIntake每轮主循环按seq顺序排空一次所有状态变更流经WorldStore.commit子处理器绝不直接修改。2. 解释器只分发不分类不提交EventInterpreter是纯 switch 路由回显分类在IntentLedger提交在WorldStore。职责分离让每个组件都可独立测试。3. 动画层是唯一门控例外每帧 60–120 次的弹簧/手势动画在CADisplayLink中推进不经过commit否则 seq 会疯狂递增。已提交的ViewportState是锚点动画在其上叠加瞬态偏移。 快速定位关键文件想了解什么去哪里看管线总览architecture.md事件接收Core/Intake/世界状态Core/World/状态归约Core/Reconcile/执行器Core/Controller/表面同步Core/Surface/Niri 引擎Core/Layout/Niri/Dwindle 引擎Core/Layout/Dwindle/IPC 通信IPC/ 更完整的架构文档含焦点热键流、IPC 命令流、贡献模式等见项目内维护的架构指南website/src/content/docs/developers/architecture.md【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWM创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
