docs(agent-week-plan): update master todo and daily plan docs

- MASTER_TODO.md: update master todo list for current sprint
- day_3_semantic_ontology_mvp.md: update semantic ontology tasks
- day_4_orchestrator_runtime.md: update orchestrator runtime tasks
- day_5_user_agent_mvp.md: update user agent tasks

chore: add server/.venv-ocr312 to .gitignore

.gitignore

@@ -14,4 +14,5 @@ Thumbs.db
 __pycache__/
 *.pyc
 server/.venv/
+server/.venv-ocr312
 server/.secrets/

document/development/agent week plan/MASTER_TODO.md

@@ -29,9 +29,9 @@
 | --- | --- | --- | --- | --- | --- |
 | Day 1 | 已完成（2026-05-11） | 基础模型与工程骨架 | 资产、版本、审核、运行日志、审计日志、基础 API、最小财务数据源 | [Day 1](./day_1_foundation_models.md) | [HTML](<../agent_week_plan_html/day-1.html>) |
 | Day 2 | 已完成，待补浏览器走查记录 | 任务规则中心联调 | 规则/技能/MCP/任务列表与详情、Markdown、版本、审核 | [Day 2](./day_2_rule_center_integration.md) | [HTML](<../agent_week_plan_html/day-2.html>) |
-| Day 3 | 已完成主体功能，待补评测样本扩充 | 语义本体 MVP | 8 字段语义解析、日志、评测入口 | [Day 3](./day_3_semantic_ontology_mvp.md) | [HTML](<../agent_week_plan_html/day-3.html>) |
+| Day 3 | 已完成主体功能，待补评测样本扩充 | 语义本体 MVP | 8 字段语义解析、日志、评测入口、OCR 摘要语义带入 | [Day 3](./day_3_semantic_ontology_mvp.md) | [HTML](<../agent_week_plan_html/day-3.html>) |
 | Day 4 | 已完成主干，待接通真实报销写链路 | Orchestrator 运行时 | 统一入口、路由、权限、工具调用、报销单写入路由、Trace | [Day 4](./day_4_orchestrator_runtime.md) | [HTML](<../agent_week_plan_html/day-4.html>) |
-| Day 5 | 已完成问答主链路，待接通真实报销落库与状态流转 | User Agent MVP | 用户问答、报销单草稿创建/补全/提交、财务查询、规则解释 | [Day 5](./day_5_user_agent_mvp.md) | [HTML](<../agent_week_plan_html/day-5.html>) |
+| Day 5 | 已完成问答主链路与 OCR 上下文透传，待接通真实报销落库与状态流转 | User Agent MVP | 用户问答、报销单草稿创建/补全/提交、财务查询、规则解释、附件/OCR 带入 | [Day 5](./day_5_user_agent_mvp.md) | [HTML](<../agent_week_plan_html/day-5.html>) |
 | Day 6 | 未开始 | Hermes MVP | 定时任务、风险巡检、日报、知识候选、规则草稿 | [Day 6](./day_6_hermes_mvp.md) | [HTML](<../agent_week_plan_html/day-6.html>) |
 | Day 7 | 未开始 | 加固、演示和验收 | 回归、测试、演示脚本、交付说明 | [Day 7](./day_7_hardening_demo_acceptance.md) | [HTML](<../agent_week_plan_html/day-7.html>) |
 
@@ -39,9 +39,17 @@
 
 - Day 1 已完成，后端基础模型、审计和最小财务数据源已可供后续能力复用。
 - Day 2 已完成主要前后端联调，当前仅剩浏览器人工走查记录待补。
