提交一次代码

docs/project/requirements/M002-order-task-workflow-v1.md

@@ -1,7 +1,7 @@
 # M002 Order Task Workflow 订单任务主流程 V1
 
-> 文档状态：历史参考。当前 M002 订单任务主流程已由
-> `M002-order-task-workflow-v2.md` 承接；后续开发、接口和测试优先以 V2 为准。
+> 文档状态：历史参考。当前 M002 后续开发基线已由
+> `M002-order-task-workflow-v3.md` 承接；V2 保留为当前阶段实现记录。
 > 本文只用于理解早期流程讨论和边界来源。
 
 ## 文档信息

docs/project/requirements/M004-debug-eml-superagent-upload-v1.md

@@ -47,6 +47,7 @@ Inbox 作为来源事实，但不创建订单、不创建任务、不写 AI 任
 - Debug EML 的 `external_message_id` 由后端生成，格式为 `debug-eml-run-{debugRunId}-{sha256前缀}`，避免同一封 `.eml` 多次上传被 SourceMessage 幂等覆盖。
 - 原始邮件 `Message-ID` 不再作为 Debug EML 的 `external_message_id`，而是保存到 `agentbus_like_payload.source.original_message_id`。
 - EML 会话解析支持 `References` / `In-Reply-To` / `Thread-Index`；缺失时再回退到当前消息 ID 或 debug 会话 ID。
+- Debug run 在解析、OSS 上传、构造 SourceMessage、写入 SourceMessage、调用 SuperAgent 前写入运行中阶段状态，便于测试环境定位卡点。
 - SourceMessage 写入成功后先把 debug run 标记为 `SOURCE_CAPTURED`；即使后续 SuperAgent 调用失败，也保留 SourceMessage 和 OSS 原文追溯信息。
 - HTML 正文复用邮件会话详情的 sanitize 策略，返回 `html_body_sanitized`、`html_sanitize_required` 和 `html_render_mode`。
 - `cid:` 图片替换支持大小写不敏感的 scheme，并兼容常见的尖括号和 URL 编码尖括号形式。
@@ -92,14 +93,21 @@ Inbox 作为来源事实，但不创建订单、不创建任务、不写 AI 任
 ```text
 Debug 页面上传 .eml
 → 后端校验 X-TH-Hotel-Debug-Upload-Key
+→ debug run 标记为 PARSING_EML
 → 解析 MIME 邮件结构
+→ debug run 标记为 UPLOADING_ORIGINAL_EML
 → 上传原始 .eml 到阿里云 OSS
+→ debug run 标记为 UPLOADING_MEDIA
 → 上传内联图片到阿里云 OSS
+→ debug run 标记为 UPLOADING_MEDIA
 → 上传普通附件到阿里云 OSS
+→ debug run 标记为 BUILDING_SOURCE_MESSAGE
 → 替换 HTML 正文中的 cid: 图片引用
 → 组装 AgentBus-like payload
+→ debug run 标记为 CAPTURING_SOURCE_MESSAGE
 → 调用 SourceMessageCaptureService 写入 SourceMessage Inbox
 → debug run 标记为 SOURCE_CAPTURED
+→ debug run 标记为 CALLING_SUPERAGENT
 → 调用 SuperAgent Open API 创建 session
 → 调用 messages/stream 发送邮件 payload
 → 解析 SSE 最终回答
@@ -338,8 +346,8 @@ platform_debug_eml_superagent_run
 | `superagent_run_id` | SuperAgent run ID |
 | `superagent_raw_answer` | SuperAgent 最终文本回答 |
 | `superagent_parsed_json` | 后端解析出的 JSON |
-| `run_status` | `CREATED`、`SOURCE_CAPTURED`、`SUPERAGENT_SUCCEEDED`、`SUPERAGENT_FAILED`、`FAILED` |
-| `safe_error_summary` | 安全错误摘要，不包含正文、Secret 或附件签名 URL |
+| `run_status` | `CREATED`、`PARSING_EML`、`UPLOADING_ORIGINAL_EML`、`UPLOADING_MEDIA`、`BUILDING_SOURCE_MESSAGE`、`CAPTURING_SOURCE_MESSAGE`、`SOURCE_CAPTURED`、`CALLING_SUPERAGENT`、`SUPERAGENT_SUCCEEDED`、`SUPERAGENT_FAILED`、`FAILED` |
+| `safe_error_summary` | 运行中保存安全阶段摘要，失败时保存安全错误摘要；成功后清空为 `NULL`，不包含正文、Secret 或附件签名 URL |
 | `created_at` / `updated_at` | 创建和更新时间，按 UTC 写入 |
 
 说明：