Facade-Grounded Building

本仓库是论文 Facade-Grounded Asset Compilation for Complete Building Generation 的公开代码，聚焦从立面证据到完整建筑资产的编译链：

Important

本项目建立在 AgibotGeneral/MANSION 之上。 建筑室内生成使用基于官方 MANSION f51269480bdf4d3cd79836e2c9d318421bda9bcb 修改的 portable pipeline。请同时引用 MANSION 论文： MANSION: Multi-floor lANguage-to-3D Scene generatIOn for loNg-horizon tasks， Lirong Che, Shuo Wen, Shan Huang, Chuang Wang, Yuzhe Yang, Gregory Dudek, Xueqian Wang, Jian Su, 2026。

@misc{che2026mansionmultifloorlanguageto3dscene,
  title        = {MANSION: Multi-floor lANguage-to-3D Scene generatIOn for loNg-horizon tasks},
  author       = {Lirong Che and Shuo Wen and Shan Huang and Chuang Wang and Yuzhe Yang and Gregory Dudek and Xueqian Wang and Jian Su},
  year         = {2026},
  eprint       = {2603.11554},
  archivePrefix= {arXiv},
  primaryClass = {cs.CV},
  url          = {https://arxiv.org/abs/2603.11554}
}

text / reference image
  -> exterior shell
  -> opening inference
  -> floor inference
  -> MANSION input adaptation
  -> official portable MANSION
  -> Blender asset assembly
  -> L0-L3 evaluation

通用场景生成、World Director、旧版复刻 MANSION 编排和未进入论文实验的 Morphogenesis 不属于本仓库范围。

当前状态

• 无外部服务烟雾测试可运行。
• official portable MANSION 源码已 vendored，并保留 Apache-2.0 许可证与修改说明。
• 完整生成仍需要独立的 MANSION 运行环境、AI2-THOR/Objaverse-THOR 资产、Blender，以及按阶段配置的图像/VLM 服务。
• 仓库不会自动下载模型权重或大型场景资产。

快速安装

需要 Python 3.11 与 uv。

./scripts/bootstrap.ps1
.\.venv\Scripts\facade-grounded-building.exe doctor --profile paper-smoke
.\.venv\Scripts\python.exe -m pytest tests/smoke -q

也可以手动安装：

python -m pip install -e ".[paper-smoke]"
facade-grounded-building doctor --profile paper-smoke
python -m pytest tests/smoke -q

CLI

查看阶段与参数：

facade-grounded-building official-building --help

只验证无需在线服务的阶段契约：

facade-grounded-building doctor --profile paper-smoke

从已有约束运行 official MANSION：

facade-grounded-building official-building "A compact furnished office" \
  --from official_mansion \
  --floor-polygon-json path/to/floor_polygon.json \
  --access-constraints-json path/to/access_constraints.json \
  --floors 1 \
  --official-root path/to/mansion-runtime

--official-root 是 MANSION 独立虚拟环境和运行产物目录，也可用 HOLODECK_MANSION_ROOT 设置。Blender 可通过 --blender-exe 或 BLENDER_EXECUTABLE 指定。

依赖边界

主 Python 环境只承载几何、适配器和评估代码。MANSION 的 AI2-THOR、Objaverse-THOR、Torch 等重量级依赖应安装在独立环境中，避免污染论文烟雾测试环境。详见 docs/INSTALLATION.md。

目录

• holodeck_cli/commands/official_building.py：八阶段建筑编译执行器。
• holodeck_core/opening_detection/：立面开口检测与二维到三维反投影。
• holodeck_core/mansion/：楼层推断、壳体约束和输入适配工具；不包含旧版复刻编排。
• workspace/external/mansion/：基于官方 MANSION 的 portable 适配版本。
• holodeck_core/asset_evaluator/：L0-L3 建筑资产评估。
• experiments/complete_building_benchmark/：论文评估与修复实验入口。
• tests/smoke/：不调用在线模型的公开烟雾测试。
• paper/：论文源码。

论文复现边界

烟雾测试用于证明代码可安装、核心数据契约可执行、几何评估与反投影逻辑可运行；它不等价于完整模型生成复现。完整复现需要第三方资产和服务，版本与准备步骤将在发布清单中单独记录。

引用与许可证

引用信息见 CITATION.cff。项目代码采用 Apache-2.0；第三方组件及修改说明见 THIRD_PARTY_NOTICES.md 和 NOTICE。