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 |

.project-docs/30-worklog/current-state.md

@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
 
 ## Integrated Through
 
+- 2026-09-13：续接任务 `20260912-land-model-capabilities-c6fa4309`，将图片附件修复源 `03fc50f7a9009b8e5c43fada8bc3365103dc732c` 从 `1d661f7` 无冲突快进合入本地 main。发送时、Pi 实时消息与历史恢复均保留图片引用，重复投影复用附件文件。产品树与已验证源完全相同，复用其相关回归、真实 Pi 新会话/恢复会话 HTTP、Electron 图片刷新、类型检查与构建证据。三个原有未跟踪记录保持原样；工作区清理等待单独确认，未推送、打包或安装。详见[图片流转](../20-architecture/data-flow.md#code-image-attachment-projection)。
+
 - 2026-09-12：任务 `20260912-land-model-capabilities-c6fa4309` 经用户授权交接主目录及集成锁，将模型能力源 `26cbb29` 合入本地 main，合并为 `2888aaed`；保留已有知识库和云智能体界面。受管模型采用 Works v2 官方能力，Main 持久化并验证原生 reasoningChoice、冻结供应商控制字段，图片附件与 Pi input 一致。合并后 57 项相关测试、类型检查、Vite 全目标构建、Electron 受管模型用例 1 项通过；源任务验证保持有效。3 份原有未跟踪记录原样保留，未推送、打包、部署或清理工作区。见[官方模型能力决策](../10-decisions/ADR-2026-09-12-official-model-capabilities.md)。
 
 - 2026-09-12：任务 `20260912-merge-kb-embedding-49e2b6c` 在用户确认主目录占用移交后，将本地 main 从 `a0b869a` 无冲突快进到知识库修复源 `3507f70e114be94913c72aa9e70eb6f9455cd86d`。创建知识库明确区分模型目录加载/失败/空状态，提供管理员配置说明及原地刷新；刷新保留名称，未知创建继续复用原请求身份。模型由平台管理员在 Yuxi 定义并启用（含维度）、在 Works Square 激活相同模型 ID，one-api 提供实际向量接口。客户端继续消费 Main Host API。源 50 项相关测试、类型检查、scoped ESLint、Vite 构建和 Windows Electron fixture 1 项通过；快进合并未改写产品代码，复用源验证。原有 3 个未跟踪文档保留；未推送、打包或部署，线上具体配置缺口及真实收费调用未验证。

.project-docs/30-worklog/tasks/20260912-land-model-capabilities-c6fa4309.md

@@ -12,6 +12,7 @@
 
 ## Scope
 
+- 2026-09-13 follow-up: integrate approved image-attachment fix 03fc50f as the continuation of the same model-capability delivery.
 - Land approved model capability source 26cbb29 onto local main; reconcile canonical memory and preserve pre-existing records.
 
 ## Intent And Constraints
@@ -23,12 +24,15 @@
 
 ## Outcome
 
+- 2026-09-13: resumed this same Integration owner and lock through bundled start/status; Planning Gate Passed using the unchanged 1d661f7 context and refreshed source/peer records. Fast-forwarded local main from 1d661f7 to image-fix source 03fc50f7a9009b8e5c43fada8bc3365103dc732c without conflict. Promoted the source image-projection/storage-reuse candidate into data-flow.md. Original source record stays unchanged.
 - Local main merged source 26cbb29 as 2888aaed without conflicts, retaining existing knowledge and cloud-agent UI updates.
 - Accepted v2 authority, native reasoningChoice and Main/Pi request preparation into ADR, decision index, architecture/data flow/domain and current-state.
 - Three original untracked task documents remain byte-for-byte unchanged and uncommitted.
 
 ## Verification
 
+- Image-fix landing documentation drift passed, including the unchanged prior adopted foreign files and source provenance. Final source/canonical diff reviewed; the ready continuation record is committed with canonical notes.
+- Image-fix follow-up: product tree on main exactly matches validated source 03fc50f. Reused source regression, DeepSeek-compatible real-process fresh/restored image HTTP, Electron attachment hydration/reload, typecheck, scoped ESLint and build results. No product edits or test reruns were necessary for the fast-forward plus canonical documentation. The source baseline has 61 additional Main TypeScript diagnostics with zero additions.
 - Final working/committed delta reviewed; git diff whitespace and bundled task-aware documentation drift checks passed. Source records and preserved foreign documents satisfy the gate. This Ready record is committed with the handoff; bundled complete follows.
 
 - Integrated main passed 57 focused tests in seven files covering managed capabilities, provider/runtime/import plus the independently merged knowledge/cloud-agent UI.
@@ -38,6 +42,8 @@
 
 ## Follow-ups
 
+- Image-fix source cleanup awaiting optional user confirmation: task 20260912-fix-image-delivery-d74b1f08; D:\Datas\OthersProjects\.codex-worktrees\makelore\20260912-fix-image-delivery-d74b1f08; branch codex/20260912-fix-image-delivery-d74b1f08-fix-image-delivery. Clean, ready, managed, with latest HEAD 03fc50f included in main. No deletion performed. The earlier separate cleanup questions remain pending and are not repeated.
+- The image fix is now merged locally; packaging, installation and remote publication were not requested or performed.
 - Awaiting optional cleanup confirmation: source 20260912-model-capabilities-c48271f9, D:\Datas\OthersProjects\.codex-worktrees\makelore\20260912-model-capabilities-c48271f9, branch codex/20260912-model-capabilities-c48271f9-model-capabilities. Its latest result is included in actual main; confirm clean/ready/managed eligibility before retire.
 - The unrelated failed knowledge retirement and its residual directory/registration remain unchanged. The unused checkout from the failed capability integration start is unowned/unmanaged and is retained, not offered for automatic retirement.
 - Worktree cleanup removes ignored dependencies/build output but preserves branches/commits. No cleanup has been authorized or executed by this handoff. No push, package, deployment, migration of a deployed database or paid inference.