@pioneer_zmc/dsh-workbench 0.2.1

package/web/assets/furniture/assets/ceramic-low-cabinet-01/model.js

@@ -0,0 +1,67 @@
+// 自制阅读休憩家具。米制、+Y向上、+Z正面，底面中心为原点。
+import * as THREE from 'three';
+
+// 圆角实体沿Z挤出，边缘真实倒角；归一到指定尺寸，顶面与包络不靠声明替身。
+function rounded(w, h, d, radius = 0.025) {
+  const r = Math.min(radius, w / 4, h / 4), x = -w / 2, y = -h / 2;
+  const shape = new THREE.Shape();
+  shape.moveTo(x + r, y); shape.lineTo(x + w - r, y);
+  shape.quadraticCurveTo(x + w, y, x + w, y + r);
+  shape.lineTo(x + w, y + h - r); shape.quadraticCurveTo(x + w, y + h, x + w - r, y + h);
+  shape.lineTo(x + r, y + h); shape.quadraticCurveTo(x, y + h, x, y + h - r);
+  shape.lineTo(x, y + r); shape.quadraticCurveTo(x, y, x + r, y);
+  const g = new THREE.ExtrudeGeometry(shape, { depth: d, steps: 1, curveSegments: 4,
+    bevelEnabled: true, bevelSegments: 2, bevelSize: Math.min(0.006, d / 5), bevelThickness: Math.min(0.006, d / 5) });
+  g.center(); g.computeBoundingBox();
+  const size = g.boundingBox.getSize(new THREE.Vector3());
+  g.scale(w / size.x, h / size.y, d / size.z); g.computeVertexNormals();
+  return g;
+}
+function woodTexture() {
+  const size = 128, data = new Uint8Array(size * size * 4); let seed = 20260930;
+  for (let v = 0; v < size; v++) for (let u = 0; u < size; u++) {
+    seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0;
+    const tone = 210 + 4 * Math.sin(v * 0.6 + Math.sin(u * 0.04)) + (seed / 4294967296 - 0.5) * 2;
+    const i = (v * size + u) * 4; data[i] = tone; data[i + 1] = tone - 26; data[i + 2] = tone - 61; data[i + 3] = 255;
+  }
+  const texture = new THREE.DataTexture(data, size, size, THREE.RGBAFormat);
+  texture.colorSpace = THREE.SRGBColorSpace; texture.wrapS = texture.wrapT = THREE.RepeatWrapping;
+  texture.magFilter = THREE.LinearFilter; texture.needsUpdate = true; return texture;
+}
+
+export function createCeramicLowCabinet() {
+  const group = new THREE.Group(); group.name = 'ceramic-low-cabinet-01';
+  const owned = new Set(), keep = value => { owned.add(value); return value; }; let disposed = false;
+  const dispose = () => {
+    if (disposed) return; disposed = true; group.removeFromParent();
+    for (const resource of owned) resource.dispose(); owned.clear(); group.clear();
+  };
+  try {
+    const material = options => keep(new THREE.MeshStandardMaterial(options));
+    const wood = material({ map: keep(woodTexture()), roughness: 0.7 });
+    const glaze = material({ color: '#eee9dd', roughness: 0.43 });
+    const brass = material({ color: '#b69557', metalness: 0.72, roughness: 0.38 });
+    const add = (g, m, x, y, z, name) => {
+      const mesh = new THREE.Mesh(keep(g), m); mesh.name = name; mesh.position.set(x, y, z);
+      mesh.castShadow = mesh.receiveShadow = true; group.add(mesh); return mesh;
+    };
+    const box = (w, h, d, m, x, y, z, name) => add(new THREE.BoxGeometry(w, h, d), m, x, y, z, name);
+    const soft = (w, h, d, m, x, y, z, name, radius) => add(rounded(w, h, d, radius), m, x, y, z, name);
+    for (const x of [-0.44, 0.44]) for (const z of [-0.18, 0.18])
+      soft(0.075, 0.14, 0.075, wood, x, 0.07, z, '矮柜短脚');
+    for (const x of [-0.52, 0.52]) box(0.045, 0.65, 0.50, glaze, x, 0.455, 0, '完整柜侧板');
+    box(1.04, 0.05, 0.50, glaze, 0, 0.15, 0, '完整柜底板');
+    box(1.04, 0.64, 0.035, glaze, 0, 0.46, -0.2325, '完整柜背板');
+    box(0.03, 0.64, 0.46, glaze, 0, 0.46, 0, '柜内中撑');
+    for (const x of [-0.252, 0.252]) {
+      soft(0.494, 0.61, 0.035, glaze, x, 0.465, 0.235, '关闭柜门', 0.015);
+      const k = x < 0 ? -0.055 : 0.055;
+      const post = add(new THREE.CylinderGeometry(0.008, 0.008, 0.017, 12), brass, k, 0.52, 0.259, '把手连接座');
+      post.rotation.x = Math.PI / 2;
+      add(new THREE.SphereGeometry(0.011, 12, 8), brass, k, 0.52, 0.267, '黄铜门把手');
+    }
+    // 顶板用完整实体盒确保冻结rect九点都处于真正水平最高面。
+    box(1.10, 0.07, 0.56, wood, 0, 0.815, 0, '平整浅木厚顶板');
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/ceramic-vase-01/asset.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "ceramic-vase-01",
+  "name": "暖釉细颈花瓶",
+  "category": "vase",
+  "description": "暖白象牙釉面细颈花瓶：圆润瓶腹向下收出稳固底足，向上经溜肩收到短细颈，瓶口微微外翻成真实口沿；瓶身有外壁与内壁的真实壁厚，顶部中央是开口，内壁下行接封闭的内瓶底，是空瓶、不插花。宽深各 0.16 米、高 0.30 米，本地 +Z 正面为无文字的釉面，仅有轻微釉色变化。仅作陈列摆件，无任何资料动作；仅可依附接受 vase 类别的承载面（如陶瓷展示台台面），当前书桌桌面只接受台灯类别，不能因为“桌面摆件”的称呼承诺能放上书桌。",
+  "styleIds": ["ceramic"],
+  "modelRef": "ceramic-vase-01",
+  "previewRef": "assets/ceramic-vase-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.08, "maxX": 0.08, "minY": 0, "maxY": 0.3, "minZ": -0.08, "maxZ": 0.08 },
+  "placement": { "allowedKinds": ["surface"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [],
+  "approachPoint": null,
+  "surfaces": [],
+  "capabilities": [],
+  "recommendations": { "note": "推荐写实项目展示区，与暖釉陶瓷展示台同系列搭配；也可混搭童话阅读房等其他风格。风格只是软推荐，不构成摆放准入；能否放置始终以承载面的类别与空间校验为准。" },
+  "source": { "origin": "自制", "license": "MIT", "note": "本包 model.js 自制 Three.js 程序化模型与固定种子 DataTexture 釉面粗糙度纹理，无外部模型或贴图。" }
+}

package/web/assets/furniture/assets/ceramic-vase-01/model.js

@@ -0,0 +1,119 @@
+// 暖釉细颈花瓶：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面；底面中心原点。冻结包络 X、Z 各 ±0.08、Y[0,0.30]。
+// 设计常数（检查按此独立手算）：外壳 lathe 剖面外底近轴 (0.001,0)→底足缘 (0.053,0.006)
+// →足上收腰 (0.046,0.022)→瓶腹最宽 (0.074,0.105)→肩 (0.049,0.212)→颈 (0.0265,0.262)
+// →外翻口沿 (0.041,0.294)→口沿顶外缘 (0.041,0.299)；口沿顶环外 0.041／内 0.033 @Y0.299；
+// 内壁剖面自口内缘 (0.033,0.299) 下行至内底缘 (0.045,0.030)；内底圆盘 r0.045 @Y0.030。
+// 腹部壁厚 0.074−0.066=0.008；底部实心厚 0.030。空瓶不插花，顶部中央为真实开口。
+import * as THREE from 'three';
+
+// 釉面粗糙度微变：NoColorSpace 数据纹理，数值接近 255，只轻微扰动基础粗糙度。
+function glazeRoughness() {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  let seed = 20260951;
+  const random = () => { seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0; return seed / 4294967296; };
+  for (let v = 0; v < size; v++) for (let u = 0; u < size; u++) {
+    const wave = 240 + 3 * Math.sin((u + 1.5 * Math.sin(v * 0.04)) * 0.05) + 2 * Math.sin(v * 0.021) + (random() - 0.5) * 2;
+    const i = (v * size + u) * 4;
+    data[i] = data[i + 1] = data[i + 2] = Math.max(0, Math.min(255, Math.round(wave)));
+    data[i + 3] = 255;
+  }
+  const texture = new THREE.DataTexture(data, size, size, THREE.RGBAFormat);
+  texture.colorSpace = THREE.NoColorSpace;
+  texture.wrapS = texture.wrapT = THREE.RepeatWrapping;
+  texture.magFilter = THREE.LinearFilter;
+  texture.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.generateMipmaps = true;
+  texture.needsUpdate = true;
+  return texture;
+}
+
+// 椭圆扁平环（口沿顶面）：外缘到内缘的真实窄环，法线朝上。
+function annulus(y, rOuter, rInner, segments) {
+  const positions = [], indices = [];
+  const ringOf = (r) => { const ids = []; for (let i = 0; i < segments; i++) {
+    const t = i / segments * Math.PI * 2;
+    const id = positions.length / 3;
+    positions.push(r * Math.cos(t), y, r * Math.sin(t));
+    ids.push(id);
+  } return ids; };
+  const outer = ringOf(rOuter), inner = ringOf(rInner);
+  for (let i = 0; i < segments; i++) {
+    const j = (i + 1) % segments;
+    indices.push(outer[i], inner[i], outer[j], inner[i], inner[j], outer[j]);
+  }
+  const geometry = new THREE.BufferGeometry();
+  geometry.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
+  geometry.setIndex(indices);
+  geometry.computeVertexNormals();
+  return geometry;
+}
+
+// 圆盘（内瓶底）：真实封底，法线朝上（腔内可见）。
+function disc(y, r, segments) {
+  const positions = [], indices = [];
+  const center = positions.length / 3;
+  positions.push(0, y, 0);
+  const ring = [];
+  for (let i = 0; i < segments; i++) {
+    const t = i / segments * Math.PI * 2;
+    const id = positions.length / 3;
+    positions.push(r * Math.cos(t), y, r * Math.sin(t));
+    ring.push(id);
+  }
+  for (let i = 0; i < segments; i++) {
+    const j = (i + 1) % segments;
+    indices.push(center, ring[j], ring[i]);
+  }
+  const geometry = new THREE.BufferGeometry();
+  geometry.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
+  geometry.setIndex(indices);
+  geometry.computeVertexNormals();
+  return geometry;
+}
+
+export function createCeramicVase() {
+  const group = new THREE.Group();
+  group.name = 'ceramic-vase-01';
+  const owned = new Set();
+  const keep = (resource) => { owned.add(resource); return resource; };
+  let disposed = false;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    group.removeFromParent();
+    for (const resource of owned) resource.dispose();
+    owned.clear(); group.clear();
+  };
+  try {
+    const rough = keep(glazeRoughness());
+    const glaze = keep(new THREE.MeshPhysicalMaterial({ color: '#e8e2d3', roughness: 0.16, roughnessMap: rough, clearcoat: 0.6, clearcoatRoughness: 0.25 }));
+    const innerGlaze = keep(new THREE.MeshStandardMaterial({ color: '#cfc8b8', roughness: 0.55 }));
+    const add = (geometry, material, name) => {
+      const mesh = new THREE.Mesh(keep(geometry), material);
+      mesh.name = name; mesh.castShadow = mesh.receiveShadow = true;
+      group.add(mesh); return mesh;
+    };
+    // 瓶身外壳：真实旋转曲面，含外底封底、底足、收腰、瓶腹、肩、细颈与外翻口沿；
+    // 剖面自下而上，法线朝外，顶部止于口沿顶外缘。
+    add(new THREE.LatheGeometry([
+      new THREE.Vector2(0.001, 0), new THREE.Vector2(0.045, 0), new THREE.Vector2(0.053, 0.006),
+      new THREE.Vector2(0.053, 0.016), new THREE.Vector2(0.046, 0.022), new THREE.Vector2(0.064, 0.055),
+      new THREE.Vector2(0.074, 0.105), new THREE.Vector2(0.071, 0.160), new THREE.Vector2(0.049, 0.212),
+      new THREE.Vector2(0.030, 0.238), new THREE.Vector2(0.0265, 0.262), new THREE.Vector2(0.029, 0.278),
+      new THREE.Vector2(0.041, 0.294), new THREE.Vector2(0.041, 0.299),
+    ], 36), glaze, '瓶身外壳');
+    // 口沿顶面：外缘 0.041 到内缘 0.033 的真实窄环，顶部中央由此保持开口。
+    add(annulus(0.299, 0.041, 0.033, 36), glaze, '瓶口沿面');
+    // 瓶内壁：自口沿内缘下行到内底缘的旋转曲面，法线朝腔内；与外壳之间是真实壁厚。
+    add(new THREE.LatheGeometry([
+      new THREE.Vector2(0.033, 0.299), new THREE.Vector2(0.031, 0.288), new THREE.Vector2(0.023, 0.262),
+      new THREE.Vector2(0.027, 0.238), new THREE.Vector2(0.041, 0.212), new THREE.Vector2(0.063, 0.155),
+      new THREE.Vector2(0.066, 0.105), new THREE.Vector2(0.062, 0.055), new THREE.Vector2(0.045, 0.030),
+    ], 36), innerGlaze, '瓶内壁');
+    // 内瓶底：封闭的瓶内底面，空瓶有底。
+    add(disc(0.030, 0.045, 36), innerGlaze, '瓶内底');
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-bed-01/asset.json

@@ -0,0 +1,61 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-bed-01",
+  "name": "林间蜂蜜木床",
+  "category": "bed",
+  "description": "蜂蜜木圆润床头与较低床尾，四脚支承床框及承托板，奶油厚床垫、双枕与低饱和青绿折被。宽1.50、深2.20、高不超过1.10米；+Z为床尾，接近位在床尾。仅地面静态休憩家具，无坐卧动作，不提供承载面。",
+  "styleIds": [
+    "fairy"
+  ],
+  "modelRef": "fairy-bed-01",
+  "previewRef": "assets/fairy-bed-01/preview.webp",
+  "placeholder": false,
+  "bounds": {
+    "minX": -0.75,
+    "maxX": 0.75,
+    "minY": 0,
+    "maxY": 1.1,
+    "minZ": -1.1,
+    "maxZ": 1.1
+  },
+  "placement": {
+    "allowedKinds": [
+      "floor"
+    ],
+    "allowedYawDeg": [
+      0,
+      90,
+      180,
+      270
+    ]
+  },
+  "clearanceBoxes": [
+    {
+      "name": "正面接近操作区",
+      "bounds": {
+        "minX": -0.8,
+        "maxX": 0.8,
+        "minY": 0,
+        "maxY": 1.9,
+        "minZ": 1.1,
+        "maxZ": 2.1
+      }
+    }
+  ],
+  "approachPoint": {
+    "x": 0,
+    "z": 1.65
+  },
+  "surfaces": [],
+  "capabilities": [],
+  "recommendations": {
+    "note": "适合温暖阅读休憩房，与蜂蜜木书桌、书架、奶油布料及暖白陶瓷搭配；风格只是软推荐，混搭允许，摆放以空间和类别校验为准。"
+  },
+  "source": {
+    "origin": "自制",
+    "license": "MIT",
+    "note": "自制Three.js程序化实体几何，无外部模型或贴图；有木面者使用固定种子DataTexture。"
+  }
+}

package/web/assets/furniture/assets/fairy-bed-01/model.js

@@ -0,0 +1,63 @@
+// 自制阅读休憩家具。米制、+Y向上、+Z正面，底面中心为原点。
+import * as THREE from 'three';
+
+// 圆角实体沿Z挤出，边缘真实倒角；归一到指定尺寸，顶面与包络不靠声明替身。
+function rounded(w, h, d, radius = 0.025) {
+  const r = Math.min(radius, w / 4, h / 4), x = -w / 2, y = -h / 2;
+  const shape = new THREE.Shape();
+  shape.moveTo(x + r, y); shape.lineTo(x + w - r, y);
+  shape.quadraticCurveTo(x + w, y, x + w, y + r);
+  shape.lineTo(x + w, y + h - r); shape.quadraticCurveTo(x + w, y + h, x + w - r, y + h);
+  shape.lineTo(x + r, y + h); shape.quadraticCurveTo(x, y + h, x, y + h - r);
+  shape.lineTo(x, y + r); shape.quadraticCurveTo(x, y, x + r, y);
+  const g = new THREE.ExtrudeGeometry(shape, { depth: d, steps: 1, curveSegments: 4,
+    bevelEnabled: true, bevelSegments: 2, bevelSize: Math.min(0.006, d / 5), bevelThickness: Math.min(0.006, d / 5) });
+  g.center(); g.computeBoundingBox();
+  const size = g.boundingBox.getSize(new THREE.Vector3());
+  g.scale(w / size.x, h / size.y, d / size.z); g.computeVertexNormals();
+  return g;
+}
+function woodTexture() {
+  const size = 128, data = new Uint8Array(size * size * 4); let seed = 20260930;
+  for (let v = 0; v < size; v++) for (let u = 0; u < size; u++) {
+    seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0;
+    const tone = 210 + 4 * Math.sin(v * 0.6 + Math.sin(u * 0.04)) + (seed / 4294967296 - 0.5) * 2;
+    const i = (v * size + u) * 4; data[i] = tone; data[i + 1] = tone - 26; data[i + 2] = tone - 61; data[i + 3] = 255;
+  }
+  const texture = new THREE.DataTexture(data, size, size, THREE.RGBAFormat);
+  texture.colorSpace = THREE.SRGBColorSpace; texture.wrapS = texture.wrapT = THREE.RepeatWrapping;
+  texture.magFilter = THREE.LinearFilter; texture.needsUpdate = true; return texture;
+}
+
+export function createFairyBed() {
+  const group = new THREE.Group(); group.name = 'fairy-bed-01';
+  const owned = new Set(), keep = value => { owned.add(value); return value; }; let disposed = false;
+  const dispose = () => {
+    if (disposed) return; disposed = true; group.removeFromParent();
+    for (const resource of owned) resource.dispose(); owned.clear(); group.clear();
+  };
+  try {
+    const material = options => keep(new THREE.MeshStandardMaterial(options));
+    const wood = material({ map: keep(woodTexture()), roughness: 0.7 });
+    const cream = material({ color: '#eee4cf', roughness: 0.92 });
+    const green = material({ color: '#86a69d', roughness: 0.94 });
+    const add = (g, m, x, y, z, name) => {
+      const mesh = new THREE.Mesh(keep(g), m); mesh.name = name; mesh.position.set(x, y, z);
+      mesh.castShadow = mesh.receiveShadow = true; group.add(mesh); return mesh;
+    };
+    const box = (w, h, d, m, x, y, z, name) => add(new THREE.BoxGeometry(w, h, d), m, x, y, z, name);
+    const soft = (w, h, d, m, x, y, z, name, radius) => add(rounded(w, h, d, radius), m, x, y, z, name);
+    for (const x of [-0.66, 0.66]) for (const z of [-0.95, 0.95])
+      soft(0.11, 0.38, 0.11, wood, x, 0.19, z, '落地床脚');
+    for (const x of [-0.69, 0.69]) soft(0.10, 0.18, 2.12, wood, x, 0.38, 0, '侧床框');
+    for (const z of [-1.02, 1.02]) soft(1.46, 0.18, 0.10, wood, 0, 0.38, z, '端床框');
+    box(1.34, 0.04, 2.02, wood, 0, 0.43, 0, '床垫承托板');
+    soft(1.48, 0.76, 0.09, wood, 0, 0.72, -1.05, '圆润床头板', 0.12);
+    soft(1.48, 0.29, 0.09, wood, 0, 0.485, 1.05, '低床尾板', 0.06);
+    soft(1.34, 0.18, 1.98, cream, 0, 0.54, 0, '奶油厚床垫', 0.055);
+    for (const x of [-0.34, 0.34]) soft(0.54, 0.12, 0.35, cream, x, 0.685, -0.69, '厚枕头', 0.06);
+    soft(1.30, 0.07, 0.96, green, 0, 0.665, 0.40, '青绿折被', 0.045);
+    soft(1.27, 0.022, 0.13, green, 0, 0.708, -0.01, '折被厚折边', 0.01);
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-book-stack-01/asset.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-book-stack-01",
+  "name": "林间双册书摆",
+  "category": "ornament",
+  "description": "童话风双册精装书摆件：下册蜂蜜棕平放，上册低饱和青绿在其上轻微错开并小角度斜叠；两册各有完整的硬封面顶板、封底板、书脊板与三面内缩的书页层，书脊上缀两条细凸饰线，封面无文字。宽 0.22 米、深 0.14 米、叠高 0.075 米，本地 +Z 正面为书页侧面。是一个整体装饰摆件，不是可点击的业务文档，无任何资料动作，也不提供承载面、不允许把新物品继续放到书上；仅可依附接受 ornament 类别的承载面（如陶瓷展示台台面），当前书桌桌面只接受台灯类别，不能因为“桌面摆件”的称呼承诺能放上书桌。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-book-stack-01",
+  "previewRef": "assets/fairy-book-stack-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.11, "maxX": 0.11, "minY": 0, "maxY": 0.075, "minZ": -0.07, "maxZ": 0.07 },
+  "placement": { "allowedKinds": ["surface"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [],
+  "approachPoint": null,
+  "surfaces": [],
+  "capabilities": [],
+  "recommendations": { "note": "推荐童话阅读房、书桌旁与展示台，与林间蜂蜜木书架、书桌同系列搭配；也可混搭写实房间。风格只是软推荐，不构成摆放准入；能否放置始终以承载面的类别与空间校验为准。" },
+  "source": { "origin": "自制", "license": "MIT", "note": "本包 model.js 自制 Three.js 程序化模型，无纹理、无外部模型或贴图。" }
+}

package/web/assets/furniture/assets/fairy-book-stack-01/model.js

@@ -0,0 +1,71 @@
+// 林间双册书摆：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面；底面中心原点。冻结包络 X ±0.11、Y[0,0.075]、Z ±0.07。
+// 设计常数（检查按此独立手算）：下册 0.208×0.041×0.132（蜂蜜棕），中心 (0,0.0205,0)，
+// 封面顶/封底厚 0.005、书脊宽 0.014 居 X[−0.104,−0.090]、页块 0.188×0.030×0.120 内缩
+// 且右缘 0.098<封面 0.104；上册 0.176×0.032×0.106（低饱和青绿），子组中心
+// (0.012,0.057,−0.002) 绕 Y 转 7°，底面与下册顶面相接（Y0.041）不悬空；上册同构四件。
+// 书脊饰线各两条（0.0016×0.0016×页深−0.07），凸出书脊外缘 0.0008，不生成文字贴图。
+// 整体一件摆件，无承载面，不允许把新物品继续挂到书上。
+import * as THREE from 'three';
+
+// 一册合上的精装书：封面顶板、封底板、书脊板与内缩页块，四件都有真实厚度；
+// 以册中心为原点，书脊居 X− 侧，页块贴书脊内缘、右侧与前后内缩。
+function addBook(parent, keep, size, materials, prefix) {
+  const [width, height, depth] = size;
+  const { cover, pages, trim } = materials;
+  const add = (geometry, material, name, x, y, z) => {
+    const mesh = new THREE.Mesh(geometry, material);
+    mesh.name = name; mesh.position.set(x, y, z);
+    mesh.castShadow = mesh.receiveShadow = true;
+    parent.add(mesh); return mesh;
+  };
+  const board = 0.005; // 硬封面厚度
+  const spine = 0.014; // 书脊板宽
+  const pageInset = 0.006; // 页块右侧与前后内缩
+  const pageWidth = width - spine - pageInset;
+  const pageHeight = height - board * 2 - 0.001; // 与封面顶底各留 0.0005，不共面
+  add(keep(new THREE.BoxGeometry(width, board, depth)), cover, `${prefix}封面顶`, 0, height / 2 - board / 2, 0);
+  add(keep(new THREE.BoxGeometry(width, board, depth)), cover, `${prefix}封底`, 0, -height / 2 + board / 2, 0);
+  add(keep(new THREE.BoxGeometry(spine, pageHeight + board * 2, depth)), cover, `${prefix}书脊`, -width / 2 + spine / 2, 0, 0);
+  add(keep(new THREE.BoxGeometry(pageWidth, pageHeight, depth - pageInset * 2)), pages, `${prefix}书页`, (spine - pageInset) / 2, 0, 0);
+  // 书脊饰线：两条细凸线，比书深短 0.07，沿书脊长度方向错开且不出封面。
+  for (const [index, offset] of [-0.03, 0.03].entries()) {
+    add(keep(new THREE.BoxGeometry(0.0016, 0.0016, depth - 0.07)), trim, `${prefix}书脊饰线${index + 1}`,
+      -width / 2 - 0.0008, (index === 0 ? 0.008 : -0.008), offset);
+  }
+}
+
+export function createFairyBookStack() {
+  const group = new THREE.Group();
+  group.name = 'fairy-book-stack-01';
+  const owned = new Set();
+  const keep = (resource) => { owned.add(resource); return resource; };
+  let disposed = false;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    group.removeFromParent();
+    for (const resource of owned) resource.dispose();
+    owned.clear(); group.clear();
+  };
+  try {
+    const honeyCover = keep(new THREE.MeshPhysicalMaterial({ color: '#a8793f', roughness: 0.52, clearcoat: 0.3, clearcoatRoughness: 0.4 }));
+    const sageCover = keep(new THREE.MeshPhysicalMaterial({ color: '#6f8d7d', roughness: 0.5, clearcoat: 0.3, clearcoatRoughness: 0.4 }));
+    const pages = keep(new THREE.MeshStandardMaterial({ color: '#ece2c8', roughness: 0.85 }));
+    const trim = keep(new THREE.MeshStandardMaterial({ color: '#e6d6a8', roughness: 0.4, metalness: 0.35 }));
+
+    // 下册平放：底面贴地 Y=0，页块三面内缩于封面。
+    const lower = new THREE.Group();
+    group.add(lower);
+    addBook(lower, keep, [0.208, 0.041, 0.132], { cover: honeyCover, pages, trim }, '下册');
+    lower.position.set(0, 0.0205, 0);
+
+    // 上册轻微错开＋小角度斜叠：子组整体变换，底面与下册顶面相接。
+    const upper = new THREE.Group();
+    group.add(upper);
+    addBook(upper, keep, [0.176, 0.032, 0.106], { cover: sageCover, pages, trim }, '上册');
+    upper.position.set(0.012, 0.057, -0.002);
+    upper.rotation.y = 7 * Math.PI / 180;
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-bookshelf-01/asset.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-bookshelf-01",
+  "name": "林间蜂蜜木书架",
+  "category": "shelf",
+  "description": "童话风格的落地开放木书架：蜂蜜色暖木、边角圆润、顶部藤叶点缀，层内放少量苔绿、褪色蓝与暖米色的装饰书；正面为本地 +Z，正面开放、背面有背板可分辨；整体点击后显示该实例绑定的资料集合。宽 1.2 米、高 1.8 米、深 0.5 米。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-bookshelf-01",
+  "previewRef": "assets/fairy-bookshelf-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.6, "maxX": 0.6, "minY": 0, "maxY": 1.8, "minZ": -0.25, "maxZ": 0.25 },
+  "placement": { "allowedKinds": ["floor"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [
+    {
+      "name": "书架前阅读取书区",
+      "bounds": { "minX": -0.65, "maxX": 0.65, "minY": 0, "maxY": 1.9, "minZ": 0.25, "maxZ": 1.3 }
+    }
+  ],
+  "approachPoint": { "x": 0, "z": 0.9 },
+  "surfaces": [],
+  "capabilities": ["open-document-collection"],
+  "recommendations": {
+    "note": "适合自然主题阅读区和温暖的项目介绍室，推荐童话房间，也可在写实房间混搭；靠墙、正面朝已保留的通路。"
+  },
+  "source": {
+    "origin": "自制",
+    "license": "MIT",
+    "note": "Three.js 程序化建模与自制材质（固定种子 DataTexture 木纹），生成文件为本包 model.js；自 E4a 样件（实验提交 f824ce3）原样迁入，造型与材质未改动。"
+  }
+}

package/web/assets/furniture/assets/fairy-bookshelf-01/model.js

@@ -0,0 +1,168 @@
+// 林间蜂蜜木书架（fairy-bookshelf-01）· 首款正式家具模型。
+// 自 E4a 实验样件原样迁入（样件提交 f824ce3，2026-09-28；E4b-1 入库，仅改本头部说明），
+// 造型、几何与材质未改动；经 web/assets/furniture/index.json 登记，由同目录 registry.js
+// 按固定字面量动态导入创建。程序化建模＋自制材质：Three.js 随包副本，木纹用固定种子
+// DataTexture 生成，不依赖 canvas/DOM，可在无 DOM 的 Node 中真实构造
+// （tests/furniture-library.test.mjs 依赖这一点）。
+// 约定：米制、+Y 向上、正面本地 +Z、底面中心为原点；根组 position/rotation 为零、
+// scale 为 1；全部实体几何落在声明盒 X[-0.6,0.6]×Y[0,1.8]×Z[-0.25,0.25] 内。
+// 构造不接业务数据、不内置房间坐标、不写实例 ID；dispose 幂等，只释放本次工厂
+// 拥有的几何/材质/纹理（共享几何只登记一次），两实例互不释放对方资源。
+import * as THREE from 'three';
+
+/** 与底座同型的固定种子随机（LCG 家族），保证纹理可复现。 */
+function seededRandom(seed) {
+  return () => {
+    seed |= 0; seed = (seed + 0x6D2B79F5) | 0;
+    let n = Math.imul(seed ^ (seed >>> 15), 1 | seed);
+    n = (n + Math.imul(n ^ (n >>> 7), 61 | n)) ^ n;
+    return ((n ^ (n >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+/**
+ * 256×256 蜂蜜木纹：低对比条纹沿纹理 U 方向变化（贴到板上即沿板长方向展开），
+ * 叠加细噪点与少量节疤环。同一张纹理同时作 map（sRGB 颜色纹理）与 bumpMap。
+ */
+function makeWoodTexture(keep) {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  const rng = seededRandom(20260928);
+  const knots = [];
+  for (let i = 0; i < 3; i++) knots.push({ u: 24 + rng() * (size - 48), v: 24 + rng() * (size - 48), r: 5 + rng() * 7 });
+  for (let v = 0; v < size; v += 1) {
+    const wobble = Math.sin(v * 0.055) * 3.2 + Math.sin(v * 0.017) * 6.5;
+    for (let u = 0; u < size; u += 1) {
+      // 主纹：沿 U 的密条纹，相位被低频扰动推弯；行间再叠一层行噪声
+      const stripe = Math.sin((u + wobble) * 0.62 + Math.sin((u + wobble) * 0.11) * 2.4);
+      const grain = stripe * 0.5 + 0.5;
+      let tone = 213 + grain * 24 - 12 + (rng() - 0.5) * 9;
+      for (const knot of knots) {
+        const du = u - knot.u; const dv = v - knot.v;
+        const ring = Math.sqrt(du * du + dv * dv);
+        if (ring < knot.r) tone -= 14 + Math.sin(ring * 2.6) * 9; // 节疤略深
+      }
+      tone = Math.max(150, Math.min(245, tone));
+      const index = (v * size + u) * 4;
+      data[index] = tone; data[index + 1] = tone - 26; data[index + 2] = tone - 62; data[index + 3] = 255;
+    }
+  }
+  const texture = new THREE.DataTexture(data, size, size, THREE.RGBAFormat);
+  texture.colorSpace = THREE.SRGBColorSpace; // 当颜色纹理使用，按颜色空间标记
+  texture.wrapS = THREE.RepeatWrapping;
+  texture.wrapT = THREE.RepeatWrapping;
+  texture.magFilter = THREE.LinearFilter;
+  texture.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.generateMipmaps = true;
+  texture.needsUpdate = true;
+  return keep(texture);
+}
+
+export function createFairyBookshelf() {
+  const group = new THREE.Group();
+  group.name = 'fairy-bookshelf-01';
+  const owned = new Set();
+  const keep = (resource) => { owned.add(resource); return resource; };
+
+  const woodMap = makeWoodTexture(keep);
+  // 材质预算 8 个：蜜木主色（略深用于背板/底座）、边角轻蜡质、三色装饰书、叶、藤枝
+  const woodMain = keep(new THREE.MeshStandardMaterial({ map: woodMap, bumpMap: woodMap, bumpScale: 0.014, roughness: 0.62, metalness: 0.02 }));
+  const woodDeep = keep(new THREE.MeshStandardMaterial({ map: woodMap, bumpMap: woodMap, bumpScale: 0.012, color: '#cdb28c', roughness: 0.7, metalness: 0.02 }));
+  const woodEdge = keep(new THREE.MeshStandardMaterial({ map: woodMap, color: '#efdcbb', roughness: 0.48, metalness: 0.03 })); // 端部压边：轻微蜡质反光
+  const bookMoss = keep(new THREE.MeshStandardMaterial({ color: '#6b7d4f', roughness: 0.82 }));
+  const bookBlue = keep(new THREE.MeshStandardMaterial({ color: '#7d93a8', roughness: 0.8 }));
+  const bookCream = keep(new THREE.MeshStandardMaterial({ color: '#d8c39a', roughness: 0.86 }));
+  const leafMat = keep(new THREE.MeshStandardMaterial({ color: '#5f7d43', roughness: 0.9, side: THREE.DoubleSide }));
+  const vineMat = keep(new THREE.MeshStandardMaterial({ color: '#6a5236', roughness: 0.95 }));
+
+  const boxGeometry = (w, h, d) => keep(new THREE.BoxGeometry(w, h, d));
+  const addBox = (w, h, d, material, x, y, z) => {
+    const item = new THREE.Mesh(boxGeometry(w, h, d), material);
+    item.position.set(x, y, z);
+    item.castShadow = true;
+    item.receiveShadow = true;
+    group.add(item);
+    return item;
+  };
+
+  // ── 结构：底座（两层）→ 侧立板 → 背板 → 三块层板 → 顶板 → 圆润压边 ──
+  addBox(1.14, 0.08, 0.42, woodDeep, 0, 0.04, 0);          // 底座主体 Y[0,0.08]
+  addBox(1.18, 0.03, 0.46, woodDeep, 0, 0.095, 0);         // 底座顶沿 Y[0.08,0.11]
+  addBox(0.045, 1.61, 0.44, woodMain, -0.575, 0.915, 0);   // 左立板 X[-0.5975,-0.5525] Y[0.11,1.72]
+  addBox(0.045, 1.61, 0.44, woodMain, 0.575, 0.915, 0);    // 右立板
+  addBox(1.06, 1.55, 0.018, woodDeep, 0, 0.885, -0.19);    // 背板 Z[-0.199,-0.181] Y[0.11,1.66]
+  for (const y of [0.52, 0.94, 1.36]) addBox(1.085, 0.035, 0.42, woodMain, 0, y, 0.01); // 三块层板
+  addBox(1.18, 0.05, 0.46, woodMain, 0, 1.745, 0);         // 顶板 Y[1.72,1.77]
+
+  // 顶前圆润压边（轴沿 X 的圆柱）与两侧前棱竖圆角柱（轴沿 Y）
+  const capBeam = new THREE.Mesh(keep(new THREE.CylinderGeometry(0.026, 0.026, 1.18, 12)), woodEdge);
+  capBeam.rotation.z = Math.PI / 2;
+  capBeam.position.set(0, 1.772, 0.214);                    // 最前 0.24、最高 1.798
+  capBeam.castShadow = true;
+  group.add(capBeam);
+  for (const x of [-0.575, 0.575]) {
+    const roundEdge = new THREE.Mesh(keep(new THREE.CylinderGeometry(0.018, 0.018, 1.55, 10)), woodEdge);
+    roundEdge.position.set(x, 0.935, 0.201);                // X ±0.593、Z 0.219
+    roundEdge.castShadow = true;
+    group.add(roundEdge);
+  }
+
+  // ── 装饰书：苔绿/褪色蓝/暖米，贴背板直立，少量斜靠与平放，不铺满每层 ──
+  // 层净空：A Y[0.11,0.5025]、B Y[0.5375,0.9225]、C Y[0.9575,1.3425]；顶层留给藤叶
+  const standing = (x, baseY, h, material, lean = 0) => {
+    const book = addBox(0.05, h, 0.17, material, x, baseY + h / 2, -0.09);
+    if (lean) { book.rotation.z = lean; book.position.x += (Math.sin(lean) * h) / 2; book.position.y = baseY + (Math.cos(lean) * h) / 2 + 0.012; }
+    return book;
+  };
+  standing(-0.44, 0.11, 0.30, bookMoss);
+  standing(-0.37, 0.11, 0.26, bookBlue);
+  standing(-0.30, 0.11, 0.32, bookCream);
+  standing(-0.17, 0.11, 0.30, bookBlue, -0.21);             // 斜靠 12°
+  standing(-0.44, 0.5375, 0.26, bookBlue);
+  standing(-0.37, 0.5375, 0.30, bookCream);
+  standing(-0.30, 0.5375, 0.24, bookMoss);
+  standing(-0.44, 0.9575, 0.28, bookCream);
+  standing(-0.37, 0.9575, 0.25, bookMoss);
+  addBox(0.30, 0.05, 0.22, bookBlue, -0.05, 0.9825, -0.09); // C 层平放一册
+
+  // ── 上角藤叶：贴背板顶沿与两角，不遮开放层与正面；细藤枝沿背板下垂 ──
+  // 叶片是压扁球体，rotY 后的世界包络半径按对角 √(sx²+sz²) 校核，保证整叶留在盒内
+  const leafGeometry = keep(new THREE.SphereGeometry(1, 8, 5)); // 所有叶片共享同一几何
+  const leaves = [
+    [-0.40, 1.772, -0.135, 0.06, 0.014, 0.09, 0.35],
+    [-0.15, 1.768, -0.138, 0.058, 0.014, 0.088, -0.2],
+    [0.12, 1.774, -0.132, 0.06, 0.014, 0.09, 0.55],
+    [0.38, 1.77, -0.135, 0.058, 0.014, 0.088, -0.4],
+    [-0.47, 1.70, -0.13, 0.055, 0.016, 0.085, 0.8],
+    [0.47, 1.70, -0.13, 0.055, 0.016, 0.085, -0.7],
+    [0.44, 1.32, -0.135, 0.06, 0.015, 0.088, 0.15],
+  ];
+  for (const [x, y, z, sx, sy, sz, rotY] of leaves) {
+    const leaf = new THREE.Mesh(leafGeometry, leafMat);
+    leaf.scale.set(sx, sy, sz);
+    leaf.rotation.y = rotY;
+    leaf.position.set(x, y, z);
+    leaf.castShadow = true;
+    group.add(leaf);
+  }
+  for (const side of [-1, 1]) {
+    const vine = new THREE.Mesh(keep(new THREE.CylinderGeometry(0.007, 0.011, 0.55, 8)), vineMat);
+    vine.position.set(side * 0.47, 1.50, -0.165);
+    vine.rotation.x = 0.12;
+    vine.rotation.z = side * 0.06;
+    vine.castShadow = true;
+    group.add(vine);
+  }
+
+  let disposed = false;
+  function dispose() {
+    if (disposed) return;
+    disposed = true;
+    group.removeFromParent();
+    for (const resource of owned) resource.dispose();
+    owned.clear();
+    group.clear();
+  }
+
+  return { group, dispose };
+}