-- Day 3 主体已完成，`/api/v1/ontology/parse`、8 字段返回、缺槽位追问、权限判断和前端调试入口均已落地；当前主要剩评测样本继续扩充。
+- Day 3 主体已完成，`/api/v1/ontology/parse`、8 字段返回、缺槽位追问、权限判断和前端调试入口均已落地；OCR 摘要和附件上下文也已进入语义层，当前主要剩叙述型报销、附件/OCR 带入样本和模糊追问样本继续扩充。
-- Day 4 主干已完成，Orchestrator 已具备统一入口、User Agent / Hermes 路由、权限阻断、ToolCall 记录、Trace 和降级；真实 `expense_claims` 建单 / 改单 / 提交流程尚未接通。
+- Day 4 主干已完成，Orchestrator 已具备统一入口、User Agent / Hermes 路由、权限阻断、ToolCall 记录、Trace 和降级；`expense_claims` 草稿建单与 ToolCall / Audit 已接通，但改单、提交、附件持久化和更细的 ToolCall Trace 仍未接通。
-- Day 5 问答主链路已完成，个人工作台和报销对话框已能把文本与附件名称带入 Orchestrator，并返回回答、规则引用、风险说明和结构化草稿；真实报销主表 / 明细 / 附件落库及 `draft -> submitted` 仍未完成。
+- Day 5 问答主链路已完成，个人工作台和报销对话框已能把文本、附件名称、OCR 摘要和页面上下文带入 Orchestrator，并返回回答、规则引用、风险说明和结构化草稿；真实报销主表 / 明细草稿落库已接通，但附件 / OCR 结果落库及 `draft -> submitted` 仍未完成。
+
+## Day 1 - Day 5 未完成补齐清单
+
+- Day 1：当前周计划范围内无新增遗留项，基础资产、日志、审计和最小财务表已完成；文件资产、OCR 结果表和风险事件表作为 Day 5 真落库前置底座，设计已完成但代码未落地。
+- Day 2：仍缺一轮浏览器人工走查记录，需补充规则中心真实页面联调截图或缺陷清单。
+- Day 3：仍需补充叙述型报销长句样本、附件/OCR 摘要带入样本、模糊短句追问样本，并把这些样本纳入自动评测。
+- Day 4：仍需接通 `update_expense_claim_draft` / `submit_expense_claim` 真服务，补齐附件挂接服务注册、ToolCall 更细粒度记录和前端 Trace 展示。
+- Day 5：仍需把附件和 OCR 识别结果真正落到 `document_assets`、`document_asset_versions`、`expense_item_documents`、`document_ocr_results`，并完成 `draft -> submitted` 状态流转、前端 claim/status 回显和提交流程确认。
 
 ## 关键依赖顺序
 

document/development/agent week plan/day_3_semantic_ontology_mvp.md

@@ -30,8 +30,9 @@ Orchestrator 不能直接根据原始文本做可靠路由。它需要先拿到
 
 - [x] ~~`/api/v1/ontology/parse` 已上线，8 字段语义结构、缺槽位、歧义、权限和澄清问题均可返回。~~
 - [x] ~~语义层已切到“模型优先 + 规则回退”，并把结果写入 `AgentRun` / `SemanticParseLog`。~~
+- [x] ~~附件名称、附件数量、OCR 摘要和 OCR 文档摘要已能作为上下文带入语义层。~~
 - [x] ~~前端调试入口与核心评测测试已完成并通过。~~
-- [ ] 叙述型报销样本和模糊短句追问样本仍需继续扩充。
+- [ ] 叙述型报销样本、附件/OCR 带入样本和模糊短句追问样本仍需继续扩充。
 
 相关架构文档：
 
@@ -261,6 +262,7 @@ Orchestrator 不能直接根据原始文本做可靠路由。它需要先拿到
 
 - [x] ~~创建至少 5 条报销问题。~~
 - [ ] 创建至少 5 条叙述型报销问题。
+- [ ] 创建至少 3 条附件 / OCR 摘要带入的报销问题。
 - [x] ~~创建至少 5 条应收问题。~~
 - [x] ~~创建至少 5 条应付问题。~~
 - [x] ~~创建至少 3 条知识库问题。~~
