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

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

@@ -0,0 +1,26 @@
+# 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 加入。