第一章：为什么是 Trae？

1.1 你要的不是“写代码更快”，而是“交付更稳定”

AI 写代码早就不是新鲜事，但工程效率的上限不取决于“能不能生成代码”，而取决于：

• 能不能快速找到证据链（入口、调用链、关键约定）
• 能不能把改动控制在边界内（目录、依赖、风格）
• 能不能交付可审阅的变更（diff 清晰、可回滚）
• 能不能跑通验证（tests/lint/typecheck/build）

Trae 的价值在于把“对话”变成“可执行的工程流程”：通过工具去搜索、阅读、修改、运行、诊断，把结果落在可审阅的变更集里。

1.2 Trae 适合的场景（高收益）

高收益场景通常有一个共同点：验收标准明确。

• 修 bug：复现→定位→修复→回归验证
• 小功能：改动范围明确、边界清晰、能跑通用例
• 重构：拆分长函数、消除重复、补测试
• 代码理解：快速梳理模块职责与调用路径
• 例行工作：PR 预审、CI 失败分析、依赖升级建议

不适合的场景也要提前知道：

• 需求与边界完全不清，只靠模型“猜”
• 高风险数据/权限场景但没有审阅与门禁

1.3 本系列怎么学：从“会用”到“用得稳”

本系列按“交付闭环”组织：

1. 环境准备（第 2 章）
2. 第一次交付（第 3 章）
3. 工具链三件套：查/改/验（第 4-6 章）
4. 规则与协作（第 7-8 章）
5. 自动化与安全（第 9-10 章）
6. 团队落地与排障（第 11-12 章）

下一章先把环境准备好：项目打开、终端可用、基础配置明确，避免“工具跑不起来”的低级返工。