# 暖橙陪诊小程序 · 视觉设计规范 适用范围:`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 个路由:首页、陪诊助手、服务列表/详情/预约、陪诊师列表/详情、预约记录/详情、服务指南/协议、就诊人列表/编辑、我的/个人信息、关于我们/联系我们/合作入驻、培训介绍/报名。逐页以业务相关性、留白、标题层级、长文本和固定栏为检查项。静态检查不等同微信开发者工具编译或真机验收,交付时分别说明实际完成的验证。