Merge branch 'feature-birthday-crown'

P0 正确性与工程卫生修复：

- 删除 core/proguard-rules.pro 中全部无效的 -keepclassmembers 规则
  (LunarCache.getOrCompute 实为实例 suspend 方法，generateMonthDays 实为
   private，签名均不匹配，属 placebo)；同时移除 core/build.gradle.kts
  release block 内重复的 consumerProguardFiles 声明
- 将 7 处 composeTrace 调用从 CalendarViewModel 移至 Compose 层
  (MenuItem.onClick / onMonthClick / BottomCard 回调)，VM 不再依赖
  android.os.Trace，可在纯 JVM 环境测试无需兜底
- 删除 CalendarViewModel 与 4 个 UI 文件中约 30 处 logd 调用及其辅助
  变量/ SideEffect/ DisposableEffect (AnimLog.kt 工具函数保留)
- 删除 CalendarViewModel.getIsoWeekNumber 不可达的 weekNumber < 1 递归分支
- 修正 MainActivity.kt setContent 块缩进错位
- 同步 README: sketch 渲染 GIF→动画 WebP，补提 :macrobenchmark 模块；
  删除 AGENTS.md 顶部过时的「README 与实际不符」注释

验证: spotlessApply UP-TO-DATE, testDebugUnitTest 全过,
       assembleDebug + assembleRelease (R8) 均成功

.gitignore

@@ -23,3 +23,4 @@ node_modules/
 logs/
 .claude/
 docs/superpowers/
+.worktrees/

AGENTS.md

@@ -2,8 +2,6 @@
 
 纯 Android + Jetpack Compose 日历应用。功能：农历/节气/节日、个人班次排期（WORK/OFF 循环）、月/周/年三视图。
 
-> **README 与实际不符**：README 提及 "Kotlin Multiplatform / iOS"，实际为纯 Android 项目。模块名为 `:core` 和 `:app`，无 `:shared` 或 `:androidApp`。
-
 ## 模块结构
 
 | 模块 | 类型 | 职责 |

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>
 
 ## 特性
@@ -19,8 +19,8 @@
 - Kotlin 2.3 · Jetpack Compose · Material 3
 - `kotlinx-datetime` 处理所有日期逻辑
 - `tyme4kt` 提供农历、节气与传统节日
-- `sketch` 渲染 GIF 动画
+- `sketch` 渲染动画 WebP
-- 双模块：`:core`（UI + 逻辑） · `:app`（薄壳）
+- 三模块：`:core`（UI + 逻辑） · `:app`（薄壳） · `:macrobenchmark`（Baseline Profile 生成）
 
 ## 构建
 

app/src/main/assets/AGENTS.md

@@ -1,25 +1,25 @@
 <!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-05-22 | Updated: 2026-05-22 -->
+<!-- Generated: 2026-05-22 | Updated: 2026-06-15 -->
 
 # assets
 
 ## Purpose
-原始资产文件目录，存放不需要 Android 资源系统处理的二进制文件。当前包含 GIF 动画资源。
+`:app` 模块原始资产文件目录。当前为空（2026-06 清理后）。
 
 ## Key Files
 
-无顶层文件
+无
 
 ## Subdirectories
 
-| Directory | Purpose |
+无（原 `gifs/` 子目录的镜像说明已删除 —— 实际 UI/WebP 资源只在 `:core`）
-|-----------|---------|
-| `gifs/` | GIF 动画资源（见 `gifs/AGENTS.md`） |
 
 ## For AI Agents
 
 ### Working In This Directory
-- 新增原始资源文件直接放入此目录或其子目录
+- 历史上此目录曾放 `app_icon.png`/`app_icon_original.png` 作图标源，因无代码引用已于 2026-06 删除
-- 通过 `AssetManager` 在运行时访问
+- 应用内图标用 `core/src/main/assets/app_icon.webp`（`Platform.kt`）
+- 启动器图标用 `app/src/main/res/mipmap-*/`（含 Adaptive Icon）
+- **不要再把图标源 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: -->

app/src/main/assets/gifs/AGENTS.md

@@ -1,33 +0,0 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-05-22 | Updated: 2026-05-22 -->
-
-# gifs
-
-## Purpose
-GIF 动画资源目录，存放应用使用的动画 GIF 文件（001.gif ~ 152.gif），由 `AnimatedGif` Composable 组件通过 `sketch` 库加载显示。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `001.gif` ~ `152.gif` | 应用动画 GIF 资源 |
-
-## Subdirectories
-无
-
-## For AI Agents
-
-### Working In This Directory
-- 替换或新增 GIF 时保持连续编号
-- GIF 文件较大，注意 APK 体积影响
-- `AnimatedGif` 组件使用 `sketch` 库异步加载和播放
-
-## Dependencies
-
-### Internal
-- `core/src/main/kotlin/plus/rua/project/ui/AnimatedGif.kt` — GIF 显示组件
-
-### External
-- `sketch` 4.4.0（GIF 解码和播放）
-
-<!-- MANUAL: -->

