户型图设计器 Skill

一张户型图（或一份 CAD 图纸），一句话，Agent 就把它还原成可 2D / 3D 直接设计的装修设计器网页。

把户型图交给 Agent，它会自动量墙、看懂图纸、补全门窗和房间、摆好家具和水电，最后交给你一个双击就能打开的单文件 HTML。 打开就是你的户型：2D 布置、3D 漫游、定制家具、水电 / 吊顶 / 铺装 / 拆改、算量报价、整套施工图，还能导出符合国标的 CAD 图纸（DXF）； 插座、照明、网线、冷热水、排水每一根线、每一根管自动排好，5 类管线分开看、分开导出；写实建模和光线追踪出图。

新：办公 / 培训 / 商业楼层。 装修公司给的整套 CAD 布置图 DXF 也能还原：核心筒、公共卫生间厕位、阶梯培训厅、几百件家具按图块一件件摆好，再和原图逐条对账。

适用于任何支持 Skill 的 Agent（Claude Code 等）。

输入：一张户型图	输出：设计器里的 2D 布置	同一份数据的 3D 鸟瞰

独栋别墅 · 沙盘效果图	晚上一键开灯，三层一起亮	智能中控：分层查看，设备图标浮在 3D 上

商业楼层：1019 ㎡ 办公培训层整层还原	四级台阶培训厅，118 座按图块角度摆	公共卫生间：厕位隔断、小便斗隔板

管线手画 + 纠错，能修的一键修	家具拖边只改宽 / 深，3D 同步	漫游：开关标记，准星对上按空格开灯

家具库：19 个空间、大图浏览	一键整套换风格	漫游视高 / 视距可调

水电管线自动排布（2D）	3D 管线透视：按真实高度走地 / 走顶	光线追踪出图

• 用法
• 能读哪些图
• 办公 / 培训 / 商业楼层（布置图 DXF）
• 它是怎么做到的
• 生成的设计器能做什么
• 水电管线自动排布
• 写实建模与光线追踪
• 导出 CAD 图纸（DXF）
• 实测
• 安装
• 仓库结构
• 整栋楼（多楼层）与楼梯
• 独栋别墅
• 交付验收：每个功能都实际点一遍
• 适用范围与局限
• 更新记录
• 开发：更新设计器模板

对你的 Agent 说：

把这张户型图做成装修设计器网页

再附上户型图（图片、截图、PDF、DXF 都行）。Agent 会按 SKILL.md 的流程工作，最后在图片旁边生成 <户型名>-装修设计器.html，并附上 2D、3D 截图和识别说明（哪些尺寸按标注、哪些按图形量、图纸自己哪里前后矛盾）。

可以顺带提要求，Agent 会写进方案里：

客厅铺 800×800 灰色大板，主卧人字拼木地板；风格要奶油风；城市是杭州
厨房做 L 形橱柜，水槽在窗下；主卧衣柜做到顶

CAD 路线按国标 GB/T 50001 / 50104 和装修图惯例理解画法：涂黑 = 钢筋混凝土 / 承重，砖纹填充 = 新砌墙，两条线 = 隔墙，3~4 条平行线 = 窗，开启弧线 = 平开门（弧心定门轴、弧侧定开向），错开两扇 = 推拉门，空断口 = 门洞，彩色框 = 新开洞口，⊠ = 烟道 / 管井，⊕ = 地漏，45° 斜杠 = 尺寸起止符号。 DXF 还按图层名（WALL / 墙、WINDOW / 窗、DOOR / 门、AXIS / 轴、DIM / 尺寸；家具、洁具、图框、标题栏层排除）、门窗编号（M0921、C1515）、房间名文字、DIMENSION 标注对象识别，中文 \U+XXXX 转义也能读。详见 reference/cad-conventions.md。

尺寸以标注为准：图上有尺寸标注时，cadvec 读出每段标注数字（没有文字层也能读：同一张图同一个数字字形完全一样，按字形聚类再用长度投票“破译”），把所有标注当成刻度间距约束做加权最小二乘，墙面、洞口边吸到对应刻度。图纸自身前后矛盾的标注（分段加起来 ≠ 总尺寸等）会逐条列出。

