先弄懂它在做什么

很多人第一次用 Trae,会把它当成「会写代码的搜索框」。其实它更像一个能读文件、能动手、能自查的搭档。 这一页用六小节,把它的工作方式、能力边界和协作方法讲清楚。

智能体循环 能力地图 上下文 需求表达 安全边界

一个会「动手」的模型

普通聊天机器人只负责「回答」。你问一句,它答一句,答案停在对话框里。 而智能体(Agent)多了一整套手脚:它能读取你的项目、拆解目标、调用工具、修改文件, 再根据运行结果决定下一步做什么。

感知读文件、看报错、听你的描述
规划拆成步骤,决定先改哪里
行动写代码、跑命令、改配置
记忆保留上下文,复盘并修正

感知 → 规划 → 行动 → 记忆,如此循环,直到任务完成或需要你介入。

这个循环决定了它最重要的特点:它是在真实项目里工作的。 所以它既可能帮你一次改对五个文件,也可能因为一句含糊的描述,把整个页面改得面目全非。 理解循环,才知道什么时候该放手、什么时候该踩刹车。

聊天机器人与智能体的区别

维度聊天机器人智能体
输出形式一段文字或代码片段直接写入项目文件
任务长度单轮问答多步骤,可连续执行
信息获取依赖你粘贴的内容主动读取文件与目录
工具使用基本没有终端、预览、MCP 工具
自我检查通常不检查可运行、可查看、可修正

为什么它适合学开发

  • 反馈快:改完立刻能在预览里看到,错误也会出现在终端里,学习闭环很短。
  • 门槛低:不必先记住全部语法,可以先理解「结构」和「思路」。
  • 可观察:它会告诉你改了哪些文件、为什么改,你可以顺着它的思路学。
  • 可迁移:拆解需求、描述约束、验收结果,这些能力与工具无关。
本章要点 智能体的价值不在「替你写」,而在「在你的项目里连续做事」。任务越具体,循环越顺。

三种模式,三种放手程度

Trae 把「和 AI 协作」拆成了几种不同自主性的模式。名字可能随版本变化,但底层逻辑很好记: 你给的自由度越高,越需要提前说清楚目标和边界。

Chat 对话

问概念、解释代码、改一小段样式。改动范围通常可控,适合边聊边学。

适合:提问、局部修改、代码走读

Builder 构建

给出一个完整目标,由它规划并生成多个文件。入门阶段做页面,最常用就是它。

适合:从零建页面、批量改结构

SOLO 自主执行

更高的自主性,能自己拆步骤、连续执行并检查结果。目标要清晰,验收要明确。

适合:目标明确的中小型任务

别忘了工作台的其余部分

  • 上下文引用:用 # 唤起文件、文件夹、文档或网页,把「你说的那个文件」变成确定的对象。
  • 项目规则:把技术栈、目录约定、代码风格写进规则文件,减少每次重复交代。
  • MCP 工具:接入外部服务与数据源,让智能体不只会写代码,还能查、能取、能操作。
  • 终端与预览:运行结果和页面效果都在眼前,报错可以直接交给它定位。
  • 版本管理:用 Git 留下可回退的节点,是安全感的来源。

怎么选

你的任务建议方式原因
「这段代码什么意思?」Chat只需要解释,不需要改文件
「把按钮颜色改浅一点」Chat改动明确且局部
「做一个完整的二手书页面」Builder需要多文件规划与生成
「按这份需求把功能补完」SOLO / Builder目标完整,步骤可由它拆解
「重构整个项目结构」先规划再执行影响面大,需要人工确认方案
版本提示 不同版本、不同地区的 Trae 在模式名称、可用模型和功能开放度上可能不同。学习时记住「自主性分级」这个思路即可,具体入口以客户端为准。

它只能看见你递给它的东西

智能体很聪明,但没有读心术。它对你项目的全部理解,来自当前对话、你引用的文件、以及它主动读到的内容。 所谓上下文工程,就是有意识地决定:让它看见什么、忽略什么、先看什么。

上下文的优先级

目标与约束:要做什么、不能做什么最重要
相关文件:真正会被改动的代码次之
示例与素材:参考风格、数据结构按需

背景知识不是越多越好。无关文件会稀释注意力,让模型抓错重点。

四个动作

  • 给足:涉及哪些文件就引用哪些,别让它靠猜。必要时贴上报错原文。
  • 去噪:只带当前任务需要的文件。大项目里尤其要克制。
  • 渐进:先让它读结构、给方案,再逐步深入具体文件。
  • 可验证:给出判断标准,例如「手机上不横向滚动」「控制台无报错」。

引用比描述可靠

与其说「改一下那个卡片」,不如把对应的文件递给它。常见的引用方式是用 # 唤起选择器:

