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

controller/docs/steps/19-图片附件任务闭环.md

@@ -0,0 +1,13 @@
+# 19：图片附件任务闭环
+
+## 已完成范围
+
+1. 批量 `@` 指派和单独指派均支持粘贴或选择 PNG、JPEG、GIF、WebP；单项任务最多 10 张、原始总大小最多 12 MiB。
+2. 多条有效批量任务带图时，每行必须明确引用“图片 1”等编号；同一行多个 Agent 共享其编号图片，未知、离线、重名和未指定目标不会收到图片。
+3. 图片只保存在总控本地 `task_images`，通过目标 Agent 的认证 WSS `task_dispatch.attachments` 下发；任务详情显示数量与缩略图，重试复用原图，清除已结束任务同时删除附件。
+4. 审计、普通日志、任务文本、结果和错误均不写入图片 Base64。
+5. 批量与单独指派页均显示本页最近任务的实时状态；任务详情在附件尚未加载时保持可用，不会造成页面空白。
+
+## 验证
+
+- 未配置“支持图片理解”的模型会安全失败，绝不降级为纯文本。