From 6fd532beae3a5573cddbc5528e5c8f63d8afc245 Mon Sep 17 00:00:00 2001 From: Zhou Weidong <502333560@qq.com> Date: Mon, 19 Oct 2026 15:51:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E8=AE=B0=E5=BD=95=20K26=20?= =?UTF-8?q?=E5=85=AD=E5=B1=8F=E9=A2=84=E8=A7=88=E6=A0=A1=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plans/2026-10-19-K26.md | 83 ++++++++++++++++++++++++++++++++++++ docs/plans/INBOX.md | 2 +- docs/plans/PROGRESS.md | 71 ++++++++++++++++++++++++++++++ 3 files changed, 155 insertions(+), 1 deletion(-) create mode 100644 docs/plans/2026-10-19-K26.md diff --git a/docs/plans/2026-10-19-K26.md b/docs/plans/2026-10-19-K26.md new file mode 100644 index 0000000..11f028c --- /dev/null +++ b/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>`。真机验收由用户执行。 + diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md index d739341..5131112 100644 --- a/docs/plans/INBOX.md +++ b/docs/plans/INBOX.md @@ -20,7 +20,7 @@ --- -## [待处理] 2026-10-19 | K26 客户端按「移动端设计预览.html」校正六屏 +## [已完成·待用户验收] 2026-10-19 | K26 客户端按「移动端设计预览.html」校正六屏 **用户指令（2026-10-19）**：「现在看 移动端设计预览.html 按这个来」。 > 新增权威设计文件（本地已同步）： diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md index 93a4380..0c0a6dd 100644 --- a/docs/plans/PROGRESS.md +++ b/docs/plans/PROGRESS.md @@ -5049,3 +5049,74 @@ eefabb6 merge: 修复播放器全屏进入方式 提交与合并 author/committer 均为 `Zhou Weidong <502333560@qq.com>`； `develop` 与 `fix/flutter-player-fullscreen` 已推送。真机验收由用户执行。 + +### K26 客户端六屏按「移动端设计预览」校正（2026-10-19） + +权威文件：`/Users/jianghaifeng/Desktop/ReelShort/docs/移动端设计预览.html`。 +保留 K24 的 Outfit / Plus Jakarta Sans、全部 Provider 业务逻辑与接口。 + +Token： + +- `bar=#0D0D11`、`card=#1B1C21`、`cardAlt/raised=#1C1D21`、`input=#25252A`、 + `quick=#202126`、`goldCard=#201B1E`、`text=#E6E1E3`、`muted=#D2CDD0`、 + `subtle=#9A96A3`、`accent=#FFA490`。 +- 卡片圆角 12、按钮 9、chips 20、封面 10；导航高 54、图标 17、文字 9； + 进度条 3px。 + +六屏： + +1. 首页：剧名 + 28px 搜索/菜单；Like/Comment/Share/Favorite 四项；底部 14px 玻璃卡 + （tags、第 x/共 y 集、13px 标题、34px 追剧/选集）；去掉 HOT/Season/头像 Follow。 +2. 发现：Logo + 发现 + 搜索/头像；36px 搜索框；推荐分类 chips；52×66 Continue Watching； + 4 个 62px 快捷入口；热门短剧标题 + 2 列 120px 封面网格。 +3. 详情：190px hero + 28px 返回；N 集、18px 标题、11px 简介、40px 开始观看、选集 chips； + 收藏/下载/分享/举报收进更多；移除 K25 统计行、CTA 行与剧集预览卡。 +4. 播放器：全屏 46px 顶栏；中心 52px 播放、1.0x；3px 进度；32px 选集/评论/下一集； + 精选评论卡；无右侧互动栏；下载/PiP/点赞/收藏/分享收进更多。 +5. 我的：Logo + 我的 + 搜索/头像；48px 用户行；`#201B1E` 金币卡；50×64 Continue Watching； + 历史/收藏/喜欢 Tabs；历史卡；语言行；保留通知/下载/账号中心入口。 +6. 登录：64px 渐变 Logo + 水果短剧 + 副标题；Google/手机号/邮箱三个 44px 入口； + Google/手机号提示即将开放，邮箱进入 K21 表单；底部法律文案。 + +新增/更新测试：首页预览卡、发现搜索/Continue Watching/2 列网格、详情选集 chips、 +全屏播放器三按钮、Me 页用户/金币/继续观看/语言行、登录三入口。 + +门禁原始输出： + +```text +$ dart analyze lib test +No issues found! + +$ flutter test +00:30 +354: All tests passed! + +$ flutter build apk --debug +Running Gradle task 'assembleDebug'... 27.2s +✓ Built build/app/outputs/flutter-apk/app-debug.apk +``` + +构建在 `/tmp/reelshort-k26-final` 独立 worktree 完成，避免与用户侧 `flutter run` +并发占用主 `build/`。 + +Git： + +```text +87db548 feat(theme): 校正 K26 预览色板与导航 +21d457f feat(ui): 校正首页发现详情播放器预览 +fecc5b0 feat(ui): 新增登录入口与我的页预览 +8767b56 test(ui): 更新三 Tab 预览断言 +a5398da merge: K26 客户端六屏按预览校正 +``` + +提交与合并 author/committer 均为 `Zhou Weidong <502333560@qq.com>`。 +ReelShort `develop` 与 `feature/flutter-k26-mobile-preview` 已推送。 + +真机验收步骤（设备侧取证由用户执行）： + +1. 首页检查剧名/搜索/菜单、四项互动、底部玻璃卡与 34px 追剧/选集按钮。 +2. 发现检查 36px 搜索、分类 chips、Continue Watching、4 快捷入口、2 列热门短剧。 +3. 详情检查 190px hero、N 集、18px 标题、40px 开始观看与选集 chips；更多菜单含收藏/下载。 +4. 从详情进入播放器，检查全屏顶栏、中心播放、3px 进度、三按钮与精选评论。 +5. 我的检查用户行、金币卡、Continue Watching、历史/收藏/喜欢与语言行。 +6. 登录页检查三个入口；Google/手机号提示即将开放，邮箱进入现有表单。 +7. 320×568、360×720、390×844 与深色/浅色检查无溢出。