# 引用具体文件,让它只关注这里
请优化 #index.html 中「学习路线」区块的间距,
保持现有的米白色调,不要改动其他区块。

# 引用文件夹,适合需要通读结构时
看一下 #assets 目录的组织方式,
告诉我新增一个详情页时文件应该放在哪里。
模糊

「帮我改好看一点」

没有对象,没有标准,智能体只能凭自己的审美大改一通。

清楚

「卡片间距从 12px 调到 20px」

对象明确、数值明确、范围明确,改完就能验收。

一句话记住 上下文不是「越多越好」,而是「越相关越好」。

把「想要」翻译成「可执行」

和智能体协作,写作能力比编程基础更早派上用场。一条好的需求,通常包含四个部分: 目标、输入、约束、验收。缺哪一块,它就只能替你猜。

要素回答的问题例子
目标最终要得到什么?做一个校园二手书列表页
输入基于什么来做?沿用现有 index.html 的配色与字体
约束哪些不能变?只用原生 HTML/CSS/JS,不引入框架
验收怎样算完成?手机端单列、桌面端三列,无横向滚动

一条可以直接用的需求

# 目标
在现有项目里新增「校园二手书」页面 books.html。

# 输入
参考 #index.html 的导航与页脚,配色沿用
米白、雾绿、浅粉,字体保持不变。

# 约束
- 只用原生 HTML / CSS / JavaScript
- 不新增第三方依赖
- 不要改动首页文件

# 验收
- 桌面端三列、手机端单列
- 每张卡片包含书名、价格、成色、联系方式
- 页面无横向滚动,控制台无报错

请先给出文件规划,再开始写。

三个小技巧

  • 用可执行的动词:「新增」「替换」「调整到 20px」比「优化」「美化」更容易落地。
  • 一次只改一件事:同时改布局、配色和文案,出问题时很难定位是哪一步错了。
  • 让它先复述:「请先复述你理解的需求,再动手」,能提前暴露误解。
一次性大改

「把整个网站重做,风格高级一点」

范围过大、标准主观,结果往往需要全部推倒重来。

小步迭代

先改导航,再改首屏,最后统一圆角

每一步都能预览、能回退,错了也只影响一小块。

像带实习生一样带它

最稳的协作节奏,不是「一句话生成整个网站」,而是把任务切成一个个可以验收的小块。 下面这个四步循环,适用于从改一个按钮到做一个完整页面。

1 · 计划

先让它说明:要改哪些文件、大致怎么做、有哪些风险。你确认后再执行。

2 · 执行

一次一个目标,范围写清楚。需要时明确「只改样式,不动结构」。

3 · 检查

自己打开预览看一遍:布局、文案、交互、控制台报错。别只看它的总结。

4 · 留痕

满意就提交一次 Git。有可回退的节点,才敢让它大胆改。

一个真实的回合长什么样

# 你
卡片在小屏幕上挤在一起了。请只调整 #assets/css/style.css
中的 .grid-3,在 720px 以下改为单列,其他断点不动。
改完告诉我改了哪几行。

# 智能体
已修改 .grid-3 的媒体查询:
- 新增 max-width: 720px 下单列布局
- 调整 gap 为 16px
- 未改动 960px 断点与其他选择器

# 你
预览确认通过。提交。

出现这些信号,先停一下

信号建议动作
它开始修改你没提到的文件暂停,要求它列出改动清单并解释原因
同一个问题改了三轮还没好停止重试,补充报错原文或换一种描述
它说「已完成」但页面没变化自己检查文件与预览,不要只信总结
需求越说越复杂退回上一版,把任务拆小
习惯 每完成一个可验收的小步,就提交一次。版本历史是你和智能体协作时最踏实的保险。

能做完,也要做得安心

智能体会读写文件、执行命令。给它自由的同时,也要给它边界。以下几条,建议从第一天就养成。

不把密钥交给对话

API Key、密码、身份证号、他人隐私,都不要粘贴进对话或写进示例文件。用环境变量或占位符代替。

审查它要执行的命令

删除文件、安装依赖、修改系统配置这类操作,先看清命令再确认。不确定就让它解释每一步。

重要项目先备份

开始大改之前先提交一次,或者复制一份文件夹。有退路,才敢让它放手做。

对产出保持判断

它会自信地说错话,也可能生成有版权风险的素材。提交作业或上线前,请自己读懂并负责。

关于学习诚信

用智能体学习,和用智能体代做,是两件事。建议把 AI 当作「随时可问的助教」: 让它解释、让它出练习题、让它 review 你的代码。但课程作业与考核,请遵守所在学校或团队的规定。

边界感 你可以随时打断、撤销、回退。智能体的自主性再高,最终按下确认键的仍然是你。

理论看完了,去动手吧

下一站是实操教程:安装、建项目、用 Builder 完成第一个页面,再把它改到满意。

进入实操教程