@deepblend/dsh-blender-preset 0.6.4 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepblend/dsh-blender-preset",
3
- "version": "0.6.4",
3
+ "version": "0.8.0",
4
4
  "type": "module",
5
5
  "description": "DeepBlend Agent-preset plane: ships the DeepBlend Studio agent presets and the deployer row that installs them into the DSH home.",
6
6
  "main": "lib/index.js",
@@ -6,4 +6,4 @@
6
6
  # is the more robust spelling: a declared number would tie with a future built-in that picks the same one, while
7
7
  # an absent one always follows the deployment's own. Measured by reading the sort, not assumed.
8
8
  name: DeepBlend Studio
9
- description: 用 DeepSeek-Flash 规划、检查并控制 Blender 产出 3D 动画的专用 Agent:只会看场景、改场景、渲预览、判读测量并交付视频,没有 Shell、没有任意文件写入、没有任意 Python。
9
+ description: 用 DeepSeek 通过少量参数创建和修整可编辑的 Blender 模型,检查真实预览、联动尺寸并保留版本;摄影、动画与导出服务于完整建模交付。
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: deepblend-studio
3
- description: Use when planning or producing a 3D animation with DeepBlend Studio — setting up a shot or product scene, importing models or visual references, changing a scene through SceneSpec patches, reviewing previews against the saved goal, running or resuming a final render, delivering a video, or restoring a previous revision.
3
+ description: Use when creating or refining editable Blender models with DeepBlend Studio — choosing an authored recipe, adjusting linked dimensions and assembly, importing models or references, repairing geometry through bounded SceneSpec edits, inspecting real previews, preserving revisions, arranging photography, or delivering native files, images and animation.
4
4
  ---
5
5
 
6
6
  # DeepBlend Studio
@@ -37,6 +37,42 @@ time (`RENDER_JOB_CONFLICT`).
37
37
 
38
38
  ## The order that works
39
39
 
40
+ ### Complete a declared recipe task with few operations
41
+
42
+ When a recipe covers the requested object and its declared parameter ranges,
43
+ use those controls directly. For a brief asking for an editable Blender file
44
+ and a preview, create with `saveCheckpoint: true` and `renderPreview: true` in
45
+ the same `blender_project_create` call. Keep the recipe identity and digest,
46
+ requested values, saved revision, checkpoint and preview receipts together.
47
+ Do not create the default object and then rebuild dimensions already covered
48
+ by its controls. Read the returned receipts before asking for the full scene.
49
+
50
+ Creation, dimensional saves and patches with preview enabled can include the
51
+ verified saved preview image in the same result. Inspect that image first; do
52
+ not render the same view again just to retrieve it. For a visible patch, request
53
+ checkpoint and preview together. When a result says its image was not attached,
54
+ the model has not seen those pixels; retain the saved artifact and report that
55
+ limit. Additional views still need to show the features required by the brief.
56
+
57
+ For a later dimensional change, read `blender_recipe_parameters`, then save
58
+ only the changed parameter IDs with the current base revision and preview
59
+ enabled. This preserves independent appearance, the original revision and
60
+ the declared attachment/framing links. If a controlled field conflicts, resolve
61
+ that actual conflict instead of silently replacing a hand-edited model.
62
+
63
+ A cup's body diameter excludes its handle. `cup-outer-diameter-mm` controls
64
+ twice the body radius; the whole object's bounding box includes the handle.
65
+ Declared wall thickness and sampled technical checks do not certify a global
66
+ minimum wall or manufacturing tolerance.
67
+
68
+ Inspect the saved preview needed for the brief; add a targeted view if it does
69
+ not show the requested features. Once the requested native file and preview
70
+ are saved, conclude with the project, revision and actual delivery paths.
71
+ Separate verified dimensions/topology from appearance observations. An
72
+ unavailable vision reviewer is a limitation to report, not a reason to repeat
73
+ unchanged renders or to claim artistic approval. Additional artistic review
74
+ and final rendering follow the user's delivery requirements.
75
+
40
76
  ### Establish the visual target before building
41
77
 
42
78
  Record the intended object, dimensions, audience, material identities and delivery
@@ -188,8 +224,10 @@ the current revision and repeat the affected views with the same settings.
188
224
  edit and no script. See "Revision discipline" below.
189
225
  6. **`blender_preview_render` / `blender_preview_views`** — look at it. `preview_views`
190
226
  renders several declared views in one Blender launch and returns contact sheet
191
- paths and measurements as text. It does not attach those images automatically;
192
- read the images before claiming to have seen them. Single-frame `preview_render`
227
+ paths and measurements, and attaches the verified saved contact sheet for image-capable models.
228
+ Inspect those pixels directly; a separate reviewer call is for independent judgement, not image access.
229
+ For a specific part, use `preview_render` with an explicit cameraId, frame and beauty/clay mode;
230
+ do not rename camera roles or reorder cameras to obtain a targeted view. Single-frame `preview_render`
193
231
  attaches an independent inspection when an explicit beauty/clay mode is set.
194
232
  7. **`blender_visual_review`** — ask for a measured judgement (see "Who decides what").
195
233
  8. **`blender_visual_autofix`** — iterate against the revision's saved goal and