@jojonadam/dsh-blender 0.1.0 → 0.1.1

package/README.md

@@ -58,7 +58,7 @@ node test/provider.test.mjs
 python3 skills/blender-studio/scripts/blender_client.py doctor
 ```
 
-实机验证：Blender 5.2.1 LTS · macOS · METAL，EEVEE 256×256 冒烟 3.5s；参数化地砖（9 块 + 选择性 Bevel + glTF）3.6s（2026-10-19）。
+实机验证：Blender 5.2.1 LTS · macOS · METAL，EEVEE 256×256 冒烟 3.5s；参数化地砖（9 块 + 选择性 Bevel + glTF）3.6s；Cycles 256×256 / 16 采样 CPU 1.3s、Metal 首次 4–5 分钟（kernel 编译，2026-10-19）。
 
 ## 品牌
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jojonadam/dsh-blender",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Blender production pack for DeepSeek Harness: headless bpy runner, render/export helpers, modeling cookbook, 5.x pitfalls and procedural asset pipeline. 本地建模 · 零依赖客户端 · 5.2 LTS 校准。",
   "type": "module",
   "main": "lib/index.js",

package/skills/blender-env/SKILL.md

@@ -40,6 +40,15 @@ license: MIT
 - 世界背景为纯黑且没有灯光时，默认立方体也会接近黑；
 - 先在 `smoke` 上验证，再怀疑场景。
 
+### Cycles 渲染特别慢（几分钟一张）
+
+- **现象**：EEVEE 几秒，Cycles 同分辨率要几分钟，CPU 占用却很低。
+- **原因**：macOS 的 Cycles Metal 后端每次启动都要编译 kernel；如果进程写不了 kernel 缓存，就会**每次重编译**。
+- **处置**：
+  - 迭代阶段用 EEVEE；
+  - 小场景/定稿可用 `--device CPU`（简单场景反而快）；
+  - 需要 GPU 时，让 Blender 在可写缓存的环境里跑，或接受首轮编译成本。
+
 ### 输出目录无权限
 
 - 错误形如 `Permission denied` / `Operation not permitted` 写 PNG；

package/skills/blender-studio/SKILL.md

@@ -51,18 +51,26 @@ python3 scripts/blender_client.py run \
 ## 4. 渲染已有工程 / 导出
 
 ```bash
-# 渲染单帧
+# EEVEE 单帧（快，适合迭代）
 python3 scripts/blender_client.py render \
   --blend outputs/blender/tiles/scene.blend \
   --out outputs/blender/tiles/final.png \
   --samples 64 --res 1024
 
+# Cycles 单帧（真实光影；macOS 用 --device METAL，小场景可先试 CPU）
+python3 scripts/blender_client.py render \
+  --blend outputs/blender/tiles/scene.blend \
+  --out outputs/blender/tiles/final_cycles.png \
+  --engine CYCLES --device METAL --samples 32 --res 512
+
 # 更复杂的导出（glTF / USD / FBX）直接在脚本里做，不要在命令行拼
 python3 scripts/blender_client.py run --script my_export.py --blend scene.blend
 ```
 
 输出统一放 `outputs/blender/<主题>/`，文件名带版本或日期；生成后用 `present` 把图片给用户看。
 
+> ⚠️ Cycles 在 macOS 上首次运行要编译 Metal kernel（可能几分钟）。如果进程写不了 kernel 缓存，每次都会重编译——迭代用 EEVEE，定稿再上 Cycles。
+
 ## 5. 领域路由
 
 | 用户问题 | 调用技能 |

package/skills/blender-studio/scripts/blender_client.py

@@ -166,10 +166,24 @@ scene.render.resolution_percentage = 100
 scene.render.image_settings.file_format = 'PNG'
 scene.render.filepath = {str(out)!r}
 scene.frame_set({int(args.frame)})
-try:
-    scene.eevee.taa_render_samples = {int(args.samples)}
-except Exception:
-    pass
+
+if {args.engine!r} == 'CYCLES':
+    try:
+        prefs = bpy.context.preferences.addons['cycles'].preferences
+        prefs.compute_device_type = {args.device!r}
+        prefs.get_devices()
+        for device in prefs.devices:
+            device.use = device.type != 'CPU'
+        scene.cycles.device = 'CPU' if {args.device!r} == 'CPU' else 'GPU'
+    except Exception as exc:
+        print('DSH_CYCLES_WARN', exc)
+    scene.cycles.samples = {int(args.samples)}
+else:
+    try:
+        scene.eevee.taa_render_samples = {int(args.samples)}
+    except Exception:
+        pass
+
 bpy.ops.render.render(write_still=True)
 print('DSH_RENDER_OK')
 """
@@ -225,6 +239,7 @@ def main() -> int:
     p_render.add_argument("--out", required=True)
     p_render.add_argument("--engine", default="BLENDER_EEVEE")
     p_render.add_argument("--samples", type=int, default=32)
+    p_render.add_argument("--device", default="METAL", help="Cycles 计算设备：METAL / CUDA / OPTIX / CPU")
     p_render.add_argument("--res", default="512")
     p_render.add_argument("--frame", type=int, default=1)
     p_render.add_argument("--timeout", type=float, default=900)