MyPad 开发记录(八):让自己愿意打开它——界面、交互与双主题
本文回顾 2026 年 11 月 8—16 日的界面整改与双主题交付,按 v0.4.0 THEME 最终验收日期归档,整理于 2026 年 11 月 16 日。依据源码与既有验证记录复盘,没有在写作时重新部署或操作个人数据。
MyPad 第一轮建设结束时,数据与状态首页已经有了比较明确的边界,界面却还留下不少影响使用的细节。
有些文字很小,有些页面滚不到底部,状态指标的白色卡片与原来的深色终端风格脱节。地图、图表和表单在窄窗口里,也并没有因为页面能打开就自然变得可用。
我仍然喜欢复古显示屏的视觉方向,后来又希望增加一种工业赛博终端风格。这一轮因此分成两步:先整理实际阅读和操作问题,再把两套外观放进同一个应用。
风格落到每天使用,会遇到很具体的问题
11 月 8 日的 UI 核查覆盖七个主页面和表单。找到的问题大多很普通,却直接决定一页内容能否被读到。
位置 | 发现的问题 | 调整方向 |
首页 | 日期、样本和技术说明堆在一起 | 分清主要数值、比较、质量与可展开资料 |
健康页 | 质量日格配着旧步数高低图例 | 图例改为可用、待核、无记录,与数据含义一致 |
年表 | 隐藏旧轨道后仍留下多余网格 | 按真实内容重新排布,限定空态说明的时间范围 |
足迹 | 直接露出英文状态码,窄屏信息难以到达 | 使用中文质量说明,保留完整日期和滚动路径 |
收藏、资产 | 对话框焦点与短窗口滚动不完整 | 统一关闭、Escape、焦点返回与底部按钮可达性 |
还有一些修改并不涉及布局:无资产快照时显示“—”,不再用配置 0% 暗示已经记录了资产;去掉“越低越好”之类判断,保持与状态指标一致的中性表达。
这些调整的前提是保留原有数据含义。缺失不能因为卡片需要一个值就变成零,GPS 仍然写估算,步数仍然是范围。
先把阅读做稳,再保留喜欢的外观
原来的扫描线、暗角、闪烁和细小等宽字能够营造终端感,也可能干扰正文阅读。这轮减少了持续动效,让普通文字、数字与装饰承担不同职责。
中文正文优先可读,数字保留等宽显示;次要文字提高对比,焦点与选中态不依赖闪烁。窄屏不能只把侧栏隐藏掉,里面的内容还需要另一个可到达的位置。
响应式检查也不能只看有没有横向滚动条。健康图是否测到了真实容器尺寸、地图是否吞掉整页滚轮、极短窗口中的表单按钮能否聚焦,都需要按实际动作检查。
这一阶段由 Work 直接实施展示层整改并自检,不应写成 DSH 实现后再由 Work 独立验收。AI 的实际分工在不同阶段确实发生过变化。
第二套主题,共用一套内容与操作
双主题保留原来的复古显示屏,新增工业赛博终端。后一套采用更明确的工业字形、黄黑标识、青色数字、切角控件和结构边框;地图也参考了我提出的赛博朋克视觉方向。
这里没有加入游戏资产,也没有为地图补造街道、建筑或任务标记。项目已有的地理数据能够表达什么,外观就围绕这些内容展开。
切换主题不刷新整个应用,不切换数据,也不重新挂载整页。当前页面、日期、年份、指标窗口和未保存输入继续留在各自状态里。顶部和弹窗中的按钮都连接到同一个主题状态。
这让一个看似简单的颜色开关,变成了需要跨 HTML、SVG、Canvas 和地图共同处理的变化。
首次画面与运行中的切换,共用一套偏好规则
应用把主题限定为
retro 和 cyber。首次打开时,阻塞式 bootstrap 在第一帧前读取偏好并设置根元素属性;React 运行后继续订阅同一个状态源。下面是按实际逻辑缩短的示例,省略订阅、按钮和滚动保留部分:
React 部分通过
useSyncExternalStore 读取主题快照并订阅变化。首次绘制与运行时没有各自维护一份不同的白名单,也没有为了主题记忆清空其他本地偏好。存储读取失败、非法主题值和写入失败都需要处理。不过,主题开关在禁用存储时仍可用,不代表整个应用的旧历史区域也已经完全支持这种环境。那里的既有错误继续作为限制保留。
CSS 变量不会替所有画面自动换色
普通网页元素可以通过共享变量切换颜色,其他绘制路径还要单独接上。
绘制方式 | 本轮处理 |
HTML/CSS | 共享颜色、字体、控件与状态变量 |
SVG | 用主题画笔替代固定颜色 |
Canvas | 读取解析后的颜色值,重画已有图层 |
Leaflet | 更新既有地理层与轨迹样式,保持视野和点集 |
地图不能每切一次主题就多加一层,Canvas 也不能只改外部 CSS 却留下旧画笔。检查因此同时看颜色是否变化、数据和图层是否保持、有没有新增业务请求。
滚动也有类似问题。主题改变字体与几何尺寸后,浏览器可能把原滚动位置夹到更短的范围里。实现保留目标位置,在切回时尝试恢复;用户主动滚动后,又要以新的选择为准。
这些行为最终都要放回真实操作中检查:开表单、输入虚构但未提交的内容、切主题、关闭、返回,再看日期与窗口选择是否仍在。
预览、部署与源码封存分别验收
主题实现先在隔离副本中推进。预览拒绝写请求,不把查看个人数据的过程顺手变成保存测试。正式部署则生成相应候选,核对产物后更新静态文件,保留旧资源,最后替换入口。
11 月 12 日的 G2 完成前端部署与本人体验验收。11 月 16 日的 G3 再处理源码同步、分组提交、标签与证据索引。G3 没有再次部署、重启后端或重算数据。
源码原本还混有其他维护,因而不能把整个工作区一起作为主题提交。最终封存包含可证明的既有 UI、前端维护与主题源码;尚未部署的后端和指标维护继续留在标签外。
这也解释了为什么测试数量不能混用:早期含未部署维护的候选树有 140 项 Python 测试,最终标签对应的独立源码树复核是 131 项 Python、32 项 Node 与 lint 通过。前后测试对象不同,不能把更大的数字拿来装饰正式版本。
可以收尾,仍然保留限制
v0.4.0 THEME 已完成最终验收,标签为
v0.4.0-themes,目标提交是 885e493。这是本次前端主题需求的收尾,不意味着全栈重新部署或所有已知问题都解决了。地图首次缩放时快速切页的既有异常、完全禁用存储时旧历史区域的错误、跨系统字体差异,以及真实保存、上传、删除和全部实体设备未覆盖的部分,都仍保留在记录里。
这轮带给我的直接结果,是可以继续使用原来的复古风格,也能切到另一套喜欢的外观,而不用重新选择日期、丢掉表单输入或改变看到的数据。接下来适合正常使用,等具体问题出现时再处理,而不是因为主题完成又立即扩出一个新的界面项目。
资料
本文依据项目源码和已有 UI、G1、G2、G3 记录整理。没有使用未经公开检查的项目截图,也没有将主题验证画面当作真实财务或全部设备验收的证据。
MyPad 系列
作者:KuAcha
声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。
Previous
MyPad 开发记录(九):我和 AI 怎样推进这个个人项目
Next
MyPad 开发记录(七):从数字到近期状态