3d-prompt-forge 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# 3d-prompt-forge — 3D 建模提示词炼成器
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+AI agent skill: 用户给你图片和一句模糊的愿望，你还给他一份精确到可以直接开工的九段式建模提示词 + 量化《建造规格表》。
+
+五步流程：输入盘点 → 缺口拷问 → 按模板起草 → 草稿过目（含 3D 可实现性问答）→ 定稿交付（提示词 + 建造规格表两件套）。
+
+用法：将 `SKILL.md` 与 `references/` 安装到你的 agent 技能目录（如 Claude Code 的 `.agents/skills/3d-prompt-forge/`）。搭配 `3d-scene-forge`（建造侧验收闭环）使用效果最佳。

package/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: 3d-prompt-forge
+description: >
+  3D 建模提示词炼成器：把用户的图片 + 想要的 3D 模型/场景描述，炼成一份结构化、
+  可直接喂给 3D 建模流程的九段式提示词。凡用户发来图片并表达"想要一个 3D 模型/场景/微缩景观/
+  照着这个做"之类的意图，或提到"建模提示词、3D 提示词、微缩场景提示词、提示词炼成、
+  photo to 3D prompt"，即使没说"提示词"三个字也应触发。先读图、再按缺口拷问用户、
+  确认后产出定稿提示词。
+---
+
+# 3d-prompt-forge —— 3D 建模提示词炼成器
+
+**一句话**：用户给你图片和一句模糊的愿望，你还给他一份精确到可以直接开工的建模提示词。
+
+核心思想：图片提供"气质与素材"，描述提供"意图与清单"，但两者的交集永远缺东西——
+视角没说、尺度没定、动效没提、禁忌没写。这些缺口靠**问用户**补齐，而不是靠模型脑补。
+产出遵循九段式结构（源自实战验证过的黄金范例），让下游建模流程拿到的每一份提示词
+都同样精确、同样克制、同样可执行。
+
+## 角色分工
+
+用户是**甲方**：出图片、出愿望、回答拷问、验收定稿。
+你是**炼金术士**：读图、盘点、提问、起草、收敛。不许脑补甲方没说的关键决策。
+
+## 流程（五步，一步都不跳）
+
+### A. 输入盘点
+
+1. **逐张 Read 用户图片**，每张记下五件事：主体是什么、渲染/绘画风格、配色倾向、
+   时间与光线氛围、有哪些可搬进 3D 场景的元素（道具/材质/构图关系）。
+2. **读文字描述**，对照九段模板逐段判断：哪些维度已明确、哪些缺失。产出两张清单：
+   - ✅ 已明确（如"微缩场景""盛夏黄昏""无 UI"）
+   - ❓ 缺口（如"视角未说""主体清单不完整""动效未知""禁忌未知"）
+3. **图与文字冲突时**（如图片是雪夜、文字说盛夏），不要擅自取舍——列出冲突点问用户。
+
+### B. 缺口拷问
+
+- **只问缺口**。已明确的维度不重复问。每批 ≤4 问（AskUserQuestion），通常 1-2 批收齐。
+- **三个维度无论是否缺失都要问**（固定兜底）：
+  ①观察视角与观看方式（环绕/固定/第一人称）②避免清单（人物？写实度？真实品牌？UI？）
+  ③品牌与文字策略（原创名？风格化文字？哪种语言？）
+- **第四兜底：量化与形制（question-bank ⑪ 组）**——主体占比、动态动词的形制选项
+  （斜靠/掀开/升腾各给 2-3 个具体形制）、画面明暗基调。这些答案会转成 3D 建造侧的
+  数字验收线：不问清楚，建造侧每项平均烧 2-3 轮验收（实战教训）。
+- 现成问句从 `references/question-bank.md` 取，按题材挑维度，不要照单全问。
+- 提问前先复述一句你的理解（"我理解你想要……，还差这几点"），让用户能纠正方向。
+
+### C. 按模板起草
+
+- 先读 `references/prompt-template.md`：**九段骨架固定，中段三节按题材换形**——
+  微缩场景 / 角色 / 道具与建筑，三种形态各有中段模板与黄金例句。
+- 微缩场景题材的黄金范例（便利店街角）全文在模板文件末尾，**起草前先对照它校准
+  详略、口吻与克制度**——它是"好答案"的定义。
+- 起草时逐条执行模板里的"写作守则"（具象名词+数量词、意象色名、低幅动效、避免清单必填……）。
+
+### D. 草稿过目
+
+- 全文给用户看，明确说"这是草稿，指出任何想改的段落"。
+- **3D 可实现性问答**（过目时一并做）：扫描草稿里的动态动词（斜靠/掀开/翻起/
+  悬挂/滴落/倚靠…），每个给用户 2-3 个具体形制选项（10 秒选择题）。文字上一句
+  "斜靠着"在 3D 里是支撑结构，形制没选对，建造侧平均烧 2-3 轮验收。
+- 用户改一句就收敛一句；改结构性的（换题材形态、删整段）回到 C。
+- 通常 1-2 轮收敛。用户说"可以了"即定稿。
+
+### E. 定稿交付（两件套）
+
+- 交付**纯文本提示词**（分段落 + 小节标题，与黄金范例同构），可整段复制使用。
+- **同步产出《建造规格表》**（YAML 量化附录，模板见
+  `references/prompt-template.md` 末尾）：主体/地台占比、关键部件尺寸、物理关系、
+  氛围元素形态参数、量化验收锚点（中位亮度/暗部占比/饱和占比，参考图实测或风格
+  默认值）。这份表由下游 3d-scene-forge 直接消费成机检验收线——没有它，
+  "死黑/过曝/比例不对"类缺陷每项平均烧 2-3 轮。
+- 末尾附一句话：「这份提示词 + 建造规格表可直接调用 3d-scene-forge 技能开建三维场景。」
+  ——只提示，不自动开建。
+
+## 写作铁律（起草与修订时逐条对照）
+
+1. **具象名词 + 数量词**："×3 分类垃圾桶""两盏路灯"，不写"几个垃圾桶"。
+2. **"像…一样"的比喻是风格锚点**："海水在底座边缘收束成半透明树脂般的切面"——
+   每个题材至少 2-3 处这类比喻。
+3. **色彩给意象词**（蜜桃橘、海盐蓝、薄荷绿），不给 hex 色号——意象词下游渲染时更稳。
+4. **动效全部低幅循环**：每个动效 = 动作 + 频率/幅度副词（"缓慢""轻轻""细微""偶尔"），
+   段末总约束句"所有动态循环自然、幅度克制，不破坏……气质"。
+5. **避免清单必填**：负面清单是防跑偏护栏。人物/写实度/真实品牌/乱码/UI/水印/过曝
+   是常见项，按题材裁剪；末尾加一句总括气质句。
+6. **品牌与文字**：必原创 + 风格化文字，明写"不出现真实商标/乱码文字"。
+7. **正向描述优先**：先写要什么，再写不要什么；通篇否定的提示词会让下游无所适从。
+8. **每段克制不堆砌**：一段一个主题；清单可以长，但每项只占一个短语，不展开成句子。
+9. **主体要有"生活痕迹"**：刚有人离开的痕迹（斜靠的冲浪板、随意摆的拖鞋）让场景有生命；
+   角色/道具题材对应"使用磨损/手作感"。
+10. **"一定要有足够丰富的内容"这类强调句要落在信息量最大的段落**（内部细节/核心结构），
+    并跟上具体清单，否则只是空喊。
+11. **动态动词必须配形制、比例必须入规格表**："斜靠着""掀开一角""蒸汽升腾"在
+    3D 里都是支撑结构/几何形态/量化参数——每个动词过一遍 D 步的可实现性问答，
+    答案连同主体占比/部件尺寸/亮度基调写进《建造规格表》。文字上读得通的描述，
+    3D 里可能不可建造或要返工数轮（实战：暖帘深度 0.2↔0.8 摆了 3 轮、伞的支撑
+    方式摆了 5 轮——都是这一条没做）。
+
+## 图片的角色
+
+图片 = **风格 / 元素 / 氛围的参照物**，不是 1:1 复刻指令：
+- 从图里提炼：风格关键词（如"日式青春动画""低多边形"）、配色意象词、可入模的具体元素。
+- 文字描述与图片冲突 → 列出冲突问用户（A3 步）。
+- 用户明确说"严格按图复刻"时才切换为以图为准模式，其余默认融合。
+
+## 无图片时
+
+流程不变，跳过 A1；全部维度走缺口拷问，通常需要 2-3 批提问（B 步放宽到 3 批）。

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "3d-prompt-forge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "3D modeling prompt forge: turn an image + rough description into a structured 9-section modeling prompt with quantified build spec. AI agent skill (3D 建模提示词炼成器).",
+  "keywords": ["ai-agent-skill", "3d", "prompt-engineering", "claude-skills", "agent-skills"],
+  "license": "MIT",
+  "files": ["SKILL.md", "references"]
+}

