用途:为构建原生 macOS SwiftUI 场景与组件提供最佳实践和示例驱动指引,覆盖窗口、命令、工具栏、设置、分栏等桌面形态。
主要能力:按目标选择切入点,已有项目先识别场景与交互模型(文档、编辑器、侧边栏-详情、工具窗口、设置、菜单栏附加项),阅读现有场景或根视图后再选参考;新应用脚手架先定场景模型(WindowGroup、Window、Settings、MenuBarExtra、DocumentGroup),并规划 App、Views、Models、Stores、Services、Support 的文件结构,避免单文件堆叠。提供侧边栏行与分栏背景的推荐写法、状态归属对照(@State、@Binding、@Observable、@SceneStorage、@AppStorage、@Environment 等)及跨切面参考文件列表。
使用方式:按 references/components-index.md 进入组件指引,再阅读 windowing、settings、commands-menus、split-inspectors、menu-bar-extra 等参考。新建脚手架时可用 git rev-parse --is-inside-work-tree 检查是否已在仓库内,否则在项目根运行 git init;并创建 script/build_and_run.sh 作为统一构建运行入口(沿用 build-run-debug 的约定)。
适用场景:构建 macOS 桌面应用、菜单栏应用、偏好设置窗口、多窗口与分栏布局。
限制:若 SwiftUI 无法清晰表达所需平台行为,应改用 appkit-interop,而非强行绕行。未提供具体版本要求、收费或效果数据。