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

controller/docs/steps/14-MCP受控桌面工具闭环.md

@@ -0,0 +1,19 @@
+# 14：MCP 受控桌面工具闭环
+
+## 已完成范围
+
+1. 总控可为指定 Agent 启用内置 `desktop-filesystem` MCP；分配和单调递增的部署版本持久化在总控数据库，状态为 `pending`、`sent`、`applied` 或 `failed`。
+2. 在线 Agent 会立即收到带部署版本的认证 WSS 快照；离线 Agent 在认证重连后自动重收同一持久化分配。Agent 在本机保存启用状态和版本，并对重复快照幂等回执。
+3. 该工具只识别明确的“在桌面创建文件夹”任务，只能创建桌面直接子文件夹；已存在目标、路径穿越或非法名称会失败，绝不覆盖。命中该工具意图但工具未部署/未应用时也会明确失败，绝不降级给 LLM。
+4. 总控审计记录部署请求、快照下发、Agent 回执和真实工具结果，且不记录 API Key、配对凭据或完整任务提示词。
+5. Agent 管理页显示每台 Agent 的 LLM、Skill 与 MCP 应用状态；任务输出和审计均会移除模型 `<think>` 内容。
+
+## 验证
+
+- Go WSS 协议测试覆盖 MCP 下发、持久化版本、过期回执忽略、认证重连重发、回执恢复、任务结果回传、审计和 `<think>` 过滤。
+- 子 Agent pytest 覆盖桌面文件夹创建、未部署拒绝而不调用 LLM、路径穿越拒绝、版本持久化与重复快照回执。
+- Windows 端到端手工验收需使用唯一目录名，并确认总控的任务详情、审计记录和 Agent 本地状态均为本次部署版本；不得以 Skill 文本或 LLM 回复替代真实目录创建证据。
+
+## 下一步
+
+将单一内置 MCP 升级为带版本、权限清单、哈希、签名和回滚的受控工具仓库；插件运行时扩展仍保持独立入口。