Skip to content

PartsBridge AD v0.3.4|让立创器件进入可长期维护的 Altium 总库

Choose a tag to compare

@Master-1st Master-1st released this 28 Aug 03:36
· 2 commits to main since this release

让立创器件沉淀为可长期维护的 Altium 资产

PartsBridge AD 不是一次性“下载一个封装”的工具。它面向中国硬件工程师,把立创商城 / LCSC 找料、候选核对、Altium 原生符号与封装生成、STEP 3D 嵌入、长期总库追加,以及 AD 库缓存刷新串成一条 Windows 本地工作流。

项目希望解决的核心问题,是让元件资料不再散落在网页、临时下载目录和单个工程中,而是逐步沉淀成团队或个人可以长期积累、备份、审查和复用的 Altium 总库。

它能做什么

  • 更适合中国供应链:按立创 C 编号、型号或关键词搜索候选,也支持 CSV 批量查询;模糊结果必须由使用者确认后才会写入库。
  • 生成真正可复用的 AD 库:维护 LCSC.SchLib 和 LCSC.PcbLib 两份原生总库,默认请求嵌入可用的 STEP 3D 模型,不把元件强行塞进某一张原理图。
  • 长期追加而不是反复重建:保留历史元件,已有 C 编号直接跳过;追加前备份,发布采用事务和完整性检查,失败时不覆盖上一次有效总库。
  • 减少 AD 重启和重复操作:新增成功后可请求 Altium 重载目标库、刷新已安装库和 Components 缓存;也可以只点“刷新 AD 库”,不会重新查料、下载或生成。
  • 透明、可检查、可迁移:默认免商城登录,不读取浏览器 Cookie;源码按 AGPL-3.0-or-later 公开,Windows 包附源码、许可证、验证记录和 SHA-256。

v0.3.4 的关键进展

  • 加入“追加后刷新 AD 库”和独立刷新命令,刷新结果与库发布结果分开报告。
  • 修复 DelphiScript 外层变量访问错误,避免 Can't access top level variable。
  • 独立 PcbLib 改用 PCB 库枚举器回读,不再把真实封装库误读为 0。
  • 符号与封装都必须同时通过数量和完整名称匹配,才会报告刷新成功。
  • 已打开的库由使用者继续拥有:不自动保存、不关闭原本打开的库或工程、不重启 AD、不模拟鼠标键盘、不自动提权。
  • 警告会显示实际值与期望值,并区分“0 个”与“未回读”;刷新失败无需重新下载或追加已经发布的元件。

下载和使用

  1. 下载 PartsBridge-AD-v0.3.4-Windows-x64.zip 并完整解压;不要只复制 EXE。
  2. 运行 PartsBridge-AD.exe,选择自己电脑上存在且可写的长期总库目录。
  3. 首次使用时,在 Altium Designer 的 Components 面板安装生成的 LCSC.SchLib 和 LCSC.PcbLib。
  4. 投板前仍须按数据手册核对引脚、Pin 1、焊盘、尺寸、3D 高度和方向。

从旧版升级且元件已经追加成功时,只需关闭旧版 PartsBridge AD、完整解压 v0.3.4,以与 AD 相同的权限运行,再点击“刷新 AD 库”;无需重新下载或追加。

验证与边界

  • 125 项自动化测试通过;compileall、依赖一致性和差异检查通过。
  • 最终 Windows 包与源码包通过 CRC、路径安全、逐文件内容和 SHA-256 校验。
  • 最终 EXE 离线自检通过,并确认新的 PCB 枚举和文档所有权保护已经进入程序包。
  • 当前自动验证环境与管理员权限 AD 不一致,因此没有绕过权限执行真实脚本。v0.3.4 在同权限 AD 中的封装回读、临时文档行为和 Components 面板即时显示仍需实机确认。

项目与嘉立创、立创商城、LCSC、EasyEDA 或 Altium 无隶属、授权或背书关系;相关名称和商标归各自权利人所有。