mulit-agent/controller/docs/steps/18-自然多Agent指派.md

18：自然多 Agent 指派

目标

在不改变既有 WSS/TLS、任务取消、超时、重试、LLM、Skill 或受控 MCP 闭环的前提下，提供两个明确分离的任务入口：单独指派，以及公共 @Agent名称 批量指派。

已实现范围

1. 主导航依次提供“控制台、智能体、批量指派、单独指派”；批量指派不再放入控制台。控制台仅保留总览、各机器运行状态与统一任务记录。
2. “单独指派”页面必须下拉选择一台在线 Agent，随后下发一条独立文本任务；状态、结果、失败、取消和重试仍在统一任务记录中处理。
3. “批量指派”页面只提供公共 @ 输入区，避免与“单独指派”重复。输入 @ 会弹出在线 Agent 候选，支持名称过滤、方向键、回车确认和 Esc 关闭；点击在线 Agent 仍可插入 @名称，不依赖操作者记住显示名称。
4. 每个非空行是一组独立任务。@设计机 在桌面新建文件夹 与下一行 @文案机 新建文本文档 会分别下发不同任务；@设计机 @文案机 做发布检查 会向两台机器创建两条内容相同的独立任务。
5. 解析仅接受已登记 Agent 的完整显示名称和边界；未知名称、重名、离线目标、缺少任务内容和未指定目标均会显示逐项原因，绝不根据前缀或相似名称误发到其它机器。
6. 两种入口都复用现有 task_dispatch、任务持久化和执行状态机，不引入对话上下文、附件、任意 Shell、远程终端或旧 FastAPI Spawn Agent。
7. 用户任务在持久化或下发前拒绝 API Key、配对凭据、账号密码及 <think> 内部推理，避免其进入界面、任务记录、日志、结果或审计摘要。
8. 新任务默认使用 5 分钟无进展超时；Agent 回传有效执行进展时，总控会续期。可按任务选择更长窗口。

验证

• Go 回归覆盖按行 @ 拆分、同一行多 Agent 的相同任务、未知名称、重名、离线目标和无目标文本的安全拒绝。
• 子 Agent pytest 覆盖独立文本任务；既有并发、取消、超时和 MCP 测试保留。
• go test -count=1 ./...、前端 npm run build、子 Agent pytest 与 ruff 均通过后，再重新生成两端 Windows EXE。

当前边界

• @ 仅用于一次性批量任务调度，不会自动把未标注文本广播给任何 Agent；非空行必须以一个或多个 @Agent名称 开始。
• 不支持附件、任意 Shell、远程终端、旧 FastAPI Spawn Agent 或跨 Agent 共享上下文。