docs: 发布 v1.3 PRD 全文(00-09,2026-11-04 收口版)

This commit is contained in:
wudh committed 2026-11-04 13:49:03 +08:00
commit 7559a9aa61
11 files changed
+1805

No files matched your search

+232
View File
@@ -0,0 +1,232 @@
# 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 秒,不做翻页。