Files
wxapp_escort/doc/DESIGN.md
T
lik cc3d6b40f3 style(design): 同步阴影边界说明与 tabBar 选中态
app.wxss 注明 --shadow-card 只给需要抬升的主服务面板与 AI 输入面板,普通白卡走描边;
tabBar 选中图标叠 14% 暖橙填充,去色后仍有实心与空心的形态差异(WCAG 1.4.1)。
DESIGN.md 同步 2026-11-14 版字号字重、版式档位、颜色面积与非令牌资源清单。
2026-11-16 19:30:31 +08:00

409 lines
40 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 暖橙陪诊小程序 · 视觉设计规范
适用范围:`ui/wxapp_escort/` 全部页面。本文规定**颜色**(§一至§七)、**字号与适老化**(§八)、**版式档位**(§九)和**清爽界面的组件配方与验收**(§十)。
最近修订:**2026-11-14**。本轮以 `pages/home/index`、`pages/escort/itemorder`、`pages/ai/aichat` 的新界面为参考,保留原暖橙色板,更新颜色面积、线条、面板、阴影和排版规则。其他页面按需渐进迁移,不代表全站已完成新版布局或真机验收。§五为历史记录;若与现行规则冲突,以本次修订的正文及 §十 为准。
---
## 一、总原则
**全站只有一个色相**——暖橙,承载品牌、交互、强调。第二色不是新色相,而是**暖墨文字层**(暖偏棕的深灰),只用来拉开层级,不与暖橙争彩。浅橙三档(描边、浅底、深字)都是主色同色阶。状态色只在**表达状态**时出现,不做装饰。
判断一个颜色能否用:既不是暖橙同色阶、也不是暖墨、也不是明确状态色的,就不该出现。灰金 `#D4A853`、亮橙 `#FF8500`、青灰、翠绿均为违反项。
### 1.1 现行方向:温暖、清爽、有完成度
**纸面承载留白,白面组织内容,细线交代边界,暖橙引导行动。** 清爽来自颜色用量与结构,而不是把所有文字变浅、把所有边框删掉。
- 先建立左对齐、字号、分组和间距,再决定是否需要色块或线条;不要用满屏横线代替信息组织。
- 主要行动明确,辅助入口安静。首屏不同时堆叠预约、客服、培训等同等重量的宣传块。
- 卡片不是越多越精致:同一组内容共享面板;不同用途可用白面、浅橙面和纸面形成层次。
- 不新增渐变、玻璃模糊、彩色辉光和重阴影,不用无意义英文、序号或装饰条填补空白。
- 装饰仅用于主视觉或欢迎区,窄屏时先退让或隐藏;不能遮挡正文或成为唯一的信息载体。
---
## 二、核心色板
令牌集中在 `app.wxss` 的 `page{}` 内,是**全站唯一来源**。页面消费令牌,不复制色板,也不覆盖同名全局颜色令牌。局部组件适配可使用另名语义变量,或将 TDesign 变量映射到现有令牌。
**非令牌资源须同步维护**(清单见 §7.3):WXML 图标 `color`、JSON 导航与 tabBar 配色、内嵌 SVG、着色位图,以及自定义 tabBar 当前保留的硬编码。改主题不能只改全局变量便宣称完成。
**`t-icon` 的 `name` 必须命中 tdesign 图标名表**(`miniprogram_npm/tdesign-miniprogram/icon/icon.wxss` 里的 `.t-icon-{name}`),写错不报错、只是渲染为空:`list` 并不存在(只有 `list-numbered`、`list-bug` 等),`info-circle`、`error-circle`、`user-business`、`chart-bar` 等均存在。
迁移进度:全部页面已删除 `page{}` 里的令牌副本,统一消费 `app.wxss`(2026-11-13 复核:`itemdetail`、`mine/contact` 的旧副本也已清除)。
### 2.1 第一色:暖橙色阶
主色于 2026-10-04 由 `#C2410C`(H18°)折中右移到下表值(H25°)。沿革与回滚见 §七。
| 令牌 | 色值 | 用途 | 对比度 |
|---|---|---|---|
| `--brand-strong` | `#B8520A` | 主按钮、价格数字、选中态、实心强调块 | 纸面 4.66:1,白卡 4.94:1;白字压其上 4.94:1 |
| `--brand-ink` | `#9B4508` | 标签文字、文字链、暖色小标题、图标 | 浅橙底 5.96:1,纸面 6.10:1,白卡 6.46:1 |
| `--brand-line` | `#FFE0C2` | 浅橙块描边、浅橙档的状态描边;`itemlist` 预约按钮软填充(§2.1 例外已登记) | 仅做描边;按钮填充见例外 |
| `--brand-soft` | `#FFF4E8` | 浅橙底:说明砖、图标衬底、按钮按下态 | 仅做底 |
用法边界:
- `--brand-strong` 是唯一可当"实心大色块"的值;全页同类实心块不超过一处。
- `--brand-soft` 只能当底,不能当文字色或描边色。
- 浅橙底上的文字一律走 `--brand-ink`(`--brand-strong` 落其上仅 4.56:1,余量小)。
- 备注(2026-10-18):`escort/itemlist` 价格数字走回默认 `--brand-strong` + 字重 500(本表「价格数字」用途原位,白卡 4.94:1),同页价格列只用这一个色值、一种字重;其间短暂用过 `--ink-2`,已回退,不再是例外。
- 例外(已登记,2026-10-18 修订):`escort/itemlist`「预约」按钮走**软填充胶囊**——3rpx `--brand-strong` 环 + `--brand-line` 填充 + 28rpx 满圆角 + `--brand-ink` 字 30rpx/500,按下整粒 `opacity .85`。沿革:原为空心胶囊(按下才填 `--brand-line`),规格签删底后"撞形"根因消失,改常填。环不可撤——`--brand-line` 填充落白卡仅约 1.1:1,非文本 3:1 由环承担(4.94:1)。**同一行只允许一个填充物**仍成立(规格签已是纯文字)。
### 2.2 第二色:暖墨文字层
| 令牌 | 色值 | 用途 | 对比度 |
|---|---|---|---|
| `--ink` | `#2B2521` | 标题、需最重的正文 | 纸面 14.26:1 |
| `--ink-2` | `#4A4038` | 正文 | 纸面 9.52:1 |
| `--muted` | `#6F655C` | 次要文字、元信息、说明、未选中态 | 纸面 5.37:1,白卡 5.69:1,浅橙底 5.24:1 |
用法边界:
- 三档只表示文字层级,不表示状态或可点击性。
- `--muted` 是最浅一档,不得再浅——它是全站文字对比度底线。历史值 `#7A7068`(纸面 4.56:1,压线无余量)已废弃,硬编码需全部替换。
- `t-icon` 的 `color` 属性当前使用与令牌对应的字面量:`#9B4508`、`#6F655C`、`#B8520A`;深色按钮上的图标允许 `#FFFFFF`。不要将 `var(...)` 当作属性值直接传入;是否可改用 CSS 着色需结合组件样式隔离验证。
### 2.3 底与线
| 令牌 | 色值 | 用途 |
|---|---|---|
| `--white` | `#FFFFFF` | 卡片、面板 |
| `--paper` | `#FAF8F5` | 页面底色(暖白纸面) |
| `--line` | `#ECE3D6` | 发丝线:卡片内部分隔、区块切分 |
| `--sep` | `#E5DACC` | 分隔线:竖线、浅橙底上的线 |
用法边界:
- **结构线与交互轮廓分开**:中性结构线用 `--line`;浅橙底内部切分或需要更清晰的细线用 `--sep`。浅橙面外轮廓用 `--brand-line`,选中控件可用 `--brand-strong`,状态胶囊用对应状态描边。不是所有边框都必须是中性色。
- 默认结构线为 **2rpx 实线**,避免满屏虚线、双重边框和上下重复横线。已有卡片边界和足够留白时,不再额外画区块分隔线。低对比度装饰线不能作为可操作控件的唯一识别依据。
- `--paper` 与 `--brand-soft` 明度差仅约 1.03:1,浅橙块落纸面须靠 **2rpx `--brand-line` 描边**托形,不加阴影。
- **白卡默认用边框,不强制阴影**:`--white` + 2rpx `--line` 已可承担边界。仅服务主面板、AI 输入面板等需要轻微抬升的容器使用 `--shadow-card: 0 2rpx 10rpx rgba(63, 43, 25, 0.07)`,不要逐张叠加。彩色阴影不得用于白面;`--shadow-cta: 0 2rpx 8rpx rgba(184, 82, 10, 0.16)` 仅用于实心主行动等强调元素。
- 例外(已登记,2026-10-18 修订):`escort/itemlist` 服务分组改为**组头落纸面 + 每项一张白卡**——项卡 `--white` + 2rpx `--line` + 24rpx 圆角 + `--shadow-card`、内距 28rpx、卡间距 20rpx(相邻选择器给出);原"通栏白底块(圆角 0)+ 虚线行"撤销——白带与项卡会叠成两层底。行宽由 686rpx 降至约 626rpx。组头副题说明砖走浅橙面配方:`--brand-soft` 填充 + 2rpx `--brand-line` 描边 + 14rpx 圆角(§四.5 说明砖填充必须中性,`--brand-line` 仅作描边;落纸面靠描边托形)。页首 `.notice` 由白卡降为纸面一行「圆点 + 26rpx `--ink-2` 小字」,费用披露不降 `--muted`。
- 例外(已登记):`escort/itemlist` 的**人工客服旁路卡**做浅橙面(`--brand-soft` + 2rpx `--brand-line` + 28rpx 圆角 + 去阴影),与首页 `.quick-item-full` 同源,补回该页"暖色只剩线、没有面"的那一档。位置在**清单之后、文档行之前**(沿革:页尾"收口卡"→页首清单上方→2026-10-18 下沉回清单之后——旁路属兜底,压在清单前会把不打算自助的用户先引走,也白占首屏):文案走本页"情形 + 动作"两段式(muted「不想线上预约?」+ 暖橙链「直接联系人工客服」)。页尾不设卡,改由一行**文档级元信息**收尾——细竖线分隔的「服务指南 │ 用户协议」(从页首披露卡下移,不加卡、不加 chevron,文字链自身即点击暗示);披露卡因此退回纯声明,只留城市与费用披露。
- 例外(已登记):`mine/about` 的「联系我们」做成**浅橙入口卡**(`--brand-soft` + 2rpx `--brand-line` + 28rpx 圆角 + 去阴影,同首页 `.quick-item-full` 配方),是该页尾部唯一的暖色面。卡内**不再平铺联系方式**——热线/微信/邮箱/工作时间四项与 `mine/contact` 页逐项重合,平铺即"同一意图两个入口";只留「联系我们」+ 一行摘要(「人工客服」,与首页同卡同文案)+ muted chevron,整卡可点跳 `mine/contact`。另注:该页品牌印记(`home-w.png` 白色线稿)必须落 `--brand-strong` 实心底,不能用 `--brand-soft`,白色线稿在浅橙底上看不见。
- 例外(已登记):`mine/mine` 的菜单与「退出登录」做成**通栏白底块**(`--white` + 上下各 2rpx `--line` + `--shadow-card`,圆角 0)。其中「退出登录」是**动作而非导航**,与菜单行不同族:单独一块、一行居中、**无图标无 chevron**、字色 `--muted`。状态色不得用于按钮(§三),退出因此不走红/橙,区分只靠结构与位置。
---
## 三、状态色
状态色只用于订单、记录这类**有明确状态字段**处,同页同类状态只允许一种颜色。
| 状态 | 底色 | 描边 | 字色 | 对比度 |
|---|---|---|---|---|
| 待服务 | `#ECF7F4` | `#C7E5DF` | `#0F766E` | 5.00:1 |
| 服务中 | `#FFF4E8` | `#FFE0C2` | `#B8520A` | 4.56:1 |
| 已完成 | `#EAF6EE` | `#CDE9D7` | `#1F7A4D` | 4.79:1 |
| 已取消 | `#FCF0EE` | `#F2D6D1` | `#B4231A` | 5.89:1 |
用法边界:
- 上表四档已在 `app.wxss` 的 `page{}` 落为令牌:`--status-wait-bg/line/ink`、`--status-done-bg/line/ink`、`--status-cancel-bg/line/ink`(「服务中」复用 `--brand-soft/--brand-line/--brand-strong`)。页面不再写字面量。首页预约预览使用中性白卡,不再用整卡状态色。
- `recordlist` / `recorddetail` 的状态胶囊不再由 JS 给色值:`utils/order.js` 只映射语气档(`tone: wait / doing / done / cancel / neutral`),页面类名拼 `.chip-tone-{tone}`,色值读上表令牌。改色只改 `app.wxss`。
- **不得仅用颜色传达状态**(WCAG 1.4.1):状态胶囊必须带文字,颜色只做强化。
- 青绿(待服务)是全站唯一冷色,只给"等你去处理"这一个语义。
- 服务中复用主色浅档,字色使用全局 `--brand-strong`(`#B8520A`)。
- 状态色不得用于区块标题、图标衬底、按钮、装饰条,只包住状态文字本身。
- 首页预约预览(2026-11-14):组头为「接下来的预约」;每条 `--white` + 2rpx `--line` + 28rpx 圆角、无阴影,卡间距 16rpx。日期与服务、医院、就诊人分层展示,医院允许换行。原「整卡青绿、24rpx 圆角、无组头」规则撤销,不再作为现行例外。
- 表单错误复用已取消档(`#B4231A` 字 + `#FCF0EE` 底),错误必须带文字。
- 禁用态不用实心暖橙:默认 `--muted` 字,按组件选择中性浅底或透明底;需要边框时使用中性线。AI 待发送按钮当前采用 `--paper` 底 + `--muted` 字,不能只凭变灰代替实际的操作拦截。
---
## 四、硬约束(可验证)
1. 所有普通文字对底色对比度目标 ≥ WCAG AA 4.5:1;中文字号不低于 24rpx。24rpx 仅在 375 CSS px 宽屏幕上约等于 12px,不能视作所有设备上的固定像素。
2. 承担识别或操作作用的图标、必要控件轮廓对相邻底色对比度 ≥ 3:1;纯装饰细线不承担该识别职责。令牌对比度不等于整页已通过无障碍验收。
3. 不得新增色相;需区分时先改结构(分组、留白、换线),不要加颜色。
4. 不得使用渐变色。
5. 卡片、面板、说明砖的填充必须中性(`--white` / `--paper` / `--brand-soft`)。
6. 暖橙以外的暖色(灰金、亮橙)不得出现。
7. 同页同一含义只能对应一个色值。
8. 不得仅用颜色传达信息(WCAG 1.4.1)。
9. 不以缩小字号、强制单行或降低文字对比度换取清爽;优先分组、换行和降低装饰密度。
---
## 五、历史遗留收口清单
本节保留历次迁移记录及待复核项,**不作为现行页面结构的完整清单**;旧路径、入口、字重和版式须与实际代码核对,不能据此恢复已撤销设计。本文档阶段不执行页面修改。
### 5.1 页面级
| 范围 | 现状 | 替换为 |
|---|---|---|
| `hospital/contact.wxss`、`hospital/ranking.wxss` | 底 `#F5F7F6`、字 `#1F2937`、绿灰系 | 整体并入暖橙体系 |
已完成(2026-10-06):`health/profilelist`、`health/profileedit` 已按本节并入暖橙体系——两页 `.wxss` 的旧金色 `#D4A853` 连同冷灰文字 `#1F2937`/`#374151`/`#6B7280`/`#9CA3AF`、冷灰线 `#F3F4F6`、旧底 `#FAF6F1`/`#FDF8EE` 一并换成暖橙令牌与暖墨阶。列表页改「浅橙说明砖 + 通栏白块」,每条主体整块可点进编辑(补 chevron 点击暗示,删除动作下沉到卡内操作行、走 `--muted`),空态与「邮寄地址」同语言(`--faint` 图标 + `--muted` 说明);表单页改通栏白块,标签左走 `--muted`、值右走 `--ink` 700,性别选中态用软橙底 + 实心橙描边,健康备注独立一块。两页 `page{}` 均不留令牌副本;`profilelist.js` 的 `confirmColor` 硬编码改 `#B8520A`,`profilelist.json` 补注册既已使用的 `t-loading`(原只在 `.wxml` 里引用、未注册,渲染为空)。
已完成(2026-10-06):`escort/guide` 已按本节并入暖橙体系——`.wxss` 里的 page 级令牌副本(停在旧值 `#C2410C` / `#9A3412`)整块删除,改用 `app.wxss` 唯一来源;`.wxml` 四处 `t-icon` 硬编码随之改值(三个卡片头图标 `#FFFFFF`→`#9B4508`、底部客服 `call` `#9A3412`→`#9B4508`)。同页三处收口:卡片头标识由「实心橙方块 + 白图标」改「`--brand-soft` + 2rpx `--brand-line` 描边 + 暖橙图标」,实心块只留底部 CTA 一处(§2.1);CTA 阴影由 `0 6rpx 16rpx rgba(194,65,12,.22)` 收为 `--shadow-cta`;三处 `font-weight: 600` 改 `700`(中文系统字体只有 400/700 两档)。内容同步:服务流程与 `services.js` 各服务的 flow 对齐(预约 → 沟通信息 → 支付费用 → 准备资料 → 全程陪诊 → 服务完成),删去不在任何 flow 里的「选择陪诊师」;温馨提示的改期句统一为「如需改期或取消,请至少提前4小时联系客服」。
已完成(2026-10-06):`escort/agreement.wxss` 已按本节并入暖橙体系——底 `#FAF6F1` 转 `--paper`,顶部白→暖白渐变去掉(直接落纸面),#`D4A853` 系连三处同色渐变与同色大阴影一并换掉:文件图标衬底转 `--brand-strong` + `--shadow-cta`(白色图标需深底),章节序号转「`--brand-soft` 衬底 + 2rpx `--brand-line` 描边 + `--brand-ink` 字」(全页实心块只留顶部一个),圆点转 `--brand-strong`;冷灰文字 `#1F2937`/`#4B5563`/`#6B7280` 转 `--ink`/`--ink-2`/`--muted`,冷线 `#F0E6D8`/`#E5E7EB` 转 `--line`/`--sep`(浅橙底上用 `--sep`);正文块改通栏白底块(上下 2rpx `--line` + 圆角 0 + `--shadow-card`)。违约金表表头不再铺色(`--brand-line` 只作描边)。另删 7 条死规则 `flow-steps`/`flow-step`/`step-badge`/`step-info`/`step-title`/`step-desc`/`step-line`——WXML 无任何引用。
已完成(2026-10-04):`escort/recordlist`、`escort/recorddetail` 已按本节并入暖橙体系——两页删去旧金色副本与全部渐变,状态一律走 §三 四档;`recorddetail` 另在 `page{ }` 登记 `--shadow-bar`(底栏上向阴影,不在全局色板内)。两页 `json` 原本 `usingComponents` 为空却已用 `t-icon`/`t-loading`,一并补注册。
已完成(2026-10-06):`mine/about.wxss` 已按本节并入暖橙体系——灰金 `#D4A853`、亮橙 `#FF8500`、冷灰底 `#F5F5F5`、品牌区与印记的两处渐变、6×28rpx 的渐变竖条全部换掉:底色转 `--paper`,印记转 `--brand-strong` + `--shadow-cta`(白色线稿需深底),竖条转 8×34rpx 实色 `--brand-strong`。同页两处违规一并修正:`.icp` 由 22rpx 提到 24rpx(硬约束 1 最小字号),元信息与标签统一 `--muted`、正文统一 `--ink-2`。死代码 `.version`(页面已无版本号展示)删除。白卡按 §2.3 补 2rpx `--line` 发丝边 + `--shadow-card` + 28rpx 圆角。同页「联系我们」由平铺的四项联系方式收成一张入口卡(配方见 §2.3 例外)——那四项与 `mine/contact` 逐项重合,平铺属"同一意图两个入口",且该页每行还少一个「拨打/复制」动作词。
已完成(2026-10-06):`escort/attendantlist` 4 文件迁至 `attendant/attendantlist`,同目录新增 `attendant/attendantdetail`(4 文件),两页一并并入暖橙体系——`attendantlist.wxss` 的 page 级令牌副本(停在旧值 `#C2410C` / `#9A3412`)整块删除,改用 `app.wxss` 唯一来源,`page{}` 只留 `background-color: var(--paper)`(同 `guide`);`.wxml` 的 `t-icon` 硬编码 `#9A3412`→`#9B4508`,两处竖分隔线 `#E5DACC`→`--sep`。结构:列表卡右侧补 `chevron-right`(`#6F655C`)作点击暗示,整卡可点进详情;详情页按国标 4.2.1.5 分区——主卡(头像 / 脱敏名 / 已核验徽标 / 服务年限 · 累计服务次数,居中)+ 擅长场景(全量,不截断)+ 服务信息(性别 / 服务区域 / 服务语言,空项整行隐藏)+ 个人简介(未填整块隐藏),全页无实心色块、不新增色相,说明行仍是「公示信息,不含联系方式」。入口仍在首页介绍卡信任行(`goToAttendants`),`app.json` 两条路由同步改路径。同日按国标 4.2.1.5 补全公示项:详情页加「资质与培训」(健康证明有效期 + 培训记录)与「过往服务评价」两个分区,两区均无数据时整块隐藏;区块内条目用 `--line` 发丝线分隔,评分用 48rpx `--ink` 大字 + `--muted` 小数(`/ 5`)与条数,无实心色块。
已完成(2026-10-24):无入口的 `attendant/attendantlist`、`attendant/attendantdetail` 整体下线并删除路由;地址维护入口由下单地址快照替代,`mine/addressedit` 同步删除。上文陪诊师页面与入口描述仅保留为历史记录,不代表当前能力。
已完成(2026-10-18):`health/profilelist` 卡片重构为「身份牌」结构——首字牌 + 姓名/性别签 + 竖线分隔元信息行(空值整项剔除,不留「未填写」)+ 备注单行省略,与 `recorddetail` 就诊人卡同语言。删除动作由「卡内操作行」改为**右上角安静图标**(`catchtap` 防冒泡、确认弹窗兜底):孤行删除撑不满一行、反而拉高卡片;上文「删除动作下沉到卡内操作行」的描述就此被替代。
已完成(2026-10-18):`escort/itemlist` 版式重排并同步本档——结构由「通栏白底章节带」改「组头落纸面 + 每项一张白卡」,虚线行与章线撤销;`.notice` 降为纸面披露行,客服旁路卡下沉到清单之后(§2.3 两条例外同步修订);价格 `--muted`→`--brand-strong`(回到「价格数字」默认用途)、「预约」改软填充胶囊(§2.1 按钮例外同步修订);组头副题说明砖按 §四.5 走 `--brand-soft` 填充 + `--brand-line` 描边;规格签删底(`--brand-soft` 落白卡仅 1.08:1 形同虚设),仅时长服务保留签,「按次」删;按钮补透明热区(2026-11-14 起 `::after` 四边各外扩 16rpx,触控 56→88rpx,视觉形态不变)。全页仍单色相、无新色。
已完成(2026-11-14):`escort/itemlist` 服务卡改为「名称 → 说明 → 价格与预约」三段纵排:名称独占一行、允许换行,价格与时长在左、预约在右;白卡去阴影,改用 2rpx `--line` 描边。`recorddetail` 的客服、修改、展开入口补可见文字(「联系客服」「修改」「订单详情 / 收起详情」)。`mine/mine` 未登录态改为「登录后管理预约与就诊人」主文案 + 次选填昵称,通栏菜单块去阴影。`custom-tab-bar` 选中图标叠 14% 暖橙填充,选中态不只靠颜色。其余内容页同步:白卡去阴影、标题与主操作字重改 600、表单值改 500。
### 5.2 系统级(不在页面里,最易漏)
| 位置 | 现状 | 应改为 |
|---|---|---|
| `app.json` tabBar 图标 | `home-green.png` / `ai-green.png` / `mine-green.png`(绿色图片) | 暖橙 `#B8520A` 版本,与 `selectedColor` 一致。注:`tabBar.custom: true` 时这三张图实际不渲染,可随自定义 tabBar 一起清理 |
已完成(2026-11-13):`app.json` 的 `tabBar.color` 已为 `#6F655C`;`custom-tab-bar` 未选中灰已为 `#6F655C`;`app.wxss` 的 `--td-brand-color-1..10` 已整体映射到暖橙令牌,不再引入第二套色板。
### 5.3 通用色值映射表
| 旧值 | 新值 | 说明 |
|---|---|---|
| `#D4A853` | `#9B4508` 或 `#B8520A` | 灰金转暖橙,按"文字/图标"或"实心"分 |
| `#FF8500` | `#B8520A` | 亮橙转主色 |
| `#FF9B33` / `#FF7A33` | `#B8520A` + `#FFF4E8` | 去渐变,拆成字色与底色 |
| `#22A45D` / `#6B8E7B` / `#2D6A4F` / `#4CAF50` / `#45A049` | `#B8520A`;语义为"已完成"则 `#1F7A4D` | 绿系转暖橙,仅状态语义保留绿 |
| `#FAF6F1` / `#F5F7F6` / `#F5F5F5` | `#FAF8F5` 或 `#FFFFFF` | 旧底转纸面或卡片 |
| `#F3F4F6` / `#EEEEEE` / `#E5E5E5` / `#E5E7EB` | `#ECE3D6`(浅橙底上用 `#E5DACC`) | 冷灰线转暖线 |
| `#1F2937` / `#333333` | `#2B2521` | 冷黑转暖墨 |
| `#6B7280` / `#9CA3AF` / `#999999` / `#7A7068` | `#6F655C` | 各版"次要灰"统一 |
---
## 六、一句话检验
1. 页面去色(灰度化)后层级还清楚吗?去掉颜色就散架 = 在用颜色凑层级。
2. 数一下色相:超过"暖橙 + 暖墨 + 至多一个状态色"就有问题。
3. 最浅的那行字是 `--muted` 或更深吗?比它更浅的要拉回来。
---
## 七、主题色沿革与回滚
主色做过一次色相右移。照 §7.3 倒着改即可整体回滚。
### 7.1 三套值
| 版本 | `--brand-strong` | HSL | `--brand-ink` | HSL | 状态 |
|---|---|---|---|---|---|
| **现行** | `#B8520A` | H25° · S90% · L38% | `#9B4508` | H25° · S90% · L32% | 全局令牌;新首页、预约页与 AI 页沿用 |
| **之前** | `#C2410C` | H18° · S88% · L40% | `#9A3412` | H15° · S79% · L34% | 历史值,不是其他页面的默认值 |
| 已否候选 | `#A85A00` | H32° · S100% · L33% | — | — | 为凑白字 AA 把明度压到 33% 致画面发闷,仅登记 |
`--brand-soft #FFF4E8`、`--brand-line #FFE0C2` 全程未动,回滚无需处理。
### 7.2 为什么离开旧值
旧值 `#C2410C`(H18° 偏红、饱和偏高)大面积铺开会读成"锈橙 ≈ 干血",与就医语境不合。折中右移到 H25°,明度只让 40%→38%、饱和 88%→90%,保住"眼前一亮"的抓力。若日后仍嫌血色,**正解是收缩橙色面积,不是继续调暗**。
### 7.3 回滚清单
以下按资源类型登记,不固定行号与处数。回滚必须先确认当前引用;SVG、位图和 JSON 不会随 CSS 变量自动换色。`--brand-soft` / `--brand-line` 在本次主色沿革中未变。
| # | 文件 | 位置 | 现行 | 回滚为 |
|---|---|---|---|---|
| 1 | `app.wxss` | `page{}` 内 `--brand-strong` / `--brand-ink`(全站唯一来源) | `#B8520A` / `#9B4508` | `#C2410C` / `#9A3412` |
| 2 | `app.wxss` | `page{}` 内 `--shadow-cta` | `rgba(184, 82, 10, 0.16)` | `rgba(194, 65, 12, 0.16)` |
| 3 | `styles/service-icons.wxss` | 首页、预约页等共用的 base64 服务图标 | 暖橙描边与浅橙填充 | 解码 SVG 后按角色调整,不直接替换 base64 文本 |
| 4 | `pages/**/*.wxml`、相关 JS | `t-icon color`、弹窗 `confirmColor` 等属性或接口参数 | 对应当前令牌的字面量 | 按主色、深字色分别映射,不改白色和中性灰 |
| 5 | `custom-tab-bar/index.wxss` | 选中标签及自绘 SVG 的描边与填充 | `#B8520A` | `#C2410C`;SVG 需解码处理 |
| 6 | `app.json`、`pages/**/*.json` | tabBar 和导航栏色值 | `#B8520A`、`#FAF8F5` 等 | 按角色同步;本次仅回滚主色时不动纸面 |
| 7 | `images/ai-ink.png` | AI 欢迎区图形等实际引用 | `#9B4508` | 按新深字色重新着色并检查透明边缘 |
| 8 | `images/home-ink.png` | 首页与 AI 页品牌印记等实际引用 | `#9B4508` | 同上;不是当前「我的」默认头像的唯一实现 |
**无需逐页改写变量消费者**:使用 `var(--brand-*)` 的页面样式随全局令牌更新。仍需搜索字面量和资源引用,复核图标、JS 接口参数、JSON、自绘 SVG 与位图;不要假定历史清单涵盖未来新增资源。
注:`custom-tab-bar` 未选中灰已改 `#6F655C`(2026-11-13 复核),与本次主色调整无关。
---
## 八、字号阶梯与适老化(2026-11-05)
### 8.1 令牌
`app.wxss` 的 `page{}` 是全站唯一来源:`--fs-24` / `--fs-26` / `--fs-28` / `--fs-30` / `--fs-32` / `--fs-34`。
页面 wxss 不再写这六档的字面量;**36rpx 及以上(大标题、价格宏数)不设令牌,保持字面量**。
实现例外:`custom-tab-bar` 当前保留独立组件内的字号与颜色字面量(26rpx / `#6F655C`),须与令牌同步;这不是“所有自定义组件都无法使用 CSS 变量”的通用结论。
`pages/train/index` 的页内 `--t-title/--t-body/--t-caption` 已指向上面的全局令牌,`--t-h2` 及以上仍是字面量。
### 8.2 定点放大规则(第一批)
面向就诊人含老年群体,但**不做整体上移**——只处理"看不清会出事"的信息,保持原有层级节奏:
| 类别 | 处理 |
|---|---|
| **关键值**(就诊/预约时间、医院与地址、就诊人姓名与手机号、金额、订单状态、健康备注、"拨打/复制"类动作词) | 若原为 `--fs-24`,提到 `--fs-26`;若同时是 `--muted`,一并改 `--ink-2` |
| **说明性小字**(卡片副题、证书/服务副标题、页脚合作链接与版权、字数计数、辅助 tip) | 保持 `--fs-24` 不变 |
| **标签 vs 值** | 标签可留 24rpx 浅灰,值不得比标签更小或更浅 |
边界:每处最多抬一档(24→26),不跳档;标题、价格、正文 28rpx 及以上不参与放大。
### 8.3 新版页面字号与字重(2026-11-14)
**取消首页与历史版本逐 rpx 等高的约束**。内容完整、层级清楚、主操作可达优先于历史盒高;不得为守住首屏而压缩医院名、缩小正文或强制服务名不换行。
| 元素 | 当前字号 / 行高 | 角色 |
|---|---|---|
| 首页 `.hero-title` | 60rpx / 1.35,600 | 双行主视觉,不作为通用页标题 |
| 首页 `.section-title` | `--fs-34`,600 | 无竖条区块标题 |
| 首页 `.hero-cta` | `--fs-32` / 1.5,600 | 实心主行动 |
| 首页 `.assist-name` | `--fs-28` / 1.6,400 | 服务入口名称,允许换行 |
| 首页 `.quick-name` | `--fs-30` / 1.5,500 | 工具卡标题 |
| 预约页 `.page-lead-text` | 44rpx / 1.5,600 | 不重复导航栏页名的内容导语 |
| AI `.welcome-title` | 44rpx / 1.45,600 | 欢迎区主标题 |
| AI `.message-text` / `.message-markdown` | `--fs-30` / 1.75 | 连续阅读正文;组件实际渲染需复核 |
| 次级说明、元信息 | `--fs-24` 或 `--fs-26` / 1.5–1.7 | 保持 `--muted` 或更深,不再额外降透明度 |
字重使用 **400 正文、500 局部强调、600 标题 / 主操作**;700 留给确需强强调的内容。不同平台字体对 500 / 600 的映射可能不同,不再假定中文字体只有两档,也不能仅凭字重区分重要信息。
不全局强改行高。各页面按阅读场景设置,固定高度容器要检查溢出;四列宫格在卡内宽度下须重新验证长名称,不能照搬旧版列宽结论。
### 8.4 二期:大字模式(未实施)
「我的」页开关 + 本地存储;开启时在页面根节点挂 `.fs-large`,在 `app.wxss` 覆写六档令牌 ×1.1(24→26 / 26→29 / 28→31 / 30→33 / 32→35 / 34→37)。
**只放大中小字**:36rpx 以上的标题与价格不动,避免首页卡片标题折行、底部操作栏变挤。
这是待实施方案,不代表只换变量即可上线。实施时须检查固定高度、按钮组、宫格、长医院名与底部操作栏,必要时换行、改 `min-height` 或重排;装饰优先隐藏,业务信息不省略。
---
## 九、版式档位(2026-11-14 修订)
统一视觉角色,而不是要求所有页面长得一样。内容页、首页、表单与聊天页允许不同结构,但应共享字号阶梯、颜色、线宽、圆角角色与留白节奏。
### 9.1 展示字号(36rpx 以上)
| 角色 | 字号 | 现状 |
|---|---|---|
| 页面主标题 / 内容型导语(不重复导航页名) | **44rpx** | AI 欢迎标题、立即预约导语;其他内容页按角色复用 |
| 区块标题 | **34rpx**(`--fs-34`) | 首页等区块标题;不强制带竖条 |
| 卡内标题 / 表单组标题 | **32rpx**(`--fs-32`) | 预约分组、内容卡标题 |
| 紧凑页首导语 | **32rpx**(`--fs-32`) | 列表、指南等无需大标题的页面 |
- 新页面优先使用无装饰标题。旧内容页保留竖条时,竖条高与标题字号同档,不再额外叠加短横、边框和色块。
- **导航栏已有页名时,页内不写同名大标题**;可以有不同内容的主张或导语,不限制为「短横 + 一句话」。
- 首页 hero 当前为 **60rpx**;价格按 34–64rpx 数值档处理,不用它替代标题层级。
### 9.2 圆角
| 层级 | 半径 |
|---|---|
| 卡片、状态卡、整块可点面 | **28rpx** |
| 消息气泡、首页主按钮 | 24rpx;消息进入侧角可收至 8rpx |
| 次级问题卡、发送按钮、部分图标衬底 | 20rpx |
| 字段、小控件、输入方式按钮 | 16rpx(标签 10–12rpx) |
| 预约页底部提交按钮 | 16rpx,与表单功能属性对应 |
| 胶囊按钮 | 999rpx |
| 底部弹层(sheet)顶部 | 32rpx |
保留例外:`itemlist` 服务项卡为 24rpx。首页预约卡已统一为 28rpx。品牌拱形、圆形箭头底座属于装饰造型,不作为新的通用容器档位。
### 9.3 容器内距
**页面内容左、右基线优先为 32rpx**。卡内通常为 20–28rpx,不把“页面外边距”与“卡内距”混为同一个数。
已落地例外:AI 输入面板与录音条外边距 24rpx,消息与页首为 32rpx;AI 输入面板内距 20rpx,预约分组水平内距 24rpx。底部主操作栏仍与页面 32rpx 基线对齐。
### 9.4 页首
新页首优先直接进入业务内容。导航栏已说明页名时,不重复堆叠小字提示、大标题和说明;确有服务名称、选择规则或风险提示时再展示。不得为了凑齐版式新增一句文案。旧版短横、竖条和欢迎装饰均不是必需元素。
共享样式可通过 WXSS `@import` 复用,服务图标已使用 `styles/service-icons.wxss`;自定义组件仍须考虑样式隔离,不把页面选择器必然穿透组件作为前提。
### 9.5 留白节奏
建议按角色选档,而不是每一处发明新间距:
| 关系 | 建议档位 | 用法 |
|---|---|---|
| 同一内容内的小间距 | 8 / 12rpx | 标题与元信息、图标与文字 |
| 相邻控件、问题卡、并排卡片 | 12 / 16rpx | 强关联且有独立边界 |
| 卡内组织 | 20 / 24 / 28rpx | 图文布局、表单分组 |
| 独立区块 | 32 / 40rpx | 不同任务之间的呼吸感 |
这些是新增页面的优先档位,不追求抹平现有所有局部补偿。主标题通常行高 1.35–1.5,连续阅读正文 1.6–1.8;留白不是空屏,装饰也不是填空工具。
---
## 十、新版清爽界面配方与验收(2026-11-14)
### 10.1 面、线、影的组合
| 场景 | 推荐组合 | 不要这样做 |
|---|---|---|
| 页面与主视觉 | `--paper` + 暖墨标题 + 少量暖橙强调 | 大面积橙底、渐变海报、全部文字加粗 |
| 普通白卡 / 表单组 | `--white` + 2rpx `--line` + 28rpx 圆角,无阴影 | 每组同时叠描边、投影、竖条、顶底分隔线 |
| 主服务面板 / AI 输入面板 | 同白卡配方,可加 `--shadow-card` | 再给里面每个条目加投影 |
| 客服兜底 / 登录提示 / 录音状态 | `--brand-soft` + 2rpx `--brand-line` + `--brand-ink` 关键动作 | 把提示做成另一个实心主按钮 |
| 字段内部、图标小底座 | `--paper` 或透明底,按需中性边框 | 在白卡里再套多层白卡 |
| 主行动 | `--brand-strong` + 白字;按下用 `--brand-ink` | 同一视区多个同等重量 CTA |
| 次级操作 | 暖墨 / `--muted` 文字与线图标,配轻量按下反馈 | 用低对比浅橙线作为唯一可点击提示 |
允许首页主按钮箭头底座使用低透明度白色作装饰;不因此新增色板。功能文字和功能图标不通过降低透明度制造“高级灰”。
### 10.2 首页参考
- 顺序:品牌 → 主视觉与立即预约 → 信任行 → 培训文字入口 → 接下来的预约(有数据时)→ 陪诊服务 → 常用功能 → 页脚。
- 主视觉为左对齐双行标题,右侧拱形品牌图形只作陪衬;屏宽不超过 340 CSS px 时隐藏图形,不压缩标题。
- 立即预约通栏,最小高度 96rpx、圆角 24rpx、字号 32rpx。微信 v2 原生按钮应显式 `size="default"`,并验证 `button.hero-cta[size="default"]` 的宽度规则实际生效,避免默认样式压窄居中。
- 服务宫格共享一张白色面板,四列、图标 56rpx;不为八种服务分别引入色相或阴影。
- 常用功能为「两张白色工具卡 + 一条通栏浅橙客服入口」,卡间距 16rpx。培训入口沿用现有位置,以业务名称 + chevron 呈现、不加底色、不增加宣传说明,避免与就医预约同重。
- 医院、服务名等动态文本允许自然换行;不使用旧版“只让医院名缩略”的单行摘要。
### 10.3 立即预约参考
- 信息拆成「选择服务 / 就诊人信息 / 就诊安排 / 补充信息」四组,分组序号表达真实填写顺序,不作为全站装饰。
- 白色分组面板无阴影,外部留白承担组间关系;组内字段用中性细线,最后一行不重复封底。
- 服务名与价格上下分层;已选就诊人同时有浅底、深色描边和对勾,不能只变颜色。
- 只读信息、可选择字段与多行补充输入有不同形态;费用披露、协议和条件收货地址不得因版式简化而删除。
- 底部金额与提交按钮固定展示,正文须预留占位和安全区;弹层高于底栏。长金额、键盘弹起和小屏需单独验证。
### 10.4 AI 助手参考
- 欢迎态:直接展示服务咨询范围与快捷问题卡,不堆叠口号、氛围插图和重复导语;问题卡圆角 20rpx、间距 12rpx,保留点选即发送提示。
- 对话态:AI 白色气泡、用户浅橙气泡;头像与身份文字辅助识别,长回答优先获得宽度。普通正文 30rpx / 1.75,AI 生成声明贴近回答。
- 等待与录音状态都有可读文字,动画只是补充;支持 `prefers-reduced-motion`。
- 输入面板共享一个白色容器,文字在上、语音和图片在左下、发送在右下,不回到狭窄的上下双按钮结构。
- 清空为低频破坏性动作,放底部工具栏右侧、仅有记录时出现,保留确认;常见问题入口在左侧,与发送操作分离。页首不再重复身份条,原生导航栏已有页名。
- 页面不整体滚动,消息区独立滚动,flex 滚动子项设置 `min-height: 0`;输入面板不被挤走,自定义 tabBar 与安全区占位不能遗漏。
- Markdown 颜色通过组件实际消费的 `--td-*` 变量映射到现有令牌;内部字号、表格和代码块样式必须验证组件隔离行为,不能仅凭页面 CSS 选择器判断已生效。
- AI 仅提供参考,不替代医生诊断;欢迎区与回复保留说明,不宣称诊断能力。
### 10.5 交互与交付检查
1. **先看灰度层级**:去色后仍能找到标题、关键信息和主操作;不要靠再加一条线或再铺一层色解决所有问题。
2. **检查触控**:高频操作优先保证约 44×44 CSS px 的有效点击区,再按真机验证。88rpx 仅在 375 CSS px 宽时约为 44px,不等于所有屏幕上都达到该目标;热区不能重叠。
3. **检查文字**:长医院名、长姓名、长服务名、多行备注、长金额均不能遮挡操作;弱化使用层级与间距,不使用过浅文字。
4. **检查状态**:空数据、加载、错误重试、未登录、禁用、提交中、录音、识别与长回复都有清楚的反馈,不为简洁删掉真实业务状态。
5. **检查适配**:至少覆盖 320 / 375 / 430 CSS px 宽、底部安全区、键盘弹起与字体放大;装饰先退让,内容可滚动、操作可达。
6. **检查实现**:图标名确实存在,图片路径可用,事件不丢失,CSS 变量有来源,WXSS / WXML / JSON 无结构错误。
7. **区分验证层级**:静态检查、模拟函数测试、微信开发者工具编译、真机视觉与交互验收分别记录;本轮新版页面已做静态与部分模拟交互检查,不能将其表述为已完成真机验收。
## 十一、清爽大气与业务文案约束(2026-11-14 用户反馈)
本节是所有页面后续优化的验收底线;与历史配方冲突时,以本节为准。
- **目标是清爽、大气,不是增加描述。** 优先删除冗余、整理层级、统一基线和适度留白,不以新增宣传语、装饰图形或卡片填空。
- 每段文案必须回答至少一个业务问题:是什么、适不适合、多少钱、有什么限制、当前什么状态、接下来怎么操作。无法回答的默认不添加。
- 不新增“为每一种需要”“让安排更从容”“安心,从这次预约开始”“余下的用心相伴”等与当前操作无关的氛围描述;已有同类文案应清理,而非换一句口号。
- 同一页面不重复业务名称、解释和入口。首页核心主标题允许保留一处,不再叠加口号式副标题、图形题字、栏目副标题和页脚标语。品牌介绍应陈述运营主体与实际服务,不扩写承诺。
- **不得误删业务信息**:价格与单位、服务范围、城市、费用排除项、预约规则、支付与退款、风险和隐私提示、协议、状态反馈、表单用途、上传要求、真实流程与无障碍标签均须保留。
- 普通内页直接进入清单、表单或详情;必要说明贴近相关字段,不强制套用“小字提示 + 大标题 + 一句说明”。不为减少行数截断医院、姓名、服务内容和错误原因。
- 样式优先统一 32rpx 页面基线、24–28rpx 卡内距、28rpx 普通卡圆角、32rpx 分区间距;保留首页紧凑工具卡 24rpx 圆角例外。减少纯装饰短横、竖条、嵌套色块和重复边线。
- 不用缩小字号、降低对比度或压缩点击热区换取清爽;固定栏、安全区、键盘避让和聊天独立滚动不受减法影响。
- 全页检查后,无需改动的业务段落可以保持原样,不为“所有页面都优化”机械改写业务数据或法律文本。
### 本轮覆盖与验证
覆盖 `app.json` 中的 20 个路由:首页、陪诊助手、服务列表/详情/预约、陪诊师列表/详情、预约记录/详情、服务指南/协议、就诊人列表/编辑、我的/个人信息、关于我们/联系我们/合作入驻、培训介绍/报名。逐页以业务相关性、留白、标题层级、长文本和固定栏为检查项。静态检查不等同微信开发者工具编译或真机验收,交付时分别说明实际完成的验证。