#Codex App 界面说明

本章逐项拆解桌面应用的界面，让你知道每个按钮在哪、点了会发生什么。建议对照自己机器上的 App 一起看。

#整体布局

┌───────────────┬──────────────────────────────────────────────┐
│  侧边栏        │  顶部操作栏（Open / Hand off / Commit / 模型）  │
│  （导航）      ├──────────────────────────────────────────────┤
│               │                                              │
│  对话/搜索     │            对话区  +  Diff 审查区              │
│  插件/自动化   │                                              │
│  任务/项目/云端 │                                              │
│               ├──────────────────────────────────────────────┤
│  Settings     │  输入框（+权限 · 模型 · 推理强度）              │
│               │  底部状态栏（Local · 权限 · 分支 · 改动行数）   │
└───────────────┴──────────────────────────────────────────────┘

#一、侧边栏（导航）

线程列表会按项目分组显示，并标注状态（如 Awaiting approval / 等待审批）与耗时。

#二、对话区

中间主区域是与 Codex 的对话，包含：

• 你的指令与 Codex 的回复
• Codex 执行的命令记录（Ran ...）、思考说明与进度（如「Worked for 6m 40s」）
• 改动文件的引用（可点击跳转）
• 结尾的本轮改动摘要与 Undo（撤销）

#三、Diff 审查区

当任务产生代码改动，右侧出现逐行 Diff：

• 顶部可在 Review / Commit 等视图间切换
• 绿色为新增、红色为删除
• 文件列表显示每个文件的 +/- 行数
• 适合提交前逐行确认，避免「以为改对了」

#四、输入框与三大选择器

输入框下方有三个关键选择器（发送前务必确认）：

输入框左侧的 + 可附加图片、文件，或（macOS）通过 Appshots 附加某个应用窗口的截图。输入 / 触发斜杠命令，输入 @ 提及文件或工具。

#五、顶部操作栏

任务进行时，线程顶部提供：

#六、底部状态栏

窗口底部一眼看清当前上下文：

• Local / Cloud：执行位置
• 权限（Default permissions 等）
• 分支（如 main）
• 改动统计（如 +1 -9）

#七、Settings（设置）

在 Settings 中可配置：

• 账号与订阅、默认模型
• 默认权限/沙箱预设
• 插件（安装/管理）、连接器（Apps）
• Computer Use 插件与系统权限（屏幕录制 / 辅助功能）
• 功能开关（Features，如 Goal 模式）

许多设置等价于 ~/.codex/config.toml 里的字段，见 配置与定制。

#下一步

• 基础入门：用这套界面完成第一个任务
• 斜杠命令：/ 唤起的快捷操作
• 权限设置：搞清三个权限预设的区别