@pioneer_zmc/dsh-workbench 0.2.1

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

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-desk-01",
+  "name": "林间蜂蜜木书桌",
+  "category": "desk",
+  "description": "蜂蜜色暖木书桌，连续水平厚桌面带柔和倒角，四条收脚木腿、桌裙与侧横枨，桌下留空；本地 +Z 正面有静态浅抽屉、细缝和小黄铜拉手，叶形浅装饰与同系列书架呼应。宽 1.6 米、高 0.75 米、深 0.8 米。桌面只承载台灯类物品，不提供抽屉开合或资料动作。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-desk-01",
+  "previewRef": "assets/fairy-desk-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.8, "maxX": 0.8, "minY": 0, "maxY": 0.75, "minZ": -0.4, "maxZ": 0.4 },
+  "placement": { "allowedKinds": ["floor"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [
+    { "name": "桌前操作留空", "bounds": { "minX": -0.8, "maxX": 0.8, "minY": 0, "maxY": 1.9, "minZ": 0.4, "maxZ": 1.3 } }
+  ],
+  "approachPoint": { "x": 0, "z": 1 },
+  "surfaces": [
+    { "surfaceId": "desktop", "name": "桌面可摆放区", "rect": { "minX": -0.7, "maxX": 0.7, "minZ": -0.3, "maxZ": 0.3 }, "y": 0.75, "allowedCategories": ["lamp"] }
+  ],
+  "capabilities": [],
+  "recommendations": { "note": "推荐童话阅读区与温暖的项目介绍区，和林间蜂蜜木书架搭配；也可混搭写实房。桌面只接受 lamp 类别，正面保留操作空间。" },
+  "source": { "origin": "自制", "license": "MIT", "note": "当前资产包 model.js 自制 Three.js 程序化模型与固定种子 DataTexture 木纹，无外部模型或贴图。" }
+}

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

@@ -0,0 +1,132 @@
+// 林间蜂蜜木书桌：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面；底面中心原点。四层圆角环形成真实倒角和连续水平桌面。
+import * as THREE from 'three';
+
+function woodTexture() {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  let seed = 20260929;
+  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++) {
+    // 木纹沿 U 延伸，横向 V 仅轻微起伏；不使用高对比节疤或随机大条纹。
+    const wave = v + 2.2 * Math.sin(u * 0.025) + 0.8 * Math.sin(u * 0.071);
+    const tone = 211 + 5 * Math.sin(wave * 0.48) + 2 * Math.sin(wave * 1.7) + (random() - 0.5) * 3;
+    const i = (v * size + u) * 4;
+    data[i] = tone; data[i + 1] = tone - 28; data[i + 2] = tone - 65; 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.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.generateMipmaps = true;
+  texture.needsUpdate = true;
+  return texture;
+}
+
+// 水平板：上下平面、圆润角点与上下斜边均为真实实体几何，顶面没有支撑替身。
+function roundedBoard(width, height, depth, bevel) {
+  const positions = [], uvs = [], indices = [];
+  const ring = (y, inset) => {
+    const radius = 0.018 - inset;
+    const hx = width / 2 - inset, hz = depth / 2 - inset;
+    const points = [];
+    for (let corner = 0; corner < 4; corner++) {
+      const angle = corner * Math.PI / 2;
+      const cx = (corner === 0 || corner === 3 ? 1 : -1) * (hx - radius);
+      const cz = (corner < 2 ? 1 : -1) * (hz - radius);
+      for (let step = 0; step <= 4; step++) {
+        const a = angle + step * Math.PI / 8;
+        points.push([cx + Math.cos(a) * radius, y, cz + Math.sin(a) * radius]);
+      }
+    }
+    return points;
+  };
+  const rings = [ring(-height / 2, bevel), ring(-height / 2 + bevel, 0), ring(height / 2 - bevel, 0), ring(height / 2, bevel)];
+  const n = rings[0].length;
+  const vertex = (p, uv) => { const id = positions.length / 3; positions.push(...p); uvs.push(...uv); return id; };
+  // 环沿 XZ 逆时针；顶部反序得到 +Y 法线，侧面单独顶点保持柔和斜边与平面分界。
+  for (const [level, top] of [[0, false], [3, true]]) {
+    const center = vertex([0, rings[level][0][1], 0], [0.5, 0.5]);
+    const ids = rings[level].map(p => vertex(p, [p[0] / width + 0.5, p[2] / depth + 0.5]));
+    for (let i = 0; i < n; i++) indices.push(center, ids[top ? (i + 1) % n : i], ids[top ? i : (i + 1) % n]);
+  }
+  for (let level = 0; level < 3; level++) for (let i = 0; i < n; i++) {
+    const j = (i + 1) % n;
+    const ids = [rings[level][i], rings[level][j], rings[level + 1][j], rings[level + 1][i]]
+      .map((p, k) => vertex(p, [((k === 1 || k === 2) ? i + 1 : i) / n * 3, p[1] / height]));
+    indices.push(ids[0], ids[2], ids[1], ids[0], ids[3], ids[2]);
+  }
+  const geometry = new THREE.BufferGeometry();
+  geometry.setAttribute('position', new THREE.Float32BufferAttribute(positions, 3));
+  geometry.setAttribute('uv', new THREE.Float32BufferAttribute(uvs, 2));
+  geometry.setIndex(indices);
+  geometry.computeVertexNormals();
+  return geometry;
+}
+
+export function createFairyDesk() {
+  const group = new THREE.Group();
+  group.name = 'fairy-desk-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 map = keep(woodTexture());
+    const wood = keep(new THREE.MeshStandardMaterial({ map, bumpMap: map, bumpScale: 0.002, roughness: 0.68, metalness: 0.01 }));
+    const deep = keep(new THREE.MeshStandardMaterial({ map, color: '#d5bd99', roughness: 0.74 }));
+    const seam = keep(new THREE.MeshStandardMaterial({ color: '#62492e', roughness: 0.9 }));
+    const brass = keep(new THREE.MeshStandardMaterial({ color: '#b99955', metalness: 0.65, roughness: 0.4 }));
+    const leaf = keep(new THREE.MeshStandardMaterial({ color: '#b69b60', roughness: 0.8 }));
+    const add = (geometry, material, x, y, z, name) => {
+      const mesh = new THREE.Mesh(keep(geometry), material);
+      mesh.name = name; mesh.position.set(x, y, z); mesh.castShadow = mesh.receiveShadow = true;
+      group.add(mesh); return mesh;
+    };
+    const box = (w, h, d, mat, x, y, z, name, grain = 'x') => {
+      const geometry = new THREE.BoxGeometry(w, h, d);
+      const p = geometry.attributes.position, uv = geometry.attributes.uv;
+      for (let i = 0; i < p.count; i++) uv.setXY(i, grain === 'y' ? p.getY(i) / h + 0.5 : grain === 'z' ? p.getZ(i) / d + 0.5 : p.getX(i) / w + 0.5,
+        grain === 'y' ? (p.getX(i) / w + p.getZ(i) / d) / 2 + 0.5 : p.getY(i) / h + 0.5);
+      return add(geometry, mat, x, y, z, name);
+    };
+    add(roundedBoard(1.6, 0.06, 0.8, 0.008), wood, 0, 0.72, 0, '连续蜂蜜木桌面');
+    // 四腿从地面到桌板底部；脚端收细，纹理沿腿长，桌下保持空隙。
+    for (const x of [-0.675, 0.675]) for (const z of [-0.28, 0.28]) {
+      const leg = box(0.092, 0.695, 0.092, wood, x, 0.3475, z, '收脚木腿', 'y');
+      const p = leg.geometry.attributes.position;
+      for (let i = 0; i < p.count; i++) if (p.getY(i) < 0) p.setXYZ(i, p.getX(i) * 0.60, p.getY(i), p.getZ(i) * 0.60);
+      p.needsUpdate = true; leg.geometry.computeVertexNormals();
+    }
+    box(1.28, 0.10, 0.038, deep, 0, 0.64, -0.28, '后桌裙');
+    for (const x of [-0.675, 0.675]) {
+      box(0.038, 0.10, 0.56, deep, x, 0.64, 0, '侧桌裙', 'z');
+      box(0.044, 0.045, 0.52, deep, x, 0.24, 0, '侧横枨', 'z');
+    }
+    for (const x of [-0.465, 0.465]) box(0.39, 0.10, 0.038, deep, x, 0.64, 0.28, '前桌裙');
+    box(0.52, 0.088, 0.026, seam, 0, 0.633, 0.301, '抽屉细缝');
+    box(0.496, 0.070, 0.029, wood, 0, 0.633, 0.320, '静态浅抽屉面板');
+    // 静态抽屉具有实际盒体：底板与侧/后板相接，低视角不会穿透到桌板。
+    box(0.496, 0.012, 0.554, wood, 0, 0.604, 0.037, '抽屉底板');
+    for (const x of [-0.240, 0.240]) box(0.016, 0.070, 0.540, deep, x, 0.643, 0.038, '抽屉侧板', 'z');
+    box(0.496, 0.070, 0.016, deep, 0, 0.643, -0.232, '抽屉后板');
+    for (const x of [-0.055, 0.055]) {
+      const post = add(new THREE.CylinderGeometry(0.009, 0.009, 0.034, 10), brass, x, 0.633, 0.35, '黄铜拉手脚');
+      post.rotation.x = Math.PI / 2;
+    }
+    const handle = add(new THREE.CylinderGeometry(0.009, 0.009, 0.128, 12), brass, 0, 0.633, 0.367, '黄铜拉手');
+    handle.rotation.z = Math.PI / 2;
+    for (const x of [-0.46, 0.46]) {
+      const relief = add(new THREE.SphereGeometry(1, 12, 6), leaf, x, 0.647, 0.302, '叶形浅浮雕');
+      relief.scale.set(0.045, 0.016, 0.004); relief.rotation.z = x > 0 ? -0.25 : 0.25;
+    }
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-notice-board-01/asset.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-notice-board-01",
+  "name": "林间蜂蜜木告示牌",
+  "category": "notice-board",
+  "description": "童话风蜂蜜木落地告示牌：两根立柱下接向前后延伸的短脚，柱顶缀黄铜小球；蜂蜜色木框上沿微拱、边缘倒角收边，框内嵌暖米色软木正面板与木质背板，正面主要区域留白，框角与拱肩缀少量黄铜铆钉。宽 1 米、高 1.7 米、深 0.44 米，本地 +Z 为软木正面板方向。落地摆放，为项目介绍、流程说明等业务资料提供直观的资料集合入口：登记后点击可经现有 open-document-collection 能力在阅读面板查看绑定文档集合；板面只表现软木材质，不直接把业务文档正文、流程图或截图渲染到三维板面上。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-notice-board-01",
+  "previewRef": "assets/fairy-notice-board-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.5, "maxX": 0.5, "minY": 0, "maxY": 1.7, "minZ": -0.22, "maxZ": 0.22 },
+  "placement": { "allowedKinds": ["floor"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [
+    { "name": "告示牌前阅读区", "bounds": { "minX": -0.55, "maxX": 0.55, "minY": 0, "maxY": 1.9, "minZ": 0.22, "maxZ": 1.25 } }
+  ],
+  "approachPoint": { "x": 0, "z": 0.9 },
+  "surfaces": [],
+  "capabilities": ["open-document-collection"],
+  "recommendations": { "note": "推荐项目入口介绍区、流程说明区与童话房，与林间蜂蜜木书架、书桌、台灯同系列搭配；也允许混搭写实房间。风格只是软推荐，不构成摆放准入。" },
+  "source": { "origin": "自制", "license": "MIT", "note": "本包 model.js 自制 Three.js 程序化模型与固定种子 DataTexture 木纹、软木纹，无外部模型或贴图。" }
+}

package/web/assets/furniture/assets/fairy-notice-board-01/model.js

@@ -0,0 +1,125 @@
+// 林间蜂蜜木告示牌：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面（软木面板朝向）；底面中心原点。冻结包络 X±0.5、Y[0,1.7]、Z±0.22。
+// 设计常数（检查按此独立手算）：木框外半宽 0.46、底 0.80、拱脚 1.30、拱顶 1.60、
+// 圆角 0.03；框带宽 0.055；框体挤出 Z[-0.045,0.045]＋倒角 0.008；软木板 Z[-0.005,0.035]；
+// 背板 Z[-0.045,-0.005]；立柱 x=±0.40（截面 0.09×0.074，Y[0.04,1.56]，前面 z=0.037
+// 略凸出于软木板前面 0.035，避免共面闪纹）；短脚 X[±0.35,±0.45]、
+// Y[0,0.045]、Z±0.19；横撑 Y[0.48,0.52]；柱顶黄铜球 r0.032@Y1.578；铆钉 r0.014@Z0.053。
+import * as THREE from 'three';
+
+function woodTexture() {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  let seed = 20260932;
+  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++) {
+    // 低对比细木纹沿 U 延伸，与书桌、书架同系列；不做节疤。
+    const wave = v + 1.4 * Math.sin(u * 0.031) + 0.5 * Math.sin(u * 0.083);
+    const tone = 208 + 4 * Math.sin(wave * 0.55) + 2 * Math.sin(wave * 1.9) + (random() - 0.5) * 2.5;
+    const i = (v * size + u) * 4;
+    data[i] = tone; data[i + 1] = tone - 24; data[i + 2] = tone - 58; 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.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.generateMipmaps = true;
+  texture.needsUpdate = true;
+  return texture;
+}
+
+function corkTexture() {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  let seed = 20260933;
+  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 grain = (random() - 0.5) * 9 + 2.2 * Math.sin(u * 0.71) * Math.sin(v * 0.63);
+    const speck = random() < 0.012 ? -26 : 0;
+    const tone = 226 + grain + speck;
+    const i = (v * size + u) * 4;
+    data[i] = tone + 8; data[i + 1] = tone - 6; data[i + 2] = tone - 34; 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.minFilter = THREE.LinearMipmapLinearFilter;
+  texture.generateMipmaps = true;
+  texture.needsUpdate = true;
+  return texture;
+}
+
+// 拱顶外轮廓：底边圆角 r，两侧直边到拱脚，两条二次曲线汇于拱顶；按 inset 收缩得框内孔。
+function boardOutline(halfWidth, bottom, spring, peak, radius) {
+  const path = new THREE.Path();
+  path.moveTo(-halfWidth + radius, bottom);
+  path.lineTo(halfWidth - radius, bottom);
+  path.quadraticCurveTo(halfWidth, bottom, halfWidth, bottom + radius);
+  path.lineTo(halfWidth, spring);
+  path.quadraticCurveTo(halfWidth, peak, 0, peak);
+  path.quadraticCurveTo(-halfWidth, peak, -halfWidth, spring);
+  path.lineTo(-halfWidth, bottom + radius);
+  path.quadraticCurveTo(-halfWidth, bottom, -halfWidth + radius, bottom);
+  path.closePath();
+  return path;
+}
+
+export function createFairyNoticeBoard() {
+  const group = new THREE.Group();
+  group.name = 'fairy-notice-board-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 wood = keep(woodTexture());
+    const cork = keep(corkTexture());
+    const honey = keep(new THREE.MeshStandardMaterial({ map: wood, bumpMap: wood, bumpScale: 0.0015, roughness: 0.66, metalness: 0.01 }));
+    const backWood = keep(new THREE.MeshStandardMaterial({ color: '#dcc39a', map: wood, bumpMap: wood, bumpScale: 0.0012, roughness: 0.78 }));
+    const corkMat = keep(new THREE.MeshStandardMaterial({ map: cork, bumpMap: cork, bumpScale: 0.004, roughness: 0.95 }));
+    const brass = keep(new THREE.MeshStandardMaterial({ color: '#c19a5e', metalness: 0.7, roughness: 0.34 }));
+    const add = (geometry, material, x, y, z, name) => {
+      const mesh = new THREE.Mesh(keep(geometry), material);
+      mesh.name = name; mesh.position.set(x, y, z); mesh.castShadow = mesh.receiveShadow = true;
+      group.add(mesh); return mesh;
+    };
+
+    // 面板三件：木框（真实倒角挤出，孔内嵌板）、软木正面板、木质背板；三者都有实际厚度。
+    const OUTER = { halfWidth: 0.46, bottom: 0.80, spring: 1.30, peak: 1.60, radius: 0.03 };
+    const inset = 0.055;
+    const frameShape = new THREE.Shape(boardOutline(OUTER.halfWidth, OUTER.bottom, OUTER.spring, OUTER.peak, OUTER.radius).getPoints(16));
+    frameShape.holes.push(boardOutline(
+      OUTER.halfWidth - inset, OUTER.bottom + inset, OUTER.spring - inset, OUTER.peak - inset, OUTER.radius,
+    ));
+    add(new THREE.ExtrudeGeometry(frameShape, { depth: 0.09, bevelEnabled: true, bevelThickness: 0.008, bevelSize: 0.008, bevelSegments: 2, curveSegments: 16 }), honey, 0, 0, -0.045, '木框');
+    const panelShape = new THREE.Shape(boardOutline(
+      OUTER.halfWidth - inset, OUTER.bottom + inset, OUTER.spring - inset, OUTER.peak - inset, OUTER.radius,
+    ).getPoints(16));
+    add(new THREE.ExtrudeGeometry(panelShape, { depth: 0.04, bevelEnabled: false, curveSegments: 16 }), corkMat, 0, 0, -0.005, '软木正面板');
+    add(new THREE.ExtrudeGeometry(panelShape, { depth: 0.04, bevelEnabled: false, curveSegments: 16 }), backWood, 0, 0, -0.045, '木质背板');
+
+    // 两根立柱与向前后延伸的短脚：脚底到 Y=0，柱、脚、面板真实嵌接，不悬空。
+    for (const side of [-1, 1]) {
+      const label = side < 0 ? '左' : '右';
+      add(new THREE.BoxGeometry(0.09, 1.52, 0.074), honey, side * 0.40, 0.80, 0, `${label}立柱`);
+      add(new THREE.BoxGeometry(0.10, 0.045, 0.38), honey, side * 0.40, 0.0225, 0, `${label}短脚`);
+      add(new THREE.SphereGeometry(0.032, 14, 10), brass, side * 0.40, 1.578, 0, '柱顶黄铜球');
+    }
+    add(new THREE.BoxGeometry(0.72, 0.04, 0.06), honey, 0, 0.50, 0, '背侧横撑');
+
+    // 少量黄铜铆钉：底角、拱肩与拱冠各就位在框带中线上，正面主要区域保持留白。
+    for (const [x, y] of [[-0.4325, 0.8275], [0.4325, 0.8275], [-0.4325, 1.3275], [0.4325, 1.3275], [0, 1.5725]]) {
+      add(new THREE.SphereGeometry(0.014, 10, 6), brass, x, y, 0.053, '黄铜铆钉');
+    }
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-potted-plant-01/asset.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-potted-plant-01",
+  "name": "林间小叶盆栽",
+  "category": "plant",
+  "description": "童话风小叶盆栽：暖陶小盆有厚边盆口与真实内外壁，盆内可见土面；短枝从土中长出并向两侧分枝，托起八片带薄厚度与弧度的小叶，绿色分三档、轮廓紧凑，叶柄接枝、枝接土。宽深各 0.22 米、高 0.36 米，本地 +Z 正面为叶簇朝向之一。静态陈列摆件，无生长动画、光点或实际灯光，无任何资料动作；仅可依附接受 plant 类别的承载面（如陶瓷展示台台面），当前书桌桌面只接受台灯类别，不能因为“桌面摆件”的称呼承诺能放上书桌。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-potted-plant-01",
+  "previewRef": "assets/fairy-potted-plant-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.11, "maxX": 0.11, "minY": 0, "maxY": 0.36, "minZ": -0.11, "maxZ": 0.11 },
+  "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-potted-plant-01/model.js

@@ -0,0 +1,128 @@
+// 林间小叶盆栽：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面；底面中心原点。冻结包络 X、Z 各 ±0.11、Y[0,0.36]。
+// 设计常数（检查按此独立手算）：盆外壳 lathe 外底近轴 (0.001,0)→外底缘 (0.058,0)→
+// 底缘圆角 (0.064,0.008)→盆壁 (0.072,0.080)→口外缘 (0.076,0.092)→厚边顶 (0.070,0.098)；
+// 盆口沿面环外 0.070／内 0.0665 @Y0.098；盆内壁 lathe 自口内缘 (0.0665,0.098) 下行至
+// 内底缘 (0.052,0.034)→内底近轴 (0.001,0.032)；土面圆盘 r0.058 @Y0.078；
+// 主枝自土内 (0.008,0.070,0.004) 至 (0.020,0.178,0.010)（r0.005），
+// 两分枝自 (0.015,0.150,0.008) 分别至 (−0.030,0.210,−0.020) 与 (0.032,0.222,0.018)（r0.0035）；
+// 八片薄弧叶（球体压扁 0.036×0.005×0.015）叶柄端接枝：叶心自所接枝端沿朝向偏移 0.024，
+// 小于长半轴 0.036，枝端点始终嵌在叶体内；随机翻转只绕长轴（rotateX），实测叶簇最高约 Y0.27。
+// 无动画、光点或实际灯光；每叶有薄厚度，枝入土、叶接枝，不出现漂浮叶。
+import * as THREE from 'three';
+
+// 圆盘（土面）：法线朝上的真实面。
+// 椭圆扁平环（盆口沿面）：厚边顶面的真实窄环。
+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;
+}
+
+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;
+}
+
+export function createFairyPottedPlant() {
+  const group = new THREE.Group();
+  group.name = 'fairy-potted-plant-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 terra = keep(new THREE.MeshStandardMaterial({ color: '#b06f4e', roughness: 0.85 }));
+    const soil = keep(new THREE.MeshStandardMaterial({ color: '#4a3626', roughness: 0.97 }));
+    const stem = keep(new THREE.MeshStandardMaterial({ color: '#5a4a33', roughness: 0.8 }));
+    const greenDeep = keep(new THREE.MeshStandardMaterial({ color: '#3c5232', roughness: 0.7 }));
+    const greenMid = keep(new THREE.MeshStandardMaterial({ color: '#4f6b3c', roughness: 0.68 }));
+    const greenLight = keep(new THREE.MeshStandardMaterial({ color: '#68884a', roughness: 0.65 }));
+    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.058, 0), new THREE.Vector2(0.064, 0.008),
+      new THREE.Vector2(0.072, 0.080), new THREE.Vector2(0.076, 0.092), new THREE.Vector2(0.070, 0.098),
+    ], 32), terra, '盆外壳');
+    add(annulus(0.098, 0.070, 0.0665, 32), terra, '盆口沿面');
+    add(new THREE.LatheGeometry([
+      new THREE.Vector2(0.0665, 0.098), new THREE.Vector2(0.060, 0.040), new THREE.Vector2(0.052, 0.034),
+      new THREE.Vector2(0.001, 0.032),
+    ], 32), soil, '盆内壁');
+    add(disc(0.078, 0.058, 32), soil, '土面');
+    // 枝：两点定长的圆柱（同台灯支架技巧），自土中向上，分枝外倾。
+    const grow = (from, to, radius, name) => {
+      const fromV = new THREE.Vector3(...from), toV = new THREE.Vector3(...to);
+      const branch = add(new THREE.CylinderGeometry(radius, radius * 1.15, fromV.distanceTo(toV), 8), stem, name);
+      branch.position.copy(fromV).add(toV).multiplyScalar(0.5);
+      branch.quaternion.setFromUnitVectors(new THREE.Vector3(0, 1, 0), toV.clone().sub(fromV).normalize());
+      return toV;
+    };
+    const soilTop = new THREE.Vector3(0.008, 0.070, 0.004);
+    const mainTip = new THREE.Vector3(0.020, 0.178, 0.010);
+    const forkBase = new THREE.Vector3(0.015, 0.150, 0.008);
+    grow([soilTop.x, soilTop.y, soilTop.z], [mainTip.x, mainTip.y, mainTip.z], 0.005, '主枝');
+    const tipA = grow([forkBase.x, forkBase.y, forkBase.z], [-0.030, 0.210, -0.020], 0.0035, '左分枝');
+    const tipB = grow([forkBase.x, forkBase.y, forkBase.z], [0.032, 0.222, 0.018], 0.0035, '右分枝');
+    // 八片薄弧叶：叶心自所接枝端沿 outward 偏移 0.024（<长半轴 0.036），朝向固定种子伪随机，三档绿色。
+    let seed = 20260961;
+    const random = () => { seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0; return seed / 4294967296; };
+    const anchors = [mainTip, tipA, tipB, tipA, tipB, mainTip, tipA, tipB];
+    const greens = [greenDeep, greenMid, greenLight];
+    for (let i = 0; i < anchors.length; i++) {
+      const anchor = anchors[i];
+      const yaw = random() * Math.PI * 2;
+      const tilt = 0.35 + random() * 0.5;
+      const outward = new THREE.Vector3(Math.cos(yaw) * Math.cos(tilt), Math.sin(tilt), Math.sin(yaw) * Math.cos(tilt)).normalize();
+      const leaf = add(new THREE.SphereGeometry(1, 10, 8), greens[i % 3], `薄叶${i + 1}`);
+      leaf.scale.set(0.036, 0.005, 0.015);
+      leaf.position.copy(anchor).add(outward.clone().multiplyScalar(0.024));
+      leaf.quaternion.setFromUnitVectors(new THREE.Vector3(1, 0, 0), outward);
+      // 随机翻转只能绕自身长轴（rotateX）：长轴保持穿过所接枝端，叶柄端始终嵌入枝内；
+      // 绕局部 Y 随机转会把短轴转向枝端（偏移 0.024 超过短半轴 0.015），叶与枝分离成漂浮叶。
+      leaf.rotateX(random() * Math.PI);
+    }
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-reading-chair-01/asset.json

