从车库庭院到泳池电梯:house-plan-designer 独栋别墅设计实战
从车库庭院到泳池电梯: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。
车库与庭院:从卷帘门到泳池
🚗 车库:外墙大洞口写成 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 结果还会半透明叠回原户型图,直接目测比对:
水电一键布置:别墅专属规则 ⚡
每层写上 "autoElec": true,设计器就自动布好全屋水电点位和管线。别墅有几条额外规则:
- 分层配电:总箱在入户层,二三层各自在楼梯口旁放配电箱,干线自动计算;
- 充电桩独立回路:每个车位一个
socketEV,7 kW 交流桩单独一路(BV 6 mm²、C32 30 mA 漏保),规则依据见 reference/mep-rules.md; - 车库双控:进屋门和车库门两处双控开关,卷帘门电机插座留在门头上方,灯按面积排;
- 庭院 / 露台:沿围墙装壁灯,留防水插座和取水点(浇花、洗车)。
夜景开灯与智能中控:住进去之前先「住一遍」
🌙 一键开灯,整栋三层同时亮——车库灯、庭院壁灯和草坪灯、泳池边的灯都在真实发光,先看看夜里回家是什么感觉:
智能中控:3D 视图里点「🏠 智能中控」,墙变半透明,灯光 / 环境 / 设备 / 扫地机 / 安防的图标浮在模型上,点开就是控制卡片——灯调色温、窗帘开合、空调出风、扫地机按栅格避障扫楼。它是入住前的预演:灯放哪、窗帘怎么配、扫地机能不能扫到每个角落,先用一遍再说。
漫游与光线追踪出图
第一人称漫游可以走楼梯、坐电梯、在开关前按空格开灯,视高(儿童 / 成人 / 高个)和视距都能调:
要拿给客户看的效果图,选「光线追踪」出图即可,1920×1080、512 采样,核显上约 3 分半钟:
动手前的三样参考 📚
- reference/route-villa.md —— 别墅识别规则:楼层、车库、庭院、挑空、电梯、水电
- reference/example-gen-villa.py —— 三层独栋别墅完整生成脚本(双车位车库、泳池、挑空、电梯),配套漫游走查路线 reference/example-walk-route.json
- reference/spec-format.md —— HouseSpec 户型描述格式;reference/delivery.md —— 交付验收清单
⚠️ 小提示:想达到满血效果,建议使用代码与多文件理解能力较强的大模型,不推荐豆包等大模型。






