创建第一个项目

平台的用户入口是项目。模型由 AI agent 在项目会话里生成，用户不上传文件。

操作流程

1. 新建项目。在首页点「新建空白项目（AI 建模）」，填标题，选项目类型：
   • ifc：AI 生成 IFC 模型。建项目时就初始化一个骨架模型。
   • cad：AI 生成 DXF 图纸，agent 会话内按需初始化。
   • cad->ifc：先出图再转 IFC 的完整链路。
2. 对话建模。进入项目会话，在右侧 AI 对话栏用自然语言描述需求。agent 按项目类型派发子 agent 生成模型，过程中能看到工具调用卡片和中间预览。
3. 审查。模型出现在项目模型列表里，点击进入查看器。IFC 走三维查看器，DXF 走二维画布。界面细节见界面使用。
4. 编辑。选中构件点定位脚本，跳到脚本对应行。改参数或改代码，沙箱验证后保存大版本。详见编辑工作流。
5. 对比版本。工具栏的 Diff 选择 base 和 target 做语义对比，也是编辑工作流的一部分。

没有配置 LLM 时，chat agent 会退到离线模式：界面流程都能走通，但不会有真正的智能回复。LLM 配置见配置说明。

排查

现象	处理
模型一直 converting	看 server 日志里的 converter stderr；手动跑 node converter/convert.js <ifc> <outDir> 复现；检查 nodeBin 和 converterScript 配置
转换 failed	调 POST /api/v1/models/{id}/retry 重试
编辑报 404 model not found	编辑服务的 VIEWER_DATA_DIR 和 server 的 dataDir 不是同一个目录
脚本编辑报 422	契约校验失败或沙箱构建失败。请求零副作用，按报错信息修正后重发
脚本编辑报 503	沙箱不可用：缺 bwrap 或缺 uv，见沙箱执行环境
AI 对话没有智能回复	LLM 三参没配，正处于离线模式。配置 VIEWER_LLM_API_KEY 等三个变量

完整排查表见测试与调试。