用 JLCPCB 制造/组装 PCB 时：生成兼容…

当你使用 JLCPCB（含 LCSC 零件库）订购裸板、钢网或贴装 PCB 时，按此生成兼容文件、检查能力约束并避免上传被拒。

适用场景

解决思路

1. 原型阶段：从 JLCPCB 订购裸 prototype PCB 和 framed stencil，零件从 DigiKey/Mouser 单独采购并在实验室手工组装；生产阶段（100s qty）从 JLCPCB 订购全组装板并使用 LCSC 零件，PCBWay 可作为替代组装商。
2. 在流程中调用相关技能：用 `kicad` 读取/分析 KiCad 项目并按 JLCPCB 能力做 DFM 评分；用 `bom` 做 BOM 管理、gerber/CPL 导出和 stencil 下单；用 `digikey` 搜索原型采购（主，也用于通过 API 下载 datasheet）；用 `mouser` 作为二级原型采购；用 `lcsc` 搜索生产采购；用 `pcbway` 作为替代制造/组装；制造前用 `emc` 做 EMC 预合规风险分析；提交制造前用 `spice` 验证模拟子电路。
3. 优先选用 Basic 零件：常见零件（电阻、电容、二极管、常见 IC）预载在贴片机上，无额外费用。
4. 需要 Extended 零件时，注意 300k+ 不常用零件按需装载，每个唯一 extended part 费用 $3。
5. 在假设 extended part 标准 $3 费用前，检查 JLCPCB 当前 parts library 页面；JLCPCB 偶尔对部分常用 extended 零件促销，可能折扣或免除 feeder fee，名称和条款会变化。
6. BOM 匹配使用 LCSC Part Number（`Cxxxxx`，例如 `C14663`）作为权威标识；用 `lcsc` 技能搜索零件。
7. 搜索 JLCPCB 零件库使用 `https://jlcpcb.com/parts/componentSearch?searchTxt=<query>`；仅搜索 Basic parts 使用 `https://jlcpcb.com/parts/basic_parts`。
8. 准备 BOM：JLCPCB 接受 CSV、XLS 或 XLSX；必须包含 `Comment`/`Value`、`Designator`（参考标号，逗号分隔，如 C1,C2,C5）、`Footprint`；推荐 `LCSC Part #`。LCSC 编号列标题必须精确为 `LCSC Part #` 或 `LCSC Part Number`，拼写错误会导致上传失败。
9. 从 KiCad 导出 BOM：在 KiCad 原理图编辑器中给每个符号添加 `LCSC` 字段并填入 LCSC 编号；导出 BOM 为 CSV，列为 Reference、Value、Footprint、LCSC；重命名列为 `Reference` -> `Designator`、`Value` -> `Comment`、`Footprint` -> `Footprint`、`LCSC` -> `LCSC Part #`。
10. 需要 gerber 导出设置、CPL 格式和 stencil 下单时，参见 `bom` 技能。
11. 申请 JLCPCB 官方 API：在 `https://api.jlcpcb.com` 申请；访问受控，需根据订单历史和企业资料审核。获批后可用 Components API（实时定价、库存、元件规格）、PCB API（上传 gerbers、报价、下单、跟踪状态）、Stencil API（钢网报价和下单）、3D Printing API（SLA/MJF/SLM/FDM 下单）。
12. 遵守标准 PCB（1-2 层）设计规则：线宽最小 0.127mm (5mil)、线距最小 0.127mm (5mil)、过孔直径 0.45mm、过孔钻孔 0.2mm、环宽 0.125mm、最小孔 0.2mm、板厚 0.4-2.4mm（默认 1.6mm）、最小板尺寸 6x6mm、最大板尺寸 500x400mm（2 层）。
13. 遵守多层板（4+ 层）设计规则：线宽最小 0.09mm (3.5mil)、线距最小 0.09mm (3.5mil)、过孔直径 0.25mm、过孔钻孔 0.15mm、板厚 0.6-2.4mm。
14. 如果有 JLCPCB `.kicad_dru` 设计规则文件，在 KiCad Board Editor > Board Setup > Design Rules > Import Settings 中导入。
15. 选择 Economic 组装：仅顶层、仅 SMD、最小元件 0201、fine-pitch BGA/QFP 到 0.5mm pitch、周转约 3-5 天、每个唯一 extended part $3。
16. 选择 Standard 组装：支持顶层+底层、SMD+通孔、最小元件 01005、fine-pitch BGA/QFP 到 0.4mm pitch、周转约 3-5 天、每个唯一 extended part $3。
17. 遵守组装通用约束：组装最小订单 5 PCBs；unique parts 无硬限制，但每个 extended part 加 $3；Basic parts 无额外费用并预载在机器上。
18. 处理旋转偏移：JLCPCB pick-and-place 对某些封装使用与 KiCad 不同的旋转约定。常见偏移：SOT-23/SOT-23-5/SOT-23-6 +180°；SOT-223 +180°；SOIC-8/SOIC-16 +90° 或 +270°；QFN（所有尺寸）+90°；SMA/SMB/SMC 二极管 +180°；USB-C 变化，查 datasheet。
19. 修复旋转问题：上传前直接在 CPL 文件的 Rotation 列添加旋转修正；自定义封装验证 pin 1 方向符合 JLCPCB 期望；JLCPCB 审核步骤会捕获大错误，但对称零件（电容、电阻）的细微 180° 旋转可能漏过；首次组装订单后，记录所需旋转修正并应用到未来 CPL 导出。
20. 原型订单（裸 PCB + 钢网）：从 KiCad 导出 gerbers（设置见 `bom` 技能）；上传 gerbers 到 `https://cart.jlcpcb.com/quote`，配置层数、厚度、颜色、数量；添加 framed stencil 到购物车（使用 gerbers 的 paste layers）；下单，PCB 和钢网通常约 1 周到达。
21. 生产订单（组装板）：从 KiCad 导出 gerbers（见 `bom` 技能）；导出 BOM 为 CSV 并带 LCSC 编号（格式如上）；导出 CPL（placement file）为 CSV（格式见 `bom` 技能）；上传 gerbers 到 `https://cart.jlcpcb.com/quote`，配置层数、厚度、颜色、数量；启用 `PCB Assembly`，选择 Economic 或 Standard；上传 BOM 和 CPL 文件；复核零件匹配，通过搜索 LCSC 编号修复任何未匹配零件；确认并下单。
22. 转换 Altium/KiCad BOM 和 CPL：对于从 Altium（或其他工具）导出且 BOM/CPL 格式不匹配 JLCPCB 期望列时，使用 `bom` 技能中的 `translate_bom_pnp.py`。BOM 子命令：`python3 skills/bom/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv`，输出 JLCPCB BOM CSV（Comment、Designator、Footprint、LCSC Part #、MPN、Manufacturer、Quantity、Notes）。CPL 子命令：`python3 skills/bom/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv`，输出 JLCPCB Pick-and-Place CSV（Designator、Mid X、Mid Y、Layer、Rotation），并进行 mil→mm 和 TopLayer/BottomLayer 归一化。
23. 执行 3 步 PCBA 上传工作流第 1 步：先转换 BOM，生成 JLCPCB 格式 BOM 并建立权威 designator 集：`python3 skills/bom/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv`。
24. 执行 3 步 PCBA 上传工作流第 2 步：用 `--bom` 过滤模式转换 CPL，将 CPL designators 与 BOM designators 取交集，删除孤儿：`python3 skills/bom/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --bom jlc_bom.csv`；检查返回的 `filtered_orphans` 数量和 `filtered_orphan_samples` 列表，上传前确认哪些 CPL 行被丢弃；常见孤儿（mounting holes、fiducials、test points）是预期的，其他可能表示 BOM/PCB 不匹配，值得调查。
25. 执行 3 步 PCBA 上传工作流第 3 步：单独列表 consigned-parts 成本。JLCPCB 报价不会自动逐项列出 consigned（用户提供）零件成本；构建报价摘要，显示 PCB fabrication、PCBA assembly fee、basic vs extended parts cost（按 JLCPCB 发票）以及单独的用户采购零件小计；没有这个分解，报价会低估真实单位成本。
26. 注意 JLCPCB 网页上传 UX 会以无帮助错误静默拒绝带 orphan-designator 的 CPL；通过 `--bom` 做 parity check 是提交干净 PCBA 订单的最高价值步骤。
27. 优先 Basic parts：无额外费用、通常有货、组装更快。
28. 订购前检查库存：extended parts 可能缺货；用 `lcsc` 技能搜索。
29. 小板让 JLCPCB 拼板（panelize），通常比自定义面板便宜。
30. 焊料选择：默认是有铅（HASL）；如需无铅，选择 lead-free HASL 或 ENIG。
31. 阻抗控制：多层板可用；在订单备注中指定 stackup。
32. Castellated holes：支持；在订单选项中启用。
33. V-cuts 和 mouse bites：支持用于分板。
34. 丝印最小：0.8mm 高度、0.15mm 线宽，以保证可读文本。
35. 边缘 clearance：铜距板边 >=0.3mm，推荐 0.5mm。

适用边界 · 注意事项

• 需要双面贴装或通孔组装时，不要选 Economic；应选 Standard 或改用支持这些工艺的组装商。
• 不能使用 JLCPCB/LCSC 零件库、或项目要求其他制造商/供应链/地区时，不适用。
• 只需 Gerber/CPL/BOM 导出或钢网下单时，优先用 `bom` 技能；不要重复本技能的完整 PCBA 上传工作流。