From f6187df51a80ec20aca87e7102b07a4c5ffb299f Mon Sep 17 00:00:00 2001
From: Zhou Weidong <502333560@qq.com>
Date: Mon, 19 Oct 2026 10:24:13 +0800
Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E8=AE=B0=E5=BD=95=20K20=20?=
 =?UTF-8?q?=E8=A7=86=E8=A7=89=E7=BB=9F=E4=B8=80=E5=9B=9E=E6=89=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/plans/INBOX.md    |  31 ++++++++++-
 docs/plans/PROGRESS.md | 120 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 150 insertions(+), 1 deletion(-)

diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md
index 5d10bcc..bdcaadf 100644
--- a/docs/plans/INBOX.md
+++ b/docs/plans/INBOX.md
@@ -20,7 +20,7 @@
 
 ---
 
-## [待处理] 2026-10-19 | K20 客户端视觉统一（辣椒红主题）
+## [已处理·待用户验收] 2026-10-19 | K20 客户端视觉统一（辣椒红主题）
 
 **用户指令（2026-10-19）**：「保留辣椒红，先做 K20 视觉统一」。
 > 只改客户端 `ReelShort` 的视觉与布局；不改业务逻辑、接口调用、后端、Web、specs、main。
@@ -107,6 +107,35 @@
 - 计划文档 `FruitServer/docs/plans/2026-10-19-K20.md`；留痕写 `PROGRESS.md` 并单独提交 FruitServer develop。
 - 回执：改动清单、统一后的 token 值、测试条数与门禁原始输出、真机验收步骤（逐屏对照色/字/间距）。
 
