離線使用指南

drawtonomy 的設計讓你可以在完全不向外傳送任何編輯資料的情況下，完成車道繪製、OpenDRIVE / OpenSCENARIO 檔案編輯，以及透過 esmini 播放模擬場景。本頁說明如何在現有版本中實現真正的零外傳工作流程，以及我們下一步將新增的一鍵切換功能。

「零外傳」的定義

編輯器完成初始載入後，除非你主動觸發特定功能，否則不會產生任何對外的網路請求。會觸發外傳的功能列表請參閱資料流與隱私。只要避開這些功能，整個工作階段就能完全離線運作，並可透過瀏覽器的 Network 分頁加以驗證。

零外傳工作階段的確認清單

1. 將地圖背景設為「Off」。 這會停用道路和衛星圖磚提供者。
2. 不使用「Generate Lanes from OSM」。 這是唯一一個會呼叫 Overpass API 的內建功能。請改為手動繪製車道，或匯入現有的 .xodr 檔案。
3. 不使用地圖搜尋框。 搜尋框會將你輸入的文字傳送至地名搜尋服務。
4. 不啟用 AI Scene Generator 擴充功能。 預設為停用狀態，只要不從 Extensions 面板開啟，就不會連線至任何 LLM。
5. 匯出時使用內建字型。 drawtonomy 已隨附 Excalifont 字型，使用此字型匯出不會連線 Google Fonts。

完成上述步驟後，drawtonomy 在整個工作階段中將不產生任何對外請求。你可以在瀏覽器開發者工具中開啟 Network 分頁，篩選「Fetch / XHR」，然後在繪製、匯入、播放場景及匯出的過程中確認清單維持空白。

可完全離線執行的工作流程

• 手動繪製道路網路，設定各車道屬性，匯出為 OpenDRIVE。
• 匯入現有的 .xodr 檔案，編輯車道幾何與連接關係，再重新匯出。
• 匯入 .xosc 檔案（含目錄參考），進行編輯後，按下 Play 即可直接在編輯器中透過 esmini-WASM 播放。
• 匯出可供 esmini 使用的 .zip 壓縮包（含 .xodr 與 .xosc），供下游模擬使用。

以上所有操作均在瀏覽器內完成。唯一需要連線 Overpass 的是選用的「Generate Lanes from OSM」功能。

需要網路連線的功能

• OSM 車道匯入。 需要 Overpass API。
• 地名搜尋。 需要公開的 Nominatim 服務。
• AI Scene Generator 擴充功能。 預設為停用；僅在你從 Extensions 面板開啟並選取後才會啟動。提示詞會直接從瀏覽器傳送至你所設定的 LLM 服務商（Anthropic Claude、OpenAI GPT 或 Google Gemini），現有畫布內容不會包含在請求中。詳情請參閱安全性 FAQ。

路線圖：一鍵「Offline mode」切換

我們計畫在漢堡選單中新增頂層 Offline mode (network 0) 切換開關，啟用後將：

• 封鎖編輯器發出的所有對外請求，包括地圖圖磚提供者、Overpass、地名搜尋、Google Fonts 及 Google Analytics。
• 在 UI 顯示小徽章，讓操作人員一眼確認外傳已停用。
• 透過自動化測試進行驗證，確保未來的程式碼變更不會悄悄重新引入網路流量。

如果你希望加速此功能的優先順序，歡迎開啟 Issue — OEM 使用場景正是這項工作的最優先目標。

相關資源

• 資料流與隱私 — 所有外傳目的地及傳送內容的完整清單。
• 安全性 FAQ — 常見問題的簡短解答。