專案、圖形與檔案
Eidograph 的層級結構是「工作區 → 專案 → 圖形」。每個頂層標籤都是一個已開啟的專案;一個專案對應一個 .eido 檔案,可以包含任意數量的 2D 或 3D 圖形。每個圖形都是一份 Eidolang 腳本。
建立專案
點擊標題列的 +,然後選擇:
- 新增專案 — 2D 圖形:內含一個初始平面圖形;
- 新增專案 — 3D 圖形:內含一個初始立體圖形;
- 空白專案:之後再從圖形面板或 Agent 新增圖形。
點擊標籤即可切換專案。點擊目前的標籤可開啟專案操作:重新命名、儲存、另存新檔或關閉。儲存後,實際的 .eido 檔案名稱會成為專案名稱。
管理圖形
在圖形面板中:
- 使用 + 2D 或 + 3D 新增圖形;
- 點擊某一列即可切換;
- 使用鉛筆圖示重新命名;
- 使用 × 刪除——確認後,一般的復原操作無法還原該圖形;
- 實心/空心圓點控制是否將此圖形暴露給 Windows 上的 MCP/REST 客戶端。
圖形在建立時就固定為 plane 或 solid。修改腳本中的 space 為另一種類型只會產生診斷訊息,不會真的轉換圖形;請改為建立目標類型的新圖形,並重新改寫構造。
當 Agent 被釘選到某個專案並正在其中運作時,該專案的圖形新增/刪除/切換操作會被鎖定,避免任務進行到一半時目標被更動。
儲存、另存新檔與關閉
- 儲存:第一次會選擇路徑,之後則覆寫該檔案。
- 另存新檔:選擇新的檔名與位置,並將專案名稱同步為該檔名。
Ctrl/⌘ S:儲存;Ctrl/⌘ Shift S:另存新檔。- 關閉:只會從工作區移除該專案標籤,不會刪除已儲存的
.eido檔案。有未儲存的修改時會要求確認。
.eido 是 ZIP 封裝格式,目前 manifest 固定為 version: 2;每個圖形仍是純文字腳本。它儲存專案名稱、圖形順序/名稱/類型,以及該專案自己的畫布設定。Agent 對話預設不包含在內;需要時請開啟設定 › 一般 › 包含 Agent 對話。
相機姿態、2D 平移/縮放、格線樣式與選取狀態屬於本機視圖狀態,不會儲存在 .eido 中。
開啟與拖放檔案
點擊資料夾按鈕,或把檔案拖放到應用程式視窗中的任何位置:
| 檔案 | 結果 |
|---|---|
.eido | 以新的專案標籤開啟 |
.zip | 讀取現有的封裝結構,並以新專案開啟 |
.geo / .txt | 將一個圖形加入目前的專案 |
裸腳本會使用 space plane 或 space solid。若沒有這行宣告,Eidograph 會詢問要使用哪一種類型開啟。.eido 封裝永遠不會合併進目前的專案。
匯出單一腳本
在命令面板中選擇儲存 Eidolang (.txt),即可取得目前圖形的純文字內容。它不包含其他圖形或專案設定,適合用於程式碼審閱與版本控制;若要分享完整專案,請使用 .eido。
建議的備份流程
- 定期儲存專案。
- 在升級、切換發行軌道或解除安裝前,使用另存新檔。
- 只有在需要時才包含 Agent 對話,並先檢查提示內容是否有敏感資訊。
- 用另一個標籤重新開啟備份檔,確認圖形數量、類型與腳本內容都正確。
