Travelerrrrrr / LCSC3D

**简体中文** | English
# LCSC3D：3D 模型内嵌与 AD / KiCad 元件库导出
**从立创商城搜索、账号收藏、购物车、订单或 C 编号选择元件，批量生成 AD / KiCad 符号库，以及自带 3D 模型的封装库。也可独立下载官方 STEP / OBJ。**
LCSC3D 是面向硬件开发、PCB 设计和结构配合的 Windows 便携工具。下载 `LCSC3D.exe` 即可运行，无须安装 Python；生成元件库也无须安装对应的 EDA 软件。
**默认开启封装关联 3D 模型。** AD PcbLib 与 KiCad 9/10 封装直接内嵌 STEP，模型随库文件保存，无需逐个手动关联；KiCad 8 提供外部模型兼容模式。保留 STEP 原始尺寸，并按官方位姿换算放置基准。
**下载 Windows 程序** · 完整源码包 · 使用说明 · 问题反馈
## 开始使用
1. 从 Releases 下载 `LCSC3D.exe`，在 Windows 10/11 x64 上运行。
2. 点击 **立创商城** 搜索元件，或登录后从 **我的收藏** 勾选并加入下载列表；也可输入 `C2040, C20197, C456013` 后点击 **载入列表**。
3. 单击器件行查看预览，勾选需要导出的器件，选择保存目录。
4. 在 **导出到** 中选择 **Altium Designer / KiCad**，勾选所需模型和元件库格式；需要汇总时启用 **Lib → 合并**，分别设置库名。
5. 点击 **开始下载**，完成后点击 **打开器件目录**。在 AD 中打开 SchLib / PcbLib；在 KiCad 库管理器中添加符号库文件和封装库目录。
**再次合并以本次勾选为准。** AD 和 KiCad 的普通导出、合并会在生成成功后覆盖同名库；KiCad 会替换整个同名 `.pretty` 目录，移除旧成员。需要保留的元件须一并勾选。AD 的 **追加** 模式用于向已有库增加元件，KiCad 暂不提供追加。
## 立创商城：选型、资料与采购
商城将 **搜索商品、我的收藏、购物车、我的订单** 放在同一原生界面中，让选型、采购和元件库导出连贯完成。
| 页面 | 可以做什么 |
| --- | --- |
| 搜索商品 | 按 C 编号、型号或关键词查询，浏览官方分类，按品牌、封装、器件参数、价格、库存等条件筛选。查看预览图、完整参数、数据手册和价格区间；分页浏览时保留勾选。 |
| 我的收藏 | 登录后获取商城账号收藏，查找已收藏器件，添加或取消收藏。可直接勾选器件加入下载列表或购物车。 |
| 购物车 | 查看商品预览图、数量、单价、小计和库存状态；在表格内修改数量并自动保存，也可移除商品或将器件加入下载列表。点击“跳转到购物车”在系统浏览器中打开商城购物车，继续确认订单和付款。 |
| 我的订单 | 按关键词和状态查询订单。点击订单，在原表格区域查看购买的器件、物品、图片、数量、单价与金额；勾选器件即可加入下载列表，返回时保留列表位置。完整订单详情可在外部浏览器打开。 |
搜索和收藏表格可直接输入采购数量，按器件起订量和最小递增量调整；搜索单价随数量匹配，仍可展开查看全部价格区间。右键器件行可 **加入下载列表、添加到收藏、添加到购物车**，批量加购使用各行填写的数量。
从搜索、收藏、购物车或订单勾选器件后，点击 **加入下载列表**，软件按 C 编号去重，再统一预览和导出模型、AD / KiCad 元件库。表格列头可拖动调整宽度，双击商品图片可查看原图。
商品行集中展示型号、品牌、封装、类别和简介，有关键参数时一并显示；悬停可阅读完整介绍。分类的子菜单默认收起，按需展开。搜索和订单支持数字页码、省略号与前后翻页，当前页以描边标出。
搜索商品无需登录；收藏、购物车和订单使用立创商城账号。上述账号采购页面适用于中文模式；English 模式使用 LCSC 国际商城搜索，国际站账号在 LCSC.com 管理。
以下为用户提供的商城界面原图，点击可查看大图。
**商品搜索、行内数量与价格区间**
**官方分类浏览**
**多条件与器件参数筛选**
**原生购物车、递增量与批量加购结果**
## 封装内嵌 3D 模型
勾选 AD **PcbLib** 或 KiCad **封装库**，保持 **封装关联 3D 模型** 开启，软件会取得所需官方 STEP 并写入封装。**无需另勾“STEP”下载，也无需在 EDA 中逐个手动关联模型。**
| 目标 | 模型保存方式 | 复制或搬迁 |
| --- | --- | --- |
| Altium Designer | STEP 内嵌到 `.PcbLib` | 模型随封装库文件保存 |
| KiCad 9 / 10 | STEP 内嵌到 `.kicad_mod` | 模型随封装文件保存，保留 `.pretty` 库结构 |
| KiCad 8 | `.pretty/LCSC3D.3dshapes/` 内的外部 STEP | 整体保留 `.pretty` 文件夹及其模型目录 |
以下是用户提供的 AD、KiCad 实测截图，展示导出后的 Type-C 三维效果。点击图片可查看原图。
| AD 内嵌模型示例一 | AD 内嵌模型示例二 |
| --- | --- |
| | |
| KiCad PCB 三维视图 | KiCad 底面与焊盘视图 |
| --- | --- |
| | |
缺少 3D 模型时仍可导出可用的二维封装；模型关联失败会保留二维结果并说明原因。**商城有商品，不代表官方已提供符号、封装或 3D 资源。**具体操作与放置范围见 使用说明 和 模型放置说明。
## 符号与封装导出
| 功能 | Altium Designer | KiCad 8+ |
| --- | --- | --- |
| 文件格式 | 原生 `.SchLib` / `.PcbLib` | `.kicad_sym` / `.pretty` 内的 `.kicad_mod` |
| 独立与合并 | 符号、封装分别控制合并与库名，可保留单器件副本 | 相同操作方式，共享封装自动复用 |
| 引脚电气类型 | 统一导出为 Passive | 默认跟随源数据，也可统一指定；不支持的类型为“未指定” |
| 符号风格 | 嘉立创 / AD，可在预览页切换并应用到导出 | 固定 KiCad 风格；矩形使用直角、实心主体背景填充 |
| 封装几何 | 焊盘、钻孔、槽孔、铜区、图形及原生过孔 | 焊盘、钻孔、槽孔、铜区和图形；过孔以无编号镀通孔保留 |
| 追加与工程 | 追加已有库、自定义工程目录与库名、导入 `.PrjPcb` | 暂不支持追加和工程自动注册 |
KiCad 添加封装库时，**库昵称应与导出库名一致**，例如 `LCSC3D`，以便符号找到对应封装。KiCad 封装中的过孔保留位置、孔径和铜环，网络归属需在 PCB 中确认。导出过程需要近似转换时，会在结果中提示。
两种目标均支持多单元符号、字符串引脚编号和常见贴片 / 通