From b434f6594b813d7e9a861b760076dc1001332c31 Mon Sep 17 00:00:00 2001
From: Zhou Weidong <502333560@qq.com>
Date: Sat, 17 Oct 2026 17:20:35 +0800
Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E4=B8=8B=E5=8F=91=20K9=20?=
 =?UTF-8?q?=E9=A6=96=E9=A1=B5=E5=89=A7=E7=9B=AE=E7=BD=91=E6=A0=BC=E6=94=B9?=
 =?UTF-8?q?=E9=80=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/plans/INBOX.md | 48 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md
index 60b156e..2800d80 100644
--- a/docs/plans/INBOX.md
+++ b/docs/plans/INBOX.md
@@ -20,6 +20,54 @@
 
 ---
 
+## [待处理] 2026-10-17 | K9 首页剧目列表改造（2 列全部剧目）
+
+**用户指令（2026-10-17）**：「优化首页，要有全部剧目的列表，一行 2 个，不用显示继续观看的」。
+
+> 只改首页（发现页）信息流布局与卡片，不改接口、不改业务逻辑、不动后端。
+> 依赖 K5 主题 token 与现有 `RemoteImage` / 卡片视觉。
+
+### 〇、开工前必读
+
+1. `AGENTS.md`、`CODING_STANDARDS.md`、`GIT_WORKFLOW.md`
+2. 当前首页 `lib/pages/discover/discover_view.dart`（649 行）
+3. K5 主题 token、K7 轮播实现
+4. 本 INBOX 条目
+
+### 一、PM 已勘察的现状（实测）
+
+- 首页结构（`discover_view.dart`）：顶部 header → 轮播（home feed banners）→ 分类 chips（为你推荐/热门/最新/服务端分类）→「继续观看」标题 + 横向卡片列表（高 196、卡片宽 132，`_dramaContent` / `_continueHeader` / `_continueTile`）。
+- 数据源：`CategoryController.visibleDramas`（当前选中分类的剧目）；`_cardsFor(...)` 生成展示卡片；分类切换已有过滤逻辑。
+- 「继续观看」区块使用 l10n `continueWatching`；横向列表不展示播放进度，本质是分类剧目横滑。
+
+### 二、本批范围（首页单页改造）
+
+1. **移除「继续观看」区块**：删除 `_continueHeader` 调用与其标题；`_continueTile` 若不再被使用则一并删除（不留死代码）。
+2. **新增「全部剧目」2 列网格**：
+   - 位置：分类 chips 下方，占据原「继续观看」位置；
+   - 标题：新增 l10n `allDramas`（中文「全部剧目」/ English「All Dramas」/ Bahasa Indonesia「Semua Drama」）；
+   - 网格：每行 2 个，左右边距 16、列间距 12、行间距 16；封面竖版比例 2:3，圆角 14；
+   - 卡片内容：封面、标题（最多 2 行）、分类/类型（最多 1 行），沿用现有深色渐变与文字层级；
+   - 数据：当前选中分类下的全部剧目（沿用 `visibleDramas`，去重后全量渲染）；「为你推荐」显示全部；
+   - 点击：沿用 `logic.openCard(...)` 进详情；
+   - 长列表性能：外层改为 `CustomScrollView` + `SliverGrid`（或等价的懒构建方案），不要用 `GridView(shrinkWrap: true)` 嵌套整页；图片沿用 `RemoteImage` 懒加载。
+3. **保留**：header、轮播、分类 chips、底部导航、现有三态（加载/失败重试/空态）与空态文案（无分类剧目/无搜索结果）。
+4. **明确不做**：不动接口与数据模型、不改观看记录/收藏/下载、不改轮播与通知、不新增分页（feed 一次返回全量）、不改底部导航。
+
+### 三、测试与门禁
+
+- 新增/更新 widget 测试：首页不再出现「继续观看」；出现 `allDramas` 标题；网格为 2 列（断言 `SliverGridDelegateWithFixedCrossAxisCount.crossAxisCount == 2`）；分类切换后网格内容更新；空态与失败态保持。
+- `dart analyze lib test` 零告警；`flutter test` 全过；`flutter build apk --debug` 通过；构建前确认无并发 `flutter run`/`build` 占用 `build/`。
+- 真机验收由用户执行：首页滚动、2 列布局、分类切换、点击进详情。
+
+### 四、Git 与留痕
+
+- 从干净 `develop` 拉 `feature/flutter-k9-home-grid`；完成后 `git merge --no-ff` 回 `develop` 并 push；不动 `main`。
+- 先写 `FruitServer/docs/plans/2026-10-17-K9.md`；每步「叙述 + 命令 + 原始输出 + 解读」追加到 `PROGRESS.md`；完成后停住写回执。
+- 提交作者与提交者统一 `Zhou Weidong <502333560@qq.com>`。
+
+---
+
 ## [已处理·待用户验收] 2026-10-17 | K8 登录页视觉重设计
 
 **用户指令（2026-10-17）**：「接下来做登录页面 ui 优化，现在这个 ui 不好看」。