- 页面交付清单 (已累计完成 9/11 个页面): 1. 语言设置 (已完工) 2. 版型切换 (已完工) 3. 心率区间设置 (已完工) 4. 自动连接配置 (已完工) 5. 手环配置 (已完工) 6. DFU固件升级 (已完工) 7. 用户管理 (已完工) 8. 设备数据库管理 (已完工) 9. 数据上传 (本次交付·已完工) - 核心重构亮点: 1. 采纳 Master-Detail Inset Station 经典双栏比例 (360px 1fr); 2. 彻底消除点击误导,左侧重构为【自动上传数据】标准开关行与只读【上传通道监控】大盘; 3. 【测试数据上传】迁移至右侧表单底部实现 100% 贯穿式排版,且支持输入完整性动态校验点亮; 4. 完善点击测试联动,实时回显 200 OK 连通状态、响应时延与最近测试时间戳; 5. 集齐 6 件套交付物 (baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD 任务卡, README 更新)。
📱 核心 UI 翻新与重构体系 (UITask 原型车间)
⚠️ 智能体请注意 (Agent Prompt & Protocol): 如果您被唤醒并要求接手本目录的 UI 任务,请不要一上来就盲目生成代码! 您必须充当“UI 架构师”的角色,严格按照以下的 “一步一答 (Step-by-Step) 交互式协议” 引导人类用户完成工作流。您的最终目标是集齐 6 件标准物料。
🗂️ 零、开工前必读:本仓库的真实资产现状
⛔ 严禁凭空假设文件名。 请务必先 ls 目录看清楚再动手。本仓库有两条必须记牢的命名铁律:
| # | 铁律 | 说明 |
|---|---|---|
| 1 | 原图 = Screenshot*.png |
从安卓设备导出的原机截屏,保持出厂文件名。仓库里不存在 actual_ui.png,那是历史文档的错误约定。 |
| 2 | 效果图 = image.png |
方案定稿后,由人类亲自截图并命名为 image.png 放进页面目录。不存在 target_style.png / final_effect.png,这两个名字同样是历史遗留,已作废。 |
当前仓库的四类目录
| 目录 | 性质 | 说明 |
|---|---|---|
设置页面UI优化/<页面名>/ |
主工作台 | 11 个页面子目录,完工形态为 6 件物料(见下)。 |
.preview/<模块英文名>/ |
候选渲染稿暂存区 | 竞标阶段的多版 HTML 草稿存放地,已纳入版本管理留痕,但绝不进入页面目录。 |
<界面名>-<YYYYMMDD>/ |
早期工作台(旧形态) | 例:系统设置界面-20260816/,一个目录打包多屏,新任务不再采用此形态。 |
ui_baseline/EAPManageUI/ |
原始截图总仓库 | 全量安卓截屏归档,只读。页面目录里的原图即来源于此。 |
📌 页面清单 · 原图映射 · 完工状态(设置页面UI优化/)
| # | 页面目录 | 原机截屏(唯一原图,只读) | image.png |
状态 |
|---|---|---|---|---|
| 1 | 语言设置/ |
Screenshot_20260812_143341.png |
✅ | 已完工(6 件齐) |
| 2 | 版型切换/ |
Screenshot_20260812_143347.png |
✅ | 已完工(6 件齐) |
| 3 | 心率区间设置/ |
Screenshot_20260817-135129.png |
✅ | 已完工(6 件齐) |
| 4 | 自动连接配置/ |
Screenshot_20260812_143357.png |
✅ | 已完工(6 件齐) |
| 5 | 手环配置/ |
Screenshot_20260812_143405.png |
✅ | 已完工(6 件齐) |
| 6 | DFU固件升级/ |
Screenshot_20260812_143413.png |
✅ | 已完工(6 件齐) |
| 7 | 用户管理/ |
Screenshot_20260812_143424.png |
✅ | 已完工(6 件齐) |
| 8 | 设备数据库管理/ |
Screenshot_20260812_143432.png |
✅ | 已完工(6 件齐) |
| 9 | 数据上传/ |
Screenshot_20260812_143450.png |
✅ | 已完工(6 件齐) |
| 10 | 版本信息/ |
Screenshot_20260812_143456.png |
❌ | 待办 · 有旧基准¹ |
| 11 | Logo授权管理/ |
Screenshot_20260812_143502.png |
❌ | 待办 · 有旧基准¹ |
¹ 旧基准复用:这 3 页(外加已完工的语言设置、版型切换)曾在
系统设置界面-20260816/产出过baseline_ui.html/DESIGN_SPEC.md/implementation_plan.md。接手时必须先读旧物料再动手,不要从零重写,避免与已交付的 Token 基准打架。
⚠️ 命名不统一警告:第 3 项证明截屏文件名没有统一格式(
Screenshot_日期_时间vsScreenshot_日期-时间)。 因此严禁用写死的正则(如Screenshot_\d{8}_\d{6}\.png)去匹配,会漏掉心率区间设置页。 唯一正确做法:列目录取实际文件,见 Step 2 的识别算法。
⛓️💥 已知断链:两份「宪法级」文档目前不在本仓库
系统设置界面-20260816/ 下的卡片与图纸把下面两份文件标为 [必读],但本仓库内并不存在它们(已全库检索确认):
| 被引用的文件 | 声称的作用 | 现状 |
|---|---|---|
UI_DEV_GUIDE.md |
Token 宪法(CSS → Android Token 映射依据) | ❌ 缺失 |
BEAUTIFY_BASELINE_20260816.md |
全局美化公约(字号阶梯、分段控件等) | ❌ 缺失 |
智能体遇到此情况的正确处理:不要卡死在找文件上,也不要假装读过。请主动告知用户:“这两份约束文档不在仓库里,请提供,或确认我按 Material 3 默认规范推进。”
在拿到之前,implementation_plan.md 里的 Token 映射一律标注为待校准,不得声称已对齐宪法。
🎨 全局 AppBar 顶部导航栏统一规范 (AppBar Global Standard)
为确保 11 个设置子页面的顶部导航栏在尺寸、间距、按钮样式上具备 100% 像素级一致性,所有页面的 AppBar 必须严格遵循以下规范:
/* =========================================================================
AppBar 顶部导航栏统一规范 (40dp 纯净透明触控槽 + Hover 微圆底)
========================================================================= */
.appbar {
height: 60px; /* --appbar-height */
display: flex;
align-items: center;
justify-content: space-between;
padding: 0 20px;
border-bottom: 1px solid var(--divider);
background: var(--color-surface);
}
.appbar-left { display: flex; align-items: center; }
/* 返回箭头 (←) 与 更多操作 (⋮) 统一规范 */
.appbar-nav, .appbar-more {
width: 40px;
height: 40px;
border-radius: 50%;
display: inline-flex;
align-items: center;
justify-content: center;
cursor: pointer;
background: transparent; /* 默认纯净透明,严禁生硬方块/灰色边框背景 */
border: none;
transition: all 0.15s ease;
}
.appbar-nav:hover, .appbar-more:hover {
background: rgba(15, 23, 42, 0.06); /* 仅在 Hover/Active 时显现轻量微圆底 */
transform: scale(0.96);
}
.appbar-nav svg, .appbar-more svg {
width: 22px;
height: 22px;
fill: var(--text-main); /* 统一跟随文字主色 */
}
.appbar-title {
font-size: 19px;
font-weight: 700;
margin-left: 10px; /* 统一标题左间距 */
letter-spacing: -0.01em;
}
🎨 全局核心主色蓝统一规范 (Global Primary Blue Standard)
为了彻底消除各页面蓝色色号不一致(如部分页面出现偏紫蓝 #3949AB、深藏青 #1A237E 等杂色)的问题,所有 11 个设置子页面的所有蓝色元素必须 100% 严格统一使用以下唯一的极客科技蓝 Token 体系:
/* =========================================================================
全局核心主色蓝统一规范 (Global Primary Blue Token Standard)
========================================================================= */
:root {
--color-primary: #2563EB; /* 核心主色蓝 (Royal Tech Blue) */
--color-primary-dark: #1D4ED8; /* 深蓝 / Hover 悬停态 */
--color-on-primary-container: #1E40AF; /* 选中深色文字 / 高亮标题 */
--color-primary-light: #EFF6FF; /* 极浅蓝背景 / 选中浅底容器 */
--color-primary-container: #EFF6FF; /* 选中卡片微底 */
--color-primary-border: #DBEAFE; /* 浅蓝边框 (Border / Chip) */
--color-primary-glow: rgba(37, 99, 235, 0.25); /* 蓝色弥散发光与阴影 */
--color-primary-gradient: linear-gradient(135deg, #2563EB 0%, #1D4ED8 100%); /* 渐变主按钮 */
}
🎯 蓝色应用强制约束原则
- 标题与分区卡片名:所有卡片标题、分类标题、模块主文案一律使用
--color-primary(#2563EB); - 选中态组件:
- 单选框 Radio、复选框 Checkbox、滑动开关 Switch 开启态、滑块 Slider 游标与轨道;
- 选中的卡片边框(
border-color: #2563EB)、选中左侧光条(background: #2563EB)、选中底色(background: #EFF6FF);
- 主操作按钮:一律采用
--color-primary或--color-primary-gradient; - 普通强调蓝色文字与标签:如
BLE协议标签、时段读数、选中文本一律采用#2563EB,浅底搭配#EFF6FF。
为了彻底杜绝大屏幕固定像素导致的不适配与留白失衡,所有设置页面实行统一的 自适应动态页边距体系,并按业务类型划分为两大栅格策略:
1. 动态自适应外层页边距体系 (所有页面 100% 统一)
- 外层视口边距:
padding: clamp(16px, 2.5vw, 32px);(上下左右等距呼吸,小屏紧凑、超大屏大气); - 容器最大宽度:
max-width: min(100%, 1160px);(大屏居中,不拉伸变形); - 卡片内边距:
padding: clamp(20px, 2.5vw, 30px);; - 分栏间距 (Gutter):
gap: clamp(16px, 2vw, 24px);; - 主容器圆角:
border-radius: 20px;。
2. 页面类型与双栏比例策略
| 页面类型 | 代表页面 | 核心栅格策略 (Grid Columns) | 说明与设计意图 |
|---|---|---|---|
| A 类:双栏选择型页面 (Dual-Column Selector) |
• 版型切换 • 语言设置 |
统一锁死黄金比例:360px 1fr(左侧 360dp 概览岛屿 + 右侧 1fr 选项卡片) |
占比严格统一,确保同类选择型页面在视觉层级、左右宽度比例上 100% 对齐,不再出现左右忽大忽小的问题。 |
| B 类:高密度复合型页面 (High-Density Multi-Zone) |
• 心率区间设置 • 自动连接配置 |
内容自适应比例: • 心率区间: 1fr 360px (左 5 区间 + 右 HUD)• 自动连接: 430px 1fr (左通道 + 右 Bento) |
按内容空间需求自适应比例,无需刻意统一左右占比,但外层动态边距与 AppBar 必须严格遵循全局规范。 |
🔄 您的交互式工作流 (Step-by-Step Protocol)
当您(新手智能体)被人类协作者唤醒,并收到这张 README 时,请按顺序执行以下步骤。每完成一步,必须停下来等待用户的回复,严禁抢跑:
🌟 AI 能力自检探针 (Capability Check) 在执行 Step 1 前,请 AI 评估自身当前具备哪些具体的 Tool/API 权限,并据此调整策略:
- 文件读写能力:能否在后台静默创建文件/目录并打包 ZIP?(有则静默创建,无则转为纯对话指导模式)
- 图片读取能力:能否读取本地磁盘上的 PNG 并真正“看见”内容?(这是 Step 2 / Step 3 的硬性前提;若不能,必须请人类口述信息槽位)
- 自动截图能力 (Headless Screenshot Pipeline):已配置 Google Chrome Headless 自动截图管线,方案定稿后自动截取
image.png落盘,无需人类手动截图。- 浏览器渲染能力:能否打开本地 HTML 预览?(决定候选稿是您截图呈现,还是给路径让人类自己看)
- 文件访问透明度:人类能否直接在电脑上双击打开你写的文件?(本地 IDE 可以;云端沙盒则需你在聊天框打印 HTML 供其复制)
📁 Step 1: 确定界面归属与建仓 (防覆盖)
- 您的动作:先问用户:“请问本次重构属于哪个界面?”
- 分支判断(关键,别建重复目录):
- 若用户报出的页面已在上方清单中 → 该页面的工作台已经存在,直接进入
设置页面UI优化/<页面名>/就地作业。 ⛔ 严禁为它新建带日期后缀的目录,严禁移动或复制原图。 - 若该页状态已是「已完工」 → 先告知用户“此页 6 件物料已齐”,问清是要修订还是误报页面名,别直接覆盖已交付成果。
- 若是清单之外的全新界面 → 在
设置页面UI优化/下新建<页面名>/,并请人类把原机截屏放进去。
- 若用户报出的页面已在上方清单中 → 该页面的工作台已经存在,直接进入
- 收尾:把您确定的工作台绝对路径回报给用户,等待确认后再进入 Step 2。
📷 Step 2: 精确识别原机截屏 (原图锁定)
- ⛔ 绝对禁令:不许假设文件名是
actual_ui.png;不许重命名、不许移动、不许覆盖原图。原图是唯一的“信息槽位保底凭证”,必须保持出厂文件名以便追溯。 - 识别算法(照做,别猜):
- 列出工作台目录下的全部文件(
ls),不要先入为主地过滤文件名。 - 筛出图片扩展名(
.png/.jpg/.jpeg/.webp)。 - 先把
image.png排除掉——它是效果图,不是原图(详见 Step 3)。 - 在剩下的图片里挑原机截屏:文件名以
Screenshot开头(大小写不敏感,分隔符可能是_也可能是-),或虽不叫这个名字但明显是设备导出的截图。 - 命中 1 张 → 锁定为本页原图,把绝对路径回报给用户确认。
- 命中多张 → 禁止自行拍板。列出全部候选(文件名 + 尺寸 + 修改时间)问用户:“检测到 N 张截屏,请指认哪张是本页的原机截屏?”
- 命中 0 张 → 向用户说明目录里没有原图,请其放入后再继续;同时可去
ui_baseline/EAPManageUI/里按时间戳协助查找。
- 列出工作台目录下的全部文件(
- 读图:锁定后必须真正读取这张 PNG,逐条列出您看到的信息槽位(标题、字段、按钮、开关、状态文案、空状态……),并向用户复述一遍:“我在原图里看到了以下 N 个元素,有没有遗漏?” 这一步是后续“绝不丢字段”验收标准的基线,不做完不许进 Step 3。
🖼️ Step 3: 效果图盘点 —— 有 image.png 就用它,没有就先竞标
📌 本仓库的效果图铁律:定稿的目标效果图固定叫
image.png。 一旦人类用户确认方案定稿后,智能体将通过无头浏览器自动截屏落盘为image.png存入页面目录,集齐 6 件全量标准物料。
先盘点:工作台目录里是否存在 image.png?
✅ 情况 A:已有 image.png(人类已定稿)
- 直接读取它,逐条列出您看到的视觉决策:栅格宽度、卡片密度、圆角、强调色用法、分组方式、控件形态、状态表达……
- 与用户核对:“我从
image.png里读到以下风格特征,理解对吗?” - ⛔ 跳过竞标流程,风格已由人类拍板,您不许再自行发挥或提议换风格。
- 直接带着 原机截屏(信息保底)+
image.png(风格目标) 双基线进入 Step 4。
🎨 情况 B:没有 image.png → 强制进入「渲染图竞标」
不许跳过、不许自己拍脑袋定一个风格就开写。
- 产出至少 3~5 个候选方案:基于 Step 2 读到的信息槽位,写出 3~5 份风格互相有明显区分度的 HTML 渲染稿(不是 3 份换个色号的同一版)。建议维度:卡片密度(紧凑 / 舒展)、分组方式(分区卡片 / 通栏列表)、强调手法(描边 / 填色 / 徽章)、平板宽屏栅格策略等。
- ⛔ 落盘纪律(核心红线):候选稿一律不许写进页面目录,必须放在
.preview/<模块英文名>/下(snake_case 英文名,如language_settings、edition_selection、heart_rate_settings、auto_connect_settings)。 目的:保持页面目录干净(只留 6 件物料),避免十几份废稿污染@coder的交付清单。💡 候选稿保留在
.preview/作为设计决策留痕,不必删除——但它们永远不算物料。 - 呈现给用户:
- 给出每份候选 HTML 的绝对路径,请用户双击打开逐个查看;有渲染能力则可另做一个
preview_bakeoff.html汇总页并排对比。 - 附一份对比说明:每版的取舍点是什么、各自适合什么场景。
- 给出每份候选 HTML 的绝对路径,请用户双击打开逐个查看;有渲染能力则可另做一个
- 等待选择:明确提问“请选择哪一版作为效果图基准,也可以指定‘要 2 号的布局 + 3 号的配色’做混合”。⛔ 用户没回话之前不许进 Step 4。
- 自动定稿截屏落盘(核心升级):用户确认落实后,智能体将中选版本写入
baseline_ui.html,并自动调用 Chrome Headless 截取高清image.png存入页面目录,自动补齐第 6 件物料,免除人类手动截图操作。
💻 Step 4: 编码 HTML 与循环调优 (防死锁)
- 您的动作:以“原机截屏 +
image.png”为双基线,打磨baseline_ui.html,写入页面目录。 - 交互:告诉用户该 HTML 文件的本地绝对路径,让用户双击用浏览器打开。
- 循环:询问用户哪里有问题,反复修改 HTML 直到用户确认满意。
- ⚠️ 防死锁警告:HTML 原型的核心目的是敲定排版结构和颜色 Token。如果您在尝试还原复杂动画或生僻字体时遭遇挫折,请主动放弃像素级的死磕,向用户说明情况并以快速输出图纸为主,切勿陷入无限修改的死循环。
📐 Step 5: 自动生成图纸与资产交付 (终局)
- 您的动作:提取 HTML 里的 CSS 逻辑,生成并保存以下 3 份标准文件:
DESIGN_SPEC.md(视觉边界手册)implementation_plan.md(原生映射图纸)CARD-YYYYMMDD-UITask-<页面名>.md(最终的重构卡片模板)
- ⚠️ 引用图片时的硬性要求:
- 引用原图必须写真实文件名(如
Screenshot_20260812_143341.png),不许写actual_ui.png。 - 引用效果图一律写
image.png,不许写target_style.png/final_effect.png。
- 引用原图必须写真实文件名(如
- 交付自检:确认页面目录下 6 件物料齐全:
Screenshot*.png、image.png、baseline_ui.html、DESIGN_SPEC.md、implementation_plan.md、CARD-*.md。
📦 交付物清单 (6 件标准物料)
第一部分:视觉基线(2 张图)
| # | 物料 | 来源 | 说明 |
|---|---|---|---|
| 1 | 📷 Screenshot*.png |
安卓设备导出 | 原机截屏,保持出厂名、只读。保底凭证,确保原有槽位绝不丢失。⛔ 不要重命名为 actual_ui.png。 |
| 2 | 🖼️ image.png |
无头浏览器自动截屏生成 | 定稿目标效果图,兼任“风格目标”与“定妆照”。由智能体在定稿后自动渲染落盘。 |
第二部分:原型与图纸(4 份文件)
| # | 物料 | 说明 |
|---|---|---|
| 3 | 🌐 baseline_ui.html |
[核心输出] 手写的 HTML/CSS 源代码。所有排版、颜色、状态机的讨论都在此 HTML 上进行。 |
| 4 | 📐 DESIGN_SPEC.md |
纯视觉说明手册(透明度、边界条件、空白状态、截断规则等)。 |
| 5 | 🛠️ implementation_plan.md |
原生 Android 施工图纸。必须含严格的 CSS-to-Android Token 映射字典(绝对禁止 XML 硬编码颜色和尺寸)。 |
| 6 | 📋 CARD-YYYYMMDD-UITask-<页面名>.md |
最终的重构任务卡片。简明标明改动文件,并声明严格遵守 UI_DEV_GUIDE.md。 |
完工目录形态(以已交付的 4 个页面为例):
设置页面UI优化/自动连接配置/ ├── Screenshot_20260812_143357.png # ① 原机截屏(原名保留,只读) ├── image.png # ② 自动渲染的定稿效果图 ├── baseline_ui.html # ③ 核心 HTML 原型 ├── DESIGN_SPEC.md # ④ 视觉边界手册 ├── implementation_plan.md # ⑤ 原生落地图纸 └── CARD-20260817-UITask-自动连接配置.md # ⑥ 重构任务卡片
🛑 行动准则
- 只做设计,不碰原生:您的工作止步于产出这 6 份物料。Android 端的实际修改,由后续的
@coder根据这 6 份物料执行。 - 原图神圣不可侵犯:原机截屏只读。不重命名、不移动、不覆盖、不修图。
- 自动截取
image.png:定稿后智能体通过无头浏览器自动生成image.png,确保 6 件物料一次性齐备。 - 统一 AppBar 视觉标准:所有页面严格采用 40dp 纯净透明触控槽 + Hover 微圆底规范,杜绝大小不一和生硬框线。
- 无
image.png必先竞标:必须先出 3~5 版(上不封顶)渲染图让用户选,候选稿只进.preview/。禁止自己选一版就闷头开写。 - 页面目录只放 6 件物料:候选稿、临时文件、废弃版本一律不进页面目录。
- 文件名以实际磁盘为准:任何时候引用图片,先
ls确认,再写路径。 - Token 宪法:编写
implementation_plan.md时对照UI_DEV_GUIDE.md,把 HTML 里的#FFFFFF映射为?attr/colorSurface,12px映射为@dimen/corner_radius_md。