31 KiB
暖橙陪诊用户端小程序代码审查
- 审查对象:
ui/wxapp_escort/(页面、自定义 tabBar、utils,以及与之相关的 health 服务契约) - 审查方式:静态审查(逐文件阅读 + 脚本校验);整改后补充 Node 行为验证,尚未在开发者工具/真机运行
- 初次审查及补充合并:2026-10-24;分批整改与复核:2026-10-24
- 结论摘要:31 个代码问题已按根因分批修复并通过静态检查及针对性行为验证;U-P2-8 保留为开发者工具/真机验收项,不以静态检查替代运行时结论。
- 编号说明:
F为功能与产品问题,U为 UI 样式与交互问题,Q为代码质量与发布风险;标注“新增”的是补充审查项。
整改后已验证项
- 前端 24 个一方 JS 文件、后端 63 个 JS 文件均通过
node --check;前端 JSON 均可解析。 app.json当前 15 个页面路由文件完整;109 个静态 WXML 事件绑定及动态菜单事件均有对应处理函数。- 服务目录、固定/夜间/灵活预约、后端时长与结束时间派生、地址快照、权限白名单、状态机、退款枚举和幂等索引行为验证通过。
- 日期合法性、年龄、脱敏、表单校验、未保存提醒、列表四态、AI 消息恢复等前期针对性行为断言通过。
- 页面列表不再使用
index、*this或索引别名作为wx:key;本地 WOFF 字体签名、全局字体覆盖和组件apply-shared适配检查通过。 - 尚未进行微信开发者工具或真机验证;小屏、大字体、键盘、读屏、安全区及字体实际渲染仍须按第五节验收。
整改状态与提交
下表中的“已修复”表示代码整改和上述静态/行为验证完成,不等同于真机验收通过。前后端为独立 Git 仓库。
| 问题编号 | 状态 | 修复提交 |
|---|---|---|
| F-P0-2 至 F-P0-5;F-P1-1、F-P1-2、F-P1-4、F-P1-6、F-P1-7 | 已修复:订单派生、预约规则、状态机、支付退款、列表计数和地址快照统一由服务端契约承接 | 后端 3f3dd07;前端 d3f399d |
| F-P0-1、F-P0-7、F-P1-5 | 已修复:启动资源与登录 Promise 就绪、无效服务拦截、登录后恢复预约、前后端幂等 | 前端 d3f399d;后端 3f3dd07 |
| F-P0-6、F-P1-8 | 已修复:统一帧协议与结束帧、唯一消息 ID、懒连接、发送时序、节流缓存和失败重试 | 后端 83ef5c2;前端 d731fc1 |
| F-P1-3、F-P1-9 至 F-P1-12、F-P2-1、Q-P3-1 | 已修复:关闭头像假入口,公共日期/状态/脱敏/未保存能力收口,完善表单及错误态 | 前端 a45a3d7 |
| U-P2-1 至 U-P2-7 | 已修复:设计令牌、tabBar、字号、文案和可访问名称统一;订单卡原有点击暗示及已支付条件经复核无需重复修改,陪诊师页随产品决策下线 | 前端 1181d59、df96cb3 |
| Q-P3-2 至 Q-P3-4 | 已修复:删除死页面与调试文件,清理无用代码和空生命周期,稳定列表键,图标字体随包发布并更新包元信息 | 前端 df96cb3 |
| U-P2-8 | 待开发者工具/真机验收;不以静态检查标记通过 | 第五节清单 |
问题总览
功能与产品
| 级别 | 编号 | 问题 | 主要位置 |
|---|---|---|---|
| P0 | F-P0-1 | 服务详情/协议页冷启动白页;无效服务无空态,登录预约缺承接 | itemdetail.js、agreement.js |
| P0 | F-P0-2 | 下单未写 duration/endTime,订单详情时长恒为 1 小时 |
itemdetail.js、订单 schema |
| P0 | F-P0-3 | 夜间陪诊无法选夜间时间;“提前 1 天”未校验 | itemdetail.wxml |
| P0 | F-P0-4 | 取消原因被后端丢弃 | recorddetail.js、订单 handler/schema |
| P0 | F-P0-5 | 订单列表分页过滤、角标、类型、部分支付均不正确 | recordlist.js |
| P0 | F-P0-6 | AI 错误帧被忽略,消息 ID 与历史冲突 | aichat.js、WebSocket |
| P0 | F-P0-7 | 【新增】提交预约无防重复机制,慢网可能重复下单 | itemdetail.js/.wxml |
| P1 | F-P1-1 | 支付口径不一致,提示联系客服但无直接出口;已支付取消无退款流转 | 服务目录、指南、订单详情 |
| P1 | F-P1-2 | 邮寄地址未被下单消费;地址操作失败后本地状态可能失真 | addressedit、下单弹窗、订单 schema |
| P1 | F-P1-3 | 头像选择不会落库 | mine/profileedit |
| P1 | F-P1-4 | 首页待服务数量只统计前 50 条 | home/index.js |
| P1 | F-P1-5 | 静默登录与页面渲染存在时序窗口 | mine.js、recordlist.js |
| P1 | F-P1-6 | 可选省份与开通范围矛盾;费用口径冲突 | itemlist、itemdetail |
| P1 | F-P1-7 | “确认完成/再次预约”语义不成立 | recorddetail.js |
| P1 | F-P1-8 | 聊天强制聚焦、逐 chunk 写缓存、启动即连 WS;断线发送存在竞态 | aichat.js、app.js |
| P1 | F-P1-9 | 订单详情展示完整身份证号与完整订单号 | recorddetail.wxml |
| P1 | F-P1-10 | 【新增】就诊人表单校验不足,非法数值会静默变成 0 | health/profileedit.js |
| P1 | F-P1-11 | 【新增】编辑页缺少未保存修改提醒 | 就诊人、个人资料、地址编辑页 |
| P1 | F-P1-12 | 【新增】请求失败可能被展示成空数据,缺统一错误态和重试 | recordlist 等列表/详情页 |
| P2 | F-P2-1 | 列表首次进入重复请求;日期解析方式不统一 | recordlist.js、recorddetail.js |
UI 样式与交互
| 级别 | 编号 | 问题 | 主要位置 |
|---|---|---|---|
| P2 | U-P2-1 | 服务详情、联系我们仍使用旧主色 | itemdetail.wxss、contact.wxss |
| P2 | U-P2-2 | TDesign 品牌变量仍为绿色 | app.wxss |
| P2 | U-P2-3 | 自定义 tabBar 未选中色仍是废弃值 | custom-tab-bar |
| P2 | U-P2-4 | 两处 22rpx 字号低于 24rpx 下限 | aichat.wxss、itemdetail.wxss |
| P2 | U-P2-5 | 整卡可点但无显性点击暗示 | recordlist.wxml、attendantlist.wxml |
| P2 | U-P2-6 | 导航标题、指南命名、已支付金额、费用披露等文案问题 | 多处 |
| P2 | U-P2-7 | 【新增】纯图标按钮缺少可访问名称 | AI 发送、弹窗关闭、删除等 |
| P2 | U-P2-8 | 【新增】小屏、大字体、长内容与键盘场景缺运行时验收 | 首页、下单弹窗、订单、AI 等 |
代码质量与发布风险
| 级别 | 编号 | 问题 |
|---|---|---|
| P3 | Q-P3-1 | 状态映射、年龄、省份、日期格式化等重复定义 |
| P3 | Q-P3-2 | 死路由、死代码、仓库垃圾文件 |
| P3 | Q-P3-3 | 图标字体依赖远程域名 |
| P3 | Q-P3-4 | 无效抽象、空生命周期、非法或不稳定 wx:key、死 CSS |
一、功能与产品问题
P0:阻断或产生错误数据
F-P0-1 冷启动、无效服务与登录预约承接不完整
位置
- itemdetail.js:同步读取
globalData.services,无效 ID 回退到服务 1,找不到服务时直接返回。 - itemdetail.js:弹窗依赖
globalData.user,未登录仅 toast。 - agreement.js:同步读取
app.globalData.agreement。 - 正确模式参照 itemlist.js:等待
servicesReady。
问题
分享或朋友圈冷启动时,服务/协议数据可能尚未就绪,页面空白且不会自愈;book=1 可能早于静默登录执行。无效 ID 默认打开服务 1,有误订风险;服务下架时仍可能显示“合计 ¥0.00 / 预约”。
建议
- 页面统一等待
servicesReady/agreementReady和登录就绪结果,再渲染或打开弹窗。 - 加载失败提供错误态和重试;无效/下架服务显示“服务不存在或已下架”,禁止预约。
- 只有明确的内部默认入口才允许缺省服务,不得把非法 ID 静默改为服务 1。
- 未登录提供“登录并继续预约”,成功后恢复原服务和预约意图。
验收标准
冷启动、分享打开、弱网、无效 ID、未登录 book=1 均不出现白页或错误服务;登录后可继续原预约。
F-P0-2 下单未写 duration/endTime
位置
- itemdetail.js:排期仅提交日期和开始时间。
- escort_record.js:
duration默认 60。 - recorddetail.js:详情直接使用订单时长。
问题
全天、半天、夜间、跑腿订单可能都显示“陪诊1小时”,结束时间为空。
建议
由后端根据 serviceId 和服务目录派生时长、结束时间与费用;前端不提交或不得成为这些字段的唯一事实来源。
验收标准
各服务订单的时长、结束时间、费用与服务目录一致;篡改前端字段不能改变后端派生结果。
F-P0-3 预约日期与时间不受服务规则约束
位置
- itemdetail.wxml:日期从当天开始,时间固定
08:00–18:00。 - services.js:公示“请提前 1 天预约”。
问题
夜间陪诊选不到夜间时段,当天预约与公示冲突,全天服务也可选择无法覆盖完整时长的开始时间。
建议
服务目录下发可约日期、时间窗和时长等机读字段;前端按字段渲染,后端提交时再次校验,不再硬编码另一组前端规则。
验收标准
每类服务只出现合法时段;当天、跨时窗和时长不足的预约均被阻止并给出具体原因。
F-P0-4 取消原因被后端丢弃
位置
- recorddetail.js:提交
{ status: 'cancelled', reason }。 - escort_record.js:状态更新只读取
status。 - 订单 schema 无取消原因字段。
问题
界面要求用户选择原因并提示成功,但原因未持久化,客服和运营无法查询。
建议
增加 cancelReason / cancelledAt 等字段,由后端在合法状态迁移中写入;前端成功后回读或展示。
验收标准
取消原因可持久化和查询;非法状态取消被拒绝,前端状态与后端一致。
F-P0-5 订单列表筛选、计数、类型和支付状态错误
位置
- recordlist.js:客户端分页后过滤、按当前页计数,类型读取不存在的
escort.type,支付映射缺partial。 - escort_record.js:支付枚举含
partial,无refunding。 - 后端已支持状态查询参数。
问题
可能漏掉后续页的进行中订单;角标不是总数;订单类型恒定;部分支付被误显为未支付;refunding 为死映射。
建议
筛选、分页、分类计数全部由服务端完成;首页与列表复用同一计数口径;类型使用 escort.serviceName;支付状态和文案收敛到共享映射。
验收标准
多页交错状态数据不漏单、不重复,角标等于服务端总数;部分支付在列表与详情中口径一致。
F-P0-6 AI 错误帧与消息标识不可靠
位置
- websocket.js:token 失效时下发
error帧。 - aichat.js:仅处理
ai帧。 - aichat.js:计数器每次进入页面从 0 开始。
问题
错误帧被忽略时会永久显示“正在输入”;历史消息与新消息可能重复 ID,导致列表键和滚动锚点冲突。
建议
统一分发所有帧类型,错误/系统帧必须结束输入态并显示可恢复提示;消息 ID 使用跨会话唯一值。错误应作为系统状态展示,不伪装成带 AI 声明的正常回答。
验收标准
token 失效、服务错误和断线均不会永久转圈;清空或重进后消息键唯一、滚动定位正确。
F-P0-7【新增】预约提交没有防重复机制
位置
- itemdetail.js:无提交中状态。
- itemdetail.wxml:提交按钮无 loading/disabled。
问题
慢网下连续点击可能创建多笔订单。
建议
前端立即锁定提交并显示处理中反馈;后端使用幂等标识防止重复创建。
验收标准
双击、连点和网络重试最终只生成一笔订单,失败后按钮可恢复并允许重试。
P1:核心体验与产品逻辑
F-P1-1 支付承诺、支付出口与退款规则不一致
位置
- services.js 和 guide.js:流程写“微信支付”。
- recorddetail.wxml:实际仅显示“请联系客服完成支付”,且不可点击。
问题
流程承诺与实际能力不一致;用户需离开订单自行寻找客服;已支付订单取消缺少退款状态或说明。
建议
产品先确定支付模式:接入支付,或统一改为“客服协助支付”。保留线下模式时,将提示改为“联系客服支付”文字链并携带订单上下文;明确已支付取消和退款规则,由后端状态机执行。
验收标准
服务页、指南和订单文案一致;未支付/部分支付均可从订单一次点击联系客服;取消后费用状态明确且可追踪。
F-P1-2 地址功能断链,失败时界面可能失真
位置
addressedit.wxml(该页已随整改删除,此处保留问题记录):声称“添加后下单即可选用”。- itemdetail.wxml:下单没有地址选择;订单 schema 无地址快照。
addressedit.js(该页已随整改删除):先改本地再请求,失败不回滚,处理中未锁定。
问题
地址维护是死功能,取药快递无法获得收货地址;删除或设默认失败时,界面可能与服务端不一致。
建议
对需要收货的服务接入默认地址选择和订单地址快照,接入前下线入口或修正承诺;操作增加处理中锁定,失败回滚并提示。
验收标准
需要地址的订单包含下单时快照;地址操作失败后刷新与失败前数据一致,不出现假成功。
F-P1-3 头像选择不会落库
位置
- profileedit.wxml:头像行有点击暗示。
- profileedit.js:只保存临时路径,提交数据不含头像。
问题
选择头像并提示保存成功后,返回仍是旧头像。
建议
上传能力完成前隐藏或禁用该入口并说明;完成后保存持久化地址并处理上传失败。
验收标准
头像保存后跨页面、跨启动一致;未支持时不再给用户可修改的假象。
F-P1-4 首页待服务数量只统计前 50 条
位置
- index.js:拉取 50 条后客户端过滤。
问题
订单超过 50 条后提醒数量偏少,并产生不必要的数据传输。
建议
由服务端按待服务状态直接返回总数,与订单列表使用同一口径。
验收标准
订单超过 50 条时,首页数量仍与实际待服务总数一致。
F-P1-5 静默登录与页面渲染存在时序窗口
位置
- mine.js:同步读取全局用户。
- recordlist.js:用户为空时直接 toast 并 return。
问题
冷启动可能短暂或持续显示未登录;记录页前置拦截使用户无法进入请求层 401 单飞重登兜底。
建议
统一暴露登录就绪 Promise/状态订阅,页面就绪后渲染;记录页避免重复实现登录拦截。
验收标准
冷启动直达“我的”和记录页均可自动恢复登录,不闪现错误身份态,也不需要切页刷新。
F-P1-6 服务区域与费用口径冲突
位置
- itemlist.wxml:公示仅北京、天津,费用仅含人工服务费。
- itemdetail.js 和
recorddetail.js:可选全国省份。 - 取药快递服务另收快递费。
问题
表单允许选择未开通区域;统一费用说明未覆盖已公示的快递费。
建议
由服务目录/区域配置驱动可选项;费用说明明确不含医疗费用和已公示的快递等代垫费用,具体以服务页为准。
验收标准
不可服务区域无法提交;列表、详情和订单费用说明无冲突。
F-P1-7 “确认完成/再次预约”语义不成立
位置
- recorddetail.js:
canComplete = status === 'completed'。 onRebook跳服务列表而非当前服务。
问题
已完成订单再次“确认完成”没有业务意义;进行中反而没有该动作。“再次预约”也不能直接重约当前服务。
建议
若维持“进行中不显示底栏”的既有规则,删除确认完成按钮和处理函数;若改为用户确认完成,则同步修改产品规则和后端状态机。再次预约携带当前 serviceId 进入服务详情。
验收标准
每个状态只显示合法动作;再次预约直达原服务,不重复写入终态。
F-P1-8 AI 连接与流式处理影响性能和恢复体验
位置
- aichat.js:每次
onShow强制聚焦。 - aichat.js:逐 chunk 同步写整段历史。
- aichat.js:调用
connect()后立即send(),未等待连接成功。 - app.js:应用启动即连接仅 AI 页使用的 WebSocket。
问题
切 Tab 强制弹键盘;长回复高频同步存储易卡顿;断线后的首条消息可能在连接建立前发送;所有用户承担常驻连接成本。
建议
取消自动聚焦;流式期间更新内存,结束或节流后落缓存;等待连接成功再发送,失败保留原消息并提供重试;进入 AI 页时懒连接。
验收标准
切页不自动弹键盘,长回复无明显存储卡顿,断线重连后首条消息不丢失且可重试。
F-P1-9 敏感信息和订单编号展示不合理
位置
- recorddetail.wxml:完整身份证号和 ObjectId。
- profilelist.js:列表已进行身份证脱敏。
问题
相同信息在不同页面隐私口径不一致;长 ObjectId 不便用户核对和口述。
建议
统一使用公共脱敏函数;订单号生成适合客服沟通的短号,或仅在 UI 展示后 8 位并保留复制完整编号能力。
验收标准
列表与详情脱敏一致;客服可查完整记录,用户无需口述 24 位字符。
F-P1-10【新增】就诊人表单校验不足
位置
- profileedit.js:只校验姓名和手机号。
- profileedit.js:非法身高、体重经
Number(...) || 0静默变成 0。
问题
非法输入不会得到具体反馈,还可能被当成“未填写”保存;证件号、出生日期等缺少合理边界校验。
建议
对身高、体重、出生日期和证件号按业务需要校验格式及合理范围;错误定位到字段并给出修正建议,不用 0 吞掉解析失败。
验收标准
非数字、负数、极端值和非法日期不能保存;合法留空仍按可选字段处理。
F-P1-11【新增】编辑页缺少未保存修改提醒
位置
就诊人编辑、个人资料编辑、地址编辑。
问题
用户修改后误返回会直接丢失输入;无修改时若一律弹窗又会增加操作成本。
建议
记录初始快照,仅在实际发生修改且未保存时提示“继续编辑/放弃修改”。
验收标准
无修改直接返回;有修改时可明确选择保留编辑或放弃,不发生静默丢失。
F-P1-12【新增】错误态与空态混用
位置
- recordlist.js:失败后列表可能仍为空,最终显示“暂无记录”。
- 其他列表/详情页应同步检查同类模式。
问题
网络或服务异常被误解为没有数据,且缺少重试入口。
建议
统一 loading / error / empty / success 四态;错误态说明原因并提供重试,空态只在请求成功后显示。
验收标准
断网、500、空数组分别显示加载失败、服务失败、真实空态;重试后无需重启页面即可恢复。
P2:功能一致性与效率
F-P2-1 首次重复请求与日期解析不统一
位置
- recordlist.js:
onLoad与onShow各请求一次。 recordlist.js、recorddetail.js使用new Date('YYYY-MM-DD'),陪诊师页使用另一套解析方式。
建议
首次加载只保留 onShow 入口;日期解析统一抽成工具函数,手工拆分年月日或采用跨端稳定格式。
验收标准
首次进入只发一次请求;iOS/Android 日期、星期和年龄结果一致。
二、UI 样式与交互问题
U-P2-1 服务详情、联系我们仍使用旧主色
位置
- itemdetail.wxss 和 contact.wxss:覆盖
--brand-strong、--brand-ink等旧色值。 - 两页 WXML 仍有硬编码图标色。
建议与验收
删除页面旧色板副本,统一使用全局 #B8520A / #9B4508 令牌;同类按钮、图标和标签跨页面色相一致,文字及非文本对比度保持达标。
U-P2-2 TDesign 品牌变量仍为绿色
位置
- app.wxss:
--td-brand-color-*为翠绿色阶。
建议与验收
将 TDesign 品牌变量映射到现有暖橙令牌,删除绿色品牌注释;loading、markdown 链接及通用组件均不出现第二色相。
U-P2-3 自定义 tabBar 未选中色仍是废弃值
位置
- custom-tab-bar/index.js 和 index.wxss:
#7A7068。 - app.wxss:规范色为
--muted: #6F655C。
建议与验收
两处统一为 #6F655C,选中态继续 #B8520A;组件无法使用全局变量时可保留字面值,但注释需指向 --muted,并保持 AA 对比度。
U-P2-4 两处字号低于项目下限
位置
- aichat.wxss:消息时间 22rpx。
- itemdetail.wxss:就诊人电话 22rpx。
建议与验收
统一提升到至少 24rpx;空间不足优先简化或脱敏内容,不压字号。小屏下不重叠、不截断,文字对比度保持 AA。
U-P2-5 整卡可点但无显性点击暗示
位置
- recordlist.wxml:注释明确移除 chevron。
attendantlist.wxml(该页已随整改删除,此处保留问题记录):整卡可点,模板无 chevron。
建议与验收
恢复右侧 chevron 或“查看详情”文字链,保留轻微按压反馈;用户无需试探即可识别可点击卡片,样式仍遵守一页一义一色。
U-P2-6 文案与元信息问题
| 位置 | 问题 | 建议与验收 |
|---|---|---|
| itemdetail.json | 导航栏标题为空 | 固定“服务详情”或动态使用服务名,冷启动后也能正确更新 |
| guide.wxml、guide.json | “服务指南/陪诊指南”混用 | 全站统一“服务指南” |
| recorddetail.wxml | 未支付也显示“已支付 ¥0.00” | 仅 paidFee > 0 时展示 |
| itemlist.wxml | 费用说明与快递费冲突 | 与 F-P1-6 同步修正,避免两个批次改出不同口径 |
U-P2-7【新增】纯图标按钮缺少可访问名称
位置
- aichat.wxml:发送按钮只有图标。
- 弹窗关闭、地址删除等同类图标按钮也需统一排查。
建议与验收
补充小程序支持的可访问名称、角色和状态;禁用态不仅改变透明度,也应禁止操作。读屏能播报“发送消息”“关闭弹窗”“删除地址”等具体用途,而不是只读“按钮”。
U-P2-8【新增】响应式与键盘场景缺运行时验收
现状
代码已使用 min-width: 0、AI 消息区 min-height: 0、固定区 flex-shrink: 0 等正确约束,但静态审查无法证明小屏、大字体和键盘下均稳定。
重点场景
- 320px 小屏及系统大字体:首页三列场景、服务名称/价格、订单金额/状态。
- 长内容:医院名、服务名、昵称、地址、AI 长回复。
- 安卓/iOS 键盘:下单弹窗、备注弹窗、就诊人表单、AI 输入区。
- 固定底栏:底部内容占位、安全区、无按钮时是否残留空白。
验收标准
除明确设计的横向选择区外不出现整页横向滚动;文本无重叠截断;当前输入项和主要动作可见或可滚动到达;底栏不遮挡内容。
三、代码质量与发布风险
Q-P3-1 重复定义应收敛
| 重复内容 | 位置 | 建议 |
|---|---|---|
STATUS_MAP |
recordlist.js、recorddetail.js |
收敛到订单常量,详情描述作为扩展字段 |
PAYMENT_STATUS_MAP |
同上 | 单源维护,避免 partial 再次漏配 |
calcAge |
陪诊师列表、详情 | 抽到日期工具 |
provinces |
下单、订单编辑 | 抽到区域配置,并最终与服务区域规则联动 |
formatDate/formatDateTime |
我的、订单、就诊人等页面 | 抽到公共格式化工具 |
Q-P3-2 死路由、死代码与仓库垃圾文件
- app.json:
pages/home/webview无入口且接收任意 URL,建议删除;陪诊师两页无入口,需产品决定恢复一个公示入口或整体下线。(已整改:三处路由与文件均已删除) recordlist.js:makePhoneCall未使用,formatRecord产出多个模板未消费字段。mine.js:多个用户信息字段未被模板使用。app.js:随机appId与 HTTP 层硬编码来源不一致,且服务端未消费。(已整改:app.js 里那个随机 appId 是无消费方的死代码,已删;但 HTTP 层的appId=wxapp-escort是服务端conf.json选 appid/secret 的键,wxsignin 缺它会 400「缺少 appId」,已恢复并保留)- 根目录
_verify2.ps1、空的README.md/doc/NOTES.md应清理或补实际用途;package.json名称和描述仍属旧项目。 about.wxss:.contact-desc已无模板引用。
Q-P3-3 图标字体依赖远程域名
位置
- icon.wxss:
@font-face从https://tdesign.gtimg.com/...加载。
风险与验收
发布前确认下载域名白名单;字体失败不能导致全站图标空白。优先自托管或提供本地兜底,并在开发者工具断网/资源失败场景验证。
(已整改:icon.wxss 的 @font-face 改为 base64 内嵌,不再请求 tdesign.gtimg.com。微信不允许组件 wxss 里用本地路径加载字体(报错带 -do-not-use-local-path- 标记),真机也不支持,故放弃本地路径方案;app.wxss 原有的 escort-icons 本地路径覆盖块已一并移除,字体唯一来源收敛到组件内嵌。
miniprogram_npm 会在「构建 npm」时由 node_modules 重新生成,重建后 icon.wxss 会退回「远程字体 + 2347 个图标 class」的原始形态(约 483KB)。此时执行 python tools/build-icon-wxss.py 重新生成:脚本按仓库里实际用到的图标名裁剪字体与 class(42 个字形,483KB → 约 14KB),assets/fonts/t.woff 只作为脚本输入、已通过 packOptions.ignore 排除出包。脚本依赖 pip install fonttools。)
Q-P3-4 其他小项
itemdetail.js:calculateTotal忽略入参、恒定返回价格,是无效抽象。agreement.js/about.js:删除空生命周期函数(webview.js已整页删除)。agreement.wxml:检查数组行的wx:key合法性。itemdetail.wxml、aichat.wxml:清理index、对象项*this等不稳定键,使用稳定字段或真正唯一 ID。agreement.js:模块顶层getApp()移入生命周期。
四、建议修复顺序
- 服务端契约优先:F-P0-2、F-P0-3、F-P0-4、F-P0-5,统一订单派生字段、预约规则、状态机、筛选计数和支付状态。
- 核心链路不中断:F-P0-1、F-P0-7、F-P1-5,处理启动就绪、登录承接和幂等下单。
- AI 可靠性:F-P0-6、F-P1-8,统一帧协议、唯一 ID、连接时序和失败恢复。
- 产品决策项:F-P1-1、F-P1-2、F-P1-3、F-P1-7,以及陪诊师公示页定位;先确认支付、地址、头像、订单完成责任,再实施。
- 表单与状态反馈:F-P1-10 至 F-P1-12、F-P2-1,统一校验、未保存提醒和四态渲染。
- UI 样式收口:U-P2-1 至 U-P2-7,按根因批量清理色板、字号、点击暗示和可访问名称。
- 质量与发布:Q-P3-1 至 Q-P3-4,抽公共能力、清理死代码并处理外部资源风险。
五、真机/开发者工具验收清单
功能与产品
- 分享/朋友圈冷启动打开
itemdetail?id=X、?id=X&book=1,以及协议页。 - 无效、下架服务 ID 和未登录预约:不白页、不误跳服务 1,登录后可继续。
- 夜间陪诊选择 20:00 后;全天服务选择过晚时间;当天预约均被正确校验。
- 各服务下单后的时长、结束时间、费用正确;连续点击只生成一笔订单。
- 第一页全为已完成时切换“进行中的”;订单超过 50 条时核对首页和列表总数。
- 部分支付订单在列表、详情显示一致;未支付/部分支付可直接联系客服并识别订单。
- 已支付取消、服务完成、再次预约按最终产品规则验证状态迁移。
- token 失效、断网、重连后的 AI 首条消息、错误提示、输入态和重试。
- 需要收货的服务须在下单时填写地址并保存快照;刷新订单后仍展示下单当刻的收货信息。
- 就诊人非法数值、日期、证件号的字段级提示;有修改返回时出现提醒。
- 列表断网与空数据分别显示错误态和空态,重试可恢复。
- iPhone/Android 上订单日期、星期、年龄显示一致。
UI 与交互
- 320px、常见全面屏、系统大字体下,无整页横向滚动、重叠或不可达操作。
- 下单、备注、AI 输入键盘弹起时,当前输入项和主要按钮不被遮挡。
- 固定底栏和安全区不遮内容,无按钮时无空白底栏。
- 全部文字满足 AA 和最小 24rpx;图标等非文本信息满足 3:1。
- loading、链接、tabBar、图标按钮均为统一暖橙/暖墨体系,无绿色或旧橙色残留。
- 可点击卡片有显性暗示和按压反馈;纯图标按钮有可访问名称和有效禁用态。
- 图标字体加载失败时有可用兜底,不出现整页方框或空白图标。
本文档保留原始问题作为审查记录;顶部“整改状态与提交”为当前实施结论。后续验收完成后,应仅依据真实开发者工具/真机结果更新剩余状态。