docs(plans): 记录 K12 首页与空态视觉回执

This commit is contained in:
Zhou Weidong committed 2026-10-17 22:45:20 +08:00
1 parent e49664ce55
commit b70449b232
2 files changed
+164 -1

No files matched your search

+140
View File
@@ -2495,6 +2495,146 @@ b5a8656 merge: 合并 K11 首页三列网格
---
## 2026-10-17 K12 首页去标题与空态重做
### 28.1 范围、分支与计划
叙述:删除 K11 首页「全部剧目」标题,使分类 chips 后直接进入网格;同时将
K10 空态从实心圆角块改为双层同心圆。只改首页间距、`EmptyState` 和对应测试。
- 客户端分支:`feature/flutter-k12-home-empty-polish`,基线 `b5a8656`。
- 文档分支:`docs/k12-home-empty-polish`,基线任务书 `87a37e9`。
开工前先写并提交计划:
```text
e49664c docs(plans): 增加 K12 首页与空态视觉修订计划
```
构建前已确认用户真机会话停止,进程检查无并发 Flutter run/build。
### 28.2 先红:标题与旧空态
```text
$ flutter test test/empty_state/empty_state_test.dart test/discover/home_all_dramas_grid_test.dart
Found 0 widgets with key [<'empty-state-art-inner'>]: []
Expected: Size(60, 60)
Actual: Size(64, 64)
Expected: <260>
Actual: <280.0>
Found 1 widget with key [<'home-all-dramas-title'>]
00:02 +2 -7: Some tests failed.
```
解读:旧实心圆角空态仍为 96/64、最大宽 280,首页标题仍存在,红灯与 K12
目标一致。
### 28.3 首页去标题
删除 `home-all-dramas-title` Text 及其间隔,分类 Sliver 的底部 padding 改为 14。
实际 chips 控件增加稳定 Key:
```text
home-category-chips
```
测试读取 chips 底边与首张卡片的 RenderBox 顶边,断言间距:
```text
closeTo(14, 0.1)
```
### 28.4 空态双层同心圆
最终规格:
```text
default outer: 84, blue alpha 0.055, border alpha 0.11
default inner: 56, blue alpha 0.11
compact outer: 60; inner: 40
icon: 27 / compact 21
title: 15 w600
subtitle: 12.5, height 1.45
button: 13, min height 44
padding: 24x28 / compact 16x16
max width: 260
```
新增 Key:
```text
empty-state-art-inner
empty-state-padding
```
`empty-state-art`、`empty-state-icon`、`empty-state-title`、
`empty-state-action` 保持,外层 Semantics 仍只读标题。
### 28.5 定向与全量绿灯
组件、首页和既有壳层:
```text
$ flutter test test/empty_state/empty_state_test.dart test/discover/home_all_dramas_grid_test.dart test/widget_test.dart
00:06 +26: All tests passed!
```
既有壳层测试中的 `All Dramas` 文本锚点改为稳定网格 Key
`home-all-dramas-grid`,原导航流程与用例全部保留。
```text
$ dart analyze lib test
Analyzing lib, test...
No issues found!
```
```text
$ flutter test
00:17 +302 ~1: All tests passed!
```
解读:302 项通过,1 项联调测试因客户端接口服务未启动按设计跳过。
### 28.6 APK 构建
```text
$ flutter build apk --debug
Running Gradle task 'assembleDebug'... 16.6s
✓ Built build/app/outputs/flutter-apk/app-debug.apk
```
### 28.7 Git
```text
2dd4627 feat(flutter): 精简首页标题并重做空态视觉
b762289 merge: 合并 K12 首页与空态视觉修订
b5a8656..b762289 develop -> develop
```
功能提交与合并提交 author/committer 均为
`Zhou Weidong <502333560@qq.com>`。
### 28.8 用户真机验证步骤与预期
以下设备侧取证由用户执行,Codex 未跑真机。
1. 打开首页并查看分类 chips 下方。
预期:不再显示「全部剧目」标题,chips 下方 14px 后直接出现 3 列网格。
2. 打开任一空列表页面。
预期:显示双层同心圆,外层比内层更淡,图标居中,不再是大块实心圆角矩形。
3. 分别切换深色和浅色主题。
预期:深色图标为 `blueSoft`,浅色图标为 `blue`,文字与背景对比清晰。
4. 检查带副标题和操作按钮的空态。
预期:标题 15、副标题 12.5、按钮 13,间距舒展,按钮点击区域不少于 44pt。
5. 打开无评论弹窗。
预期:使用 60/40 compact 双层圆,图标 21,上下留白 16,不挤压输入区。
6. 在 320px 宽小屏检查空态和首页。
预期:最大宽 260 生效,无横向溢出,标题最多两行。
设备侧截图、深浅主题与小屏结果由用户执行。
---
## 2026-10-17 iOS 构建阻塞:固定 shared_preferences_foundation 2.5.6
### 25.1 现象与根因