第十二章 避坑指南与持续成长

一、新手 90% 会踩的 8 大坑

坑 1：「我不会代码所以我不能用」

症状：看到 Trae 是 IDE，吓到了，关闭，再也没打开过。

真相： 本书前面 11 章你已经看到——90% 的需求一句话就能搞定，不需要看一行代码。 Trae 的真正用户里，有相当大比例是非程序员——运营、销售、文案、宝妈、退休老人。

避坑做法：

• 把 Trae 当"24 小时陪你的中文工程师同事"，不是当 IDE。
• 第一周只用 Builder 模式，只用对话框，永远不点代码窗口。
• 跑完第二章的"5 分钟简历页"——你会发现这件事比你想的简单 100 倍。

坑 2：「一个超复杂的提示词扔过去，期待 AI 一次做完」

症状：

"帮我做一个像滴滴一样的打车 App，要有用户端、司机端、后台管理、订单系统、支付、地图、客服……"

5 分钟后看到 AI 给你一堆错误代码，怀疑人生。

真相： AI 不能"一口气吃成胖子"。任何复杂的项目都要拆成"小步快跑"的迭代——

• 先做"能跑起来的最小版本"。
• 再加一个功能。
• 再加一个功能。
• ……

避坑做法：

• 用第五章学的 Plan→Act——任何复杂任务先让 AI 给方案。
• 每次让 AI 改的事情不超过 3 件。
• 每完成一个小步骤，git commit 一次——失败可以回退。

坑 3：「全盘接受 AI 的代码，从不审核」

症状： AI 给你 200 行代码，你看都不看就点"全部接受"。 两个月后想改某个细节，发现：

• 代码里有 30 行你完全不知道在干嘛。
• 加了 10 个第三方包，你没听过其中 8 个。
• 性能很差，但你不知道哪里慢。

真相： AI 写的代码 ≠ 一定对的代码。它可能：

• 用了过时的写法。
• 引入了不必要的依赖。
• 留下了"幻觉 API"（不存在的方法名）。
• 没考虑边界情况。

避坑做法：

• 每次"全部接受"前至少看一遍变更摘要——AI 改了哪些文件、新增了什么。
• 重要项目让 AI 自己评分：1-10 分这段代码质量如何？低于 7 让它优化。
• 小项目可以"接受 + 跑一遍"；重要项目至少手动测试关键路径。

坑 4：「依赖单一模型，模型一变就垮」

症状： 你做了一个 SaaS，全部依赖 DeepSeek-V3。某天 DeepSeek 涨价 / 限流 / 改 API，你的产品立刻挂掉。

真相： 模型层是"易变层"——价格、能力、可用性都会变。

避坑做法：

• 代码里抽象出"AI 调用层"——业务代码不直接调 OpenAI / DeepSeek，而是调你自己的 aiClient.chat()。
• aiClient 内部支持多种模型，可以一键切换。
• 让 Trae 帮你做这个抽象：

@Builder

帮我重构 src/api/openai.js，
做成一个抽象的 aiClient，支持：
- DeepSeek（默认）
- Doubao
- OpenAI
- Claude

业务代码只调 aiClient.chat()，
切换模型只改环境变量 AI_PROVIDER。

坑 5：「用 AI 写出第一版就上线，没考虑安全 / 异常 / 性能」

症状： Trae 帮你做了一个工具，本地跑挺好，部署到线上：

• 有用户输入特殊字符就崩。
• 100 个并发就 Down。
• 有人发现接口能直接刷你的 OpenAI 余额。

真相： Demo ≠ 生产。AI 默认产出的是"能跑的最小版本"，不会自动加这些：

• 输入校验
• 错误处理
• 防滥用（限流）
• 隐私脱敏
• 性能优化
• 监控告警

避坑做法： 真正要"上线给陌生人用"前，加一份"上线检查清单"提示词：

@Builder

我准备把这个项目部署到 Vercel 给陌生人用。
帮我做"上线前检查"：

1. 列出所有用户输入点 → 加输入校验。
2. 检查所有 API 调用 → 加 try/catch。
3. 给所有调用 AI / 数据库 的接口加限流（每个 IP 每天 N 次）。
4. 检查日志里是否打印了用户敏感信息（手机号 / 邮箱 / Token）→ 脱敏。
5. 加一个 "/health" 健康检查接口。
6. 加 robots.txt 和 404 页面。
7. 给我一份"还需要做什么"的清单。

坑 6：「沉迷于'重构'和'完美'」

症状： 做出一个工具能用，但你觉得"代码还可以更优雅"——

• 改命名 → 没问题
• 改架构 → 重构 1 周
• 升级技术栈 → 重写 3 周
• ……一直没真正用上

