61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# 工作流定义
|
|
|
|
## 阶段
|
|
|
|
```text
|
|
uploaded
|
|
-> region_selection
|
|
-> plan_review
|
|
-> blockout
|
|
-> style_brief
|
|
-> direction_selection
|
|
-> render_review
|
|
-> editing
|
|
-> completed
|
|
```
|
|
|
|
任意异步阶段都可以进入 `failed`，修正问题后通过 `retry` 回到最近一个可恢复阶段。
|
|
|
|
## 关键命令
|
|
|
|
| 命令 | 作用 | 关键约束 |
|
|
|---|---|---|
|
|
| `start_ingestion` | 分析上传文件 | 先判断矢量 PDF、DXF 或扫描图 |
|
|
| `select_region` | 选择目标户型区域 | 一张图纸可能包含多个平面区域 |
|
|
| `confirm_plan` | 确认清洗后的结构 | 必须处理低置信度墙、门窗和比例 |
|
|
| `build_blockout` | 生成 3D 白模与相机 | 不追求施工级构造 |
|
|
| `submit_style_brief` | 建立 Style DNA | 用户意图写入结构化字段 |
|
|
| `select_direction` | 锁定设计方向 | 保留方向分支和父版本 |
|
|
| `request_render` | 生成一个或多个视角 | 携带空间控制图与锁定状态 |
|
|
| `apply_edit` | 执行局部或全局修改 | 只变更受影响的状态与视角 |
|
|
| `complete_project` | 完成当前概念方案 | 输出仍标注为概念效果图 |
|
|
|
|
## 当前已实现的图纸导入
|
|
|
|
1. 网页通过 API 上传 PDF，API 同时将原文件保存到 MinIO 的原始图纸桶。
|
|
2. PDF 首页被渲染为 PNG 并保存到派生文件桶。
|
|
3. 解析器统计矢量线、矩形与曲线数量，判断矢量或扫描来源。
|
|
4. 基于页面墨迹连通区域检测一页中的多个平面候选区，不自动把整页当作唯一户型。
|
|
5. 用户在预览上明确选择目标区域后，工作流从 `region_selection` 进入 `plan_review`。
|
|
6. 项目快照、修订号和选择结果写入 PostgreSQL，API 重启后仍可恢复。
|
|
|
|
第一版限制为 PDF、25 MB、首页候选区域检测；多页选择、墙门窗语义分割与比例求解继续在 `plan_review` 阶段实现。
|
|
|
|
## Agent 分工
|
|
|
|
- Orchestrator：确定下一步、追问缺失条件、调度任务、处理失败和回滚。
|
|
- Plan Interpreter：解析图层、区域、比例和房间语义。
|
|
- Spatial Critic：检查动线、遮挡、焦点和基本几何约束。
|
|
- Style Director：维护 Style DNA，提出差异明确的风格方向。
|
|
- Layout Planner：操作结构化家具占位，不直接修改像素。
|
|
- Render Router：按任务特征选择图像模型，并生成控制输入。
|
|
- Aesthetic Reviewer：比较空间忠实度、配色、材质连续性和多视角一致性。
|
|
|
|
## 第一版人工确认点
|
|
|
|
1. 选择图纸中的目标区域。
|
|
2. 确认比例、墙、门窗和需要保留的家具。
|
|
3. 确认层高和关键开口高度。
|
|
4. 从三个风格方向中选择一个主方向。
|
|
5. 对高成本多视角生成进行确认。
|