mirror of
https://github.com/aiclientproxy/proxycast.git
synced 2026-10-16 07:16:36 +08:00
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
# Execution Tracker 后续路线（P1 / P2）
|
||
|
||
## 1. 目标说明
|
||
|
||
P0 已完成统一追踪能力落地；本路线定义下一阶段（P1/P2）可执行改进项，用于持续提升一致性、可观测性与运维效率。
|
||
|
||
## 2. P1（应做，近期）
|
||
|
||
## P1-1 生命周期统一收敛
|
||
|
||
- 目标：Skill / Heartbeat 入口统一切换为 `with_run` 风格
|
||
- 收益：减少重复生命周期模板代码，降低维护成本
|
||
- 交付：
|
||
- 入口改造 PR
|
||
- code review checklist（执行追踪接入规范）
|
||
|
||
## P1-2 一致性与悬挂监控
|
||
|
||
- 目标：建立 `running` 悬挂探测与告警机制
|
||
- 收益：提前发现 finish 漏写、异常中断等问题
|
||
- 交付：
|
||
- 定时巡检任务（阈值可配置）
|
||
- 统计指标：悬挂数、悬挂时长分布、来源维度占比
|
||
|
||
## P1-3 旧路径读侧收敛
|
||
|
||
- 目标：禁止新增模块依赖 `heartbeat_executions` 写路径
|
||
- 收益：为单写切换清障，避免双写长期化
|
||
- 交付：
|
||
- 文档与注释标记（deprecated 说明）
|
||
- 读写链路梳理清单
|
||
|
||
## 3. P2（可做，中期）
|
||
|
||
## P2-1 执行追踪聚合 API
|
||
|
||
- 目标：提供按来源/状态/时间窗口的聚合统计接口
|
||
- 收益：支撑运营看板、质量趋势分析
|
||
- 交付：
|
||
- 聚合命令/API（例如成功率、P95 时延、错误 TopN）
|
||
|
||
## P2-2 追踪与日志链路关联
|
||
|
||
- 目标：在 run 维度关联请求日志、会话消息与错误栈索引
|
||
- 收益：故障排查从“多处跳转”收敛到“单 run 入口”
|
||
- 交付：
|
||
- run → 日志/会话的关联字段规范
|
||
- 前端详情页一跳联查能力
|
||
|
||
## P2-3 数据归档与保留策略
|
||
|
||
- 目标：定义 `agent_runs` 分层保留与归档策略
|
||
- 收益：控制数据量增长，保障查询性能
|
||
- 交付：
|
||
- 保留周期配置（热数据/冷数据）
|
||
- 清理任务与容量水位监控
|
||
|
||
## 4. 建议里程碑
|
||
|
||
- M1（1-2 周）：完成 P1-1、P1-2
|
||
- M2（2-4 周）：完成 P1-3，启动单写切换评估
|
||
- M3（4-8 周）：推进 P2 聚合与链路关联能力
|