空间图译 · Spatial Translator
作者：小浣熊肖恩｜版本：2.2.0｜定位：户型图 → 可信效果图（附保真报告）
一、北极星目标
让用户用最少轮次拿到能拿去沟通、且清楚知道哪里不能信的空间效果图。交付物必须同时包含「图」与「保真边界」两件东西；只有图没有边界，是未完成。
边界红线：本技能只产出概念效果图。以下七条为硬规则，违反任一即视为交付不合格。
| # | 红线 | 判定方式 |
|---|---|---|
| 1 | 不得输出无依据的精确尺寸；无强基准必须拒绝 | 检查 refused 与 value_mm 是否并存 |
| 2 | 出图前必须生成并确认保真合同 | confirmed_by_user 必须为 true |
| 3 | 房地产场景必须双标注「效果图」+「仅供参考，以实际交付为准」 | 缺任一即阻断交付 |
| 4 | 房地产场景不得出现风水相关内容 | 出现即阻断 |
| 5 | 多机位核验只报冲突，不自动修复 | auto_fixed 恒为 false |
| 6 | 保真表「明确不承诺」段不得为空 | 为空即阻断交付 |
| 7 | 不得把 AI 效果图表述为可施工依据 | 交付物须含免责句 |
二、何时用 / 何时不用
应该触发：
- 用户上传户型图/平面图，问「改完什么样」「能不能这样改」「出个效果图」。
- 用户已有户型，问单件家具是否放得下、怎么摆好看。
- 设计师要按图出方案图集、要可回溯的空间约束与提示词包。
- 房产/家居运营方要一组合规的户型展示图。
不该触发（命中即停下来说明，不要硬接）：
| 用户诉求 | 为什么不接 | 该去哪 |
|---|---|---|
| 帮我画个户型图 / 画平面图 | 本技能是读图，不是画图 | 制图工具 |
| 这房子值多少钱 / 出个报价 | 涉金额准确性 | 估价与造价能力 |
| 这墙能不能拆 / 承重如何 | 涉结构安全，越界即责任 | 结构专业审图 |
| 帮我改一下这张效果图的天空 | 属图片精修 | 图像编辑能力 |
| 消防怎么报审 | 涉法规合规判断 | 消防报审专业能力 |
三、开工前必须拿到的东西
本技能不提供任何示例素材，素材全部由用户提供。缺料就停下来要，不要凭想象编。
| 素材 | 必要性 | 要求 | 用于 |
|---|---|---|---|
| 户型图 | 必须 | PNG/JPG，短边 ≥1000px，含完整外轮廓 | 全部路径 |
| 尺寸标注 | 路径 A 必须 | 图内含三道尺寸线，或另给尺寸表 | 锚点判定 |
| 风格参考图 | R1.5/R3/R4 必须 | 1–3 张，短边 ≥800px | 风格与材质 |
| 材质参考图 | 可选 | 0–3 张 | 材质细化 |
| 现场照片 | 可选 | 0–5 张 | 核验比对 |
索取分级（关键设计，直接决定 C 端能不能用起来）：
- R1 / R2 快环：只强制户型图。风格用文字预设替代，不因缺参考图卡住用户。
- R1.5 / R3 主环：户型图 + 风格参考图必须齐，否则约束不完整。
- R4 营销：另需品牌视觉素材。
详细字段与不合格处理见 references/material-request.md。
四、工作流
第 0 步 — 路由
读身份与来意，判到五条路径之一。判定树见 references/routing-protocol.md。判不准时只问一个问题（房是否已购），不要连问三四个。
第 1 步 — 素材校验
按路径索取清单核对。缺件进待补状态，说明缺什么、怎么补；不合格按 references/material-request.md 的矩阵处理，不强行走。
第 2 步 — 读图解析
输出房间、开口、动线、面积四项结构化结果，每条带 certainty 与 evidence。
- 判据与失败模式：
references/parse-layout-cases.md、references/parse-failure-cases.md - 需要给多方案时：
references/parse-layout-candidates.md
第 3 步 — 锚点与比例
判三条路径（有标注直接读 / 有先验反解 / 皆无拒绝给尺寸），输出约束集与六项比例指标。
- 判据：
references/anchor-geometry.md - 空间语言与方位表述：
references/anchor-spatial-language.md - 比例公式库：
references/anchor-ratio-formulas.md
无强基准时必须拒绝输出尺寸，只给相对关系。这是本技能最硬的一条纪律。
第 4 步 — 保真合同（出图前）
生成并请用户确认：不可变项、可变项、必须新增项、比例容差、降级预案。
- 模板：
templates/fidelity-contract.md
未确认合同不得出图。 理由：用户在图出来之前接受「这些不能保证」，比事后告知体验好得多，也避免效果图被当成施工依据。
第 5 步 — 提示词合成
按四层结构写入：L1 硬约束（空间关系，违反即报废）→ L2 半约束（机位比例）→ L3 软倾向（风格材质灯光）→ L4 禁止项。
- 四层写法：
references/prompt-four-layers.md - 场景机位预设：
references/prompt-scene-presets.md - 跨引擎改写：
references/prompt-engine-matrix.md
第 6 步 — 逐机位出图
按机位独立出图，单机位失败不影响其他。灯光与材质口径见 references/render-lighting.md、references/render-materials.md；去 AI 味自检见 references/render-deai-checklist.md。
第 7 步 — 多机位核验
六项比对：房间数、开口、橱柜走向、家具品类、动线、比例指标。只报冲突，不自动修复，把裁决权交回用户。返工建议与停止条件见 references/rework-routing.md。
第 8 步 — 分级交付
按速览/标准/交付三档出产物，附三栏保真表、合规声明、（3D 场景）证据集。
- 保真表：
templates/fidelity-report.md - 提示词包：
templates/prompt-pack.md - 方案报告：
templates/plan-report.md - 3D 家具级：
references/render-3d-furniture.md、references/render-3d-placement.md、references/domain-evidence.md
五、输出契约
| 档 | 产物 | 用时 | 只承诺到 |
|---|---|---|---|
| 速览档 | 3 张图 + 一句话结论 + 简版保真 | ≤10 min | L1 关系 |
| 标准档 | 5–8 张图 + 三栏保真表 + 合规声明 | ≤30 min | L1+L2+L5 |
| 交付档 | 全套 + 提示词包 + 方案报告（+3D 白模与证据集） | ≤60 min | 依场景至 L3/L4 |
三栏保真表固定三段：✅ 可以信 / ⚠️ 需回图纸核对 / ⛔ 明确不承诺。第三段不得为空。
六、质量门禁（逐条可勾）
- [ ] 素材齐备度已核，缺件已说明
- [ ] 每条约束都带
certainty与evidence，无空evidence - [ ] 无强基准时已拒绝输出尺寸，未给单点数值
- [ ] 保真合同已生成且
confirmed_by_user = true - [ ] 提示词 L1 在首位，L4 禁止项 ≥2 条
- [ ] 目标引擎已知时已按矩阵改写长度与语法
- [ ] 多机位冲突只报不修，
auto_fixed = false - [ ] 保真表
not_promised非空 - [ ] 房地产场景含「效果图」+「仅供参考」双标注
- [ ] 3D 交付含七张证据集，缺一张不算通过
七、异常处理
| 情况 | 处理 |
|---|---|
| 未给户型图 | 停，给索取清单，不编造房间 |
| 给的不是户型图 | 判 PARSE_ILLEGIBLE，说明原因，不进解析 |
| 图被裁掉一部分 | 只解析可见区，明说右侧/上部读不到 |
| 无尺寸无先验 | 进拒绝态，只给相对关系 |
| 合同未确认 | 阻断出图，报 CONTRACT_UNCONFIRMED |
| 单机位出图失败 | 交付已完成项 + 提示词包，标注未完成 |
| 跨机位矛盾 | 并列展示冲突图，请用户指定以哪张为准 |
| 命中不接范围 | 停下说明边界，指向合适能力 |
八、资源索引（按环节读，不要一次全读）
| 环节 | 读什么 |
|---|---|
| 路由与路径 | references/routing-protocol.md |
| 素材索取 | references/material-request.md |
| 读图 | references/parse-layout-cases.md、references/parse-failure-cases.md、references/parse-layout-candidates.md |
| 锚点 | references/anchor-geometry.md、references/anchor-spatial-language.md、references/anchor-ratio-formulas.md |
| 保真合同 | templates/fidelity-contract.md |
| 提示词 | references/prompt-four-layers.md、references/prompt-scene-presets.md、references/prompt-engine-matrix.md |
| 出图 | references/render-lighting.md、references/render-materials.md、references/render-deai-checklist.md |
| 辅助图（SVG） | references/render-slot-diagram.md（机位示意图 / 保真热力图 / 网格判读） |
| 交互指引 | references/interaction-guidance.md（三句话说明 / 分段进度 / 单机位重绘） |
| 需求问卷 | references/intake-questionnaire.md（R1.5 精简版 / R3·R4 完整版） |
| 3D | references/render-3d-furniture.md、references/render-3d-placement.md、references/domain-contract.md、references/domain-evidence.md |
| 3D 场景构建 | references/render-3d-scene-build.md（七步流水线 + 每步验收断言） |
| 3D 机位与光照 | references/render-camera-lighting.md（8 机位预设 / 室内外切换 / 阴影参数） |
| 3D 缺陷排查 | references/render-defect-catalog.md（16 条四栏对照，按症状速查） |
| 实测案例 | references/render-case-library.md（3 个已跑通案例 + 修正记录） |
| 核验 | references/verify-consistency.md、references/rework-routing.md |
| 交付 | references/grade-fidelity.md、templates/fidelity-report.md、templates/prompt-pack.md、templates/plan-report.md |
| 房地产 | references/scene-realestate.md |
| 术语 | references/glossary.md |
| 接话怎么说 | references/phrasebook.md |
| 本体结构 | references/playbook.md |
| 源材料覆盖 | references/source-map.md |
| PRD 落地审计 | references/prd-implementation-audit.md |
| 脚本 | scripts/ 下 8 个可执行文件，见 scripts/README.md |
| 触发用例 | tests/trigger-cases.md（正向 14 / 反向 12 / 灰区 6，含判定门槛） |
| 数据 | data/furniture-catalog.json（20 类家具规格）、data/layout-candidates.json（候选规则）、data/dataset-registry.json（数据集定义）、data/D-1.json（样本集，当前 3 条）、data/D-2.json（素材集，59 条） |
| 填写样例 | examples/minimal-delivery-sample.md（完整最小交付示例，含关键取舍说明） |
九、脚本与数据
全部脚本仅用 Python 标准库，无第三方依赖。
| 脚本 | 作用 |
|---|---|
scripts/parse_layout.py |
解析结果校验与规整 |
scripts/build_anchor.py |
三路径锚点判定 + 比例指标 |
scripts/build_contract.py |
保真合同生成与校验 |
scripts/compose_prompt.py |
四层提示词装配 + 引擎改写 |
scripts/verify_consistency.py |
六项核验与冲突清单 |
scripts/grade_fidelity.py |
三栏保真表生成与门禁 |
scripts/validate_datasets.py |
数据集分布校验 |
scripts/gen_walls.py |
户型网格 → 墙段生成（门窗洞口/过梁/窗台，含自测 14 项） |
十、触发自检
应触发：「我有张户型图，想看看改完什么样」
应触发：「这个沙发放我家客厅摆得下吗，我有户型图」
不应触发：「帮我画个户型图」（本技能读图不画图）
不应触发：「这面墙能拆吗」（涉结构安全，越界）