装修公司给的往往是整套 DXF：原始结构、平面布置、顶面、水电几张图上下排在一个文件里，家具是块套块，中文图层名和文字是 GBK 乱码。SKILL.md「2E 布置图 DXF 路线」按下面的步骤做：

1. 挑出一张：dxf_prepare.py 把块展开、修好乱码，按 CAD 坐标框出“平面布置图”那一张。
2. 清点：dxfinventory.py 列出每个家具块（图层、外框、旋转、镜像、缩略图）、全部文字、门弧线。
3. 按图层认：活动家具、落地到顶柜、悬空吊柜、台面洁具、小便斗隔板、窗帘、吊顶条形风口、完成面、原墙柱 / 新砌墙；门槛石是地面分隔条，不当门。
4. 朝向按图块算：家具朝向取图块的插入角度和镜像，不靠“离哪张桌子近”去猜（阶梯教室椅子坐反就是这么修好的）；门轴和开向从门弧读。
5. 阶梯教室：台阶边线 + 标高建成一级级能走上去的地台，桌椅放在各自那一级上。
6. 逐项对账：dxfaudit.py 把模型和原图逐条比——
   • 墙：模型墙面 ↔ 原图墙线（±40 mm）
   • 门：原图门图层每樘门都要有门洞
   • 家具：原图家具图层的图形都要有模型家具对应，模型里也不能多出原图没有的
   • 尺寸标注：两头落在墙线上的每条标注 ↔ 模型墙面 / 洞口边
   • 每项列出没对上的条目，逐条处理或说明原因

新增的房间类型：核心筒（电梯厅、电梯井、消防楼梯、前室、强弱电间、管井）、公共卫生间（厕位隔断、小便斗隔板）、培训厅、会议室、讨论室、开放工位、前台、茶水间、玻璃幕墙外墙；家具库补了办公、培训、卫浴、设备类家具。 完整示例：reference/example-gen-office-dxf.py（1019 ㎡ 办公培训层：460 件家具、118 座四级阶梯培训厅）。

1. 量墙：矢量图纸用 cadvec.py 直接读坐标；图片用 analyze.py 提取墙体（承重 / 非承重按墙芯颜色聚类，分不开时按厚度猜并标出待确认），找出尺寸线刻度，配合 axismap.py 按标注数字把像素换成毫米。
2. 看懂图纸：Agent 对照原图和带像素标尺的识别图，补全漏掉的墙（被窗打断的墙、很细的隔墙、只画双线的墙），分清门窗类型和开向，认出每个房间，写出户型描述 JSON（格式见 reference/spec-format.md）。
3. 自己检查：build.py 生成网页，check.mjs 用无头浏览器打开，检查房间是否闭合、有没有悬空的墙、门窗是否被丢掉，算出外围三道尺寸和每个房间的开间 × 进深和图上标注逐个对数，并把生成结果半透明叠回原图截图。不对就改，循环到墙墙重合。交付前再用 qa.mjs 把设计器的每个功能实际操作一遍（见交付验收）。
4. 自动布置：按房间功能摆好家具和家电，放上地漏和下水口；户型描述写 "autoElec": true，设计器自动布好全套水电并把开关关联到灯，再跑一遍方案检查（重叠、挡门、通道宽度、马桶坑距……）。

户型与结构

• 画墙、拆墙、改门窗，面积实时重算；墙体转角 / 丁字口按相交墙厚度精确接合，房间面积按墙面精确计算
• 外围三道尺寸、每段墙净长、房间开间 × 进深，改墙后实时重算；左侧可显示原图底图对照
• 门窗 12 种：单开、双开、子母、推拉、折叠、隐形推拉门、门洞；平开、推拉、落地（带护栏）、高窗、飘窗
• 薄墙在直线上接厚墙（隔墙接承重墙、外墙段变薄）时自动让墙面齐平，不会两边各错开半个厚度差；露台女儿墙、楼梯栏板只砌到栏板高

家具与定制

