#!/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)")