FruitServer/docs/plans/2026-10-17-K5.md

2026-10-17 K5 客户端视觉：克莱因蓝主题 + 印尼市场适配

一、目标与边界

本轮只完成 Flutter 客户端的主题色、蓝色收敛、印尼语 locale 和回归测试：

• K5-A：建立克莱因蓝 token 与浅色/深色显式 ColorScheme，主色统一 #002FA7。
• K5-B：清理页面层的旧蓝字面量，统一使用 AppColors / ColorScheme；不改语义色。
• K5-C：LocaleController 支持 id；未显式选择时跟随系统，非 en/zh/id 回退 id； 两个现有语言入口增加 Bahasa Indonesia。
• K5-D：补主题 token、对比度、硬编码扫描、locale 回退与语言切换测试， 回归深色/浅色、三态和小屏布局。

不做 K4、支付、Google 登录、新接口、下载落盘、App 图标/启动图或信息架构调整； 不改后端、ReelShortWeb、specs。

二、用户裁定色值

Token	值	用途
blue	#002FA7	Klein Blue / IKB 主色
bluePressed	#00227A	按下/激活态与大面积蓝色背景
blueSoft	#5B7BE0	深色背景上的高亮/次级文字与图标
onPrimary	#FFFFFF	主色上的文字/图标
ink	#0B0C10	保持现值
bar	#101114	保持现值
card	#17191F	保持现值
muted	#B7BDC9	保持现值

对比度口径：正文 ≥ 4.5:1，大字/图标 ≥ 3:1；错误红、成功绿、点赞红等语义色不改。

三、预计影响文件

• lib/core/theme/app_colors.dart
• lib/app.dart
• lib/core/config/locale_controller.dart
• lib/pages/mine/mine_logic.dart
• lib/pages/home/widgets/home_quick_drawer.dart
• lib/pages/home/home_view.dart
• lib/pages/discover/discover_view.dart
• lib/pages/drama_detail/drama_detail_view.dart
• lib/pages/player/player_view.dart
• lib/pages/player/player_logic.dart
• lib/pages/player/widgets/seek_progress_bar.dart
• lib/pages/player/widgets/comment_tile.dart
• lib/pages/player/widgets/drama_comments_sheet.dart
• lib/pages/mine/mine_view.dart
• lib/pages/watch_records/watch_records_page.dart
• lib/pages/downloads/downloads_page.dart
• lib/pages/auth/auth_view.dart
• lib/core/widgets/auth_gate.dart
• lib/l10n/app_{en,zh,id}.arb 与生成文件
• test/theme/*、test/config/*、相关页面 widget 测试

实际改动以静态扫描结果为准；不改业务逻辑和页面布局。

四、TDD 顺序

1. 写主题 token/对比度、硬编码蓝色扫描、locale id 持久化与未知语言回退测试，确认红灯。
2. K5-A：新增色值 token 和浅色/深色 ColorScheme，补主题测试转绿。
3. K5-B：按扫描结果替换页面蓝色字面量，补语言入口和 widget 回归。
4. K5-C：实现 id locale、系统语言跟随、未知系统语言回退 id，两个入口增加 Bahasa Indonesia。
5. K5-D：全量扫描、深色/浅色与小屏 widget 回归。
6. 门禁：dart analyze lib test、flutter test、flutter build apk --debug。
7. --no-ff 合并回 develop 并 push；FruitServer 仅提交 docs/plans。

五、风险与处理

• 克莱因蓝在浅色背景上作为文字可能对比不足：正文继续使用现有着色， 主色主要用于按钮/图标/选中态；主色背景统一配 onPrimary。
• blueSoft 仅用于深色背景高亮，避免在浅色背景当正文色造成低对比度。
• 现有 _orange 等历史命名可能实际承载蓝色，替换时按语义改名，避免误导。
• 直接替换主题色可能影响 FilledButton、Slider、Switch 等 Material 控件： 通过显式 ColorScheme 和 widget 测试统一验证。
• 语言入口两处需同步，避免“我的”和快捷抽屉行为不一致。
• 真机、设备截图与系统语言切换证据由用户执行，Codex 不跑真机。

六、待确认

• 当前无产品歧义；按用户裁定的方案 A 色值执行。
• specs 无成文色板，若后续提供 Stitch 视觉稿，再按新稿更新 token 与页面映射。