• 家具库（按空间分 19 类、二级按家具类型，290 件 / 158 种）：搜索、9 种风格（现代简约、北欧、新中式、轻奢、日式原木、美式、工业风、奶油风、侘寂），一键把方案里已有的家具整套换成某个风格（腿型、扶手、床头、木色、金属色、面料一起换）；列表单独滚动，左栏可以拖宽，还能开「大图浏览」窗口挑
• 自由模型：方块、圆柱、拱门、弧形墙、格栅、台阶、拉伸体等 17 种造型，画轮廓拉伸，改材质、圆角、倾斜、阵列；可以设成“能站上去”（地台、舞台、台阶）
• 家具改尺寸：拖四边只改宽或深（对边不动），拖四角一起改（Shift 等比）；尺寸牌上点数字直接输入宽 / 深 / 高，拖 ↕ 调高度
• 家具家电种类：各种床、沙发（U 形 / 弧形 / L 形）、餐桌卡座、酒柜展示柜、卫浴洁具、空调热水器油烟机洗碗机、窗帘绿植、健身宠物用品，别墅用的车、充电桩、车棚、泳池、凉亭、台球桌、茶台、桑拿……
• 定制家具参数化（现实里能定做的都能改，冰箱洗衣机等成品家电保持标准尺寸）：
  • 橱柜：一字 / L / U 形、地柜进深、台面高度厚度颜色、水槽和灶台在哪一段的哪个位置和宽度、单双盆、灶眼数、吊柜（高 / 深 / 离地）、油烟机、电器高柜；水槽灶台间距、灶台离墙不足时提示
  • 定制柜：每列宽度和类型（门板 / 抽屉 / 开放格 / 挂衣 / 玻璃门 / 中空 / 上门下抽）、L 形转角柜、顶柜、踢脚、拉手、平开 / 推拉门、一键顶天立地
  • 浴室柜单双盆 / 悬空 / 镜柜，淋浴房方形 / 钻石形 / 弧扇形 / 一字形，中岛水槽 / 灶台 / 吧台出挑
  • 2D、3D、立面图、报价（橱柜按延米、高柜按投影面积）、自动水电点位全部同步

3D 与效果

• 2D 平面、3D 鸟瞰、第一人称漫游、720° 全景；🔒 锁定防误触
• 漫游找东西：附近（没被墙挡住）的开关、插座、小物件头上浮出标记，开关标记随灯亮变色；点标记直接操作，准星对着的按空格操作，T 显示 / 隐藏；视高（儿童 / 成人 / 高个 / 高处）、视距（第一人称 / 近跟随 / 远跟随）、视角都能调
• 灯多的平面里每盏灯都会真的照亮房间（以前只有前 22 盏有真实光源，大平面里很多开关按了不亮）
• 写实建模（不用外部 glb 模型，全部程序生成）：乳胶漆 / 木纹 / 布纹 / 地板细微纹理和凹凸、鼓包软垫带包边、被子褶皱、家具小倒角；漫游有接触阴影、窗户面光源（拉上窗帘房间变暗）、房间反弹光、窗外城市远景，顶面不漏光；光线追踪出图；画质三档（见写实建模与光线追踪）
• 3D 可交互：点墙上的开关开关它关联的灯（双控、调光、三开分路），门能开关、平开窗 / 推拉窗能打开、窗帘能拉、电视能开、台灯能点亮；漫游时门窗窗帘和灯会真实改变室内光影
• 动效平滑：门窗、窗帘（一褶一褶收拢）、灯光淡入淡出、电视、楼层切换都用临界阻尼弹簧推进，起停都缓、中途反向不顿
• 智能中控（3D 视图「🏠 智能中控」，参考 HAbridge 智能家居仪表盘，单层套房和多层都能用）：白色半透明墙、开灯在地面打出光池；问候 / 日期农历 / 日出日落、灯光空调窗帘开启数、室内环境曲线（模拟）；楼层切换和 ALL 爆炸视图；灯光 / 环境 / 设备 / 扫地机 / 安防五类设备图标浮在 3D 上，点开控制卡片——灯的色温亮度和场景、窗帘开合百分比、空调温度模式风速摆风（3D 出风气流）、设备开关、扫地机器人（栅格避障不穿模、关门进不去、受阻绕行、低电量回充充满续扫，留下清扫轨迹；没放基站时自动放一个虚拟的）、门窗开关和门锁；切换楼层时别的层滑开淡出，挑高层娃娃屋剖切。 中控是 3D 里的模拟演示（环境数据为模拟、状态不存进方案、不连接真实设备），用途是装修前的预演：灯放哪、空调窗帘怎么配、扫地机能不能扫到每个角落，住进去之前先用一遍
• 真实日照：按城市纬度、月份、时间算太阳位置，晚霞星空月光，一键日照演示
• 视觉风格：写实 / 彩平图（正上方俯视，一键导出 4000 像素高清 PNG）/ 沙盘效果图（微缩模型感），方案原色 + 12 套主题配色

