首次启动与导入¶
页面目标¶
帮助你在第一次使用时建立完整闭环：从资料库进入，到导入、打开、再次回到资料库。
首次冷启动的默认资料¶
当资料库为空时，应用会自动预置两份可直接打开的 KiCad 示例文档：
h730duinoBluePhil
如果你只是想先熟悉交互，建议先打开这两份示例文档之一；如果你要验证自己的资料，再继续下面的导入流程。
当前支持的导入路径¶
新建文档或追加修订¶
- 导入文件：用于单个文件输入，例如
DSN、KiCad .kicad_pcb、IPC-2581 XML，也支持选择内含受支持文件夹的.zip压缩包。 - 导入文件夹：用于需要目录授权或目录结构的输入，例如
KiCad .kicad_pro / .kicad_sch所在项目文件夹、Gerber/Drill 包文件夹、ODB++文件夹。
新建导入时不再要求你先判断“设计”或“制造”。PCB Atlas 会根据文件或文件夹内容自动归类；只有 IPC-2581 XML 会继续询问导入意图。
需要现有文档上下文的导入¶
- SES：不能直接新建文档；必须从现有文档的操作菜单进入，并先选择一个 base revision
IPC-2581 的特殊行为¶
当你选择 IPC-2581 XML 时，系统不会直接假设它属于设计或制造；而是会先弹出确认框，让你选择：
- 作为设计数据导入
- 作为制造数据导入
推荐操作步骤¶
- 在资料库首页点击导入入口。
- 如果手头是单文件或
.zip压缩包，选择“导入文件”；如果手头是 KiCad project/schematic 文件夹、Gerber/Drill 包或 ODB++ 目录，选择“导入文件夹”。 - 选择来源后，如果是
IPC-2581 XML，继续选择其导入意图。 - 等待资料库顶部的导入进度条推进。
- 导入完成后，资料库中会出现新文档卡片，或原文档的修订数增加。
- 打开文档进入工作区，确认
2D / Data可正常查看。
你会看到哪些反馈¶
- 资料库顶部会显示导入中的 banner，包括标题、阶段说明与进度百分比；如果此时位于工作区，导入进度会以模态遮罩显示。
- 导入期间如果你已经手动打开了别的文档，导入任务仍会继续完成，但不会强行把焦点抢回新导入文档；在当前工作区导入未结束前，返回资料库入口会暂时不可用。
- 在工作区拖入新的板文件时，如果当前已经打开文档，系统会先询问是否替换当前内容。
- 通过“导入文件夹”导入 KiCad 项目后，资料库会保存项目目录内相关 KiCad 源文件；工作区会出现
Project页，列出Source Documents / Libraries / Settings，并允许在 PCB 与原理图入口之间切换。 - 如果导入失败，系统会弹出错误提示；点击提示里的“复制”可以复制完整错误文本，便于提交复现信息。
KiCad Project 与原理图导入后¶
通过“导入文件夹”选择包含 KiCad .kicad_pro 的项目文件夹后，PCB Atlas 会把项目目录中相关 KiCad 源文件保存到资料库修订里，并在工作区提供 Project 页。这里会按 Source Documents / Libraries / Settings 分组，让你确认本次导入到底包含哪些板文件、原理图、库文件和设置文件。
如果文件夹中没有 .kicad_pro，但只有一个顶层 KiCad .kicad_sch，资料库会按这个原理图入口收集它实际引用到的 child sheet，以及必要的本地库/设置文件；不会把同目录下无关的 .kicad_sch 全部打包进来。若文件夹里存在多个顶层 .kicad_pro 或多个顶层 .kicad_sch，导入会要求你选择更具体的文件夹。
打开原理图时，工作区仍使用 2D 画布，但右侧 Workbench 会切换为原理图专用结构：
Sheets：查看层级、breadcrumb 和可打开的 child sheets。Search：在Current Sheet或Whole Project中搜索Symbols / Nets / Labels / Text / Markers。Selection / Details：显示当前从搜索结果或画布 pick 得到的对象。Problems：展示导入诊断、内容识别结果和原理图工作台不可用时的明确问题提示。
在同一个 KiCad 项目里切换 PCB 与不同原理图 sheet 时，每个源文件会保留自己的 2D 视角与缩略图缓存；首次打开某个源文件会按该文件内容重新适配画布，而不会沿用上一个 PCB 或 sheet 的相机位置。
原理图画布支持点选 symbol / pin / wire / bus / label / text / junction / marker。点选后会同步选择、详情与高亮；多候选命中时可循环候选。原理图编辑、ERC 修复和属性写回继续在专业 EDA 工具中完成。
修订相关操作¶
在资料库卡片的操作菜单中，你可以：
- 为当前文档追加设计修订
- 为当前文档追加制造修订
- 为当前文档导入 SES，并选择可作为 base 的历史修订
这意味着“导入”不只是新建文档，也可以持续维护同一项目的版本演进。
同名重复导入的当前规则¶
从 App 内导入同名且同格式的资料时，当前版本会优先把它视为“同一文档的新一轮输入”，而不是直接再建一张新卡片：
- 如果这次导入的原始源和当前修订完全一致，系统会提示“未变化，已忽略导入”，不会新增修订
- 如果原始源不一致，系统会把它作为该文档的新修订保存，并切换到最新修订
- 修订标签会按文档名动态显示为
A1 / A2 / ...
从系统文件关联打开文件时，行为更偏向“打开这份外部文件”：
- 如果外部文件内容已经存在于某个历史修订，系统会直接切到该修订并打开，不会再提示“未变化”
- 如果同名同格式的文档已存在，但外部文件内容不同，系统会询问是加入为新修订，还是导入成新的资料库文档
- 如果选择导入成新文档，完成后会自动打开新文档
使用建议¶
- 第一次验证流程时，优先从
DSN、KiCad .kicad_pcb或 KiCad 原理图项目文件夹开始。 - 若要导入制造包或 KiCad 项目压缩包，建议先确认目录或
.zip内容完整；单个 Gerber/Drill 文件不作为 App 内新建导入入口，请选择完整制造包文件夹，或选择包含完整文件夹的.zip。 - 对同一项目的迭代版本，优先追加修订，而不是重复创建多个相似文档。
常见问题¶
为什么 SES 不能像普通文件一样直接导入？¶
因为 SES 需要依附某个已有设计修订作为 base revision。当前版本要求你先进入现有文档，再从该文档的菜单里发起 SES 导入。
为什么选择 IPC-2581 后系统还要再问一次？¶
因为同一个 IPC-2581 XML 可能被当作设计资料或制造资料处理，当前版本会显式让你决定导入意图。
为什么同一个 IPC-2581 用两种方式导入后，看起来几乎没有区别？¶
这是当前版本的正常表现。对 IPC-2581 来说，“作为设计导入”和“作为制造数据导入”目前主要区别是资料库里的导入意图与文档分类，而不是一打开就出现明显不同的画面结果。
- 选择“作为设计导入”后，文档会按设计类资料管理。
- 选择“作为制造数据导入”后，文档会按制造类资料管理。
- 这个分类会影响后续管理行为，例如追加修订时默认沿用哪一类导入意图。
- 同一个
IPC-2581文件如果分别按两种方式导入，通常会形成两条独立文档，而不是自动合并。
但在当前版本中，IPC-2581 打开后的显示结果还没有把“设计/制造”差异完整体现在工作区视图上，所以你打开同一个文件时，往往不会立刻看到明显的可视差异。
如果你的目标只是正常查看板内容，两种入口通常都可以完成导入；如果你的目标是让资料库里的文档语义更清晰，建议按该文件的主要用途来选择入口。
为什么不能直接选 .kicad_pro、.kicad_sch 或单个 Gerber/Drill 文件？¶
这些输入通常需要读取同目录或子目录中的关联文件。为了让 iOS/macOS 一次授权完整来源，当前新建导入要求你使用“导入文件夹”，选择包含这些源文件的项目或制造包文件夹。