Community画像github.com

pcb-render

将立创EDA(EasyEDA)专业版导出的PCB素材包渲染成照片级3D效果图(Blender Cycles):STEP 3D + DXF图形层 → 每个元件独立分色的PBR材质、蓝色阻焊+金色焊盘+白色丝印+铜箔走线,输出2K/4K主图、俯视图、微距。

pcb-render とは?

pcb-render是一个专门用于将立创EDA(EasyEDA)专业版导出的PCB素材包(.zip文件,内含*_3D.step、*_DXF.dxf、BOM、PickAndPlace)自动渲染成照片级3D效果图的AI智能体技能。它基于Blender Cycles渲染引擎,通过一套精心编排的脚本管线(位于scripts/目录)实现:解包 → STEP转GLB → DXF仅用于阻焊开窗/钻孔/板框 → AUDIT审计(覆盖率/连通块检查,失败则停止) → 材质映射(基于recon_footprints.py) → 渲染(支持2K/4K分辨率,主图/俯视图/微距视角)。核心设计原则是“STEP优先”,即铜层和丝印必须从STEP几何投影,禁止用DXF重绘这些层,因为DXF重绘会导致铜层隔离带填实(覆盖率97%)、丝印文字偏移(0.3-0.5mm)等严重问题。技能包含严格的审计铁律(audit_assets.py非零退出即停止)、单GPU队列防资源争抢、1:1裁切抽查等质量控制措施。支持Blender路径自动探测(环境变量、配置文件、常见安装位置),并提供详细的故障对照表处理常见问题。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/maker114/PCB-Render-Kit/tree/HEAD/skill/pcb-render

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

pcb-render は何をしますか?

把「立创EDA 专业版一键导出的素材包」变成成品效果图。整条链路的脚本都在 scripts/,本文件只做路由与纪律;细节按需读 references/。

触发条件

  • 用户给了 EDA 导出的 zip(内含 *_3D.step、*_DXF.dxf、BOM、PickAndPlace),要出图
  • 用户说「再渲一版」「换个角度」「来张微距」「放大到 4K」「上次那块板」
  • 用户在聊 PCB 渲染、板子 3D、产品图

铁律(每一条都是踩坑换来的,违反必翻车)

  1. STEP 优先,禁止用 DXF 重绘已存在的层。 STEP 里有 TopCopper / TopSilkscreen 等产品时,铜层和丝印必须从 STEP 几何投影(layers_from_step.py)。 DXF 只补 STEP 没有的层:阻焊开窗、钻孔、板框。
    • 反例 1:用 DXF 重绘铜层 → 铺铜的隔离带被填成实心(覆盖率 97%),走线全消失
    • 反例 2:用 DXF TEXT + 替代字体重绘丝印 → 字宽不一致,46 个字符偏移 0.30.5 mm
  2. 审计先行。 audit_assets.py 非 0 退出就停止,不许渲染。它查覆盖率/连通块,能抓住「实心填充」「空层」「单连通域」。
  3. 单 GPU 队列。 禁止同时跑两个 Blender OptiX 渲染(6 GB 显存互抢,实测 85 s → 696 s)。
  4. 不许覆盖。 验证图进 render/out/diag/,render/out/final/ 只写一次;重渲前确认目标分辨率。
  5. 交付前 1:1 抽查。 至少看 3 处 100% 裁切:焊盘、走线、丝印位号。缩略图不算验收。
  6. 每换一块板就补齐材质映射。 recon_footprints.py 打印封装 + 颜色,补进 materials.py 的 FOOTPRINT_MAP。

环境探测(每次开工先做)

脚本里不写死任何路径,scripts/env.py 负责探测(先跑 python scripts/env.py 看报告):

项怎么找
Blender--blender 参数 → config.json 的 blender → 环境变量 PCB_RENDER_BLENDER → PATH → 各系统常见安装位置(Windows 的 Program Files / Steam 库、macOS 的 /Applications、Linux 的 /usr/bin、snap、flatpak)
Python跑 pipeline.py 的那个解释器(sys.executable),所以用你自己装了依赖的 Python 启动即可
依赖python -m pip install -r requirements.txt(cascadio / ezdxf / numpy / Pillow)

找不到 Blender 时的覆盖方式,二选一:

# A. 命令行
python pipeline.py --blender "C:/Program Files/Blender Foundation/Blender 5.2/blender.exe" ...

# B. 配置文件(一次配好)
#   把 config.example.json 复制成 config.json,填 "blender": "<路径>"
#   也支持 %APPDATA%/pcb-render/config.json 或 ~/.config/pcb-render/config.json

缺依赖时 pipeline.py 会直接打印带解释器路径的安装命令,不会甩裸 traceback。

所有 Blender 调用都要带 --factory-startup。 否则会加载用户偏好(中文界面),新建节点被本地化成「背景」,studio.py 之类按名字取节点的地方会炸。本仓库的 studio.py 已改成按类型取节点,但仍建议加该参数(还能避开不兼容插件的报错)。

主流程

一条命令跑完(推荐,约 40 s 出 preview / 3–5 min 出 2K):

