此用例旨在将应用构想转化为感觉专为桌面（而非从触控优先堆栈拉伸而来）构建的 Mac 应用外壳。要求 Codex 首先选择场景模型，然后围绕稳定的侧边栏选择、详情界面和辅助控件或元数据的检查器来设计主窗口。

当您希望 Codex 应用该桌面结构并保持构建/运行循环外壳优先时。其 macOS SwiftUI 模式技能非常适合场景设计、侧边栏、检查器、命令、设置以及当 SwiftUI 略显不足时针对特定 Mac 行为的小型 AppKit 桥接。

使用 构建 macOS Apps 插件 构建侧边栏、详情面板和检查器

当功能受益于持久导航和稳定选定项时。保持侧边栏行原生轻量，让侧边栏使用系统背景，并将自定义卡片或密集元数据保留在详情面板或检查器中。

在适合工作流的地方，优先选择 NavigationSplitView 如果应用需要不寻常的分割尺寸调整、底层窗口协调或自定义响应者链行为，请要求 Codex 保持 SwiftUI 外壳完整，并仅为该缺陷添加最小的 AppKit 桥接。

struct LibraryRootView: View {
  @SceneStorage("LibraryRootView.selection") private var selection: Item.ID?
  @SceneStorage("LibraryRootView.showInspector") private var showInspector = true

  var body: some View {
    NavigationSplitView {
      List(selection: $selection) {
        ForEach(items) { item in
          Label(item.title, systemImage: item.systemImage)
            .tag(item.id)
        }
      }
      .listStyle(.sidebar)
      .navigationTitle("Library")
    } detail: {
      ItemDetailView(selection: selection)
        .inspector(isPresented: $showInspector) {
          ItemInspectorView(selection: selection)
        }
    }
  }
}

在桌面层中放置命令、工具栏和快捷键

Mac 用户应该能够在菜单栏、工具栏和键盘快捷键中发现重要操作。要求 Codex 连接场景级别的

将偏好设置保留在 commands,围绕相同的应用操作提供上下文相关的菜单项和工具栏按钮,使桌面用户无需四处寻找仅手势可用的控件。

@main
struct LibraryApp: App {
  var body: some Scene {
    WindowGroup {
      LibraryRootView()
    }
    .commands {
      CommandMenu("Library") {
        Button("New Item") {
          // Create a new item.
        }
        .keyboardShortcut("n")

        Button("Toggle Inspector") {
          // Route this command to the focused window or selected item state.
        }
        .keyboardShortcut("i", modifiers: [.command, .option])
      }
    }

    Settings {
      LibrarySettingsView()
    }
  }
}

使用 FocusedValue,场景状态,或当命令应应用于当前详情项时的显式选择状态。如果某快捷方式会在多个位置注册,请让 Codex 整合其归属,使应用拥有一条清晰的命令路径。

对于应用偏好设置，请使用专用的 Settings

场景，并使用 Settings 持久化持久的用户选择 @AppStorage。这通常比在主内容窗口中推入设置界面更符合 macOS 的使用习惯。

struct LibrarySettingsView: View {
  @AppStorage("showItemMetadata") private var showItemMetadata = true

  var body: some View {
    TabView {
      Form {
        Toggle("Show Item Metadata", isOn: $showItemMetadata)
      }
      .tabItem { Label("General", systemImage: "gearshape") }
    }
    .frame(width: 460, height: 260)
    .scenePadding()
  }
}

提示应用概念，然后验证外壳

当您的提示命名了应用概念、主要内容对象和主要操作，然后要求 Codex 首先围绕该工作流构建桌面外壳时，此页面效果最佳。让代理运行小型构建/运行检查，并总结场景结构、命令连接、状态所有权以及它必须桥接的任何 AppKit 边缘情况。

实用技巧

保持侧边栏原生

在侧边栏行中使用一个图标、一行标题，最多一行简短的辅助文本。将更丰富的卡片、计数器和元数据移至详情面板或检查器，以便源列表保持易于扫描。

避免在主堆栈中隐藏设置

如果用户偏好设置影响整个应用，请要求 Codex 将该控件置于 Settings with @AppStorage 中，并通过应用菜单公开入口，而不是构建另一个推入式设置屏幕。

将 AppKit 用于狭窄的桌面缺陷

如果功能需要打开/保存面板、第一响应者控制或自定义 NSView，将 AppKit 作为 SwiftUI 拥有的状态模型周围的少量外围层来使用，而不是用 AppKit 重写整个窗口。