FPC 速成引擎
海洋湃1v26.10.1
FPC 排线参数化速成引擎，支持焊盘阵列、金手指、补强板自动生成，符合 JLCPCB/PCBWay 工艺规范
详情
更改日志
历史版本
评论
FPC 速成引擎
海洋湃1详情
更改日志
历史版本
评论
FPC 速成引擎
English | 简体中文 | 繁體中文 | 日本語 | Русский
FPC 速成引擎是嘉立创 EDA 专业版的 PCB 扩展。设置焊盘数量、间距和排线尺寸，即可生成两端焊盘、连接导线、板框和可选的 FR4 补强板，适合绘制直线 FPC 排线的初始图形。
安装后，在 PCB 编辑器打开 高级 → FPC 速成引擎 → 生成排线。
功能特性
- 两端焊盘阵列：左右两端各一排，数量、中心间距、焊盘长度和宽度可调；支持矩形、长圆和界面标为“圆形”的椭圆焊盘。
- 直线连接：在顶层连接左右对应焊盘，可设置线宽及两端焊盘中心距。
- 板框轮廓：分别设置焊盘侧边距、端边距和板框圆角。
- FR4 补强板：可在底部补强层生成两端补强，厚度固定为 0.2 mm，向排线内侧的延伸长度可调；外侧圆角随板框设置。
- 扣位轮廓：可开启四处向外凸出的扣位，调整位置、尺寸、切角和圆角；开启补强时，补强轮廓随扣位延伸。
- 清除与反馈：提供清除按钮、可展开的运行日志和明暗主题切换；清除范围见下文。
功能演示
在 PCB 中使用默认参数生成的排线：左右各 10 个焊盘、10 条导线、板框和两端 FR4 补强，扣位关闭。
参数面板；向下滚动可继续设置扣位尺寸并使用生成、清除按钮：
安装
导入扩展包
- 打开嘉立创 EDA 专业版，进入 高级 → 扩展管理器。
- 点击 导入，选择
fpc-generator-v3_v26.10.1.eext。 - 打开需要绘制排线的 PCB，使用 高级 → FPC 速成引擎 → 生成排线。
扩展清单声明的最低版本为 EDA 3.2.69；当前生成与补强清除流程已在 V4.1.71 验证，不代表所有旧版宿主均已验证。
从源码构建
在包含 package.json 的工程根目录执行，需先准备 Node.js 和 npm：
npm install --ignore-scripts
npm run build
--ignore-scripts 用于跳过工程里旧的自动安装钩子。构建产物位于 build/dist/fpc-generator-v3_v26.10.1.eext，构建后按上面的步骤手动导入。
使用步骤
- 打开目标 PCB。首次使用可在空白 PCB 中绘制，生成图形以画布原点为中心。
- 从 高级 → FPC 速成引擎 → 生成排线 打开面板，设置焊盘形状、数量、尺寸和板框边距。
- 按需要开启补强板、扣位并设置相关尺寸，然后点击 生成。
- 在画布查看生成结果；默认参数生成左右各 10 个焊盘、10 条导线、1 个板框和 2 个补强板。
- 需要调整参数重新绘制时，在同一个面板中先点 清除，再点 生成。点击底部 运行日志 可查看结果或错误。
重复点击“生成”会继续添加图形，不会自动替换上一批。请先清除再生成，避免图形重叠。
参数说明
下面的范围来自当前面板输入框，不是制造工艺标准。所有尺寸单位均为 mm；生成前还会检查焊盘数量、间距、长宽、线宽和排线长度的下限，其余尺寸及相互关系需自行核对。
| 参数 | 默认值 | 面板范围 | 说明 |
|---|---|---|---|
| 焊盘形状 | 矩形 | 矩形 / 长圆 / 圆形 | “圆形”按长、宽生成椭圆，长宽相等时为圆 |
| 焊盘数量 | 10 | 2–100 | 单侧焊盘总数 |
| 焊盘间距 | 0.5 | ≥ 0.3 | 同一端相邻焊盘的中心距 |
| 焊盘长度 | 3.5 | ≥ 0.5 | 沿排线方向（X 轴）的长度 |
| 焊盘宽度 | 0.3 | ≥ 0.2 | 沿焊盘排列方向（Y 轴）的宽度 |
| 导线宽度 | 0.15 | ≥ 0.1 | 连接左右对应焊盘的线宽 |
| 排线长度 | 30 | 5–200 | 左右两端焊盘的中心距，不含焊盘向外伸出的部分和端边距 |
| 焊盘侧边距 | 0.4 | ≥ 0.1 | 最外侧焊盘边缘到板框上下边的距离 |
| 端边距 | 0.15 | ≥ 0.1 | 焊盘外端到板框左右端的距离 |
| 圆角半径 | 0.2 | ≥ 0 | 板框圆角；0 为直角，实际半径会按几何尺寸限制 |
| 启用补强板 | 开启 | 开启 / 关闭 | 生成左右两端 FR4 补强板 |
| 延伸长度 | 1.0 | 0.5–10 | 补强向排线内侧超出焊盘的长度 |
| 启用扣位 | 关闭 | 开启 / 关闭 | 在板框四角附近生成向外凸出的扣位 |
| 扣位上端 | 2.8 | ≥ 0.5 | 与“扣位高度”共同确定扣位距左右端边的位置，见下文 |
| 扣位宽度 | 0.8 | ≥ 0.3 | 当前实现中为扣位向板框外侧凸出的距离（Y 轴） |
| 扣位高度 | 1.4 | ≥ 0.5 | 当前实现中为扣位沿板框边的长度（X 轴） |
| 切角 C | 0.5 | ≥ 0 | 扣位外角的切角尺寸；0 表示不切角 |
| 扣位圆角 | 0.2 | 0–1 | 扣位转角及与板框连接处的圆角；0 表示直角 |
扣位参数沿用面板上的名称。扣位靠近左右端边的一侧与端边的距离为 max(0, 扣位上端 − 扣位高度)；默认值对应 1.4 mm。开启扣位后，请检查扣位、圆角与补强的轮廓是否符合所用连接器尺寸。
生成图层
| 图形 | 图层 | 固定设置 |
|---|---|---|
| 焊盘、导线 | 顶层（1） | 左右两端焊盘按 1 起编号 |
| 板框 | BoardOutline（11） | 轮廓线宽 0.1 mm |
| 补强板 | Bottom Stiffener（59） | FR4，厚度 0.2 mm |
开启补强时，扩展会把当前 PCB 类型设为柔性板。
清除范围
- 同一个面板内生成后清除：删除该面板记录的最近一批焊盘、导线和板框，并清除当前 PCB 中带本扩展标记的补强板。
- 关闭面板再重开后清除：可重新找到并删除当前 PCB 中带本扩展标记的补强板，包括之前生成的补强；不会恢复此前焊盘、导线和板框的记录，这些图元需要在 PCB 中手动处理。
- 连续生成多批后清除：普通图元只保留最近一批的记录，因此应先清除再生成。
- 如果读取 PCB 或清除补强失败，运行日志会显示错误。清除后请检查画布结果。
已知限制
- 当前为固定横向布局，左右两端各一排焊盘，没有方向切换或独立的阵列宽度输入。
- 两端使用相同焊盘和补强尺寸，不支持两端不对称配置。
- 导线为直线，不沿板框轮廓绕行；生成图形仍需按工程需要检查网络连接和设计规则。
- 补强只支持底部 FR4，材质和厚度不能在面板中调整。
- 本扩展用于辅助绘图，不自动校验连接器配合、弯折要求或板厂制造规则；生产前需按实际设计复核。
版本历史
参见 CHANGELOG.md
许可证
本作品采用 CC BY-NC 4.0 许可协议进行许可。 允许个人使用、学习、修改和分发，禁止商业用途。
Changelog
所有重要更改都将记录在此文件中。
[未发布]
[26.10.1] - 2026-10-13
变更
- 完善中文 README，补充功能演示图、V4 菜单入口、当前参数默认值与范围、源码构建步骤和清除限制。
- 版本号沿用“年.月.小迭代”，本轮为 26.10.1。
修复
以下为此前已完成的 V4 兼容修复补记，本轮未修改功能代码：
- 修正扩展元数据中的空格网址，解决上传时的 homepage 校验报错。
- 调整补强板写入格式和删除方式，修复清除补强时的“格式错误”。
- 修复关闭面板再重开后无法清除补强的问题；普通焊盘、导线和板框仍不能跨面板找回。
- 读取 PCB 源码失败或补强删除失败时显示错误，不再提示清除成功。
v26.5.34 (2026-05-26)
Fixed
- 修复右上扣位补强 L/ARC 命令互换导致轮廓不跟随板框
- 焊盘长度默认值改为 3.5mm
v26.5.33 (2026-05-26)
Added
- 扣位补强轮廓跟随：补强板现在跟随扣位凸出轮廓，覆盖扣位区域以增强机械强度
- 新增 writeStiffenerFpcFill / buildStiffenerContourPath / createStiffenerContoured 函数
v26.5.32 (2026-05-26)
Fixed
- 修复扣位上端计算公式：buckleCornerOffset = buckleTopPos - buckleWidth（扣位上端减去扣位高度）
v26.5.31 (2026-05-26)
Fixed
- 修复扣位标签文字互换（扣位高度/宽度标签之前互换了位置）
- 修复扣位上端计算公式：buckleCornerOffset = buckleTopPos - buckleHeight
[26.5.29] - 2026-05-26
Added
- 新增"清除"按钮，一键清除生成的板框、补强、焊盘和导线
Fixed
- 修复扣位模式下板框圆角方向错误（向内→向外）
[26.5.28] - 2026-05-26
Fixed
- 修复扣位模式下板框圆角半径未生效的问题（板框四角新增圆角支持）
[26.5.27] - 2026-05-26
修复
- （待补充）
[26.5.22] - 2026-05-26
修复
- 还原扣位圆角半径处理逻辑至 v26.5.19 行为
- 避免
Number.isFinite修改对板框与补强圆角半径的意外影响
- 避免
[26.5.21] - 2026-05-26
修复
- 扣位圆角半径设为0仍生成圆角：修复参数收集阶段的
|| 0.2导致0被误判为falsy的问题- 参数收集时保留原始值，fallback逻辑移至
createBuckleBoardFramePath内部处理
- 参数收集时保留原始值，fallback逻辑移至
[26.5.20] - 2026-05-26
修复
- 扣位高度/宽度参数标签修正：交换了UI标签与实际效果的对应关系
- "扣位高度"现在控制扣位凸出深度（原 buckleWidth）
- "扣位宽度"现在控制扣位横向宽度（原 buckleHeight）
- 扣位圆角半径为0时仍生成圆角的bug修复：使用
Number.isFinite()替代||避免0被误判为falsy
[26.5.19] - 2026-05-26
修复
- 扣位伸出方向修正：从向内改为真正向外（背离板框中心）
- 下扣位：Y减小（向下凸出）
- 上扣位：Y增大（向上凸出）
- 扣位圆角（ARC）角度修正：所有圆弧角度根据新的向外几何重新计算
- 进入圆角：板框边缘到扣位侧壁的过渡圆弧
- 外端圆角：扣位外端转角的内部圆弧（fillet）
- 收回圆角：扣位侧壁回到板框边缘的过渡圆弧
- 简化坐标模型：直接用边缘坐标（lbLeft/lbRight 等）替代中心点换算
- 切角路径修正：修复切角后的底部/顶部连线
[26.5.18] - 2026-05-25
修复
- 扣位切角位置修正：切角现在在扣位的外角（远离板框中心）
- 左下扣位：向下凸出，切角在左侧（外端左角，X更小处）
- 右下扣位：向下凸出，切角在右侧（外端右角，X更大处）
- 右上扣位：向上凸出，切角在右侧（外端右角，X更大处）
- 左上扣位：向上凸出，切角在左侧（外端左角，X更小处）
[26.5.17] - 2026-05-25
修复
- 扣位位置重构：从金手指位置改为板框四角
- 左下扣位：从下边缘左下角附近向下凸出
- 右下扣位：从下边缘右下角附近向下凸出
- 右上扣位：从上边缘右上角附近向上凸出
- 左上扣位：从上边缘左上角附近向上凸出
- 扣位伸出方向：向外凸出（背离板框中心）
- 上扣位：Y减小（向上）
- 下扣位：Y增大（向下）
- 切角位置：外端朝向板框中心的一侧
- 参数语义更新：
- buckleTopPos → buckleCornerOffset（扣位距离角落的偏移）
- buckleHeight → buckleDepth（扣位凸出深度）
- 函数签名简化：
createBuckleBoardFramePath移除padX1/padX2参数
[26.5.16] - 2026-05-25
修复
- 扣位几何结构重新实现：基于竖向金手指旋转90度的正确几何类比
- 扣位方向：向上/下伸出（Y方向），而非向左/右伸出
- 每个金手指有上下两个扣位，共4个扣位
- 切角位置：上扣位切角在右上角，下扣位切角在左上角
- 坐标命名优化：gf1_leftX/gf1_rightX, gf2_leftX/gf2_rightX
[26.5.15] - 2026-05-22
修复
- 扣位切角位置修正：切角现在在扣位外端且朝向金手指方向
- 左侧上扣：切角在左上角（外端的左侧） ✓
- 左侧下扣：切角在左下角（外端的左侧） - 从右上角修正
- 右侧上扣：切角在右上角（外端的右侧） - 从左上角修正
- 右侧下扣：切角在右下角（外端的右侧） ✓
[26.5.14] - 2026-05-22
修复
- 修复
createBoardFrame函数签名缺少padX1参数导致 "padX1 is not defined" 错误 - 函数内部调用
createBuckleBoardFramePath时正确传递padX1参数
[26.5.13] - 2026-05-22
修复
- 扣位双侧生成：左侧金手指（padX1）和右侧金手指（padX2）都生成扣位
- buckleTopPos 参数生效：扣位位置由 buckleTopPos 控制（距离中心的 Y 坐标），而非固定在板框边界
[26.5.12] - 2026-05-22
修复
- 扣位方向修正：从左右伸出改为上下伸出（适配横向排线布局）
- 扣位位置修正：靠近右侧金手指区域（padX2）
新增
- 扣位圆角参数
buckleCornerRadius（默认 0.2mm） - 扣位三角外凸圆角（左上角、左下角、右下角）
[26.5.11] - 2026-05-22
新增
- 扣位功能：板框两侧对称扣位伸出，支持参数化控制
- buckleTopPos: 扣位上端位置（从水平线 Y=0 向上的距离），默认 2.8mm
- buckleHeight: 扣位高度（Y 方向长度），默认 1.4mm
- buckleWidth: 扣位宽度（从金手指边缘伸出的长度），默认 0.8mm
- buckleChamfer: 扣位外角切角大小，默认 0.5mm
- 扣位自动融入板框轮廓路径（非独立图元）
[26.5.10] - 2026-05-16
修复
- 修正补强板 polygon 路径方向（逆时针→顺时针），圆角从内凹改为外凸
[26.5.9] - 2026-05-16
修复
- 修正补强板 polygon path 中 ARC 命令参数顺序（angle 应在 endX/endY 之前）
[26.5.8] - 2026-05-16
变更
- 补强板贴合板框一侧同步圆角，保持与板框紧密关联
[26.5.7] - 2026-05-15
修复
- 修正 R 矩形命令参数：y 改为左上角坐标（y2）、rotation 固定为 0，修复板框偏移和旋转问题
[26.5.6] - 2026-05-15
修复
- 板框圆角改用 R 矩形命令替代 ARC 命令，修复参数顺序导致的多边形无效错误
[26.5.5] - 2026-05-15
新增
- 板框圆角属性，默认 0.2mm（0 = 直角）
[26.5.4] - 2026-05-15
变更
- 插件更名为"FPC 速成引擎"（原"FPC 排线生成器"），统一全部文案
- 移除页面内 Toast 通知，改用编辑器原生通知
- 状态栏替换为可折叠运行日志面板（默认隐藏，点击底部"运行日志"条展开）
修复
- 清理冗余通知渠道，避免双重提示
[26.5.1] - 2026-05-12
修复
- 清理 src/index.ts 死代码（删除 generateFPC 及 5 个辅助函数）
- 删除未使用的 iframe/app.js 文件
- 移除未实现的"铺满"按钮
- 版本号统一为 26.5.1
[1.0.0] - 2026-05-11
新增
- 横向 / 竖向布局 FPC 排线生成
- 三种焊盘形状：矩形（RECT）、长圆（OVAL）、圆形（ELLIPSE）
- 参数化 UI 面板（焊盘数量、间距、阵列宽度、长度、宽度）
- 导线宽度可调
- 板框边距独立可调（焊盘侧 / 端边）
- FR4 补强板自动生成（Bottom Stiffener 层，layer=59）
- 补强板开关和延伸长度可调
- 生成后状态反馈（就绪 / 生成中 / 成功 / 错误）
- 输入参数前端验证
修复
- 补强板坐标计算错误（Bottom Stiffener 的 R 格式 y1 为左上角 Y 坐标，已修正）
备注
- 所有图元以画布原点为中心对称生成
- 适用于立创 EDA 专业版 >= 3.1.60 或 >= 3.2.69
暂无数据
类型
PCB
关键词
FPC排线柔性电路金手指补强板参数化
扩展信息
| 版本 | v26.10.1 |
| 发布者 | Ocean |
| 发布时间 | 2026-10-13 11:14:24 |
| 名称 | fpc-generator-v3 |
| UUID | a7f3e9c2d1b84056a9e7f3c2d1b84056 |
| 适用EDA版本: | >=3.2.69 |
| 报告 | 报告滥用 |
评论