首次啟動與匯入¶
頁面目標¶
協助你完成第一次使用的完整迴圈：從資料庫開始，匯入資料，開啟文件，再回到資料庫。
支援平台¶
iOSmacOS
適用對象¶
- 想完成第一次匯入流程的新使用者
- 驗證從資料庫匯入到工作區行為的測試人員
前置條件¶
- PCBAtlas 已可啟動並進入資料庫
- 你已準備好內建範例，或自己的設計 / 製造專案檔
操作步驟¶
- 從資料庫開始，依來源選擇設計或製造匯入路徑。
- 如果來源是
IPC-2581 XML，在提示出現時選擇匯入意圖。 - 等待資料庫頂部的進度橫幅完成，再開啟產生的文件。
- 確認匯入內容可在
2D / Data檢視，且修訂狀態符合預期。
結果¶
- 來源會以新文件或新修訂的形式匯入資料庫，工作區也能成功開啟。
首次冷啟動的預設內容¶
當資料庫是空的，App 會自動加入兩個可立即開啟的 KiCad 範例文件：
h730duinoBluePhil
如果只是想熟悉互動流程，可以先開啟其中一個範例；如果要驗證自己的資料，請繼續下面的匯入流程。
目前匯入路徑¶
建立新文件或追加修訂¶
- 設計路徑：
DSN、KiCad .kicad_pcb、IPC-2581 XML - 製造路徑：
IPC-2581 XML、ODB++壓縮檔 / 目錄輸入，以及 App 可辨識的製造封裝資料夾
需要既有文件上下文的匯入¶
- SES：不能建立獨立的新文件；必須先選擇基準修訂，再從既有文件選單發起
IPC-2581 的特殊行為¶
選取 IPC-2581 XML 時，App 不會自行假設它該被當成設計端或製造端資料，而是會顯示確認對話框，讓你選擇：
- 以 設計資料 匯入
- 以 製造資料 匯入
建議步驟¶
- 在資料庫首頁點擊匯入入口。
- 依手上的來源資料選擇設計或製造路徑。
- 選取檔案後，如果它是
IPC-2581 XML，請選擇匯入意圖。 - 等待資料庫頂部匯入進度橫幅推進。
- 匯入完成後，會出現新的文件卡片，或目標文件的修訂數增加。
- 在工作區開啟文件，確認
2D / Data可正常檢視。
你會看到的回饋¶
- 資料庫頂部會顯示進行中的橫幅，包含標題、階段詳情與百分比。
- 如果你在匯入期間手動開啟其他文件，匯入任務仍會完成，但不會強制把焦點切回新匯入的文件。
- 如果在已開啟某文件時，把新的板檔丟進工作區，App 會先詢問是否要取代目前內容。
匯入 KiCad 專案或原理圖後¶
匯入 KiCad .kicad_pro 後，PCBAtlas 會把專案目錄中相關的 KiCad 專案檔存入該資料庫修訂，並在工作區提供 Project 頁。內容會分到 Source Documents / Libraries / Settings，方便你確認哪些板檔、原理圖、程式庫檔與設定被收錄。
開啟原理圖時，工作區仍使用 2D 畫布，但右側 Workbench 會切換成原理圖專用結構：
Sheets：檢查階層、麵包屑與可開啟的子 sheet。Search：在Current Sheet或Whole Project搜尋Symbols / Nets / Labels / Text / Markers。Selection / Details：顯示從搜尋結果或畫布點選取得的物件。Problems：顯示匯入問題、未支援內容，以及原理圖 Workbench 無法使用時的明確訊息。
原理圖畫布支援選取 symbol / pin / wire / bus / label / text / junction / marker 對應的元件符號、接腳、連線、匯流排、標籤、文字、接點與標記。選取、詳情與高亮會保持同步，重疊命中也可以循環切換。版面編輯仍應在專用 EDA 工具中完成。
修訂相關動作¶
從文件卡片的動作選單中，你可以：
- 追加設計修訂
- 追加製造修訂
- 匯入 SES，並選擇可作為基準的歷史修訂
也就是說，匯入不只用來建立新文件，也用來維護同一專案持續演進的修訂歷史。
目前同名同格式重新匯入規則¶
當來源以相同文件名稱與相同格式再次匯入時，目前版本會把它視為同一文件的另一輪輸入，而不是自動建立新的頂層卡片：
- 如果新匯入的原始來源與目前修訂 逐位元組相同，App 會提示沒有變更並忽略匯入
- 如果原始來源 不同，App 會把它存成該文件底下的新修訂，並切換到最新修訂
- 修訂標籤會依文件名稱動態顯示為
A1 / A2 / ...
建議¶
- 第一次驗證時，建議從單一
DSN或KiCad檔開始。 - 對製造資料，匯入前先確認壓縮檔或目錄內容完整。
- 同一專案的反覆更新，優先使用追加修訂，不要建立多個幾乎相同的文件。
常見問題¶
為什麼 SES 不能像一般檔案一樣匯入？¶
因為 SES 必須附著到既有設計修訂作為基準修訂。目前版本要求你先進入既有文件，再從該文件的選單開始 SES 匯入。
為什麼選擇 IPC-2581 後 App 還會再次詢問？¶
因為同一個 IPC-2581 XML 可以被視為設計端或製造端資料，目前版本會明確要求你選擇。
為什麼同一個 IPC-2581 的設計與製造路徑匯入後有時看起來幾乎相同？¶
這是目前版本的正常現象。對 IPC-2581 而言，現在主要差異在資料庫端的匯入意圖與文件分類，而不一定會在工作區立即呈現非常明顯的視覺差異。
- 選擇設計路徑時，文件會以設計端材料管理。
- 選擇製造路徑時，文件會以製造端材料管理。
- 這個分類會影響後續管理行為，例如預設追加路徑。
- 同一個
IPC-2581透過兩條路徑匯入時，通常會形成兩個獨立文件，而不是自動合併。
同時，目前開啟後的顯示行為尚未強烈表達設計與製造的差別，所以可見結果仍可能相當接近。
為什麼匯入選擇器沒有列出所有製造套件副檔名？¶
製造路徑接受常見壓縮檔、目錄與一般資料輸入。最終是否成功，取決於 App 能否從選取來源中辨識出支援的製造封裝。