From c591bc389b7d4304721e7676bdbb6851f064d086 Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Mon, 15 Jun 2026 14:13:26 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E5=A4=8D=E4=BB=A3=E7=A0=81?=
 =?UTF-8?q?=E5=AE=A1=E6=9F=A5=E5=8F=91=E7=8E=B0=E7=9A=84=E9=97=AE=E9=A2=98?=
 =?UTF-8?q?(README=20=E5=9D=8F=E9=93=BE=20+=20=E5=8E=9F=E5=9B=BE=E5=BD=92?=
 =?UTF-8?q?=E5=AE=BF=E8=AF=B4=E6=98=8E)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

审查发现 2 个问题:

1. README.md:6 坏链 [必须修]
   - <img src="app/src/main/assets/app_icon.png"> 指向 Task 1 已删的 PNG
   - 改为 core/src/main/assets/app_icon.webp (现存的应用内图标, 512px)
   - 加 width/height=128 限制展示尺寸 (原图无尺寸约束会撑满)

2. app/assets/AGENTS.md 原图归宿说明模糊 [建议修]
   - 原写"源文件放仓库外或 .assets-source/" 但两者都不存在, 误导
   - 改为明确: 原图 app_icon_original.png (2048px) 保留在 git 历史
     commit a36f6c4, 用 git show 恢复, 生成脚本见实施计划 Task 5

审查驳回的建议 (附理由):
- <mipmap> 间接引用: 审查自承"通常能工作", 且 Task 5 已模拟器实机
  验证渲染正常 (analyze_image 确认黄色主体居中无裁切)。
  <mipmap> 标签按密度选桶是启动器前景的标准做法, 不改。
- baseline-prof lambda hash: Task 3 commit 已说明"下次 updateBaselineProfile
  校准", 且 hash 失效是静默降级不报错, 不阻塞合并。

验证: ./gradlew :app:assembleDebug → BUILD SUCCESSFUL
---
 README.md                     | 2 +-
 app/src/main/assets/AGENTS.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0ea3256..99abc61 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 纯 Android + Jetpack Compose 日历应用，支持农历/节气/节日、个人班次排期，提供月/周/年三种视图。
 
 <div>
-    <img src="app/src/main/assets/app_icon.png" />
+    <img src="core/src/main/assets/app_icon.webp" width="128" height="128" />
 </div>
 
 ## 特性
diff --git a/app/src/main/assets/AGENTS.md b/app/src/main/assets/AGENTS.md
index 965ae29..438ef21 100644
--- a/app/src/main/assets/AGENTS.md
+++ b/app/src/main/assets/AGENTS.md
@@ -20,6 +20,6 @@
 - 历史上此目录曾放 `app_icon.png`/`app_icon_original.png` 作图标源，因无代码引用已于 2026-06 删除
 - 应用内图标用 `core/src/main/assets/app_icon.webp`（`Platform.kt`）
 - 启动器图标用 `app/src/main/res/mipmap-*/`（含 Adaptive Icon）
-- **不要再把图标源 PNG 放这里**：会被打进 APK。源文件放仓库外或 `.assets-source/`
+- **不要再把图标源 PNG 放这里**：会被打进 APK。原图 `app_icon_original.png` (2048px) 保留在 git 历史（commit `a36f6c4`），重新生成 foreground 时用 `git show a36f6c4:app/src/main/assets/app_icon_original.png` 恢复，生成脚本见 `docs/superpowers/plans/2026-06-15-image-management-optimization.md` Task 5
 
 <!-- MANUAL: -->