首次启动与导入¶
页面目标¶
帮你完成第一次使用闭环：从资料库开始，导入资料，打开工作区，再回到资料库。
支持的平台¶
- iOS / iPadOS：17.0 或更高版本。
- macOS：14 或更高版本。
适合谁阅读¶
- 想完成第一次导入流程的新用户
- 需要验证资料库到工作区导入行为的测试人员
准备条件¶
- PCBAtlas 已经可以进入资料库
- 你手边有内置示例，或已经准备好自己的设计/制造项目文件
操作步骤¶
- 从资料库出发，根据来源选择
Import File或Import Folder。 - 如果来源是
IPC-2581 XML，在提示出现时选择导入意图。 - 等待资料库顶部的导入进度完成，再打开生成的文档。
- 确认独立 PCB 来源进入 PCB Viewer；原理图来源与含原理图的 KiCad 项目进入 Schematic Workbench，并且修订信息符合预期。
结果¶
- 来源资料会作为新文档或新修订进入资料库，并且工作区会打开对应的 PCB Viewer 或 Schematic Workbench。
首次冷启动的默认资料¶
当资料库为空时，应用会自动加入三份可以直接打开的示例文档：
h730duino（ODB++ 制造资料）BluePhil（KiCad 设计板）WooKey Mainboard（包含 PCB 与层级原理图的 KiCad 项目）
如果只是熟悉交互，可以先打开其中一个示例。如果要验证自己的资料，请继续走下面的导入流程。
当前支持的导入路径¶
Import File¶
- 单个
DSN、KiCad .kicad_pcb、独立KiCad .kicad_sch或IPC-2581 XML - 普通 KiCad
.zip，以及应用能够识别的 ODB++ / Gerber / Drill 制造资料压缩包 - 兼容的
.epcbdoc.zip文档包
不要把 .kicad_pro 当作孤立文件导入；项目需要同目录的原理图、库与设置文件，请改用 Import Folder。单个 .kicad_sch 只有在不引用子 sheet 时才能直接导入；多 sheet 原理图也应通过项目文件夹导入，应用不会再弹出第二个文件选择器补充目录权限。
Import Folder¶
- 含有效
.kicad_pro的 KiCad 项目目录，包括只含原理图的项目
文件夹与压缩包的来源选择¶
Import Folder 只接受 KiCad 项目：PCBAtlas 必须找到有效的 .kicad_pro；如果没有项目文件或项目无法重新打开，导入会直接报错，不会降级成 .kicad_pcb 或 .kicad_sch 导入。如果发现多个项目，会要求你明确选择，不会静默挑选。成功导入后，所选目录内的全部常规文件都会按原相对路径保存在同一修订中，包括项目闭包之外的说明文件或制造输出；遇到不可读文件、符号链接或其他不受支持的目录项时会整体失败，不会只保存一部分。
从 Files、iCloud Drive 或第三方文件提供器选择项目目录时，应用会先把完整目录准备为本地临时快照，再检查项目入口。.history 等历史目录仍会按原路径保存在修订中，但其中的 PCB 或原理图只作为历史支持文件，不会与 .kicad_pro 同目录的当前设计争夺打开入口。
对于仍保留 KiCad 5 .sch 原理图的项目，如果 .kicad_pro 指向的同名 .kicad_sch 已不存在，但同目录存在精确同名的 .sch，PCBAtlas 会把该 .sch 及其子 sheet 识别为项目原理图，并允许 PCB 与原理图双画布打开。应用不会改选无关 .sch；只有 .pro 而没有 .kicad_pro 的旧项目目录仍不属于 Import Folder 支持范围。
打开 KiCad 项目时，应用会优先打开与项目同名的原理图；没有同名原理图时按路径排序选择一个可用原理图。项目同时包含 PCB 与原理图时，应用会在同一进度阶段准备两幅画布，完成后默认显示双画布；只有一种设计来源时显示单画布，画布切换按钮不可用。
IPC-2581 的特殊行为¶
选择 IPC-2581 XML 后，应用不会自动猜测它应该按设计资料还是制造资料处理，而是会弹出确认框，让你选择：
- 作为设计资料导入
- 作为制造资料导入
推荐操作步骤¶
- 在资料库首页点击
Import File或Import Folder。 - 单个文件和压缩包使用
Import File；包含.kicad_pro的完整 KiCad 项目目录使用Import Folder。 - 选中文件后，如果它是
IPC-2581 XML，再选择导入意图。 - 等待资料库顶部的导入进度条推进。
- 导入完成后，会出现新的文档卡片，或目标文档的修订数量增加。
- 打开文档进入工作区，确认 PCB 与原理图都存在时默认显示双画布；只有一种设计来源时显示单画布，并确认
Project / Data内容完整。
你会看到哪些反馈¶
- 资料库顶部会显示导入中的横幅，包含标题、阶段详情和百分比。
- 打开项目时，竖屏或紧凑布局会保持在 Viewer 进度页；画布准备完成后再直接展示可操作内容，不会提前切到
Project页面。 - 如果你在导入过程中手动打开了另一个文档，导入仍会继续完成，但完成后不会强行把焦点切回新导入的文档。
- 如果你在已有文档打开时把新板文件拖进工作区，应用会先询问是否替换当前内容。
导入 KiCad Project 或原理图后¶
通过 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 工具完成。
修订相关操作¶
在文档卡片的操作菜单里，你可以：
- 追加设计修订
- 追加制造修订
因此，导入不只是创建新文档的入口，也是维护同一项目后续修订历史的方式。
同名同格式重复导入的当前规则¶
当来源资料使用同一个文档名和同一种格式再次导入时，当前版本会把它视为同一文档的又一次输入，而不是自动创建新的顶层卡片：
- 如果新导入的原始源与当前修订字节完全一致，应用会提示没有变化并忽略本次导入
- 如果原始源不同，应用会把它保存为该文档下的新修订，并切换到最新修订
- 修订标签会根据文档名动态显示为
A1 / A2 / ...
使用建议¶
- 第一次验证时，先从单个
DSN或KiCad文件开始。 - 对制造资料，导入前先确认压缩包或目录内容完整。
- 同一项目反复更新时，优先追加修订，不要创建多个几乎相同的文档。
常见问题¶
为什么选择 IPC-2581 后系统还要再问一次？¶
因为同一个 IPC-2581 XML 既可能被当作设计侧资料，也可能被当作制造侧资料。当前版本要求你明确选择。
为什么同一个 IPC-2581 选择设计和制造意图后，看起来几乎没有区别？¶
这是当前版本的正常现象。对 IPC-2581 来说，现在主要差别在资料库侧的导入意图和文档分类，而不是工作区里立刻可见的视觉差异。
- 选择设计意图时，文档会按设计侧资料管理。
- 选择制造意图时，文档会按制造侧资料管理。
- 这个分类会影响后续管理行为，例如默认追加修订类型。
- 同一个
IPC-2581分别以两种意图导入时，通常会形成两个独立文档，而不是自动合并。
与此同时，当前显示行为还不会强烈表达设计/制造分类差异，所以打开后的可见结果可能仍然很相似。
为什么导入选择器没有列出每一种制造包后缀？¶
制造资料导入接受常见压缩包、目录和通用数据输入。最终能否导入，取决于应用能否从所选来源中识别出支持的制造包结构。