真相： 完美是 Done 的敌人。 用户不在乎你代码是什么样的——用户只在乎能不能解决问题。

避坑做法：

• 设一个"够用就停"的标准——比如"能解决我 80% 的需求就上线"。
• 重构只在"现在的代码已经妨碍我加新功能"时做，不为重构而重构。
• 优先做新功能，而不是优化老功能。

坑 7：「项目文件夹爆炸，找不到东西」

症状： 你做了 30 个项目，全部塞在桌面：

桌面/
├── 简历网站
├── 简历网站_v2
├── 简历网站_最终版
├── 简历网站_最终版_新
├── 一个工具
├── 那个工具
├── 上次客户要的东西
├── ...

找一个项目要 5 分钟。

真相： 项目结构 = 你的"AI 时代生产力地基"。地基乱了，你会经常重复造轮子。

避坑做法： 按这个结构整理：

~/Documents/trae-projects/
├── 01-上线项目/        # 已经上线、给别人用的
│   ├── personal-site/
│   ├── ai-naming/
│   └── ...
├── 02-个人工具/         # 自己用的
│   ├── file-organizer/
│   ├── weekly-report/
│   └── ...
├── 03-学习实验/         # 跟着教程做的、试新东西的
│   ├── trae-book-cases/
│   └── ...
└── 99-archive/         # 不再维护的

让 Trae 帮你写一个"项目目录"工具：

@Builder

帮我做一个项目目录工具 my-projects.html。

读取 ~/Documents/trae-projects/ 下所有文件夹，
每个项目读它的 README.md 第一行作为简介，
按"上线项目 / 个人工具 / 学习实验"分类展示。

每个项目卡片显示：
- 名字
- 简介
- 上次修改时间
- 在 Trae 中打开按钮（call trae:// 协议）

让我能一眼看完所有作品。

坑 8：「忽视'对话历史'，每次重新开始」

症状： 做项目 A，跟 Trae 对话 50 轮，搞清楚了一堆约束。 关掉 Trae，第二天回来，发现全部历史没了——又要从头跟 AI 解释一遍。

真相： Trae 的对话默认是"会话级"的——关掉就清空。 你需要把"沉淀下来的决策"显式保存。

避坑做法： 对每个长期项目，建一个 .trae/decisions.md（或 notes/decisions.md）记录：

# 项目决策日志

## 2026-04-19 技术栈
- 前端：HTML + TailwindCSS + 原生 JS（不用 React，因为简单）
- 后端：Vercel Functions
- AI：DeepSeek-V3
- 数据：localStorage（先不上数据库）

## 2026-04-22 命名规范
- 文件名 kebab-case（user-profile.html）
- JS 变量 camelCase
- 中文注释

## 2026-04-25 已确认的设计
- 配色：#FF6B35 + 白
- 字体：思源黑体
- 圆角：0.75rem

## 2026-05-01 不要做的事
- 不要做用户登录系统（增加复杂度）
- 不要接数据库（成本上升）
- 不要做移动端原生 App（先 Web 验证）

每次跟 Trae 开始新对话时：

@Builder
请先读一下 #notes/decisions.md，了解这个项目的所有决策。
然后帮我做：xxxxx

这是你和 AI 长期协作的"共同记忆"。

二、隐私与安全 5 条底线

底线 1：永远不在提示词里贴真实身份证 / 银行卡 / 密码

即使本地用 Trae，AI 模型可能会上传到云端。

正确做法：

• 测试用假数据——身份证 11010119900101001X、银行卡 6222020200112233000。
• 处理真实数据时先脱敏——身份证显示成 110101****001X。

底线 2：API Key 用环境变量，不要硬编码

错的：

const apiKey = "sk-abc123xxxx"; // 直接写在代码里

对的：

const apiKey = process.env.OPENAI_API_KEY;

并且 .env 文件要在 .gitignore 里——绝对不能 push 到公开仓库。

让 Trae 帮你检查：

@Builder

帮我扫描整个项目，找出所有可能硬编码的 API Key、密码、Token。
列出位置 + 改成环境变量的方案。
顺便检查 .gitignore 是否包含 .env、.trae/local/、node_modules/、*.key 等敏感文件。

底线 3：自己电脑数据备份分三层

• 代码 / 项目：Git + GitHub（自动多机备份）。
• 重要文档：Google Drive / 阿里云盘（云端）+ 移动硬盘（本地）。
• 一次性的实验：可以不备份，做完就归 archive。

底线 4：MCP 严格按"最小权限"原则

第九章讲过的 7 条铁律——再强调一遍：

• Filesystem 只给具体目录，不给 /。
• 数据库给只读账号。
• API Token 用环境变量。
• 敏感操作 Plan→Act。
• mcp.json 不提交 Git。
• 重要数据先备份。
• 定期 review 已装的 MCP。

