Files
lujianlucha-prd/04-glasses-field.md
T

233 lines
17 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.
# 04 眼镜端 · 现场主交互
| 项目 | 内容 |
| --- | --- |
| 版本 | v1.3,2026-11-03 |
| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §3、`02-pages/P16 P17 P22 P23 P24 P18`、`04-components.md` C-47 至 C-52 |
| 原型 | p16-standby、p17-list、p22-item、p23-input、p24-result、p18-overlay |
| 功能点 | 43(P16 7、P17 12、P22 5、P23 5、P24 5、P18 9) |
| 视口 | 1280×720,`gl-*` 令牌,形状加亮度编码 |
| 数据来源 | `reference/mock-data.md`,六屏全部示例值取自该文件 |
| 状态 | G4 交付,待评审 |
## 1 端的定位
眼镜是现场主交互端。执法人员戴着它走完一次检查:看清单、听引导、说结论、说数值、说提交。手机在口袋里当中转,只在改错、看证据、复核三个时点掏出来。
四条边界决定了本板块的全部设计:
1. 屏上元素一律不可点。没有按钮、没有列表选择、没有滚动条,交互只有语音。加一个可点元素,就意味着要设计焦点、要处理触控与语音的争用,而现场戴着手套点不中。
2. 不渲染加载态。骨架、进度条、转圈一概不出。刷新在两秒内不可感知,任何加载指示只是噪声。
3. 镜片按单色落稿(实机单色还是彩色未定,V13-Q25/Q43),淡绿底上红绿灰三色语义不可辨。三态只能靠形状与亮度区分,并配一行文字计数兜底。
4. 场景不在这里选。眼镜只播报当前场景,起单复用该人上次完成的场景,切换场景的唯一入口是手机主页。眼镜发起的切换请求已在 2026-11-03 删除。
## 2 六屏一览
| 屏 | 一句话 | 入口 | 出口 | 功能点 |
| --- | --- | --- | --- | --- |
| P16 待命屏 | 现在归哪一类检查、怎么开始 | 开机;提交成功后回落 | P17 清单屏 | 7 |
| P17 清单屏 | 这一类该查什么、查到哪了,并且在这里把它查完 | P16 起单成功;P22、P23 返回;P24 失败回落 | P22、P24、P16 | 12 |
| P22 单项引导屏 | 这一项查什么、判什么 | P17 说项名或说下一项 | P17;P23(不符合后说录入) | 5 |
| P23 录入屏 | 识别不出时,把值说出来 | P22 不符合后说录入 | P17 | 5 |
| P24 提交结果屏 | 交成没交成、差哪几项 | P17 说提交,服务端校验返回 | P16(成功);P17(失败或断连) | 5 |
| P18 覆盖层与横幅 | 正在听、听懂了什么、判定记没记住、还有什么没核对 | 任意屏之上 | 自动回落,无手动关闭 | 9 |
主线在 P17 完成:说结论即推进,P22 是「停下来看清一项」的放大镜,P23 只在不符合且有数值时出现,P24 是提交后的唯一反馈面。
## 3 语音词表
词表是眼镜端的接口定义。同义词双收,落库与播报一律用规范词,留痕存原始话语。
| 说法 | 生效在 | 行为 | 屏面反馈 |
| --- | --- | --- | --- |
| 小新小新 | 任意屏 | 唤醒 | C-29 聆听横幅 |
| 开始检查 | P16 | 按该人上次完成的场景起单 | 播报「{场景名},正在识别」 |
| 符合 | P17、P22 | 当前项置「符合」,进下一未查项 | C-51,播报「已记符合」 |
| 不符合 | P17、P22 | 当前项置「不符合」;有数值要求时追问 | C-51,播报「已记不符合」 |
| 不适用 | P17、P22 | 追问原因,收到原因才落库 | C-51 |
| 录入 | P22(仅不符合后) | 进 P23 | 屏面切 P23 |
| 重说 | P23 | 清空回显,重新聆听 | 回显清空 |
| 确认 | P23 | 落库,来源 voice | 200ms 后回 P17 |
| 跳过/下一个 | P17、P22 | 当前项状态不变,跳到下一项 | 大字换项 |
| 上一项 | P17、P22 | 回上一个未查项 | 大字换项 |
| 第 N 项 | P17、P22 | 跳到该项 | 大字换项 |
| 重新核对 | P17 | 本单作废,回到核对检查对象环节重新识别,留痕记作废原因 | 播报「已作废,请核对检查对象」 |
| 提交 | P17 | 先复述对象求确认,确认后校验提交 | 进 P24 |
| 继续 | P24 | 立即回 P17 首个差异项 | 屏面切 P17 |
| 还有几项 | P17 | 播报剩余数 | 无变化 |
| 关闭显示/打开显示 | 任意屏 | 熄屏与亮屏,语音照常 | 全黑或恢复 |
三条词表纪律:
1. 跳过与不适用必须分开。跳过是不查就过、状态不变;不适用是查过判定不适用、要原因。合成一个说法,NA 无原因数必然涨。
2. 「录入」只在不符合之后可用。误说时播报「请先说不符合」,不直接进 P23,否则会录出一个没有对应结论的数值。
3. 一次说两句(「不符合,下一个」)只取第一个结论,第二句忽略并播报「已记不符合」。
词表只有规范词。界面文案、播报、落库值一律用「符合/不符合/不适用」。识别层对现场沿用的旧说法做同义映射,映射表维护在语音指令配置里,不进入任何界面与本文正文。
示例区的话必须先唤醒。待命屏与清单屏的示例只是教学样例,未唤醒时说这些内容系统不响应,因此必须给一句「请先说『小新小新』」:现场把没反应当设备故障,比多说一句话的代价高得多。
「重新核对」与手机端页面名「核对检查对象」同源,现场听到的是同一个动作:停下当前这单,回到核对环节重新识别。它不作废整条记录,只作废这次的临时单,留痕里记谁在什么时候因为什么停了单。
## 4 逐屏定义
### 4.1 P16 待命屏
| 区域 | 内容 |
| --- | --- |
| R0 顶栏 | 左「就绪」,右「■ 手机已连接」;断开态改空心方块 |
| R0b 页面名 | 当前场景名;未定场景显示「未选择场景」 |
| R1 唤醒提示 | 「说『小新小新』开始」 |
| R2 示例轮播 | 前置一行「唤醒后可以说」,示例挂在左竖线下;按当前场景取示例组,M01 三条:开始检查、说结论推进、烟度要不要取样 |
| R3 底部声明 | 「检查在眼镜完成,修改在手机」 |
起单有四种拒绝,都不生成任务:无上次场景、上次场景已停用、场景无冻结模板、手机未连接(起单可成但识别无法回传)。
### 4.2 P17 清单屏
| 区域 | 内容 |
| --- | --- |
| R1 对象行 | 识别键主字段大字加场景名;复合键的主字段与副行分开 |
| R2 当前项 | 项名 64px、状态图形、依据条款号一行 28px |
| R3 进度计数 | 已查 / 未查 / 不适用,形状加文字双兜底 |
| R4 下两项 | 当前项之后两个未查项的项名 |
| R5 同步角标 | 未同步的行右侧标「未同步」,补传后逐条消失 |
R2 加依据条款号是本次唯一的加字。现场被问「凭什么判这条」时,屏上要有条号,不能每次回手机查。
### 4.3 P22 单项引导屏
项名、依据、三个结论块横排、一行语音提示。无顶栏状态条、无计数行:这一屏只服务一项,带计数反而分散注意力。
三个结论块的形状与清单屏三态图形一一对应:符合是实心方块、不符合是空心方块、不适用是斜纹方块。不符合在手机端仍是「已查」,异常与否由异常判定算,不由结论词算。
### 4.4 P23 录入屏
待录字段(名、单位、范围提示)、聆听态、识别回显(值 64px 加来源标「语音」)、兜底提示四段。
不落库的三种情况:超出范围、非数值、超时无输入。落库即回清单屏,不在本屏停留。
### 4.5 P24 提交结果屏
成功显示回执号后六位与「已留档」,失败显示「未提交」加差哪几项(最多三条,超出「还有 N 项」),断连显示「未连手机」。
三个变体的自动回落时长不同:成功与断连 3 秒,失败 8 秒。回落目标也不同,成功回待命屏,失败回清单屏的首个差异项。
### 4.6 P18 覆盖层与横幅
单实例栈,不并行叠放:聆听 → 路由 → 结果 → 判定已记录 → 待复核提醒。后一个替换前一个。
C-51 解决「说了结论但不确定系统有没有收到」,没有它现场会重复说一遍,把同一项说成两条。C-52 解决「提交完就走」,识别与语音的值没人看过,这份记录在复核时站不住。待复核数为 0 时不出现 C-52。
## 5 跨屏规则
| 规则 | 内容 |
| --- | --- |
| 断连 | 判定落本地队列,屏上标未同步,允许继续判定;按提交播报「请先连上手机」,不发校验请求 |
| 队列丢失 | 眼镜重启且未落盘,该行标「未落库」,不给补救入口;提交时由服务端列缺项后逐项补查 |
| 熄屏 | 全黑但语音与判定照常;四条横幅只播报不上屏;屏不因任何事件自动亮起 |
| 场景停用 | 大字下方一行「该场景已停用」,禁止判定与提交 |
| 文字兜底 | 三态计数永远显示文字,不只靠形状 |
| 不显示判定长文 | 眼镜上不播报长文案,失败只说差哪几项 |
## 6 降级:L0 与 L1
L0(无屏)与 L1(仅状态灯)两档全部退化为语音,功能不缺失,只是没有视觉。两档不进一期验收,但代码分支不能删,否则换机型要改结构。
| 屏 | L0/L1 播报示例 |
| --- | --- |
| P17 | 「第 3 项,OBD 就绪状态,依据法典第 1126 条,说符合、不符合或不适用」 |
| P22 | 同上,进入即播,不等追问 |
| P23 | 「请说光吸收系数的数值,单位米的负一次方」,识别后播「一点二,说确认或重说」 |
| P24 | 成功播「已提交,回执号 000041」;失败播「未提交,缺 5 项」,只播前 3 条与总数 |
## 7 功能点清单
| 编号 | 功能 | 规则 | 验收 |
| --- | --- | --- | --- |
| F-P16-01 | 顶栏状态 | 左就绪、右连接态,断开为空心方块 | 断开手机后顶栏右端变空心方块 |
| F-P16-02 | 页面名 | 显示当前场景名,随切换更新 | 切换场景后屏上名称同步,不残留旧名 |
| F-P16-03 | 唤醒提示 | 「说『小新小新』开始」 | 常显 |
| F-P16-04 | 示例轮播 | 按场景取示例组,3 条 5 秒轮换;示例区带「唤醒后可以说」前提标签,视觉从属于唤醒提示 | 切场景后示例组随之变化;未唤醒说示例内容时播报「请先说『小新小新』」,不静默 |
| F-P16-05 | 底部声明 | 「检查在眼镜完成,修改在手机」 | 常显,不含技术词 |
| F-P16-06 | 熄屏态 | 全黑,语音照常,屏不自动亮 | 说「关闭显示」后全黑,再说「开始检查」仍能起单 |
| F-P16-07 | 语音起单 | 按上次完成场景起单;四种拒绝各一句播报 | 无上次场景时播「请先在手机选择检查类型」,且不生成任务 |
| F-P17-01 | 顶栏状态 | 同 P16 | — |
| F-P17-02 | 对象行 | 识别键主字段加场景名,复合键副行 | M04 显示信用代码为主、点位编号为副 |
| F-P17-03 | 当前项 | 项名、状态图形、依据条款号 | lawRef 为空时显示「依据待补」 |
| F-P17-04 | 进度计数 | 已查、已查不适用、未查三段 | 计数与项状态实时一致 |
| F-P17-05 | 下两项 | 取当前项之后两个未查项 | 末项时该行不渲染 |
| F-P17-06 | 熄屏态 | 同 P16 | — |
| F-P17-07 | 显示事件挂载 | 接挂载、增量、清除三类下行事件 | 手机改值后屏上对应行变化 |
| F-P17-08 | 说结论即推进 | 两类结论;不适用追问原因;跳过不改状态 | 说「不符合」后落库值为「不符合」,项状态转已查 |
| F-P17-09 | 翻项 | 按名、按序、上一项、下一项、第 N 项 | 说「上一项」回到上一未查项 |
| F-P17-10 | 语音提交 | 先复述识别键求确认;断连拒绝;通过进 P24 | 断连时说提交只播报,不发校验 |
| F-P17-11 | 同步角标 | 未同步逐行标注,补传后逐条消失 | 断连判定后该行出现「未同步」,重连后消失 |
| F-P17-12 | 对象纠错 | 说「重新核对」作废本单并留痕 | 作废后回核对检查对象环节,留痕可见作废原因 |
| F-P22-01 | 项名展示 | 单行截断,18 字以内不换行 | 30 字项名截断加省略号,不缩字号 |
| F-P22-02 | 依据展示 | 取 lawRef,只显示条款号 | 无依据时显示「依据待补」 |
| F-P22-03 | 结论三选展示 | 三块横排,形状加文字 | 三块形状与清单屏三态一致 |
| F-P22-04 | 语音收结论 | 收结论后落定并回 P17 | 说「不符合」后三块中该块转高亮,回清单屏 |
| F-P22-05 | 不符合后续问 | 配了数值区间才问「是否录入数值」 | 布尔项不出现该追问 |
| F-P23-01 | 待录字段 | 字段名、单位、范围提示 | 未配范围时该行不出现 |
| F-P23-02 | 聆听态 | 波形条随音量变化,不做识别进度 | 说话时波形起伏 |
| F-P23-03 | 识别回显 | 值加单位,来源标「语音」 | 回显值与落库值一致 |
| F-P23-04 | 重说 | 清空回显重新聆听 | 说「重说」后回显清空 |
| F-P23-05 | 二次失败兜底 | 连续两次解析失败提示「请用手机录入」 | 两次失败后不再追问数值 |
| F-P24-01 | 成功展示 | 回执号后六位加「已留档」 | 后六位与手机端回执一致 |
| F-P24-02 | 失败展示 | 差哪几项最多三条,超出「还有 N 项」 | 8 个差异项时不滚动只列三条 |
| F-P24-03 | 断连展示 | 「未连手机」加一行提示 | 不发起校验请求 |
| F-P24-04 | 自动回落 | 成功 3 秒、断连 3 秒、失败 8 秒,无手动关闭 | 到时自动跳转,无关闭入口 |
| F-P24-05 | 语音继续 | 说「继续」回 P17 首个差异项 | 回落目标是差异项,不是首个未查项 |
| F-P18-01 | 聆听横幅 | C-29,与「请讲」同帧 | 唤醒后立即出现 |
| F-P18-02 | 路由横幅 | C-30,意图判定单行 | 兜底不经过本组件 |
| F-P18-03 | 结果横幅 | C-31,指令、答案、兜底三变体 | 三种说法各出其变体 |
| F-P18-04 | 自动回落 | 各横幅按自身时长回落 | 判定已记录 1.5 秒,待复核提醒 3 秒 |
| F-P18-05 | 熄屏边界 | 熄屏期间只播报不上屏 | 熄屏时判定不出现横幅 |
| F-P18-06 | 单实例栈 | 五类元素顺序替换,不叠放 | 连续判定只刷新主副行,不排队 |
| F-P18-07 | 兜底静默 | 未命中不弹条,只播固定话术 | 说无关内容不出现横幅 |
| F-P18-08 | 判定已记录横幅 | 主行加副行「已查 n / 总数」,1.5 秒 | 每记一条出现一次 |
| F-P18-09 | 待复核提醒横幅 | 主行加副行「手机可改」,3 秒,仅一次 | 待复核为 0 时不出现 |
## 8 与手机端的分工接口
| 接口 | 方向 | 载荷 | 手机侧承接 |
| --- | --- | --- | --- |
| 判定 | 眼镜上行 | 项编号、结论、来源、时间、是否入队 | 落库,值进待复核清单 |
| 录入值 | 眼镜上行 | 项编号、原话、解析值、来源 voice | 落库,进待复核清单 |
| 挂载与增量 | 手机下行 | 清单、项状态、同步态 | 变值后下行刷新屏面 |
| 提交结果 | 手机下行 | 回执号或差异项列表 | P06 显示同一份回执与校验清单 |
| 核对检查对象 | 眼镜上行 | 识别键 | P02 只在识别失败或复合键缺段时拉起 |
两路提交先进为准。眼镜提交成功后,手机 P06 进入即转回执段,不产生第二条记录。
## 9 验收范围
本板块 43 个功能点进入一期验收,对应 `03-user-stories-and-journey.md` 的 US-04-01 至 US-04-05。L0、L1 两档不验收但保留分支;实机分辨率与刷新率复核后只换 `gl-*` 令牌,不改结构。
## 10 Mock 数据一致性
六屏与手机端共用一套事实,取自 `reference/mock-data.md`。跨页出现的车号、项名、条号、进度必须能对上,不允许各页自造。
| 屏 | 关键数据 | 事实集对应 |
| --- | --- | --- |
| P16 | 场景名「路检路查」;示例三条为路检语境(烟度、OBD、尿素),不得混入堆场或废水场景的话术 | §4 场景与检查项 |
| P17 | 苏A12345 · 已查 2 / 未查 5 / 不适用 0,当前第 3 项光吸收系数「法典第 1124 条」 | §4 进度算术第 1 行 |
| P22 | 第 3 项光吸收系数,数值型,判不符合后可录入 | §4 第 3 项:值类型 数值 0 至 9.99 m⁻¹ |
| P23 | 光吸收系数 1.2 m⁻¹,范围 0 至 9.99 | §4 第 3 项终局 |
| P18 | 判定已记录,副行「已查 3 / 7」 | §4 进度算术第 3 行 |
| P24 | 差 4 项:OBD 就绪状态、尿素使用情况、OBD 通信,还有 1 项(车载诊断系统故障指示) | §4 进度算术第 4 行 |
条号、限值属示例值,客户确认检查项依据后替换,只改数值不改结构(V13-Q13)。
## 11 未闭合
| 编号 | 内容 | 本板块的落法 |
| --- | --- | --- |
| V13-Q27 | 马路噪声下语音识别率未实测 | 录入屏不设置信度阈值,只在连续两次解析失败时兜底 |
| V13-Q25 / Q43 | 实机分辨率、单色或彩色、刷新率、书面确认 | 按 1280×720 与 `gl-*` 令牌落稿 |
| V13-Q11 | 其余五场景的示例话术 | M01 沿用三条,其余场景用通用三条占位 |
| V13-Q28 | 主页眼镜信息字段 | 与本板块无关,属手机端 R5 |
一处设计值待实测:P24 失败回落 8 秒,依据是「够读完三条差异项」,未实测。偏短则延长到 12 秒,不做翻页。