& $py "<skill>\scripts\pipeline.py" `
    --package "<素材包.zip>" `
    --workdir "<工作目录>" `
    --resolution preview        # preview | 2k | 4k
# 可选:--views hero,top,macro  --samples 160  --skip-render
#       --macro-target 0.010,-0.010,0.0016  --macro-distance 0.062

它依次做:解包 → STEP→GLB → DXF 只出 mask/drill(并写出 align.json)→ STEP 出 copper/silk → 审计门(不通过直接退出,不渲染) → 打印封装清单 → build_board → 渲染 3 张 → 转 8bit/jpg。 分步命令与每步产物见 references/pipeline.md。

跑完必做:

  1. 看图(render/out/final/)→ 构图/材质/走线是否正常
  2. 1:1 裁切抽查(Python 裁 3 处,逐张 Read 确认)
  3. 转 8-bit:16 位母版留 *_16bit.png,主文件名给 8-bit,另存 q95 jpg
  4. 写 README.md 到交付目录:输入包、板子型号、尺寸、每张图的内容/尺寸、审计数字、复现命令
  5. 用 present 交付 3 张 + README

构图与参数速查

板型主图俯视微距
宽板(100×65)16:9 3840x2160竖/横按板容2560x1600
方板(36×36)1:1 2048x2048(2K)/ 3840x3840(4K)1:12400x1680
长条4:5 或 16:9竖构图—

已验证的相机/灯光(不要每次重扫):

  • 3/4 主图:--framing three_quarter --azimuth -32 --elevation 38 --margin 0.0~0.02
  • 俯视:--framing top --azimuth 0 --elevation 84 --margin 0.05 --exposure -0.2
  • 微距:--framing three_quarter --target X,Y,0.0016 --lens 100 --distance 0.05~0.07 (必须用 --distance:studio 的 detail 取景距离偏大 2~3 倍)
  • 灯光一律 --light pcb_hero --floor black --exposure -0.8(俯视 -0.2)
  • 采样:2K 128~160、4K 200;降噪 OIDN

故障对照表

症状原因处理
走线看不见 / 板子一片纯蓝铜层用 DXF 重绘被填实跑 layers_from_step.py 重新用 STEP 投影
丝印文字偏移、越长的标签偏得越多DXF 用替代字体重绘同上,丝印也改用 STEP
KeyError: 'Background'/'背景'没加 --factory-startup,中文界面节点本地化加 --factory-startup
微距出来还是整板studio detail 自动距离偏大加 --distance 0.05~0.07
渲染突然变慢 5~10 倍两个 OptiX 渲染并发串行,一次只跑一个
模组丝印上下颠倒器件旋转 180°(设计如此)核对 PickAndPlace 的 Rotation,不是 bug
通孔/安装孔变成金圆盘金盘用「开窗」而不是「开窗∧铜」已实现 mask ∧ copper,检查铜层贴图是否为空
焊盘比器件引脚大一圈蒙版扩张(mask expansion)正常现象,实物也是开窗略大于焊盘
板子贴图整体错位align.json 的板框与 UV 不一致确认 build_board.py 读的是同一份 align.json

参考文件

什么时候读文件内容
要分步执行 / 搞不清每步产物references/pipeline.md命令、目录结构、每步输入输出、审计含义
出问题要对照前因后果references/pitfalls.md5 次事故的数据、根因、检测手段
新板子分色不对 / 要加封装references/materials.md调色板、FOOTPRINT_MAP 结构、补映射流程
调构图、灯光、微距目标点references/lighting-camera.mdstudio 预设、aspect 决策、微距坐标换算

安装(DSH 到底从哪扫)

DSH 由 skill-filesystem 插件按以下根目录发现 skill(rank 越小优先级越高):

范围路径rank
项目<项目根>/.dsh/skills100
项目<项目根>/.agents/skills200
自定义customSkillDirs 配置(cordis.patch.yml 里 skill-filesystem 的 config)300
用户%USERPROFILE%\.dsh\skills(Windows)/ ~/.dsh/skills(macOS、Linux)400
用户~/.agents/skills500

一个 skill = 一个目录 + SKILL.md。frontmatter 必须有 name(kebab-case,正则 ^[a-z0-9]+(?:-[a-z0-9]+)*$)和 description; 其余字段(compatibility / allowed-tools)会被忽略或收进 metadata,不会报错。 想禁止模型自动触发可加 disable-model-invocation: true。

# 本机:仓库通过「目录联接」挂到 DSH 技能目录 —— 改仓库立即生效,只有一份内容
cmd /c mklink /J "%USERPROFILE%\.dsh\skills\pcb-render" "<本仓库>\skill\pcb-render"

# 其他机器:普通复制即可
Copy-Item -Recurse -Force "<本仓库>\skill\pcb-render" "$env:USERPROFILE\.dsh\skills\pcb-render"

# 或直接用仓库脚本(默认 junction,-Copy 走复制)
powershell -File "<本仓库>\scripts\install-skill.ps1"

坑:DSH 安装目录下的 resources/runtime/office-skills/ 不是通用扫描目录 —— 它是 office 插件自己的 assetRoot,塞进去不会被发现(踩过,白折腾一轮)。 改完 skill 会自动热加载(provider 带 chokidar watcher),新会话必然可见。

関連スキル