底线 5：商业敏感数据不要交给 AI 处理（除非企业版）

• 公司财务数据
• 客户名单
• 未公开的产品计划
• 内部薪资

这些用本地 Excel 处理，不要丢给云 AI。 如果必须用 AI，用本地部署的开源大模型（Ollama + Qwen2.5）。

让 Trae 帮你装本地大模型：

@Builder

帮我在本机装 Ollama，然后下载 qwen2.5:7b 模型，
做成一个本地命令行工具 local-ai，
我以后跑 `local-ai "总结一下这段..."` 就能本地推理，
不会上传任何数据到云端。

三、长期成本管控

3.1 国内版用户（推荐路径）

建议：先用国内版 + DeepSeek API 做副业 SaaS，月入超过 5000 再考虑升级。

3.2 国际版用户

3.3 节省成本的 8 个技巧

1. 能用国内免费就用国内免费——除非真的需要 Claude 的"理解力"。
2. DeepSeek-V3 替代 GPT-4 ——能力接近，价格 1/30。
3. 简单任务用 Doubao，复杂任务才用 DeepSeek-R1 / Claude。
4. 缓存 AI 回答——同样的问题不要重复问，用 localStorage / Redis 缓存。
5. 批处理代替单次调用——能 1 个请求做完的，别拆 10 个。
6. 本地大模型替代部分 SaaS 调用——Ollama + Qwen2.5 跑常规需求。
7. 定时清理无用项目——避免不必要的 Vercel 部署消耗。
8. 关注每月账单——所有 AI 服务都给你看 Token 消耗，每月 1 号查一次。

四、Trae 长期使用的 7 个原则

原则 1：保持"AI Native"心态

每次想做新事情时，先问自己：

"如果让 AI 来做，怎么做？"

而不是：

"让我自己想想怎么做……做不出来再用 AI。"

这种"AI First"的思维转变，是普通人和高效用户最大的差别。

原则 2：项目从小到大，从快到慢

每周做 1 个小项目（30-60 分钟能跑通的）—— 积累 1 年 = 50 个小项目 = 50 个能解决你具体问题的工具。

每季度做 1 个"中项目"—— 积累 1 年 = 4 个能拿出去给别人看 / 用的作品。

每年做 1-2 个"大项目"—— 真正的"代表作"——可以求职、可以变现、可以建立个人品牌。

原则 3：永远写"决策日志"

不只是为了 AI 协作——也是为了未来的你。

3 个月后你回头看自己写的代码，"咦，当时为什么这么设计？"—— 打开 decisions.md —— "哦原来是因为 X 约束"。

原则 4：定期复盘"我和 AI 的协作模式"

每月问自己 5 个问题：

1. 这个月我用 Trae 做了几件事？
2. 哪几次明显比"我自己做"快？
3. 哪几次反而 AI 出了"幻觉"让我多花了时间？
4. 我能给 Trae 配什么"规则 / 智能体"，让下次更顺？
5. 下个月想用 AI 解决什么新问题？

复盘 = 进步。

原则 5：建立你自己的"提示词库"

看到好用的提示词就保存——可以放在：

• ~/.trae/prompts/ 文件夹
• Notion 数据库
• iCloud 备忘录
• 微信收藏

按"工作 / 生活 / 学习"分类。1 年下来你会有几百条专属于你的提示词。

原则 6：跟一个"AI 同行社区"

Trae 中文用户活跃在：

• 即刻 App "用 Trae 的人" 圈子
• 掘金 Trae 官方专栏
• 小红书"Trae"标签
• B 站 Trae 教程区
• 微信"Trae 中文用户群"（在官网申请加入）

有同伴 = 你不会孤独地走 AI 这条路。

原则 7：别忘了"AI 之外的能力"

AI 帮你解决了"实现"的环节，但有些事 AI 做不到：

• 想清楚"做什么"（问题定义）
• 决定"为谁做"（用户洞察）
• 判断"什么是好"（审美 / 品味）
• 长期坚持"做下去"（毅力 / 节奏感）

继续读书、继续观察用户、继续培养自己的判断力—— AI 越强大，你的"非 AI 能力"反而越值钱。

五、给不同人群的 6 个月成长地图

5.1 完全零基础的"AI 新人"

目标：6 个月内从"不会用 AI"到"AI 重度用户"。

6 个月后：你已经超过 90% 的"看了就放着没用"的人。

5.2 已经会用 ChatGPT / 文心 的"进阶用户"

目标：从"AI 助手用户"升级为"AI 工程师"。

5.3 已经会编程的"开发者"

目标：从"会写代码"到"AI 协同高效开发"。

六、避坑 + 成长的"45 天速成法"

如果你想"45 天进入 AI 高效用户的 Top 10%"，按这个时间表：