装修设计

• 布置 / 水电 / 顶面 / 铺装 / 拆改五种图层；墙顶地材质、吊顶、踢脚线、立面图
• 自定义铺砖：砖的长宽、灰缝、8 种铺法、6 种纹理、起铺点，一块块铺，报价按整砖 + 切砖片数算
• 独栋别墅：车库（电动卷帘门、车、充电桩、储物架）、庭院（围墙 + 车道口、大门、草坪、汀步、泳池、凉亭、车棚、乔木、草坪灯、烧烤台、景墙）、挑空客厅 + 水晶吊灯、电梯、茶室 / 影音室 / 台球室 / 桑拿、设备间（壁挂炉、分集水器、软水机）；一键水电会按车库、庭院、分层配电的规则布
• 智能中控：每盏主灯、吊灯单独一个图标，同房间的筒灯 / 壁灯 / 一排吸顶灯合成一组，2D 里加删灯、挪家具、改门窗都会自动同步
• 水电管线自动排布：插座 / 照明回路、网线、冷热水、排水的每一根线和管，回路表、材料清单，5 类分开看、分开导出（见水电管线自动排布）
• 水电点位 29 种，一键布置水电（按功能区布灯：餐桌 / 岛台吊灯、沙发区、厨房操作区、玄关走廊，再全屋覆盖检查补筒灯不留暗区；门边开关、多门口和楼梯双控、床头双控；插座沿墙补齐、每间网口、电视位；橱柜冷热水、排水、燃气、空调孔、强弱电箱）
• 方案检查：家具重叠、挡门、通道太窄、马桶离下水口太远、家电附近缺插座或水点、吊柜挡窗、楼梯着地端 / 到达端 / 头顶净高等
• 自动算量报价；导出整套 A3 施工图 PDF、CAD 图纸 DXF、彩平图 PNG、分享文件；多方案管理与对比，自动保存

水电图层在点位之上自动排出每一根线、每一根管（100 mm 网格 A* 寻路，只走横平竖直，少拐弯，优先从门洞过墙，尽量不穿承重墙，同类管线并排成束）。规则和依据见 reference/mep-rules.md：

• 6 个视图：全部 / 强电 / 照明 / 网线 / 给水 / 排水，单独看一类时只显示这一类的点位和图例
• 导出：当前视图 PNG / DXF；「5 类管线分别导出 CAD」一次出 5 份 DXF（按系统分图层 MEP-POWER / LIGHT / WEAK / COLD / HOT / DRAIN）；整套 PDF 每类一页；回路表 + 材料清单 CSV（BV 线按三色 × 1.1 损耗、线管、底盒、网线、PPR、弯头三通、PVC）
• 走法按家装行业做法：墙面横平竖直、地面可点对点，厨卫电线全走顶，水走顶，电上水下不同槽，强弱电间距 ≥ 300 mm，排水 45° 弯头、坡度 ≥ 2.6%
• 手动编辑：选系统逐点画，吸附到点位自动结束；勾「自动寻路」只点起点和终点；拖顶点、拖线段、双击加拐点，Delete 删除；点中一段管线拖动平移，「恢复自动走线」撤回；选中插座 / 灯可以改它所属的回路
• 纠错：自动线和手改线都按施工规矩检查（悬空没接上、穿承重墙、强弱电贴太近、厨卫电线走地……），能自动处理的给出一键修复（重新走线 / 恢复 / 删除 / 接上 / 吸附 / 换走顶）
• 3D「⚡ 管线」：管线按真实高度放进模型（走地贴地、走顶贴顶棚，到点位竖直上下墙），墙变半透明

管线排布是按国标常用做法自动生成的方案，用于装修前规划和沟通；正式施工前以现行规范原文和电工、设计师的核算为准。

