TRAE 国内版 Solo 功能完整使用文档

浪浪山_大橙子
3,185 阅读13分钟

TRAE 国内版 Solo 功能完整使用文档

文档版本：V1.0（2025年11月更新） 适用场景：开发者使用 TRAE 国内版 Solo 模式进行代码开发、项目搭建、功能迭代等工作 核心价值：通过智能体协同与高效交互设计，实现从需求到落地的全流程开发提效，支持单开发者独立完成复杂任务

一、功能概述：什么是 Solo 模式？

Solo 是 TRAE 国内版为独立开发者打造的智能开发模式，通过内置专业智能体与灵活的协作机制，将 AI 能力深度融入开发全流程。其核心优势在于：无需团队协作即可实现复杂任务拆解、自动化流程推进，同时支持个性化配置以匹配不同开发习惯，大幅降低重复工作成本，提升开发效率与交付质量。

1.1 核心智能体介绍

Solo 模式内置两大核心智能体，覆盖不同开发场景，选择匹配的智能体是提效的第一步：

  • SOLO Coder：专注「复杂任务处理与迭代」，具备强大的项目理解和上下文管理能力，自动编排智能体协同工作。 适用场景：现有代码库的迭代优化、Bug 修复、代码重构、跨模块变更、接口改造等。
  • SOLO Builder：擅长「从0到1落地新项目」，支持端到端全链路开发。 适用场景：全新应用搭建、需求文档转技术方案、快速原型开发、从设计到代码的完整落地等，流程覆盖「需求解析→技术文档→代码开发→服务预览→发布上线」。

1.2 适用人群与核心场景

  • 适用人群：独立开发者、小型项目负责人、需要快速验证想法的产品经理、技术学习者。
  • 核心场景：单模块开发、代码优化、Bug 定位修复、新项目原型搭建、技术方案生成、开发过程中的问题咨询。

二、基础操作：从入门到启动

2.1 进入 Solo 模式

  1. 登录 TRAE 国内版客户端或网页端，进入主界面；
  2. 点击左侧导航栏「开发模式」，选择「Solo 独立开发」；
  3. 首次进入需选择智能体类型（SOLO Coder / SOLO Builder），后续可在顶部工具栏切换；
  4. 创建工作空间：输入项目名称（如「电商小程序首页开发」），选择开发语言（如 JavaScript/Java），点击「启动 Solo 模式」完成初始化。

2.2 核心交互：指令输入与优化

清晰的指令是 AI 精准输出的核心，Solo 模式提供多重能力辅助优化输入，新手也能快速给出专业指令。

2.2.1 优质指令的核心要素

避免模糊表述，指令需包含「任务目标+具体要求+上下文信息」，示例如下：

低效指令：优化这段代码

高效指令：重构下方用户登录模块代码（见#login.js），要求：1. 将用户验证逻辑提取为独立函数 checkUserAuth()；2. 增加手机号格式校验与密码强度提示的错误处理；3. 遵循 ES6 代码规范，变量命名采用小驼峰式。

2.2.2 指令优化工具的使用

若不确定指令是否清晰，可使用内置「Prompt 优化」功能：

  1. 在对话输入框中输入初始指令；
  2. 点击输入框右侧「优化输入内容」按钮（图标为✨）；
  3. 系统自动生成优化后的指令，可直接使用或手动修改后发送；
  4. 支持多次点击「重新优化」，直到获得满意的指令表述。

2.2.3 上下文引用技巧

处理复杂任务时，通过「#符号」引用相关资源，帮助 AI 精准理解背景：

  • 引用文件：输入「基于#api文档.pdf中的用户接口定义，开发对应的后端服务代码」，系统自动关联已上传的文件；
  • 引用代码片段：在代码编辑器中选中目标片段，点击「加入对话」，自动生成引用标识，指令中可直接关联；
  • 引用历史对话：输入「延续#3中的登录模块开发，完成注册功能代码」，AI 将继承此前的开发逻辑与风格。

2.3 基础功能：任务计划与进度跟踪

2.3.1 开启 Plan 模式，先规划再开发

针对 Bug 修复、架构重构等复杂任务，建议先开启 Plan 功能制定开发计划，避免偏离预期：

  1. 在输入指令前，勾选输入框下方「开启 Plan 模式」；
  2. 发送指令后，AI 会先输出详细开发计划，包含「任务拆解、技术选型、步骤安排、预期结果」等内容；
  3. 查看计划后，可直接点击「按此计划执行」，或提出修改意见（如「将步骤2的接口测试提前到代码开发后」）；
  4. 计划确认后，AI 将按步骤推进开发，过程透明可控。

2.3.2 待办清单：掌握开发节奏

