lpt-android 页面重构 · 目标态线框

六个页面 + 状态矩阵的线框,按 lpt-android/.agents/roles/design-system.md 登记的取值绘制; 图上文案就是落地后的真实文案,不是占位。图源是同目录的 .svg(由 _build_wireframes.py 生成,改文案改脚本重跑), 画布 360×800,等于真机 1080×2400 的 dp。

本地预览:cd docs/diagrams && python3 -m http.server 8000,再开 http://localhost:8000/android-ui/index.html。

一、这一轮吃掉哪几条偏差

现状偏差(登记处)这一轮的做法
#1 主色还是 M3 蓝 #1F6FEB / #6EA8FE换成 #237556 / #7FD8B4,两个色板都按下面取值表补全
#2 深色只覆盖 4 个槽位深色 8 个槽位全给值:页底 #111A16、面 #1B2A23、内嵌 #22332B…
#3 条目与区块都是灰 Card分开:页面区块 = 12dp 卡片无描边;列表条目 = 白底 8dp + 1dp 描边
#4 顶栏四个等权文字按钮任务页顶栏只留「设置」;权限、地址、退出登录全进设置页
#5 labelSmall 11sp 写正文6 处全部换 bodySmall 12sp,全仓不再出现 11sp
#7 空态与错误态同一分支空 / 加载 / 错误三条分支各自成形,见「任务页三态」
#8 间距档位散在 4/6/8/10/12/14/16/20/24只留 4 / 8 / 12 / 16 / 24,Spacer(0.dp) 三处直接删

二、取值:颜色、间距、字号、容器

颜色(含实测对比度)

用在哪浅色深色对比度
页面底#F7FBF8#111A16深色主文字 15.06:1
区块 / 条目面#FFFFFF#1B2A23浅色 16.11:1 / 深色 12.71:1
输入框底、内嵌块#F1F6F3#22332B深色次要字 7.50:1
主操作实底 / 上面的字#237556 / #FFFFFF#7FD8B4 / #111A165.60:1 / 10.47:1
强调块(进行中会话)#EEF9F3 + #237556 字#17332A + #7FD8B45.19:1 / 8.02:1
次要文字(时间戳、说明)#4B6156#B3C7BD6.40:1 / 9.99:1
到时 / 暂停提醒条#FFF8E1 + #856404#3A3220 + #FFD08A5.17:1 / 11.00:1
错误#B62324(底 #FDECEA)#F851495.64:1 / 5.29:1
列表条目 1dp 分组描边#C6D6CD#33453D1.5:1,只做分隔,不用它表达状态
图标 / 需要识别的强描边#6B7F75同色系提亮4.27:1

间距与字号

项取值用在哪
间距五档4 / 8 / 12 / 16 / 24条目内相邻行 8;条目内 12;条目之间、区块之间 16;页面大块之间 24
屏幕边距16登录页 24 保留为已登记例外
字号六档28 / 22 / 16 / 14 / 12 / 4444 只给会话页大计时(唯一自造字号,等宽 + 粗体)
圆角三档8 / 12 / 18条目 8、区块 12、浮窗拉起的输入页 18(已登记例外)

三、页面

任务页 顶栏只留一个动作条目与区块分家

任务页目标态:标题 + 设置,进行中会话块,搜索,白底描边任务条目
留:页面标题「学习任务」,右上只一个「设置」;进行中会话独立成块(整块可点,不带箭头);搜索框(任务 ≥6 个才出现,40dp 高、浅底无描边);任务条目。
删:「已登录:admin」、「共 8 个任务」、「刷新」「权限」「退出登录」四个顶栏/次级按钮、「开始学习 ›」的箭头。
主操作:每行右下唯一绿色「开始学习」;「报告」降为 #4B6156 次要色,不与主操作抢。
取值:条目 8dp 圆角 + 1dp #C6D6CD,内边距 12;任务名 14、描述与优先级 12(优先级用等宽数字);条目间 16。

任务页三态 空 / 加载 / 错误分开

任务页空态、加载骨架、错误态三张并排
空:一句事实 + 一句「任务在网页端新建」+ 一个「刷新列表」。
加载:三条骨架块,不用居中大转圈(列表位置不跳)。
错误:标题「任务列表没加载出来」+ 原因「网络断开,或服务器没有响应」+ 一句「恢复网络后重新加载,列表不会丢」+「重新加载」。错误不再和空态共用一条文案。

