程式碼與檔案
使用 Editor 檢視並管理 Atoms 專案中的原始檔。您可以尋找檔案、預覽支援的格式、比較變更、將程式碼加入 Chat 作為上下文，以及下載個別檔案、資料夾或整個專案。
本指南僅涵蓋儲存在 專案工作區 中的檔案。在 Chat 中上傳的檔案、產生的媒體、雲端資料、已發佈版本，以及來自已連接服務的檔案，皆會分開管理。
開始之前
- 請使用桌面版瀏覽器。Editor 在行動裝置上的使用體驗有限。
- 在對相同檔案進行手動變更之前，請等待智能體完成作業。
- 請開啟最新的專案版本。如果您正在檢視較早的版本，請在版本控制中選取 Restore，確認 Restore，並等待還原完成後再進行編輯。
- 編輯或下載專案可能需要符合資格的付費方案。
切勿將密碼、API 金鑰、存取 Token 或其他機密資訊直接放入原始檔或 Chat 中。
開啟 Editor
- 開啟現有專案。
- 從專案工具列選取 Editor。
- 等待檔案樹與檔案檢視器載入完成。
檔案樹會顯示在左側。所選檔案會在右側以程式碼編輯器或預覽方式開啟。針對檔案顯示的工具會依其格式與目前專案狀態而定。
尋找與預覽檔案
依檔案或資料夾名稱搜尋
- 在檔案樹上方選取 Search。
- 輸入檔案或資料夾名稱的一部分。
- 選取相符結果以開啟。
搜尋會比對檔案與資料夾名稱，不會搜尋檔案內的文字。如果您找不到項目，請縮短搜尋詞、清除搜尋，並手動展開相關資料夾。
依檔案或資料夾名稱搜尋 Editor 檔案樹。
預覽檔案
在樹狀清單中選取檔案。Atoms 可以預覽常見的程式碼與文字檔、HTML、Markdown、DOCX 與 XLSX 檔案、圖片、支援的音訊與影片、PDF、CSV 檔案，以及 Jupyter 筆記本。可用的預覽方式取決於檔案類型。
如果檔案或資料夾無法預覽，請先下載，再使用相容的應用程式開啟。
編輯專案程式碼
- 開啟支援的程式碼或文字檔。
- 在編輯器中進行變更。
- 等待儲存指示器完成。儲存會同步您目前的編輯工作階段，但尚不會套用整個工作階段。
- 可提供預覽時，選取 Preview 以檢查結果。
- 選取 Submit all 以套用該工作階段，或選取 Discard all 以回復該工作階段中的編輯。
手動編輯與智能體產生的變更可能會影響相同檔案。在要求智能體變更專案之前，請先提交或捨棄您目前的編輯，並在進行大幅變更前使用專案歷史記錄。
預覽、捨棄或提交 Editor 編輯工作階段。
如果 Editor 為唯讀
當智能體正在作業、儲存進行中，或您正在檢視較早的專案版本時，Editor 可能會暫時禁止變更。對於不受支援的專案，或沒有必要存取權限的帳戶，它也可能是唯讀模式。
請等待目前作業完成、開啟最新版本，並重新整理頁面。如果您正在檢視較舊版本，請在版本控制中選取 Restore，確認 Restore，等待還原完成，然後重新開啟最新版本。編輯前請確認不再顯示 Read only 指示。
在 Chat 中使用程式碼並比較變更
將整個檔案加入 Chat
開啟檔案，按一下垂直的 ... ，並在可使用該操作時選取 Select file。您也可以在 Chat 中輸入 #，然後選擇專案檔案。該檔案會作為您下一個請求的上下文加入。
開啟目前檔案操作並選取 Select file。
比較變更
可使用時，選取 Diff 以在套用變更前比較檔案的原始版本與修改後版本。
管理檔案與資料夾
使用檔案樹中項目旁的 ... 來查看該檔案或資料夾可用的操作。依項目與專案狀態而定，您可以建立、上傳、重新命名、下載或刪除檔案與資料夾。
- 在樹狀清單中找到檔案或資料夾。
- 選取 ...。
- 選擇所需操作，並依照畫面提示進行。
刪除檔案或資料夾後將無法復原。 刪除重要專案檔案前，請先建立安全的專案版本或下載副本。
當智能體正在變更專案，或編輯工作階段正在儲存時，某些檔案操作將無法使用。請等待目前作業完成後再試一次。
下載程式碼與檔案
下載目前檔案
- 在 Editor 中開啟檔案。
- 從目前檔案操作中選取 Download。
- 開啟瀏覽器的下載位置並確認檔案。
下載資料夾
- 選取資料夾旁的 ...。
- 選取 Download。Atoms 會將資料夾封裝為 ZIP 壓縮檔。
- 開啟壓縮檔並確認其內容。
下載目前專案
- 在 Editor 中，於檔案樹下方選取 Download Project。
- 在 Atoms 準備壓縮檔期間，請保持頁面開啟。
- 開啟下載的 ZIP，並確認您需要的檔案。
您必須先登入。下載目前專案原始碼可能需要符合資格的付費方案。在共享的唯讀專案檢視中，Editor 下載功能也可能無法使用。
從 Share 匯出
您也可以開啟 Share 並選取 Export。這提供另一種將專案匯出為 ZIP 的方式。在將下載的壓縮檔作為交接或備份使用前，請先檢查其內容。
開啟 Share 並選取 Export 以下載專案。