Trae 插件 Builder - 高效構(gòu)建項(xiàng)目開(kāi)發(fā)全流程

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

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

Builder 的工作流程

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

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

前置條件

• VS Code 版本為 1.93 及以上。

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

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

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

打開(kāi) Builder

1. 使用快捷鍵（macOS：Command + U；Windows：Ctrl + U）打開(kāi) AI 對(duì)話框。

2. 在對(duì)話框的左上角，點(diǎn)擊 Builder。

   

探索 Builder

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

添加上下文

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

生成并處理代碼變更

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

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

  

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

  

生成并運(yùn)行命令

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

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

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

預(yù)覽成果

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

回退版本

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

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

使用以下步驟回退項(xiàng)目的版本：

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

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

   對(duì)話框中展示本次回退會(huì)影響的文件。

   

3. 點(diǎn)擊文件名。

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

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

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

   Builder 開(kāi)始回退項(xiàng)目。

管理歷史會(huì)話

點(diǎn)擊 Builder 窗口右上角的 歷史會(huì)話 按鈕，打開(kāi) 歷史會(huì)話 面板，該面板展示 Chat 模式和 Builder 模式的所有對(duì)話記錄。

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

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