package/references/buildable-spec.md

@@ -0,0 +1,76 @@
+# 建造规格表（Buildable Spec）——字段定义与实例
+
+> 《建造规格表》是九段提示词的量化姊妹篇。九段给"人与多模态模型"看；
+> 这张表给 3D 建造流程（3d-scene-forge）用——把"读起来对"的描述翻译成
+> "可机检"的数字。来源：雨夜屋台实战（13 轮 Critic 验收）的教训反向提炼：
+> 每个缺失字段都对应过 2-3 轮验收返工。
+
+## 字段定义
+
+### meta
+项目名、定稿日期、提示词版本。规格表与提示词同版本号，改提示词必须同步改表。
+
+### proportions（比例锁定）——hero 构图的最大杠杆
+- `hero_to_base`：主体占基底/画面宽度比。**最先锁定**——0.30 与 0.35 是两幅
+  完全不同的构图，相机怎么摆都救不回来（实战：错定 0.30 被 Critic 连扣 3 轮）。
+- `part_dims[]`：关键部件尺寸，世界单位或相对比。每条注明"到哪/相对什么"
+  （例：暖帘 depth 0.42 = 挂点到底沿；凳台高差 0.35 = 台面高 - 座面高）。
+- 判据：任何两个部件之间的"上下/前后/长短"关系，用户看到成片后会说
+  "不对"的，都必须有数字。
+
+### physics（物理关系）——防"悬浮/穿模/无支点"
+- 每个可动/可倚/可悬挂的道具一条：`{ obj, support, contact[] }`。
+- support 用双支点/悬挂点/靠立面等具体几何语言，不用"斜靠着"三个字。
+- 3D 侧审计对 support 做机检（接触点存在、无穿插）；白名单豁免须注理由。
+
+### fx（氛围元素形态参数）——防"量感错误返工"
+- 蒸汽：类型（交叉平面柱/体积）、层数、宽口径范围、alpha 梯度。
+- 雨：层数/根数/宽度/透明度（远中近三层），风携漂移幅度。
+- 已知坑：纯 sprite 叠堆近景读作"白色实心柱"；圆头亮棒读作"划痕/珠链"。
+
+### acceptance（量化验收线）——防"死黑/过曝"两极摆动
+- 有参考图：对图实测中位亮度、p95、sat>0.7 占比、暗部占比。
+- 无参考图：按基调给风格默认值（深夜暗调中位 ~20 / 雨雾中等 ~49 / 明亮 ~70）。
+- 3D 侧每轮验收截图同口径测量对照，±20% 内合格。
+
+### camera（hero 机位建议）
+- 视角（3/4 俯视/平视/低角度）、大致方位与距离、必须完整入画的元素清单。
+- 注意：**"地台完整入画"与"主体撑满画面"可能几何不可兼得**——先锁
+  proportions.hero_to_base，再谈机位。
+
+## 实例：雨夜屋台拉面摊（2026-10 实战定稿）
+
+```yaml
+meta: { project: 雨夜屋台拉面摊, date: 2026-10-23, prompt_ver: 九段定稿v2 }
+proportions:
+  hero_to_base: 0.35
+  part_dims:
+    - { part: 暖帘, depth: 0.42, note: 挂点2.36到底沿1.94，露出摊主头肩 }
+    - { part: 凳台高差, value: 0.58, note: 站立吧台比例，真实屋台形制 }
+    - { part: 摊车占基底宽, value: 0.35 }
+physics:
+  - { obj: 透明伞, support: 沿搭凳沿+尖落地双支点, contact: [凳2沿] }
+  - { obj: 暖帘左幅, support: 翻过横杆掖进棚内露衬里 }
+  - { obj: 汤勺, support: 手握柄+勺头入锅 }
+fx:
+  steam: { type: 交叉平面柱, layers: 8, width: 0.46-0.88, alpha: 0.5→0.06 }
+  rain:
+    layers: [ {n:520, w:0.005, op:0.15}, {n:180, w:0.008, op:0.22}, {n:24, w:0.011, op:0.18} ]
+    wind_drift: 0.3
+acceptance:
+  median_luma: 49
+  dark_ratio: 0.05
+  sat_ratio: 0.09
+camera:
+  overview: { pos: [7.2, 5.95, 9.2], target: [-0.6, 0.95, -0.45], fov: 42 }
+  must_frame: [地台完整, 摊车, 霓虹灯箱]
+```
+
+## 使用规则
+
+- 字段按需裁剪，但 `proportions.hero_to_base` 与 `acceptance.median_luma`
+  是场景类项目的最小集。
+- 数字来源优先级：用户明确给出 > 参考图实测 > 风格默认值。凡用户没给的，
+  拷问阶段用 question-bank ⑪ 组补问，不要留空。
+- 与 3d-scene-forge 衔接：B0（量化对齐）消费 acceptance；D0（分区契约）
+  消费 proportions/physics；Critic 用它做数字对照与回归判定。

