docs(plans): 记录 K26 六屏预览校正

docs/plans/2026-10-19-K26.md

@@ -0,0 +1,83 @@
+# K26 计划：客户端按「移动端设计预览」校正六屏
+
+日期：2026-10-19
+基线：`ReelShort/develop` = `eefabb6`
+分支：`feature/flutter-k26-mobile-preview`
+
+## 一、范围
+
+按本地 `/Users/jianghaifeng/Desktop/ReelShort/docs/移动端设计预览.html`
+校正六屏：首页、发现、详情、播放器、我的、登录。该文件优先于此前 Stitch screens。
+
+保留 K24 的 Outfit / Plus Jakarta Sans、Provider 业务逻辑、现有接口与数据模型。
+不改后端、Web、specs、main。
+
+## 二、Token
+
+| 语义 | 值 |
+| --- | --- |
+| primary | `#FF5B3D` |
+| secondary | `#9278EA` |
+| background | `#0B0C10` |
+| nav | `#0D0D11` |
+| card | `#1B1C21` |
+| cardAlt | `#1C1D21` |
+| input / quick | `#25252A` / `#202126` |
+| gold card | `#201B1E` |
+| text / dim / accent | `#E6E1E3` / `#D2CDD0` / `#FFA490` |
+| border | `white 8%` |
+
+圆角：卡片 10-14、按钮 9、chips 20、封面 10。
+新增紧凑字号 token（9/10/11/12/13/14/15/18/20）与按钮高度 token（28/32/34/40/44）。
+
+## 三、六屏
+
+1. 首页：剧名 + 搜索/菜单；Like/Comment/Share/Favorite 四互动；底部玻璃卡
+   （tags、第 x/共 y 集、13px 标题、34px 追剧/选集）；去掉 HOT/Season/Follow。
+2. 发现：Logo + 发现 + 搜索/头像；36px 搜索框；分类 chips；52×66 Continue Watching；
+   4 个 62px 快捷入口；热门短剧标题 + 2 列封面高 120 网格。
+3. 详情：190px hero + 28px 返回；N 集、18px 标题、11px 简介、40px 开始观看、选集 chips；
+   收藏/下载/举报收进更多；删除统计行、预览卡与底部 Tab。
+4. 播放器：全屏；46px 顶栏；中心 52px 播放 + 1.0x；3px 进度；32px 选集/评论/下一集；
+   一条精选评论卡；无右侧互动栏；下载/PiP/互动收进更多。
+5. 我的：顶部 Logo + 我的 + 搜索/头像；48px 用户行；金币卡；Continue Watching；
+   历史/收藏/喜欢；语言行；底部 3 Tab。
+6. 登录：64px 渐变 Logo + 水果短剧 + 副标题；Google/手机号/邮箱三个 44px 入口；
+   Google/手机号置灰提示即将开放，邮箱进入 K21 表单；底部法律文案。
+
+## 四、TDD 顺序
+
+1. Token / AppDimens / GlassPanel 测试。
+2. 首页 overlay 结构与底部导航测试。
+3. 发现页搜索、Continue Watching、快捷入口、2 列网格测试。
+4. 详情页 190px hero、40px CTA、选集 chips 测试。
+5. 播放器全屏顶栏、三按钮、精选评论测试。
+6. 我的页用户行、金币卡、Continue Watching、语言行测试。
+7. 登录入口与邮箱二级表单测试。
+8. 回归播放、进度、收藏、下载、PiP、票据错误、评论与导航。
+
+## 五、数据缺口
+
+- 剧级点赞/评论数、已完结、Top 排名、VIP、评分、场景标签无模型字段：隐藏。
+- Continue Watching 仅有 `episodeId/position/duration`；集号能从剧集列表匹配时显示。
+- 金币余额与 Google/手机号登录后端未就绪：金币显示 0，Google/手机号入口提示即将开放。
+- 剧集时长只有 `durationSec`；缺失则不显示。
+
+## 六、风险
+
+- 六屏同时调整会触碰大量既有 widget 测试；只改视觉/布局与入口，不改业务逻辑。
+- 登录页改成入口页后，K21 邮箱表单测试需要先点击邮箱入口；表单本身与认证逻辑保持不变。
+- 播放器仍复用 ticket/PlaybackSession/PlaybackQueue；只替换非首页的 overlay。
+- 卡片圆角与按钮高度变化可能影响小屏布局，用 320×568、360×720、390×844 回归。
+
+## 七、门禁
+
+```bash
+dart analyze lib test
+flutter test
+flutter build apk --debug
+```
+
+完成后 `--no-ff` 合并回 `develop` 并 push；作者/提交者
+`Zhou Weidong <502333560@qq.com>`。真机验收由用户执行。
+