Solo 模式会自动将任务拆解为待办清单，实时标记进度，在对话界面右侧「任务面板」中展示：

  • 自动拆解：AI 根据任务复杂度拆分节点（如「需求分析→架构设计→代码开发→测试优化」）；
  • 进度可视化：完成节点标记为绿色✔️，进行中为黄色🔄，未开始为灰色○；
  • 精准交互：点击节点可展开详细内容，支持针对单个节点提出修改要求（如「优化‘代码开发’节点中的前端样式逻辑」）；
  • 摘要生成：对话过长时，系统自动折叠冗余内容，生成进度摘要，重点一目了然。

三、进阶技巧：提升开发效率

3.1 多任务并行：同时推进多个模块

Solo 模式支持在同一工作空间内并行处理多个任务，避免单任务阻塞，操作方式如下：

  1. 新建任务：使用快捷键（Mac：Command+Control+N；Windows：Ctrl+Alt+N）或点击顶部「+新建任务」按钮；
  2. 命名任务：为每个任务设置清晰标题（如「任务1：用户中心接口开发」「任务2：登录页前端样式优化」）；
  3. 任务管理：左侧「任务列表」中可快速切换不同任务，系统自动为每个任务生成智能标题与进度标签；
  4. 高效策略：将大项目拆分为「核心功能开发+问题咨询+次要模块」三个并行任务，定期查看各任务进度摘要，及时纠偏。

3.2 精准操作：元素选择与问题定位

针对 UI 开发或 Bug 修复场景，Solo 提供可视化操作能力，无需复杂指令即可实现精准修改。

3.2.1 UI 元素精准迭代

  1. 在 Solo 内置浏览器中预览开发成果；
  2. 点击浏览器右上角「选择元素」按钮（图标为十字准星）；
  3. 鼠标点击目标 UI 组件（如按钮、导航栏），系统自动识别并在对话中关联该元素的代码；
  4. 直接输入修改要求（如「将这个按钮的背景色改为#1677ff，圆角设置为8px」），AI 快速完成优化。

3.2.2 日志关联与 Bug 修复

遇到运行报错时，无需手动复制日志，直接关联即可快速定位：

  1. 打开底部「控制台」面板，找到报错日志；
  2. 右键点击日志，选择「加入对话」；
  3. 输入指令「分析此报错原因并修复对应的代码」，AI 自动定位问题代码并给出解决方案。

3.3 快捷键与高效操作

掌握常用快捷键可减少鼠标操作，提升开发流畅度，以下是 Solo 模式默认快捷键（支持自定义修改）：

操作动作MacOS 快捷键Windows 快捷键
新建任务Command + Control + NCtrl + Alt + N
代码自动补全Command + SpaceCtrl + Space
打开命令面板Command + Shift + PCtrl + Shift + P
打开文件/文件夹Command + OCtrl + O
打开设置界面Command + ,Ctrl + ,
报告问题/反馈Command + K , Command + RCtrl + K , Ctrl + R
界面放大Command + 加号Ctrl + Shift + 加号
界面缩小Command + 减号Ctrl + Shift + 减号

自定义快捷键路径：点击顶部「设置」→「通用」→「快捷键设置」，可修改、添加或删除快捷键组合。

3.4 语音输入：解放双手

针对冗长指令或不便打字场景，可使用语音输入功能：

  1. 点击输入框左侧「麦克风」图标，开启语音输入；
  2. 清晰说出指令内容（如「基于 Vue3 框架，开发一个包含搜索框、轮播图和商品列表的首页组件，要求适配移动端屏幕」）；
  3. 语音内容实时转录为文字，确认无误后点击发送；
  4. 点击麦克风图标可关闭功能，支持普通话与英文语音输入。

四、精通策略：个性化配置与高级功能

4.1 自定义智能体：组建专属 AI 团队

SOLO Coder 支持创建自定义智能体，针对特定领域分工协作，解决长对话中模型效果下降的问题。

4.1.1 快速创建自定义智能体

  1. 点击顶部「智能体管理」→「新建自定义智能体」；
  2. 输入基础信息： - 智能体名称（如「前端样式大师」）； - 核心职责（如「专注 CSS/LESS 样式开发，擅长响应式布局与动画效果优化」）； - 专业领域（勾选「前端开发→样式设计」）；
  3. 点击「智能生成配置」，系统自动补充提示词与调用规则；
  4. 优化配置：可添加范例（如「好的样式：简洁清晰，兼容主流浏览器；坏的样式：使用内联样式，未做适配」），点击「保存」完成创建。

4.1.2 智能体调用方式

  • 自动调用：复杂任务中，SOLO Coder 会根据需求自动分配给对应自定义智能体；
  • 手动调用：在指令中输入「@前端样式大师 优化此页面的响应式布局」，直接指定智能体处理。

4.2 个性化规则配置：匹配个人开发习惯