@@ -293,5 +295,6 @@ Orchestrator 不能直接根据原始文本做可靠路由。它需要先拿到
 ## 日终交接
 
 - [x] ~~已支持报销 / 应收 / 应付 / 知识 / 风险 / 草稿 / 越权动作等核心场景关键词、实体与权限解析。~~
-- [x] ~~当前仍需继续扩充的弱样本主要是叙述型报销长句和模糊短句追问。~~
+- [x] ~~语义层已可接收附件名称、附件数量和 OCR 摘要上下文，但这些样本仍需继续扩到评测集。~~
+- [x] ~~当前仍需继续扩充的弱样本主要是叙述型报销长句、附件/OCR 带入和模糊短句追问。~~
 - [x] ~~Day 4 可直接复用 `scenario / intent / entities / time_range / metrics / constraints / risk_flags / permission / confidence / missing_slots / ambiguity / parse_strategy / clarification_required / clarification_question / run_id`。~~

document/development/agent week plan/day_4_orchestrator_runtime.md

@@ -25,7 +25,9 @@
 
 - [x] ~~`/api/v1/orchestrator/run`、统一路由、权限阻断、ToolCall 记录、Trace 和降级结果已经可用。~~
 - [x] ~~用户消息已能路由到 User Agent，占位 Hermes 任务也能由定时入口触发。~~
-- [ ] 真实 `expense_claims` 建单 / 改单 / 提交链路尚未接通，当前草稿路径仍是占位执行。
+- [x] ~~附件名称、页面上下文和 OCR 摘要已能随 Orchestrator 请求透传到语义层和 User Agent。~~
+- [ ] 真实 `expense_claims` 改单 / 提交链路尚未接通；草稿建单已接到真实落库，附件与 OCR 持久化仍未完成。
+- [ ] 报销附件持久化服务、OCR 结果落库服务和前端 ToolCall 细粒度 Trace 展示尚未接通。
 
 相关架构文档：
 
@@ -111,7 +113,7 @@
 - [x] ~~`intent=query` 且来源为 user_message 时路由到 User Agent。~~
 - [x] ~~`intent=explain` 路由到 User Agent。~~
 - [x] ~~`intent=draft` 路由到 User Agent，但当前只返回草稿占位结果。~~
-- [ ] `scenario=expense` 且最小建单槽位完整时，允许进入 `create_expense_claim_draft`。
+- [x] ~~`scenario=expense` 且最小建单槽位完整时，允许进入 `create_expense_claim_draft`。~~
 - [ ] `scenario=expense` 且已有 `claim_id` 时，允许进入 `update_expense_claim_draft`。
 - [ ] `scenario=expense` 且用户明确确认提交时，允许进入 `submit_expense_claim`。
 - [x] ~~`permission.level=approval_required` 时设置 `requires_confirmation=true`。~~
@@ -127,7 +129,7 @@
 - [x] ~~新增权限判断服务或函数。~~
 - [x] ~~查询类请求返回 `read`。~~
 - [x] ~~草稿类请求返回 `draft_write`。~~
-- [ ] 报销草稿创建、字段补全、附件挂接返回 `draft_write`。
+- [ ] 报销草稿字段补全、附件挂接返回 `draft_write`。
 - [ ] 报销单提交返回 `approval_required`，并要求显式用户确认。
 - [ ] 审批、上线、付款类请求返回 `approval_required`。
 - [x] ~~用户无权限时返回 `forbidden`。~~
@@ -146,6 +148,7 @@
 - [x] ~~从 `AgentAsset` 查询 active MCP。~~
 - [x] ~~从 `AgentAsset` 查询 active 任务。~~
 - [ ] 查询可用的报销单写入服务和附件挂接服务。
+- [ ] 查询可用的 OCR 结果持久化服务和票据文件回溯服务。
 - [x] ~~过滤 disabled 能力。~~
 - [x] ~~过滤未审核 active 条件不满足的规则。~~
 - [x] ~~为每次能力选择记录 `route_json`。~~
