Build3D 本地多 Agent 建模架构设计
最新增量:户型精装按 docs/workflows/interior-finish-runtime-v1.json 执行11个节点(分类、空间、配准、立面、构造、LLM分析、核审、建模、渲染、展示、校验)。运行方式为“已核审场景”,不宣称任意DWG自动完成语义重建。主卫V4配准与折线轮廓见 master-bath-view-v4.md;本次仅本机验证,GitHub里程碑后未获新的推送指令。
当前增量设计:[户型精装模板第二版](interior-finish-v2.md),将精装实体与土建变体分离,并增加四向立面/节点关联与确认后微调流程。旧版下述实现记录保留为版本历史。
2026-11-10 增量:[装修六面、转角与室内巡游](finish-surfaces-and-tour.md)。finishAssemblies 增加可选 cornerTrims,展示层室内缩放即时重绘,输出层新增按同版模型生成的室内巡游 MP4 与路径报告;旧版数据/模型保持可读。架构图的版本成果框同步加入巡游视频。六面节点自动对应与电视墙完整细分仍待证据核审。
版本 1.0 · 2026-11-09 · 设计先于本次网关与 Agent 重构
目标与部署范围
把当前单体建模演示升级为可复用的本地项目工作室。底层网关负责资料和工具接入及大模型路由,中间由建模、渲染、展示三个 Agent 执行有明确输入输出的任务,上层沿用 Codex 式项目、文件与对话布局。
本次只在本机开发、测试并交付 http://127.0.0.1:8765/。不推送 GitHub、不部署线上 Space。用户另行通知后才能开始远端发布。
分层与职责
| 层 | 模块 | 输入 | 输出与边界 |
|---|
| 交互层 | 项目工作室 | 项目选择、文件配置、问题、生成请求 | 三维查看、历史、配置、下载;无密钥与供应商调用 |
| 编排层 | Project Service 与任务执行器 | 项目 ID、模板、参数快照、渲染选项 | 版本 ID、阶段状态、运行报告;负责隔离、锁、保留策略 |
| Agent 层 | Modeling Agent | 标准化输入清单、CAD 证据、核审场景、规则 | 有限 LLM 分析迭代、核审报告、可校验几何与原生 3DM |
| Agent 层 | Rendering Agent | 已生成几何、材料目录、材质方案 | 纹理关联、材质/白模 GLB、Blender、可选渲染图;保持几何 |
| Agent 层 | Presentation Agent | 当前项目证据、版本、问题、历史 | 回答、出处、房间/构件定位动作、可打开成果;不静默改模 |
| 网关层 | Asset Gateway | DWG/DXF、PDF/图片、3DM、GLB/Blend | 输入清单、哈希、文件类型、解析器能力、项目内路径 |
| 网关层 | Geometry Gateway | 已校验 scene、执行阶段、输出路径 | 受控 Blender 与 Rhino 执行、日志、读回验证;不执行 LLM 代码 |
| 网关层 | LLM Gateway | 任务类型、消息、可选图像、结构化约束 | OpenAI 优先、百炼备用,统一文本/JSON结果、模型与用量元数据 |
| 存储层 | 本机目录 | 输入、会话、版本产物 | .local/projects/<id>,原始资料、工作区、不可覆盖输出分离 |
三个 Agent 是应用内的职责模块,由同一任务执行器调用;不是三个无限自主进程,也不是额外的 Codex 聊天。通过统一契约复用模型、工具与规则,后续可以替换为独立服务。
处理流程
- 资料登记:输入网关只访问当前项目目录,区分设计、材料、其它资料,记录相对路径、类型、大小与 SHA-256。DWG 本地转换为 DXF;PDF 提取页图、文字与样板;3DM 读取单位、层级和几何。
- 冻结输入:生成请求创建独立版本,保存
input.json。输入清单写入该版本,后续修改工作区不改变本次任务的参数。 - 建模分析:规则先检查单位、房间边界、坐标、材质 ID 和墙高等必需条件。LLM 读取有限证据摘要,输出结构化问题、依据和建议;非法/缺失字段最多反馈重试一次。不能确认的尺寸保留在待核审报告中,不用通用建筑常识补齐。
- 规则建模:几何网关执行确定性建模器。CAD 实体与核审参数生成结构模型,3DM 使用原生拉伸实体与曲线,参考节点保留原层级。不能通过参数检查或导出读回检查则任务失败。
- 材质与渲染:渲染 Agent 根据材料目录和已有对应关系校验材质,必要时调用同一 LLM 网关解释冲突。应用样板纹理、导出白模与材质模型;渲染开关只决定是否额外计算效果图,不改变结构。
- 展示与问答:展示 Agent 基于当前项目和选定版本构造上下文,输出答案、来源与允许的房间定位动作。浏览器执行经 ID 白名单校验的动作,不能执行任意模型返回脚本、URL或文件路径。
- 发布本地版本:必需文件齐全、GLB 文件头及 3DM 读回通过后标记成功。仅此时清理超过最近 3 个成功版本的旧目录。失败目录可手动删除,已有成功版本保持可用。
核心契约
Project 与模板
project.json 保存 ID、名称、模板、只读、输入保护、归档、时间与版本清单。模板定义必需输入、输出格式、可用规则和 Agent 执行链。
基础模板保留六栋案例,输入为平立剖标注图与核审建筑参数,输出 GLB/Blender/渲染。户型模板输入为 DWG/DXF、物料书、其它说明(含效果 PDF 和节点 3DM)、核审场景,输出 3DM、GLB、Blender、可选图片。当前户型导入器针对 128 案例;不能声称已实现任意 DWG 的可靠自动语义重建。
SourceManifest
每条记录包含 path/category/type/size/sha256。路径只允许项目内 inputs/work/outputs,拒绝绝对路径、越界、目录链接、Windows ADS 和设备名。模型响应只能引用清单已有的路径。
Scene 与分析结果
Scene 保留 units/rooms/walls/windows/features/materials/linework/issues/provenance/nodeReference。坐标与尺度必须来自 CAD 或注明核审状态的输入。分析结果保存 summary/issues/evidence 与供应商、模型、耗时、用量及迭代次数。
LLM 本次负责语义分析与核审建议,几何生成受已有 Scene 和规则约束。自动落位壁龛、自动补齐吊顶/门窗、任意施工图自动精确翻模属于后续能力,不能用配置页上传成功代替解析成功。建议改变尺寸或材料时须先更新核审参数,再生成新版本。
Run 与阶段
任务整体状态为 queued → running → done/error,另记录 ingest/analyze/model/render/validate 阶段与起止时间。保存 pipeline-report.json、analysis.json、source-manifest.json、input.json、工具日志、model_info.json、rhino-report.json 和模型文件。
新任务使用时间戳加随机后缀,不覆盖任何旧文件。服务重启将未完成任务标为中断;不自动续跑可能重复收费的模型调用。规则/导出失败不自动消耗多次 LLM 修复;LLM 结构修复最多两次总调用。
LLM 网关设计
- OpenAI 使用 Responses API,优先从
OPENAI_API_KEY 或 OPENAI_KEY_FILE 读取凭据;默认密钥路径使用用户指定的本机文件。模型可通过 OPENAI_MODEL 设置,实际访问能力以本机连通性验证为准。 - 百炼沿用已有兼容 API 与模型清单,读取
BAILIAN_API_KEY / BAILIAN_KEY_FILE,兼容原加密保险箱。所有新 Agent 和原对话均通过统一门面调用。 - 自动路由优先 OpenAI;仅在缺少凭据、超时、限流或服务故障等情况下使用已配置百炼,并在结果记录实际供应商及降级原因。显式指定模型时不得静默切到另一个供应商。
- 密钥不出服务端,不打印请求 Authorization、不记录原始错误响应中的潜在凭据。请求只发送本任务必要摘要/选定资料,不扫描无关目录。OpenAI 请求设置
store:false。 - 网关支持文本与结构化 JSON;图像输入作为受控能力,按显式选择的项目图片提供,不能把“支持图像 API”写成已完整理解所有 DWG。
- 分析输出即使符合 JSON Schema,也必须通过本地证据/ID/数值规则验证。供应商失败或拒答记录清楚;若继续确定性核审预览,必须标明本次未获 LLM 分析,不能声称 AI 已完成理解。
官方接口依据:Responses API、Structured Outputs。严格结构化输出用于限制返回结构,不能替代几何或事实校验。
展示与配置
左侧是打开的项目、项目文件树和历史对话;项目内切换工作台、文件、版本、材料、核审、对话与配置。配置按三类输入展示添加/删除及输入保护开关;输出显示时间和版本,支持打开、下载、删除。
工作台支持拖动旋转、白模/材质切换、标签高亮、房间视点、构件依据和相关立面。问答可提供房间定位按钮;从回答跳转展示时保持项目与版本绑定。
当前 128 户型精度边界
整户型预览来源于真实 DWG 墙柱/窗线与效果平面标签。房间铺装边界、统一预览高度、部分硬装体块尚须核审。原始 3DM 节点的 1,189 个对象、29 个原图层保留在隐藏参考层,未自动推断安装位置。物料样板用于预览,3DM 为材质平均色和编码,GLB/Blender 包含样板纹理。它不是完整精装施工模型,也尚未达到参考效果图的细节程度。
实施与迁移顺序
本设计形成后再依次实现:统一 LLM 网关与兼容门面 → 资料/执行网关 → 三个 Agent → 阶段报告与 UI → 后台测试 → 切换本机服务。保留现有项目 ID、文件结构、成功版本与原接口。云端部署包不更新。
验证标准
- 单元/接口:项目隔离、锁与输入保护、三类配置、同名不覆盖、版本删除、保留 3 个成功版本、失败保护。
- 网关:OpenAI 优先与真实最小调用;显式模型不跨供应商;缺钥、超时、429、无效结构、拒答与降级路径;日志不含密钥。
- Agent:有界迭代、来源和 ID 白名单、规则失败阻止建模、渲染不改变几何、展示动作不跨项目。
- 产物:GLB 可读,3DM 读回无无效对象、单位毫米、原节点保留,渲染图非空白,版本有阶段报告。
- 后台浏览器:项目/模板切换、三类配置、历史对话、版本打开/下载、材质/白模、房间高亮、立面、窄屏与桌面布局。
- 仓库既有
verify.py 和 verify_chat.py 通过,再交付本机网页。未测试功能不得写成已完成。
自检通过 ARCHROBOT_BASE 指定隔离测试端口(本次为 8766),通过后才切换 8765 正式本机入口。OpenAI 本机已验证可访问 gpt-4.1,该模型作为可配置的默认实现值,并非“最新模型”的声明。
兼容约定:模型供应商降级记录为 provider_fallback,与原对话接口中“改参问题回落为问答”的 fallback 字段分开,避免合并响应时冲突。
启动顺序先绑定端口,再初始化任务状态,防止重复启动失败时把仍在运行的任务标为中断。本地启动器固定监听回环地址,控制台不显示不可访问的局域网入口。
变更记录
- 2026-11-09:根据用户要求先确立分层网关、三个 Agent、OpenAI 优先、设计先行与本地交付约束,再执行重构。下文记录本轮实现与测试结果;已验证版本运行于本机 8765,未推送或部署云端。
本轮实现对应与验证结果
| 设计模块 | 实现文件 | 实际状态 |
|---|
| LLM 网关 | app/gateways/llm.py、app/llm.py、app/bailian_legacy.py | OpenAI Responses 真实调用通过,百炼兼容门面,显式供应商降级元数据 |
| 输入网关 | app/gateways/assets.py、tools/import_interior.py | 11 份输入已解析/登记;哈希缓存,复用 DXF 须匹配原 DWG 哈希 |
| 执行网关 | app/gateways/geometry.py | 受控工具与产物校验 |
| 建模 Agent | app/agents/modeling.py、demo/build_interior.py、tools/export_3dm.py | 规则检查 + OpenAI 结构化核审 + 确定性几何;本轮不自动采用 LLM 尺寸建议 |
| 渲染 Agent | app/agents/rendering.py、demo/render_interior.py | 独立材质阶段,渲染前后网格/变换不变检查;复用建模分析中的材质问题 |
| 展示 Agent | app/agents/presentation.py | OpenAI 问答、版本参数、出处与房间 ID 白名单;实际验证“客厅材质 → 定位客厅” |
| 任务编排 | app/agents/pipeline.py、app/projects.py | 五阶段报告,输入快照,3 版本保留与手动删除 |
| 页面 | app/static/workspace.* | 项目、文件、对话、三类配置、版本及模型交互 |
本机测试:32 项项目/Agent/网关测试、44 项工作台自检、77 项原对话与模型接入回归通过。新流程分别完成含渲染与不渲染的实际任务;3DM 为毫米单位,1,645 个对象、106 个图层、71 个新实体、0 个无效对象。网页下载的 3DM 与服务端 SHA-256 一致。最近 3 个成功版本策略已在真实输出目录验证。后台浏览器已核对项目/模板切换、输入添加、房间高亮、白模/材质、室内视点、立面、模型下载、展示动作及桌面/窄屏布局。
仍需后续设计与实现:任意 DWG 自动语义重建、房间级精确立面编号绑定、节点自动落位、完整吊顶/门窗/家具、实测 PBR 材质、图像输入选择 UI、多用户身份鉴权。LLM 的核审建议也必须由工程证据复核,不能把测试通过等同于施工精度通过。
卫生间 V3 与识图规则
本阶段优先卫生间,先按 bathroom-detail-v3.md 设计,再实现曲线五金、圆角台盆、双镜门/内格分离和逐标签立面匹配。独立规则见 [读图识别与建模规则](读图识别与建模规则.md),匹配表见 [逐标签核对](elevation-index-128.md)。33个标签中32个图框与编号一致,4号有图框引用冲突;不得自动忽略。3DM试导出912部件、无无效对象仅证明导出几何有效,仍不构成1mm交付认证。
图纸配置与对话补齐
详见 [分组图纸配置设计](drawing-input-configuration.md)。在输入网关按平面/立面/部件/未分类登记,保留是否参与和SHA256;生成快照冻结配置,来源改变使已有参数核审失效。对话提案扩展已登记材质与单独立面关联,确认后新版本生效。新增图纸不等于已自动完成几何识别,禁止使用旧核审参数冒充新生成结果。
最新交付交互:效果图独立页签,底部共用项目助手;保存按钮记录不可变成果,保留最近3个手动保存版本,另留1个未保存预览。下载整包ZIP。Blender后台、低优先级、最多4线程;详见drawing-input-configuration.md及bathroom-detail-v3.md。此约定取代此前“生成成功即清理到3个版本”的描述。
验证更新:49项单元测试、verify.py 44项、verify_chat.py 77项全部通过;浏览器验证三类DWG分组、独立效果图页签、跨页签草稿保留及ZIP下载。实际下载ZIP含22项文件,CRC检查通过。早期渲染被用户终止后按4线程/低优先级恢复,近景验证另记。
主卫V4与模板工作流验收
11节点模板工作流受白名单和依赖检查约束;案例配准、真实折线空间、逐标签立面与节点快照、室内六向查看、物理构造和挂件样件已接通。57项单测、44项应用、77项对话及24项导出检查通过。最终本机预览为20261109-182223-02a272,934个精装部件;未达到1mm客户交付验收。具体问题及来源见master-bath-view-v4.md和每版本room-review.json。
户型精装模板第二版设计
2026-11-09,先完成本设计再修改实现。本轮仅本机测试,不推送。
需求与证据
会议纪要明确要求实体装修建模:土建墙体外的基层、面层、地面、踢脚、吊顶、柜体、门窗、洁具及节点收口;效果图只作风格参考。DWG 为几何与节点主依据,成套 PDF 负责解释图例和索引,完成面尺寸优先于效果图估计。旧版把白模当土建、贴图当精装的表达应当替换。
本次新增六张成套 PDF 与会议纪要作为项目副本。平面图 KP-FF.01 中公卫四向索引为图上方29、右方30、下方31、左方32,均指向 IE-FF.10;33 是额外窗口方向分图。方向以图纸坐标为准,不声明地理北向。立面29/31宽1540,30/32宽2340,室内净高由完成地面-0.010到吊顶+2.400得到2410毫米。32号立面含洗手台、镜柜、侧格、金属收边、淋浴,且明确引用 DT-T.02 的06/07节点。
材料:T-1004岩板、GL-1001超白钢化玻璃、ST-1002石材、MR-1001清镜、MT-1001金属、UP-1002扪皮,31另含WD-1001。具体构造尺寸以卫生间DWG大样提取的标注为准;尚无图示依据的产品细部标为可调整产品参数,不能宣称是已核准下单尺寸。
CAD 存在 Model 与布局空间。旧解析器只读模型空间且遗漏 INSERT 的 ATTRIB,造成材料码、立面号和节点号缺失。新输入网关必须保留布局名、视口映射、附着属性、纸空间标注、模型尺寸与来源句柄,并生成可查看的单幅裁图。不能将同一 DWG 内的多个平面副本叠成一个模型。
模型与数据
Scene V2 新增 elevations、finishAssemblies、components、dimensionComparison 与 sourceEvidence。索引关系为 room → direction → elevation ID → material codes → detail references。每个几何部件有稳定ID、房间、分类、土建/精装变体、材料、来源、尺寸、待核审状态。公共构造库和参数实例分离,避免只为一个文件名编写展示逻辑。
土建模型包含楼板、土建墙柱、洞口、门窗结构;精装模型在此基础上增加真实厚度的基层/饰面、铺装分块与缝、踢脚、吊顶、门扇/框/把手、窗框/玻璃、固定柜体、家具、洁具、镜柜、淋浴玻璃与五金。土建外轮廓不得因装饰而变动,完成面向室内偏移,净宽/净深/净高需要显示前后差异。
卫生间优先采用四向立面和06卫生间大样。包括台盆与台面开孔、柜体及抽屉、镜柜分格与搁板、灯带、马桶、花洒与软管、玻璃隔断与夹件、地漏、岩板分缝、基层与金属收边。来源明确的尺寸直接采用,产品未给定的自由形状使用带来源状态的参数化表达。
精装实体由建模 Agent 生成;渲染 Agent 只负责材质/灯光/成像,保持几何不变。白模是材质选项,不能代替土建变体。
输出和版本
每个版本同时保存 model-structural.glb/.3dm、model-finished.glb/.3dm,以及兼容入口 model.glb/.3dm(精装)。渲染时输出 render-structural.png、render-finished.png 和卫生间近景。保存部件清单、四向立面与节点证据、尺寸对照报告。一次生成是一个版本,两套模型一同计入最近3个成功版本的保留策略,不覆盖旧版。
对话与确认
用户补充要求按装修面材质/图层显示隐藏:精装查看器增加构造分类与材料编号两组可见性开关,真实隐藏对应几何,露出独立基层/土建对象;白模切换只改变材质,不代替隐藏。图层分类写入GLB部件属性和3DM层级。提供全部恢复及顶面剖切,状态按项目保留在本机浏览器,不改动工程模型或生成新版本。按来源可核查材料代码,未知代码不凭样板外观猜测。
在主图下方、资料预览上方加入项目对话区,可选网关已登记模型,可配置对应供应商 Token。Token 只发送到回环本机服务,保存为当前 Windows 用户的 DPAPI 密文,不回显、不写聊天、不记录请求体;保留已有密钥文件读取方式。
问答复用展示 Agent 与版本证据。微调走独立流程:用户要求 → 受约束参数建议 → 显示旧值/新值/影响范围 → 用户确认 → 校验提案与当前参数哈希 → 写入核审参数并生成新版本。提案创建不得改文件或模型;过期、参数已变、只读、重复确认必须拒绝或返回既有结果。用户取消则保留原模型。
允许微调材料、饰面厚度、已登记产品尺寸/位置等白名单字段,拒绝任意代码和无约束文件访问。结构改动与不具备依据的重大尺寸变化提示回到图纸核审。
接口与迁移
新增网关配置状态/密钥接口、项目提案生成/确认接口。持久化提案在 work/proposals,原始源文件不改动。旧版 Scene 和旧版本仍可浏览,V2 生成器只处理显式V2数据。升级先导入证据、建立索引和构造参数,再执行几何和页面改造。
查看器的房间和尺寸必须来自所选输出的不可变输入快照,不能把当前工作参数套在旧模型上。V2生成按钮直接使用服务端工作参数,浏览旧版本不自动回写工作区。历史版本只能浏览/下载;微调提案要求当前最新成功版本,且仍校验工作参数哈希。
验收
位置材质与毫米核审(追加要求)
客户精装交付门槛(最新要求)
目标是家具、墙体、电器与零部件按1:1交付,容差1mm。视觉效果、程序测试和3DM几何有效性均不能证明该容差。当前版本必须标记“核审模型,禁止作为客户交付验收依据”,不得发布为已达标模型。
新增交付核审报告:逐类列出尺寸来源完整性、土建/完成面基准、未建模电器零部件、产品厂家几何、实测/PBR依据和未订正的冲突。缺少明确产品规格或现场复测时保留缺项;订正建议带原值、建议值、证据与影响,未经确认不修改源DWG或施工尺寸。等待用户指定最终图纸版本、现场复测与厂家模型目录,继续对已有资料核查。此门槛不能通过“增加小数位”或参数化近似自动通过。
材料不得统一铺满同一方块样板。面层按构件、位置和真实规格定义:木纹沿构件长向,岩板按整板尺寸连续取样,铺地按实际板块裁切,涂料使用均色与细微粗糙度,玻璃、镜面和金属使用独立物理属性。物料书样板不是厂家实测PBR;样板来源及可调整的纹理尺度应保留,不能声称照片级准确。材质变体只改着色,不改几何。
尺寸报告以毫米展示土建/完成面对照,记录原图标注、推算值及待核审状态。应检查薄层与净尺寸、洞口与饰面、产品越界、同位置图纸冲突。当前矩形房间范围和部分产品落位属于核审参数,不满足“全部尺寸已逐一确认”时必须明确列出问题,不能凭更多小数宣称毫米精度。
完成面尺寸图显示主卫净宽1540mm、分段900+1540=2440mm,不能套用公卫1540×2340mm。构造支持各墙独立偏移 wallBuildUpSides;当前土建矩形包围范围与完成面反算的主卫80/10mm差异本身是需核审的冲突,不能当作节点已确认的基层厚度。净高仍须分别核对,不能把公卫标高默认为主卫已确认标高。
- 单幅立面29/30/31/32与公卫四面可点击关联,显示材料和节点来源。
- 两个模型部件数/包围盒/净尺寸存在合理差异;精装包含门窗、家具、镜柜和卫生间五金;两份3DM均读回检查。
- 两张总览及卫生间效果图实际渲染且人工核对。
- 无确认时参数与版本不变;确认后只生成一次且有差异记录,过期提案拒绝。
- 密钥状态接口不返回秘密,新增密钥用后端DPAPI保护。
- 后台浏览器验证切换土建/精装、立面、尺寸对比、对话、选择模型和确认/取消微调,执行已有自检与有意义的回归测试。
卫生间优先精细化设计
用户已将本阶段范围收敛为卫生间,其余空间后续按此调整。五金样式依据现有DT-T.01-02 DWG,不要求先补充一套资料才能识别。
索引证据
平面索引位于01平面系统DWG,图签KP-FF.01;含01—33号分图索引。分图位于02立面DWG的IE-FF.01—10。符号方向需结合块自身形状、镜像变换与引线读取,不能仅按INSERT旋转角(现有多个块旋转角均0)判断。
DT-T节点02为IE-FF.10镜柜内分隔;01及03—07引用IE-FF.08。立面32同时调用DT-T.02的06/07,表明可复用节点做法,但不能忽略公共卫生间自身的尺寸链。
立面32的镜柜横向链为80+540+540+280=1440mm,与节点02总宽一致;节点02的245/245/510是内部分隔,不能误当作三个镜门的面宽。公卫立面柜体内部80+270+270+20=640mm,620为局部定位链;需将20mm收口/凸出单独呈现,不能将其与IE-FF.08节点790mm整体尺寸直接当成同一对象冲突。
几何
从DWG直接提取五金轮廓,弯曲路径离散误差目标0.05mm,并保存源区域、图层、句柄、单位和文件哈希。现有15mm容差的线稿只用于缩略预览,禁止直接作为1mm精细模型的曲线来源。
按节点05/06的两视图重建弯颈龙头、两个十字阀柄、法兰/阀座,替换L形示意杆。顶面阀柄中心距由DWG读数200mm;管径和形状从同一CAD轮廓量取并标注“图形量取”,不同于厂家制造公差认证。260mm是台面至镜柜下沿间距,不能误当作龙头高度。
台面标高850mm,镜柜下沿1110mm、高1000mm;180mm深度来自剖面节点,适用关系单列。镜柜内隔板、双镜门、80mm灯带区和280mm开放侧格分别建模。节点02内隔板20mm,侧格15mm边板、5mm前缘搁板及相应净高按尺寸链设置。台盆采用420×320mm内口与460×360mm外缘,台盆中心据节点06位置,不能用椭圆盆替代。
引入可追溯的管状网格、旋转体、带截面的挤出和台盆曲面,Blender/GLB与3DM共享同一构件定义;材质阶段不改变空间几何。源图已标数值、图形量取、按对称/剖面推导、未确认的深度分别记录。
校核与交付
保留土建/精装双模型、分层显隐、四向立面及微调确认。新增卫生间证据与部件对照报告,检查尺寸链闭合、材质不兼容、构件相交、与参考节点适用关系。先展示订正建议,不修改原始DWG。
导出有效性和程序测试不能证明全户型1mm精度;验收范围本轮仅推进卫生间。其余空间继续标为待核审,不能承诺高保真客户交付已通过。
渲染恢复:若整体图已导出而近景进程失败,仅从已保存model.blend恢复近景,不重做几何或覆盖成功版本。恢复检查几何签名不变、真实输出非空及3DM有效性后才将失败任务转为成功。单独近景关闭CPU降噪器以隔离最后阶段失败,保留Cycles路径追踪与原分辨率/采样。
用户确认此前渲染被手动结束,并要求降低资源优先级。Blender统一后台无窗口、BelowNormal优先级、最多4个CPU线程;恢复任务同样降低优先级。线程环境参数仅允许1—4,避免默认占满CPU。
近景目视复核:首张恢复图噪点高、透明玻璃导致五金可见性不足,不能作为高保真交付图。用户已说明进程是被手动终止,故恢复Cycles原有降噪;清玻璃采用Transmission=1、Alpha=1、IOR=1.45与低粗糙度,不用半透明白色模拟清玻璃。压低室内灯功率并降低曝光,重新导出对应材质GLB与Blender保持一致,几何签名必须不变。
读图识别与建模规则
版本:2026-11-09 / 主卫精细化 V4 与模板工作流。本文是识图与建模的工作依据,不是施工验收合格证。后续修改先更新设计和本规则,再实现、验证。
规则状态与证据
每条识别结果记录源文件及哈希、图纸版本、布局/图框、实体句柄、单位、尺寸来源、适用对象和核审状态。状态分为“标注已核对”“图形量取”“反算/推定”“冲突”“待补充”。不得把后两类静默转为已确认。LLM 可解释、匹配和提出候选,不能替代尺寸证据。
以下方法可复用;其中的具体数值仅用于128户型当前资料,换项目或源文件哈希变化必须重新核对。
通用图形识别规则
| 编号 | 规则 | 处理与限制 |
|---|
| G01 | 先判单位、模型/纸空间和视口 | 保存缩放、平移、旋转及块嵌套变换;未支持的扭转视口不得套用无旋转公式。 |
| G02 | 组合索引拆成独立标签 | 一向、双向、四向仅表示同组多个分图。每个标签单独建立“编号+目标图框→单张立面”的关联。 |
| G03 | 分图标题与父图框共同判定 | 平面标签的IE-FF编号对应立面所在图框;立面下方KP-FF.01是回指平面,不能当成目标图框缺失。编号相同但图框不同须报冲突。 |
| G04 | 方向由符号完整变换判断 | 综合块族、箭头形状、旋转和负比例镜像;不能只用INSERT旋转角。图纸上下左右不自动等于地理方位。 |
| G05 | 引线落点定位空间/墙面 | 从符号端沿引线到落点,经纸空间视口与平面配准转为模型坐标,再与房间实际轮廓和墙段交叉核对。距离聚类阈值须按本套符号尺度校准。 |
| G06 | 土建与完成面独立配准 | 用多组相同墙柱/窗实体的形状与位置求变换;保留匹配数量和残差。不得将本户型的平移量作为通用常数。 |
| G07 | 尺寸对象与基准先于数字 | 区分总宽、净宽、局部定位、收口、层厚、标高、净高及间距。检查尺寸链闭合;不同对象不能仅因数值不同就报冲突。 |
| G08 | 节点按引用适配 | 记录节点号、引用图框、适用立面和尺寸覆盖。共享构造不代表共享整体宽度;内部隔断不等于正面分格。 |
| G09 | 正视/平面/剖面互证 | 至少对齐共同基准、尺寸与部件身份。单个轮廓只能确认该投影,不能证明完整三维形态和制造公差。 |
| G10 | 精细曲线与预览分离 | 当前精细轮廓离散容差0.05mm;15mm线稿仅供预览。曲线离散容差不等于模型、源图或现场总体误差。 |
| G11 | 材料代码结合属性语义读取 | 分别读取类别、编号、吊顶高度等属性;如CH块NUM2为高度、NUM4为材料编号,不能把2800高度拼成PT-2800。块定义变化后重新校验。 |
| G12 | 材料落到具体表面与构造层 | 按立面分区、材料书厚度、纹理方向、板幅、缝、收口和基层分别建模。材质显隐必须改变对应可见层,不能只切换文字。 |
| G13 | 纹理以真实尺度铺装 | UV米制尺度与材料板幅一致,木纹/石纹方向按位置定义,必要时独立裁切和拼纹;材料样本照片不是已标定PBR贴图。 |
| G14 | 结构与精装分开输出 | 结构保留土建基准,精装加入面层、基层、门窗、柜体、洁具和五金;完成面净尺寸由真实层厚/偏移计算。 |
| G15 | 冲突与调整保留审计 | 输出原值、依据、建议、影响范围和状态。聊天先形成差异,用户确认后生成独立新版本;取消不改模型。 |
| G16 | 输入按职责分组 | 平面图定位空间与索引;立面图定位各竖面;部件图定义墙、天花、地板、门与五金构造。未知图纸单独保留,未确认分类不能自动参与生成。 |
|---|
| G17 | 对话补齐需显式确认 | LLM提出物料库材质绑定、构件—立面对应和同号图框引用订正,显示原值、新值与依据。未有依据的内容保持推定;图纸配置变更使旧核审失效。 |
| G18 | 空间与结构相交检查 | 用真实完成面轮廓检查结构墙面积交集,柱凸出不可被矩形包围框填平。重点空间冲突阻止生成,其它空间问题逐项记录。室内相机必须在净轮廓内。 |
| G19 | 家具旋转后再核对范围 | 床宽和床长按旋转后的方向比较;正交俯视不产生透视缩放。家具产品参数与图纸实测分开记录,不能把渲染观感等同尺寸证据。 |
| G20 | 用户新增挂件保留来源 | 电话、毛巾杆等用户要求的样件可以进入核审模型,但必须标注厂家、尺寸、安装点未确认;不得冒充DWG已识别部件。 |
| G21 | 六面与转角逐项闭合 | 每个房间按四面、顶面、地面建立独立覆盖和相邻交线;大样须经图框/索引/剖切关系确认适用房间,尺寸链不闭合时保留核审状态,不将表格截图当作安装位置。 |
| G22 | 巡游路径须几何可达 | 镜头路径和视点逐帧检查净空间、墙柱及柜体障碍;视频与模型使用同一冻结版本,失败保留报告,不以静态图片转场冒充空间环绕。 |
128户型已形成的案例规则
| 编号 | 当前依据与结论 | 适用边界 |
|---|
| C01 | 01平面系统DWG的布局1/KP-FF.01含33个标签;02立面DWG含IE-FF.01—10。9组单向、2组双向、5组四向。 | 逐项见《elevation-index-128.md》和项目elevation-index-map.json。 |
| C02 | 公卫29/30/31/32分别为图纸上/右/下/左,逐项对应IE-FF.10内同号分图。15号对应其自身IE-FF.06分图。 | 不得把29号按外观匹配到15号。 |
| C03 | 平面4号指向IE-FF.01,但已找到的4号立面位于IE-FF.02。 | 标记sheet_reference_conflict,暂停自动套用该面材料,需订正引用。 |
| C04 | 两平面配准获得46组相同几何签名,平移48468.107mm;公卫索引引线5674E2落入对应公卫。 | 仅当前源图;坐标换算及视口证据保存在项目映射文件。 |
| C05 | 公卫完成面1540×2340mm,净高2410mm;地面FFL−10mm,吊顶AFFL2400mm。 | 必须区分相对浴室地面与全局标高。主卫1540×2440mm;其80/10mm墙侧偏移是反算待核值。 |
| C06 | 公卫32号镜柜横向80+540+540+280=1440mm;节点02内部245/245/510等是隔断净宽。 | 双镜门与三列内格分别建模,不能画成三扇245/245/510镜门。 |
| C07 | DT节点02引用IE-FF.10;01及03—07引用IE-FF.08。公卫32调用06/07时复用做法。公卫柜体80+270+270+20=640mm;主卫80+690+20=790mm。 | 620mm为局部定位,不能把公卫640与主卫790简单报成同一对象冲突。 |
| C08 | 台面距浴室地面850mm;镜下沿1110mm、镜高1000mm。260mm是台面至镜底间距。 | 260不能用作龙头高度;180mm镜深来自剖面,跨节点适用仍需核审。 |
| C09 | 节点05/06显示弯颈龙头和双十字阀柄;阀中心距200mm。盆内口420×320、外缘460×360mm,按DWG圆角轮廓建模。 | 龙头约165.848mm高度、15mm管径为图形量取;台盆未标深度、实体厚度等必须保留推定状态。 |
| C10 | 公卫玻璃横链200+150+440+650+100=1540mm,固定片440、门650;玻璃高2310、合页距浴室地面300/1900mm。 | 局部墙垛、门轴与80mm淋浴隔断须同基准落位。 |
| C11 | 公卫入口31号为WD-1001木门;灯轮廓为30×920mm胶囊形。 | 不得沿用旧版磨砂玻璃门和25×940方盒灯。 |
| C12 | T-1004为800×2780×9mm,WF-1001为1210×153×15mm,T-1001为1500×750×10mm;ST-1002为18mm,GL-1001为12mm,MR-1001为4mm。 | 按具体位置与材料代码适用;参考3DM中的ST-102A等代码不得按相似字符串自动映射。 |
| C13 | 立面31/32使用UP-1002,而材料书标注其不防水。 | 作为湿区适用风险输出,核实干湿区与防护做法;不自动换材。 |
| C14 | 主卫实际结构内边x3.6/5.2、y5.7/8.2m;西北柱凸出350×900mm。按完成面折线保留柱,名义1540×2440mm,净高2410mm,FFL−10mm、吊顶+2400mm据20—23。 | 覆盖C05旧主卫80/10mm反算方案;30mm总构造仍待逐层节点确认。有效平面面积约3.443㎡,不是完整矩形3.758㎡。 |
| C15 | 主卫立面23柜宽80+640+20=740mm;节点06/07为790mm。镜柜80+640+540+280=1540mm。 | C07的790mm仅是节点尺寸,不能当成本房柜体最终宽。当前核审按本房740mm落位,50mm差异仍列冲突。 |
待完善规则与落地顺序
- 先补齐卫生间尚未充分约束的洁具高度/曲面、五金安装和检修空间、所有隐蔽层、缝与公差。已提取投影不能冒充厂家实体模型。
- 扩展到其他房间时,逐面复核33个索引的墙段归属、分区和开口;不沿用卫生间尺寸、材料和节点适用范围。
- 增加有坐标证据的门扇开启碰撞、抽屉/电器检修、排水坡度与防水连续性检查。未实施的检查不可显示为通过。
- 将设计冲突与模型推定分开输出;几何越界、尺寸链不闭合、湿区不防水、薄弱裁切等给出定位证据。排版小于50mm目前是本模型提醒阈值,不是引用的施工规范。
- 建立源版本变更后的增量复核:哈希变化使相关映射和确认失效;不能悄悄复用旧审核。
- 1mm验收需完整的尺寸基准、源图与实体误差链、产品和安装尺寸、现场/设计验收范围及逐项检查记录。毫米单位、GLB显示效果、3DM对象有效性均不足以证明已达到该要求。
实施入口与验证
CAD网关提取属性和视口;elevation_index网关匹配逐标签;建模Agent应用尺寸/节点规则;渲染Agent应用表面构造且不暗改几何;展示Agent只回答当前版本事实,修改必须确认。索引、证据和参数随输出input.json冻结,查看历史版本必须使用该版本快照。
验证至少涵盖索引同号/异图框冲突、镜像方向、尺寸链、结构/精装隔离、真实材质尺度、3DM毫米单位及有效性、确认前不变更与失败回滚。最终规则状态以源证据和实际测试为准。
本轮验证记录
2026-11-09:49项单元测试通过,含逐标签冲突、确认前不修改、受约束材料与对应关系、图纸集合变化失效、GLB纹理变换不改几何缓冲区。卫生间V3的3DM试导出912部件,两个变体均0无效对象。以上为软件和几何检查,不能替代1mm完整尺寸验收。
展示与保存规则:效果图独立页签,项目助手固定底部且跨页签保留草稿;生成仅作预览,点击保存才进入最近3个手动保存版本。下载所选模型统一ZIP整包。
主卫优先:装饰与室内查看 V4
用户反馈进入主卫后空白,要求优先完善主卫装饰,辅以LLM提示语和参数;同时需要整体/单房间、天花、四向立面、助手最小化。本轮先核对既有主卫模型部件及IE-FF.08/20—24、DT-T节点和天花图,不用艺术生成图片替代可交互模型。
设计
- 展示层统一使用实际GLB世界坐标和房间完成面边界;由加载几何包围盒验证相机坐标。室内相机放在可用空间内,拖动只改变朝向,禁止围绕墙外目标旋转造成穿墙。四向/看顶/看地按钮使用同一室内眼位;WASD限制在房间边界及净高内。
- 左侧增加整体模型入口;房间入口仅显示该房间及关联围护结构。显隐与材质开关取交集。整体模式剖顶,室内模式默认显示本房天花;自动排除相邻房间,不隐藏本房家具和五金。
- 默认主卫模型应具有墙饰面、构造基层、天花面层/基层、地面、镜柜、台盆、龙头、马桶、淋浴玻璃与五金;对应到20—24号单独立面。外观/厚度依图纸和物料书,推定值独立标注。天花图应先核查,未证实节点不称为准确复原。
- LLM通过既有网关读取主卫证据、材料与尺寸,产出受约束的装饰分析/提示语;确定性建模与材质参数保持可审计,禁止执行LLM代码。模型与渲染必须使用同一参数快照。
- 项目助手增加独立最小化状态,缩为内容区左下角的小按钮;跨页签和刷新保留,恢复后保留对话、草稿和待确认方案,不占正文底部空间。
- 不覆盖已保存模型。必要时新增未保存预览,继续采用最近3个手动保存版本策略。后台Blender最多4线程、低优先级。
验证
真实页面进入主卫后画面非空且相机处于净边界内;四向旋转/看顶、单房间隔离、整体恢复、部件清单与材质显隐、助手最小化恢复均须检查。新增主卫模型输出须检查3DM毫米单位、几何有效、材料与厚度、同版渲染;不能以网格有效性代替1mm验收。保留DOM诊断计数和相机状态供回归检查,不在用户流程堆放调试文字。
当前阶段
用户随后要求先学习酷家乐教程和视频,暂停继续实现/建模。已整理《template-workflow-design.md》,将模板定义为有版本的工作流。V4页面中间改动尚未完成验收;主卫配准、构造和新渲染未完成,不得按已完成交付。
恢复实现:工作流与主卫修复
用户现已要求继续本机实现。先将案例配准数据与模板执行器分离:模板从输入快照、墙体与空间、单标签映射、构造参数运行,记录逐节点状态、证据及核审问题。通用DWG语义提取仍需核审,不宣称任意图纸无人确认即可完成。
主卫旧范围 [3.11,5.5657,4.81,8.0257] 与CAD墙体冲突。修复依据CAD实际内边:西3.6、东5.2、南5.7、北8.2米;北西柱凸出须保留真实折线。完成面名义1540×2440与立面20—23交叉核对;30mm构造是反算值,9mm面层有物料书依据,其余层仍标核审。配准更新属于纠正模型,不修改用户设计。
数据扩展:空间允许 structuralPolygon / finishedPolygon;构造允许逐段 surfaceSegments(含柱侧、回口)、ceiling 与 accessories 参数;相机以实际轮廓和障碍物选择内部眼位,不以包围矩形代表全部净空间。新增 room-review.json 记录净尺寸、结构侵入、六面覆盖、配件证据及未解项。
主卫立面23柜宽80+640+20=740mm与节点06/07的790mm不一致,预览按本空间立面落位,保留50mm节点适配冲突;门按立面22的760mm可见扇幅核对,结构洞口保持原CAD墙线。电话等未找到明确位置/尺寸的配件,须记录为待补,不以随意模型冒充DWG复原。顶喷、手持花洒、软管、阀件、镜柜与坐便器按已有轮廓细化,并记录推定尺寸。
实施入口:agents/workflow.py 编排实际节点与质量门槛;interior_spec/bathroom_detail生成部件;展示层增加四向/顶/地、同空间部件列表和证据。历史版本不改,新输出单独生成;更换输入使旧配准失效。
验收:源墙体叠图与空间轮廓、相机不在墙中、四向/天花/地面截图有内容,五金可见且可选;毫米3DM与双GLB导出;同快照主卫渲染,低优先级4线程;单元测试、应用/对话回归与真实浏览器验证。仍不把核审版当1mm施工交付。
浏览器核对增量:金属/镜面需要室内反射环境,否则WebGL镜柜黑屏;实时玻璃用透明预览表达,下载模型与Cycles效果保持物理透射。默认眼位朝向镜柜和淋浴的交界,支持放大浏览与退出。静止时按需绘制,避免后台空转。柱面与淋浴左收口不得重复生成;电话核审样件放在镜柜下方,不能埋在柜体内。
本轮结果(2026-11-09)
最终预览 20261109-182223-02a272 通过11节点真实工作流,OpenAI核审通过本地结构与来源枚举校验;模型与图纸参数独立冻结,7张节点图片随版本保存。934个精装部件、83个土建部件,两个3DM均毫米单位且无无效对象。
软件验证:57项单元测试、44项应用自检、77项对话回归、24项双模型导出检查通过。首轮并行重建曾超过300秒测试等待限额,串行重跑77项全部通过;后台重建等待上限改为600秒,不放宽几何或答案检查。ZIP实际下载70项文件、CRC检查通过。当前3个手动保存版本与1个未保存预览。
界面验证:室内眼位 [4.7388,1.49,-6.706](WebGL Y-up)在完成面内;六个方向保持眼位,材质开关将主卫可见数146降至122并可恢复;电话可选中、关联23号立面。增加正交俯视、放大浏览、镜柜障碍约束和静止时按需绘制。仅发布到本机8765,未推送新代码。
质量边界:主卫名义1540×2440×2410mm,图上左侧柱350×900mm,实际平面面积约3.443㎡,柱侧局部净宽1190mm。30mm总构造为反算;柜体立面740/节点790差50mm仍需订正适配。电话、毛巾杆、灯具、部分产品曲面与安装规格未获厂家确认。其它房间仍有配准问题,已写入版本核审报告。本轮为主卫核审预览,不是1mm客户精装交付验收通过。