SuperAPI AI 工具集

build-macos-app

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:面向原生 macOS SwiftUI/AppKit 应用的构建、审计与发布,涵盖新项目脚手架、功能实现、重设计、迁移、发布准备与质量配置。仅适用于存在 macOS 目标的项目;不适用于纯 iOS/iPadOS/visionOS/watchOS/tvOS、无 UI 的通用 Swift 包、纯服务端 Convex/TypeScript、非 Apple 平台 Swift 及浏览器自动化。

主要能力:按操作路由到对应参考文档,包括 Bootstrap(新应用)、Build(新增视图/窗口/命令)、Redesign(原生化、Liquid Glass)、Audit(审查与预检)、Migrate(macOS 14/15 迁移至 26)、Install hooks(SwiftLint/SwiftFormat/pre-commit/CI)、Add visual tests(快照测试)、Wire cloud sync(Convex + Clerk)、Ship(发布清单)。

核心规则:HIG 始终为基线,Liquid Glass 为 macOS 26+ 的附加视觉层,内容区不应用玻璃效果;菜单栏须可达所有操作,保留标准快捷键,设置即时生效。视图编写前需回答三个问题:是导航还是内容、唯一主操作是什么、是否与 Finder/Mail 等原生应用协调。

质量钩子:禁止直接写入 .git/hooks/,使用 git config core.hooksPath .githooks;类型检查默认关闭,需 SWIFT_HOOK_TYPECHECK=1 启用;不默认安装全局工具。

云同步:默认使用 Clerk 认证,ConvexMobile 仅支持 Apple Silicon macOS,非离线优先;不得信任客户端传入的 userId,服务端 Clerk JWT 为授权边界。

限制:Liquid Glass 需 macOS 26+ 与 Xcode 26 SDK;向后兼容目标为 macOS 14+ 并需可用性守卫;Convex + Clerk 路径不支持 Catalyst、Intel Mac、watchOS、tvOS、visionOS。具体版本号与最新校验信息以资料中 references/cloud-sync/operations/verified-corrections.md 为准。