会话页 一屏只有一个大计时

会话页目标态:任务名、倒计时、44sp 大计时、暂停与结束、预期与碎片
留:顶栏用任务名当标题(会话号 12sp 在下面);倒计时一行小字 + 44sp 等宽大计时 + 「有效学习时间」;「暂停」实底、「结束学习」描边、两行分开;「显示悬浮窗」文字入口;学习预期已填就显示文本 +「修改」;知识碎片输入 + 最近 3 条 +「查看全部」。
删:「状态:进行中」、「已暂停 · 有效学习时间」前缀、页面底部「正在与服务器同步…」、「误操作结束(零数据 / 已产生碎片,不可用)」这一长串——改成页面最底一行「误操作结束」,点开才是确认弹窗。
主操作:「暂停」/「继续」独占一行;「结束学习」是描边次级,不与主操作并排同权重。

会话页两个非常态 状态靠形态

会话页暂停态、到点态并排
暂停:顶部一条 #FFF8E1 提醒「已暂停,继续后接着计时」,大计时降到 #4B6156,按钮变「继续」。不写「(暂停中)」这类小眉标。
到点:提醒条写「本轮时间已到,先暂停休息 / 会话不会自己结束」,倒计时 00:00 用提醒色,按钮仍是「暂停」——会话不会自己结束。

报告页 结论先行

报告页目标态:每条只露日期与会话摘要,展开后露出预期、判断、自由总结
留:顶栏「学习报告」+ 任务名;每条只露「日期 + 会话号 + 会话摘要」,「展开全文」才露出本次预期 / 预期达成判断 / 自由总结;「查看本次碎片」保留(降为次要色);底部「加载更多(3/12)」。
删:每条重复的「学习报告」标题(一屏三次同字)、章节标签的绿色、11sp 时间戳。

设置页 权限并进来

设置页目标态:权限三条、小米额外设置、服务器地址、退出登录;右侧为首启权限引导
留:权限三条(标题 + 为什么 + 右侧状态,未授权时多一个「去开启」);小米 / MIUI 额外设置(收起成一行,展开才是说明);服务器地址(当前值 +「修改」);最底「退出登录」。
首启引导(右图):同一套权限行,换一句标题「能不能跨应用计时,取决于这三项」,底部主操作「已完成,去学习任务」,右上「稍后」。不再写页面级说明段——理由挪进每条的说明行。
删:任务页顶栏的「权限」「退出登录」,以及原来权限页与设置页各写一遍的重复文案。

登录页 去自述

登录页目标态:只有标题、账号、密码、登录、修改 API 地址
留:「LPT 学习」28sp 标题、账号、密码、全宽「登录」、「修改 API 地址」文字入口。
删:副标题「移动端学习会话 · 悬浮窗计时」、页脚「LPT」、底部「提示:dev 环境默认 https://lpt-dev…」(这句把域名写死在界面里,改了地址它也不会跟着变)。

深色 8 个槽位全给值

任务页深色目标态
页底 #111A16、面 #1B2A23、输入框 #22332B、描边 #33453D、主色 #7FD8B4。深浅两套按同一色相派生,不是把浅色反相。

四、需要你拍板的地方

1. 任务页首屏是否接受「没有刷新按钮」? 刷新改成下拉刷新(列表 >1 屏时用手势),空态与错误态各自带按钮。代价:任务 ≤5 条时没有明显刷新入口。
2. 搜索框何时出现? 现在任务 ≥6 个才出现,≤5 个不占首屏。若你经常在 3–4 个任务时搜,就改成常驻。
3. 会话页顶栏用任务名替代「学习会话」这个页标题,可以吗? 任务名更长、逐屏不同,比重复的固定标题有用;代价是不符合「每页一个 22sp 标题」的字面规则,要把它写成登记例外。
4. 报告条目默认只露会话摘要,预期/判断/自由总结收进「展开全文」——够用吗? 这是本次删得最多的一处:一屏从 3 条压到 2 条多一点,但要看全一次学习的结论多点一次。

确认后按三个单元改代码:A 取值与共用件(Theme / 间距常量 / 页头与条目组件)→ B 任务页 + 设置页 + 权限段 + 导航 → C 会话页 + 报告页 + 登录页;改完按真机矩阵截图(默认 / 空 / 加载 / 错误 / 深色 / 130% / 200% / 横屏)再走一轮 ui-review。