@@ -161,7 +164,9 @@
 - [ ] 工具请求前写入 `AgentToolCall` running 或准备记录。
 - [x] ~~工具成功后写入响应和耗时。~~
 - [x] ~~工具失败后写入错误。~~
-- [ ] 报销草稿创建、更新、提交也按工具调用或等价服务调用记录。
+- [ ] 报销草稿更新、提交也按工具调用或等价服务调用记录。
+- [x] ~~报销草稿创建按工具调用或等价服务调用记录。~~
+- [ ] 附件挂接、OCR 结果落库、票据回溯查询也按工具调用或等价服务调用记录。
 - [x] ~~外部 MCP 调用失败时返回降级结果。~~
 - [x] ~~数据库查询失败时返回明确错误。~~
 - [x] ~~LLM 调用失败时返回可读提示。~~
@@ -195,6 +200,7 @@
 - [ ] 展示工具调用列表。
 - [x] ~~展示错误信息。~~
 - [ ] 展示耗时。
+- [ ] 展示报销写链路中的 claim_id / claim_no / status 变化。
 
 验收证据：
 
@@ -220,7 +226,8 @@
 - [x] ~~Orchestrator API 可用。~~
 - [x] ~~用户请求能路由到 User Agent 占位实现。~~
 - [x] ~~定时任务能路由到 Hermes 占位实现。~~
-- [ ] 语义补槽完成后的报销输入能路由到建单或改单动作。
+- [x] ~~语义补槽完成后的报销输入能路由到建单动作。~~
+- [ ] 语义补槽完成后的报销输入能路由到改单动作。
 - [x] ~~权限阻断有效。~~
 - [x] ~~运行 Trace 可查询。~~
 - [x] ~~工具调用日志可查询。~~
@@ -236,3 +243,4 @@
 - [x] ~~当前路由规则已稳定为：`user_message -> user_agent`、`schedule -> hermes`、`clarification_required -> blocked`。~~
 - [x] ~~当前权限判断已稳定为：`read / draft_write / approval_required / forbidden`，高风险动作默认阻断或要求确认。~~
 - [x] ~~Day 5 需承接的接口契约已明确：Orchestrator 向 User Agent 传入语义结果、能力码、工具结果，并期待返回 `answer / citations / suggested_actions / draft_payload / risk_flags`。~~
+- [x] ~~下一步仍需补齐的运行时写链路是：报销草稿真实落库、附件持久化、OCR 结果落库和提交状态流转。~~

document/development/agent week plan/day_5_user_agent_mvp.md

@@ -31,7 +31,8 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 
 - [x] ~~个人工作台、报销对话框和通用聊天入口已经接通真实 Orchestrator / User Agent 问答链路。~~
 - [x] ~~回答、规则引用、风险说明、建议动作和结构化 `draft_payload` 已可返回。~~
-- [ ] 真实 `expense_claims` / `expense_claim_items` / 附件表落库，以及 `draft -> submitted` 状态流转尚未完成。
+- [x] ~~报销对话框已接入 OCR 识别接口，附件名称、OCR 摘要和页面上下文已能透传到 Orchestrator / User Agent。~~
+- [ ] 真实 `document_assets` / `document_asset_versions` / `expense_item_documents` / `document_ocr_results` 落库，以及 `draft -> submitted` 状态流转尚未完成；`expense_claims` / `expense_claim_items` 草稿已接通真实落库。
 
 相关架构文档：
 
@@ -145,10 +146,11 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 
 ## 5. 草稿生成与单据落库
 
-- [ ] 支持根据语义结果创建 `expense_claims` 草稿。
+- [x] ~~支持根据语义结果创建 `expense_claims` 草稿。~~
-- [ ] 报销草稿初始状态写为 `draft`。
+- [x] ~~报销草稿初始状态写为 `draft`。~~
-- [ ] 支持根据语义结果创建或更新 `expense_claim_items`。
+- [x] ~~支持根据语义结果创建或更新 `expense_claim_items`。~~
 - [ ] 支持把用户上传附件挂到 `document_assets`、`document_asset_versions`、`expense_item_documents`。
