docs: 记录智能体图标修复集成结果

.project-docs/20-architecture/system-overview.md

@@ -1,5 +1,8 @@
 # System Overview
 
+智能体图标跟随发布定义：Yuxi 将原生 `icon` 固定到发布快照，Works Square 转为公开地址 `icon_url` 下发。Makelore 顶栏、邀请、面板标题、欢迎区和消息行统一读取该字段；缺失或加载失败时回退到既有 `avatar_id`。新话题取当前发布定义，旧话题保持原版本；自定义图标使用正常图像渲染，内置像素头像保持像素样式。
+详见[图标集成记录](../30-worklog/tasks/20260926-merge-agent-avatar-ml-92dc837e.md)。
+
 Code 咨询由 Works Square 运营下发的 Yuxi 智能体执行，客户端不内置老师／朋友角色；发布定义提供名称、头像、人设、欢迎语和推荐问题。Main 按账号／项目管理本机话题，Renderer 按账号／项目／服务端智能体 ID 保存未发送草稿。每轮绑定当前操作会话和已完成 Pi 公开消息，执行云端请求的三个只读工具后主动回传结果；Yuxi 保存云端消息和收到的片段。学生支付咨询模型费用，个人 Agents 保持创建者付费。全部下发智能体在顶栏以头像和名称直接选择，溢出横向滚动；面板不再提供智能体下拉框。选择恢复对应历史或空输入框，不创建话题或调用模型。新话题使用所选或默认项，旧话题固定版本；旧未归属项目草稿、合成朋友历史及草稿仅查看。结构化讨论和现有主动跟进协议保留。正文只接收云端主线程文本，子线程事件仍推进续传游标。Code 默认 Agent、项目下会话和 Pi 执行保持原边界。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
 
 ## Current Architecture

.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-26：合入图标修复源 `a3c02e74649c743c445fb2304bec9e0ac954ad96`，合并提交 `e3d01a1da4c836d0f5c9d9fc42bd9257088a4669`。智能体图标跟随发布定义：Yuxi 将原生 `icon` 固定到发布快照，Works Square 转为公开地址 `icon_url` 下发。Makelore 顶栏、邀请、面板标题、欢迎区和消息行统一读取该字段；缺失或加载失败时回退到既有 `avatar_id`。新话题取当前发布定义，旧话题保持原版本；自定义图标使用正常图像渲染，内置像素头像保持像素样式。 产品与测试保持已审查源字节，复用源验证；7 份跨仓外来文档原样保留且未纳入提交。未推送、部署或更新安装版；发布配套三端后需在运营端同步 Yuxi 配置，新话题使用新版本。见[源任务](tasks/20260926-agent-avatar-ml-3c3686ec.md)及[本次集成](tasks/20260926-merge-agent-avatar-ml-92dc837e.md)。
+
 - 2026-09-26：以已集成技术基线 `1037356090eca90793ffe74750c273cbb44d7aef` 为基础，记录并按用户进一步澄清修订[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)：老师 Agent 是某一领域杰出人物的能力转化而成的智能体，供平台学生使用，提供专业理解、判断与解决问题的能力支持。蒸馏属于实现方法，产品定义围绕人的领域能力及学生价值。同步 README、老师 ADR 和决定索引；本次仅记录理念，不变更运行代码、线上配置或既有智能体角色模型，也不代表所有下发项已完成能力验收。
 
 - 2026-09-24：从 `0e22e0545d6f58a17a8c85805570a550d1c14c43` 无冲突快进合入源 `79914e1d06a66f78239ebe57f816acc98dc1eaae`。智能体提交工具结果遇到同一 interrupted 父 Run 的临时 run_busy 时，Main 保留原批次等待资源释放后续接，不重读文件或新建问题，沿用取消与原问题时限；其他运行占用及冲突保持失败。产品/测试与源完全一致，沿用源 183 项相关测试及最终 29 项聚焦回归、Renderer 类型检查、scoped lint、Vite 构建和配套本地真实 HTTP/PG/worker 因果验证。原有 3 份文档保持，未推送、打包、安装或部署。详见[源任务](tasks/20260924-consultation-run-busy-9ac245f1.md)和[集成记录](tasks/20260924-merge-agent-rendering-ml-4efb196c.md)；安装版/生产模型仍待验收。

.project-docs/30-worklog/tasks/20260926-merge-agent-avatar-ml-92dc837e.md

@@ -0,0 +1,41 @@
+# Task: Integrate distributed agent icon repair
+
+## Identity
+
+- Task ID: 20260926-merge-agent-avatar-ml-92dc837e
+- Mode: Integration
+- Branch: main
+- Worktree: D:\Datas\OthersProjects\makelore
+- Base commit: 37e7b1d01c438cd5cd0da7b8ada432b06970d150
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Merge reviewed source a3c02e74649c743c445fb2304bec9e0ac954ad96 from task 20260926-agent-avatar-ml-3c3686ec into the local primary branch; promote the published agent icon contract.
+
+## Intent And Constraints
+
+- Concurrent, Planning and Integration Gates Passed. Official start/status match Identity and exclusive integration ownership. Read entry, own/source records, positioning/current-state/decisions/architecture/domain and relevant evidence/commitment indexes; refreshed registered peer scope sections and reused unchanged prior context. Historical placeholder scopes have no concrete dependency on this merge; isolated pricing work is out of scope.
+- User explicitly approved release --force of the completed prior primary owner and --adopt-existing for the known foreign documents. Preserve their exact states and exclude them from commits. Source task records remain read-only.
+- Plan: merge the exact source; verify ancestry, unchanged product/test/source-record bytes and retained main documentation; promote accepted icon facts; pass documentation/whitespace gates, commit and complete. Reuse the independent review and source tests when product bytes match. No new subagents, push, deployment, model calls or worktree deletion.
+
+## Outcome
+
+- Merged exact source a3c02e74649c743c445fb2304bec9e0ac954ad96 without conflicts as e3d01a1da4c836d0f5c9d9fc42bd9257088a4669. All changed product/test and source-task files match the reviewed source; Makelore README retains the newer main-branch positioning paragraph.
+- Promoted the approved versioned icon contract into system-overview and current-state. Existing foreign documents remain unchanged and outside the index; no source record was rewritten.
+
+## Verification
+
+- Source/staged file equality, absence of unmerged paths and git diff --cached --check passed before the merge commit. Independent source review passed with no blocking findings; no implementation changes required another reviewer.
+- Source evidence reused for identical product/test bytes: 56 focused unit tests, renderer typecheck, focused ESLint, Vite renderer/Main/preload/worker build and real Edge image decoding/404 fallback case passed. Installed-client and production OSS acceptance remain unverified.
+- Final source ancestry, exact product/test tree and imported records, clean unchanged source worktree, scoped document diff, whitespace and official task-aware drift passed. Main-only README/product-introduction text is preserved. The official drift check confirmed all adopted foreign document states unchanged. No new fingerprints or validation infrastructure were added.
+
+## Follow-ups
+
+- Compatible three-end deployment, Operations configuration sync and real-client image acceptance remain separate. Older topics keep their published definition; a new topic uses the synchronized icon.
+- Source worktree D:\Datas\OthersProjects\.codex-worktrees\makelore\20260926-agent-avatar-ml-3c3686ec on branch codex/20260926-agent-avatar-ml-3c3686ec-agent-avatar-ml is retained awaiting post-merge cleanup confirmation. Removing it would also remove ignored dependencies/build output; branches and commits must remain.
+
+## Promotion Candidates
+
+- Accepted source proposal applied to system-overview and current-state under integration ownership. No architecture direction, billing or historical-version conflict remains.