Blender - Agents Help with 3D work

🧊 Shell 直连 Blender 的轻量桥

通过 Flue 桥接器在 Shell 中直接操控 Blender,无需 MCP 服务器即可执行 bpy Python 脚本与场景操作

收藏
9.7k
安装
2.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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.mdadapters/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),优先采用"小而可检查的步骤",避免未经请求的破坏性操作。这一设计哲学符合专业软件集成的最佳实践。

Blender - Agents Help with 3D work 内容

手动下载zip · 5.0 kB
FLUE.mdtext/markdown
请选择文件