package/references/prompt-template.md

@@ -0,0 +1,161 @@
+# 九段式建模提示词模板
+
+> 九段骨架固定，中段三节按题材换形。起草前先读末尾的黄金范例校准详略与口吻。
+
+## 骨架总览
+
+| 段 | 固定段（所有题材） | 中段（按题材三选一） |
+|---|---|---|
+| 1 | 总览 | — |
+| 2 | 画面风格 | — |
+| 3-7 | — | **形态 A 微缩场景**：底座与构图 / 主体外观 / 环境元素 / 内部细节（或合并） |
+| 3-6 | — | **形态 B 角色**：形象与姿势 / 服饰道具 / 表情与情绪 |
+| 3-6 | — | **形态 C 道具与建筑**：造型与功能 / 结构与材质细节 / 使用痕迹 |
+| 倒数第三 | 时间与氛围 | — |
+| 倒数第二 | 美术风格重点 | — |
+| 倒数第二 | 基础动效 | — |
+| 末段 | 避免出现 | — |
+
+中段节数允许 3-5 节浮动，按题材信息量裁剪；每节一个小节标题。
+
+---
+
+## 各段模板与写作守则
+
+### 第 1 段 总览
+
+一句话定义作品：**题材 + 观察视角 + 整体形态 + 质感定位**，并写明"无 UI"类呈现约束。
+
+> 例：请制作一个盛夏黄昏的海边便利店街角微缩场景，以第三人称环绕视角观察整个场景。……呈现小巧、精致、可收藏的展示级模型质感。
+
+守则：开头即"请制作/请建模"；本段出现"自由拖拽、旋转、缩放"或"无 UI"等观看方式词时
+必须与用户确认过的视角一致。
+
+### 第 2 段 画面风格
+
+渲染风格类型（三渲二卡通/黏土/低多边形/像素…）+ 氛围基调 + 材质表现 + 色彩倾向 + 光影层次。
+四件事一句话一件，不展开清单。
+
+### 第 3-6 段 中段（按形态）
+
+**形态 A 微缩场景**（范例见文末黄金范例）：
+- 底座与构图：底座形态与边界约束 → 场地分区布局（主次/朝向/视线动线）→ 边缘收束细节 → 远中近景收束物
+- 主体外观：主体逐项清单（数量 + 状态 + 位置关系）→ 生活痕迹 → "不要人物但保留痕迹"式约束
+- 环境元素：周边道具逐项清单 → 远景收束
+- 内部细节（若有可透视内部）："一定要有足够丰富的内容"式强调 + 逐项清单 + 对比关系（如室内暖 vs 室外冷）
+
+**形态 B 角色**：
+- 形象与姿势：体型 Age/比例、姿态动作（精确到重心与手位）
+- 服饰道具：逐件服饰 + 随身道具（材质 + 磨损）
+- 表情与情绪：五官状态 + 情绪复合词（"倔强里带一点疲惫"）
+
+**形态 C 道具与建筑**：
+- 造型与功能：外形轮廓 + 功能部件逐项
+- 结构与材质细节：结构分层 + 每层材质
+- 使用痕迹：磨损/手作感/贴纸标签
+
+### 倒数第三段 时间与氛围
+
+时间点 + 光源状态 → 天空/环境色渐变（意象词序列"由 A、B 过渡到 C 与 D"）→ 空气感/地面反光 →
+情绪复合词（"安静、治愈，带一点怀旧与轻微孤独感"）→ 一个"始终温暖/始终坚定"的情绪锚。
+
+### 倒数第二段 美术风格重点
+
+建模精度 → 描边 → 材质层次清单（哑光塑料/透明树脂/金属玻璃反光，每项一个短语）→
+主色板（意象词 4-5 个）+ 点缀色策略 → 反光与空气感收尾。
+
+### 倒数第二段 基础动效
+
+逐项动效清单：**动作 + 频率/幅度副词**（"缓慢推上""轻轻吹动""偶尔开合""细微涟漪"）；
+段末总约束句："所有动态循环自然、幅度克制，不破坏……（气质定位回指第 1 段）。"
+
+### 末段 避免出现
+
+负面清单（按题材裁剪）：人物/人影、照片级写实、真实品牌标志、乱码文字、UI 按钮或操作面板、
+水印、过曝、脏乱堆砌、过饱和霓虹……收尾一句话总括气质：
+"整体应像……，精致、温暖、小巧，带有恰到好处的生命力。"
+
+---
+
+## 黄金范例（形态 A 微缩场景 · 全文照录，起草前必读校准）
+
+> 请制作一个盛夏黄昏的海边便利店街角微缩场景，以第三人称环绕视角观察整个场景。整体是一个可以自由拖拽、旋转、缩放观看的完整三维微缩模型或小型景观，画面中没有任何 UI 界面元素。所有元素都搭建在一个完整的正方形底座上，构图紧凑、主次清晰、层次丰富，呈现小巧、精致、可收藏的展示级模型质感。
+>
+> 画面风格为三渲二卡通渲染，强调浓厚的日式青春动画氛围，材质表现干净，轮廓线明确，色彩明快柔和，同时具有夏日傍晚特有的暖冷光影层次。
+>
+> 底座与构图： 底座是一整块完整的正方形地台，边缘整齐利落，像一件展示级树脂微缩景观。地台上同时容纳便利店、街角道路、停车位、通向海边的小巷、沙滩与一小段浅海，所有元素都不超出底座范围。海水在底座边缘收束成半透明树脂般的切面，白色浪花像模型涂装一样贴着沙岸。便利店位于视觉中心，正面朝向街角路口；道路在一侧形成明确的转角，另一侧由小巷自然过渡到沙滩。远景用低矮防波堤、消波块和一座迷你灯塔收住视线，让整个底座像一块完整而精致的海边小镇切片。
+>
+> 时间与氛围： 盛夏黄昏，太阳刚刚沉入海平线，天空由蜜桃橘、珊瑚粉过渡到海盐蓝与靛青。便利店亮起温暖明亮的灯光，室外则是清透微凉的蓝调。空气中有海边傍晚的潮气，路面、湿沙和浅水洼泛着微光，映出晚霞、路灯与招牌的颜色。整体气质安静、治愈，带一点夏日黄昏的怀旧与轻微孤独感，但便利店的光始终让人感到温暖。
+>
+> 便利店外观： 便利店具有日式便利店的典型招牌与灯箱，使用原创品牌和风格化假名文字，不出现真实商标。大面积落地玻璃橱窗和自动门让店内陈设一览无余，屋檐雨棚、门口地垫、自动贩卖机、带藤篮的自行车、冲浪板架、沙滩伞、分类垃圾桶、路灯、电线杆、交错电线、路牌、街角护栏、停车位、排水沟、浅水洼、反光斑马线、小巷入口、空调外机和贴满夏日祭与花火大会海报的公告栏一应俱全。停车位里安静停着一辆浅蓝色小货车；店门口斜靠着一块还带着水光的冲浪板，地垫边随意摆着一双沙滩拖鞋。不要人物，但保留这些生活痕迹，让场景像是刚刚有人离开。
+>
+> 海边元素： 店旁小巷通向一小片沙滩和浅海，沙滩上有低矮防波堤、消波块、救生圈、贝壳、海玻璃、通往沙滩的小木阶梯和一把收起的沙滩伞。海浪缓慢推上沙岸，留下细细的白色泡沫线。海平线远处立着一座迷你灯塔，和近处的电线、路灯一起组成安静的海边小镇轮廓。
+>
+> 便利店内部： 室内一定要有足够丰富的内容，并且透过大面积玻璃窗清楚可见。店内灯管和灯箱发出暖白偏暖黄的明亮光线，与室外的蓝调海风形成鲜明对比。整齐排列的货架、饮料柜、便当区、饭团和零食陈列、收银台、冰咖啡机、杂志架、宣传海报、店内灯箱、冰柜、夏季冰淇淋柜、冷饮吧台、地面导视、储物柜和后场门都清晰可见。靠窗位置设置夏日限定陈列区，摆放烟花、蚊香、防晒霜、沙滩玩具和游泳圈。便当与饭团摆放整齐，饮料柜玻璃带着淡淡冷雾，收银台旁的小风扇缓慢转动。室内商品色彩丰富但排布克制，灯光从玻璃内透出，成为整个海边暮色中最温暖的光源。
+>
+> 美术风格重点： 高精细建模、三渲二卡通渲染、清晰描边、干净而简洁的材质层次。整体具有微缩模型的涂装感：哑光塑料、透明树脂海水、细腻的金属与玻璃反光。色彩以海盐蓝、奶油白、蜜桃橘、薄荷绿为主，招牌灯箱与自动贩卖机点缀柔和霓虹色。湿润的浅水洼、斑马线和玻璃表面反射晚霞与灯光，让画面保持通透、清爽，同时保留夏日海边独有的潮湿感与空气感。
+>
+> 基础动效： 海浪持续缓慢地冲刷沙滩，白色泡沫生成又退去；海风轻轻吹动树叶、风铃、遮阳棚、海报边角和电线；空调外机滴下冷凝水，水珠落入浅水洼荡开细微涟漪；自动门偶尔缓慢开合，带出一小片温暖室内光；招牌与灯箱轻微闪烁；冷柜白色冷雾缓缓下沉；店内小风扇慢慢旋转；湿沙、积水和斑马线上的倒影随晚霞轻轻晃动；远处交通信号灯微弱变化，灯塔光束缓慢扫过海面。所有动态循环自然、幅度克制，不破坏微缩模型安静而静止的气质。
+>
+> 避免出现： 人物、人影、照片级写实风格、真实品牌标志、乱码文字、UI 按钮或操作面板、水印、过曝、脏乱堆砌和过饱和霓虹。整体应像一幕被定格下来的日本动画夏日海边街角场景模型，精致、温暖、小巧，带有恰到好处的生命力。
+
+## 从这份范例里学什么（起草时的对照清单）
+
+1. 开头一句覆盖：题材 + 视角 + 观看方式 + 底座 + 质感定位 + 无 UI——六件事一句话。
+2. 每个比喻都在做风格定位："像一件展示级树脂微缩景观""像模型涂装一样贴着沙岸"。
+3. 清单长而不乱：同一节的道具按"空间从近到远/功能同类"排序，一口气排开不换行解释。
+4. 对比结构制造层次："室内暖白 vs 室外蓝调""始终让人感到温暖"是全篇情绪锚。
+5. 动效段每项都是"主语 + 幅度副词 + 动词"，12 项无一重复句式开头。
+6. 避免清单 9 项 + 一句总括气质——负面清单护栏 + 正面气质锚同时收尾。
+
+## 附录：建造规格表（九段提示词的量化姊妹篇，交付时随提示词一起给出）
+
+> 九段提示词给"人与多模态模型"看，《建造规格表》给 3D 建造流程（3d-scene-forge）
+> 用——把提示词里"读起来对"的描述翻译成"可机检"的数字。没有这张表，
+> 比例类/物理类/量化类的描述全靠建造侧猜，每项平均烧 2-3 轮验收。
+
+### 字段定义（按需裁剪，场景类建议全填）
+
+```yaml
+meta:            # 项目名、定稿日期、提示词版本
+proportions:     # 比例锁定（每条都是 Critic 的验收线）
+  hero_to_base: 0.35        # 主体占基底宽度比（hero 构图的最大杠杆，先锁定）
+  part_dims:                # 关键部件尺寸（世界单位或相对比）
+    - { part: 暖帘, depth: 0.42, note: 挂点到底沿 }
+    - { part: 凳台高差, value: 台面-座面 = 0.35 }
+physics:         # 物理关系（3D 侧要建支撑结构）
+  - { obj: 伞, support: 双支点(沿搭凳沿+尖落地), contact: [凳沿] }
+  - { obj: 暖帘左幅, support: 翻过横杆露衬里 }
+fx:              # 氛围元素形态参数
+  steam: { type: 交叉平面柱, layers: 8, width: 0.46-0.88, alpha: 0.5→0.06 }
+  rain:  { layers: [远520/0.15, 中180/0.22, 近24/0.18], wind_drift: 0.3 }
+acceptance:      # 量化验收线（有参考图从图实测，无图用风格默认值）
+  median_luma: 49
+  dark_ratio: 0.05      # luma<0.08 像素占比
+  sat_ratio: 0.09       # sat>0.7 像素占比（防过饱和）
+camera:          # hero 机位建议（视角/高度/距离）
+```
+
+### 实例：雨夜屋台拉面摊（2026-10 实战定稿节选）
+
+```yaml
+proportions:
+  hero_to_base: 0.35        # 摊车占基底宽（错定成 0.30 时 hero 构图被 Critic 连扣 3 轮）
+  part_dims:
+    - { part: 暖帘, depth: 0.42, note: 0.2 太窄 0.8 太深，各挨一轮批 }
+    - { part: 凳台高差, value: 0.58, note: 站立吧台比例，来自真实屋台 }
+physics:
+  - { obj: 透明伞, support: 沿搭凳沿+尖落地双支点 }
+  - { obj: 暖帘左幅, support: 翻过横杆掖进棚内露衬里 }
+acceptance:
+  median_luma: 49           # 从靶图实测；对标前中位只有 13（死黑 6 轮）
+  dark_ratio: 0.05
+  sat_ratio: 0.09
+```
+
+### 使用规则
+
+- 与 3d-scene-forge 衔接：这张表被 scene-forge 的 B0（量化对齐）与 D0（分区契约）
+  直接消费，验收 Critic 拿它做数字对照。
+- 数字来源优先级：用户明确给出 > 参考图实测 > 风格默认值。凡用户没给的，
+  起草时在拷问阶段补问（⑪ 组问句），不要留空。

