Codex 需绑定 Flutter 项目上下文才能精准生成代码：先用 code . 打开含 pubspec.yaml 的根目录，执行 codex init --project-type flutter 建立符号索引，再通过 codex status 确认环境就绪；否则指令将返回通用模板而非适配代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让 Codex 真正帮你写 Flutter 代码，而不是生成一堆报错的 Dart 片段，必须先让它理解你的项目结构、识别当前上下文、并限制在安全范围内修改——它不会主动读你整个 lib/ 目录，也不会猜你用的是 GetX 还是 Riverpod，更不会替你处理 AndroidManifest.xml 里的权限声明。
让 Codex 看懂你的 Flutter 项目
打开 VS Code，确保已加载一个含 pubspec.yaml 的 Flutter 项目根目录；Codex 插件只有在此状态下才能自动识别 Dart SDK 路径、解析依赖版本、并推断出你大概率在用 MaterialApp 而不是 CupertinoApp。
在终端中执行 codex init --project-type flutter，这会触发 Codex 扫描 lib/ 下所有 .dart 文件，建立基础符号索引；【跳过此步会导致后续所有“帮我重构 XX 页面”类指令失效，它只会返回通用模板】。
执行 codex status，确认输出里包含 “Flutter SDK: 3.22.0+” 和 “Dart analysis server: ready”。如果显示 “no project context”，说明 Codex 没绑定到当前工作区——关掉所有窗口，用 code . 重新打开项目根目录。
三类高频协作场景与对应操作
第一步：定位问题文件 → 第二步：选中报错代码块（含 import 行和 build 方法）→ 第三步：右键 → “Codex: Explain Error”。
方法一：修复下拉刷新卡死这类生命周期陷阱
把 RefreshIndicator 的 onRefresh 回调整段复制进 Codex 输入框，附上错误现象：“松手后动画不消失，控制台无报错”。Codex 会立刻指出 “onRefresh 必须返回 Future
方法二：从零生成带状态管理的列表页
在 lib/ 目录新建 list_page.dart，在顶部写注释：// 生成一个 StatefulWidget 列表页：顶部 AppBar 标题为「任务」，主体是 SliverList + RefreshIndicator，支持下拉刷新和分页加载，使用 ChangeNotifier 管理 _items 列表，每页 15 条 mock 数据。光标停在注释下方，按 Ctrl+Enter（Win）或 Cmd+Enter（Mac），Codex 将输出完整可运行代码，含 import、ViewModel 类、Widget 类及 dispose 实现。
方法三：反向审计现有页面逻辑漏洞
打开 login_page.dart，全选整个 build 方法 → 右键 → “Codex: Audit Widget Tree”。它会逐行扫描：是否在 build 中调用 setState、是否未包裹 Scaffold 导致 MediaQuery.of(context) 报错、是否用了硬编码颜色值而没走 Theme.of(context).colorScheme；【若发现某行用了 DateTime.now() 且未加 const，它会直接标红并警告“每次 rebuild 都触发新实例，可能引发性能抖动”】。
关键配置统一接入 TaoToken
在项目根目录创建 .codex/config.json，填入：
{
"endpoint": "https://taotoken.net/api",
"api_key": "sk-xxx-your-taotoken-key-xxx"
}
这一步必须在首次运行 codex generate 前完成；【否则 Codex 默认连接公网模型，响应慢、无历史上下文、且无法复用 TaoToken 的多模型路由能力】。
执行 codex auth verify，看到 “✅ Auth OK, model: qwen2.5-coder-32b” 即表示接入成功。此后所有代码生成、调试建议、反向审计均走 TaoToken 统一通道，Key 不再散落在 .env 或 IDE 设置里。
