用途 Blender Forge 是面向 Claude Code 的技能，用 Blender 的无头模式（blender -b --python）执行带版本管理的 bpy 脚本，稳定地生成和修改 3D 资产。它的核心理念是可验证的循环：每个脚本都会输出结果模型、JSON 报告和渲染预览，运行后阅读报告与接触表、修正问题、再次运行，而不是指望一次生成的代码就正确。
主要能力
- 器皿（vessel）：提供 cup、bowl、ladle、jar、libation-table 预设，也可用 --profile 自定义从足部到口沿的外壁轮廓；可在器壁上按 --band-z 位置、--depth 深度、--sign-height 高度和 --start 起始角雕刻文字，文字会随鼓腹和锥形壁面贴合。
- 泥板（tablet）：生成带圆角的板体，支持多行正面文字、背面文字、--rules 刻划线，--raw 按 --font 刻写任意字符。
- 文字系统：--signs、--line、--back-line 接受音节转写（如 KU-RO 65、JA-SA-SA-RA-ME），经可选的符号登记表按音值或 AB 编号解析；数字 1–9999 按 Linear A 方式绘制（个位竖线、十位横线、百位圆圈、千位带射线圆圈）。
- 扫描清理（clean）：输入 GLB/glTF、OBJ、PLY 或 STL，执行焊接分裂顶点、剔除松散碎片、补洞、统一法线、按目标三角面数简化，并报告每一步前后变化，不覆盖原始输入。
- 转台渲染（turntable）：将任意支持格式的网格归一化到单位包围球，适配相机保证全程所有顶点在画面内，用主光、补光、轮廓光照明，在 GPU 上以 Cycles 渲染透明背景帧，输出帧序列、4 个角度的接触表和 report.json。
- 视频编码与叠加（encode）：用 ffmpeg 输出 alpha WebM 与 ProRes，可把转台循环叠加到实拍视频上并复制其音轨。
- 可选集成：读取 linear-a-decipherment 技能的符号登记表；可用 recordly 的 X 检查脚本验证导出。
使用方式 脚本位于 ~/.claude/skills/blender-forge/scripts，用变量 B="blender -b --factory-startup --python-exit-code 1 --python" 调用。示例： $B $S/make_vessel.py -- --out out/cup.glb --preset cup --signs "JA-SA-SA-RA-ME" $B $S/make_tablet.py -- --out out/tab.glb --width 60 --height 90 --line "KU-RO 65" --line "PA-I-TO 12" --back-line "JA-SA-SA-RA-ME" --rules $B $S/clean_scan.py -- --in scan.ply --out scan-clean.glb --triangles 100000 $B $S/turntable.py -- --glb obj.glb --out out/turn --frames 360 --glow 3 python3 $S/encode_turntable.py out/turn --prores python3 $S/encode_turntable.py out/turn --over take.mp4 --height 0.6
适用场景 适合需要批量、可复现地生成考古风格器皿与泥板、在模型上刻写 Linear A 文字、清理摄影测量扫描、制作转台展示视频的 3D 内容工作流，也适合作为智能体操作 Blender 的可测试基础。
限制与注意事项 平台默认 macOS；Linux 可用但需通过 --font 指定 Noto Sans Linear A 字体，GPU 后端回退为 CUDA、OptiX、HIP 或 CPU。需要 Blender ≥ 5.1（测试于 5.2.3 LTS）、带 libvpx-vp9 和 prores_ks 的 ffmpeg。无符号登记表时仍可刻数字或通过 --text/--raw 刻写字面文本。脚本会对不合法的几何请求明确报错（如文字带放不下、壁厚过薄、切割穿透、线条超出边距等）。首次在 Metal 上渲染 Cycles 需编译内核约 90 秒，共享 GPU 的渲染会相互拖慢速度。许可受限的扫描数据应仅保存在本地，不得出现在公开发布的渲染、带遥测的 MCP 会话或外部生成服务中。项目采用 MIT 许可，Blender 本身为 GPL，脚本仅调用它。