核心用法
Blender Skill 为命令行智能体提供了直接操控 Blender 的能力,其核心依赖 Flue —— 一个轻量级的本地 Shell-to-Application 桥接器。工作流程遵循极简的管道模型:智能体将 Python 代码写入 blender_bridge.py,Flue 将其传递给 Blender 内置的 bpy 运行时执行,并以结构化 JSON 返回结果。
典型应用场景
- 检查当前打开的场景、集合、对象层级
- 查询和修改网格数据、材质属性
- 读取和操作当前选择状态
- 执行小型 bpy 自动化脚本
前置要求
1. 必须阅读同目录下的 FLUE.md,了解桥接协议、安全约定和 bpy 示例
2. 若 Flue 已安装:补充阅读 C:\Users\fredd\.claude\skills\flue\SKILL.md 和 adapters/blender_adapter/APP.md
3. 若未安装:需用户明确授权后执行 pip install flue && flue setup
显著优点
- 零 MCP 依赖:相比传统 MCP 服务器方案,Flue 更轻量、协议更简单
- 原生 bpy 访问:直接操作 Blender 的 Python API,功能完整无阉割
- 统一多应用支持:同一 Flue 安装可覆盖 Photoshop、Illustrator、Premiere、After Effects、InDesign、Audition、Houdini、3ds Max、Unity 及 Microsoft Office
- MIT 开源可审计:代码托管于 GitHub/PyPI,使用前可完整审查
- 结构化输出:标准 JSON 响应,便于智能体解析和后续处理
潜在局限性与风险
- 本地安装依赖:需 Python 环境和 pip 权限,非零配置方案
- 桌面软件绑定:必须 Blender 已运行,无法操作 headless/远程实例
- 跨平台路径问题:文档示例使用 Windows 路径 (
C:\Users\fredd...),Linux/macOS 用户需手动适配 - 破坏性操作风险:bpy 可直接删除对象、修改场景结构,需用户显式授权
- 版本兼容性:Blender 的 bpy API 随版本变化,脚本可能需要维护更新
- 单会话限制:当前设计似乎绑定特定用户路径,多用户/多机器场景需额外配置
适合人群
- 技术美术 (TA):需要自动化重复性 Blender 操作
- 程序化内容创作者:通过 Python 批量生成或修改 3D 资产
- CLI 优先的开发者:偏好命令行工作流而非 Blender GUI
- 流水线工程师:将 Blender 集成到更广泛的自动化工作流中
安全建议
文档明确建议"将人类视为驾驶员"(treat the human as the driver),优先采用"小而可检查的步骤",避免未经请求的破坏性操作。这一设计哲学符合专业软件集成的最佳实践。