@@ -0,0 +1,61 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-reading-chair-01",
+  "name": "林间软垫阅读椅",
+  "category": "chair",
+  "description": "紧凑蜂蜜木扶手椅，四脚、座框和背支承连接厚奶油坐垫与靠垫，两侧圆润扶手。宽0.72、深0.60、高不超过0.95米；+Z为座前。仅地面静态家具，不支持坐下，不提供承载面。",
+  "styleIds": [
+    "fairy"
+  ],
+  "modelRef": "fairy-reading-chair-01",
+  "previewRef": "assets/fairy-reading-chair-01/preview.webp",
+  "placeholder": false,
+  "bounds": {
+    "minX": -0.36,
+    "maxX": 0.36,
+    "minY": 0,
+    "maxY": 0.95,
+    "minZ": -0.3,
+    "maxZ": 0.3
+  },
+  "placement": {
+    "allowedKinds": [
+      "floor"
+    ],
+    "allowedYawDeg": [
+      0,
+      90,
+      180,
+      270
+    ]
+  },
+  "clearanceBoxes": [
+    {
+      "name": "正面接近操作区",
+      "bounds": {
+        "minX": -0.45,
+        "maxX": 0.45,
+        "minY": 0,
+        "maxY": 1.9,
+        "minZ": 0.3,
+        "maxZ": 1.3
+      }
+    }
+  ],
+  "approachPoint": {
+    "x": 0,
+    "z": 0.9
+  },
+  "surfaces": [],
+  "capabilities": [],
+  "recommendations": {
+    "note": "适合温暖阅读休憩房，与蜂蜜木书桌、书架、奶油布料及暖白陶瓷搭配；风格只是软推荐，混搭允许，摆放以空间和类别校验为准。"
+  },
+  "source": {
+    "origin": "自制",
+    "license": "MIT",
+    "note": "自制Three.js程序化实体几何，无外部模型或贴图；有木面者使用固定种子DataTexture。"
+  }
+}