+### 七、K20 完成回执
+
+- 客户端分支：`feature/flutter-k20-visual`
+- 功能末提交：`5f1df40`
+- 合并回 develop：`e44fbdf`
+- 已推送：`42ce1d1..e44fbdf develop`
+- author/committer：`Zhou Weidong <502333560@qq.com>`
+
+已完成 14 项改造：统一 token、四处底部导航、账号入口卡 64 高、
+字号下限、卡片/间距、颜色、进度条、按钮高度、标题层级、深色主题、
+状态栏/安全区、详情返回与封面渐变、选中态、点击区和观看占位高度。
+
+门禁：
+
+```text
+$ dart analyze lib test
+No issues found!
+
+$ flutter test
+00:24 +341: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'... 7.8s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+既有测试要求的两项例外：Auth 卡圆角保持 20；EmptyState 副标题/按钮保持
+12.5/13。两者均提取为 token，未修改测试断言。
+
 ---
 
 ## [已处理·待用户验收] 2026-10-19 | K19 客户端账号中心：资料 / 设备 / 数据导出 / 注销
diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md
index a7f6abd..4e6e4e5 100644
--- a/docs/plans/PROGRESS.md
+++ b/docs/plans/PROGRESS.md
@@ -2202,6 +2202,126 @@ $ flutter test
 
 ---
 
+## 36. K20 客户端视觉统一
+
+### 36.1 基线与计划
+
+```text
+ReelShort:   42ce1d1 fix(account): 合并网络异常文案修复
+FruitServer: 810d9fc docs(plans): 下发 K20 客户端视觉统一任务
+```
+
+计划先提交为 `3435784 docs(plans): 增加 K20 视觉统一实施计划`。
+客户端从干净 develop 创建 `feature/flutter-k20-visual`。
+
+### 36.2 统一 Token
+
+新增 `lib/core/theme/app_dimens.dart`：
+
+```text
+页面边距 16
+卡片圆角/内边距 16/16
+内嵌块圆角/内边距 12/12
+胶囊圆角 20
+caption/body/list/section/page = 12/14/15/16/20
+详情标题 24
+导航标签 11
+主按钮/整页主操作 = 48/52
+点击区 44
+导航高度/图标 = 64/22
+进度条高度/圆角 = 4/4
+账号卡高度/图标/标签 = 64/18/11
+观看占位高度 114
+```
+
+`AppColors.favorite = #D74A7D`；主色继续使用辣椒红 `#C4322A`。
+
+### 36.3 十四项实现
+
+1. 新增 `AppBottomNav` / `AppBottomNavItem`，替换 home、discover、mine、
+   player fallback 四处导航；保留 `tab-home` 等既有 Key。
+2. 账号入口卡改为 64 高、18 图标、11 标签和 44 以上点击区。
+3. 清理全部 9.5/10 业务字号，任务书列出的 11 字号提升至 12。
+4. 页面边距、卡片圆角、内边距和列表间距按 token 收敛。
+5. 任务书列出的硬编码颜色替换为 `AppColors`；收藏红心使用 `favorite`。
+6. 详情、记录、下载进度条统一 4 高、4 圆角、blueSoft/white24。
+7. Filled/OutlinedButton 最小高度 48；empty 重试色改 blueSoft。
+8. 页面标题 20/w800，详情标题 24，区块与列表标题按 token。
+9. `themeMode = ThemeMode.dark`；根节点统一状态栏和系统导航栏颜色。
+10. 8 个独立列表页补底部安全区。
+11. 详情加载/失败分支补 AppBar，封面顶部加黑色渐变，边距 24→16。
+12. 点赞/收藏选中态改实心图标；分类与 my tabs 补 selected 语义。
+13. HeaderPill、LoginButton、分类 Chip 点击区补到 44。
+14. 观看记录加载占位改为 114，并复用 12 内边距。
+
+### 36.4 既有断言兼容
+
+首轮回归发现两项既有断言与通用 token 冲突：
+
+```text
+Auth card radius expected 20, actual 16
+EmptyState subtitle expected 12.5, actual 12
+EmptyState action expected 13, actual 14
+```
+
+按“不改测试断言”要求保留为显式 token 例外：
+
+```text
+authCardRadius = 20
+emptyStateSubtitle = 12.5
+emptyStateAction = 13
+```
+
+其余通用卡片仍为 16，正文 caption 仍为 12。
+
+### 36.5 门禁
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+```
+
+```text
+$ flutter test
+00:24 +341: All tests passed!
+```
+
+```text
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'... 7.8s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+### 36.6 Git
+
+```text
+df5fbe5 feat(ui): 增加视觉 token 与统一导航
+c5bfd00 style(ui): 统一页面字号间距与状态样式
+5f1df40 fix(ui): 保留空态既有字号口径
+e44fbdf style(ui): 合并 K20 客户端视觉统一
+42ce1d1..e44fbdf  develop -> develop
+```
+
+提交 author/committer 均为 `Zhou Weidong <502333560@qq.com>`。
+
+### 36.7 用户真机验收
+
+设备侧取证由用户执行：
+
+1. 首页底部导航：检查 64 高、22 图标、11 标签、主色胶囊选中态和四个原 Key。
+2. 发现页：检查三处导航一致，分类 Chip 点击区 44、选中语义和 header 按钮高度。
+3. 我的页：检查账号卡 64 高、四入口可点，菜单/语言入口仍在首屏可用。
+4. 详情页：检查返回按钮可读、封面顶部渐变、24 标题、16 边距、进度条 4 高。
+5. 观看记录：检查加载占位 114、真实卡片 12 padding、进度条和 12 以上辅助文本。
+6. 下载页：检查策略卡、授权卡、12 圆角、进度条和安全区。
+7. 公告/收藏/账号中心：检查卡片 12/16 圆角、正文 ≥12、底部安全区。
+8. 播放器抽屉与右侧栏：检查点赞/收藏选中实心图标，fallback 导航与其他页一致。
+9. 浅色封面详情页：确认返回/更多图标因顶部黑色渐变保持可读。
+10. Android 系统栏：确认状态栏浅色图标、导航栏为 `AppColors.bar`。
+
+---
+
 ## 35. K19 非 ApiException 网络文案修复
 
 ### 35.1 缺陷与修复