Files
X-Financial/document/development/agent week plan/MASTER_TODO.md
caoxiaozhu 4792b5074f 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
2026-05-12 03:00:54 +00:00

5.6 KiB
Raw Blame History

Agent Week Plan 总控

本文件是本周总览和执行索引。

每个 Day 文档现在同时包含:

  • 路线图
  • 当前完成情况
  • 验收门槛
  • 详细执行清单

不再跳转独立执行细则目录。

快速浏览

执行方式

  1. 先看本文件,确认今天做哪一天、当前状态和依赖顺序。
  2. 再打开当天 daily 文档,直接在同一份文档里推进开发。
  3. 完成一个最小 TODO 后,再改成 [x] ~~...~~
  4. 每天结束时回填阻塞记录、验收结果和日终交接。

一周节奏

Day 状态 主题 主要交付 Markdown HTML
Day 1 已完成2026-05-11 基础模型与工程骨架 资产、版本、审核、运行日志、审计日志、基础 API、最小财务数据源 Day 1 HTML
Day 2 已完成,待补浏览器走查记录 任务规则中心联调 规则/技能/MCP/任务列表与详情、Markdown、版本、审核 Day 2 HTML
Day 3 已完成主体功能,待补评测样本扩充 语义本体 MVP 8 字段语义解析、日志、评测入口、OCR 摘要语义带入 Day 3 HTML
Day 4 已完成主干,待接通真实报销写链路 Orchestrator 运行时 统一入口、路由、权限、工具调用、报销单写入路由、Trace Day 4 HTML
Day 5 已完成问答主链路与 OCR 上下文透传,待接通真实报销落库与状态流转 User Agent MVP 用户问答、报销单草稿创建/补全/提交、财务查询、规则解释、附件/OCR 带入 Day 5 HTML
Day 6 未开始 Hermes MVP 定时任务、风险巡检、日报、知识候选、规则草稿 Day 6 HTML
Day 7 未开始 加固、演示和验收 回归、测试、演示脚本、交付说明 Day 7 HTML

当前完成情况

  • Day 1 已完成,后端基础模型、审计和最小财务数据源已可供后续能力复用。
  • Day 2 已完成主要前后端联调,当前仅剩浏览器人工走查记录待补。
  • Day 3 主体已完成,/api/v1/ontology/parse、8 字段返回、缺槽位追问、权限判断和前端调试入口均已落地OCR 摘要和附件上下文也已进入语义层,当前主要剩叙述型报销、附件/OCR 带入样本和模糊追问样本继续扩充。
  • Day 4 主干已完成Orchestrator 已具备统一入口、User Agent / Hermes 路由、权限阻断、ToolCall 记录、Trace 和降级;expense_claims 草稿建单与 ToolCall / Audit 已接通,但改单、提交、附件持久化和更细的 ToolCall Trace 仍未接通。
  • 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_assetsdocument_asset_versionsexpense_item_documentsdocument_ocr_results,并完成 draft -> submitted 状态流转、前端 claim/status 回显和提交流程确认。

关键依赖顺序

  1. Day 1 必须先完成,因为后面所有能力都依赖资产、版本、审核、日志。
  2. Day 2 必须在 Day 3 前完成,因为语义和 Agent 需要读取规则、技能、MCP、任务资产。
  3. Day 3 必须在 Day 4 前完成,因为 Orchestrator 依赖语义本体做路由。
  4. Day 4 必须在 Day 5 / Day 6 前完成,因为 User Agent 和 Hermes 都应该由 Orchestrator 调用。
  5. Day 5 和 Day 6 可以部分并行但都必须遵守权限、审计、Trace。
  6. Day 7 不新增大功能,只做加固、验收和交接。

最终验收

  • 任务规则中心能看到规则、技能、MCP、任务。
  • 规则详情能编辑 Markdown、查看最近 5 个版本、切换版本。
  • 未审核规则不能上线。
  • 用户问题能解析出语义本体 8 字段。
  • Orchestrator 能路由到 User Agent 和 Hermes。
  • User Agent 能完成查询、解释、报销单草稿创建、字段补全和提交前确认。
  • Hermes 能执行一次风险巡检或日报任务。
  • AgentRun、ToolCall、AuditLog 都能追溯。
  • 有演示脚本和下一阶段交接文档。