通过配置个人规则，让 AI 输出默认符合你的编码风格与标准，避免重复修改：

  1. 路径：顶部「设置」→「AI 交互」→「个人规则」；
  2. 核心配置项： - 语言偏好：对话语言（中文）、编程语言（默认 JavaScript）； - 代码规范：勾选「遵循 ESLint 规范」「变量命名小驼峰」「注释占比≥15%」； - 输出格式：「代码+注释+使用说明」的固定结构； - 专业要求：「优先使用开源框架」「避免冗余代码」等；
  3. 项目级规则：若不同项目要求不同，可在工作空间内设置「项目规则」，优先级高于个人规则；
  4. 保存后重启 TRAE，规则即可生效，后续 AI 输出将自动匹配配置。

4.3 上下文管理：保持模型聚焦

长对话会导致上下文冗余，影响 AI 理解重点，可通过以下方式优化：

  • 自动压缩：当对话长度超过 50 轮，系统自动压缩历史冗余信息，保留核心上下文；
  • 手动压缩：点击对话面板顶部「上下文压缩」按钮，手动触发压缩，可选择保留「近10轮对话」或「仅核心需求与成果」；
  • 上下文清空：若开启新任务，点击「清空上下文」，避免历史信息干扰。

4.4 内置工具集成：减少应用切换

Solo 模式集成多款开发工具，支持在同一空间内完成多环节工作：

  • 设计稿解析：导入 Figma 链接，AI 自动将设计稿转换为前端代码；
  • 数据库操作：集成 Supabase，直接在界面内创建数据库表与接口；
  • 一键部署：关联 Vercel 账号，代码开发完成后点击「部署」即可上线预览；
  • 支付集成：接入 Stripe 工具，快速开发支付模块。

使用路径：顶部「工具集」，选择对应工具并完成授权，即可直接调用。

五、常见问题与避坑指南

常见问题原因分析解决方案
AI 输出与需求偏离指令模糊，缺少具体要求或上下文1. 使用「指令优化工具」重构指令；2. 补充引用相关文件/代码；3. 开启 Plan 模式确认开发思路
代码运行报错AI 未考虑运行环境差异，或逻辑疏漏1. 将控制台日志加入对话；2. 补充说明运行环境（如 Node.js 16.x）；3. 要求 AI 输出单元测试代码
上下文过长导致响应变慢冗余信息占用模型处理资源1. 手动触发「上下文压缩」；2. 拆分任务为多个并行子任务；3. 清空无关历史上下文
自定义智能体效果不佳职责定义模糊，缺少范例引导1. 细化智能体职责，明确专业领域；2. 添加「好/坏范例」；3. 根据输出结果迭代优化智能体配置
快捷键无效与系统快捷键冲突，或未启用1. 进入「快捷键设置」检查是否启用；2. 修改冲突的快捷键组合；3. 重启 TRAE 生效

六、最佳实践：典型场景工作流

场景1：现有代码重构（SOLO Coder）

  1. 进入 Solo 模式，选择 SOLO Coder，创建工作空间「用户管理模块重构」；
  2. 上传待重构文件（#userModule.js），输入指令：「@后端架构师 重构此用户模块代码，开启 Plan 模式。要求：1. 拆分数据层与业务层；2. 增加权限校验逻辑；3. 兼容现有数据库结构」；
  3. 查看并确认 AI 生成的开发计划，补充修改意见（如「将单元测试步骤提前」）；
  4. AI 按计划输出重构代码，通过待办清单跟踪进度，针对数据层代码提出优化要求；
  5. 关联控制台日志，验证代码运行效果，反馈报错信息并要求修复；
  6. 完成后，导出重构文档与最终代码，结束任务。

场景2：新项目从0到1搭建（SOLO Builder）

  1. 选择 SOLO Builder，创建工作空间「微信小程序 Todo 应用」；
  2. 输入指令：「开发一个 Todo 小程序，功能包括：用户注册登录、任务添加/编辑/删除、任务分类标签、完成状态统计。技术栈：微信原生框架+云开发，输出需求分析文档+技术架构+完整代码+部署教程」；
  3. AI 生成需求文档后，确认并补充细节（如「增加任务提醒功能」）；
  4. 拆分并行任务：新建「任务1：前端页面开发」「任务2：云函数编写」「任务3：部署流程整理」；
  5. 使用「选择元素」功能优化前端页面样式，调用「云开发工具」配置数据库；
  6. 完成开发后，通过内置浏览器预览，一键部署至微信开发者工具。

七、附录：资源与支持

  • 官方资源：《8个可一键导入的自定义智能体》docs.trae.ai/ide/custom-…
  • 技术支持：点击界面右下角「帮助」→「在线客服」，或拨打客服电话400-XXX-XXXX（工作日9:00-18:00）
  • 更新日志：顶部「设置」→「关于 TRAE」，查看 Solo 功能最新更新与优化
avatar
文章
阅读
粉丝