第 1-7 天：建立基础

• Day 1：装 Trae，跑通第二章简历页。
• Day 2：跑通第七章 7.1 桌面整理工具。
• Day 3：跑通第七章 7.2 家庭账本。
• Day 4：建立 ~/.trae/rules/user_rules.md（第六章模板）。
• Day 5：跑通第八章 8.1 周报生成器。
• Day 6：建立你的项目目录结构。
• Day 7：休息 + 复盘第一周收获。

第 8-21 天：做出有用的东西

• Day 8-14：每天做一个第七 / 八章的小项目。
• Day 15-17：做一个完整的端到端项目（第十一章）。
• Day 18-21：让你的简历网站上线，分享给 5 个朋友。

第 22-35 天：组建你的 AI 团队

• Day 22-25：创建 5 个自定义智能体（第十章模板）。
• Day 26-30：装 5 个 MCP（第九章推荐套餐）。
• Day 31-35：用智能体团队做一个完整的副业 MVP。

第 36-45 天：开始变现

• Day 36-40：把 MVP 上线，接入支付。
• Day 41-43：发到 1-2 个社区做种子推广。
• Day 44-45：复盘，迭代第二版。

45 天后：你已经是"AI 时代的创作者"，而不是"AI 时代的旁观者"。

七、本章一图回顾（文字版）

8 大坑
    │
    ├─ 1. 我不会代码所以不能用 → 错，本书 90% 不需要看代码
    ├─ 2. 复杂提示词期望一次完成 → 用 Plan→Act
    ├─ 3. 全盘接受 AI 代码 → 至少看一遍变更摘要
    ├─ 4. 依赖单一模型 → 抽象 AI 调用层
    ├─ 5. Demo 直接上线 → 加上线检查清单
    ├─ 6. 沉迷重构追完美 → 用户不在乎，先解决问题
    ├─ 7. 项目文件夹爆炸 → 按"上线/工具/学习/归档"分
    └─ 8. 忽视对话历史 → 写 decisions.md

5 条底线
    │
    ├─ 1. 不贴真实身份证/银行卡/密码
    ├─ 2. API Key 用环境变量
    ├─ 3. 数据备份三层
    ├─ 4. MCP 最小权限
    └─ 5. 商业敏感数据用本地大模型

7 大原则
    │
    ├─ 1. AI Native 心态
    ├─ 2. 小项目快迭代
    ├─ 3. 写决策日志
    ├─ 4. 定期复盘
    ├─ 5. 建立提示词库
    ├─ 6. 跟同行社区
    └─ 7. 培养"非 AI 能力"

45 天速成法
    │
    ├─ Week 1: 基础（跑通第二章 + 几个小项目）
    ├─ Week 2-3: 做出有用东西 + 上线第一个网站
    ├─ Week 4-5: 组建 AI 团队（智能体 + MCP）
    └─ Week 6+: 启动副业 → 接入支付 → 推广 → 迭代

八、本书结尾的话

如果你已经读到这里—— 恭喜你。

我们一起从"什么是 Trae"走到了"我有一支 AI 团队，正在做能赚钱的副业"。 这条路上你看到了 12 个章节的内容，做过（或将要做）大约 15 个真实项目。

但这本书不是"终点"，而是"地图"。

下一步，由你自己走。

你可以做的三件事

1. 挑一件事，今天就开始——不要等"准备充分"。打开 Trae，跑第二章的 5 分钟简历页。30 分钟后你已经有了一个能给别人看的东西。

2. 做出第一个能上线的产品——按第十一章的步骤，一个属于你的网址 yourname.com。这是你"AI 时代身份证"。

3. 持续输出，把成果给世界看——做一个东西就发一次（朋友圈 / 即刻 / 小红书）。做 30 个，你就成为"那个会用 AI 的人"。

关于"普通人"的话

这本书叫《Trae 橙皮书》，写给"普通人"。

但我们对"普通人"的定义是—— 那些没有"先天优势"，但愿意用工具去抹平差距的人。

不是"运气好的人"， 不是"出身好的人"， 不是"在大厂工作的人"， 是就是你。

AI 不会让聪明人更聪明——AI 让普通人第一次拥有"杠杆"。

你这一生有没有可能做出让自己骄傲的东西？ 答案不在"等一个机会"， 答案在今天打开 Trae 的那一下。

"未来已来，只是分布不均。" — William Gibson

Trae 在这里，等的是你。

接下来是 5 个附录：

• 附录 A 快捷键与常用操作速查表
• 附录 B 30 个开箱即用提示词
• 附录 C 术语表
• 附录 D 资源与社区链接
• 附录 E 100 项达成清单

收藏起来，当你迷路时，回来翻一翻。

—— 完 ——