+- [ ] 支持把 OCR 识别快照写入 `document_ocr_results`，并保留 `ocr_engine`、`ocr_model`、`raw_json`、`confidence`。
 - [ ] 对话中补充金额、事由、客户、参与人、票据后，能回写已有草稿而不是只更新内存结果。
 - [x] ~~支持生成报销处理意见草稿。~~
 - [x] ~~支持生成应收催收建议草稿。~~
@@ -159,8 +161,10 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 - [ ] 报销状态变更写入 AgentRun 结果。
 - [x] ~~草稿中标明“待人工确认”。~~
 - [x] ~~草稿不直接提交业务系统。~~
-- [ ] 草稿生成写入审计日志。
+- [x] ~~草稿生成写入审计日志。~~
 - [x] ~~草稿生成写入 AgentRun 结果。~~
+- [ ] 草稿创建或更新后向前端返回 `attachment_ids`。
+- [x] ~~草稿创建或更新后向前端返回 `claim_id`、`claim_no`、`status`。~~
 
 验收证据：
 
@@ -187,7 +191,11 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 - [x] ~~前端增加用户问题输入框。~~
 - [x] ~~输入框支持回车或按钮提交。~~
 - [x] ~~提交时调用 Orchestrator，而不是绕过 Orchestrator。~~
-- [ ] 提交时透传首句文本、附件名称、附件 ID 和页面上下文。
+- [x] ~~提交时透传首句文本。~~
+- [x] ~~提交时透传附件名称。~~
+- [x] ~~提交时透传 OCR 摘要。~~
+- [x] ~~提交时透传页面上下文。~~
+- [ ] 提交时透传附件 ID。
 - [x] ~~展示 Agent 回答。~~
 - [x] ~~展示引用规则或知识。~~
 - [x] ~~展示建议动作。~~
@@ -227,7 +235,8 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 - [ ] 测试应付查询。
 - [ ] 测试规则解释。
 - [x] ~~测试风险解释。~~
-- [ ] 测试报销草稿创建。
+- [ ] 测试 OCR 摘要透传后，User Agent 能在回答中正确引用附件语境而不编造内容。
+- [x] ~~测试报销草稿创建。~~
 - [ ] 测试报销草稿补槽更新。
 - [ ] 测试报销状态从 `draft` 变更到 `submitted`。
 - [x] ~~测试草稿生成。~~
@@ -243,7 +252,7 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 - [x] ~~User Agent 服务可被 Orchestrator 调用。~~
 - [x] ~~用户入口可提交自然语言问题。~~
 - [x] ~~至少 3 个财务场景有回答。~~
-- [ ] 语义识别完整后的报销输入能创建报销草稿。
+- [x] ~~语义识别完整后的报销输入能创建报销草稿。~~
 - [ ] 用户确认后能提交报销并更新状态。
 - [x] ~~回答能引用规则或知识。~~
 - [x] ~~高风险动作不会自动执行。~~
@@ -258,5 +267,6 @@ Day 1 到 Day 4 已经具备资产、语义、路由和日志基础，此时可
 ## 日终交接
 
 - [x] ~~当前已支持报销 / 应收 / 应付查询、规则解释、风险解释、草稿建议与澄清追问。~~
-- [x] ~~当前仍是占位的主要能力是报销单真实落库、附件持久化和知识库读取，不再是简单静态问答 Mock。~~
+- [x] ~~当前已支持附件名称、OCR 摘要和页面上下文进入对话链路，但这还不是附件真实持久化。~~
+- [x] ~~当前仍是占位的主要能力是报销单真实落库、附件持久化、OCR 结果入表和知识库读取，不再是简单静态问答 Mock。~~
 - [x] ~~Day 6 Hermes 可直接复用当前的规则检查、风险标签和 Orchestrator Trace / ToolCall 契约。~~