X-Financial/document/development/agent week plan/day_1_foundation_models.md

Day 1：基础模型与工程骨架

当前状态

• Day 1 已完成（2026-05-11）。
• 后端基础模型、API 骨架、种子数据、审计能力和 Day 2 联调入口均已落地。

今天的大开发点

Day 1 只做地基，不做复杂 Agent 智能。

核心是把后面 6 天都会用到的基础对象建出来：资产、版本、审核、运行日志、工具调用日志、语义解析日志、审计日志，以及最小财务业务数据来源。

为什么第一天做这个

如果没有稳定的数据模型，后面的任务规则中心、语义本体、Orchestrator、User Agent、Hermes 都会各自临时造结构，后期会很难合并。

今天主要交付

• 统一资产模型：规则、技能、MCP、任务。
• 版本模型：规则 Markdown 和其他资产配置快照。
• 审核模型：未审核不能上线。
• Agent 运行日志：所有 Agent 执行都有 run_id。
• 工具调用日志：MCP、数据库、LLM、OCR、规则引擎调用都可追踪。
• 语义解析日志：后续语义本体结果可回放。
• 审计日志：所有写操作可追责。
• 最小财务业务数据来源：报销、应收、应付。

实际落地结果

• 新增 AgentAsset、AgentAssetVersion、AgentAssetReview、AgentRun、AgentToolCall、SemanticParseLog、AuditLog、ExpenseClaim、ExpenseClaimItem、AccountsReceivableRecord、AccountsPayableRecord。
• 新增 /api/v1/agent-assets、/api/v1/agent-runs、/api/v1/audit-logs 相关接口。
• 种子数据已覆盖 3 条规则、2 条技能、2 条 MCP、3 条任务，以及报销 / 应收 / 应付示例数据。
• 旧开发库启动时会自动补齐新增资产和版本，不需要手动清库。

对应执行细则

• Day 1 执行细则

相关架构文档：

• 整体架构
• 语义本体
• 数据契约与治理
• 能力注册
• 权限与确认
• 观测与 Trace
• 财务单据标准模型

当天验收门槛

• 数据库或等价存储能创建基础对象。
• API 服务能启动。
• 资产列表能返回规则、技能、MCP、任务。
• 规则资产能关联 Markdown 当前版本。
• 未审核规则不能上线。
• AgentRun 能保存一条运行记录。
• AuditLog 能保存一条写操作记录。

Day 2 联调入口

• GET /api/v1/agent-assets
• GET /api/v1/agent-assets/{asset_id}
• GET /api/v1/agent-assets/{asset_id}/versions?limit=5
• POST /api/v1/agent-assets/{asset_id}/reviews
• POST /api/v1/agent-assets/{asset_id}/activate
• GET /api/v1/audit-logs

今天不做

• 不做完整 Agent 对话。
• 不做完整 Hermes 调度。
• 不做真实 OCR。
• 不做复杂规则推理。