Community编程与开发github.com

blender-creation

从头开始,在无头 Blender (bpy, bmesh) 中创建物理校准、带铰接、PBR 纹理的 3D MuJoCo 资产 (MJCF model.xml, .mjz, mjSpec),包括凸碰撞合成、10 场景审核和 Studio 预览。仅在要求根据 URL、图像或文本描述创建、建模或构建 3D MuJoCo 对象,或明确指定使用 blender-creation 时使用。不用于非 MuJoCo 的 Blender/Cycles/CAD 建模。

blender-creation 是什么?

该技能使 AI 代理能够从零开始,仅根据自然语言提示、产品 URL 或参考图像,在无头 Blender(使用 bpy/bmesh)中创建完整的、物理准确的 MuJoCo 3D 资产。它处理完整的端到端管道:研究产品尺寸和机制、在 Blender 中对几何体进行建模和雕刻、应用 PBR 纹理(包括从参考图像和 AmbientCG 地图中采样颜色)、生成凸碰撞网格、构建完整的 MJCF 模型(包含关节和致动器),以及使用 MuJoCo 的 Filament PBR 渲染器以交互方式预览资产。该技能支持 MuJoCo(mjcf/mjz/mjSpec)和嵌入了 Filament 和 MuJoCo Studio 的 Blender,并可选地集成 subagent 编排以实现并行构建和审核,以及通过 MuJoCo Studio sidecar 进行实时 Web 预览。它会强制进行 10 场景动态物理审核以确保稳定性,并生成 360° 转盘展示视频。用户可以通过简单参数(如“Fast”跳过视频渲染或“Rigid-Only”创建单刚体)覆盖默认行为。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/google-deepmind/robotics-antigravity-plugin/tree/HEAD/plugins/robotics/skills/blender-creation

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

在 Blender 中从头创作 3D MuJoCo 资产 (bpy / bmesh + PBR)

[!IMPORTANT]

与 [rules/mujoco_asset_standards.md][asset-standards] 配合使用:首先阅读 [rules/mujoco_asset_standards.md][asset-standards] 以了解强制性的 MuJoCo 坐标系 (UP_POSZ_FORWARD_POSX_RIGHT_NEGY)、SI 单位规则、组分离 (group="2" 视觉, group="3" 碰撞, group="4" 位点) 以及物理/审核要求。本指南涵盖如何使用无头 Blender (PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P ...)、scripts/blender_mesh_utils.py (bmu)、scripts/asset_build_utils.py (abu)、mujoco-audit/SKILL.md、mujoco-showcase-shot/SKILL.md (render_showcase_shot.py) 和 mujoco-studio-sidecar/SKILL.md 来从头研究、测量、建模、雕刻、UV 展开、纹理化、烘焙、导出、验证和交互预览新资产,使其在 MuJoCo 的 Filament PBR 渲染器和 MuJoCo Studio 中看起来精确、行为准确且可精确检查。


1. 入口点、子代理编排、本地 Blender 设置与参考输入

1.0 调用、默认值与子代理编排

用户通过自然语言、产品 URL、参考图像或文本规范来调用此技能:

"为这把厨房夹子构建一个 3D MuJoCo 资产:<url>" "遵循 blender-creation 对 <image/link> 中的对象进行建模"

