首次啟動與匯入¶
頁面目標¶
協助你完成第一次使用的完整迴圈：從資料庫開始，匯入資料，開啟文件，再回到資料庫。
支援平台¶
iOSmacOS
適用對象¶
- 想完成第一次匯入流程的新使用者
- 驗證從資料庫匯入到工作區行為的測試人員
前置條件¶
- PCBAtlas 已可啟動並進入資料庫
- 你已準備好內建範例，或自己的設計 / 製造專案檔
操作步驟¶
- 從資料庫開始，依來源選擇
Import File或Import Folder。 - 如果來源是
IPC-2581 XML，在提示出現時選擇匯入意圖。 - 等待資料庫頂部的進度橫幅完成，再開啟產生的文件。
- 確認獨立 PCB 來源進入 PCB Viewer；原理圖來源與含原理圖的 KiCad 專案進入 Schematic Workbench，且修訂狀態符合預期。
結果¶
- 來源會以新文件或新修訂的形式匯入資料庫，工作區會開啟對應的 PCB Viewer 或 Schematic Workbench。
首次冷啟動的預設內容¶
當資料庫是空的，App 會自動加入三個可立即開啟的範例文件：
h730duino（ODB++ 製造資料）BluePhil（KiCad 設計板）WooKey Mainboard（包含 PCB 與階層原理圖的 KiCad 專案）
如果只是想熟悉互動流程，可以先開啟其中一個範例；如果要驗證自己的資料，請繼續下面的匯入流程。
目前匯入路徑¶
Import File¶
- 單一
DSN、KiCad .kicad_pcb、KiCad .kicad_sch或IPC-2581 XML - 一般 KiCad
.zip，以及 App 可辨識的 ODB++ / Gerber / Drill 製造資料壓縮檔 - 相容的
.epcbdoc.zip文件套件
不要把 .kicad_pro 當成獨立檔案匯入；專案需要同目錄的原理圖、程式庫與設定檔，請改用 Import Folder。單一 .kicad_sch 只有在不引用子 sheet 時才能直接匯入；多 sheet 原理圖也應透過專案資料夾匯入，App 不會再跳出第二個檔案選擇器補充目錄權限。
Import Folder¶
- 含有效
.kicad_pro的 KiCad 專案目錄，包括只含原理圖的專案
資料夾與壓縮檔的來源選擇¶
Import Folder 只接受 KiCad 專案：PCBAtlas 必須找到有效的 .kicad_pro；如果沒有專案檔或專案無法重新開啟，匯入會直接回報錯誤，不會降級成 .kicad_pcb 或 .kicad_sch 匯入。如果發現多個專案，會要求你明確選擇，不會靜默挑選。匯入成功後，所選目錄內的全部一般檔案都會依原相對路徑保存在同一修訂中，包括專案閉包之外的說明檔或製造輸出；遇到無法讀取的檔案、符號連結或其他不支援的目錄項時會整體失敗，不會只保存一部分。
從 Files、iCloud Drive 或第三方檔案提供者選擇專案目錄時，App 會先把完整目錄準備為本地暫存快照，再檢查專案入口。.history 等歷史目錄仍會依原路徑保存在修訂中，但其中的 PCB 或原理圖只作為歷史支援檔案，不會與 .kicad_pro 同目錄的目前設計爭奪開啟入口。
對仍保留 KiCad 5 .sch 原理圖的專案，如果 .kicad_pro 指向的同名 .kicad_sch 已不存在，但同目錄存在精確同名的 .sch，PCBAtlas 會把該 .sch 及其子 sheet 識別為專案原理圖，並允許 PCB 與原理圖雙畫布開啟。App 不會改選無關 .sch；只有 .pro 而沒有 .kicad_pro 的舊專案目錄仍不屬於 Import Folder 支援範圍。
開啟 KiCad 專案時，App 會優先開啟與專案同名的原理圖；沒有同名原理圖時依路徑排序選擇一份可用原理圖。專案同時包含 PCB 與原理圖時，App 會在同一進度階段準備兩幅畫布，完成後預設顯示雙畫布；只有一種設計來源時顯示單畫布，畫布切換按鈕不可用。
IPC-2581 的特殊行為¶
選取 IPC-2581 XML 時，App 不會自行假設它該被當成設計端或製造端資料，而是會顯示確認對話框，讓你選擇：
- 以 設計資料 匯入
- 以 製造資料 匯入
建議步驟¶
- 在資料庫首頁點擊
Import File或Import Folder。 - 單一檔案與壓縮檔使用
Import File；包含.kicad_pro的完整 KiCad 專案目錄使用Import Folder。 - 選取檔案後，如果它是
IPC-2581 XML，請選擇匯入意圖。 - 等待資料庫頂部匯入進度橫幅推進。
- 匯入完成後，會出現新的文件卡片，或目標文件的修訂數增加。
- 在工作區開啟文件，確認 PCB 與原理圖都存在時預設顯示雙畫布；只有一種設計來源時顯示單畫布，並確認
Project / Data內容完整。
你會看到的回饋¶
- 資料庫頂部會顯示進行中的橫幅，包含標題、階段詳情與百分比。
- 開啟專案時，直向或緊湊配置會維持在 Viewer 進度頁；畫布準備完成後才直接展示可操作內容，不會提早切到
Project頁面。 - 如果你在匯入期間手動開啟其他文件，匯入任務仍會完成，但不會強制把焦點切回新匯入的文件。
- 如果在已開啟某文件時，把新的板檔丟進工作區，App 會先詢問是否要取代目前內容。
匯入 KiCad 專案或原理圖後¶
透過 Import Folder 或一般 KiCad .zip 匯入 .kicad_pro 後，PCBAtlas 會把相關 KiCad 專案檔存入該資料庫修訂，並在工作區提供 Project 頁。Import Folder 還會保留所選目錄中的其他一般檔案。內容會分到 Source Documents / Libraries / Settings，方便你確認哪些板檔、原理圖、程式庫檔與設定被收錄。獨立 .kicad_sch 會透過 Import File 直接進入原理圖工作區，不會額外要求其父目錄。
開啟原理圖時，工作區仍使用 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 對應的元件符號、接腳、連線、匯流排、標籤、文字、接點與標記。選取、詳情與高亮會保持同步，重疊命中可以循環切換，已選取的非網路物件會顯示橙色定位框。存在可用的 PCB 路徑時，單畫布模式會提供 在 PCB 中檢視；點選後會切換到 PCB，優先選取對應封裝或焊盤，否則高亮關聯網路，並縮放至目標。雙畫布模式會保持兩側交叉探查聯動。版面編輯仍應在專用 EDA 工具中完成。
修訂相關動作¶
從文件卡片的動作選單中，你可以：
- 追加設計修訂
- 追加製造修訂
也就是說，匯入不只用來建立新文件，也用來維護同一專案持續演進的修訂歷史。
目前同名同格式重新匯入規則¶
當來源以相同文件名稱與相同格式再次匯入時，目前版本會把它視為同一文件的另一輪輸入，而不是自動建立新的頂層卡片：
- 如果新匯入的原始來源與目前修訂 逐位元組相同，App 會提示沒有變更並忽略匯入
- 如果原始來源 不同，App 會把它存成該文件底下的新修訂，並切換到最新修訂
- 修訂標籤會依文件名稱動態顯示為
A1 / A2 / ...
建議¶
- 第一次驗證時，建議從單一
DSN或KiCad檔開始。 - 對製造資料，匯入前先確認壓縮檔或目錄內容完整。
- 同一專案的反覆更新，優先使用追加修訂，不要建立多個幾乎相同的文件。
常見問題¶
為什麼選擇 IPC-2581 後 App 還會再次詢問？¶
因為同一個 IPC-2581 XML 可以被視為設計端或製造端資料，目前版本會明確要求你選擇。
為什麼同一個 IPC-2581 選擇設計與製造意圖後有時看起來幾乎相同？¶
這是目前版本的正常現象。對 IPC-2581 而言，現在主要差異在資料庫端的匯入意圖與文件分類，而不一定會在工作區立即呈現非常明顯的視覺差異。
- 選擇設計意圖時，文件會以設計端材料管理。
- 選擇製造意圖時，文件會以製造端材料管理。
- 這個分類會影響後續管理行為，例如預設追加修訂類型。
- 同一個
IPC-2581分別以兩種意圖匯入時，通常會形成兩個獨立文件，而不是自動合併。
同時，目前開啟後的顯示行為尚未強烈表達設計與製造的差別，所以可見結果仍可能相當接近。
為什麼匯入選擇器沒有列出所有製造套件副檔名？¶
製造資料匯入接受常見壓縮檔、目錄與一般資料輸入。最終是否成功，取決於 App 能否從選取來源中辨識出支援的製造封裝。