• 建模：全部由代码程序生成（不依赖外部 glb）。软装是细分后“鼓起来”的填充感垫子，带包边；被子有褶皱；柜体、桌面有小倒角；墙面乳胶漆、木纹、布纹、地板都有世界坐标的细微纹理和凹凸，远处自动淡出不闪；布艺用丝绒光泽、烤漆用清漆层
• 漫游光影：GTAO 接触阴影、窗户是面光源（窗帘拉上会暗）、房间光照探针模拟反弹光、窗外城市远景（夜里亮窗）、室内摄影调色、抗锯齿；墙段之间严丝合缝、不重叠，鸟瞰和漫游都不闪烁、不漏光
• 画质三档：流畅 / 均衡 / 高画质，第一次打开按显卡自动选（核显 → 均衡，独显 → 高画质），在「🎨 风格 → 画质」里手动切换并记住
• 光线追踪出图：☀ 面板「方式」选光线追踪（three-gpu-pathtracer + 自写的法线 / 深度 / 本色引导降噪），有进度条和剩余时间，可以随时“提前结束并保存”。实测 1920×1080、512 采样在 Intel UHD 630 核显上约 3 分 40 秒（含首次约 1~1.5 分钟的着色器编译）

设计器「导出图纸」菜单里有三种 DXF：平面布置图（国标三道尺寸）、平面布置图（装修四道尺寸）、水电点位图。 AutoCAD、天正、中望、浩辰和常见看图软件都能直接打开；按 GB/T 50001-2017《房屋建筑制图统一标准》/ GB/T 50104《建筑制图标准》的出图习惯组织：

导出的 DXF 可以再用 cadvec.py 读回来（实测墙体、门窗全部一致）。说明：DXF 存不了天正那种参数化“墙对象”，在 CAD 里拉一段墙不会带动相接的墙——要改墙回设计器里改，再导出。

完整示例：reference/example-spec.json（户型描述）、reference/example-gen.py（图片路线生成脚本）、reference/example-gen-precise.py（按标注精确定位）、reference/example-gen-cad.py（CAD 路线：读入 draft.json 再补改）、reference/example-gen-building.py（整栋楼）、reference/example-gen-duplex.py（挑高复式、多跑楼梯）、reference/example-gen-villa.py（三层独栋别墅：车库、庭院、泳池、挑空、电梯）+ reference/example-walk-route.json（漫游走查路线）。

1. 把本仓库放进你的 Agent 的 skills 目录，例如 Claude Code：

   git clone https://github.com/ZWD11/house-plan-designer ~/.claude/skills/house-plan-designer

   其他 Agent 放到各自约定的 skills 目录即可。

2. 安装依赖：

   pip install numpy pillow opencv-python pymupdf ezdxf   # 后两个给 CAD 图纸（PDF / DXF）用
   cd scripts && npm install                              # puppeteer-core，自查截图用

3. 本机需要有 Chrome 或 Edge（自查截图要用）。找不到时，设置环境变量 CHROME_PATH 指向浏览器程序。

