03 · 核心概念

深入理解 Trae 的三种模式、Agentic Loop 和”用嘴编程”的本质。

01 Trae 的三层架构

Trae 不是”一个 AI + 一个编辑器”的简单堆叠。它的设计哲学可以概括为三层递进：

┌─────────────────────────────────┐
│        SOLO 层（全自动）         │  ← AI 做主，你审核
│  "帮我做一个用户登录功能"        │
├─────────────────────────────────┤
│      Builder 层（半自动）        │  ← AI 执行，你随时改
│  "做一个带深色模式的博客"        │
├─────────────────────────────────┤
│       Chat 层（手动）            │  ← 你问，AI 答
│  "这段代码是什么意思？"          │
└─────────────────────────────────┘

每一层对应不同的协作深度。关键是在正确的时间进入正确的层次——不是越高越好，不是越低越安全。

02 Chat 层：问答式协作

两种 Chat 形态

Trae 的 Chat 有两种形式：

Chat 能做什么

• 解释代码逻辑：选中一段复杂代码，问”这段做了什么”
• 分析 Bug：“为什么这个函数返回 undefined”
• 技术问答：“这个项目用什么方式做路由比较好”
• 生成代码片段：“写一个防抖函数”
• 代码翻译：“把这段 JS 翻译成 Python”

Chat 的边界

Chat 模式下，每次代码修改都需要你手动确认（点 Apply 按钮）。AI 不会主动创建文件、装依赖、跑命令。这是最安全的模式，也最适合学习阶段。

心智模型：Chat 像一个随叫随到的导师——你问什么，它答什么；你说改哪，它改哪。控制权 100% 在你手里。

03 Builder 层：从描述到运行

Builder 是什么

Builder 是 Trae 和 Cursor 最大的区别点。你可以把它理解为嵌在 IDE 里的 Bolt.new——用自然语言描述你要的应用，AI 自动创建完整的项目并启动给你看。

Builder 工作流

你描述需求
    ↓
AI 分析需求 → 列出步骤
    ↓
自动创建文件 → 写代码 → 装依赖 → 启动 dev server
    ↓
右侧 Webview 实时预览 ← 你可以点、输入、交互
    ↓
追加修改描述 → AI 增量更新代码
    ↓
满意 → 一键导出或继续开发

Builder 模式的关键操作

Builder 的适用边界

最适合：

• 从零建原型：“我想看看这个想法能不能跑”
• 快速验证：“用 Next.js 搭个架子出来”
• 学习新技术栈：“帮我用 tRPC 写个示例”

不太适合：

• 在已有的复杂项目上新增功能（用 SOLO Coder）
• 需要精细代码控制的场景（用 Chat + Inline Edit）

心智模型：Builder 像找了个外包团队——你把需求文档（自然语言描述）给他们，他们搭好整个框架交给你看。你看完可以说”改这里”、“加那个”、“换个颜色”。

04 SOLO 层：AI 全自动工程师

SOLO 的核心理念

SOLO（The Real AI Engineer 的全自动形态）是 Trae 2.0 的旗舰功能。它的设计理念是：

你给目标，它给结果。中间过程它自己管理。

这和你用 Chat 模式”一步步指挥”截然不同。在 SOLO 下，你只需要：

1. 描述最终目标（“给这个项目加上用户认证”）
2. SOLO 自己做需求分析 → 方案设计 → 分步实现 → 测试 → 修 Bug → 部署
3. 你在每一步审核 diff，随时纠正方向

SOLO 的两个子智能体

SOLO Coder 的工作方式

SOLO Coder 不只是”看当前文件”——它会：

1. 读取整个项目：理解目录结构、模块关系、技术栈
2. 分析依赖：改一个文件时会检查影响哪些关联文件
3. 匹配现有风格：不会把 React class component 塞进一个全是 hooks 的项目
4. 自检修复：写完代码→跑测试→报错→自己定位→自己修→再跑测试→确认绿了

SOLO Builder 的工作方式

SOLO Builder 更侧重速度和从零构建：

1. 接收一句话需求
2. 生成 PRD + 技术架构文档（约 12 秒）
3. 自动拆解为 Todo Pipeline
4. 逐项实现，每完成一项就展示
5. 自检修复闭环
6. 一键部署（Vercel、Supabase）

什么时候用 SOLO

心智模型：SOLO 像雇了一个全栈工程师——你告诉他做什么，他做完给你看结果。你不需要告诉他每一步怎么做，但最终的结果你必须看得懂、审得过。

05 三种模式的切换策略

一个典型的工作流：

拿到一个新需求
    ↓
第一步：Chat 模式讨论方案（"这个功能怎么做比较好？"）
    ↓
第二步：如果是全新模块 → Builder 模式搭架子
         如果是现有项目加功能 → SOLO Coder 实现
    ↓
第三步：Chat 模式逐文件 review 改动
    ↓
第四步：Cmd+K 做局部微调
    ↓
第五步：SOLO 模式跑测试 → 确认绿了 → commit

关键原则：

• 先聊后做：用 Chat 讨论方案，对齐理解，再让 SOLO/Builder 执行
• 小步快跑：一次 SOLO 任务不要超过一个 commit 的量——拆成 5 个小任务，每个都能 review 和回滚
• 始终审核：SOLO 不是”甩手掌柜”模式——每一行 AI 写的代码，最终都要经过你的眼睛

06 小结

下一篇：04 界面总览 —— 熟悉 Trae 的界面布局和每个面板的作用。