mulit-agent/controller/docs/steps/11-Agent管理与配对生命周期.md

11：Agent 管理与配对生命周期

本阶段目标

让 Wails 总控能管理多个子 Agent，而不仅是显示在线数量。

已实现范围

1. 新增独立 Agent 页面，列出当前在线和离线的 Agent。
2. 每个 Agent 显示不可变 ID、显示名称、状态和最后心跳时间。
3. 允许修改显示名称，不改变 Agent 身份或凭据。
4. “撤销配对”会立即关闭当前 WSS 会话并删除配对记录；Agent 再次连接时会被拒绝，必须重新配对。
5. “添加 / 重新配对”只跳转到独立的“安全与配对”页面，不在 Agent 列表或概览页泄露配对码。

安全边界

• 前端只有 Agent 查询、改名和撤销三个受限绑定，不可读到凭据哈希、TLS 私钥或数据库原始内容。
• 撤销会移除 Agent 配对记录，但不删除已有任务与审计历史。
• 已移除的 Agent 不能通过旧凭据认证。

验收

1. 完成一个 Agent 的配对后，确认其出现在 Agent 页面并显示在线。
2. 修改名称并刷新，确认名称被持久化。
3. 点击“撤销配对”并确认，Agent 卡片立即消失且连接断开。
4. 重启 Agent，确认旧凭据被拒绝；生成新配对码后可作为新的 Agent 加入。