Skip to content

v2.4.0

Latest

Choose a tag to compare

@github-actions github-actions released this 29 Oct 01:09

JLCEDA MCP 社区版 v2.4.0

Bridge 与 Server 来自同一标签 v2.4.0(提交 c79e43d),请配套安装。

文档重打包说明

按维护者要求沿用 v2.4.0,保留精简文档,并恢复仓库首页与扩展 README 的演示 GIF、功能示意图;扩展安装包已包含 GIF 文件。功能代码未变。标签与附件已更新至上述提交,SHA256SUMS 已重新生成。此前下载过 v2.4.0 的用户如需新版文档与演示,请重新下载安装包。

Bridge

  • pcb_routing_edit 直线修改按请求几何与当前页铜线完整覆盖核验:支持修改后新产生的同网交点拆线(#94)、与原共线相邻段合并,以及 PR #97 复查发现的幂等写入和合并到未变化已有线段。延伸时允许旧 ID 保留为请求的一部分,但须证明写前没有完整覆盖、写后完成新增覆盖,不能用已有重叠铜掩盖未执行的修改;覆盖不足、网络/层/线宽/锁定不符或出现额外铜继续失败。使用 ID 索引避免高密度快照的重复线性查找,整页铜线快照上限为 20000。
  • pcb_pour_manage 重建以当前页回读为权威:原生只返回部分或空填充集合、对未变化覆铜返回 null、或同一填充的相同记录重复时,不单独判定失败;重复数量和 ID 作为诊断。目标覆铜仍有可读填充且每条原生返回均与回读一致时返回 verified:true、verificationScope:"page_readback" 与 nativeReturnCoveredObservedCount;页面回读重复 ID、填充丢失或内容不一致仍拒绝(#95)。
  • design_source_export 的 footprints 动作在原生列表不完整时返回 missingReferencedFootprintUuids 与 missingReferencedFootprintCount,被 limit 截断时不再声明 complete:true(#93)。PR #97 复查补齐引用 API 缺失、返回非法列表、getter 缺失/异常及坏引用数据分支:保留可用源码和部分已知 UUID,明确 complete:false,不把无法盘点当作空 PCB。
  • schematic_component_edit 禁止通过 otherProperty 重放原生库绑定及供应商、制造商别名;自定义属性更新保留其余自定义字段,并核对未请求修改的 canonical BOM 属性。支持读取和比较 Component、Symbol、Footprint 三种库绑定;缺少 getter 时报告 unavailable,绑定改变、失去可读性或 BOM 字段意外清空时返回实际 after 与 mismatches,不报告验证成功。
  • 官方类型固定到 @jlceda/pro-api-types 0.4.27,重新生成离线 API 索引,扩展 engines 更新为 ^3.0.0 || ^4.0.0。api_search 返回备注、弃用信息和 minimumEditorVersions;api_invoke 在版本与元数据可用时,拒绝低于官方门槛的调用,返回 EDA_VERSION_UNSUPPORTED、commitStatus:"not_started"、nativeCallAttempted:false,避免低版本误调用 4.1.79/4.2 新接口或 EDA v4 误调用 v5 新接口。
  • manufacture_export 新增原理图 png、svg,PNG 可选 resolution,提供时至少指定 width/height 中一项,每边为 1–4096 整数;SVG 不接受分辨率参数,多图页 ZIP 保留原生文件名/类型。调用前检查 EDA 3.2.183 / 4.1.23 门槛;旧 document 导出继续兼容,文档标明原生方法从 EDA v4.1 起弃用。
  • design_archive_export 新增 action:"schematic",调用当前原理图归档 API,沿用类型和受限 Base64 输出,并检查 EDA 3.2.183 / 4.1.23 门槛。
  • design_compare 按 0.4.27 官方签名限定原理图比较为 UUID 字符串,PCB 比较新增 valUnit、deviation、comparisonSize 选项;EDA 4.1.78 实机确认后两项须为严格正数,schema 与 handler 提前拒绝零值。原理图/PCB 比较门槛为 EDA 3.2.205 / 4.1.62,按原生 success 判断结果。
  • library_classification_query 优先使用新 getClassificationTree;新方法缺失,或新版合法空树而旧树非空时回退旧 getAllClassificationTree,避免 v4 公共库失去旧分类。新版抛错/非法结果不回退,旧接口缺失或两边均空时保留新版空树;classificationApi 与回退时的 fallbackReason 标明来源。节点增加完整 namePath,uuid 在原生提供时保留,输入和节点/深度限制保持不变。
  • 回归:pcb-routing-split-modify-test.cjs 与 schematic-component-reserved-test.cjs 此前未接入 npm run build,现已纳入 test:pcb-routing 和 test:schematic-components;新增新交点拆线、共线合并、高密度快照、空/部分/null 原生返回与截断完整性用例。
  • Bridge/Server 2.4.0 在 EDA 4.1.78 的专用测试项目副本实测通过:线宽 10→11→10 与幂等写入、器件改名/恢复及 BOM/三库绑定保留、PNG/SVG/原理图归档。末轮复测公共库分类回退返回 total:8654、returned:5 及完整 namePath;覆铜重建原生/页面均为 17 个填充,verified:true、page_readback,不再误入隔离。本轮另验证设计比较、版本门槛、封装源完整性及 recover/readback;详见 2.4.0 验证记录。
  • 两端完整本地 build/test/lint 和多客户端验证通过;末轮分类/覆铜摘要补修后定向测试、lint、typecheck、compile、runtime 再次通过。Server 生产依赖审计 0 项,开发依赖仍有 Bridge 18 项、Server 9 项告警。本轮未重跑 EDA 3.x、未实测索引全部 API;此处记录本地验证;远端检查与下载状态以 GitHub Actions/Release 为准,最终资产校验和随 Release 提供。

MCP Server

  • 配合 Bridge 更新 pcb_routing_edit 与 pcb_pour_manage:拆线/合并按完整覆盖核验,延伸可保留旧 ID 为请求的一部分但须证明新增覆盖;覆铜重建以当前页回读为权威,原生部分、空集合或相同重复记录不单独判为失败,重复保留诊断,页面回读重复 ID 仍拒绝。
  • PR #97 复查补齐幂等直线修改与未变化铜线合并、封装引用盘点不可用时的完整性诊断,以及原理图 Component/Symbol/Footprint 绑定和未请求 BOM 属性的读回保护;Server 继续传递实际状态、差异和未知提交恢复要求。
  • 配合 Bridge 的 EDA 3.x/4.x engines 及官方 @jlceda/pro-api-types 0.4.27 索引,公开 API 备注、弃用说明与最低版本。已知宿主版本不满足元数据门槛时,Bridge 在原生调用前返回 EDA_VERSION_UNSUPPORTED 和 nativeCallAttempted:false,包括 4.1.79/4.2 新增接口及 v5 专用接口。
  • manufacture_export 输入 schema 新增原理图 png、svg;PNG resolution 提供时至少指定一项宽高,每边为 1–4096 的整数,SVG 不接受 resolution。旧 document 分支继续兼容,标注其原生接口从 EDA v4.1 起弃用;新分支要求 EDA 3.2.183 / 4.1.23。
  • design_archive_export 新增 action:"schematic",同步当前原理图归档参数及 EDA 3.2.183 / 4.1.23 门槛;保持受限 Base64 返回。
  • design_compare 原理图来源仅接受 UUID 字符串,PCB 来源保持 UUID 或工程/PCB 对象,并新增 valUnit、deviation、comparisonSize 选项;后两项按 EDA 4.1.78 实机结果要求有限且严格大于零,schema 与 handler 同步。两种比较最低版本为 EDA 3.2.205 / 4.1.62,按原生 success 判断成功。
  • library_classification_query 输入保持不变,输出完整 namePath、可选 uuid、实际 classificationApi 及回退时的 fallbackReason。Bridge 优先新版树,在新方法缺失或新版合法空树而旧树非空时回退;新版抛错/非法结果不回退,旧接口缺失或两边均空时保留新版空树。
  • 匹配 Bridge/Server 2.4.0 在 EDA 4.1.78 的专用测试项目副本实测通过线宽/器件修改与恢复、BOM/三库绑定保留、新导出,以及末轮公共库分类回退和 17 个填充的覆铜重建;重建 verified:true、page_readback,无误隔离。本轮另验证比较、版本拦截、封装源完整性和 recover/readback,范围见 2.4.0 验证记录。
  • 两端完整本地 build/test/lint、多客户端验证通过;最后分类/覆铜摘要补修后定向测试、lint、typecheck、compile、runtime 再次通过。Server 生产依赖审计 0 项,开发依赖仍有 Bridge 18 项、Server 9 项告警;本轮未重跑 EDA 3.x,也未逐项实测新索引全部 API。此处记录本地验证;远端检查与下载状态以 GitHub Actions/Release 为准,校验和随最终 Release 附件提供。

安装包与验证

  • EDA 扩展:mcp-bridge-community-2.4.0.eext
  • MCP Server:jlceda-mcp-server-2.4.0.tgz
  • SHA-256 校验:SHA256SUMS

发布工作流已完成 Windows/Linux Server 测试和 Linux Bridge 构建、lint 与打包;这不替代 CHANGELOG 中明确记录的 EDA 宿主实测。此流程不发布到 npm registry。