V3 生命周期 — main→develop 等价映射
main 分支的 Manager 生命周期管理能力（9 commit）在 develop V3 架构中 已由 worker 模块完整吸收。本文档记录等价关系，说明为何 Group E 跳过移植。
等价映射
| main 能力 | main 位置 | develop 等价位置 | 说明 |
|---|---|---|---|
| Agent CRUD + lifecycle API | manager/api/agents.py | services/manager/app/api/agent_instances.py | V3 三层模型：AgentInstance 替代 Agent，含 publish/offline 状态机 |
| 部署编排服务 | manager/services/deployment_service.py | services/manager/app/worker/router.py + k8s_manager.py | deploy_flow / suspend / destroy / wakeup / hot_reload / apply_config 全覆盖 |
| K8s STS 管理 | manager/infra/k8s_manager.py（StatefulSet） | services/manager/app/worker/k8s_manager.py（Deployment） | V3 升级为 Deployment 模式，支持 replicas 缩放 + pod_manager 轮询 |
| Pod 状态查询 | manager/infra/k8s_manager.py get_sts_status | services/manager/app/worker/pod_manager.py | 独立模块，4 档轮询频率（deploying→running→suspended→destroyed） |
| idle 自动回收 | manager/services/deployment_service.py _check_idle | services/manager/app/worker/recycle_scheduler.py | RecycleScheduler 5min 检测 → 30min idle SUSPEND；CleanupScheduler 1h → 24h DESTROY |
| metric 周期采样 | manager/services/deployment_service.py _sample | services/manager/app/worker/metric_sampler.py | MetricSampler 60s 采样 Pod CPU/内存 → resource_metric_samples 表，7d 保留 |
| 外键级联删除 | migrate_fk_cascade.sql | services/manager/app/models/__init__.py | Base.metadata 已用 ondelete="CASCADE"（22 处），无需独立 migration |
| Deploy 事件面板 | admin DeployConfigTab.vue | apps/admin/.../DeployEventsPanel.vue | 4 档轮询频率 + 实时事件流 |
| 健康检查巡检 | manager/services/deployment_service.py _monitor | services/manager/app/worker/router.py _update_active_loop | 60s 更新 last_active_at + profile 一致性巡检 |
V3 新增能力（main 无）
- AgentDefinition / AgentVersion / AgentInstance 三层模型 — 草稿/发布/实例分离
- ResourcePool 资源池 — 多租户资源隔离
- AgentInstanceChannel — 实例↔渠道绑定（独立于 deployment）
- profile_resolver — gateway 层 Profile 路由解析（60s 正缓存 + 10s 负缓存）
- 用户身份双通道注入（复用时间注入 ephemeral system 机制）：
- ephemeral 注入（每轮自动）：gateway 转发前往 messages system / instructions 追加「当前用户身份」（角色/用户组/业务用户名，非 PII），走 hermes ephemeral system 通道（叠加在 core 之上、不覆盖、不持久化、core prefix cache 不受影响）。
profile_resolver.resolve内调 manager/user-context端点拉取 + 60s 缓存，注入点（proxy/dispatcher）按 profile_name 查缓存。智能体每轮自动知道当前用户是谁。 - current-user-info pull skill（按需）：智能体经
terminal跑脚本调 manager 只读端点GET /api/controller/profiles/{profile_name}/user-context，拉完整信息（含手机号/邮箱等强 PII，不进 langfuse trace）。 - 分工：高频低敏感（业务身份）走 ephemeral；低频高敏感（联系方式）走 pull。ephemeral 只注非 PII 避免 PII 进 trace。
- ephemeral 注入（每轮自动）：gateway 转发前往 messages system / instructions 追加「当前用户身份」（角色/用户组/业务用户名，非 PII），走 hermes ephemeral system 通道（叠加在 core 之上、不覆盖、不持久化、core prefix cache 不受影响）。
- minio_archiver — SUSPEND 时 PVC→MinIO 归档（零开销存档策略）
结论
develop V3 worker 已完整吸收 main 的生命周期能力，并在此基础上增加了 三层模型、资源池、Profile 路由等 V3 特性。Group E 跳过 cherry-pick， 仅文档化等价关系。
相关文件
services/manager/app/worker/— background.py / k8s_manager.py / pod_manager.py / recycle_scheduler.py / metric_sampler.py / minio_archiver.py / user_md_sync.py / router.pyservices/manager/app/api/agent_instances.py— V3 实例 APIservices/manager/app/models/__init__.py— V3 三层模型 + ondelete CASCADE
相关记忆
- [[monitoring-wiring-status]] — 监控栈部署状态