mulit-agent/controller/docs/steps/15-Agent规模化管理.md

15：Agent 规模化管理

已实现范围

1. Agent 目录由总控 SQLite 服务端分页，页大小限制为 1 至 50；名称搜索使用参数化 LIKE 查询并转义通配符。
2. 支持组合筛选在线/离线、MCP、LLM 和 Skill 状态。Skill 状态会汇总为未选择、等待连接、下发中、已应用或失败；任一 Skill 失败优先显示失败。
3. Agent 详情返回受限的最近任务、最近安全审计、部署历史和当前失败原因。详情记录有数量上限，且失败文本经过显示层脱敏；不返回 API Key、配对凭据或内部推理。
4. 配置下发的认证确认优先于异步 LLM、Skill、MCP 快照，避免重连后出现未认证配置快照。

回归范围

• Go 测试覆盖分页、名称和状态组合筛选、非法筛选拒绝、失败原因脱敏，以及 Agent 详情的任务、审计和部署轨迹。
• 原有 WSS/MCP 重连补发与幂等回执测试继续通过。

验收

1. 在“智能体”页面用名称与任意状态组合筛选，确认分页总数和卡片状态来自总控服务端。
2. 打开任意卡片，确认可见最近任务、审计、部署历史和失败原因；敏感字段不得显示。
3. 离线 Agent 的下发显示等待连接，重连后先收到认证确认，再恢复持久化配置快照。