chore: initial commit (sources + docs, ignore build artifacts and secrets)

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

@@ -0,0 +1,19 @@
+# 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 的下发显示等待连接，重连后先收到认证确认，再恢复持久化配置快照。