docs: 记录智能体头像主分支集成

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

@@ -1,5 +1,11 @@
 # Data Flow
 
+## Personal cloud-agent avatars
+
+Renderer 选择头像 → Main 原生文件选择及 5 MB 校验 → 当前账号的 Yuxi Makelore 凭据 → 原生公开图片存储 → 返回持久化引用 `icon` 与独立展示地址 `icon_url`。上传只更新未保存预览；创建/保存才写入 Yuxi `Agent.icon`，省略字段保留旧值、显式 null 移除。取消或失败保留现有头像，账号切换丢弃迟到结果。
+
+个人列表和草稿读取当前头像；分享入口、接收列表与版本对比读取不可变发布快照。恢复版本将其头像复制到草稿；旧快照缺字段或图片加载失败使用默认图标。客户端不另建头像存储，移除引用不删除历史快照可能使用的图片。见[实现证据](../30-worklog/tasks/20261012-agent-avatars-840d7fd7.md)。
+
 ## Project conversations and distributed-agent consultation
 
 目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定；切换项目丢弃旧读取。

.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-10-12：按用户要求，将头像源 `235af24d6cf29b7e13b6be29fec9426fd4c6600c` 无冲突快进合入本地 `main`，配套 Yuxi 源为 `288ab7f84a9d02ca2b092c10da9f7b4ee7d66206`。智能体支持上传、替换、移除、未保存预览与列表/分享/版本展示，复用 Yuxi `Agent.icon` 和公开图片存储；Main 持有上传凭据并解析展示地址，发布头像由快照固定。独立 Reviewer 无阻断发现；98 项客户端测试、Renderer 类型检查、相关 lint、构建及 Electron 流程通过。Main 全量类型检查仍有既有错误，真实 OSS 和安装包未验收。3 份原有记录保持未提交；未推送或部署。见[源记录](tasks/20261012-agent-avatars-840d7fd7.md)和[本次集成](tasks/20261012-integrate-agent-avatars-a1f8e70c.md)。
+
 - 2026-10-11：用户授权回滚与主目录交接，已在本地 main 合入源 658bf7d 和正式文档整合 9949328，合并提交 5ae6ffd204e4d5e0f8546544fa8fc8cc3e1c51f1。恢复旧 Works Square 登录/刷新/注销路径；产品与已验证源一致。原有三份任务文档保持未提交，未推送、部署或删除工作区。见[主分支记录](tasks/20261011-integrate-makelore-rollback-b8f41a62.md)。
 
 - 2026-10-11：按用户明确要求，将 Makelore 平台 SSO 回滚源 `e28beff`（原平台 OIDC 实现 `7236def` 的逆提交）合入本地集成分支，客户端恢复 Works Square 传统密码/手机登录、刷新与注销边界。回滚验证沿用源任务的 60 项聚焦测试、typecheck、scoped lint、Renderer-only Vite build 与 `git diff --check`；正常 D: 构建仍因磁盘空间不足未完成。本次未推送、部署、迁移真实账号、改 LMS 或支付；主目录 3 份外来未跟踪文档原样保留且未纳入提交。此前 2026-10-10 的 OIDC 条目和来源任务继续保留为历史证据，当前运行时以本条及 ADR-004 为准。见[回滚源任务](tasks/20261011-rollback-makelore-platform-auth-7c4e9a2b.md)和[本次集成](tasks/20261011-integrate-rollback-makelore-c9d8e7f6.md)。

.project-docs/30-worklog/tasks/20261012-integrate-agent-avatars-a1f8e70c.md

@@ -0,0 +1,44 @@
+# Task: Integrate Makelore agent avatars
+
+## Identity
+
+- Task ID: 20261012-integrate-agent-avatars-a1f8e70c
+- Mode: Integration
+- Branch: main
+- Worktree: D:\Datas\OthersProjects\makelore
+- Base commit: 0ca744fb9b663a91aae9cdc6e5d3f8c860c551ed
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Integrate the reviewed agent-avatar result into local Makelore main; reconcile its accepted current-state and data-flow facts.
+
+## Intent And Constraints
+
+- User explicitly authorized local main-branch merge, one fresh read-only Reviewer, and official release/adoption of the prior primary owner while retaining all foreign files. No push, deployment or cleanup authorization is implied.
+- Concurrent and Planning Gates Passed: official start/status confirm this Integration identity, primary worktree, branch, recorded base and exclusive integration ownership. Loaded entry, own record, positioning, current state, decisions, architecture, domain, evidence, reflection and commitments; unchanged source-context reads and peer scope assessments remain applicable. The only concrete dependency, primary-owner handoff, is resolved by the user's explicit approval.
+- Existing peer placeholders remain unknown coordination state without a concrete conflicting dependency. Source task records are read-only during integration. Preserve the adopted 3 packaging/hang task records unchanged and untracked.
+- Integration Gate Passed: source commit 235af24d6cf29b7e13b6be29fec9426fd4c6600c is present, its outcomes and promotion candidates agree with existing Agent.icon ownership and immutable publication. No contradictory product decision requires resolution.
+
+## Outcome
+
+- Fast-forwarded main to reviewed source 235af24d6cf29b7e13b6be29fec9426fd4c6600c without conflicts; no additional product changes.
+- Accepted the source's current-state and data-flow promotion candidates. Source task and decision records remain unchanged; no new schema, dependency or configuration is introduced.
+- Original foreign documents remain untracked and excluded from commits. No push, release or deployment.
+
+## Verification
+
+- Fresh independent read-only Reviewer avatar_review reviewed full requirements, diffs, new files, tests and rules and reported no blocking findings after the fixture correction.
+- 98 focused Vitest tests, Renderer typecheck, scoped ESLint, Vite production build and one real Electron UI flow passed. Main-wide TypeScript still has existing baseline errors.
+- Product and test trees match the reviewed source; main ancestry, Git whitespace and official task-aware documentation drift are checked before completing this integration.
+- Real deployed OSS and installed-client acceptance remain unverified. File sink / Host API fixtures are explicitly scoped evidence, not production acceptance.
+
+## Follow-ups
+
+- Source task 20261012-agent-avatars-840d7fd7 remains at its managed linked worktree on codex/20261012-agent-avatars-840d7fd7-agent-avatars. Post-merge cleanup was offered with absolute paths and branch/commit preservation; awaiting user confirmation, retained meanwhile.
+- Deploy the paired Yuxi API and Makelore client when separately requested, then verify real public storage and the installed application.
+
+## Promotion Candidates
+
+- Accepted source current-state and data-flow facts are promoted in this integration; no unresolved promotion or semantic conflict.