用途:Permiso 为 macOS 应用提供权限引导弹窗界面,帮助用户前往系统设置开启辅助功能等权限,复刻 Codex Computer Use 的引导式授权体验。
主要能力:展示带动画的引导浮层,指引用户打开系统设置并启用指定权限(如辅助功能);以应用内助手形式引导用户完成授权,缓解 macOS 权限流程的常见摩擦。
使用方式:通过 Swift Package Manager 安装,在 Package.swift 中添加 .package(url: "https://github.com/zats/permiso", branch: "main"),或在 Xcode 中通过 File → Add Package Dependencies 添加,并将 Permiso 加入目标依赖。核心 API 为 PermisoAssistant.shared.present(panel: .accessibility),需在 @MainActor 或主线程调用。可在应用启动、AppDelegate 或敏感操作前检查 AXIsProcessTrusted() 后触发,也可用定时器轮询授权状态。
适用场景:需要在 macOS 应用中引导用户开启辅助功能权限的开发者,尤其是依赖辅助功能 API 的工具类应用。
限制:面向 macOS,建议 macOS 13+ 与 Swift 5.9+;present 必须在主线程调用;授权后 AXIsProcessTrusted() 可能因系统缓存仍返回 false,需重启应用或轮询;沙盒应用可能需完整重启;若需实际使用辅助功能 API,可能需相应 entitlements。具体版本要求与收费信息暂未提供。