SKILL.md                         Agent 读的流程说明
assets/template.html             设计器模板（单文件，three.js 已内联，约 1 MB）
scripts/analyze.py               图片识别墙体 → 比例 + 尺寸线刻度 + HouseSpec 初稿
scripts/axismap.py               按尺寸标注把像素换成毫米（逐段，不用整体比例）
scripts/cadvec.py                CAD 矢量 PDF / DXF 识别 → 按标注定坐标的 HouseSpec 初稿
scripts/cadsplit.py              整栋楼 / 描边墙：一页多层自动切分 + 识别 + 各层对齐 → building_draft.json
scripts/dimtext.py               没有文字层时破译尺寸数字（字形聚类 + 长度投票）
scripts/dxf_prepare.py           整套 DXF：展开块、修 GBK 乱码、按坐标裁出一张图
scripts/dxfinventory.py          布置图 DXF 清点：家具块（含旋转 / 镜像）、文字、门弧线、毫米底图
scripts/dxfaudit.py              布置图精确取数 + 对账：墙 / 门 / 家具 / 尺寸标注逐条和原图比
scripts/gridmm.py                给户型图任意一块叠毫米网格并放大，按毫米直接读位置（位图多楼层用）
scripts/build.py                 户型描述 JSON + 原图 → 设计器网页
scripts/check.mjs                无头浏览器自查：报告 + 2D / 叠图 / 3D 截图
scripts/walktest.mjs             漫游走查：按路线走一遍，验证楼梯、扶手、门
scripts/qa.mjs                   交付验收：真显卡把设计器每个功能实际操作一遍，出报告 + 截图
scripts/qa_files.py              检查 qa.mjs 导出的文件能否正常打开
scripts/qa_furniture.mjs         家具库逐件拍 3D，人工核对模型
scripts/qa_styles.mjs            风格款家具 + 自由模型逐件拍 3D（一行一个风格）
scripts/wallfit.py               按原图量每面墙的两个墙面，核对墙中线和厚度
scripts/furnoverlay.py           把 spec 里的家具画回原图，逐件核对“家具一比一还原”
scripts/dev/                     开发回归工具：
  make_test_dxf.py               把确认无误的户型画成 DXF，再用 cadvec 识别回来
  compare.py                     识别结果和标准答案逐项比对
  dumprooms.mjs                  导出每个房间的精确面积和矩形拆分，和按标注手算的面积核对
  mk_dxf_template.py             生成设计器 DXF 导出用的骨架（图层 / 线型 / 标注样式）
  shot3d.mjs / birdshot.mjs      漫游 / 鸟瞰机位截图（birdshot 还量相机微动时的闪烁像素）
  ptshots.mjs / uitest.mjs       光线追踪出图回归
  walk_lights.mjs / swinfo.mjs   漫游开关灯实测（夜里走到开关前按空格，看灯和点位标记）
  fps.mjs / libshot.mjs          3D 帧率、家具库面板截图
reference/mep-rules.md            管线排布规则与规范依据（回路、线径、管径、走线方式、导出）
reference/catalog-sizes.json     家具库尺寸表（自动从设计器同步）
reference/spec-format.md         户型描述格式（墙、门窗、房间、家具含定制参数、水电、铺砖、整栋楼与楼梯）
reference/cad-conventions.md     CAD 图纸画法、识别规则、核对清单、导出 DXF 的规则
reference/example-*              完整示例（example-gen-building.py = 整栋楼模板，example-gen-duplex.py = 挑高复式，example-gen-villa.py = 独栋别墅，example-gen-furnished.py = 照图一比一还原家具的大平层，example-gen-office-dxf.py = 布置图 DXF 还原办公培训层）

设计器支持任意层数：每层单独编辑，2D 各层平铺 / 单层，3D 整栋 / 平铺 / 单独看某一层（可含下层剖切），风格和配色对每种看法都生效； 楼板开洞（楼梯井、挑空、下沉区）、家用电梯；漫游时可以走楼梯、坐电梯上下楼；报价可以全楼汇总；撤销 / 重做跨楼层。 只有一层时和以前完全一样。户型描述格式见 reference/spec-format.md“整栋楼”。

楼梯

• 类型：U 形（双跑折返、三跑）、直跑、休息平台、扇形转角踏步（照图上的放射线分块，90° 拐角和 180° 掉头都行），可以拼成 L 形、多跑盘旋楼梯；直跑段可以指定踏步数
• 读图：按国标楼梯平面画法理解——首层只画剖切面以下的着地段、45° 折断线、以上虚线；顶层透过洞口看到整部楼梯、只标“下”；洞口里的斜线是楼板开洞，拐角的放射线是转角踏步。 先分清着地端（下层图的实线起点、“上”字）和到达端（上层图洞口边接上层地面、“下”字起点），再数踏步推算层高：1619 级是普通层高，2634 级是挑高复式，楼梯多跑盘旋、上一跑压在下一跑正上方，两层图看到的不是同一段梯子
• 2D 也按这个画：本层被剖切的梯段画折断线、以上虚线；上层洞口里自动画出下层整部楼梯并标“下”
• 扶手：外沿悬空的地方自动装；按高度判断有没有依靠（旁边是墙、或另一段梯段 / 平台高差在一步之内才算接上），上下叠着的两跑照样装；漫游时扶手、栏板、女儿墙都挡人，从高段梯段底下可以走过去、进出门
• 自动检查：最低一级离地 ≤ 一级且踩在本层地面上；最高一级 = 楼面到楼面、外侧是上层地面；梯段头顶净空 < 2 m 的地方上层必须开洞
• scripts/walktest.mjs 按一条路线在漫游里把楼梯真走一遍（脚高、楼层、是否被挡），交付前验证用

