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

2026-09-16 12:24:49 +08:00
commit 8a6c55d94a
124 changed files with 12168 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Controller 当前开发进度
+
+更新时间：2026-09-15
+
+## 已完成并验证
+
+- 图片附件任务闭环：批量 `@` 与单独指派均可粘贴/选择受限图片；多条有效批量任务必须以“图片 N”逐行路由，同一行多个目标只共享该编号图片。附件经认证 WSS 下发、本地持久化供重试复用，任务详情仅显示安全缩略图和数量；清除结束任务同时清除附件。未配置视觉能力的模型会安全拒绝，不会丢图或降级为文本。
+
+- 新版 Agent 默认完全访问：总控仍只通过已认证 WSS 下发任务，但 Agent 可在其所在 Windows 电脑实际操作文件、程序、网络和桌面应用。任务详情会把实际调用过本机执行工具的结果标为“完全访问”；结果、日志与审计摘要持续脱敏，不保存 API Key、密码、凭据、图片 Base64 或内部推理。
+
+- 独立 Wails2（Go + React/TypeScript）总控工程、独立数据目录、TLS/WSS 服务和 Windows 编译脚本。
+- 一次性配对码、证书指纹校验、Agent 认证、心跳、离线判定、名称修改和撤销配对。
+- 多 Agent 独立文本任务下发、状态回传、取消、超时和重试；任务记录持久化到总控本地数据库。一次最多可下发 20 条不同目标的任务；单条失败不会阻塞其它任务。
+- 新任务默认使用 5 分钟无进展超时，而非绝对总时长；Agent 回传接收或执行进展会刷新下一次超时点。任务页可按需设为 15、30 分钟或 1 小时。
+- 总控基础界面：主导航依次提供控制台、智能体、批量指派、单独指派及密钥与配对；控制台包含按机器汇总的实时任务状态和任务历史，两种批量下发方式集中在“批量指派”。
+- 总控 LLM 配置页：内置 OpenAI、Anthropic、Gemini、DeepSeek、OpenRouter、Groq、Mistral、xAI、Together、硅基流动、Moonshot、MiniMax、Ollama、LM Studio、vLLM 预设，并支持任意 OpenAI 兼容的中转站或本地模型。
+- LLM API Key 使用 Windows DPAPI 加密后保存于总控本机；列表只显示“已保护保存”，不会回显 Key。
+- 总控可将指定 LLM 配置下发给指定 Agent；在线 Agent 立即接收，离线 Agent 会在下次认证连接时补齐。总控显示等待、已发送、已应用或失败的回执状态。
+- Skills 已采用 Markdown 仓库、哈希校验和按 Agent 下发；子端只受控安装，不执行 Skill 中的脚本。
+- 旧版桌面文件 MCP 状态机保留为兼容记录；它不再限制新版 Agent 的默认本机权限。插件与 MCP 页面会明确显示“本机完全访问：默认启用”。
+- Agent 管理页会汇总显示 LLM、Skill 与 MCP 的部署/应用状态；本地审计日志已覆盖 MCP 下发、回执和工具结果，不保存 API Key、配对凭据或完整任务提示词。
+- Agent 返回的任务输出会在接收端去除 `<think>...</think>`（含未闭合标签），避免内部推理显示到任务结果或审计中。
+- 最近任务卡片和详情会保留并显示执行 Agent 名称；可一键清除已结束任务及其任务时间线，进行中的任务与审计日志会保留。
+- Skills 页面提供可搜索的只读 Markdown 浏览器：按名称或版本即时过滤，逐行显示名称、版本和更新时间，按需加载正文；预览会脱敏 API Key、密码、令牌、账号等敏感字段，不执行任何 Markdown 内容。
+- Agent 管理页已升级为服务端分页目录：支持名称搜索，以及在线/离线、MCP、LLM、Skill 状态组合筛选。Agent 详情提供最近任务、最近安全审计、部署历史、当前失败原因和既有 Skills/MCP 配置；列表与详情中的失败文本会脱敏敏感字段。
+- 认证确认会在 LLM、Skill、MCP 配置快照之前发送，避免重连时部署快照抢先到达；认证后的持久化配置仍会异步补发。
+- 审计日志已升级为统一、可筛选的本地基础设施：记录时间、操作者、目标 Agent、资源类型、动作、结果和安全摘要；支持按 Agent、资源类型、结果、时间范围服务端分页筛选。现有配对、Agent、LLM、Skill、MCP、任务链路均已覆盖；安全摘要不保存 API Key、配对凭据、完整任务提示词或内部推理，清除任务历史也不会删除审计。
+- 子 Agent 的独立任务执行已通过并发回归：同一台机器收到多条任务时会分别进入后台执行；多台机器可同时处理各自任务。日常使用应按机器资源自行控制同机任务数量。
+- “批量指派”和“单独指派”是彼此独立的任务入口：单独指派会明确选择一台在线 Agent；批量指派只提供公共 `@` 输入，不保留重复的多条任务草稿。`@` 支持点选或键盘选择 Agent，并按换行拆成不同任务；同一行的多个 Agent 会各自收到完全相同的任务。未知、重名、离线和未指定的目标均不会误发。
+- 任务内容会拒绝 API Key、配对凭据、账号密码及 `<think>` 内部推理，避免进入界面、任务记录、日志、结果或审计摘要。
+- 旧 FastAPI Dashboard 的导航信息架构已迁入：模板、技能、插件、工作流、定时任务、密钥、委派、审计日志、设置等页面均已有入口；尚未迁移的页面显示“正在开发”。
+- 用户、记忆、帮助及旧登录/角色模型已按当前产品决策移除。
+
+## 最近编译
+
+- `build/bin/MultiClawController.exe` 已于 2026-09-15 重新编译（含独立的批量指派页面、单独指派与 5 分钟无进展续期）。
+
+## 接下来按旧版能力迁移的顺序
+
+1. 优先补齐离线任务队列、重连补传和子 Agent 重启恢复，增强多机任务闭环的可靠性。
+2. 需要复用任务时再实现模板、定时任务、工作流和委派，均由总控持久化和触发。
+3. 将 MCP 扩展为带版本、权限清单、哈希、回滚和多工具状态的受控仓库；插件包保留独立入口。
+4. 最后实现 Agent 守护服务，提供远程启动、停止、重启和升级。
+
+## 已规划，尚未实现
+
+- 总控定时任务、委派规则与工作流执行器。
+- Skills、插件与 MCP 工具的签名、版本回滚和完整包生命周期。
+- 定时任务、模板、工作流、委派和远程运维的审计扩展。
+- Agent 守护服务及其远程启动、停止、重启、升级能力。
+
+## 进度判断
+
+- **可测试基础闭环**（配对、在线、任务、取消、重试）：约 **70%**。
+- **最终集中管理目标**（统一 LLM/Skill/MCP/定时器/远程运维）：约 **35%**。
+
+当前策略：优先迁移旧版有价值的总控功能和页面，再把每项能力通过 WSS 下发给独立子 Agent；不迁移旧 FastAPI、Node.js、旧 Python Agent 运行环境，也不恢复用户、登录、记忆、帮助或 Tailscale 发现。