package/web/assets/furniture/assets/fairy-reading-chair-01/model.js

@@ -0,0 +1,66 @@
+// 自制阅读休憩家具。米制、+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 createFairyReadingChair() {
+  const group = new THREE.Group(); group.name = 'fairy-reading-chair-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.28, 0.28]) for (const z of [-0.21, 0.21])
+      soft(0.065, 0.40, 0.065, wood, x, 0.20, z, '落地椅脚');
+    box(0.62, 0.065, 0.47, wood, 0, 0.39, 0.015, '座承托板');
+    for (const x of [-0.29, 0.29]) soft(0.065, 0.105, 0.52, wood, x, 0.38, 0, '侧座框');
+    for (const z of [-0.23, 0.23]) soft(0.62, 0.105, 0.055, wood, 0, 0.38, z, '端座框');
+    for (const x of [-0.275, 0.275]) {
+      soft(0.055, 0.57, 0.065, wood, x, 0.635, -0.235, '靠背支承');
+      soft(0.055, 0.24, 0.055, wood, x, 0.505, 0.21, '前扶手支承');
+      soft(0.09, 0.065, 0.52, wood, x, 0.635, 0, '圆润扶手');
+    }
+    soft(0.56, 0.12, 0.46, cream, 0, 0.48, 0.015, '厚坐垫', 0.035);
+    soft(0.56, 0.47, 0.06, wood, 0, 0.70, -0.25, '实木背板', 0.04).rotation.x = -0.05;
+    soft(0.53, 0.43, 0.095, cream, 0, 0.705, -0.18, '厚靠垫', 0.05).rotation.x = -0.05;
+    soft(0.53, 0.018, 0.035, green, 0, 0.543, 0.205, '坐垫青绿缝边', 0.005);
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/fairy-table-lamp-01/asset.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "fairy-table-lamp-01",
+  "name": "林间暖光台灯",
+  "category": "lamp",
+  "description": "童话风暖光小台灯：低矮圆润蜂蜜木底座带收边，黄铜灯杆经套环连接底座与灯头，暖米色微锥布灯罩有外壁、内衬与上下薄包边，罩内小灯泡呈固定暖亮外观；宽 0.24 米、高 0.42 米、深 0.30 米，本地 +Z 正面为底座小黄铜叶纹嵌片。仅可依附接受 lamp 类别的承载面（如书桌桌面），无独立地面站位；灯泡为固定暖亮材质，无实际照明、开关灯或昼夜动作。",
+  "styleIds": ["fairy"],
+  "modelRef": "fairy-table-lamp-01",
+  "previewRef": "assets/fairy-table-lamp-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.12, "maxX": 0.12, "minY": 0, "maxY": 0.42, "minZ": -0.15, "maxZ": 0.15 },
+  "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 木纹、布纹，无外部模型或贴图。" }
+}