@pioneer_zmc/dsh-workbench 0.2.1

package/web/assets/details.js

@@ -0,0 +1,197 @@
+// 说明文档（details.md）解析：纯函数，不碰 DOM，Node 侧可直接 import 测试。
+// 约定：一级标题 `#` 是图的总说明；`## <节点 id>` 分节，
+// 节内为自由 Markdown。图上不存在但详情写了的 id —— 容忍，不报错（删节点后旧详情不必同步清）；
+// 图上存在但详情缺失的节点 —— 只列为"没写说明"，不算错误。
+
+/** 去掉首尾空行，不去中间（节内空行保留，段落由 parseBody 再拆）。 */
+function trimBlank(lines) {
+  let start = 0
+  let end = lines.length
+  while (start < end && !lines[start].trim()) start += 1
+  while (end > start && !lines[end - 1].trim()) end -= 1
+  return lines.slice(start, end)
+}
+
+/** 拆出总说明与各分节（按文件出现顺序）。空文件/非字符串 → 空结果。 */
+export function parseDetails(text) {
+  const result = { title: '', sections: [] }
+  if (typeof text !== 'string' || !text.trim()) return result
+  let current = null
+  // 正在其中的代码块围栏（``` 或 ~~~）：围栏里的 `#`/`##` 是演示示例不是标题，
+  // 当正文原样保留——不然示例会截断上一节，还会冒充别的节点的说明
+  let fence = null
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.trimEnd()
+    const fenceMark = /^ {0,3}(`{3,}|~{3,})/.exec(line)
+    if (fence) {
+      // 关围栏：同种字符、不短于开的时候、后面没字（后面有字算围栏里的正文）
+      if (fenceMark && fenceMark[1][0] === fence[0] && fenceMark[1].length >= fence.length
+        && !line.slice(fenceMark[0].length).trim()) fence = null
+      if (current) current.body.push(rawLine)
+      continue
+    }
+    if (fenceMark) {
+      fence = fenceMark[1]
+      if (current) current.body.push(rawLine)
+      continue
+    }
+    // 一级标题只在首个分节之前算"总说明"；分节里的 `#` 属于正文
+    const heading1 = /^#[ \t]+(.+?)[ \t]*$/.exec(line)
+    if (heading1 && !current) {
+      result.title = heading1[1].trim()
+      continue
+    }
+    // `^##[ \t]` 不会匹配 `###`（第三个字符不是空白），三级标题因此留在节内
+    const heading2 = /^##[ \t]+(.+?)[ \t]*$/.exec(line)
+    if (heading2) {
+      // 约定写纯节点 id；多写的字不丢正文，按空白切成 id 与剩余文字
+      const [id, ...rest] = heading2[1].trim().split(/\s+/)
+      current = { id, note: rest.join(' '), body: [] }
+      result.sections.push(current)
+      continue
+    }
+    if (current) current.body.push(rawLine)
+  }
+  for (const section of result.sections) section.body = trimBlank(section.body).join('\n')
+  return result
+}
+
+/**
+ * 把说明文档与图上节点对上，供页面直接渲染。
+ * nodes 为空数组表示"图读不开、判断不了归属"（例如 workflow.json 坏了）：
+ * 此时不把条目判成图外条目，按原样列出。
+ * nodes 里混进非对象或缺 id 的坏条目（如 JSON 里写了 null）：跳过它们，不让页面崩——
+ * 图本身已由渲染区报错，这里不再因为同一份坏文件二次崩页。
+ */
+export function buildDetails(text, nodes) {
+  const parsed = parseDetails(text)
+  const chartNodes = (Array.isArray(nodes) ? nodes : []).filter(
+    (node) => node && typeof node === 'object' && !Array.isArray(node) && typeof node.id === 'string',
+  )
+  const known = chartNodes.length > 0
+  const byId = new Map(chartNodes.map((node) => [node.id, node]))
+  const seen = new Set()
+  // 同一编号写多节：不算错，但要让人知道——块上带这个编号在文档里出现的次数，
+  // 详情弹层据此提示"显示的是第一份"，而不是默默挑一份
+  const times = new Map()
+  for (const section of parsed.sections) times.set(section.id, (times.get(section.id) || 0) + 1)
+  const blocks = []
+  const strays = []
+  for (const section of parsed.sections) {
+    seen.add(section.id)
+    const node = byId.get(section.id)
+    const entry = {
+      id: section.id,
+      label: node ? node.label || node.id : section.id,
+      sublabel: node && node.sublabel ? node.sublabel : '',
+      note: section.note || '',
+      body: section.body,
+      repeats: times.get(section.id) || 1,
+      onChart: known ? Boolean(node) : null,
+    }
+    if (entry.onChart === false) strays.push(entry)
+    else blocks.push(entry)
+  }
+  const missing = known
+    ? chartNodes.filter((node) => !seen.has(node.id)).map((node) => ({ id: node.id, label: node.label || node.id }))
+    : []
+  const hasText = typeof text === 'string' && Boolean(text.trim())
+  return {
+    empty: !hasText,
+    title: parsed.title,
+    // 有内容却没有分节：没按约定写（只有总说明也算），页面据此说明为什么只有一段
+    malformed: hasText && parsed.sections.length === 0,
+    blocks,
+    strays,
+    missing,
+  }
+}
+
+/**
+ * 在说明文档结果里找某个节点的这一节（详情弹层用）。只做判断与查找，不拼文案——措辞由页面
+ * 按同一个版本的情况写，弹层与说明面板才说得一样。返回 { kind, ... }：
+ *   'unreadable' 文档在但读不开（如超过大小上限）：给 unreadable 原因即此态
+ *   'empty'      这个版本没有说明文档
+ *   'section'    找到这一节：block 就是说明面板里那一块（正文/名字/副标签/编号都在里面）；
+ *                同一编号在文档里写了多节时 repeats 带次数（取按出现顺序的第一份，
+ *                页面要据此提示，不能默默挑一份）
+ *   'malformed'  有文档但没按约定分节（每节应以「## 节点编号」开头）
+ *   'missing'    文档按约定分了节，但没有这个节点的
+ * 五种之外不会有第六种：图上有的节点，落到后四种之一必然说得出原因。
+ */
+export function findSection(doc, id, { unreadable = '' } = {}) {
+  if (unreadable) return { kind: 'unreadable', reason: unreadable }
+  if (!doc || doc.empty) return { kind: 'empty' }
+  // 图外条目（旧编号）也认：配上就显示，不因为"图上没有"就当没写
+  const block = doc.blocks.find((item) => item.id === id) || doc.strays.find((item) => item.id === id)
+  if (block) return { kind: 'section', block, repeats: block.repeats || 1 }
+  if (doc.malformed) return { kind: 'malformed' }
+  return { kind: 'missing', id }
+}
+
+/**
+ * 正文分块内核：空行分段、`-`/`*`/`数字.` 列表；headings 打开时把 `#` 标题单独成块
+ * （房内资料面板读整篇业务文档要标题；节点详情的节内正文不按标题切）。
+ * 只认最常见的写法，不假装是完整 Markdown 解析器。
+ */
+function parseBlocks(text, headings) {
+  const items = []
+  let paragraph = []
+  const flush = () => {
+    if (paragraph.length) {
+      items.push({ kind: 'paragraph', text: paragraph.join(' ') })
+      paragraph = []
+    }
+  }
+  for (const line of String(text ?? '').split(/\r?\n/)) {
+    const trimmed = line.trim()
+    if (!trimmed) {
+      flush()
+      continue
+    }
+    const heading = headings ? /^(#{1,6})[ \t]+(.+?)[ \t]*$/.exec(trimmed) : null
+    if (heading) {
+      flush()
+      items.push({ kind: 'heading', level: heading[1].length, text: heading[2] })
+      continue
+    }
+    const bullet = /^(?:[-*+]|\d+\.)[ \t]+(.*)$/.exec(trimmed)
+    if (bullet) {
+      flush()
+      items.push({ kind: 'bullet', text: bullet[1] })
+    } else {
+      paragraph.push(trimmed)
+    }
+  }
+  flush()
+  return items
+}
+
+/**
+ * 一节正文拆成段落与列表项。只认最常见的写法（空行分段、`-`/`*`/`数字.` 列表），
+ * 不假装是完整 Markdown 解析器。
+ */
+export const parseBody = (text) => parseBlocks(text, false)
+
+/**
+ * 整篇文档的正文分块（房内资料面板读业务文档用）：与 parseBody 同一口径，多认 `#` 标题行。
+ * 标题按层级给 { kind: 'heading', level 1..6, text }，页面据此决定用几级标题呈现。
+ */
+export const parseDocument = (text) => parseBlocks(text, true)
+
+/** 行内标记：**加粗** 与 `代码`。返回片段数组，页面拼 DOM 用（不经 innerHTML）。 */
+export function splitInline(text) {
+  const parts = []
+  const pattern = /\*\*([^*]+)\*\*|`([^`]+)`/g
+  let last = 0
+  let match
+  while ((match = pattern.exec(String(text ?? '')))) {
+    if (match.index > last) parts.push({ text: String(text).slice(last, match.index) })
+    if (match[1] !== undefined) parts.push({ text: match[1], strong: true })
+    else parts.push({ text: match[2], code: true })
+    last = pattern.lastIndex
+  }
+  const source = String(text ?? '')
+  if (last < source.length) parts.push({ text: source.slice(last) })
+  return parts
+}

package/web/assets/evidence.js

@@ -0,0 +1,30 @@
+// 源码证据展示的纯函数部分（步骤 4/D）：不含 DOM，Node 可直接加载验证（.runtime/check-d.mjs）。
+// 输入形状 = 服务端 /api/evidence 的返回（src/core/evidence.ts 的 EvidenceResult）。
+
+/**
+ * 服务端把报错拼成「refs[0]（bad-commit）：原因」；页面上编号与 id 已单独展示，
+ * 这里剥掉前缀只留人话原因。前缀对不上（形状变了）就原样返回，不吞错误。
+ */
+export function displayError(error) {
+  const stripped = error.replace(/^refs\[\d+\]（[^：]*）：/, '')
+  return stripped || error
+}
+
+/** 代码片段拼成带行号的整段文本（行号 = 文件里的真实行号，从 fromLine 起）。 */
+export function formatCodeBlock(text, fromLine) {
+  const lines = text.split('\n')
+  const width = String(fromLine + lines.length - 1).length
+  return lines.map((line, i) => `${String(fromLine + i).padStart(width)} │ ${line}`).join('\n')
+}
+
+/** 汇总一行：几条证据、几条有效、几条有问题。没有引用时返回 null（不显示汇总）。 */
+export function evidenceSummary(refs) {
+  if (!refs.length) return null
+  const ok = refs.filter((ref) => ref.ok).length
+  return { total: refs.length, ok, bad: refs.length - ok }
+}
+
+/** 有效引用的出处说明（一行）：文件 · 行范围 · 固定提交（短号）。 */
+export function describeSource(ref) {
+  return `文件 ${ref.path} · 第 ${ref.fromLine}–${ref.toLine} 行 · 固定提交 ${ref.commit.slice(0, 8)}`
+}

package/web/assets/furniture/SOURCES.md

@@ -0,0 +1,24 @@
+# 家具来源与许可
+
+十二款登记家具均由本项目程序化自制；模型代码、程序生成纹理与渲染缩略图统一采用同包 [MIT许可证](../../../LICENSE)。没有引入外部模型或网络素材。木纹/织物由固定种子DataTexture生成，其余使用材质着色；缩略图由相应模型渲染生成。
+
+asset.json 的 source.license 为 MIT。status=internal 是当前目录格式的登记字段，目录读取器仍要求此值；它不是许可限制，不需要修改为public/published。尺寸、互动、摆放与绑定约束以每款asset.json为准。
+
+| 家具 | 元数据 | 模型 | 缩略图 |
+| --- | --- | --- |
+| 暖釉陶瓷展示台 | [ceramic-display-stand-01](assets/ceramic-display-stand-01/asset.json) | [model.js](assets/ceramic-display-stand-01/model.js) | [preview.webp](assets/ceramic-display-stand-01/preview.webp) |
+| 暖釉落地阅读灯 | [ceramic-floor-lamp-01](assets/ceramic-floor-lamp-01/asset.json) | [model.js](assets/ceramic-floor-lamp-01/model.js) | [preview.webp](assets/ceramic-floor-lamp-01/preview.webp) |
+| 暖白双门矮柜 | [ceramic-low-cabinet-01](assets/ceramic-low-cabinet-01/asset.json) | [model.js](assets/ceramic-low-cabinet-01/model.js) | [preview.webp](assets/ceramic-low-cabinet-01/preview.webp) |
+| 暖釉细颈花瓶 | [ceramic-vase-01](assets/ceramic-vase-01/asset.json) | [model.js](assets/ceramic-vase-01/model.js) | [preview.webp](assets/ceramic-vase-01/preview.webp) |
+| 林间蜂蜜木床 | [fairy-bed-01](assets/fairy-bed-01/asset.json) | [model.js](assets/fairy-bed-01/model.js) | [preview.webp](assets/fairy-bed-01/preview.webp) |
+| 林间双册书摆 | [fairy-book-stack-01](assets/fairy-book-stack-01/asset.json) | [model.js](assets/fairy-book-stack-01/model.js) | [preview.webp](assets/fairy-book-stack-01/preview.webp) |
+| 林间蜂蜜木书架 | [fairy-bookshelf-01](assets/fairy-bookshelf-01/asset.json) | [model.js](assets/fairy-bookshelf-01/model.js) | [preview.webp](assets/fairy-bookshelf-01/preview.webp) |
+| 林间蜂蜜木书桌 | [fairy-desk-01](assets/fairy-desk-01/asset.json) | [model.js](assets/fairy-desk-01/model.js) | [preview.webp](assets/fairy-desk-01/preview.webp) |
+| 林间蜂蜜木告示牌 | [fairy-notice-board-01](assets/fairy-notice-board-01/asset.json) | [model.js](assets/fairy-notice-board-01/model.js) | [preview.webp](assets/fairy-notice-board-01/preview.webp) |
+| 林间小叶盆栽 | [fairy-potted-plant-01](assets/fairy-potted-plant-01/asset.json) | [model.js](assets/fairy-potted-plant-01/model.js) | [preview.webp](assets/fairy-potted-plant-01/preview.webp) |
+| 林间软垫阅读椅 | [fairy-reading-chair-01](assets/fairy-reading-chair-01/asset.json) | [model.js](assets/fairy-reading-chair-01/model.js) | [preview.webp](assets/fairy-reading-chair-01/preview.webp) |
+| 林间暖光台灯 | [fairy-table-lamp-01](assets/fairy-table-lamp-01/asset.json) | [model.js](assets/fairy-table-lamp-01/model.js) | [preview.webp](assets/fairy-table-lamp-01/preview.webp) |
+
+## 第三方依赖
+
+Three.js用于渲染，随包代码保留上游MIT版权声明，来源与版本见 [Three.js版本说明](../three/VERSION.md)。Archify用于资料和流程图渲染，其 [LICENSE](../../../vendor/archify-renderer/archify/LICENSE) 与 [第三方声明](../../../vendor/archify-renderer/archify/THIRD_PARTY_NOTICES.md) 保留。家具MIT声明不替换任何第三方版权。

package/web/assets/furniture/assets/ceramic-display-stand-01/asset.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "ceramic-display-stand-01",
+  "name": "暖釉陶瓷展示台",
+  "category": "display-stand",
+  "description": "暖白象牙釉面陶瓷展示台：厚台板带柔和倒角与台板下一圈浅青灰收边，中央收腰柱身托住台板，向下接较宽的低底座，底面落地。釉面有柔和高光与很弱的粗糙度变化。占地 0.8×0.6 米、高 0.9 米，本地 +Z 为正面。台顶提供水平陈列面，可放置台灯、花瓶、绿植与小摆件；展示台没有资料动作，不是屏幕，不显示文档或流程图。",
+  "styleIds": ["ceramic"],
+  "modelRef": "ceramic-display-stand-01",
+  "previewRef": "assets/ceramic-display-stand-01/preview.webp",
+  "placeholder": false,
+  "bounds": { "minX": -0.4, "maxX": 0.4, "minY": 0, "maxY": 0.9, "minZ": -0.3, "maxZ": 0.3 },
+  "placement": { "allowedKinds": ["floor"], "allowedYawDeg": [0, 90, 180, 270] },
+  "clearanceBoxes": [
+    { "name": "展台前陈列操作区", "bounds": { "minX": -0.5, "maxX": 0.5, "minY": 0, "maxY": 1.9, "minZ": 0.3, "maxZ": 1.3 } }
+  ],
+  "approachPoint": { "x": 0, "z": 0.9 },
+  "surfaces": [
+    { "surfaceId": "display-top", "name": "展示台顶部陈列区", "rect": { "minX": -0.32, "maxX": 0.32, "minZ": -0.22, "maxZ": 0.22 }, "y": 0.9, "allowedCategories": ["lamp", "vase", "plant", "ornament"] }
+  ],
+  "capabilities": [],
+  "recommendations": { "note": "推荐写实项目展示区，也可混搭童话阅读房。台顶陈列区接受台灯、花瓶、绿植与小摆件四类，子物品仍须自身支持 surface 放置并通过投影、重叠与高度等现行校验，不代表对应资产已经做出或任意大小都能放。" },
+  "source": { "origin": "自制", "license": "MIT", "note": "当前资产包 model.js 自制 Three.js 程序化模型与固定种子 DataTexture 釉面粗糙度纹理，无外部模型或贴图。" }
+}

package/web/assets/furniture/assets/ceramic-display-stand-01/model.js

@@ -0,0 +1,116 @@
+// 暖釉陶瓷展示台：自制程序化候选模型，不依赖 DOM、网络或实验文件。
+// 米制、+Y 向上、+Z 正面；底面中心原点。冻结包络 X±0.4、Y[0,0.9]、Z±0.3。
+// 设计常数（检查按此独立手算）：台板圆角矩形主体 X±0.4/Z±0.3（shape 内收倒角 0.03），
+// 挤出总厚 0.07＝depth 0.062＋两端倒角 0.004，Y[0.83,0.9]，顶面平面区 X±0.37/Z±0.27；
+// 台板收边（浅青灰）X±0.36/Z±0.26、Y[0.800,0.838]，顶面嵌入台板内部避免共面闪纹；
+// 收腰柱身 Lathe 半径 0.118~0.175、Y[0.050,0.845]，两端开口分别埋入底座与收边；
+// 宽底座圆角矩形 X±0.335/Z±0.235（shape 0.33/0.23＋倒角 0.005）、Y[0,0.085]，底面贴地。
+import * as THREE from 'three';
+
+// 釉面粗糙度微变化：缓波纹叠极弱噪点（NoColorSpace，乘在基础 roughness 上），不是砂纸颗粒。
+function glazeRoughness() {
+  const size = 256;
+  const data = new Uint8Array(size * size * 4);
+  let seed = 20260941;
+  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 = 232 + 3.5 * Math.sin(u * 0.021 + Math.cos(v * 0.017) * 1.2) + 2 * Math.sin(v * 0.043 + u * 0.011) + (random() - 0.5) * 3;
+    const i = (v * size + u) * 4;
+    const tone = Math.round(Math.max(0, Math.min(255, wave)));
+    data[i] = data[i + 1] = data[i + 2] = tone; 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;
+}
+
+// 圆角矩形轮廓（本地 XY 平面）：圆角只落在四角，直边保持给定半宽/半深。
+function roundedRect(halfWidth, halfDepth, radius) {
+  const shape = new THREE.Shape();
+  shape.moveTo(-halfWidth + radius, -halfDepth);
+  shape.lineTo(halfWidth - radius, -halfDepth);
+  shape.quadraticCurveTo(halfWidth, -halfDepth, halfWidth, -halfDepth + radius);
+  shape.lineTo(halfWidth, halfDepth - radius);
+  shape.quadraticCurveTo(halfWidth, halfDepth, halfWidth - radius, halfDepth);
+  shape.lineTo(-halfWidth + radius, halfDepth);
+  shape.quadraticCurveTo(-halfWidth, halfDepth, -halfWidth, halfDepth - radius);
+  shape.lineTo(-halfWidth, -halfDepth + radius);
+  shape.quadraticCurveTo(-halfWidth, -halfDepth, -halfWidth + radius, -halfDepth);
+  shape.closePath();
+  return shape;
+}
+
+// 水平板：在本地 XY 画圆角矩形、沿 +Z 挤出，再绕 X 转 -90° 使挤出方向成为 +Y；
+// yBottom 对应挤出几何的 z=0 面（含倒角时是下端倒角外沿）。只创建与放置 mesh，入组由调用方处理。
+function slab(geometry, material, name, yBottom) {
+  const mesh = new THREE.Mesh(geometry, material);
+  mesh.rotation.x = -Math.PI / 2;
+  mesh.position.y = yBottom;
+  mesh.name = name;
+  mesh.castShadow = mesh.receiveShadow = true;
+  return mesh;
+}
+
+export function createCeramicDisplayStand() {
+  const group = new THREE.Group();
+  group.name = 'ceramic-display-stand-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());
+    // 暖白象牙釉：柔和高光（clearcoat）叠很弱的粗糙度变化；模型自身不创建灯光或环境贴图。
+    const glaze = keep(new THREE.MeshPhysicalMaterial({
+      color: '#efe7da', roughness: 0.17, roughnessMap: rough, metalness: 0,
+      clearcoat: 0.55, clearcoatRoughness: 0.3,
+    }));
+    const trim = keep(new THREE.MeshPhysicalMaterial({
+      color: '#b6c3be', roughness: 0.38, roughnessMap: rough, metalness: 0,
+      clearcoat: 0.3, clearcoatRoughness: 0.45,
+    }));
+    const add = (geometry, material, name, yBottom) => group.add(slab(keep(geometry), material, name, yBottom));
+
+    // 厚台板：shape 内收 0.03 让倒角后的主体恰为 X±0.4/Z±0.3；顶面（Y=0.9）平面区 X±0.37/Z±0.27，
+    // 完整覆盖承载矩形 X±0.32/Z±0.22，九点采样不会命中倒角斜面。
+    const TOP = { depth: 0.062, bevel: 0.004, top: 0.9 };
+    add(new THREE.ExtrudeGeometry(
+      roundedRect(0.37, 0.27, 0.05),
+      { depth: TOP.depth, bevelEnabled: true, bevelThickness: TOP.bevel, bevelSize: 0.03, bevelSegments: 3, curveSegments: 12 },
+    ), glaze, '厚台板', TOP.top - TOP.depth - TOP.bevel);
+
+    // 台板收边：浅青灰整板，四壁环绕形成台板下的一圈收边；顶面 Y=0.838 嵌入台板主体（不共面）。
+    add(new THREE.ExtrudeGeometry(roundedRect(0.36, 0.26, 0.04), { depth: 0.038, bevelEnabled: false, curveSegments: 12 }), trim, '台板收边', 0.800);
+
+    // 中央收腰柱身：Lathe 旋转体轮廓，底部展宽、腰部收细、顶部微扩托住收边；
+    // 两端开口分别埋入底座（顶 0.085）与收边板（0.800~0.838）内部，外部看不到开口。
+    const profile = [
+      [0.150, 0.050], [0.150, 0.090], [0.175, 0.160], [0.150, 0.300],
+      [0.118, 0.440], [0.118, 0.560], [0.150, 0.700], [0.172, 0.800], [0.172, 0.845],
+    ].map(([radius, height]) => new THREE.Vector2(radius, height));
+    // Lathe 旋转体本身绕 Y 直立，直接放置，不做水平板的转轴处理。
+    const column = new THREE.Mesh(keep(new THREE.LatheGeometry(profile, 40)), glaze);
+    column.name = '收腰柱身'; column.castShadow = column.receiveShadow = true;
+    group.add(column);
+
+    // 较宽低底座：圆角矩形厚板，底面 Y=0 落地，顶面 0.085 与柱身嵌接。
+    const BASE = { depth: 0.075, bevel: 0.005 };
+    add(new THREE.ExtrudeGeometry(
+      roundedRect(0.33, 0.23, 0.06),
+      { depth: BASE.depth, bevelEnabled: true, bevelThickness: BASE.bevel, bevelSize: 0.005, bevelSegments: 2, curveSegments: 12 },
+    ), glaze, '宽底座', BASE.bevel);
+
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/ceramic-floor-lamp-01/asset.json

@@ -0,0 +1,61 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "ceramic-floor-lamp-01",
+  "name": "暖釉落地阅读灯",
+  "category": "floor-lamp",
+  "description": "低圆暖白釉面底座连接黄铜立杆、支架和灯座，双壁暖白布罩带厚口沿及上下开口，罩内固定暖亮灯泡。宽深不超过0.48、高不超过1.65米；按+Z为统一正面，仅地面放置。静态自发光外观，不实际照亮周围，不支持灯光开关，无承载面。",
+  "styleIds": [
+    "ceramic"
+  ],
+  "modelRef": "ceramic-floor-lamp-01",
+  "previewRef": "assets/ceramic-floor-lamp-01/preview.webp",
+  "placeholder": false,
+  "bounds": {
+    "minX": -0.24,
+    "maxX": 0.24,
+    "minY": 0,
+    "maxY": 1.65,
+    "minZ": -0.24,
+    "maxZ": 0.24
+  },
+  "placement": {
+    "allowedKinds": [
+      "floor"
+    ],
+    "allowedYawDeg": [
+      0,
+      90,
+      180,
+      270
+    ]
+  },
+  "clearanceBoxes": [
+    {
+      "name": "正面接近操作区",
+      "bounds": {
+        "minX": -0.34,
+        "maxX": 0.34,
+        "minY": 0,
+        "maxY": 1.9,
+        "minZ": 0.24,
+        "maxZ": 1.2
+      }
+    }
+  ],
+  "approachPoint": {
+    "x": 0,
+    "z": 0.85
+  },
+  "surfaces": [],
+  "capabilities": [],
+  "recommendations": {
+    "note": "适合温暖阅读休憩房，与蜂蜜木书桌、书架、奶油布料及暖白陶瓷搭配；风格只是软推荐，混搭允许，摆放以空间和类别校验为准。"
+  },
+  "source": {
+    "origin": "自制",
+    "license": "MIT",
+    "note": "自制Three.js程序化实体几何，无外部模型或贴图；有木面者使用固定种子DataTexture。"
+  }
+}

package/web/assets/furniture/assets/ceramic-floor-lamp-01/model.js

@@ -0,0 +1,56 @@
+// 自制阅读休憩家具。米制、+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;
+}
+export function createCeramicFloorLamp() {
+  const group = new THREE.Group(); group.name = 'ceramic-floor-lamp-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 cream = material({ color: '#eee4cf', roughness: 0.92 });
+    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);
+    add(new THREE.CylinderGeometry(0.185, 0.215, 0.085, 40), glaze, 0, 0.0425, 0, '釉面低圆底座');
+    add(new THREE.CylinderGeometry(0.018, 0.018, 1.355, 16), brass, 0, 0.7575, 0, '黄铜立杆');
+    add(new THREE.CylinderGeometry(0.035, 0.032, 0.08, 20), brass, 0, 1.39, 0, '杆端灯座');
+    const bulbMat = material({ color: '#fff1cf', emissive: '#ffcf80', emissiveIntensity: 0.45, roughness: 0.5 });
+    const bulb = add(new THREE.SphereGeometry(1, 20, 12), bulbMat, 0, 1.465, 0, '固定暖亮灯泡'); bulb.scale.set(0.045, 0.065, 0.045);
+    // Lathe环剖面绕一圈：外壁上行、顶口沿、内壁下行、底口沿，中央上下真正开口。
+    const profile = [[0.235,1.28],[0.158,1.65],[0.148,1.65],[0.225,1.28],[0.235,1.28]];
+    add(new THREE.LatheGeometry(profile.map(([r,y]) => new THREE.Vector2(r,y)), 48), cream, 0, 0, 0, '双壁开口厚布灯罩');
+    // 三个真实径向支架位于下口平面，穿入罩的厚口沿与中心杆端。
+    for (let i = 0; i < 3; i++) {
+      const angle = i * Math.PI * 2 / 3;
+      const a = new THREE.Vector3(0, 1.285, 0), b = new THREE.Vector3(Math.cos(angle)*0.232, 1.285, Math.sin(angle)*0.232);
+      const delta = b.clone().sub(a);
+      const support = add(new THREE.CylinderGeometry(0.004,0.004,delta.length(),10),brass,(a.x+b.x)/2,1.285,(a.z+b.z)/2,'径向灯罩支架');
+      support.quaternion.setFromUnitVectors(new THREE.Vector3(0,1,0),delta.normalize());
+    }
+    return { group, dispose };
+  } catch (error) { dispose(); throw error; }
+}

package/web/assets/furniture/assets/ceramic-low-cabinet-01/asset.json

@@ -0,0 +1,81 @@
+{
+  "schemaVersion": 1,
+  "assetVersion": 1,
+  "status": "internal",
+  "assetId": "ceramic-low-cabinet-01",
+  "name": "暖白双门矮柜",
+  "category": "cabinet",
+  "description": "暖白半哑光完整柜体、浅木厚顶板、两扇关闭柜门与黄铜小把手。宽1.10、深0.56、高0.85米；+Z为双门正面。柜顶陈列区平整，可承载台灯、花瓶、盆栽、摆件；点击可打开已绑定的资料集合，不是开柜门或抽屉动画。",
+  "styleIds": [
+    "ceramic"
+  ],
+  "modelRef": "ceramic-low-cabinet-01",
+  "previewRef": "assets/ceramic-low-cabinet-01/preview.webp",
+  "placeholder": false,
+  "bounds": {
+    "minX": -0.55,
+    "maxX": 0.55,
+    "minY": 0,
+    "maxY": 0.85,
+    "minZ": -0.28,
+    "maxZ": 0.28
+  },
+  "placement": {
+    "allowedKinds": [
+      "floor"
+    ],
+    "allowedYawDeg": [
+      0,
+      90,
+      180,
+      270
+    ]
+  },
+  "clearanceBoxes": [
+    {
+      "name": "正面接近操作区",
+      "bounds": {
+        "minX": -0.65,
+        "maxX": 0.65,
+        "minY": 0,
+        "maxY": 1.9,
+        "minZ": 0.28,
+        "maxZ": 1.3
+      }
+    }
+  ],
+  "approachPoint": {
+    "x": 0,
+    "z": 0.9
+  },
+  "surfaces": [
+    {
+      "surfaceId": "cabinet-top",
+      "name": "矮柜顶部陈列区",
+      "rect": {
+        "minX": -0.48,
+        "maxX": 0.48,
+        "minZ": -0.21,
+        "maxZ": 0.21
+      },
+      "y": 0.85,
+      "allowedCategories": [
+        "lamp",
+        "vase",
+        "plant",
+        "ornament"
+      ]
+    }
+  ],
+  "capabilities": [
+    "open-document-collection"
+  ],
+  "recommendations": {
+    "note": "适合温暖阅读休憩房，与蜂蜜木书桌、书架、奶油布料及暖白陶瓷搭配；风格只是软推荐，混搭允许，摆放以空间和类别校验为准。"
+  },
+  "source": {
+    "origin": "自制",
+    "license": "MIT",
+    "note": "自制Three.js程序化实体几何，无外部模型或贴图；有木面者使用固定种子DataTexture。"
+  }
+}