关于 blender-python-integration
面向 Claude 的 Blender Python 技能，可通过脚本自动化 3D 场景、对象、材质与动画制作。适合希望以程序化方式搭建和迭代 Blender 场景、减少重复操作的用户。
主要功能
- 01生成 Blender Python 脚本
- 02程序化创建场景与对象
- 03自动化动画和关键帧
- 04设置材质、灯光与渲染
- 05增量验证场景
适用场景
- 01程序化生成科幻场景
- 02自动制作循环动画
- 03批量创建重复几何体
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/blender-python-integration确认已加载。
详细介绍
Blender Python 集成
概述
此技能可帮助 Claude 生成和优化 Blender Python 脚本，以便在 Blender 中自动化 3D 工作流。
该工作流侧重于：
- Blender Python 脚本编写
- 程序化场景生成
- 动画自动化
- 对象创建
- 材质自动化
- 场景设置
- 加速工作流
目标是让用户即使没有丰富的 Blender 使用经验，也能通过 AI 辅助脚本创建复杂的场景、动画和程序化系统。
Claude 无需用户通过 Blender UI 手动完成所有操作，而是可以生成可执行的 Blender Python 代码，以自动化重复性高或技术复杂的工作流。
设置
开始之前：
-
安装 Blender： https://www.blender.org
-
打开 Blender。
-
切换到 Scripting Workspace。
-
确保 Python Console 和 Text Editor 均可见。
-
在 Blender 中创建新脚本。
推荐工具：
- Blender
- VS Code（可选）
- Blender Python API 文档
- 参考图片或动画概念
可选：
- 用于脚本版本管理的 Git
- 用于资源库的插件
所需输入
- 场景构想或动画目标
- 对象要求
- 动画行为
- 材质或灯光要求
可选：
- 现有的 Blender 项目
- 参考渲染图
- 程序化生成目标
- Geometry Nodes 工作流
何时使用此技能
在以下情况下使用此技能：
- 自动化 Blender 工作流
- 生成程序化场景
- 以编程方式制作动画
- 创建重复几何体
- 编写对象生成脚本
- 加快复杂设置任务
- 无需丰富的手动操作经验即可创建 Blender 场景
何时不使用
请勿在以下情况下使用此技能：
- 纯手工雕刻工作流
- 手工打造的艺术细节
- 仅涉及 UI 操作的 Blender 教程
- 非 Blender 3D 软件管线
使用示例
完全通过 Python 脚本在 Blender 中创建程序化科幻动画。
Claude 应该：
- 生成 Blender Python 代码
- 以程序化方式创建对象
- 放置摄像机和灯光
- 为场景元素添加动画
- 自动应用材质
- 配置渲染设置
- 导出最终动画
最终结果应：
- 自动化重复性设置
- 保持可编辑
- 生成一致的结果
- 加快场景创建
- 显著减少 Blender 中的手动操作
Blender Python 核心原则
1. 自动化重复性工作
在自动化重复性高或技术复杂的工作流时，Blender 脚本最有价值。
最佳使用场景：
- 对象生成
- 场景设置
- 动画系统
- 摄像机放置
- 程序化复制
- 材质分配
自动化有助于提升：
- 速度
- 一致性
- 可扩展性
2. 正确使用 Blender 的 Python API
大多数工作流依赖于：
bpy- 场景上下文
- 对象操作
- 程序化逻辑
常见操作：
- 对象创建
- 网格修改
- 动画关键帧
- 材质设置
- 渲染配置
Claude 应生成：
- 整洁
- 易读
- 模块化
- 可编辑的脚本
3. 保持脚本模块化
大型 Blender 脚本应保持：
- 条理清晰
- 可复用
- 易于调试
推荐结构：
- 设置函数
- 对象生成器
- 动画系统
- 渲染配置代码块
避免：
- 巨型单体脚本
- 重复逻辑
- 硬编码场景值
4. 将脚本编写与程序化思维相结合
优秀的 Blender 脚本工作流通常结合：
- Python 自动化
- Geometry Nodes
- 程序化材质
- 可复用系统
Claude 应鼓励：
- 可扩展的场景生成
- 可编辑参数
- 程序化探索
5. 逐步验证场景
如果一次性生成过多系统，程序化 Blender 脚本可能很快出错。
Claude 应：
- 逐步构建场景
- 增量验证对象
- 尽早测试动画行为
- 持续检查渲染效果
渐进式工作流有助于提升：
- 调试效率
- 可靠性
- 迭代速度
工作流
1. 定义场景目标
首先确定：
- 应创建什么内容
- 动画要求
- 渲染风格
- 程序化行为
- 可复用系统
示例：
- 程序化城市
- 动画 Logo 揭示
- 科幻环境
- 循环动画
- 抽象动态图形
2. 生成场景结构
Claude 应生成以下代码：
- 清理场景
- 创建对象
- 创建集合
- 变换
- 设置摄像机
- 设置灯光
示例操作：
- 添加立方体
- 生成阵列
- 放置灯光
- 创建程序化布局
保持结构：
- 易读
- 模块化
- 可复用
3. 添加程序化逻辑
使用 Python 脚本来：
- 随机化对象
- 分布几何体
- 自动放置
- 生成变体
- 控制动画时序
程序化系统可提升：
- 可扩展性
- 实验空间
- 创作灵活性
4. 为场景元素添加动画
Claude 应生成：
- 关键帧
- 运动系统
- 循环动画
- 摄像机运动
- 程序化动画逻辑
验证：
- 时序
- 插值
- 渲染行为
- 动画流畅度
5. 应用材质和灯光
自动完成：
- 分配材质
- 设置着色器
- 放置灯光
- 配置渲染
良好的灯光能显著提升：
- 真实感
- 电影质感
- 渲染效果
6. 配置渲染
Claude 应配置：
- 渲染引擎
- 分辨率
- 帧范围
- 输出格式
- 采样设置
首选输出：
- MP4
- PNG 序列
- EXR（高级工作流）
7. 验证并导出
导出前验证：
- 对象层级
- 动画时序
- 材质表现
- 渲染质量
- 脚本稳定性
确保：
- 场景仍可编辑
- 脚本仍可复用
- 输出的渲染结果保持一致
输出要求
最终输出应包括：
- 可复用的 Blender Python 脚本
- 自动化场景生成
- 程序化动画系统
- 可用于生产的渲染设置
- 可扩展的 Blender 工作流
工作流本身应保持：
- 模块化
- 可编辑
- 可复用
- 便于自动化
- 可用于生产
执行策略（面向 AI Agent）
Agent 应：
- 将创作目标转化为 Blender 脚本
- 尽可能积极地自动化重复工作流
- 逐步构建场景
- 保持脚本模块化且可复用
- 持续验证程序化系统
- 优化可扩展性和迭代速度
工作流应优化：
- 自动化质量
- 程序化灵活性
- 渲染一致性
- 工作流加速
- 场景可扩展性
最佳实践
- 逐步构建场景
- 保持脚本模块化
- 尽可能使用程序化逻辑
- 尽早验证渲染结果
- 尽可能积极地自动化重复任务
- 保持生成的代码易读
- 将脚本与 Geometry Nodes 工作流结合
备注
- Blender 脚本可显著加速复杂工作流
- 程序化系统比手动重复操作更易扩展
- 增量验证可避免出现大量调试问题
- Python 自动化让非专家也能使用高级 Blender 工作流
- 将脚本与程序化生成结合，可创建高度可扩展的创作系统