别墅图和公寓图的区别是主楼外面还有车库、庭院、车棚、泳池，楼里常有挑空客厅、电梯、设备间和露台。Agent 按 SKILL.md“独栋别墅”一节认图：

• 车库：外墙上 2.4~6 m 的大洞口 → 电动卷帘门（门型 garage，3D 里点一下卷起 / 放下），车库里放车、壁挂充电桩、储物架
• 庭院：主楼外一圈围墙圈起来的地方，围墙按高度砌、车道口和人行门留通高洞口；草坪、汀步、乔木、草坪灯、烧烤台、景墙
• 车棚、泳池、凉亭：照图上的位置和尺寸摆
• 挑空、电梯：上层楼板开洞（挑空四周装栏板，可挂水晶大吊灯）；电梯每层同一位置，漫游时能坐电梯上下楼
• 水电：车库按面积排灯、进屋门和车库门双控、每个车位一个充电桩电源、卷帘门电机插座；庭院 / 露台沿墙壁灯、防水插座、取水点

完整示例：reference/example-gen-villa.py。

check.mjs 管户型对不对，qa.mjs 管设计器每个功能能不能用、显示对不对。SKILL.md 规定交付前必须全部通过：

node scripts/qa.mjs <设计器.html> <输出目录>            # 约 20 分钟；--quick 跳过 PDF 和光线追踪
python scripts/qa_files.py <输出目录>/downloads        # 导出的 PNG / DXF / PDF / CSV / JSON / 分享文件能不能正常打开
node scripts/qa_furniture.mjs <设计器.html> <输出目录>  # 改家具建模时：全部家具排成网格分块拍 3D，逐件看

• 用真显卡（无头 Chrome + D3D11）打开设计器，把 2D 编辑（画墙、房间、门窗、点位、批注、测量、拆墙、家具拖动旋转复制删除、撤销重做）、属性面板（墙、门窗、房间、点位、定制橱柜 / 柜体）、5 个图层、水电 6 个视图和拖动改线、全部导出、报价、方案管理与对比、楼层、保存后刷新、3D 风格 / 配色 / 画质 / 日照 / 漫游 / 全景 / 光线追踪 / 智能中控 5 类设备，以及 4 种电脑屏幕尺寸和手机尺寸，一项项实际操作

• 判失败：页面报错、界面出现 NaN / undefined、操作后状态没变、导出没下载到或打不开、3D 画面空白、按钮被挤出或重叠、夜里中控文字对比度不够、手机上平面超出屏幕

• 输出 report.md（每项 ✅ / ❌ + 原因 + 截图）和每一步的截图，自动检查之外再人工过一遍截图

• 电脑性能一般也能跑：验收进程默认“低于正常”优先级（Chrome 跟着降），跑的时候电脑照常能用；常用参数：

  node scripts/qa.mjs <设计器.html> <输出目录> --lite --quick          # 1280×800、快速画质、超时放宽；1019 ㎡ 大平面约 11 分钟
  node scripts/qa.mjs <设计器.html> <输出目录> --only walk             # 只跑一组：2d / 3d / walk / smart / screen，或步骤名关键词（--only 管线,漫游），约 2 分钟
  node scripts/qa.mjs <设计器.html> <新输出目录> --retry <输出目录>/report.json   # 只重跑上次失败项所在的组

  不要和视频渲染、录屏、另一个验收同时跑：抢显卡会让 3D / 漫游 / 中控几十项一起超时

• 示例户型实测：大平层四室 110 / 110、三层独栋别墅 112 / 112，导出文件 24 / 24 正常