默认值与可选覆盖: 默认情况下,技能执行完整的端到端管道:自动检测铰接、中间诊断渲染、10 场景动态物理仿真审核 (§7.3) 和 360° Filament 转盘展示视频 (§7.4)。用户可以选择使用纯英文文本或要点请求覆盖:

  • Fast / No Turntable:跳过第 7.4 步的展示视频渲染(节省渲染时间)。
  • Rigid-Only:强制为 0 个关节,将对象创作为单一刚体。
  • Skip Physics Audit / Fast Audit:跳过第 7.3 步中的 10 场景动态物理仿真套件(仅依赖于第 7.1 步的静态清洁度和碰撞对齐检查)。
  1. 如果你是顶层/父对话:

    • 通过 invoke_subagent 生成一个 self 子代理 (Model: "inherit") 来构建和验证资产,传递所有用户指定的指令、URL 和覆盖、Parent Conversation ID: <parent_conv_id>、目标资产输出父目录,并指示子代理阅读此 blender-creation 技能、[rules/mujoco_asset_standards.md][asset-standards]、mujoco-audit/SKILL.md 和 mujoco-showcase-shot/SKILL.md。不要指示子代理在父对话的 brain/<parent_conv_id>/ 目录内编写暂存/输入文件(macOS Seatbelt 沙箱会使用 PermissionError 阻止跨对话的 brain/ 访问);让子代理使用其自己的 <ArtifactDir>/scratch/ 并返回完成的资产和预览路径。
    • 当子代理完成时:在顶层对话中遵循 第 7.6 步 (mujoco-studio-sidecar/SKILL.md) 来启动(或重用)指向已完成的资产目录 (--workspace_dir=<asset_dir>) 的 MuJoCo Studio Web sidecar 守护进程 (studiod.py) 并验证 /_studio/status ("ok": true, "daemon_connected": true)。从顶层对话启动 studiod.py 而不是在构建子代理内部,这样后台守护进程不会在子代理退出时被回收。在你的最终响应中,首先展示完成的资产路径、模型摘要(尺寸、质量、关节、视觉/碰撞分解、审核状态)、并排比较和转盘视频(除非通过 Fast (No Turntable) 跳过,简要地用一行说明该视频展示了完整的 360° 纹理视觉旋转,随后是半透明物理碰撞外壳检查),并且将 [MuJoCo Studio](sidecar://robotics/mujoco_studio/) (如果 Node sidecar 代理未激活,则加上来自 $SESSION_FILE 的 http://127.0.0.1:<http_port>/) 作为响应中最后一项放在底部,这样交互式 sidecar 按钮永远不会在顶部被错过。
  2. 如果你已经是生成的构建主子代理:

    • 不要生成嵌套的构建子代理——直接执行 第 1.1 节至第 7.5 节(如果在第 1.1 步中产品 URL 需要客户端 JS 渲染,你仍然可以调用只读的 browser 子代理)。将所有暂存/输入文件保留在此子代理自己的 <ArtifactDir>/scratch/ 中,以便沙箱化的 run_command 步骤具有本地读写访问权限,而不会出现 PermissionError。不要在子代理内部运行第 7.6 步 (studiod.py);而是将完成的 <asset_dir> 路径、模型摘要、比较图像和转盘视频路径返回给父对话,以便父对话启动 studiod.py 并呈现 Studio 链接。
    • 确保本地安装了 uv 和无头 Blender (4.2+) (macOS & Linux):
      uv --version
      if [ -x "/Applications/Blender.app/Contents/MacOS/Blender" ]; then
        BLENDER_BIN="/Applications/Blender.app/Contents/MacOS/Blender"
      else
        BLENDER_BIN="blender"
      fi
      "$BLENDER_BIN" --version || (sudo apt-get update && sudo apt-get install -y blender)
      
      使用 PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P <ArtifactDir>/scratch/build_asset.py 运行 Blender 脚本,并在 Blender 脚本内部将 <PLUGIN_DIR>/skills/blender-creation/scripts 添加到 sys.path 以 import blender_mesh_utils as bmu。
    • MuJoCo 编译、Filament 展示渲染与参考输入 (uv run):
      uv run --with mujoco --with numpy --with scipy --with trimesh --with Pillow \
        python3 <ArtifactDir>/scratch/script.py
      
      在你的暂存脚本内部,将插件脚本目录(<PLUGIN_DIR>/skills/blender-creation/scripts、<PLUGIN_DIR>/skills/mujoco-audit/scripts 和 <PLUGIN_DIR>/skills/mujoco-showcase-shot/scripts)添加到 sys.path 以导入 asset_build_utils as abu、audit_scenarios 和 render_showcase_shot。
    • 范围与工作目录卫生:
      • 默认运行 audit_scenarios 的 10 场景物理掉落/倾斜/抓取仿真(第 7.3 步),验证所有场景通过(或根据 mujoco-audit/SKILL.md 修复失败的检查)。仅当用户明确指定 Skip Physics Audit 或 Fast Audit 时才跳过动态仿真。除非被要求,否则不要生成第二个 <asset_name>_mechanical/ 包。验证干净的静态 MjModel 编译、零背面法线 (abu.render_blender_diagnostic_sheet)、碰撞对齐 (audit_scenarios.compute_collision_alignment_summary)、运动学关节位姿 (Articulations: Auto) 以及所有动态物理掉落/倾斜/稳定场景。
      • 将所有暂存脚本、下载的参考照片、中间网格、诊断 .jpg/.png 表、.blend 文件、虚拟环境 (.venv) 和缓存保留在 <ArtifactDir>/scratch/、~/.venvs/ 和 ~/.cache/mujoco_pbr_cache 中。仅将最终资产交付件(model.xml、meshes/*.obj、textures/*.png)写入目标资产目录,并且永远不要将 .pyc / __pycache__、.venv 或 studiod 脚手架/运行时文件写入资产目录。
    • 尊重旋钮覆盖:Articulations: Rigid-Only -> 0 个关节;Depth: Fast (No Turntable) -> 跳过第 7.4 步;Skip Physics Audit / Fast Audit -> 跳过第 7.3 步。

1.1 输入、参考联系/细节表与表单摘要

  1. 产品 URL 与参考输入 (<= 8 张图像读取):
    • 永远不要从 URL 路径段(例如,/Walnut-Elegant-Design-Coffee-Products/dp/... 可能是一个截断的 SEO 段而不是咖啡桌)猜测产品标识、类别或尺寸。
    • 当提供产品 URL 时:
      1. 调用只读的 browser 子代理来代表用户导航到 <product_url>。像人类设计师一样检查实时渲染的页面:
        • 提取已验证的产品标题、材料、机构描述和尺寸规格(以 mm 为单位的 长 × 宽 × 高 和以 kg 为单位的裸产品重量,交叉核对零售 Item Weight 与包装运输重量)。
        • 识别高分辨率产品图库/轮播图像 URL。
      2. 如果访问被交互式 CAPTCHA 或安全门阻止:停止,不要尝试绕过该门,直接要求用户提供产品尺寸、规格或参考照片。
      3. 将收集到的高分辨率图库图像下载到 <ArtifactDir>/scratch/intake/ref_*.jpg(例如,使用 curl 或一个最小的内联下载脚本)。
    • 当未提供 URL 时(纯文本查询):通过 search_web 查找裸产品 长 x 宽 x 高(mm)和重量(kg)(如果 search_web 仅返回没有摘要的裸重定向链接,则调用 browser 子代理)。交叉核对零售 Item Weight 与尺寸和材料密度。
    • 复合表(<= 8 张图像读取):永远不要对数十个单独帧调用 read_file。将通过 abu.build_ref_contact_and_detail_sheets 下载的 ref_*.jpg 照片和子特征裁剪拼接成 ref_contact_sheet 和 ref_details_grid,然后使用 read_file 检查这些复合表。
  2. 直接从参考裁剪中采样光度 RGB 百分位数 (rgb_sample_boxes):
    • 不要从口头类别名称("红色塑料"、"黑色橡胶"、"绿色长毛绒")杜撰 RGB 值。将 rgb_sample_boxes=[('main_shell', ref_path, (x0, y0, x1, y1)), ...] 传递给 abu.build_ref_contact_and_detail_sheets,以直接从均匀的内部表面斑块(排除镜面高光和投射阴影)测量 [p25, p50, p75] sRGB 元组。
  3. 编写一个 <= 25 行的表单摘要和命名参数块 P(<= 40 个命名尺寸):
    • 在编写 Blender bmesh 代码之前,编写一个简洁的表单摘要并定义一个命名参数字典 P = dict(...)(<= 40 个以 mm / m 和 deg 为单位的命名尺寸,带有出处注释),而不是对数百个魔数坐标元组进行硬编码:
      • 命名主要表面及其相交方式:侧面轮廓面/角度、平面视图锥度、顶部横截面、零件之间的负空间/开放间隙,以及齐平 vs. 阶梯式连接处。
      • 左/右(+Y 与 -Y)和前/后(+X 与 -X)不对称性:明确指出哪些杠杆、夹子、按钮、标签或端口出现在每侧。
      • 材料区域与分型线:例如,双射包覆成型,其中刚性 ABS 形成内核和外露的齐平边缘,而哑光 TPE 形成外部握柄表皮,或凹陷的品牌口袋。
      • 机构与行程:具有真实物理枢轴/轴和以 m 或 rad 为单位的行程的运动子部件(铰链盖、滑块、夹子、刀片、按钮、旋钮)。

2. 工具参考与目标渲染器规则

2.1 快速助手指令参考 (blender_mesh_utils、asset_build_utils、render_showcase_shot)

  • blender_mesh_utils as bmu (在无头 Blender "$BLENDER_BIN" -b -P 内部,来自 scripts/blender_mesh_utils.py):
    • bmu.clear_scene() -> None
    • bmu.assign_pbr_material(objects, name=None, *, base_color=None, base_color_srgb=(200, 200, 200), roughness=0.4, metallic=0.0, normal_bump_mm=0.0, bump_height_mm=0.0, bump_scale=250.0) -> bpy.types.Material
    • bmu.skin_skeleton(name, nodes_xyzr, edges=None, *, subsurf_levels=2) -> obj
    • bmu.metaball_sdf(name, elements, *, resolution=0.002) -> obj
    • bmu.swept_tube(name, points_xyzr, *, bevel_resolution=6) -> obj
    • bmu.voxel_smooth_union(name, objects, *, voxel_size=0.0015, smooth_iterations=6) -> obj
    • bmu.apply_boolean_cutter(target_obj, cutter_obj, *, operation='DIFFERENCE', solver='MANIFOLD') -> obj
    • bmu.smart_seam_unwrap(target_obj, *, angle_limit_deg=66.0, margin=0.005) -> obj
    • bmu.smart_uv_project(objects, *, angle_limit_deg=66.0, island_margin=0.01, margin=None) -> list[obj]
    • bmu.pack_shared_uv_atlas(objs, *, margin=0.005, rotate=True, align_minimal_bbox=True, match_3d_area=True) -> None
    • bmu.finalize_and_export_obj(target_obj, out_obj_path, *, crease_deg=None, world_pos=None, body_pos=None, ensure_uvs=True) -> {'verts', 'quads', 'tris', 'earclipped_ngons'}
    • bmu.export_convex_hull_col(source_obj_or_points, out_obj_path, *, clip_bounds_world_m=None, clip_bounds_m=None, max_verts=64, name=None, world_pos=(0,0,0), body_pos=None) -> col_obj
    • bmu.bake_pbr_maps(out_dir, *, material_groups=None, resolution=1024, samples=8) -> {key: {'basecolor', 'roughness', 'metallic', 'normal'}}
  • asset_build_utils as abu (在 uv run 脚本内部,来自 scripts/asset_build_utils.py):
    • abu.build_ref_contact_and_detail_sheets(ref_paths, detail_crops, out_contact_png, out_details_png, *, raw_crops_dir=None, rgb_sample_boxes=None, cols=3, cell_size=440, include_shadow_lift=False) -> dict
    • abu.fetch_ambientcg_maps(asset_id, *, cache_dir=None, resolution='1K') -> {'color', 'roughness', 'normal_gl', 'metallic', 'ao', 'opacity', ...}
    • abu.rasterize_uv_world_fields(obj_paths, canvas_size=1024, *, part_offsets=None) -> dict
    • abu.dilate_uv_gutters(arr, valid_mask, *, max_dist_px=12) -> np.ndarray
    • abu.triplanar_project_map(map_2d, xyz, world_normal, *, texels_per_meter=4000.0, sharpness=4.0) -> np.ndarray
    • abu.height_to_normal_rgb(height_map, strength=3.5, *, smooth_sigma=0.0, valid_mask=None) -> (H,W,3) uint8
    • abu.normal_rgb_from_3d_height_fn(height_fn, uv_world_fields, *, step_mm=0.15, strength=1.0) -> (H,W,3) uint8
    • abu.fbm_noise_3d(xyz, *, base_freq=25.0, wavelength_mm=None, octaves=4, per

…

[因翻译而截断]

相关技能