docs(plans): 下发 K12 首页与空态视觉修订

This commit is contained in:
Zhou Weidong authored and trae-solo-agent committed 2026-10-17 22:39:37 +08:00
1 parent fe2e179bdc
commit 87a37e987a
1 file changed
+53 -1
+53 -1
View File
@@ -20,7 +20,59 @@
---
## [已处理·待用户验收] 2026-10-17 | K11 首页网格 3 列 + 分类首位「全部」
## [待处理] 2026-10-17 | K12 首页去标题 + 空态视觉重做
**用户指令(2026-10-17)**:「有了全部分类后 全部剧目不要显示了 而且现在空状态UI太丑了」。
> 在 K9/K10/K11 基础上做视觉修订,不改接口、数据与业务逻辑。
### 一、现状(实测)
- 首页 `lib/pages/discover/discover_view.dart`:分类 chips 下方有 `Text(l10n.allDramas)`(`Key('home-all-dramas-title')`),再往下才是 `_HomeDramaGrid`。
- 空态组件 `lib/core/widgets/empty_state.dart`:96×96 圆角 28 **实心方块** + 42px 图标 + 16px 标题 + 13px 副标题 + TextButton。用户反馈“太丑”。
### 二、本批范围
#### K12-A 去掉首页「全部剧目」标题
- 删除 `Key('home-all-dramas-title')` 的 `Text` 及其下间距;分类 chips 与网格间距调整为 12–14px。
- 网格、数据、空态逻辑不变;相关测试中“标题存在”的断言改为“不存在”,不得删测试文件。
#### K12-B 空态视觉重做(`empty_state.dart`)
目标:轻盈、精致、留白多,去掉“大色块 + 图标”的模板感。
图形结构改为**双层同心圆**:
- 外层圆:直径 84(compact 60),填充 `blue` 透明度 **0.05–0.06**,并加 1px 描边 `blue` 透明度 0.10–0.12;
- 内层圆:直径 56(compact 40),填充 `blue` 透明度 **0.10–0.12**;
- 中央图标:26–28px(compact 20–22),颜色深色主题 `blueSoft`、浅色主题 `blue`;
- 外层与内层同心居中,用 `Stack` 或两层 `Container` 嵌套实现。
文字与间距:
- 标题 15px / w600 / `onSurface`,与图形间距 14(compact 10);
- 副标题 12.5px / `muted` / 行高 1.45,与标题间距 6;
- 操作按钮:保留 `TextButton`,字号 13、主色、点击区 ≥44pt,与副标题间距 8;
- 整体 `Padding` 上下 28(compact 16),最大宽度 260;
- 不新增图片资源、不加动画。
#### K12-C 测试
- 更新 `empty_state` 相关断言:存在 `empty-state-art` 与内层圆(可用新 Key `empty-state-art-inner`)、图标尺寸、标题/副标题/按钮;
- 首页测试:`home-all-dramas-title` 不存在;chips 后直接出现 `home-all-dramas-grid`;
- 既有测试不得删改致绿。
### 三、门禁与 Git
- `dart analyze lib test` 零告警;`flutter test` 全过;`flutter build apk --debug` 通过(构建前确认无并发 `flutter run`/`build`)。
- 从干净 `develop` 拉 `feature/flutter-k12-home-empty-polish`;完成后 `git merge --no-ff` 回 `develop` 并 push;不动 `main`。
- 先写 `FruitServer/docs/plans/2026-10-17-K12.md`;每步「叙述 + 命令 + 原始输出 + 解读」追加到 `PROGRESS.md`;完成后停住写回执。
- 提交作者与提交者统一 `Zhou Weidong <502333560@qq.com>`。
---
## [待处理] 2026-10-17 | K11 首页网格 3 列 + 分类首位「全部」
**用户指令(2026-10-17)**:「现在改首页,一行显示 3 个,而且我要的全部是显示在分类的第一个」。