Tinycast AX 坐标系解析窗口管理为什么锚定主显示器而不是窗口所在屏幕【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycastTinycast是一款小巧的纯原生 macOS 启动器Launcher集成全局热键与无限剪贴板历史其中的窗口管理功能可以把任意窗口一键贴到屏幕的上下左右、四分之三等位置。它背后的关键在于如何正确使用 macOS 的AXAccessibility坐标系——而一个不起眼的设计决策坐标翻转锚定主显示器而不是窗口所在的屏幕直接决定了多显示器下窗口摆放的正确与否。两种坐标系Cocoa 在下AX 在上macOS 里其实存在两套全局坐标系这是很多开发者踩坑的根源坐标系原点位置Y 轴方向使用方CocoaNSScreen主显示器左下角向上 YAppKit 应用自身AXAccessibility主显示器左上角向下 Y系统辅助功能 APITinycast 移动窗口时走的是 AX API与剪贴板粘贴共用同一个辅助功能授权不额外要权限所以所有窗口几何计算都发生在 AX 空间全局坐标、左上角原点、Y 轴向下。这也带来一个可验证的结果——上半屏命令产出的矩形一定满足minY visibleFrame.minY测试会专门断言这一点防止左下角习惯悄悄回流。核心问题翻转时锚在哪把 Cocoa 坐标翻转成 AX 坐标公式只有一行y 锚点高度 − rect.maxY。真正的学问在于锚点高度取谁的高度。直观的错误做法是窗口在哪块屏幕上就用那块屏幕的高度做锚。单显示器下完全正确但一旦混接不同尺寸的屏幕所有矩形都会被剪切shear掉一个高度差——比如主屏高 1200pt副屏高 900pt副屏上的窗口算出来的 Y 坐标就会系统性偏移 300pt窗口落位瞬间错乱。原因一句话就能说清Cocoa 全局空间和 AX 全局空间两者的原点都锚在主显示器上。主显示器是唯一一个 Cocoa 框架原点在(0, 0)的屏幕它是两套坐标系的共同基准。既然翻出去和翻回来都以主显示器为锚那么中间所有转换也必须以它为锚才能让整条链路自洽。这个 bug 在单屏上完全不可见在每一套混尺寸多屏环境下都会出错——所以 Tinycast 的文档里特意值得强调两遍。代码里的实现一次快照、唯一转换点整个转换被严格收口到一个结构体里这也是 docs/features/window-management.md 中明确列出的不变量WindowPlacementEngine只工作在 AX 空间AXGeometry是唯一做 Cocoa↔AX 转换的地方。核心逻辑非常简洁见 AXScreens.swift找出主显示器screens.first { $0.frame.origin .zero }即 Cocoa 原点为(0, 0)的那块屏取它的高度作为anchorHeight翻转是一个对合操作involution翻两次还原flip(rect)只减不缩放宽度高度原样保留。同样值得注意的还有两点防御性设计每条命令只做一次快照。热插拔、系统唤醒、分辨率切换都可能让NSScreen.screens在两次调用之间变化如果一条命令里混用了两个不同锚点结果立刻被污染全程不碰backingScaleFactor。NSScreen.frame、visibleFrame与 AX 坐标全部以点points为单位因此混合 DPIRetina 普通屏的正确性是自动的——如果这个功能里出现任何缩放因子那就是 bug。命令如何落位唯一的写入序列拿到目标矩形后真正动手的是 AXWindowAccess.swift 里唯一的写入序列被移动器、布局运行器共享保证再顽固的应用也只会以同一种方式被摆好先设尺寸再设位置最后再设一次尺寸——因为部分应用在 resize 时会以另一条边为锚导致原点漂移若应用有最小尺寸限制压住了目标尺寸就按命令的锚点对实际尺寸重新定位一次且只重摆一次避免来回抖动窗口若拒绝 resize则保留其现有尺寸只在目标区域内按锚点摆放。而纯几何计算则全部由 WindowPlacementEngine.swift 完成——它只依赖 Foundation 和 CoreGraphics不接触 AX、不接触NSScreen可以独立跑单元测试这正是坐标系收口带来的收益几何错了在测试里就能发现不需要真的去搬窗口。给多显示器用户的实际影响主屏高度是全局标尺副屏上执行上半屏/下半屏贴边的是副屏自己的visibleFrame但 Y 换算依然走主屏锚点落位精确️混尺寸屏幕不再错位4K 笔记本屏、Retina 2K 屏这类组合是最容易暴露此类 bug 的场景Tinycast 从设计上就排除了它配合自定义尺寸与窗口布局自定义尺寸永远作用于窗口当前所在显示器而 Window Layouts 支持跨多屏的一次性编排共享同一套坐标系与间距规则。延伸阅读功能总览与坐标系专节docs/features/window-management.md坐标转换实现AXScreens.swift唯一 AX 读写层AXWindowAccess.swift纯几何引擎WindowPlacementEngine.swift移动策略循环、还原、全屏WindowMover.swift3×3 位置网格锚点WindowLayoutAnchor.swift一句话总结坐标系是全局的锚点必须唯一。Tinycast 用锚定主显示器这一个约束换来了任何显示器组合下窗口命令的一致正确——这也是所有跨屏幕几何代码最值得抄走的一课。【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycast创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考