Tendedero 源码剖析四零权限调用 WindowServer 私有 API精准识别全屏 Space【免费下载链接】tendederoScreenshots, hung out to dry. A tiny native macOS app that hangs every screenshot on a line at the top of your screen.项目地址: https://gitcode.com/gh_mirrors/te/tendederoTendedero 是一款 macOS 原生截图管理工具它把每次截图像晾衣服一样挂在屏幕顶部的晾衣绳上鼠标停在菜单栏就会滑下来移开即收起。它能在所有 Space虚拟桌面之间跟随却从不覆盖全屏应用。这期源码剖析聚焦一个精巧的设计如何在不申请任何权限、不使用任何公开 API 的情况下直接调用 WindowServer 的私有函数精准判断当前屏幕是否处于全屏 Space从而决定晾衣绳该出现还是该等待。问题晾衣绳为什么必须避开全屏Tendedero 的核心面板是一块横跨屏幕顶部的透明条带它的窗口行为设置让它能浮现在所有 Space 之上// 每个 Space 都加入但全屏 Space 除外 collectionBehavior [.canJoinAllSpaces, .stationary, .ignoresCycle]完整实现见 Sources/Tendedero/LinePanel.swift。.canJoinAllSpaces是 AppKit 的公开能力但这里有个系统级细节带此标志的窗口在普通 Space 可见在全屏 Space 上则不出现。所以不盖住电影这件事窗口管理器其实已经帮忙做了一半。然而只靠系统行为不够。用户可能先截了图、再点开一部全屏视频——此时晾衣绳被系统藏起来了但截图还在等上线。理想的体验是全屏期间晾衣绳安静等待一旦退出版全屏就立刻露面。要做到这一点应用必须主动知道这块屏幕现在是不是全屏而这正是本期要剖析的能力。零权限调用私有 API两行_silgen_namemacOS 的窗口与 Space 管理由 WindowServer窗口服务进程负责它通过 CoreGraphics 框架暴露了一批以CGSCoreGraphics Services开头的函数。其中两个关键函数没有公开头文件却稳定存在了十多年也是 yabai 等窗口管理器的依赖基础// 窗口服务器知道每个显示器当前显示的是哪类 Space _silgen_name(CGSMainConnectionID) private func CGSMainConnectionID() - Int32 _silgen_name(CGSCopyManagedDisplaySpaces) private func CGSCopyManagedDisplaySpaces(_ connection: Int32) - CFArray代码位置Sources/Tendedero/FullScreen.swift。这里的技巧是 Swift 的_silgen_name属性它让编译器在链接期直接生成一个 C 符号引用绕开 Swift/ObjC 的方法查找机制。链接时从 CoreGraphics 的动态库中解析出该符号运行期像普通函数一样调用。整个过程❌ 不需要辅助功能Accessibility权限❌ 不需要沙盒例外或 entitlements❌ 不需要CGSSpace相关的任何私有头文件签名靠人工声明✅ 只需知道函数名和返回结构两行声明即可源码注释说得很直白These calls are private but stable for a decade, need no permission这些调用是私有的但十多年来稳定不变且无需权限。解读返回值type 为 4 就是全屏 Space拿到两个函数后判断全屏只剩读懂返回值这一步。CGSCopyManagedDisplaySpaces返回一个数组每个元素描述一块显示器的 Space 信息核心字段是字段含义Display Identifier显示器的 UUID 字符串Current Space当前 Space 的字典Current Space.typeSpace 类型全屏 Space 的类型是4主判断逻辑只有几行private static let fullScreenSpaceType 4 let current entry?[Current Space] as? [String: Any] return (current?[type] as? Int) fullScreenSpaceType完整入口是 FullScreen.isActive(on:)整个文件不超过 40 行。多屏兼容两种系统设置的自适应macOS 在显示器具有单独的空间Displays have separate Spaces关闭时返回数组里只有一条记录、覆盖所有屏幕开启时则每块显示器一条。源码对两种情况做了区分if displays.count 1 { entry displays.first // 单条目覆盖所有屏幕 } else { let uuid uuidString(for: screen) entry displays.first { ($0[Display Identifier] as? String) uuid } }多屏分支中把NSScreen转成Display Identifier需要一个小小的桥接uuidString(for:)从deviceDescription取出NSScreenNumber即CGDirectDisplayID用公开的CGDisplayCreateUUIDFromDisplayID换成CFUUID再转成字符串与返回值比对。这样在双屏一屏全屏一屏工作的场景下也能精确判断正在使用的那块屏幕是否全屏。与界面逻辑的协作不是藏而是等识别出全屏后Tendedero 并没有简单地把面板藏死而是在 AppDelegate.refresh() 里把它变成一个门控条件let blocked panel.screen.map(FullScreen.isActive(on:)) ?? LinePanel.screenUnderPointer().map(FullScreen.isActive(on:)) ?? false if wanted !blocked { present() // 有内容要展示且不在全屏 → 出现 } else { dismiss() // 否则收起wanted 保留退全屏后自动回来 }关键在于wanted这个状态位截图挂上时置为true全屏只会让它暂时不呈现而不会清除它。等用户退出全屏Space 切换通知触发重新检查晾衣绳立刻等来了自己的时机。同样的判断也用在热区检测中——指针停在菜单栏准备拉下晾衣绳时会先确认该屏幕不是全屏AppDelegate.swift避免在全屏应用里触发无意义的动画。监听 Space 切换动画结束后的二次采样进出全屏本质上是一次 Space 切换。AppDelegate.swift 订阅了两个系统通知activeSpaceDidChangeNotificationSpace 切换时didActivateApplicationNotification应用激活时每次触发都调用两次refresh()一次立即、一次延迟 0.8 秒。注释解释了原因Entering or leaving full screen switches Space. Check again once the switch animation has settled.进入或退出全屏会切换 Space等切换动画结束后再检查一次。二次采样是个务实的细节macOS 的全屏切换有动画动画进行中的窗口服务器状态可能尚未落定800ms 后的复检保证了状态判断的可靠性。小结这套设计的三个要点要点做法价值零权限_silgen_name直接链接 WindowServer 私有符号无需授权弹窗用户体验零摩擦选稳定的私有 API依赖十年未变的 CGS 函数族与窗口管理器同款的成熟路径风险可控状态机而非开关wantedblocked门控全屏不是隐藏而是等待退出即恢复全文涉及的核心文件全屏检测Sources/Tendedero/FullScreen.swiftREADME 中的角色描述是Knows when to stay hidden——知道何时该保持隐藏面板行为Sources/Tendedero/LinePanel.swift状态编排Sources/Tendedero/AppDelegate.swift工程配置Package.swiftmacOS 14Swift/AppKit/SwiftUI无第三方依赖一个不到 40 行的文件两行私有 API 声明加上一个wanted状态位就构成了晾衣绳在全屏应用前知礼退让、又随时候命的完整体验。对于想在 macOS 上做窗口管理、悬浮面板类工具的同学这份源码展示了调用 WindowServer 私有 API 时最克制的工程姿态用最少的声明换最稳的私有接口再用状态机把系统行为变成产品行为。【免费下载链接】tendederoScreenshots, hung out to dry. A tiny native macOS app that hangs every screenshot on a line at the top of your screen.项目地址: https://gitcode.com/gh_mirrors/te/tendedero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考