主题
O6 视觉异常流转(工单系统内置功能 PRD)
| 项 | 内容 |
|---|---|
| 文档定位 | 本文是工单系统内置功能 PRD,非 ReAct Agent 能力。 O6 不进入「一个 B 端小程序入口 + 一个 ReAct 智能体 + 按角色权限装配」的统一架构,属于工单系统巡检模块的事件驱动页面与状态机 |
| 通用规范引用 | 公共规范.md §5 数据规范、§6 输出规范;仅取数据与呈现口径,不套用 §8 的 Agent 10 节骨架 |
| 能力来源 | 04_AI智能巡检-视觉巡检与日报.md(视觉巡检判定、置信度、复核、工单衔接)、05_巡检任务完成情况统计.md(误报率/复核率/有效异常/转工单口径)、现有工单系统(巡检工单/巡检明细/工单状态机) |
| 复用关系 | 只借鉴 space-agent 一键诊断的交互与话术(证据、置信度、低置信度提示、反馈留痕)和 AI 工单的防重/状态流转;不复用其智能体实现或编排逻辑 |
| 版本 | v0.1 |
1. 场景定义
1.1 一句话与定位
本文是工单系统内置功能 PRD,非 ReAct Agent 能力。O6 描述的是:巡检任务执行完成后,视觉巡检的 VLM 判定结果中,低置信度、判定不符合、无法判定、抓拍失败的记录自动进入复核队列;复核人查看证据图与置信度后,确认异常并转工单或转人工现场,或纠正为正常/标记误报,最终闭环留痕。
本项目统一架构是一个 B 端小程序入口 + 一个 ReAct 智能体 + 按角色权限装配。O6 不在这套架构里:它没有用户 query、没有工具调用、没有多步编排,属于工单系统巡检模块的内置页面与状态机。它和 O4 的一键诊断一样,是工单系统里的固定功能,不是 Agent 场景。
注:Agent 不编排、不建单、不派单。 O6 的入队由巡检完成事件触发;建单必须由复核人确认后调用工单系统接口完成;派单由工单系统既有规则负责。
1.2 用户与价值
| 用户 | 在 O6 里做什么 | 价值 |
|---|---|---|
| 巡检执行人 | 查看本人任务产生的异常与复核状态;接收抓拍失败/现场核实待办 | 知道哪条被退回、为什么退回 |
| 区域运维 | 认领并复核本区域异常;确认/纠正/误报;转单或转现场 | 不用逐条翻巡检记录,按队列处理 |
| 班组长/复核人 | 处理本班组复核队列、超时升级件、代复核 | 责任到人,证据齐全 |
| 管理者 | 只读查看本授权范围的复核率、误报率、转单率 | 判断视觉巡检是否可信、是否需要调标准 |
| 运维主管 | 跨区域查看、处理升级件、导出统计 | 发现区域积压与系统性问题 |
价值总结:把 VLM 的「不确定」变成「有人负责的确定」——该复核的进队列,该转单的带证据转单,误报有原因、有统计,标准调整有依据。
1.3 触发方式
- 事件触发,没有用户 query:巡检任务执行完成(
InspectionTaskCompleted)或视觉异常产生(InspectionExceptionCreated)后,由工单系统内部事件驱动 O6 入队。 - 入队条件(满足任一):
result = 不符合;result = 无法判定;confidence = low,或数值置信度低于该巡检项的confidence_threshold;- 抓拍失败或图像质量不合格(模糊/过暗/遮挡/视角偏移);
- 巡检项
review_policy = 必须复核。
result = 符合且置信度达标:正常归档,不进队列。- 同一巡检明细重复投递事件时,按
item_result_id幂等,不重复入队。 - O6 不创建巡检计划、不触发巡检执行;巡检调度属于巡检模块既有能力。
1.4 边界
| 不做 | 原因 |
|---|---|
| 不做成 ReAct Agent 能力 | O6 是事件驱动、链路固定的工单系统内置功能,不需要自然语言理解、工具选择或多步推理;做成 Agent 只会增加不确定性。 |
| Agent 不编排、不建单、不派单 | 编排由巡检完成事件和复核状态机负责;建单必须人工确认后走工单系统接口;派单由工单系统既有规则负责。 |
| 不连续录像 | 只按巡检时刻抓拍,降低隐私与存储风险。 |
| 不做人脸识别、不做人员身份识别 | ROI 避开人脸,只判断设备/空间状态,不输出人员身份。 |
| 不自动修改巡检标准、提示词、参考图、置信度阈值 | 复核反馈只形成调整建议,由人员在巡检配置中修改并版本化,避免历史口径漂移。 |
| 不做像素级比对 | 光照、角度、时间变化会放大误报;采用语义判定 + 置信度 + 人工复核。 |
| 不替代消防/安防实时联锁 | 巡检是周期抽检,不承担实时安全联锁职责。 |
| 不默认新建独立工单类型 | 优先复用现有报修/维修工单;是否新建类型见 §9 待确认。 |
| 不自动关闭异常 | 闭环必须由人工确认、纠正、误报标记、数据无效关闭或工单闭环回写触发。 |
| 不做对话入口、不做小程序 AI 悬浮球入口 | O6 是固定的复核工作台,不是聊天场景;悬浮球是统一 AI 入口,不能混用。 |
1.5 与 O4 的区别
| 维度 | O4 告警/工单/根因 | O6 视觉异常流转 |
|---|---|---|
| 入口 | 规则告警 → 自动建单 → 工单详情页「一键诊断」按钮 | 巡检 VLM 结果 → 复核队列 |
| 触发 | 告警事件;自动建单 | 巡检任务完成事件;无用户 query |
| 是否自动建单 | 是 | 否;必须人工确认后才转单 |
| 人工动作 | 在工单内点「一键诊断」看根因/证据/建议 | 看证据图/置信度,确认/纠正/误报,再转单/转现场 |
| 输出 | 诊断报告 | 复核结论 + 工单/现场处置 |
| 共同点 | 都是工单系统内置,非 ReAct Agent 能力;都不替工单系统派单 | 同左 |
一句话:O4 从告警进、O6 从巡检结果进;O4 有自动建单,O6 必须人工确认后才转单。 O6 不调用一键诊断;一键诊断也不进入 O6 复核队列。两者只共享证据展示、置信度提示、反馈留痕的交互原则,实现路径独立。
2. 形态与入口
| 入口 | 载体 | 主要用户 | 能做什么 | 不做什么 |
|---|---|---|---|---|
| 复核队列列表 | 工单系统 Web → 巡检管理 → 异常复核 | 区域运维、班组长/复核人、运维主管 | 按区域/状态/置信度筛选;认领;进入详情 | 不做对话;不直接批量建单 |
| 巡检工单详情页 | 工单系统 Web/移动端 → 巡检工单 → 异常明细 | 巡检执行人、区域运维 | 查看该次巡检的异常与复核状态;进入单条复核 | 不在详情页内自动建单 |
| 移动端待办 | 工单系统移动端/现有工作台待办 | 区域运维、班组长 | 接收待复核/超时提醒;打开移动端复核页 | 不做小程序 AI 悬浮球入口;不做独立 App |
- 复核队列默认筛选「待复核 + 我的区域」,按等待时长/异常等级排序。
- 巡检工单详情页只显示与本工单关联的异常;单条「复核」打开与队列相同的详情组件,避免两套页面逻辑。
- 移动端待办复用现有工单待办与站内消息;不新增微信服务号/企微推送承诺,渠道以工单系统现网能力为准。
- 明确不做:对话入口、AI 悬浮球入口、独立 App、大屏入口。复核是固定工作流,用户不需要「问」;悬浮球是统一 AI 入口,不应承载工单系统内部按钮。
3. 复核链路与状态机
3.1 复核链路
3.2 状态机
3.3 状态说明
已确认为决策态,不是终态;已纠正、已标记误报、数据无效关闭是三个并列的判定分支,不是顺序流转。
| 状态 | 进入条件 | 可执行动作 | 超时与提醒 | 关键留痕 |
|---|---|---|---|---|
| 待复核 | 命中 §1.3 入队规则,且未被认领 | 查看详情、认领 | 默认 4 h 未认领提醒班组长;24 h 升级运维主管;不自动关闭 | 入队时间、入队原因、事件 ID |
| 复核中 | 复核人认领并锁定 | 查看、确认异常、纠正为正常、标记误报、数据无效关闭、释放 | 30 min 无操作自动释放回待复核;每次有效操作刷新锁定;释放留痕 | 认领人、认领时间、锁定到期时间 |
| 已确认 | 复核人判定异常成立 | 转报修/维修工单、转人工现场;未选择去向可撤回复核中 | 2 h 未选择去向提醒本人/班组长;不自动转单 | 复核人、复核时间、异常描述、建议动作 |
| 已转工单 | 工单创建成功并返回工单号 | 查看工单、复制工单号 | 按工单系统 SLA;O6 只显示同步状态;闭环回写后转已闭环 | 工单 ID、工单类型、创建时间、幂等键 |
| 已转人工现场 | 现场处置待办生成并通知班组 | 查看处置要求、回填结果、关闭 | 按现场处置时限(默认 4 h/8 h 待确认)提醒班组长 | 目标班组、处置要求、通知时间、回填人 |
| 已纠正(判正常) | 复核人判定现场正常,且原结果为无法判定/低置信度 | 填写纠正说明;如有关联工单,按规则关闭/撤销 | 无额外超时;确认后闭环 | 纠正原因、前后结论、关联工单处理结果 |
| 已标记误报 | 复核人判定原「不符合」为错误判定 | 选择误报原因(必填)、补充说明 | 无额外超时;确认后闭环;计入误报率 | 误报原因、说明、复核人、时间 |
| 已闭环 | 工单闭环、现场回填、纠正或误报完成 | 只读查看 | 终态;新证据不重开旧记录,新建异常并关联旧异常 | 闭环方式、闭环时间、全链路操作日志 |
补充规则:
- 抓拍失败/数据缺失且无证据图:不进入已确认/已纠正/已标记误报,允许从复核中直接「数据无效关闭」为已闭环;原因必填,计入抓拍失败率,不计入误报率。
- 纠正与误报的区分:原结果 = 不符合、现场正常 → 必须选「标记误报」;原结果 = 无法判定/低置信度、现场正常 → 选「纠正为正常」,不计误报;抓拍失败/数据缺失 → 数据无效关闭,不计误报。三者不得混用。
- 复核结论优先于 VLM 结果:人工确认/纠正/误报时以复核结论为准,同时记录 VLM 原结果与人工结论的差异,用于后续阈值、提示词和参考图调整。
- 并发认领:服务端用版本号/乐观锁,第二个认领人收到「已被认领」提示,不覆盖原认领人。
- 所有状态变更只追加审计日志,业务侧不得修改或删除历史记录。
4. 页面与信息展示
4.1 复核队列列表
| 列 | 内容 | 说明 |
|---|---|---|
| 异常编号 | EX-YYYYMMDD-xxxx | 可点击进入详情 |
| 发现时间/等待时长 | 抓拍时间、已等待小时数 | 等待超阈值标红 |
| 空间/对象 | 楼栋/楼层/房间、设备或空间名称 | 按用户区域权限过滤 |
| 巡检项 | 如「地面积水」「防火门状态」 | 显示所属标准/计划 |
| VLM 结果 | 不符合/无法判定/抓拍失败/符合(低置信度) | 用文字 + 颜色双重标识 |
| 置信度 | high/medium/low(有数值时同时显示) | 显示与阈值的关系 |
| 抓拍质量 | ok/模糊/过暗/遮挡/视角偏移/失败 | 质量异常单独标识 |
| 入队原因 | 低置信度/不符合/无法判定/抓拍失败/必审 | 可多选展示 |
| 状态 | 待复核/复核中/已确认/已转工单/已转现场/已闭环 | 支持筛选 |
| 复核人 | 认领人/处理人 | 未认领显示「—」 |
| 操作 | 查看、认领 | 已认领的记录只显示「查看」 |
筛选项:区域、时间范围、巡检计划、巡检项、置信度、抓拍质量、状态、入队原因。默认「待复核 + 我的区域」,按等待时长降序、异常等级升序。
4.2 复核详情页
| 区域 | 展示内容 | 要求 |
|---|---|---|
| 异常摘要 | 异常编号、空间、对象、巡检项、发现时间、来源巡检任务、当前状态、入队原因标签 | 首屏可见,结论先行 |
| 证据图 | 原图可放大/缩放/拖拽;抓拍时间;相机名称与 ID;预置位;ROI 框与文字说明;图像质量标记 | 原图与参考图可并排对照;无图时明确显示「抓拍失败/无证据图」 |
| VLM 输出 | 判定结果、evidence 文本、置信度(high/medium/low + 数值)、阈值、是否低于阈值、巡检说明版本、模型版本、解析是否失败 | 置信度必须与阈值同时展示;解析失败标「未判定」,不伪造结论 |
| 巡检项与标准 | 检查内容、巡检说明快照、参考图、所属标准/计划、抓拍方式 | 巡检说明用复核时的快照,避免后续改 prompt 影响历史 |
| 历史同点位 | 最近 10 次同点位记录:时间、结果、置信度、复核结论、关联工单 | 可展开;用于判断偶发/复发 |
| 同类异常近期次数 | 同空间 + 同巡检项近 7/30 天次数、未闭环数、最近一次时间、已有工单链接 | 重复异常给出明确提示 |
| 操作区 | 确认异常 / 纠正为正常 / 标记误报 / 数据无效关闭;确认后选择转工单或转人工现场 | 按钮按状态和权限显示;无证据图时禁用「确认异常→转单」 |
| 留痕区 | 认领、复核、转单、回写、闭环的操作人/时间/原因/前后状态 | 只读,不可编辑 |
4.3 低置信度与异常状态提示
借鉴一键诊断「只在低置信度时出现提示行、不新增重新分类按钮」的交互原则,话术按巡检证据场景重写。复核结论本身就是反馈,不额外做点赞/点踩。
| 情况 | 提示话术 | 动作约束 |
|---|---|---|
| 低置信度 | 「AI 置信度 low(0.42),低于该巡检项阈值 0.70。此判定仅作参考,请对照原图、参考图和 ROI 说明人工确认;系统不会据此自动建单。」 | 可确认/纠正/误报,但必须人工判断 |
| 中等置信度且不符合 | 「AI 判定不符合,置信度 medium(0.66)。请重点核对 evidence 描述的位置与 ROI 是否一致。」 | 可确认,建议先看历史同点位 |
| 无法判定/解析失败 | 「模型未能给出可靠判定(无法判定/输出解析失败),本条不按异常直接建单。请转人工现场或数据无效关闭。」 | 不显示「不符合」结论 |
| 抓拍失败 | 「本次抓拍质量不合格(过暗/模糊/遮挡/视角偏移),模型未判定。请安排重拍或转人工现场,不硬判。」 | 禁用「确认异常→转单」 |
| 证据图缺失 | 「证据图不可用,禁止仅凭文本确认异常转单;可转人工现场核实。」 | 只允许转现场/数据无效关闭 |
| 已被认领 | 「该记录已被 {姓名} 认领({时间}),如需处理请联系对方或等待释放。」 | 只读,等待锁释放 |
| 超时未认领 | 「已等待 {x} 小时未认领,已提醒班组长。」 | 仍可认领;升级后主管可处理 |
4.4 移动端
- 单列布局:异常摘要 → 证据图 → VLM 输出 → 历史 → 操作区;操作按钮吸底。
- 证据图全宽展示,支持双指缩放和拖动查看;缩略图与原图切换不横向溢出。
- 置信度、入队原因、状态用「文字 + 颜色」双重表达,不只靠颜色。
- 必须覆盖加载中(骨架屏)、空状态(「暂无待复核」)、图片加载失败(占位 + 重试 + 转人工现场)、提交失败(保留当前状态 + 重试)四种状态。
5. 转单 / 转人工规则
5.1 转单对象
默认复用现有 7 类工单中的报修/维修工单,不新建独立「视觉异常工单」。按异常类型分流:
| 异常类型 | 默认处置对象 | 说明 |
|---|---|---|
| 设备/设施故障(门、灯、投影、屏幕、阀门等) | 报修/维修工单 | 复用现有工单;携带证据图与巡检项 |
| 安全/消防隐患(防火门未关、通道堵塞、积水) | 报修/维修工单,标记紧急 | 可同时转人工现场;不替代消防联锁 |
| 保洁/环境(垃圾溢出、污渍) | 转人工现场(保洁班组) | 是否落为保洁工单待确认 |
| AV/教学就绪(桌椅、幕布、白板) | 转人工现场(AV 班组)或报修 | 按是否设备故障选择 |
| 抓拍失败/无法判定 | 转人工现场(重拍/核实) | 不硬判、不直接建单 |
| 其他 | 复核人选择 | 需在备注中说明理由 |
- 具体工单类型(报修 vs 维修)由工单产品经理确认;现有类型不能满足时列为待确认,不在本文擅自新增。
- O6 不派单:不选处理人、不选班组、不写派单规则。如页面展示「建议处理班组」,只作为描述字段,不产生派单动作。
5.2 转单携带字段
| 字段 | 说明 |
|---|---|
| 来源类型 | 巡检视觉异常 |
| 异常 ID / 巡检任务 ID / 巡检明细 ID | 用于追溯与防重 |
| 空间 | 楼栋/楼层/房间及空间 ID |
| 对象 | 设备/空间/自定义点及对象 ID |
| 巡检项 | 巡检项 ID、名称、巡检说明快照、提示词版本 |
| 异常类型/等级建议 | 来自巡检项配置或复核人补充 |
| 发现时间/抓拍时间 | 两个时间都带,便于判断时效 |
| 证据图 | 原图附件 ID 或受控 URL,至少 1 张 |
| VLM 输出 | 判定结果、evidence 文本、置信度、阈值 |
| 复核结论 | 复核人、复核时间、确认说明 |
| 建议动作 | 来自巡检项配置或复核人补充 |
| 幂等键/去重键 | 服务端生成,用于防重复建单 |
不携带处理人、派单班组、派单时间等派单字段。
5.3 防重复规则
- 去重键:
space_id + inspection_item_id + exception_type,默认 24 h 时间窗;同一键在窗内已有未闭环异常/工单时合并,不重复建单。 - 合并动作:增加重复次数、追加新证据图、更新最近发现时间;在队列和详情页提示「已合并至 EX-xxx / WO-xxx」。
- 已有记录已闭环:允许新建异常,标记「复发」并关联上一条异常/工单。
- 同一空间但巡检项不同、或同一相机但预置位不同:不合并。
- 并发/重试:复核提交带幂等键;服务端用唯一约束或事务 + 行锁校验,双击、网络重试返回同一工单,不产生重复单。
- 24 h 窗口是否可按巡检项配置,列入待确认;默认 24 h。
5.4 转单后状态回写
- 工单创建成功回写:工单 ID、工单类型、状态、处理人、闭环时间。
- 工单闭环:异常状态自动转「已闭环」,闭环方式记为「转工单闭环」。
- 工单取消/驳回:异常回退到「已确认」,保留原因并要求重新选择处置;不自动重建工单。
- 回写失败:显示「同步中/同步失败」,后台重试并对账;不允许人工直接把异常改成已闭环。
- 工单系统是处置状态的唯一事实源;O6 只做展示和状态映射。
- 指标口径:复核率 = 需人工复核的巡检项数 ÷ 已完成巡检项数;误报率 = 标记误报数 ÷ 视觉巡检报出异常数;有效异常数 = 复核确认异常数(含转工单/转现场);转工单数 = 实际创建的关联工单数。数字由巡检明细、异常、工单表统计,不由页面文案估算。
5.5 转人工现场
满足任一条件可转人工现场:
- 抓拍失败或图像质量不合格,需要重拍/现场确认;
- 证据不足、无法判定,不能仅凭图片下结论;
- 非设备故障类异常(保洁、秩序、布置),不适合直接转维修工单;
- 安全/消防隐患需要立即到场,可同时转现场并建紧急工单。
转人工现场的动作:在巡检模块生成「现场处置待办」,按现有班组值班/区域规则通知对应班组,记录目标班组、处置要求、时限;处理人回填结果后异常闭环。默认不创建工单;是否落为保洁/安保等工单,列入待确认。O6 不指定个人、不派单。
6. 系统内置能力与接口依赖
注:本节替代 Agent 场景 PRD 的 MCP/Skill 章节。O6 无 Skill、无 MCP、无 Agent 工具、无 Agent 权限装配;以下均为工单系统内部服务/接口。
| 能力 | 作用 | 关键要求 |
|---|---|---|
| 巡检完成事件订阅 | 接收 InspectionTaskCompleted / InspectionExceptionCreated,按入队规则生成复核记录 | 按 item_result_id 幂等;重复投递不重复入队;不新建调度 |
| 巡检明细读取 | 读取结果、置信度、evidence、抓拍质量、巡检说明快照、抓拍时间、相机/预置位/ROI | 只读;按异常 ID 或明细 ID 查询;字段缺失标「暂无」 |
| 证据图存储与访问 | 保存原图/缩略图,提供受控访问 | 私有对象存储;签名 URL 短时效;访问留日志;不暴露公网永久地址 |
| 工单创建接口 | 复核确认后创建报修/维修工单 | 入参含 §5.2 字段;带幂等键;返回工单 ID;权限校验;失败明确报错 |
| 工单状态回写 | 工单闭环/取消/驳回同步到异常状态 | 事件或回调;失败重试 + 对账;O6 不反向改工单 |
| 待办与消息 | 生成待复核、超时、现场处置待办 | 复用现有工单待办/站内消息;渠道以现网能力为准;不承诺新增外部推送 |
| 复核留痕 | 记录认领、复核、转单、回写、闭环全过程 | 只追加;业务侧不可改/删;关键字段可做哈希链/审计签名(实现待定) |
| 权限与区域范围 | 列表、详情、转单、导出统一鉴权 | 按空间树/区域授权;越权返回 403/404;证据图 URL 绑定用户会话 |
| 配置读取 | 读取 confidence_threshold、review_policy、超时、自复核开关、去重窗口 | 按巡检项/计划生效;变更需版本化并留痕 |
失败与并发处理:
| 场景 | 处理 |
|---|---|
| 事件重复投递 | 以 item_result_id 幂等,已存在则忽略或更新非关键字段 |
| 两人同时认领 | 乐观锁/版本号,仅一人成功,另一人提示已被认领 |
| 重复点击转单/网络重试 | 幂等键,返回同一工单 ID;不重复建单 |
| 工单创建失败 | 保持「已确认」,提示重试;不伪造成功、不自动降级为现场处置 |
| 证据图不可用 | 禁止「确认异常→转单」;只允许转现场或数据无效关闭 |
| 状态回写失败 | 显示同步状态并后台重试/对账;不手改异常状态 |
| 权限失效/跨区域 | 拒绝请求并记录审计;不返回其他区域数据 |
7. 权限与数据范围
注:本节是工单系统 RBAC + 区域数据范围,不是 Agent 能力装配。
| 角色 | 看复核队列 | 复核 | 转单 | 转人工现场 | 数据范围 | 说明 |
|---|---|---|---|---|---|---|
| 巡检执行人 | 仅本人任务/本人负责点位,只读 | 否 | 否 | 否 | 本人 | 可查看退回原因与复核状态 |
| 区域运维 | 本区域 | 是 | 是 | 是 | 本区域空间树 | 默认复核人 |
| 班组长/复核人 | 本班组区域 | 是 | 是 | 是 | 本班组 | 可处理超时升级件、可代复核 |
| 管理者 | 授权范围,只读 | 否 | 否 | 否 | 授权范围 | 只看统计与明细,不参与处置 |
| 运维主管 | 全部区域或授权全域 | 是(升级件) | 是 | 是 | 全域 | 处理升级、跨区域查看、导出;是否日常复核待确认 |
规则:
- 区域隔离:列表、详情、转单、导出、证据图访问全部按空间树/区域授权过滤;直接访问他区异常返回 403 或 404,不泄露记录是否存在。
- 自复核:默认禁止复核本人执行/本人抓拍的记录;班组长可代复核。若业务确需开启,按巡检计划配置开关,记录
self_review=true并在统计中单独标注;默认不建议。 - 证据图权限:签名 URL 绑定当前用户会话,短时效;默认不提供外链分享。是否允许下载/外发见 §9 待确认。
- 只读角色:管理者、巡检执行人不能执行确认/纠正/误报/转单;前端隐藏按钮,后端同步鉴权。
- 导出:仅运维主管/管理者可导出统计;证据图与个人信息按最小化原则处理。
8. 验收要点
| # | 验收项 | 标准 |
|---|---|---|
| 1 | 低置信度入队 | 置信度 low 或数值低于阈值时,自动进入待复核,入队原因显示「低置信度」 |
| 2 | 不符合入队 | result=不符合 自动进入待复核,不以「符合」误归档 |
| 3 | 无法判定/解析失败 | 进入待复核,显示「未判定」,不伪造「不符合」结论,不自动建单 |
| 4 | 抓拍失败不硬判 | 质量不合格记录不入正常判定,显示抓拍失败原因;只允许转现场/数据无效关闭 |
| 5 | 证据图可见可放大 | 原图可放大/缩放/拖拽,抓拍时间、相机、预置位、ROI 说明可见 |
| 6 | 置信度展示 | 显示 high/medium/low、数值(如有)、阈值及是否低于阈值 |
| 7 | 确认→转单成功 | 创建报修/维修工单成功,返回工单号,异常状态变「已转工单」,可跳转工单 |
| 8 | 转单字段完整 | 空间、对象、巡检项、证据图、置信度、发现时间、建议动作齐全 |
| 9 | 纠正→关联工单关闭 | 纠正为正常时,如存在关联工单,按工单规则关闭/撤销并留痕;异常转已闭环 |
| 10 | 误报→计入误报率 | 标记误报必须选原因;计入误报率,不计入有效异常 |
| 11 | 重复异常合并 | 同空间+同巡检项+同异常 24 h 内不重复建单,证据合并并提示已合并 |
| 12 | 复核留痕不可篡改 | 认领、复核、转单、回写、闭环全程可查;业务侧不能修改/删除 |
| 13 | 区域越权拦截 | 跨区域列表不可见,直接访问详情/转单被拒绝并审计 |
| 14 | 超时提醒与锁释放 | 4 h 未认领提醒、24 h 升级;30 min 无操作释放锁;提醒记录可查 |
| 15 | 并发与幂等 | 两人同时认领仅一人成功;重复点击/重试不重复建单 |
| 16 | 移动端可用 | 待办可打开,图片可缩放,操作可用,无横向溢出,覆盖加载/空/失败状态 |
9. 已确认与待确认
9.1 已确认
| # | 事项 | 结论 |
|---|---|---|
| 1 | O6 定位 | 工单系统内置功能,非 ReAct Agent 能力;不进入统一 Agent 架构 |
| 2 | 触发方式 | 巡检任务完成事件;无用户 query;O6 不创建巡检计划或调度 |
| 3 | 复核链路 | VLM 结果 → 入队 → 人工复核 → 确认/纠正/误报 → 转单/转现场 → 闭环 |
| 4 | 入口 | 复核队列、巡检工单详情、移动端待办;不做对话/悬浮球入口 |
| 5 | 证据与置信度 | 原图 + 抓拍信息 + ROI + VLM 输出 + 置信度 + 阈值 + 历史 |
| 6 | 隐私边界 | 只按巡检时刻抓拍;不连续录像;ROI 避人脸;不做人脸识别 |
| 7 | 转单 | 默认复用报修/维修工单,不新建独立类型;必须人工确认后才转单 |
| 8 | 派单 | 由工单系统既有规则负责,O6 不派单 |
| 9 | 防重 | 同空间+同巡检项+同异常 24 h 内合并,不重复建单 |
| 10 | 标准调整 | 不自动改巡检说明/参考图/阈值;复核反馈只形成建议 |
| 11 | Agent 边界 | Agent 不编排、不建单、不派单 |
9.2 待确认
- 转单目标工单类型:默认转报修还是维修?是否需要新建「巡检视觉异常」工单类型?建议复用现有报修/维修,不新建。
- 置信度阈值默认值与维护人:全局默认还是按巡检项配置?由谁设定、谁审批?建议按巡检项配置,默认 high ≥ 0.80、medium 0.50–0.80、low < 0.50,最终由运维与甲方确认。
- 复核时限与超时升级规则:4 h 提醒、24 h 升级是否合适?升级到班组长还是运维主管?是否需要二次升级?
- 是否允许自复核:默认不建议;如开启,按计划配置并标记
self_review,是否纳入正常复核率统计需确认。 - 证据图保存期限与隐私合规:保存 30/90/180 天?删除策略、告知与授权、人脸规避责任方由谁承担?
- 误报原因枚举:建议「抓拍角度/遮挡/光线/参考图不符/模型误判/标准不清/其他」,需甲方确认后再固化。
- 复核队列与巡检日报联动:日报中的待复核/已复核/误报数是实时取队列还是取当日快照?由 O8 还是统计模块负责?
- 转人工现场是否落单:只生成现场处置待办,还是同时创建保洁/安保等工单?需与工单产品经理确认。
- 批量操作:是否允许批量认领/批量转单?默认只做单条,避免误操作;如需要,限定同空间+同巡检项。
- 证据图下载/外发:是否允许下载、加水印、审批后外发?默认不允许外链分享。
- 纠正与误报的统计口径:建议「原不符合→现场正常」计误报,「原无法判定/低置信度→现场正常」计纠正不计误报;需与 05 指标口径最终对齐。
- 工单取消/驳回后的回退:回退到「已确认」还是「待复核」?建议回「已确认」并要求重新选择处置,不自动重建。
10. 关联文档
| 文档 | 章节 | 引用内容 |
|---|---|---|
04_AI智能巡检-视觉巡检与日报.md | §5.2、§5.3、§5.4、§5.5、§5.6、§7 | 巡检项配置、巡检说明 prompt、抓拍判定流程、异常与工单、反馈闭环、数据模型 |
05_巡检任务完成情况统计.md | §2、§4.2、§6 | 误报率/复核率/有效异常/转工单口径、异常处置漏斗、数据模型与工单衔接 |
08_移动端AI场景设计.md | §6、§10 O6 行、§11、§12 | 运维时间线与 O6 原始定义、视觉巡检兜底、隐私与角色分流 |
公共规范.md | §5、§6 | 数据规范、输出规范(本文只取数据与呈现口径) |
T1-到校前简报.md | 全文 | 仅参考章节粒度与表格写法,不套用其 Agent 结构 |
space-agent/.../FA_一键诊断_前端PRD.md | §1、§2.5、§3、§4 | 仅借鉴入口、低置信度提示、异常状态、反馈留痕的交互话术 |
space-agent/.../AI工单_6月一键工单方案.md | 工单模板、防重、状态流转相关段落 | 仅借鉴工单防重与状态流转,不借鉴其 Agent 编排 |