Repository navigation
Releases
PartsBridge AD v0.3.8|立创中国站到 Altium 长期总库|发布人 foke
PartsBridge AD v0.3.8
维护与发布:foke
GitHub:Master-1st/PartsBridge-AD
这个项目做什么
PartsBridge AD 是一座面向中国硬件工程师的元件数据桥:从立创商城中国站搜索元件,让使用者确认 C 编号、型号与封装后,生成原生 Altium SchLib / PcbLib,嵌入可用的 STEP 3D 模型,并持续追加到同一套长期总库。
它的目标不是“下载一个临时封装”,而是把商城选料、BOM 处理和 Altium 设计资产连接成可复用的本地工作流:历史元件保留、重复 C 编号跳过、新元件先验证后发布、失败不覆盖旧库,并可请求 Altium 刷新库缓存。
对国内研发流程而言,这意味着更少地在网页、数据手册、临时库和工程文件之间反复搬运,也让团队逐步沉淀一套可审计、可备份、可长期维护的 Altium 元件资产。
v0.3.8 主要更新
- 合并中国站优先搜索:优先返回国内库存、人民币价格、C 编号、制造商料号、封装、数据手册和中国商城链接;中国站无结果时才回退全球公开数据。
- 修正 STEP 3D 高度基准:按旋转后的模型真实最低点定位,贴片件落在板面,插件件保留针脚穿板深度,避免模型约一半埋入 PCB。
- 新增安全的 PcbDoc 焊盘恢复源码工具:只替换等长的
Pads6/Data原生流,不再重写整份板文件;模型表、3D Body 引用、原生流清单和非目标流哈希任一失配都会停止。 - 保留长期总库增量追加、历史元件保护、事务发布、备份恢复、重复跳过和 AD 缓存刷新能力。
验证证据
- 142 项自动化测试全部通过;语法编译和依赖一致性检查通过。
- 当前在线搜索
TD331SCANH/C7527764精确返回C7527764、国内库存、人民币价格和 SMD-9 封装。 - 7 个真实贴片/插件 STEP 完成几何边界计算、PcbLib 写入和原生回读。
- 一份不进入仓库的真实 PcbDoc 完成受控恢复,并由 Altium Designer 26.9.1 重新打开、原生保存;模型表与 230 个 3D Body 引用保持完整。
- 发布 EXE 内嵌归档已确认包含中国站接口和 STEP Z 高度归一化逻辑;EXE 文件/产品版本为
0.3.8.0,CompanyName=foke。
下载
PartsBridge-AD-v0.3.8-Windows-x64.zip:Windows 目录版,完整解压后运行PartsBridge-AD.exe,不要单独复制 EXE。PartsBridge-AD-v0.3.8-source.zip:对应本次发布提交的源码。SHA256SUMS.txt:两个压缩包的 SHA-256 校验和。
使用边界
- 当前个人构建未做 Authenticode 数字签名,Windows 可能显示“未知发布者”;
CompanyName=foke是产品元数据,不等同于受信任证书签名。 - 立创/EasyEDA 公开网页配套接口可能变化;正式开放平台凭据仍是可选且待审批项。
- 投板前必须按原厂数据手册复核引脚、Pin 1、焊盘、尺寸、方向和 3D 高度。
- 同权限 Altium 会话中的实际追加、脚本回读、临时文档行为和 Components 面板即时显示仍需继续实机验收;本版本没有把自动化验证描述成全部 GUI/工程签核。
PartsBridge AD v0.3.5|写库前权限门控与配对库诊断|发布人 foke
在写库之前统一 AD 权限,把异常挡在下载和发布之前
维护与发布:foke
GitHub Release 由仓库账号 Master-1st 上传;软件维护与发布名称为 foke。
Windows EXE 文件属性中的公司/发布名称为 foke,产品版本为 0.3.5.0。本版本未使用 Authenticode 证书签名,因此这不会把 Windows SmartScreen 或 UAC 中的“未知发布者”变成“已验证发布者”。
PartsBridge AD 面向 Windows 与 Altium Designer,把立创商城 / LCSC 找料、候选确认、原生符号与封装生成、STEP 3D 嵌入、长期总库追加和 AD 缓存刷新串成一条本地工作流。
v0.3.5 针对真实使用中出现的“追加已经完成,但下一次读取时 SchLib/PcbLib 不再匹配”加强安全边界。新版不会放宽完整性检查,也不会用自动覆盖掩盖异常;它会把权限问题挡在写库之前,并在有哈希证据时指出发布后发生变化的文件。
本版本做了什么
- 写库前权限预检:AD 未运行时允许离线建库;AD 正在运行时,必须只有一个同会话实例,且与元件库桥运行权限一致。
- 更早停止:权限不一致、多 AD 会话或无法可靠判断时,在网络获取、总库目录创建和文件发布之前停止。
- 不能绕过:即使关闭“追加后刷新 AD 库”,写库前权限门控仍然生效。
- 不自动提权:不请求 UAC,不启动、关闭或操控 AD,不修改系统设置。
- 定位配对库异常:当符号引用的本地封装无法解析时,对比上次成功发布记录与当前文件的 SHA-256 和大小,报告后来变化的 SchLib/PcbLib。
- 谨慎提供备份:只有发布前备份确实包含
LCSC.SchLib和LCSC.PcbLib完整库对时,才显示供人工核对和成对恢复的位置;不会自动恢复或覆盖。 - 发布者元数据:Python 项目元数据和总库维护清单记录维护/发布者为
foke。
对真实错误的复现结论
使用当前在线数据按相同顺序隔离生成 C32713268,再追加 C192062(AD5422BREZ-REEL),两者均嵌入 STEP。保存、合并和再次读取获得 2 个符号、2 个封装、2 个模型,完整验真通过;继续追加第三个元件也通过。
因此,已收到日志中的 C192062_AD5422BREZ-REEL / C192062_HTSSOP-24 失配不能由当前器件数据稳定复现。新版仍保留严格阻断,并在上次发布哈希可用时明确指出哪份库后来发生变化。
验证
- 131 项自动化测试通过。
compileall、依赖一致性和差异检查通过。- 最终 EXE 的
doctor报告版本 0.3.5。 - 在真实权限不一致环境中,打包后的
prepare退出 1;测试输出目录没有创建,也没有进入网络获取、库写入或 AD 脚本派发。
下载与使用
- 下载
PartsBridge-AD-v0.3.5-Windows-x64.zip并完整解压,不要只替换 EXE。 - 推荐 AD 和 PartsBridge AD 都使用普通权限;如果 AD 已以管理员身份运行,PartsBridge AD 也必须使用相同权限。
- 追加前仍应在 AD 中保存并关闭
LCSC.SchLib、LCSC.PcbLib文档。 - 投板前按数据手册复核引脚、Pin 1、焊盘、尺寸、3D 高度和方向。
当前自动验证环境与管理员权限 AD 不一致,因此尚未完成 v0.3.5 在同权限 AD 中的实际追加、脚本回读、临时文档行为和 Components 面板即时显示验收。
项目与嘉立创、立创商城、LCSC、EasyEDA 或 Altium 无隶属、授权或背书关系;相关名称和商标归各自权利人所有。
PartsBridge AD v0.3.4|让立创器件进入可长期维护的 Altium 总库
让立创器件沉淀为可长期维护的 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 个”与“未回读”;刷新失败无需重新下载或追加已经发布的元件。
下载和使用
- 下载
PartsBridge-AD-v0.3.4-Windows-x64.zip并完整解压;不要只复制 EXE。 - 运行
PartsBridge-AD.exe,选择自己电脑上存在且可写的长期总库目录。 - 首次使用时,在 Altium Designer 的 Components 面板安装生成的
LCSC.SchLib和LCSC.PcbLib。 - 投板前仍须按数据手册核对引脚、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 无隶属、授权或背书关系;相关名称和商标归各自权利人所有。
元件库桥 PartsBridge AD v0.3.1
PartsBridge AD v0.3.1
元件库桥:面向立创/LCSC 元件检索的 Windows 本地工具,将确认后的 C 编号追加到长期维护的 Altium 原生库。
本版本
- 搜索和批量查询候选;由使用者核对型号后加入队列。
- 输出一套
LCSC.SchLib/LCSC.PcbLib,保留历史符号、引脚、封装及内嵌 STEP;不写入原理图。 - 已有 C 编号提前跳过;新增元件在暂存目录验证,发布前备份,支持受保护的中断恢复。
- 修复非零 3D 高度偏移或旋转导致的
native item preservation failed;完整性校验仍然开启。 - Windows 发布包包含依赖许可证和来源说明;不包含个人元件库、BOM、缓存、账号凭据或模型文件。
下载与使用
PartsBridge-AD-v0.3.1-Windows-x64.zip:完整解压后运行PartsBridge-AD.exe;不要只复制 EXE。PartsBridge-AD-v0.3.1-source.zip:应用源码、测试和构建配置。SHA256SUMS.txt:下载文件的 SHA-256 校验和。
首次启动请选择自己电脑上存在且可写的总库目录。0.3.1 在没有已保存偏好时的默认目录使用 G 盘;没有 G 盘时必须改选。
追加前在 Altium 中保存并关闭两份库。失败批次的 STEP 没有持久缓存,重试可能重新请求;已有元件不会自动更新或补模型。
验证与边界
82 项单元测试通过;原生库副本连续追加和重复跳过验证通过,原有符号、封装和 STEP 保持一致。Windows 包通过离线自检及原生库验真。
这些结果不等于 Altium GUI 可视检查或工程签核;投板前必须对照数据手册复核。公开 JSON 数据源可能限流或变化,库存/价格不保证等同中国站实时成交信息。详细边界见 VALIDATION_REPORT.md 和 README.md。
本项目采用 AGPL-3.0-or-later;第三方组件遵循各自许可证。本项目与立创、嘉立创、EasyEDA、Altium 无隶属或背书关系。