Files
lpt-meta/docs/diagrams/android-ui/index.html
T

172 lines
14 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>lpt-android 页面重构 · 目标态线框</title>
<style>
body { margin: 0 auto; max-width: 1180px; padding: 28px 24px 80px; background: #f6f8f7; color: #16241C;
font-family: "PingFang SC", "Microsoft YaHei", system-ui, sans-serif; line-height: 1.65; }
h1 { font-size: 24px; margin: 0 0 6px; }
h2 { font-size: 17px; border-left: 3px solid #237556; padding-left: 10px; margin: 44px 0 12px; }
h3 { font-size: 15px; margin: 28px 0 8px; color: #237556; }
.tip { color: #4B6156; font-size: 13px; }
.lead { font-size: 14px; color: #33463C; }
.wire { margin: 14px 0 8px; background: #fff; border: 1px solid #D7E2DC; border-radius: 10px; padding: 12px; }
.wire img { display: block; height: auto; }
.wire.single img { width: auto; max-width: 400px; margin: 0 auto; }
.wire.multi img { width: 100%; }
figcaption { margin-top: 10px; font-size: 12.5px; color: #4B6156; line-height: 1.75; }
.grid2 { display: flex; gap: 18px; flex-wrap: wrap; }
.grid2 > figure { flex: 1 1 320px; margin: 0; }
table { border-collapse: collapse; width: 100%; font-size: 13px; margin: 8px 0 4px; background: #fff; }
th, td { border: 1px solid #DCE6E1; padding: 6px 9px; text-align: left; vertical-align: top; }
th { background: #EFF5F1; font-weight: 600; }
code { font-family: "JetBrains Mono", Menlo, Consolas, monospace; font-size: 12px; background: #EDF3EF;
padding: 1px 4px; border-radius: 3px; }
.swatch { display: inline-block; width: 34px; height: 14px; border-radius: 3px; border: 1px solid #C6D6CD;
vertical-align: -2px; margin-right: 6px; }
ul { padding-left: 20px; }
li { margin: 3px 0; font-size: 13.5px; }
.ask { background: #fff; border: 1px solid #D7E2DC; border-left: 3px solid #237556; border-radius: 8px;
padding: 12px 16px; margin: 10px 0; }
.ask b { display: block; margin-bottom: 2px; }
.badge { display: inline-block; font-size: 11.5px; border-radius: 999px; padding: 0 8px; margin-left: 6px;
border: 1px solid #BFD6CA; color: #237556; }
</style>
</head>
<body>
<h1>lpt-android 页面重构 · 目标态线框</h1>
<p class="lead">六个页面 + 状态矩阵的线框,按 <code>lpt-android/.agents/roles/design-system.md</code> 登记的取值绘制;
图上文案就是落地后的真实文案,不是占位。图源是同目录的 <code>.svg</code>(由 <code>_build_wireframes.py</code> 生成,改文案改脚本重跑),
画布 360×800,等于真机 1080×2400 的 dp。</p>
<p class="tip">本地预览:<code>cd docs/diagrams &amp;&amp; python3 -m http.server 8000</code>,再开
<code>http://localhost:8000/android-ui/index.html</code>。</p>
<h2>一、这一轮吃掉哪几条偏差</h2>
<table>
<tr><th>现状偏差(登记处)</th><th>这一轮的做法</th></tr>
<tr><td>#1 主色还是 M3 蓝 <code>#1F6FEB</code> / <code>#6EA8FE</code></td><td>换成 <code>#237556</code> / <code>#7FD8B4</code>,两个色板都按下面取值表补全</td></tr>
<tr><td>#2 深色只覆盖 4 个槽位</td><td>深色 8 个槽位全给值:页底 <code>#111A16</code>、面 <code>#1B2A23</code>、内嵌 <code>#22332B</code>…</td></tr>
<tr><td>#3 条目与区块都是灰 <code>Card</code></td><td>分开:页面区块 = 12dp 卡片无描边;列表条目 = 白底 8dp + 1dp 描边</td></tr>
<tr><td>#4 顶栏四个等权文字按钮</td><td>任务页顶栏只留「设置」;权限、地址、退出登录全进设置页</td></tr>
<tr><td>#5 <code>labelSmall</code> 11sp 写正文</td><td>6 处全部换 <code>bodySmall</code> 12sp,全仓不再出现 11sp</td></tr>
<tr><td>#7 空态与错误态同一分支</td><td>空 / 加载 / 错误三条分支各自成形,见「任务页三态」</td></tr>
<tr><td>#8 间距档位散在 4/6/8/10/12/14/16/20/24</td><td>只留 4 / 8 / 12 / 16 / 24,<code>Spacer(0.dp)</code> 三处直接删</td></tr>
</table>
<h2>二、取值:颜色、间距、字号、容器</h2>
<h3>颜色(含实测对比度)</h3>
<table>
<tr><th>用在哪</th><th>浅色</th><th>深色</th><th>对比度</th></tr>
<tr><td>页面底</td><td><span class="swatch" style="background:#F7FBF8"></span><code>#F7FBF8</code></td><td><span class="swatch" style="background:#111A16"></span><code>#111A16</code></td><td>深色主文字 15.06:1</td></tr>
<tr><td>区块 / 条目面</td><td><span class="swatch" style="background:#FFFFFF"></span><code>#FFFFFF</code></td><td><span class="swatch" style="background:#1B2A23"></span><code>#1B2A23</code></td><td>浅色 16.11:1 / 深色 12.71:1</td></tr>
<tr><td>输入框底、内嵌块</td><td><span class="swatch" style="background:#F1F6F3"></span><code>#F1F6F3</code></td><td><span class="swatch" style="background:#22332B"></span><code>#22332B</code></td><td>深色次要字 7.50:1</td></tr>
<tr><td>主操作实底 / 上面的字</td><td><span class="swatch" style="background:#237556"></span><code>#237556</code> / <code>#FFFFFF</code></td><td><span class="swatch" style="background:#7FD8B4"></span><code>#7FD8B4</code> / <code>#111A16</code></td><td>5.60:1 / 10.47:1</td></tr>
<tr><td>强调块(进行中会话)</td><td><span class="swatch" style="background:#EEF9F3"></span><code>#EEF9F3</code> + <code>#237556</code> 字</td><td><span class="swatch" style="background:#17332A"></span><code>#17332A</code> + <code>#7FD8B4</code></td><td>5.19:1 / 8.02:1</td></tr>
<tr><td>次要文字(时间戳、说明)</td><td><code>#4B6156</code></td><td><code>#B3C7BD</code></td><td>6.40:1 / 9.99:1</td></tr>
<tr><td>到时 / 暂停提醒条</td><td><span class="swatch" style="background:#FFF8E1"></span><code>#FFF8E1</code> + <code>#856404</code></td><td><span class="swatch" style="background:#3A3220"></span><code>#3A3220</code> + <code>#FFD08A</code></td><td>5.17:1 / 11.00:1</td></tr>
<tr><td>错误</td><td><code>#B62324</code>(底 <code>#FDECEA</code>)</td><td><code>#F85149</code></td><td>5.64:1 / 5.29:1</td></tr>
<tr><td>列表条目 1dp 分组描边</td><td><code>#C6D6CD</code></td><td><code>#33453D</code></td><td>1.5:1,只做分隔,不用它表达状态</td></tr>
<tr><td>图标 / 需要识别的强描边</td><td><code>#6B7F75</code></td><td>同色系提亮</td><td>4.27:1</td></tr>
</table>
<h3>间距与字号</h3>
<table>
<tr><th>项</th><th>取值</th><th>用在哪</th></tr>
<tr><td>间距五档</td><td>4 / 8 / 12 / 16 / 24</td><td>条目内相邻行 8;条目内 12;条目之间、区块之间 16;页面大块之间 24</td></tr>
<tr><td>屏幕边距</td><td>16</td><td>登录页 24 保留为已登记例外</td></tr>
<tr><td>字号六档</td><td>28 / 22 / 16 / 14 / 12 / 44</td><td>44 只给会话页大计时(唯一自造字号,等宽 + 粗体)</td></tr>
<tr><td>圆角三档</td><td>8 / 12 / 18</td><td>条目 8、区块 12、浮窗拉起的输入页 18(已登记例外)</td></tr>
</table>
<h2>三、页面</h2>
<h3>任务页 <span class="badge">顶栏只留一个动作</span><span class="badge">条目与区块分家</span></h3>
<figure class="wire single">
<img src="tasks.svg?v=3" alt="任务页目标态:标题 + 设置,进行中会话块,搜索,白底描边任务条目">
<figcaption>
<b>留:</b>页面标题「学习任务」,右上只一个「设置」;进行中会话独立成块(整块可点,不带箭头);搜索框(任务 ≥6 个才出现,40dp 高、浅底无描边);任务条目。<br>
<b>删:</b>「已登录:admin」、「共 8 个任务」、「刷新」「权限」「退出登录」四个顶栏/次级按钮、「开始学习 ›」的箭头。<br>
<b>主操作:</b>每行右下唯一绿色「开始学习」;「报告」降为 <code>#4B6156</code> 次要色,不与主操作抢。<br>
<b>取值:</b>条目 8dp 圆角 + 1dp <code>#C6D6CD</code>,内边距 12;任务名 14、描述与优先级 12(优先级用等宽数字);条目间 16。
</figcaption>
</figure>
<h3>任务页三态 <span class="badge">空 / 加载 / 错误分开</span></h3>
<figure class="wire multi">
<img src="tasks-states.svg?v=3" alt="任务页空态、加载骨架、错误态三张并排">
<figcaption>
<b>空:</b>一句事实 + 一句「任务在网页端新建」+ 一个「刷新列表」。<br>
<b>加载:</b>三条骨架块,不用居中大转圈(列表位置不跳)。<br>
<b>错误:</b>标题「任务列表没加载出来」+ 原因「网络断开,或服务器没有响应」+ 一句「恢复网络后重新加载,列表不会丢」+「重新加载」。错误不再和空态共用一条文案。
</figcaption>
</figure>
<h3>会话页 <span class="badge">一屏只有一个大计时</span></h3>
<figure class="wire single">
<img src="session.svg?v=3" alt="会话页目标态:任务名、倒计时、44sp 大计时、暂停与结束、预期与碎片">
<figcaption>
<b>留:</b>顶栏用任务名当标题(会话号 12sp 在下面);倒计时一行小字 + 44sp 等宽大计时 + 「有效学习时间」;「暂停」实底、「结束学习」描边、两行分开;「显示悬浮窗」文字入口;学习预期已填就显示文本 +「修改」;知识碎片输入 + 最近 3 条 +「查看全部」。<br>
<b>删:</b>「状态:进行中」、「已暂停 · 有效学习时间」前缀、页面底部「正在与服务器同步…」、「误操作结束(零数据 / 已产生碎片,不可用)」这一长串——改成页面最底一行「误操作结束」,点开才是确认弹窗。<br>
<b>主操作:</b>「暂停」/「继续」独占一行;「结束学习」是描边次级,不与主操作并排同权重。
</figcaption>
</figure>
<h3>会话页两个非常态 <span class="badge">状态靠形态</span></h3>
<figure class="wire multi">
<img src="session-states.svg?v=3" alt="会话页暂停态、到点态并排">
<figcaption>
<b>暂停:</b>顶部一条 <code>#FFF8E1</code> 提醒「已暂停,继续后接着计时」,大计时降到 <code>#4B6156</code>,按钮变「继续」。不写「(暂停中)」这类小眉标。<br>
<b>到点:</b>提醒条写「本轮时间已到,先暂停休息 / 会话不会自己结束」,倒计时 <code>00:00</code> 用提醒色,按钮仍是「暂停」——会话不会自己结束。
</figcaption>
</figure>
<h3>报告页 <span class="badge">结论先行</span></h3>
<figure class="wire multi">
<img src="reports.svg?v=3" alt="报告页目标态:每条只露日期与会话摘要,展开后露出预期、判断、自由总结">
<figcaption>
<b>留:</b>顶栏「学习报告」+ 任务名;每条只露「日期 + 会话号 + 会话摘要」,「展开全文」才露出本次预期 / 预期达成判断 / 自由总结;「查看本次碎片」保留(降为次要色);底部「加载更多(3/12)」。<br>
<b>删:</b>每条重复的「学习报告」标题(一屏三次同字)、章节标签的绿色、11sp 时间戳。
</figcaption>
</figure>
<h3>设置页 <span class="badge">权限并进来</span></h3>
<figure class="wire multi">
<img src="settings.svg?v=3" alt="设置页目标态:权限三条、小米额外设置、服务器地址、退出登录;右侧为首启权限引导">
<figcaption>
<b>留:</b>权限三条(标题 + 为什么 + 右侧状态,未授权时多一个「去开启」);小米 / MIUI 额外设置(收起成一行,展开才是说明);服务器地址(当前值 +「修改」);最底「退出登录」。<br>
<b>首启引导(右图):</b>同一套权限行,换一句标题「能不能跨应用计时,取决于这三项」,底部主操作「已完成,去学习任务」,右上「稍后」。不再写页面级说明段——理由挪进每条的说明行。<br>
<b>删:</b>任务页顶栏的「权限」「退出登录」,以及原来权限页与设置页各写一遍的重复文案。
</figcaption>
</figure>
<h3>登录页 <span class="badge">去自述</span></h3>
<figure class="wire single">
<img src="login.svg?v=3" alt="登录页目标态:只有标题、账号、密码、登录、修改 API 地址">
<figcaption>
<b>留:</b>「LPT 学习」28sp 标题、账号、密码、全宽「登录」、「修改 API 地址」文字入口。<br>
<b>删:</b>副标题「移动端学习会话 · 悬浮窗计时」、页脚「LPT」、底部「提示:dev 环境默认 https://lpt-dev…」(这句把域名写死在界面里,改了地址它也不会跟着变)。
</figcaption>
</figure>
<h3>深色 <span class="badge">8 个槽位全给值</span></h3>
<figure class="wire single">
<img src="tasks-dark.svg?v=3" alt="任务页深色目标态">
<figcaption>页底 <code>#111A16</code>、面 <code>#1B2A23</code>、输入框 <code>#22332B</code>、描边 <code>#33453D</code>、主色 <code>#7FD8B4</code>。深浅两套按同一色相派生,不是把浅色反相。</figcaption>
</figure>
<h2>四、需要你拍板的地方</h2>
<div class="ask"><b>1. 任务页首屏是否接受「没有刷新按钮」?</b>
刷新改成下拉刷新(列表 >1 屏时用手势),空态与错误态各自带按钮。代价:任务 ≤5 条时没有明显刷新入口。</div>
<div class="ask"><b>2. 搜索框何时出现?</b>
现在任务 ≥6 个才出现,≤5 个不占首屏。若你经常在 3–4 个任务时搜,就改成常驻。</div>
<div class="ask"><b>3. 会话页顶栏用任务名替代「学习会话」这个页标题,可以吗?</b>
任务名更长、逐屏不同,比重复的固定标题有用;代价是不符合「每页一个 22sp 标题」的字面规则,要把它写成登记例外。</div>
<div class="ask"><b>4. 报告条目默认只露会话摘要,预期/判断/自由总结收进「展开全文」——够用吗?</b>
这是本次删得最多的一处:一屏从 3 条压到 2 条多一点,但要看全一次学习的结论多点一次。</div>
<p class="tip" style="margin-top:36px">确认后按三个单元改代码:A 取值与共用件(Theme / 间距常量 / 页头与条目组件)→ B 任务页 + 设置页 + 权限段 + 导航 → C 会话页 + 报告页 + 登录页;改完按真机矩阵截图(默认 / 空 / 加载 / 错误 / 深色 / 130% / 200% / 横屏)再走一轮 <code>ui-review</code>。</p>
</body>
</html>