PCB 单拼版核心能力跃迁大小拼完整方案 × 尺寸序列驱动 × 阻抗条算法演进本文记录了 ai-pcbcut 单料号拼版模块在 2026年7月28-29日两天内的密集迭代——共计30 次提交涉及9 个文件、1011 行新增、454 行删除。核心主题包括大小拼方案从「一刀两片」到「多片组合旋转A/B双向编辑完整可视化」的能力跃迁、WPnl 尺寸序列从「被动过滤」到「主动驱动」的算法重构、阻抗条放置经历 5 次位置演化的设计决策、以及方向标记从文本符号到 Canvas 矢量 F 字母的视觉进化。一、两天迭代全景7月28日 7月29日 ════════════════════════════════ ════════════════════════════════ 单拼页面UI重组 留边最大化 方向指示: 三角旗 → F字母 大小拼多片组合排布 F标记放大×2 粘连修复 开料图大小拼 WPNL-B 渲染 阻抗条: 居中 → 工艺边 → 行空隙 WPNL旋转90°(宽高互换多放一片) WPnl尺寸序列: 过滤 → 驱动生成 大小拼引擎合并(代码减半) 模板字段完整映射 工作板范围检查修复 displayGroups 方案条数限制 开料图多行多列渲染(Wpnl不超出) Coupon重命名为阻抗条 启动命令修复 大小拼WPnl-B完整支持两天 30 次提交每一次都是对单拼版功能的纵深打磨。二、大小拼从「一刀两片」到完整方案闭环这是两天迭代中变动量最大、也是业务价值最高的一条主线。2.1 背景回顾单料号拼版中当用户开启「含大小拼」开关后引擎在 SET 上做直切分割产生 WPnl-A大面积和 WPnl-B小面积两种工作板分别排入不同数量的 PCS以提升整体利用率。之前的大小拼实现是一个「概念验证」级别单一直切线一刀切出 A 和 B各占一块固定区域。存在几个明显的短板排布僵化A 只有 1 片、B 只有 1 片无法多片组合方向固定WPnl 不能旋转 90°错失了宽高互换可能带来的额外容量B 不可见开料图上只能看到 AB 是隐形的不可编辑B 板的 PCS 排列只能在概念上计算无法在编辑器中调整2.2 多片组合排布从 11 到 MN核心突破1e8d3a1将一刀两片改为多片组合排布。之前: 一刀切 → A×1 B×1 现在: 枚举 cutColsA × cutColsB → A 放 N 片 B 放 M 片 水平布局: [A][A][B][B][B] ← cutColsA2, cutColsB3 同行(rows一致), 同高排列 垂直布局: A A A ← cutRowsA2, cutRowsB3 B B B B B 同列(cols一致), 同宽排列算法核心——枚举 {cutColsA, cutColsB} / {cutRowsA, cutRowsB} 找到最优填满方案// 水平布局枚举for(intca1;ca*wpnlAWbw*0.85;ca){doubleusedWca*wpnlAW;doubleremainWbw-usedW;intcb(int)((remainWkerf)/(wpnlBWkerf));if(cb0)continue;// 两尺寸均受工作板尺寸范围约束if(wpnlAWminWorkW||wpnlAWmaxWorkW)continue;if(wpnlBWminWorkW||wpnlBWmaxWorkW)continue;inttotalPcsca*rows*unitsPerBoardAcb*rows*unitsPerBoardB;// 取总PCS最大、利用率最高的组合}这极大地释放了大小拼的潜力——不再是固定的一刀两片而是根据板材尺寸自动适配最佳的 A/B 排列组合。2.3 WPnl 旋转 90°宽高互换多放一片关键突破113289b允许大小拼中的 WPnl 旋转 90°。场景Wpnl-A 尺寸 406×457, Wpnl-B 尺寸 304×406 水平布局: 406(A) 304(B) 406(A) 1116 1000(板宽) ❌ 旋转B: 406(A) 406(B宽) 406(A) 1218 1000 ❌ 旋转A: 457(A宽) 304(B) 761 1000 ✓ 还能加一片!算法实现对每种尺寸组合分别尝试正常方向和旋转 90° 方向宽高互换以寻找更紧凑的排列。2.4 引擎合并代码减半重要重构9b07074大小拼引擎中的正常方向和旋转方向原本是两套几乎重复的代码~346 行重构后合并为一个循环// 重构前: 两套独立代码// 水平布局代码块 × 1 (正常方向)// 水平布局代码块 × 1 (旋转方向) ← 完全重复// 重构后: 一个循环搞定boolean[]rotStates{false,true};for(booleanrotated:rotStates){doublestepWrotated?unitL:unitW;doublestepHrotated?unitW:unitL;// 正常旋转共用同一套逻辑}// 346行 → 160行2.5 WPnl-B 完整闭环编辑 / 详情 / 拼版图 / 开料图收尾之作2d12f92让 WPnl-B 在前端各个模块中都有完整呈现模块之前之后拼版图只能看 WPnl-AA/B 切换按钮自由切换视图开料图A 单色渲染B 不可见分组渲染B 用橙色块显示 切割线跨组绘制详情页无 B 信息补传 wpnl-b-* 全套参数编辑器不支持 BA/B 双向编辑 独立撤销栈 旋转按钮组配色统一蓝A蓝, B橙黄 (bColorScheme)开料图分组渲染算法870b37a——这是两天中最复杂的前端变更水平布局时: 每组 colsA 个 WPnl-A bPerGroup 个 WPnl-B 组内水平排列 → 板满后换行 → 下一组 切割线在每组内部正确绘制 垂直布局时: 每组 rowsA 个 WPnl-A bPerGroup 个 WPnl-B 组内垂直排列 → 板满后换列 → 下一组关键 Bug 修复去掉了rows1的单行限制仅凭高度比例判断水平/垂直布局类型使多行多列的大小拼开料图正确渲染不再出现 WPnl 超出大板边界的问题。三、WPnl 尺寸序列从边角校验到核心驱动3.1 需求背景PCB 工厂通常有固定的 WPnl工作板规格表——比如 406×457、“18寸标准板” 等。拼版结果的可制造性取决于 WPnl 尺寸是否在工厂已有的治具/工艺能力范围内。之前的实现是「事后过滤」模式先自由枚举所有可能的 WPnl 尺寸 → 然后过滤出表中存在的尺寸 → 丢弃不匹配的。这意味着大量计算被浪费。3.2 算法重构从事后过滤到主动驱动第一阶段20e492f→176c311建立过滤机制。// 从 templateParams 解析 wpnlSizeTable// compactWP 计算后查表匹配±5mm 容差// 不在表中 → 跳过不产生方案问题发现过滤位置不对。最初放在tryCompactPlace内部只覆盖紧凑排布路径常规方案、大小拼、花式拼、横直料方案的 WPnl 没有被校验。修复——统一后置过滤// singleOptimize 末尾统一过滤// 覆盖所有方案类型: 常规、大小拼、花式拼、横直料// 大小时: A 和 B 都必须在表中if(wpnlSizeSet!null){for(SingleOptimizeVariantv:allVariants){booleanaMatchanyMatch(wpnlSizeSet,v.workBoardW(),v.workBoardH());if(!aMatch)continue;if(v.wpnlBCount()0){if(!anyMatch(wpnlSizeSet,v.wpnlBW(),v.wpnlBH()))continue;}}}第二阶段abf05ec从「过滤」重构为「凑表值驱动生成」。核心思想完全翻转不再自由枚举再过滤而是直接遍历表中尺寸作为目标反算 PCS 排列。privateListSingleOptimizeVariantoptimizeBySizeTable(SingleOptimizeRequestrequest,SetStringsizeSet,doublemarginAutoAdd){for(Stringsz:sizeSet){inttargetW406,targetH457;// 从表中解析// 反算在目标 WPnl 尺寸内能放多少行多少列 PCSintmaxCols(int)((targetWspacing)/(stepWspacing));for(intcols1;colsmaxCols;cols){doublecellWcols*stepW(cols-1)*spacing;doublemr(targetW-cellW)/2;// 留边 表尺寸 - PCS网格if(mr0||mrmrMaxmarginAutoAdd)continue;// 同理计算 rowsintmaxRows(int)((targetHspacing)/(stepHspacing));for(introws1;rowsmaxRows;rows){...}}}}关键创新——“凑表值”而非“过滤表值”对比维度过滤模式旧驱动模式新枚举起点自由枚举 SET 网格直接遍历表中尺寸精度±5mm 容差匹配精确命中目标尺寸留边自由选择反算targetW - cellW覆盖率可能有遗漏100% 覆盖表性能计算过滤丢弃多只算命中零浪费验证结果100×150mm PCS spacing0.8精确命中406×457和304×406两个工厂标准尺寸。3.3 开关联动防止脏数据一个容易被忽略的 Bug39f3249模板参数 含 wpnlSizeTable → 合并到 mergedParams → 传给后端 → 即使开关关闭后端检测到 wpnlSizeSet ! null → 仍然执行过滤修复开关关闭时主动清除// 开关关闭时 delete mergedParams.wpnlSizeTable// 确保后端不会收到任何尺寸表数据四、阻抗条放置算法五次演化阻抗条Impedance Bar是 PCB 制造中用于阻抗测试的工艺条需要在 WPnl 上占一个位置。它的放置看似简单实际经历了 5 次位置调整演化路径: 底部(旧) → 居中(避免SET重叠) → 工艺边(避免SET重叠) → 行空隙(最优) → 间距计算修复第一次尝试放在 WPnl 底部旧逻辑阻抗条放在 WPnl 底部工艺边区域。看似合理但实际上阻抗条会和某些大尺寸 SET 重叠。第二次居中放置b3573ea// 阻抗条居中而非底部effH 不再扣减 impBar// 对 ur 2 的 WPnl:midRowrows/2下半SET下移 impBar → 阻抗条在SET行之间 compactWHimpBar第三次放回工艺边106e40c发现居中方案有细节问题——阻抗条在 SET 行间隙中会破坏 SET 的网格对齐。改为放在顶部工艺边区域。第四次放回行空隙1d1f4a7经过多轮权衡最终确定最优方案阻抗条放在 SET 行空隙中央。这需要前后端协同// 后端: impBar 0 且 ur 2 时以 midRow 为界分裂 SET// 下半部下移 impBar → 中间产生 impBar 宽度的空隙// 前端: 通过 items 的 Y 值找最大空隙// 阻抗条绘制在空隙的精确中央位置第五次间距计算修复03d06bc阻抗条有多条时总高度需要包含 spacing// 修复前totalHwidth*count// 修复后totalHwidth*countspacing*count// 每条阻抗条之间有间距技术启示一个放哪里的问题需要前后端协同 多轮验证才能确定最优方案。工程中没有一蹴而就的答案。五、方向标记从文本符号到矢量 F 字母5.1 进化链▲▼◀▶ UNICODE 文本 → Canvas 三角旗 → F 字母矢量图 文本: 简单但无法表达旋转镜像 三角旗: 旗面旗杆组合, 支持旋转, 但辨识度不够 F字母: 开口方向方向, 旋转旋转, 镜像翻转红色5.2 F 字母方案15aba87这是一个巧妙的设计——F 字母的开口天然指示方向正常状态蓝色: F 开口向上 → UP F 开口向右 → RIGHT F 开口向下 → DOWN F 开口向左 → LEFT 旋转90°/270°: F 整体旋转 ±90°开口方向自动跟随 镜像红色: F 水平翻转 X轴偏移 红色绘制 → 清晰区分F 字母的 Canvas 绘制F 的笔画结构: 竖线 (stem): [(-0.65s, 0.75s)] ← 上下延伸 上横线: [(-0.65s, -0.55s)] 中横线: [(-0.65s, 0.05s)] 竖线 上横线 中横线 F 参数 s 自适应缩放 (基于item尺寸和scale)后续还有三次精细调整上下横线间距增大a7ff30bsyTop-0.55s / syMid0.05s / syBot0.55s横线间距 0.60s 避免粘连F 标记整体放大fd13fbdsize 0.38→0.50再次放大ce2609esize 0.50→0.65(整体30%)竖线-0.60~0.65 → -0.65~0.75六、参数模板与 UI 体系完善6.1 模板字段完整映射48779ffapplyTemplateParams之前只映射了部分参数本次补全了所有缺失字段分类补全字段留边范围processEdgeLRMin/Max, processEdgeTBMin/Max, marginLeftRight 等工作板尺寸wpnlMin/MaxWidth, wpnlMin/MaxLength拼版开关enableStaggered, enableDualWpnl, enableHvMaterialAB 拼enableAbRotate/AbMirror, 单双行交替, AB 间隔开料方向forceDirection allowRotation 联动铜箔开料enableCopperCalc, copperMargin/SpacingPCS 折断边breakaway 四边 autoReverseBreakaway pcsSpacing阻抗条impedanceBars(模板数组) → useImpedanceBars 列表6.2 其他工程完善displayGroups9233a51从模板 JSON 解析displayGroups字段默认 20去重排序后截断方案列表避免前端展示过多候选项阻抗条数据兼容a89c701模板中的阻抗条数据存在coupons字段下quantity属性与页面impedanceBars字段格式不同需要兼容映射Coupon→阻抗条20bbe5c统一命名Coupon页签重命名为阻抗条相关变量名全部同步UI 重组31bcc2f单拼页面 UI 重新布局留边最大化页面整体更紧凑七、技术总结7.1 核心突破模块突破大小拼一刀两片 → 多片组合 → 旋转90° → A/B双向编辑完整可视化尺寸序列被动过滤 → 主动驱动生成凑表值精确命中的零浪费算法阻抗条5 次位置演化最终收敛到「SET 行空隙中央 前后端协同」方向标记文本 → 三角旗 → F 字母矢量图8方向旋转镜像全覆盖模板映射补全 20 字段映射实现模板参数→页面控件的完整闭环7.2 设计哲学两天的迭代体现了三个工程原则从能用走向好用——大小拼从概念验证到完整闭环不是加新功能而是把已有的做深做透算法翻转而非修修补补——尺寸序列从过滤改为驱动不是调参数而是重构搜索起点前后端协同布局——阻抗条的位置、开料图的渲染都是前后端各司其职又互相配合项目ai-pcbcut PCB 拼版系统模块单料号拼版Single Scheme技术栈Java Spring Boot Vue 3 Canvas 2D TypeScript开发模式Claude Code AI 辅助编程本文基于 2026年7月28-29日 ai-pcbcut 项目 master 分支的 30 次提交撰写。