从车库庭院到泳池电梯:house-plan-designer 独栋别墅设计实战

原创2026-11-15 10:21:431,917 阅读

从车库庭院到泳池电梯:house-plan-designer 独栋别墅设计实战

house-plan-designer 是一个把户型图变装修设计器的 Agent Skill:给一张别墅户型图(彩色图、CAD 截图、DXF 均可),一句话「把这张户型图做成装修设计器网页」,Agent 就会把它还原成一个双击即可打开的单文件 HTML——支持 2D 布置、3D 鸟瞰、第一人称漫游、家具家电布置和水电管线自动排布。本文带你走查一栋三层独栋别墅:双车位车库、围墙庭院、泳池、挑空客厅和家用电梯,是如何被一步步建模出来的。

一句话上手:别墅户型图 → 可交互 3D 设计器

把仓库放进 Agent 的 skills 目录并装好依赖即可:

git clone https://gitcode.com/gh_mirrors/ho/house-plan-designer
pip install numpy pillow opencv-python pymupdf ezdxf pypdf

然后附上别墅图纸,告诉 Agent「把这张别墅户型图做成装修设计器网页」。想顺带提要求也行,比如「车库做双车位」「客厅要挑空」「泳池放在后院」,Agent 都会写进方案。Agent 的完整工作流程见 SKILL.md。

图纸怎么读:别墅特有的 6 类符号

公寓图之外,别墅图还会多出车库、庭院、泳池这类室外空间,以及挑空、电梯这类垂直空间。Agent 先按 reference/route-villa.md 的别墅识别规则,整理出一份「图上符号 → 建模」清单:

图上符号 识别依据 建模结果
外墙 2.4~6 m 宽的大洞口 标「车库 / 车位」,常画粗线门板 电动卷帘门(garage),3D 里点一下卷起 / 放下
主楼外围一圈细墙线 标「庭院 / 花园」,墙厚 150~240 1.2~1.8 m 围墙 + 车道口 / 人行门 + 庭院大门
蓝色或水波线矩形 标「泳池 / 水池」 泳池 pool,长边方向可旋转
上层客厅上方的斜线 标「挑空 / 上空」 楼板开洞 voids + 栏板,可挂水晶吊灯
楼梯旁约 1.5×1.5 m 小井道 标「电梯」 家用电梯 elevator,漫游里能真坐上去
院子里虚线矩形 + 角柱 标「车棚 / 车位」 车棚 carport / carport2,底下再放一辆车

墙体位置一律按图上尺寸标注逐段定位到毫米;CAD 图纸的画法、承重判定规则在 reference/cad-conventions.md。三层别墅的完整生成脚本示例:reference/example-gen-villa.py。

house-plan-designer 独栋别墅 3D 沙盘效果图:三层主楼带车库、庭院围墙、泳池和凉亭

车库与庭院:从卷帘门到泳池

🚗 车库:外墙大洞口写成 garage(example-gen-villa.py#L49),2D 画门板 + 卷帘箱虚线,3D 里门板能卷进门头、中控能开关;地面用环氧地坪(epoxy),两辆车车头朝里停放,壁挂充电桩 evCharger 挂在车头正对的墙上,储物架、工具台靠侧墙。

🏡 庭院:围墙用 low() 写法只砌到 1.5 m 高,车道口和人行门留通高洞口,再在洞口上放 gate;草坪、汀步、凉亭、烧烤台、水景景墙、草坪灯都在「别墅 · 庭院」家具库里。这里有个关键细节:院子必须被围墙 + 主楼外墙完整围住,否则会被识别成室外——没有地面、不布水电。

挑空与电梯:垂直空间不穿模

  • 挑空客厅:二层楼板在客厅上方写 voids 开洞,四周用 1.1 m 栏板围住;水晶大吊灯 chandelier 挂在二层顶面、垂进客厅。
  • 电梯:每层同一位置放 elevator,上层井道标记 "shaft": true;漫游时楼梯和电梯都能真走、真坐,扶手和栏板会挡住你。
  • 楼梯:U 形三跑 stairU,2D 也按国标楼梯画法画(剖切面以下实线、45° 折断线、以上虚线)。

交付前 walktest.mjs 会按预设路线把楼梯、电梯、各层门洞真实走一遍,验证脚高、楼层和是否被挡,走不通就改,直到全通。

交付前自查:叠图对账 + 水电审计

生成的设计器不是「看图说话」就完事:wallaudit.py 沿每段墙横切原图核对墙厚和洞口,每道尺寸链逐刻度对账,家具逐件叠图核对;2D 结果还会半透明叠回原户型图,直接目测比对:

house-plan-designer 别墅设计器叠图自查:建模结果半透明叠加回原户型图比对尺寸

水电一键布置:别墅专属规则 ⚡

每层写上 "autoElec": true,设计器就自动布好全屋水电点位和管线。别墅有几条额外规则:

  • 分层配电:总箱在入户层,二三层各自在楼梯口旁放配电箱,干线自动计算;
  • 充电桩独立回路:每个车位一个 socketEV,7 kW 交流桩单独一路(BV 6 mm²、C32 30 mA 漏保),规则依据见 reference/mep-rules.md;
  • 车库双控:进屋门和车库门两处双控开关,卷帘门电机插座留在门头上方,灯按面积排;
  • 庭院 / 露台:沿围墙装壁灯,留防水插座和取水点(浇花、洗车)。

house-plan-designer 别墅水电管线自动排布 2D 平面图:回路分层、横平竖直走线

夜景开灯与智能中控:住进去之前先「住一遍」

🌙 一键开灯,整栋三层同时亮——车库灯、庭院壁灯和草坪灯、泳池边的灯都在真实发光,先看看夜里回家是什么感觉:

house-plan-designer 独栋别墅夜景效果图:一键开灯三层同时亮起,庭院壁灯与泳池照明点亮

智能中控:3D 视图里点「🏠 智能中控」,墙变半透明,灯光 / 环境 / 设备 / 扫地机 / 安防的图标浮在模型上,点开就是控制卡片——灯调色温、窗帘开合、空调出风、扫地机按栅格避障扫楼。它是入住前的预演:灯放哪、窗帘怎么配、扫地机能不能扫到每个角落,先用一遍再说。

house-plan-designer 别墅智能中控 3D 鸟瞰:灯光设备图标浮在模型上,车库与庭院同屏显示

漫游与光线追踪出图

第一人称漫游可以走楼梯、坐电梯、在开关前按空格开灯,视高(儿童 / 成人 / 高个)和视距都能调:

house-plan-designer 别墅第一人称漫游:视高视距可调的 3D 室内视角

要拿给客户看的效果图,选「光线追踪」出图即可,1920×1080、512 采样,核显上约 3 分半钟:

house-plan-designer 光线追踪渲染的别墅室内效果图:真实光影与材质

动手前的三样参考 📚

⚠️ 小提示:想达到满血效果,建议使用代码与多文件理解能力较强的大模型,不推荐豆包等大模型。

登录后查看全文
house-plan-designer