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

40 KiB
Raw Blame History

暖橙陪诊小程序 · 视觉设计规范

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