SuperAPI AI 工具集

blender-python-api-verification

设计与创作

查看项目

更新于 10-16 07:24

技能介绍

用途:在编写或执行 Blender Python 修改操作前,先核实 Running Blender 实例中的真实 API 形态,适用于属性、枚举、运算符、动画 API 及插件接口的核验。

权威来源:可见的宿主 Blender 进程即为唯一事实来源。本安装还在 /sandbox/reference/blender-python-api-5.1 提供官方 Blender 5.1 Python API,可用 sandbox 终端配合 scripts/search_blender_api.py 检索官方文档;该文档仅覆盖 Blender 自身,不包含 OVRTX、OVPhysX 等插件。

必需流程:面对不确定的修改时,先在版本匹配的参考中检索类型或运算符;再单独发起一次非破坏性的 mcp_blender_execute_blender_code 调用,检查运行中的对象、RNA 属性、枚举项或运算符 RNA;逐一核对不确定的属性与枚举值,不得依据旧版 Blender 示例推断可用性;核验通过后再在第二次 Blender MCP 调用中执行修改。最后返回紧凑回执,不要把完整 RNA schema 倾倒到聊天中。

限制:不要在 sandbox Python 中 import bpy,Blender MCP 代码运行在宿主的 Blender 内,sandbox 代码不在此环境。修改前若发现 API 缺失、只读、枚举值不同或运算符 poll 失败,应立即停止并报告观察到的 Blender 版本与 API 形态,不要重试猜测的属性名,也不要执行混合探测与破坏性修改的长脚本。非 RNA 的 Python 对象可用窄范围过滤的 dir() 或 hasattr()。优先使用数据 API 而非依赖上下文的 bpy.ops;必须用运算符时先检查 poll() 并显式建立其上下文。