diff --git a/docs/diagrams/android-ui/_build_wireframes.py b/docs/diagrams/android-ui/_build_wireframes.py
new file mode 100644
index 0000000..ad41eb6
--- /dev/null
+++ b/docs/diagrams/android-ui/_build_wireframes.py
@@ -0,0 +1,371 @@
+#!/usr/bin/env python3
+"""生成 lpt-android 目标态线框(.svg)。
+
+取值来自 lpt-android/.agents/roles/design-system.md:
+ 主色 #237556(深色 #7FD8B4)、页底 #F7FBF8 / #111A16、面 #FFFFFF / #1B2A23、
+ 输入框底 #F1F6F3 / #22332B、描边 #C6D6CD / #33453D、次要字 #4B6156 / #B3C7BD、
+ 提醒条 #FFF8E1/#856404、错误 #B62324、强调底 #EEF9F3。
+一屏一份文件;画布 360×800(=真机 1080×2400 的 dp)。改文案或布局改这里,重跑:
+
+ python3 docs/diagrams/android-ui/_build_wireframes.py
+
+不生成二进制;产物是同目录的 .svg,由 index.html 引用。
+"""
+
+import os
+
+W, H, PAD, GUTTER = 360, 800, 16, 24
+FONT = "'Noto Sans CJK SC','Source Han Sans SC','PingFang SC','Microsoft YaHei',system-ui,sans-serif"
+MONO = "'JetBrains Mono','SF Mono',Menlo,Consolas,monospace"
+
+LIGHT = dict(bg="#F7FBF8", surface="#FFFFFF", inset="#F1F6F3", text="#16241C", sec="#4B6156",
+ primary="#237556", on_primary="#FFFFFF", border="#C6D6CD", accent="#EEF9F3",
+ warn_bg="#FFF8E1", warn="#856404", err="#B62324", err_bg="#FDECEA",
+ skeleton="#E4EDE8")
+DARK = dict(bg="#111A16", surface="#1B2A23", inset="#22332B", text="#E4EFE9", sec="#B3C7BD",
+ primary="#7FD8B4", on_primary="#111A16", border="#33453D", accent="#17332A",
+ warn_bg="#3A3220", warn="#FFD08A", err="#F85149", err_bg="#3A1F1F",
+ skeleton="#2C3E36")
+
+OUT = os.path.join(os.path.dirname(os.path.abspath(__file__)))
+
+
+def esc(s):
+ return (s.replace("&", "&").replace("<", "<").replace(">", ">"))
+
+
+def rect(x, y, w, h, fill, r=0, stroke=None, sw=1, dash=None):
+ s = f'"
+
+
+def line(x1, y1, x2, y2, color, sw=1, dash=None):
+ s = f'"
+
+
+def text(x, y, s, size=14, color="#000", anchor="start", weight=400, family=None, opacity=None):
+ extra = f' font-family="{family}"' if family else ""
+ extra += f' font-weight="{weight}"'
+ if opacity is not None:
+ extra += f' opacity="{opacity}"'
+ return (f'{esc(s)}')
+
+
+def button(x, y, w, h, label, p, kind="primary", size=14):
+ out = []
+ if kind == "primary":
+ out.append(rect(x, y, w, h, p["primary"], 8))
+ out.append(text(x + w / 2, y + h / 2 + 5, label, size, p["on_primary"], "middle", 500))
+ elif kind == "outlined":
+ out.append(rect(x, y, w, h, p["surface"], 8, p["primary"], 1))
+ out.append(text(x + w / 2, y + h / 2 + 5, label, size, p["primary"], "middle", 500))
+ elif kind == "text":
+ out.append(text(x + w / 2, y + h / 2 + 5, label, size, p["primary"], "middle", 500))
+ return out
+
+
+def status_bar(p, y=0):
+ out = [text(PAD + 4, y + 19, "9:41", 11, p["text"], weight=500)]
+ out.append(rect(W - 58, y + 13, 12, 9, p["sec"], 1))
+ out.append(rect(W - 44, y + 16, 8, 6, p["sec"], 1))
+ out.append(rect(W - 33, y + 12, 15, 10, "none", 2, p["sec"], 1))
+ out.append(rect(W - 31, y + 14, 11, 6, p["sec"], 1))
+ return out
+
+
+def header(p, title, back=None, action=None):
+ """页头:标题 22sp;可带左侧返回与右侧唯一动作。"""
+ out = []
+ x = PAD
+ if back:
+ out.append(text(PAD, 62, back, 14, p["primary"]))
+ x = PAD + 56
+ out.append(text(x, 64, title, 22, p["text"]))
+ if action:
+ out.append(text(W - PAD, 62, action, 14, p["primary"], "end"))
+ return out
+
+
+# ---------------------------------------------------------------- 任务页
+
+TASKS = [
+ ("LLM 模型部署实践", "vLLM 与 PagedAttention 的部署实验", "3.75"),
+ ("k8s 的使用", "把 LPT 系统迁移到 k8s 中", "3.15"),
+ ("功能测试", "复习功能的测试学习任务", "2.45"),
+ ("Whisper 模型学习与应用", "数据集、微调与领域模型", "2.35"),
+ ("网络通讯加密与应用", "TLS 握手与证书链排查", "2.10"),
+]
+
+
+def screen_tasks(p, with_search=True):
+ out = header(p, "学习任务", action="设置")
+ # 进行中会话:独立成块,整块可点,不带箭头
+ out.append(rect(PAD, 88, W - 2 * PAD, 64, p["accent"], 12))
+ out.append(text(PAD + 16, 113, "有一次学习正在进行", 14, p["text"]))
+ out.append(text(PAD + 16, 133, "LLM 模型部署实践 · 已学 12:30", 12, p["sec"]))
+ out.append(text(W - PAD - 16, 117, "回到会话", 14, p["primary"], "end", 500))
+ y = 168
+ if with_search:
+ out.append(rect(PAD, y, W - 2 * PAD, 40, p["inset"], 8))
+ out.append(f'')
+ out.append(line(PAD + 28.5, y + 24.5, PAD + 32, y + 28, p["sec"], 1.5))
+ out.append(text(PAD + 42, y + 25, "搜索任务名称或描述", 14, p["sec"]))
+ y += 56
+ for name, desc, prio in TASKS:
+ out.append(rect(PAD, y, W - 2 * PAD, 104, p["surface"], 8, p["border"], 1))
+ out.append(text(PAD + 16, y + 28, name, 14, p["text"]))
+ out.append(text(PAD + 16, y + 50, desc, 12, p["sec"]))
+ out.append(text(PAD + 16, y + 86, f"优先级 {prio}", 12, p["sec"], family=MONO))
+ out.append(text(PAD + 216, y + 86, "报告", 12, p["sec"]))
+ out.append(text(W - PAD - 16, y + 86, "开始学习", 14, p["primary"], "end", 500))
+ y += 120
+ return out
+
+
+def screen_tasks_empty(p):
+ out = header(p, "学习任务", action="设置")
+ out.append(text(W / 2, 392, "还没有学习任务", 14, p["text"], "middle"))
+ out.append(text(W / 2, 416, "任务在网页端新建,建好后回来刷新", 12, p["sec"], "middle"))
+ out.extend(button(W / 2 - 60, 440, 120, 40, "刷新列表", p, "outlined"))
+ return out
+
+
+def screen_tasks_loading(p):
+ out = header(p, "学习任务", action="设置")
+ y = 96
+ for i in range(3):
+ out.append(rect(PAD, y, W - 2 * PAD, 104, p["inset"], 8))
+ out.append(rect(PAD + 16, y + 20, 140, 12, p["skeleton"], 4))
+ out.append(rect(PAD + 16, y + 44, 220, 10, p["skeleton"], 4))
+ out.append(rect(PAD + 16, y + 76, 72, 10, p["skeleton"], 4))
+ y += 120
+ return out
+
+
+def screen_tasks_error(p):
+ out = header(p, "学习任务", action="设置")
+ out.append(rect(PAD, 196, W - 2 * PAD, 152, p["surface"], 12, p["border"], 1))
+ out.append(text(PAD + 16, 232, "任务列表没加载出来", 14, p["text"]))
+ out.append(text(PAD + 16, 258, "网络断开,或服务器没有响应", 12, p["err"]))
+ out.append(text(PAD + 16, 282, "恢复网络后重新加载,列表不会丢", 12, p["sec"]))
+ out.extend(button(PAD + 16, 296, 120, 40, "重新加载", p, "outlined"))
+ return out
+
+
+# ---------------------------------------------------------------- 会话页
+
+def screen_session(p, mode="ongoing"):
+ # 会话页顶栏不放「学习会话」这种复述性页标题:任务是逐屏变化的,任务名就是标题
+ out = [text(PAD, 62, "‹ 任务", 14, p["primary"])]
+ out.append(text(PAD + 56, 54, "LLM 模型部署实践", 16, p["text"]))
+ out.append(text(PAD + 56, 74, "S-20261119-01", 12, p["sec"]))
+ y = 96
+ if mode == "paused":
+ out.append(rect(PAD, y, W - 2 * PAD, 44, p["warn_bg"], 8))
+ out.append(text(PAD + 16, y + 27, "已暂停,继续后接着计时", 12, p["warn"]))
+ y += 56
+ elif mode == "due":
+ out.append(rect(PAD, y, W - 2 * PAD, 60, p["warn_bg"], 8))
+ out.append(text(PAD + 16, y + 25, "本轮时间已到,先暂停休息", 12, p["warn"]))
+ out.append(text(PAD + 16, y + 44, "会话不会自己结束", 12, p["warn"]))
+ y += 72
+ out.append(rect(PAD, y, W - 2 * PAD, 152, p["surface"], 12))
+ countdown = "00:00" if mode == "due" else "12:34"
+ out.append(text(W / 2, y + 34, f"本轮还剩 {countdown}", 14,
+ p["warn"] if mode == "due" else p["sec"], "middle"))
+ out.append(text(W / 2, y + 92, "25:30", 44, p["sec"] if mode == "paused" else p["primary"],
+ "middle", 700, MONO))
+ out.append(text(W / 2, y + 120, "有效学习时间", 12, p["sec"], "middle"))
+ y += 168
+ out.extend(button(PAD, y, W - 2 * PAD, 48, "继续" if mode == "paused" else "暂停", p, "primary"))
+ y += 56
+ out.extend(button(PAD, y, W - 2 * PAD, 48, "结束学习", p, "outlined"))
+ y += 56
+ out.append(text(W / 2, y + 16, "显示悬浮窗", 14, p["primary"], "middle"))
+ y += 40
+ # 学习预期
+ out.append(rect(PAD, y, W - 2 * PAD, 112, p["surface"], 12))
+ out.append(text(PAD + 16, y + 28, "学习预期", 14, p["text"]))
+ out.append(text(W - PAD - 16, y + 28, "修改", 12, p["primary"], "end"))
+ out.append(text(PAD + 16, y + 54, "理解 vLLM 的 PagedAttention 与连续批处理,", 12, p["sec"]))
+ out.append(text(PAD + 16, y + 74, "并跑通一次并发压测", 12, p["sec"]))
+ y += 128
+ # 知识碎片
+ out.append(rect(PAD, y, W - 2 * PAD, 176 if mode != "ongoing" else 208, p["surface"], 12))
+ out.append(text(PAD + 16, y + 28, "知识碎片(3)" if mode == "ongoing" else "知识碎片(2)",
+ 14, p["text"]))
+ out.append(rect(PAD + 16, y + 40, 232, 40, p["inset"], 8))
+ out.append(text(PAD + 30, y + 65, "记一条…", 14, p["sec"]))
+ out.append(text(W - PAD - 16, y + 65, "记录", 14, p["primary"], "end", 500))
+ out.append(text(PAD + 16, y + 108, "1.", 12, p["sec"]))
+ out.append(text(PAD + 34, y + 108, "PagedAttention 把 KV cache 按页切", 14, p["text"]))
+ out.append(text(PAD + 16, y + 134, "2.", 12, p["sec"]))
+ out.append(text(PAD + 34, y + 134, "连续批处理提升吞吐,延迟换吞吐", 14, p["text"]))
+ if mode == "ongoing":
+ out.append(text(PAD + 16, y + 160, "3.", 12, p["sec"]))
+ out.append(text(PAD + 34, y + 160, "抢占会让请求重算,代价是解码时间", 14, p["text"]))
+ if mode == "ongoing":
+ out.append(text(W / 2, y + 178, "查看全部 3 条", 12, p["primary"], "middle"))
+ return out
+
+
+# ---------------------------------------------------------------- 报告页
+
+def screen_reports(p, expanded=False):
+ out = header(p, "学习报告", back="‹ 任务")
+ out.append(text(PAD + 56, 82, "LLM 模型部署实践", 12, p["sec"]))
+ y = 96
+ out.append(rect(PAD, y, W - 2 * PAD, 132, p["surface"], 8, p["border"], 1))
+ out.append(text(PAD + 16, y + 26, "S-20261114-03", 12, p["sec"]))
+ out.append(text(W - PAD - 16, y + 26, "11-14 21:30", 12, p["sec"], "end", family=MONO))
+ out.append(text(PAD + 16, y + 54, "把 PagedAttention 与连续批处理跑通,", 14, p["text"]))
+ out.append(text(PAD + 16, y + 74, "对比了两种并发配置的吞吐", 14, p["text"]))
+ out.append(text(PAD + 16, y + 106, "展开全文", 12, p["primary"]))
+ out.append(text(PAD + 88, y + 106, "查看本次碎片", 12, p["sec"]))
+ y += 148
+ h = 300 if expanded else 132
+ out.append(rect(PAD, y, W - 2 * PAD, h, p["surface"], 8, p["border"], 1))
+ out.append(text(PAD + 16, y + 26, "S-20261113-02", 12, p["sec"]))
+ out.append(text(W - PAD - 16, y + 26, "11-13 20:10", 12, p["sec"], "end", family=MONO))
+ out.append(text(PAD + 16, y + 54, "复习了 vLLM 的调度器源码,", 14, p["text"]))
+ out.append(text(PAD + 16, y + 74, "补了 3 条碎片", 14, p["text"]))
+ if expanded:
+ out.append(text(PAD + 16, y + 110, "本次预期", 12, p["sec"]))
+ out.append(text(PAD + 16, y + 132, "看懂调度器怎么决定这一批跑哪些请求", 14, p["text"]))
+ out.append(text(PAD + 16, y + 166, "预期达成判断", 12, p["sec"]))
+ out.append(text(PAD + 16, y + 188, "部分达成:调度策略看懂了,抢占逻辑还没", 14, p["text"]))
+ out.append(text(PAD + 16, y + 222, "自由总结", 12, p["sec"]))
+ out.append(text(PAD + 16, y + 244, "下次从抢占与重算那条路径接着看", 14, p["text"]))
+ out.append(text(PAD + 16, y + 276, "收起全文", 12, p["primary"]))
+ else:
+ out.append(text(PAD + 16, y + 106, "展开全文", 12, p["primary"]))
+ out.append(text(PAD + 88, y + 106, "查看本次碎片", 12, p["sec"]))
+ y += h + 16
+ out.append(text(W / 2, y + 20, "加载更多(3/12)", 12, p["primary"], "middle"))
+ return out
+
+
+# ---------------------------------------------------------------- 设置页 / 权限引导
+
+def permission_rows(p, y):
+ """一行一条权限:左边「是什么 + 为什么」,右边「现在什么状态 + 怎么开」。"""
+ out = []
+ rows = [
+ ("悬浮窗权限", "在其他应用之上显示计时浮窗", "已授权", True),
+ ("通知权限", "前台服务要有一条常驻通知", "未授权", False),
+ ("电池优化白名单", "长时间学习时不被系统冻结计时", "未授权", False),
+ ]
+ for name, why, state, granted in rows:
+ out.append(text(PAD + 16, y + 26, name, 14, p["text"]))
+ out.append(text(PAD + 16, y + 48, why, 12, p["sec"]))
+ out.append(text(W - PAD - 16, y + 26, state, 12,
+ p["primary"] if granted else p["err"], "end"))
+ if not granted:
+ out.append(text(W - PAD - 16, y + 49, "去开启", 12, p["primary"], "end"))
+ y += 64
+ return out
+
+
+def screen_settings(p):
+ out = header(p, "设置", back="‹ 任务")
+ y = 96
+ out.append(rect(PAD, y, W - 2 * PAD, 232, p["surface"], 12))
+ out.append(text(PAD + 16, y + 28, "权限", 14, p["text"]))
+ out.extend(permission_rows(p, y + 44))
+ y += 248
+ out.append(rect(PAD, y, W - 2 * PAD, 56, p["surface"], 12))
+ out.append(text(PAD + 16, y + 34, "小米 / MIUI 额外设置", 14, p["text"]))
+ out.append(text(W - PAD - 16, y + 34, "展开", 12, p["primary"], "end"))
+ y += 72
+ out.append(rect(PAD, y, W - 2 * PAD, 112, p["surface"], 12))
+ out.append(text(PAD + 16, y + 28, "服务器地址", 14, p["text"]))
+ out.append(text(W - PAD - 16, y + 28, "修改", 12, p["primary"], "end"))
+ out.append(text(PAD + 16, y + 56, "https://lpt-dev.cat-shark.xyz/api", 12, p["sec"], family=MONO))
+ out.append(text(PAD + 16, y + 82, "换环境时改这里,改完重新登录", 12, p["sec"]))
+ y += 136
+ out.append(text(W / 2, y + 24, "退出登录", 14, p["err"], "middle"))
+ return out
+
+
+def screen_permissions_gate(p):
+ out = header(p, "权限与后台", back="‹ 任务", action="稍后")
+ y = 96
+ out.append(rect(PAD, y, W - 2 * PAD, 232, p["surface"], 12))
+ out.append(text(PAD + 16, y + 28, "能不能跨应用计时,取决于这三项", 14, p["text"]))
+ out.extend(permission_rows(p, y + 44))
+ y += 248
+ out.append(rect(PAD, y, W - 2 * PAD, 88, p["surface"], 12))
+ out.append(text(PAD + 16, y + 26, "小米 / MIUI 额外设置", 14, p["text"]))
+ out.append(text(PAD + 16, y + 50, "自启动、后台弹出界面、省电策略无限制", 12, p["sec"]))
+ out.append(text(W - PAD - 16, y + 26, "展开", 12, p["primary"], "end"))
+ out.extend(button(PAD, H - 88, W - 2 * PAD, 48, "已完成,去学习任务", p, "primary"))
+ return out
+
+
+# ---------------------------------------------------------------- 登录页
+
+def screen_login(p):
+ out = []
+ out.append(text(PAD + 8, 268, "LPT 学习", 28, p["text"]))
+ for label, value, y in (("账号", "admin", 312), ("密码", "••••••••••", 384)):
+ out.append(rect(PAD + 8, y, W - 2 * PAD - 16, 56, p["surface"], 8, p["border"], 1))
+ out.append(text(PAD + 24, y + 22, label, 12, p["sec"]))
+ out.append(text(PAD + 24, y + 43, value, 14, p["text"]))
+ out.extend(button(PAD + 8, 464, W - 2 * PAD - 16, 48, "登录", p, "primary"))
+ out.append(text(W / 2, 544, "修改 API 地址", 14, p["primary"], "middle"))
+ return out
+
+
+# ---------------------------------------------------------------- 组装
+
+def compose(frames, dark_border=False):
+ n = len(frames)
+ width = W * n + GUTTER * (n - 1)
+ parts = [f'")
+ return "\n".join(parts)
+
+
+FILES = {
+ "tasks.svg": [(False, screen_tasks)],
+ "tasks-dark.svg": [(True, screen_tasks)],
+ "tasks-states.svg": [(False, screen_tasks_empty), (False, screen_tasks_loading),
+ (False, screen_tasks_error)],
+ "session.svg": [(False, screen_session)],
+ "session-states.svg": [(False, lambda p: screen_session(p, "paused")),
+ (False, lambda p: screen_session(p, "due"))],
+ "reports.svg": [(False, screen_reports),
+ (False, lambda p: screen_reports(p, expanded=True))],
+ "settings.svg": [(False, screen_settings), (False, screen_permissions_gate)],
+ "login.svg": [(False, screen_login)],
+}
+
+if __name__ == "__main__":
+ for name, frames in FILES.items():
+ svg = compose(frames)
+ with open(os.path.join(OUT, name), "w", encoding="utf-8") as f:
+ f.write(svg + "\n")
+ print(f"wrote {name} ({len(frames)} frame(s), {len(svg)} bytes)")
diff --git a/docs/diagrams/android-ui/index.html b/docs/diagrams/android-ui/index.html
new file mode 100644
index 0000000..df9573c
--- /dev/null
+++ b/docs/diagrams/android-ui/index.html
@@ -0,0 +1,171 @@
+
+
+
+
+ lpt-android 页面重构 · 目标态线框
+
+
+
+
+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 / #111A16 | 5.60:1 / 10.47:1 |
+ | 强调块(进行中会话) | #EEF9F3 + #237556 字 | #17332A + #7FD8B4 | 5.19:1 / 8.02:1 |
+ | 次要文字(时间戳、说明) | #4B6156 | #B3C7BD | 6.40:1 / 9.99:1 |
+ | 到时 / 暂停提醒条 | #FFF8E1 + #856404 | #3A3220 + #FFD08A | 5.17:1 / 11.00:1 |
+ | 错误 | #B62324(底 #FDECEA) | #F85149 | 5.64:1 / 5.29:1 |
+ | 列表条目 1dp 分组描边 | #C6D6CD | #33453D | 1.5:1,只做分隔,不用它表达状态 |
+ | 图标 / 需要识别的强描边 | #6B7F75 | 同色系提亮 | 4.27:1 |
+
+间距与字号
+
+ | 项 | 取值 | 用在哪 |
+ | 间距五档 | 4 / 8 / 12 / 16 / 24 | 条目内相邻行 8;条目内 12;条目之间、区块之间 16;页面大块之间 24 |
+ | 屏幕边距 | 16 | 登录页 24 保留为已登记例外 |
+ | 字号六档 | 28 / 22 / 16 / 14 / 12 / 44 | 44 只给会话页大计时(唯一自造字号,等宽 + 粗体) |
+ | 圆角三档 | 8 / 12 / 18 | 条目 8、区块 12、浮窗拉起的输入页 18(已登记例外) |
+
+
+三、页面
+
+任务页 顶栏只留一个动作条目与区块分家
+
+
+
+ 留:页面标题「学习任务」,右上只一个「设置」;进行中会话独立成块(整块可点,不带箭头);搜索框(任务 ≥6 个才出现,40dp 高、浅底无描边);任务条目。
+ 删:「已登录:admin」、「共 8 个任务」、「刷新」「权限」「退出登录」四个顶栏/次级按钮、「开始学习 ›」的箭头。
+ 主操作:每行右下唯一绿色「开始学习」;「报告」降为 #4B6156 次要色,不与主操作抢。
+ 取值:条目 8dp 圆角 + 1dp #C6D6CD,内边距 12;任务名 14、描述与优先级 12(优先级用等宽数字);条目间 16。
+
+
+
+任务页三态 空 / 加载 / 错误分开
+
+
+
+ 空:一句事实 + 一句「任务在网页端新建」+ 一个「刷新列表」。
+ 加载:三条骨架块,不用居中大转圈(列表位置不跳)。
+ 错误:标题「任务列表没加载出来」+ 原因「网络断开,或服务器没有响应」+ 一句「恢复网络后重新加载,列表不会丢」+「重新加载」。错误不再和空态共用一条文案。
+
+
+
+会话页 一屏只有一个大计时
+
+
+
+ 留:顶栏用任务名当标题(会话号 12sp 在下面);倒计时一行小字 + 44sp 等宽大计时 + 「有效学习时间」;「暂停」实底、「结束学习」描边、两行分开;「显示悬浮窗」文字入口;学习预期已填就显示文本 +「修改」;知识碎片输入 + 最近 3 条 +「查看全部」。
+ 删:「状态:进行中」、「已暂停 · 有效学习时间」前缀、页面底部「正在与服务器同步…」、「误操作结束(零数据 / 已产生碎片,不可用)」这一长串——改成页面最底一行「误操作结束」,点开才是确认弹窗。
+ 主操作:「暂停」/「继续」独占一行;「结束学习」是描边次级,不与主操作并排同权重。
+
+
+
+会话页两个非常态 状态靠形态
+
+
+
+ 暂停:顶部一条 #FFF8E1 提醒「已暂停,继续后接着计时」,大计时降到 #4B6156,按钮变「继续」。不写「(暂停中)」这类小眉标。
+ 到点:提醒条写「本轮时间已到,先暂停休息 / 会话不会自己结束」,倒计时 00:00 用提醒色,按钮仍是「暂停」——会话不会自己结束。
+
+
+
+报告页 结论先行
+
+
+
+ 留:顶栏「学习报告」+ 任务名;每条只露「日期 + 会话号 + 会话摘要」,「展开全文」才露出本次预期 / 预期达成判断 / 自由总结;「查看本次碎片」保留(降为次要色);底部「加载更多(3/12)」。
+ 删:每条重复的「学习报告」标题(一屏三次同字)、章节标签的绿色、11sp 时间戳。
+
+
+
+设置页 权限并进来
+
+
+
+ 留:权限三条(标题 + 为什么 + 右侧状态,未授权时多一个「去开启」);小米 / MIUI 额外设置(收起成一行,展开才是说明);服务器地址(当前值 +「修改」);最底「退出登录」。
+ 首启引导(右图):同一套权限行,换一句标题「能不能跨应用计时,取决于这三项」,底部主操作「已完成,去学习任务」,右上「稍后」。不再写页面级说明段——理由挪进每条的说明行。
+ 删:任务页顶栏的「权限」「退出登录」,以及原来权限页与设置页各写一遍的重复文案。
+
+
+
+登录页 去自述
+
+
+
+ 留:「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。
+
+
+
diff --git a/docs/diagrams/android-ui/login.svg b/docs/diagrams/android-ui/login.svg
new file mode 100644
index 0000000..f3f2bf0
--- /dev/null
+++ b/docs/diagrams/android-ui/login.svg
@@ -0,0 +1,24 @@
+
diff --git a/docs/diagrams/android-ui/reports.svg b/docs/diagrams/android-ui/reports.svg
new file mode 100644
index 0000000..e14cfdc
--- /dev/null
+++ b/docs/diagrams/android-ui/reports.svg
@@ -0,0 +1,66 @@
+
diff --git a/docs/diagrams/android-ui/session-states.svg b/docs/diagrams/android-ui/session-states.svg
new file mode 100644
index 0000000..149659d
--- /dev/null
+++ b/docs/diagrams/android-ui/session-states.svg
@@ -0,0 +1,82 @@
+
diff --git a/docs/diagrams/android-ui/session.svg b/docs/diagrams/android-ui/session.svg
new file mode 100644
index 0000000..a921f09
--- /dev/null
+++ b/docs/diagrams/android-ui/session.svg
@@ -0,0 +1,43 @@
+
diff --git a/docs/diagrams/android-ui/settings.svg b/docs/diagrams/android-ui/settings.svg
new file mode 100644
index 0000000..5e4fcc2
--- /dev/null
+++ b/docs/diagrams/android-ui/settings.svg
@@ -0,0 +1,71 @@
+
diff --git a/docs/diagrams/android-ui/tasks-dark.svg b/docs/diagrams/android-ui/tasks-dark.svg
new file mode 100644
index 0000000..3e8263b
--- /dev/null
+++ b/docs/diagrams/android-ui/tasks-dark.svg
@@ -0,0 +1,54 @@
+
diff --git a/docs/diagrams/android-ui/tasks-states.svg b/docs/diagrams/android-ui/tasks-states.svg
new file mode 100644
index 0000000..36076e0
--- /dev/null
+++ b/docs/diagrams/android-ui/tasks-states.svg
@@ -0,0 +1,64 @@
+
diff --git a/docs/diagrams/android-ui/tasks.svg b/docs/diagrams/android-ui/tasks.svg
new file mode 100644
index 0000000..d41d9c2
--- /dev/null
+++ b/docs/diagrams/android-ui/tasks.svg
@@ -0,0 +1,54 @@
+
diff --git a/docs/diagrams/index.html b/docs/diagrams/index.html
index e660cc2..facf421 100644
--- a/docs/diagrams/index.html
+++ b/docs/diagrams/index.html
@@ -21,6 +21,18 @@
本地预览:在 docs/diagrams 目录执行 python3 -m http.server 8000,再访问
http://localhost:8000/<主题>/index.html。