• 最适合带尺寸标注的图：彩色户型图、CAD 矢量图纸效果最好；黑底截图、墙只画双线的图需要 Agent 按标注手写墙，多花几轮。
• 纯线稿、扫描件、拍歪的照片，自动识别的初稿会很差，主要靠 Agent 根据尺寸标注推算。
• 图上没有任何尺寸时，Agent 会问你要一个已知尺寸，或者按常见尺寸估算并注明。
• 承重墙：图片按颜色 / 厚度判断，CAD 按“涂黑 + 厚度”判断（原始结构图常把所有原墙涂黑），以物业结构图为准。
• 存档保存在浏览器本地；换电脑或发给别人时，用设计器里的“导出 → 分享文件”。
• 导出的 DXF 是标准 CAD 图元（线、填充、标注、编组、图块），不含天正自定义实体。

• 2026-10-28：办公 / 培训 / 商业楼层（新户型类别：核心筒、公共卫生间厕位、阶梯培训厅、玻璃幕墙）；布置图 DXF 路线（整套 DXF 挑一张还原，块套块、GBK 乱码；家具朝向按图块角度和镜像；按图层认柜 / 吊柜 / 台面 / 窗帘 / 风口）；dxfaudit.py 和原图对账（墙、门、家具、尺寸标注逐条比）；管线按家装行业做法重排，支持手画、拖改、删除、自动寻路和纠错一键修复；家具横竖改尺寸（拖边 / 拖角 / 输入 / 拖高度）；漫游点位标记（开关、插座、小物件，空格开灯，T 显示隐藏）和视高 / 视距 / 视角调节；修复灯多的平面只有前 22 盏灯有光源、很多开关按了不亮；家具库按空间 19 类、9 种风格、一键整套换风格、拖宽左栏、大图浏览；自由模型 17 种造型；验收加 --lite / --only / --retry 和低优先级，新增“墙被吸歪”“门窗被藏住”两项自查；验收 105 项
• 2026-10-22：水电管线自动排布（强电 / 照明回路、网线、冷热水、排水，参照 GB 50096 / 50311 / 50242 / 50015；回路表、材料清单；拖动改线；3D 管线透视；别墅分层配电和立管）；5 类管线分开看、分开导出（PNG / DXF / PDF 每类一页）；写实建模（软垫鼓包、被子褶皱、细微纹理凹凸、丝绒 / 清漆）和漫游光影（接触阴影、窗户面光源、反弹光、城市远景）；光线追踪出图；画质三档；新增 qa.mjs 全功能交付验收。修复：配色切换出现条纹、墙面闪烁和小白点、玻璃底边白点、房间名标签挡住墙和门窗点不中、日照演示后一直是夜景、夜里中控文字看不清、PDF 图签长图名溢出、手机上楼层条挡住按钮、窗口变窄平面跑出屏幕、餐桌模型自带吊灯与水电吊灯重复
• 2026-10-17：智能中控（灯光 / 环境 / 设备 / 扫地机 / 安防，多层 ALL 爆炸视图和楼层切换，每层一台扫地机）；独栋别墅（车库电动卷帘门、庭院围墙、车棚、泳池、凉亭、挑空、电梯，别墅家具 30 多件）；一键水电重写（按功能区布灯，全屋覆盖检查补筒灯，插座沿墙补齐）；门窗、窗帘、灯光、楼层切换改成弹簧动效；晚上一键开灯整栋所有楼层一起亮；修复床板闪烁、楼板多出一块、沙盘眩光、灯光卡片点不动
• 2026-10-15：整栋楼 / 挑高复式与楼梯：多跑楼梯、扇形转角踏步、国标楼梯画法、扶手碰撞、楼梯两端检查
• 2026-10-12：CAD 矢量识别、国标 DXF 导出、定制家具参数化
• 2026-10-09：尺寸精确、自定义铺砖、彩平图、漫游室内光影；沙盘效果图与 12 套配色、真实日照与月夜、家具库扩到 130 件；家电门窗补齐、一键布置水电、3D 可交互

设计器源码是一个 TypeScript + Vite + three.js 项目（不在本仓库）。改完功能后在项目里执行 npm run skill:sync：打包成单文件并复制到 assets/template.html。 读取预设户型的代码在项目的 src/model/spec.ts（planFromSpec、window.__PRESET__）和 src/app.ts；DXF 导出在 src/export/dxf.ts，其骨架由 scripts/dev/mk_dxf_template.py 生成。