docs: record image attachment fix on main

.project-docs/20-architecture/data-flow.md

@@ -4,6 +4,12 @@
 
 one-api 官方接口/文档事实与实际 group 路由交集 -> Works 完整快照和业务授权 -> model-config v2 -> Main 安全 Provider metadata -> 产品 reasoningChoice/图片输入校验 -> 冻结父/子运行上下文 -> Pi 请求钩子清除 SDK 控制字段并写入原生字段。Renderer 消费相同能力投影，缺失事实不做名称推测；详情见[官方能力决策](../10-decisions/ADR-2026-09-12-official-model-capabilities.md)。
 
+## Code image attachment projection
+
+Main 在接收带图消息时立即将上传 attachment id 放入 optimistic user node；Pi 的实时事件与持久会话恢复都通过 production composition 的 projectImage 回调，将图片字节映射到同一附件存储。Renderer Snapshot/Patch 只携带附件引用，时间线按需读取二进制；重新打开会话后仍可展示图片。
+
+附件存储按 MIME 与图片字节复用已写入文件，避免每次事件或历史 hydration 重写整张图片；既有随机 ID 附件继续可读。模型识图能力仍由官方能力投影决定，不能根据旧会话中助手自述“看不到图片”反向更改模型配置。源提交：03fc50f；生产 composition、真实 Pi 新建/恢复会话 HTTP 和 Electron 图片刷新测试提供验证。
+
 ## Primary Flows
 
 | Flow | Source | Destination | Notes |