# JLC2AD_AutoLib

**Repository Path**: connor_c/jlc2-ad_-auto-lib

## Basic Information

- **Project Name**: JLC2AD_AutoLib
- **Description**: 用于把嘉立创的元件库快速导入AD
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 小工具

## README

# 立创 Altium 库批量工具

用于将从立创 / EasyEDA 下载的 Altium 文件批量整理为独立的原理图库和 PCB 库。

## 使用界面

双击 `Open-JlcPackage.cmd`，无需输入命令。

### 1. 导出元件库

1. 将原理图下载内容放进一个文件夹，将 PCB 下载内容放进另一个文件夹。
2. 在“导出元件库”页面分别选择这两个文件夹。
3. 输入本次库的名称，点击“开始导出”。
4. 可分别设置“原理图库输出目录”和“PCB 库输出目录”。导出完成后，最终的 `.SchLib` 和 `.PcbLib` 会自动复制到对应目录；“工作目录”只保存中间文件和日志。

会自动识别子文件夹中的 ZIP、`.SchDoc`、`.PcbDoc`、`.SchLib`、`.PcbLib` 和 `.IntLib` 文件。

- `.SchDoc` 会合并为一个 `.SchLib`。
- `.PcbDoc` 会合并为一个 `.PcbLib`。
- 已经下载好的 `.SchLib`、`.PcbLib`、`.IntLib` 不会被修改，而是单独收集保存。

每次导出位于：

```text
Libraries/<库名称>-<时间>/
  Schematic/<库名称>.SchLib
  PCB/<库名称>.PcbLib
  Work/
  batch-result.txt
```

`Work` 与 `batch-result.txt` 用于排错；最终库也会复制到界面中指定的两个输出目录。

### 2. 按型号搜索并一键生成库

在“按型号搜索”页面中，每行输入一个型号或立创 LCSC 料号，例如 `S8050`、`SP485EEN-L` 或 `C2040`。点击“查询立创”后：

1. 在“搜索结果”中核对型号、封装和库存，勾选需要的元件，再点“加入待生成”。
2. 已加入的器件会保留在“待生成清单”中。继续搜索其他型号只会替换上方搜索结果，不会清空待生成清单；相同 LCSC 编号会自动去重。
3. “打开待生成详情”会打开中国大陆立创商城的对应商品页，方便再次核对选型。
4. 确认“库名称”和两个输出目录后，点击“一键生成库”。程序会自动获取每个元件的符号、封装和可用的 3D 数据，合并为一套 `.SchLib` 和 `.PcbLib`，并分别复制到对应目录。

首次一键生成时，程序会询问是否准备转换工具。选择“是”后会依次显示下载 Python 运行环境、安装转换工具的状态；界面会保持响应，单一步骤超过 15 分钟会自动停止并把诊断写入 `tools/engine-install.log`。准备成功后不需要重复安装。每批输出同时包含元件清单、处理日志和失败清单（如果有）。

“保存待生成清单”可将当前清单导出为 CSV 和商品链接列表，便于留档或后续复用。

## 命令行（可选）

仍支持旧的一文件夹模式：

```powershell
.\Open-JlcPackage.ps1 -PackagePath 'C:\Downloads\JLC' -LibraryName 'MyParts'
```

使用两个独立文件夹：

```powershell
.\Open-JlcPackage.ps1 `
  -SchematicPath 'C:\Downloads\JLC-Schematic' `
  -PcbPath 'C:\Downloads\JLC-PCB' `
  -OutputRoot 'D:\AltiumLibraries' `
  -LibraryName 'MyParts'
```

可增加 `-NoLaunch` 仅检查识别到的文件，不启动 Altium。若自动检测不到 Altium，可增加 `-AltiumExe 'D:\Altium\X2.EXE'`。

## 使用前检查

实际用于项目之前，请在 Altium 中检查符号引脚、封装焊盘、尺寸、1 脚方向、禁布区与 3D 模型方向。元件库数据可能随供应商更新，量产前应以数据手册为准。