docs: 补充回忆布局、回忆 AI 与 Android 页面三组图表

This commit is contained in:
cat-shark
2026-11-20 09:36:54 +08:00
parent 281585698b
commit bd6717dc8d
33 changed files with 2296 additions and 0 deletions
+171
View File
@@ -0,0 +1,171 @@
<!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>