Builder 可以幫助你從 0 到 1 開發(fā)一個完整的項目。你可以將它無縫融入到項目構(gòu)建的流程中。

在 Builder 模式下，AI 助手在回答時會根據(jù)需求調(diào)用不同的工具，包括分析代碼文件的工具、編輯代碼文件的工具、運行命令的工具等等。從而讓回答更精確、更有效。

Builder 的工作流程

Builder 模式下，AI 助手會主動讀取當(dāng)前項目中的文件內(nèi)容，拆解任務(wù)并逐步執(zhí)行，包括：

• 提取相關(guān)上下文
• 創(chuàng)建或修改文件
• 生成并運行終端命令
• 分析命令運行狀態(tài)

前置條件

• VS Code 版本為 1.93 及以上。

• (僅 Windows) 已為 VS Code 配置 PowerShell 6 或更高版本。若當(dāng)前非此配置，參考以下步驟完成配置：

  1. 安裝 PowerShell 6 或更高版本。安裝說明參考此文檔。
  2. 返回 Trae 并打開 終端 面板。
  3. 點擊右上方區(qū)域的 + > 選擇默認(rèn)配置文件。
     界面上方顯示配置文件選擇列表。
  4. 選擇帶有 \PowerShell{版本號}\xxx 字樣的配置文件（一般會自動檢測到 ）。

     提示
     - {版本號} 大于等于 6。
     - 勿選擇系統(tǒng)內(nèi)置的舊版本 PowerShell，例如圖中的 Windows PowerShell。

打開 Builder

1. 使用快捷鍵（macOS：Command + U；Windows：Ctrl + U）打開 AI 對話框。

2. 在對話框的左上角，點擊 Builder。

   

探索 Builder

Builder 提供一系列實用的功能，精準(zhǔn)且高效地助力你從 0 到 1 開發(fā)項目。

添加上下文

AI 助手可以理解當(dāng)前項目中的上下文，包括代碼和文件，從而更精確地協(xié)助你完成開發(fā)需求。你可以通過 #引用 的方式將項目中的代碼和文件作為上下文，在提問時一并發(fā)送給 AI 助手。

生成并處理代碼變更

根據(jù)你的需求，AI 助手會自動創(chuàng)建新文件或編輯已有文件，并自動保存生成的代碼。你可以選擇接受或拒絕代碼變更，包括：

• 處理多文件內(nèi)的所有代碼變更：點擊輸入框上方待審查文件列表中的 全部接受 或 全部拒絕 按鈕，批量接受或拒絕當(dāng)前項目中的所有代碼變更。

  

• 處理單文件內(nèi)的所有代碼變更：打開待審查的文件列表，點擊某個文件以在編輯器內(nèi)打開它，然后審閱代碼變更。審閱完成后，點擊 接受 或 拒絕 按鈕，批量接受或拒絕當(dāng)前文件中的所有代碼變更。

  

生成并運行命令

根據(jù)你的需求，AI 助手會適時推薦必要的 Shell 命令供你運行（以下圖為例）。你可以選擇運行或跳過某個命令，AI 助手會根據(jù)你的操作完成后續(xù)的工作。

點擊 運行 后，終端將運行該命令。命令運行后，AI 助手會自動讀取并分析運行結(jié)果。如果運行異常，AI 助手會自動分析原因，并給出建議解決方案。

若命令運行成功，你可以點擊命令卡片右上角的 終端 按鈕，然后在終端中查看該命令的運行日志。

預(yù)覽成果

AI 助手完成開發(fā)需求后，會提供 預(yù)覽 按鈕。點擊后，IDE 內(nèi)會打開 Preview 窗口，用于展示開發(fā)成果。

回退版本

你可以將項目回退到指定會話輪次發(fā)起前的版本。

提示
- 回退操作不可撤銷；
- 僅支持在最近活躍的 Builder 窗口中回退版本；
- 僅支持回退至最近 10 輪會話內(nèi)的版本。

使用以下步驟回退項目的版本：

1. 找到目標(biāo)對話氣泡。

2. 點擊左側(cè)的 回退 按鈕。

   對話框中展示本次回退會影響的文件。

   

3. 點擊文件名。

   編輯器內(nèi)會打開該文件，顯示即將發(fā)生的變更。

4. 確認(rèn)本次回退的影響范圍。

5. 若本次回退符合預(yù)期，點擊 確認(rèn)。

   Builder 開始回退項目。

管理歷史會話

點擊 Builder 窗口右上角的 歷史會話 按鈕，打開 歷史會話 面板，該面板展示 Chat 模式和 Builder 模式的所有對話記錄。

• 若你需要查看某輪歷史對話，點擊該對話條目，你會跳轉(zhuǎn)至該對話的位置。
• 若需要刪除某輪對話，可以將鼠標(biāo)懸浮至該對話，然后點擊右側(cè)的 刪除 圖標(biāo)。

提示：
對話記錄刪除后無法恢復(fù)。