zhuangxiu/docs/workflow.md

工作流定义

阶段

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. 对高成本多视角生成进行确认。