proxycast/docs/develop/execution-tracker-p0-acceptance-report.md

Execution Tracker P0 验收报告

验收日期：2026-02-20
对应规划：docs/develop/execution-tracker-technical-plan.md

1. 验收范围

本报告仅覆盖统一执行追踪专项的 P0 目标，不包含其他产品线功能（如创作画布、Provider 扩展等）。

2. 结果结论

P0 目标整体达成，统一执行追踪已进入可用状态并通过构建与测试验证。

3. 已完成项（按 P0 目标映射）

3.1 统一 run 模型与数据层

已完成：

• 新增 agent_runs 表与索引
• 新增 AgentRunStatus 统一状态枚举
• 新增 AgentRunDao（create/finish/get/list）
• 终态写入具备幂等保护（finished_at IS NULL）

关键文件：

• src-tauri/crates/core/src/database/schema.rs
• src-tauri/crates/core/src/database/dao/agent_run.rs

3.2 统一执行追踪服务

已完成：

• 新增 ExecutionTracker
• 提供 start / finish_success / finish_error / finish_with_status
• 新增 with_run 包装器（减少生命周期重复代码）
• 支持环境变量灰度开关：PROXYCAST_EXECUTION_TRACKER_ENABLED

关键文件：

• src-tauri/src/services/execution_tracker_service.rs

3.3 三大执行入口接入

已完成：

• Skill 入口：execute_skill 接入追踪
• Chat 入口：aster_agent_chat_stream 接入追踪（已改用 with_run）
• Heartbeat 入口：按任务粒度接入追踪并映射状态

关键文件：

• src-tauri/src/commands/skill_exec_cmd.rs
• src-tauri/src/commands/aster_agent_cmd.rs
• src-tauri/src/services/heartbeat_service/mod.rs

3.4 查询接口与最小前端观测

已完成：

• 后端命令：execution_run_list / execution_run_get
• 设置页新增“执行轨迹”面板（筛选、详情、自动刷新、复制）
• 聊天页与心跳页接入统一状态徽标

关键文件：

• src-tauri/src/commands/execution_run_cmd.rs
• src/components/settings-v2/system/execution-tracker/index.tsx
• src/components/execution/LatestRunStatusBadge.tsx

3.5 旧路径退场规划

已完成：

• 新增旧路径退场文档，明确阶段、时间窗口与回滚策略

关键文件：

• docs/develop/execution-tracker-deprecation-plan.md

4. 验证记录

已通过：

• cd src-tauri && cargo check
• cd src-tauri && cargo test -p proxycast-core agent_run::tests -- --nocapture
• cd src-tauri && cargo test -p proxycast execution_tracker_service::tests -- --nocapture
• npm run build

5. 与 P0 验收标准对照

标准 1：三个执行入口全部接入 execution_tracker

结果：通过。

标准 2：至少一个统一查询接口可用于调试与 UI 展示

结果：通过（execution_run_list/get + 执行轨迹面板）。

标准 3：旧路径进入可下线状态（有迁移清单和时间点）

结果：通过（退场计划文档已给出阶段和时间窗）。

标准 4：无新增重复生命周期逻辑

结果：通过（统一追踪服务已收敛，with_run 已建立标准接入方式；后续入口将按该模式持续统一）。

6. 风险与后续动作（非 P0 阻塞）

1. Heartbeat 历史表仍处于并存阶段，需按退场计划逐步降级为只读。
2. Skill/Heartbeat 入口可继续向 with_run 统一风格收敛，以进一步减少生命周期模板代码。
3. 建议在后续版本补充跨入口一致性统计报表（用于监控“running 悬挂率”）。