用途：为 Blender 5.x 提供 bpy 脚本与插件开发的专家指引，涵盖自定义操作符、UI 面板、插件（add-on）开发、上下文管理、handlers 与 timers、属性系统、批处理以及 Blender 数据模型访问。参考文件内含完整模板与数据模型层级。
主要能力：优先采用 MCP 优先方式，即使用官方 Blender MCP Server（Blender Lab，Blender 5.1+）在执行中的 Blender 会话里运行脚本、检查 datablock、直接修改场景状态；仅在 MCP 未连接时退化为输出 Python 脚本。会话开始时可通过工具名识别 MCP 是否可用，例如 execute_blender_code、get_objects_summary、search_api_docs。相关工具包括：execute_blender_code（在实时会话运行 bpy 代码）、get_objects_summary 与 get_object_detail_summary（先检查场景状态）、get_blendfile_summary_* 系列（清点文件）、search_api_docs / get_python_api_docs / search_manual_docs（确认 API 与操作符名称）、截图工具（验证视觉结果）、跳转工具（驱动 UI 使改动可见）、渲染缩略图工具（快速视觉反馈）。推荐工作流：先用 get_* / search_* 工具检查，再用 execute_blender_code 修改，最后用截图或摘要工具验证；代码块保持小而幂等，便于定位失败。
使用方式：按任务决策树选择参考文件，例如创建操作符或构建 UI 面板可查阅 references/python_api.md，批处理参考批处理模式，数据访问参考 references/data_model_reference.md。插件通常采用包含 init.py、operators.py、panels.py、properties.py 等的目录结构；单文件插件需定义 bl_info、操作符、面板及 register()/unregister()。命令行批处理示例：blender --background scene.blend --python my_script.py；自定义参数位于 -- 之后，可用 sys.argv[sys.argv.index("--") + 1:] 读取。
适用场景与限制：适合 Blender 5.x 插件开发、批处理渲染与对象处理、UI 定制与 API 调用。Blender 5.1 已升级到 Python 3.13，新增类型提示语法支持；部分旧操作符被移除，如 bpy.ops.anim.convert_legacy_action。背景模式下许多视口操作符会失败，应改用 bpy.data.* 直接数据 API；handlers 中运行 bpy.ops 需使用 temp_override 或避免使用；调用操作符前应检查上下文（active_object、mode 等），必要时调用 view_layer.update()。安装与配置细节见 docs/blender-mcp-setup.md。