編輯器

編輯器分頁內嵌 BRICKS Controller 提供的同一個視覺化 Config Editor，但改為連線至您的本機專案。您可以視覺化地編輯 Subspace、Canvas、Brick、Generator、Data、Animation 與 Data Calculation，而儲存時會將您的編輯編譯成專案的 bricks-ctor TypeScript 原始程式碼，並提交至 Git。編輯器可在專案工作階段中使用——而非主聊天——並會沿用 CTOR 的語言與主題。它同時適用於應用程式專案與模組專案。 編輯器使用與網頁版 Config Editor 相同的實體模型。關於 Subspace、Canvas、Brick、Generator、Data、Animation 與 Data Calculation 的定義，請參閱 Config Editor 參考。

​

開啟編輯器

從任一面板的 +（新增分頁）選單新增編輯器分頁。

​

需求

​

工具列

編輯器工具列有以下控制項：

​

儲存與提交

點選儲存會開啟提交訊息快顯，並預先填入預留位置 chore: update config from CTOR editor。以儲存並提交確認以寫入您的編輯。 儲存時會：

• 為您的編輯產生原始程式碼檔案——application.json、app.ts、root.ts，以及 subspaces/ 與 automation-tests/ 下的檔案。
• 編譯並型別檢查所產生的原始程式碼。
• 建立一個 Git 提交——主旨為您的訊息（或預設的預留位置），內文為變更摘要。只有編輯器產生或移除的檔案會被暫存，絕不包含您無關的變更。

若編譯或型別檢查失敗，儲存會被拒絕並顯示失敗內容。不會提交任何內容。

​

儲存狀態

儲存狀態圓點會回報您編輯的狀態。將游標停留在其上可檢視完整文字。 若您有尚未儲存的編輯，而已編譯設定在編輯器外部變更（例如代理編輯了原始程式碼），儲存時會顯示「已編譯設定在編輯器外部變更。請重新載入或處理外部變更後再儲存。」編輯器會嘗試自動合併外部變更並重試儲存；若無法合併，請先使用重新載入或處理該變更。 重新載入會捨棄您尚未儲存的編輯——並確認「要捨棄尚未儲存的設定編輯器變更嗎？」——同時清除復原歷程。

​

鍵盤快速鍵

當您正在文字欄位中輸入時，複製、貼上與再製會略過。在任何項目上按右鍵可開啟其快顯選單。 複製的 Brick 與 Canvas 可在編輯器與網頁版 Config Editor 之間雙向移動，因此您可以在其中一邊複製，並在另一邊貼上。

​

命令選擇區

當編輯器分頁為使用中時，按 Cmd/Ctrl+K 開啟編輯器的命令選擇區，其標題為 編輯器指令。內容包含：

• New: Subspace / Canvas / Data / General Data Calculation / Script Data Calculation / Animation——建立該類型的新項目。
• New Brick: <name> 與 New Generator: <name>——建立指定類型的新 Brick 或 Generator。
• 針對設定中既有項目的前往導覽。

模組專案無法建立 Subspace。

​

即時模擬與代理

您尚未儲存的編輯會即時算繪在模擬器中，代理的螢幕截圖也會使用這些編輯，因此您看到的內容會與代理看到的一致。 當代理在編輯器開啟時變更設定，該變更會就地套用——受影響的 Brick、Canvas 框架與清單列會短暫閃動，讓您看出變更之處。 代理也能看見您的編輯器狀態：編輯器是否開啟、是否有尚未儲存的編輯、目前的 Subspace、目前選取內容，以及近期編輯歷程。這讓代理能與您的視覺化編輯同步進行。

​

尚未儲存的編輯保護

在您有尚未儲存的編輯時切換工作階段或專案、關閉編輯器分頁，或關閉視窗，都會先詢問「要捨棄尚未儲存的設定編輯器變更嗎？」，以免您不慎遺失工作內容。

​

個別項目說明

許多項目帶有說明（?）圖示。點選即可開啟停靠的參考抽屜，並以編輯器的語言顯示。

​

後續步驟