house-plan-designer:把一张户型图还原成可交互的装修设计器网页
ZWD11 在 GitHub 开源的 Agent Skill(MIT):把户型图或 CAD 图纸还原成单文件装修设计器,含 2D/3D、家具与水电自动排布。
Skill 资料
npx skills add ZWD11/house-plan-designer --skill house-plan-designer
装修前最卡人的,往往是第一步:把一张户型图变成能拖着摆家具、能看 3D、还能算钱的东西。house-plan-designer 是 ZWD11 在 GitHub 以 MIT 许可开源的 Agent Skill。装上以后,Claude Code 等支持 Skill 的智能体会读懂户型图或 CAD 图纸,写出一份户型描述,交付一个双击就能离线打开的单文件 HTML 设计器,初始户型就是你给的那张图。
它让智能体按什么顺序做事
SKILL.md 规定的顺序不能乱。开工前,智能体先列出待确认清单:图上每件家具要不要一比一还原,电梯厅、管井这类公共区域还原不还原,图上没标的层高和楼板厚度按什么估。接着按输入选识别路线:彩色户型图和截图走图像分析,矢量 PDF 与 DXF 直接读取图元坐标,原图加装修布置图则按同一道尺寸链对位。
户型描述要用 Python 脚本生成,不手写 JSON。生成后,无头浏览器检查房间是否闭合、墙体有没有悬空、门窗有没有被丢掉,并把每道尺寸链和图纸对一遍。交付前还要过墙体、尺寸链和家具摆放三项对账;报告里的错误和警告必须清零,才会把 HTML、压缩包、对账结果和待确认清单一起交给用户。
它约束了什么
- 待确认不硬猜:图上没有任何尺寸时,智能体要向用户要一个已知长度,或按常见尺寸估算并注明。拿不准的承重墙、估算的层高和看不出窗台高的玻璃,写成批注,打开设计器即可在「批注」页逐条看到。
- 只改描述,不改模板:
assets/template.html就是设计器本体,SKILL.md 要求不改,所有修正都落在户型描述里。 - 水电是规划稿:插座、照明、网线、冷热水和排水由程序按常见国标做法自动排布。README 写明它服务于装修前的规划与沟通,正式施工仍要以现行规范原文和电工、设计师的核算为准。
- 导出的 DXF 不可参数化:导出的是普通 CAD 图元,带图层、标注和编组。在 CAD 里拖动一段墙,不会带动相接的墙;要改,回设计器改完再导出。
适合谁
适合手上已有户型图、想尽快拿到可交互草案的设计师、装修公司和业主。项目 2026-10-06 建库,截至 2026-11-09 有 477 颗星,README 的更新记录一直写到当天。作者在 README 里记录了一组实测:套内 1019 平方米的办公培训层,按装修公司的布置图 DXF 还原,摆了 460 件家具和 118 座阶梯培训厅;160 条墙尺寸标注中有 109 条与模型偏差在 5 毫米以内。这些数字来自作者,编辑部没有复现,本文依据仓库的 README 与 SKILL.md 核对。
门槛不低。需要装 numpy、pillow、opencv-python、pymupdf、ezdxf、pypdf,以及 Node 依赖;浏览器要用本机已有的 Chrome、Edge 或 Chromium,或另装 Playwright 的浏览器。没有显卡也能生成,只是验收会进入慢速模式;作者估计完整功能验收约 20 分钟。
识别质量还取决于智能体读图的能力。作者说明,纯线稿、扫描件和拍歪的照片,自动初稿会很差,主要靠智能体按尺寸推算。仓库描述里还写明,想达到满血效果,不建议用豆包等大模型。DWG 要先另存为 DXF,或导出 SVG。库里没有的异形家具,可以在自由造型工作台里画,或导入 GLB 模型;想从照片或提示词在本地生成单个 3D 模型,可以看 Modly。如果要的是 iPhone 扫描房间后重建场景,3d-model-anything 走的是另一条路线。