package/references/question-bank.md

@@ -0,0 +1,79 @@
+# 缺口拷问问题库
+
+> 用法：A 步盘点出缺口清单后，按维度从本库取现成问句，改写成贴合用户题材的具体问法，
+> 用 AskUserQuestion 分批发出（每批 ≤4 问）。**前三个维度是固定兜底，永远要问。**
+
+## 固定兜底三问（永远必问）
+
+### ① 观察视角与观看方式
+- "这个模型你想怎么观看？360° 自由环绕（可拖拽旋转缩放）、固定机位展示，还是第一人称走进去？"
+- "默认打开时镜头停在哪 kind of 角度？正面平视 / 3/4 俯视 / 低角度仰视？"
+
+### ② 避免清单
+- "有什么绝对不要出现的东西？比如：人物或人影？照片级写实？真实品牌标志？画面里的 UI/水印？"
+- "写实度想要多高？卡通/三渲二/黏土，还是写实渲染？"
+- "过曝、脏乱堆砌、过饱和霓虹这类失控风险要不要预先写进禁止项？"
+
+### ③ 品牌与文字策略
+- "场景/道具上的文字（招牌、海报、标签）怎么处理？我可以起一个原创品牌名 + 风格化文字，避免真实商标和乱码。"
+- "文字用什么语言？日文假名/中文/英文/无文字？"
+
+---
+
+## 缺口驱动维度（按 A 步盘点结果选问）
+
+### ④ 底座与尺度（形态 A）
+- "底座要什么形状和尺寸感？正方形/圆形/长条？大约多大于一个手掌？"
+- "底座边缘想怎么收？树脂切面 / 涂装描边 / 木框？"
+- "各分区的占比大概什么关系？主 subject 占几成？"
+
+### ⑤ 时间与氛围
+- "什么时间点？清晨/正午/黄昏/深夜？光源（太阳/灯）处于什么状态？"
+- "情绪基调选一组：安静治愈 / 热闹烟火气 / 孤独疏离 / 神秘悬疑？"
+- "天气如何？晴天/雨后/雾？要不要湿面反光？"
+
+### ⑥ 主体清单补全（主体外观/形象）
+- "主体周围还有哪些道具要一并建模？帮我列全还是你心里有清单？"
+- "主体上有没有'生活痕迹'类细节（磨损/使用感/刚有人离开的痕迹）？"
+
+### ⑦ 环境与远景
+- "远景要不要收束物（灯塔/山影/霓虹天际线）来框住视线？"
+- "环境里要有植被/车辆/其他叙事道具吗？"
+
+### ⑧ 内部细节 / 核心结构
+- "内部（或背面/内部结构）需要建模到什么程度？透过 XX 能看到多少？"
+- "内部最想让人一眼看到的 3-5 样东西是什么？"
+
+### ⑨ 基础动效
+- "需要动效吗？静态展示还是带环境动效？"
+- "动效密度：只挑 2-3 个点睛（如灯光闪烁），还是全套环境动效（水/风/光/机械各来一点）？"
+
+### ⑩ 风格与色彩
+- "渲染风格确认：三渲二卡通 / 黏土 / 低多边形 / 写实 PBR？"
+- "主色板倾向哪些意象色？（比如'蜜桃橘、海盐蓝、薄荷绿'这种说法）"
+- "对比关系要不要？如'室内暖 vs 室外冷''旧物 vs 新漆'。"
+
+### ⑪ 量化与形制（3D 建造规格，答案直接进《建造规格表》）
+
+> 这组问题的答案不是形容词，是能转成数字/几何的建造规格。下游 3d-scene-forge
+> 会把它们写成机检验收线——每个数字都省掉 3D 侧数轮"形制摸索"。
+
+- **占比类**："主体在画面/地台上占多大比例？（如摊车占地台宽 ~35%）"
+  "关键部件的尺寸关系？（如暖帘长度到柜台哪、凳面到台面的高差）"
+- **形制类**（动态动词逐个给选项，10 秒选择题）：
+  - "斜靠类道具（伞/板/车）的支撑方式：双支点（沿搭沿+尖落地）/挂墙/收拢靠立？"
+  - "掀开/翻起类（暖帘角/盖子）：翻过横杆露衬里 / 侧掀半幅 / 静态假掀？"
+  - "蒸汽/烟雾的量感：细缕 / 中柱 / 厚柱？（量感错了 3D 侧要返工）"
+- **量化锚点类**："画面明暗基调：深夜暗调（中位亮度 ~20）/雨雾中等（~49）/明亮（~70）？"
+  "高饱和颜色占比要多还是克制？（饱和像素占比是 3D 侧 bloom/配色的验收线）"
+- **物理关系类**："A 与 B 的接触/悬挂/倚靠关系具体是什么？（3D 侧要建支撑结构，
+  '斜靠着'三个字不够）"
+
+---
+
+## 提问纪律
+
+1. 每批 ≤4 问，先问影响骨架的（题材形态/视角/氛围），再问影响清单的。
+2. 提问前用一句话复述你的理解，让用户有机会整体纠偏。
+3. 用户答了 "随便/你定" 的维度：自己定一版并在草稿里标注"（我替你定了 X，可改）"。
+4. 两批问完还有缺口：带着缺口直接起草，把假设写进草稿让用户在 D 步修——不要无限追问。