http://127.0.0.1:8765/。请双击 D:\blend\app\start_server.bat,
不要直接双击 index.html(file:// 协议禁止访问接口,点任何按钮都会报 Failed to fetch)。
三维模型 · 可拖动查看
自动旋转 线框 透视 重置视角 左键拖动旋转 · 滚轮缩放 · 右键平移 · 点构件看参数并自动聚焦(内墙自动开透视)左侧选择楼栋并点击「生成 3D 模型」
图纸对话 · 知识库增强
清空对话 正在加载引擎…同一份数据,两端产物
左侧是 Agent 依据 5 个视角生成的二维图纸,右侧是 Blender 按同一份 JSON 自动建出的三维模型。上方查看器里的模型就是 Blender 导出的 glTF 文件本身——可以拖动、可以点构件看参数,不是截图。




系统架构 · 六层,各管一件事
对齐《中建东方 · 3D 建模 Agent 方案》的六层结构。本 Demo 落地的是 L2 解析(多视角图纸)、L4 编排(本地服务)、L5 执行(Blender 无头引擎)、L6 交付(GLB / .blend / 参数表)四层,L1 接入与 L3 知识层以参数化图纸库与构件规则替代。服务只监听 127.0.0.1,数据不出本机。
Agent 的边界:哪里调大模型,哪里坚决不调
先把话说清楚:本 Demo 跑起来没有调用任何大模型。它是 Agent 的骨架——任务编排、队列、状态机、工具调用(subprocess 拉起 Blender)、失败重试、全过程留痕;执行体是确定性算法 bpy。大模型只在"读不懂的语义"环节才有位置,几何生成不需要猜。
| 环节 | 判断 / 执行方式 | 本 Demo 现状 |
|---|---|---|
| 图纸清洗、图元识别 | 规则 + 几何算法,高置信自动、中置信给人确认 | 参数化图纸直接可解析,不调模型 |
| 几何建模(墙 / 洞口 / 屋面) | bpy 确定性执行,同样的输入必得同样的模型 | 已实现,不调模型 |
| 参数对齐(材质 / 做法 / 编号) | 规则表 + 优先级(说明 > 做法表 > 标注 > 默认值) | 规则内置,不调模型 |
| 中置信歧义(识别不了) | 大模型读做法表与图集,给候选类型 + 依据,人点一下确认 | 预留接口,当前未启用 |
| 自然语言问答与查改 | 大模型 + 工具调用,读 IFC 属性后作答 | 预留接口,当前未启用 |
| 冲突裁决 | 人裁决,裁决结果回写成规则 | 预留 |
两条纪律:一、原始几何与属性数据不进大模型上下文,模型只读结构化摘要;二、每层可单独替换,接不接大模型都能跑,接了只是把中置信项从"人工翻图"变成"点一下确认"。
接口清单 · 前端与编排层的契约
全部为 HTTP 明文接口,仅绑定 127.0.0.1,不依赖任何外部服务与第三方库(three.js 已本地化)。
| 接口 | 方法 | 说明 |
|---|---|---|
/api/health | GET | 健康检查:Blender 是否存在、楼栋数、图纸数、媒体目录 |
/api/buildings | GET | 6 栋楼 + 每栋 5 个视角(编号 / 名称 / 约束说明 / 约束点数) |
/api/state | GET | 一次性返回所有楼栋建模状态,用于卡片打"已建模"标记 |
/api/generate | POST | 下发建模任务,工作线程串行调用 Blender |
/api/status/<id> | GET | 轮询任务状态;服务重启后从磁盘产物自动恢复 done |
/api/model/<id> | GET | 构件清单与统计(供参数面板与构件列表) |
/output/<id>/model.glb | GET | 网页 3D 查看器加载的真实模型文件 |
/output/<id>/model.blend | GET | 下载可编辑模型文件 |
业务闭环 · 六个环节,第四环是卡点
现场作业链是「测绘 → 出图 → 核审 → 2D 转 3D → 参数确认 → 业务可用」。前三个环节都有成熟工具和明确责任人;第四环没有工具、没有标准动作,是整条链上唯一还靠"人读图"的环节——本 Demo 就是用 Agent 补这一环。
与 PPT 方案的对应关系
本 Demo 是《中建东方 · 3D 建模 Agent 方案》中「L2 解析 + L4 编排 + L5 执行 + L6 交付」的最小可跑通实现:编排层负责任务排队与状态机,执行层用 bpy 做确定性建模,交付层直接给出网页可查看的 glTF 与可继续编辑的 .blend。原始几何参数全程不进大模型上下文——模型只认结构化输入,与方案里两条设计纪律一致。