mulit-agent/controller/docs/steps/10-Wails2迁移与信息架构.md

10：Wails2 迁移与信息架构

已完成迁移

1. controller 根目录已切换为 Wails2 工程：Go 负责控制平面，React/TypeScript 负责界面。
2. 旧 PySide6 总控入口、项目定义、源码与测试已从工作根目录移除；旧发布产物仅保留在隐藏归档目录，不能被默认构建入口使用。
3. build.ps1 和 build.bat 默认构建 Wails 发布包 build/bin/MultiClawController.exe。
4. 当前 Wails 控制平面已覆盖首次配对、TLS 指纹校验、WSS 心跳、单 Agent 任务下发和最终结果回传。

当前界面架构

• 概览：总控状态、在线 Agent、运行任务、当前电脑 IP 和 Agent 连接地址；不展示配对码。
• 任务：选择在线 Agent、下发文本任务、查看持久化的最近任务结果。
• 安全与配对：沿用旧 Dashboard 的“密钥独立页面”原则，生成仅可使用一次、十分钟有效的配对码。该配对码不同于旧系统的长期 API Key，包含 TLS 指纹且不写入界面持久化状态。

验收

1. 启动 build/bin/MultiClawController.exe，确认概览显示本机 IP。
2. 在“安全与配对”生成代码，并在子 Agent 使用该 IP/连接地址完成配对。
3. 在“任务”页面向在线 Agent 下发文本任务，确认状态与结果回传。