mulit-agent/mulit_agent/docs/steps/13-图片附件模型闭环.md

# 13：图片附件与视觉模型闭环

## 已完成范围

1. `ControllerSession` 严格校验 `task_dispatch.attachments` 的类型、MIME、数量和解码后总大小；无效消息只拒绝该任务，不影响 WSS 会话。
2. 附件仅在执行内存中传递，不写入本地任务库、事件、日志、错误或模型结果。
3. OpenAI 兼容请求使用 `text` 与 `image_url`，Anthropic 使用 base64 `image` 内容块，Gemini 使用 `inline_data`。
4. 未显式配置视觉能力的模型会安全失败，不能把图片任务降级为文本。
5. 已部署的受控桌面文件工具可在新建桌面直接子文件夹时，将本任务附件以固定安全文件名保存其中；不允许调用方指定路径、覆盖文件或访问桌面外位置。