OPEN SOURCE DEEP DIVE
户型图设计器:把平面图还原成可编辑装修设计器
将户型图、扫描件、CAD 截图、矢量 PDF 与 DXF 还原为毫米级可编辑户型,并自动对账墙体、尺寸、门窗与家具,输出离线装修设计器。
这个开源项目解决的是一个很具体的问题:用户手里只有一份户型图、扫描件、CAD 截图、矢量 PDF 或装修公司的整套布置图,却要在短时间内得到一个能继续编辑、能在三维里检查、还能输出施工资料的装修工作区。它不是把图片贴进一个三维查看器,而是让智能体先读图,再把墙体、门窗、房间、家具、材料和水电点位转成结构化的毫米制数据,最后封装成一个可直接打开的单文件网页。
输入先归一到可核验的几何
仓库把输入分成多条识别路线,而不是用一套固定流程处理所有图纸。彩色户型图和扫描件走图像识别,程序从像素中提取墙体,再利用尺寸标注确定每一段的比例。黑底 CAD 截图先按线色拆分图层,找出轴号和轴线,再根据轴线尺寸建立像素与毫米之间的关系。矢量 PDF 和 DXF 则直接读取图元坐标,避免截图分辨率带来的二次误差。两张图同时出现时,结构以原始户型图为准,家具和改造以装修布置图为准,通过尺寸链把两张图对到同一个坐标系。
对于整栋住宅,项目会先切分楼层,再分别识别每层的墙、门窗、楼梯和楼板开洞。对于装修公司提供的整套 DXF,预处理会展开嵌套图块、修复中文乱码,并裁出平面布置图这一张。随后清点家具图块、文字、门弧和尺寸标注,保留图块自身的插入角度与镜像关系来恢复家具朝向。这个设计表明项目关注的不是单个户型模板,而是不同图纸来源之间可解释的转换过程。
所有能力都落在同一份户型描述上
系统的中心是一份名为 HouseSpec 的户型描述。坐标统一使用毫米,横轴向右、纵轴向下,墙用中心线表示,墙厚、承重属性、齐平方向和门窗洞口分别记录。门窗不是画在墙上的装饰线,而是绑定到具体墙段和洞口区间的结构数据;房间用落在封闭区域内的标签点命名,地面材质、墙面材质与吊顶做法也由同一个区域对象承载。
家具、结构构件、电气点位、给排水点位、管线、梁和局部吊顶分别拥有独立的字段。家具使用类型、中心点、朝向和尺寸描述,定制橱柜还把柜体形状、台面、水槽和灶台参数拆开。底图可以以毫米比例和原点叠回模型,因此编辑结果始终能与原图对照。这种字段划分让二维平面、三维模型、算量报价和导出文件共享同一事实来源,减少了多套数据彼此漂移的机会。
识别之后还有三轮对账
项目没有把“识别出墙体”当成完成。生成网页后,无头浏览器会检查房间是否闭合、墙端是否悬空、门窗是否丢失,并把外围尺寸和房间开间、进深与图纸标注逐项比较。偏差超过阈值会进入报告,图纸自身前后矛盾的尺寸则单独列为冲突,避免把原图错误误判成模型错误。
墙体审计沿每段墙每隔一百五十毫米切一条剖面,在原图中统计墙厚范围内的线条数量,再与模型中的墙、窗、玻璃和洞口状态对比。墙边家具会先被遮掉,避免衣柜或床头板干扰判断。家具审计把模型外框和朝向箭头叠回设计图,逐件检查类型、位置、尺寸和朝向;设计器内部还会检查家具重叠、挡门、通道宽度、高柜挡窗和楼梯净高等问题。这些检查共同组成了从原图到模型的证据闭环,而不只是视觉上看起来相似。
生成物是一套可操作的离线工作区
仓库把设计器模板与户型数据分离。模板承担界面、模型库、编辑器和渲染器,智能体只负责生成准确的户型描述并注入模板。最终产物是一个单文件网页,双击即可离线打开。用户可以在二维平面上改墙、拆墙、调整门窗和房间材质,也可以进入三维鸟瞰、第一人称漫游或全景视图检查空间关系。
工作区包含布置、水电、顶面、铺装和拆改等图层。家具库覆盖住宅、办公、商业和户外场景,支持按图替换、改宽深高和一键切换风格。装修部分提供橱柜、衣柜、浴室柜等参数化定制,吊顶可配置边吊、叠级、悬浮、铝扣板与灯槽,铺砖支持多种规格和排布方式,水电点位可以自动生成后手工修改。项目还实现了一百毫米正交网格上的管线寻路,把强电、照明、弱电、冷热水和排水分别排布,并在三维里按真实高度显示。
输出侧包括平面图、施工图 PDF、报价与材料清单,以及 DXF 图纸。导出的 DXF 使用标准 CAD 图元、图块、图层和尺寸标注,可以被普通 CAD 软件继续打开和编辑,但它不是参数化建筑墙对象。设计师若要让相接墙体联动,仍应回到设计器修改,再重新导出。
仓库给出的精度证据
项目公开列出了一组可供复核的案例。一个一万二千三百四十乘一万一千九百四十毫米的住宅户型,被还原为二十一面墙、八扇门、七扇窗和八个房间,其中八面墙由智能体补全,外轮廓误差为十毫米。矢量结构图中一百零一条尺寸标注读出第一百条,其中九十四条与模型尺寸相差不超过一毫米,另外六条被解释为图纸自身的尺寸冲突。建筑 DXF 回归中,十六个洞口全部往返成功,墙体误差为零。
规模更大的商业楼层案例面积为一千零一十九点四二平方米,包含四百六十件家具和一座一百一十八座的四级阶梯培训厅。原图中四十二扇门全部在模型里找到对应门洞,项目自查为零警告,功能验收与文件导出也全部通过。双图对齐案例的均方根误差分别为四毫米和十三毫米。以上数字来自仓库作者的测试与说明,本次精读没有重新执行全部大模型、浏览器和 CAD 验收,因此应把它们看作项目声明的可复核证据,而不是独立第三方复现结果。
边界与使用风险
位图墙体识别仍可能需要智能体修正,尤其是墙体只靠颜色或线宽区分、图纸分辨率不足、扫描变形或缺少尺寸标注时。像素比例可能来自已知尺寸或人工估计,任何估算都应写进交付说明。基于平行线配对的兜底流程能恢复大部分墙和柱,也可能产生误报。承重属性只能从线型、填充和结构常识推断,面对实际拆改时必须回到原始结构图、房屋档案或结构工程师意见。
水电自动排布是装修前的规划辅助,不替代现行规范原文、专业计算和现场复核。噪声、层高、梁位、管井、进户条件和地方标准都可能改变方案。正确使用方式是把项目输出的模型、截图、尺寸冲突、推断项和待确认清单一起审阅,再由设计或施工人员对其中的结构安全、消防、机电容量与施工可行性负责。这个边界写得越清楚,智能体读图带来的效率才越可靠。