app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Adaptive Icon 背景: 纯色块, 取自原图四角采样 RGB(131,208,241) -->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#83D0F1"
+        android:pathData="M0,0h108v108h-108z" />
+</vector>

app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Adaptive Icon (API 26+): 系统按 OEM 启动器形状自动裁切背景+前景。
+-->
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
+</adaptive-icon>

app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Adaptive Icon 圆形版 (API 26+), 内容与 ic_launcher.xml 一致 -->
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
+</adaptive-icon>

core/build.gradle.kts

@@ -12,6 +12,21 @@ android {
     defaultConfig {
         minSdk = libs.versions.android.minSdk.get().toInt()
         consumerProguardFiles("proguard-rules.pro")
+
+        // 构建期扫描 assets/animations/ 生成 WebP 文件列表，避免运行期硬编码 (1..152)
+        // 与 assets/ 目录耦合却不校验，导致增删文件后隐性 bug
+        val webpFiles = layout.projectDirectory
+            .dir("src/main/assets/animations")
+            .asFile
+            .listFiles { f -> f.extension.equals("webp", ignoreCase = true) }
+            ?.map { it.name }
+            ?.sorted()
+            ?: emptyList()
+        require(webpFiles.isNotEmpty()) { "assets/animations/ 不应为空，请检查目录" }
+        // 拼成 Java 数组字面量: new String[]{"001.webp","002.webp",...}
+        val quoted = webpFiles.joinToString(",") { name -> "\"$name\"" }
+        val arrayLiteral = "new String[]{$quoted}"
+        buildConfigField("String[]", "WEBP_FILES", arrayLiteral)
     }
 
     buildTypes {
@@ -20,7 +35,6 @@ android {
         }
         release {
             isMinifyEnabled = false
-            consumerProguardFiles("proguard-rules.pro")
             buildConfigField("boolean", "ENABLE_TRACE", "false")
         }
         create("trace") {

core/proguard-rules.pro

@@ -1,34 +1,6 @@
 # Baseline Profiles 保留规则：确保方法名不被 R8 混淆，使 profile 规则匹配正确
 -keepattributes SourceFile,LineNumberTable
 
-# ========== 启动热点路径保留 ==========
-
-# DayCell — 启动最热点
--keepclassmembers class plus.rua.project.ui.DayCellKt {
-    public static void DayCell(...);
-}
-
-# LunarCache — 日期计算缓存
--keepclassmembers class plus.rua.project.LunarCache {
-    public static plus.rua.project.DayCellInfo getOrCompute(kotlinx.datetime.LocalDate);
-    public static java.lang.String formatLunarDate(kotlinx.datetime.LocalDate);
-    public static void precompute(...);
-}
-
-# DayCellInfo 数据类
--keepclassmembers class plus.rua.project.DayCellInfo {
-    public java.lang.String getAnnotationText();
-    public boolean getIsAnnotationHighlight();
-    public java.lang.String getHolidayBadge();
-    public java.lang.String getLunarMonthName();
-}
-
-# CalendarMonthPage
--keepclassmembers class plus.rua.project.ui.CalendarMonthPageKt {
-    public static void CalendarMonthPage(...);
-    public static java.util.List generateMonthDays(...);
-}
-
 # ========== 第三方库保留 ==========
 -keep class kotlinx.datetime.** { *; }
 -keep class cn.tyme.** { *; }

core/src/main/assets/AGENTS.md

@@ -1,25 +1,28 @@
 <!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-05-22 | Updated: 2026-05-22 -->
+<!-- Generated: 2026-05-22 | Updated: 2026-06-15 -->
 
 # assets
 
 ## Purpose
-核心模块原始资产文件目录，与 `app/src/main/assets/` 镜像，包含 GIF 动画资源供 `AnimatedGif` Composable 组件加载。
+核心模块原始资产文件目录，通过 `AssetManager` 在运行时访问。包含应用内图标和动画 WebP 资源。
 
 ## Key Files
 
-无顶层文件
+| File | Description |
+|------|-------------|
+| `app_icon.webp` | 应用内展示用的图标（`Platform.kt` 的 `getAppIconUri()` 引用） |
 
 ## Subdirectories
 
 | Directory | Purpose |
 |-----------|---------|
-| `gifs/` | GIF 动画资源（见 `gifs/AGENTS.md`） |
+| `animations/` | 动画 WebP 资源（见 `animations/AGENTS.md`） |
 
 ## For AI Agents
 
 ### Working In This Directory
-- 此目录与 `app/src/main/assets/` 内容同步
+- 新增原始资源文件直接放入此目录或其子目录
-- 通过 `AssetManager` 在运行时访问
+- **不与 `app/src/main/assets/` 镜像**：启动器图标在 `:app`，UI/WebP 资源在 `:core`
+- 通过 `file:///android_asset/<path>` URI 在运行时访问
 
 <!-- MANUAL: -->