质检结果技能
概述
本技能用于处理用户提供的维修单 Excel 表格内容，并结合用户输入的提示词，对表格中的图片地址、文件地址、视频地址等素材进行质检，最终输出一份带异常标注和颜色高亮的 质检结果 Excel。
适用场景：
- 维修单、售后单、巡检单、安装单等包含多媒体素材的 Excel 表格质检
- 检查签字照片、故障点照片、序列码照片、附件文件、故障视频等是否重复、空白、不清晰或与工单内容不一致
- 在大批量数据处理中持续执行，并在中断后自动续跑
输入
用户通常会提供：
1. 一份 Excel 文件内容或 Excel 文件路径
2. 一段提示词，说明当前质检规则、工单字段含义或特殊判断口径
3. 可能涉及的字段包括但不限于：
- 工单号 / 服务单号 / 维修单号
- 客户信息 / 产品信息 / 产品型号 / 产品序列码
- 故障描述 / 维修描述 / 服务内容
- 图片 URL / 文件 URL / 视频 URL
- 多个 URL 混合在同一个单元格中的情况
核心目标
必须同时满足以下要求：
- 输出一份质检结果 Excel，名称为：
用户原始表格名称 + 质检结果 - 输出表格必须保留原始维修单的：
- 行数不变
- 原始列内容不变
- 原始记录顺序不变 - 新增
异常标注列，用于写明该行发现的异常 - 若单元格中存在多个 URL，必须先拆分为多个可访问 URL，再写入新增列或展开列中，便于后续核验
- 不能只比较 URL 文本是否重复，还要比较：
- 图片内容是否重复
- 视频内容是否重复
- 文件内容是否重复或明显指向同一素材
- 素材内容与工单描述、产品信息、序列码信息是否一致 - 执行过程中不能因单条异常而整体中断；如果被打断，必须能够从上次进度自动续跑
输出
1. 主输出文件
输出一份 Excel 文件：
- 文件名：<原始表格名称>质检结果.xlsx
- 行数与原表一致
- 原始字段保留不变
- 新增用于质检的字段，例如：
- 异常标注
- URL拆分结果
- 图片核验结果
- 视频核验结果
- 文件核验结果
- 重复比对结果
> 注意：新增列名可以根据实际字段结构调整，但必须至少包含 异常标注 这一列。
2. 行颜色标注规则
对存在异常的整行进行背景色标记，颜色必须清晰区分：
- 红色背景：重复异常
- 例如相同图片、相同视频、相同文件，或内容高度一致且判定为重复
- 黄色背景：素材与工单不一致
- 例如图片内容、文件内容、视频内容与工单描述、产品、序列码或服务场景明显不匹配
- 橙色背景：图片空白、模糊、不清晰、无法辨认关键信息
- 例如签字看不清、故障点无法辨认、序列码无法识别、画面严重过曝/欠曝
- 其它较深颜色：其它异常
- 例如 URL 无法访问、文件损坏、格式不支持、关键素材缺失、字段异常、无法完成判定等
3. 异常标注要求
异常标注 列必须尽量具体，不可只写“异常”。
正确示例：
- 重复：与工单 SO20260605018 的故障视频内容重复
- 不一致：序列码照片识别为 SN-AX9321，与工单序列码 SN-AX9381 不一致
- 图片不清晰：签字照片存在严重模糊，无法识别签名
- 其它异常：附件 URL 无法访问，返回 403
执行流程
步骤 1：识别输入结构
- 读取用户提供的 Excel
- 识别表头与字段语义
- 找出与质检相关的列：
- 工单唯一标识列
- 产品/设备/序列码列
- 故障描述列
- 图片列
- 视频列
- 文件列 - 如果用户提示词中给出了重点核验规则，优先遵循用户规则
步骤 2：预处理 URL
对每一行执行以下动作：
- 检查单元格中是否包含多个 URL
- 支持常见分隔形式：
- 换行
- 空格
- 逗号 / 中文逗号
- 分号 / 中文分号
- 竖线 - 从混合文本中提取可访问 URL
- 将拆分结果写入新增列，必要时展开为：
-图片URL_1、图片URL_2
-视频URL_1、视频URL_2
-文件URL_1、文件URL_2 - 原始单元格内容不得覆盖或删除
步骤 3：素材可用性检查
逐条检查拆分后的 URL：
- URL 是否为空
- URL 是否可访问
- 返回内容类型是否与预期匹配：
- 图片 URL 应返回图片
- 视频 URL 应返回视频
- 文件 URL 应返回可识别文件 - 是否存在：
- 403 / 404 / 5xx
- 超时
- 重定向异常
- 文件损坏 - 可用性异常归类为“其它异常”或按实际情况归类
步骤 4：内容级重复检测
严禁只做 URL 文本去重
必须进行内容级比较：
- 图片重复检测
- 比较感知哈希、视觉特征、截图内容、主要主体是否一致
- 即使 URL 不同，只要图片内容相同或高度相似，也应判定为重复候选 - 视频重复检测
- 抽取关键帧或视频指纹进行比较
- 即使视频链接不同，只要内容一致或高度相似，也应判定为重复候选 - 文件重复检测
- 比较文件哈希、文件名、页内容、提取文本、截图预览或元数据
- 防止“换链接不换内容”的重复提交 - 记录重复关系：
- 当前行与哪一行重复
- 当前工单与哪个工单重复
- 重复的是哪类素材
重复异常输出要求
发现重复后，在 异常标注 中明确写出：
- 重复类型
- 重复对象
- 对应工单号或行号
例如：
- 重复：故障图片与第 182 行工单 WD20260528091 的图片内容重复
步骤 5：工单与素材一致性检查
对每一行素材进行语义和内容核验，不能只看文件名。
重点核验内容
- 签字照片
- 是否确实为签字/签收场景
- 是否为空白纸张、无签名、严重模糊 - 故障点照片
- 是否包含故障部位
- 是否与故障描述一致
- 是否为无关图片 - 序列码照片
- 是否包含序列码/铭牌
- 可识别出的序列码是否与工单字段一致 - 故障视频
- 是否展示故障现象
- 与故障描述是否匹配
- 是否为无效视频、黑屏、无关场景 - 附件文件
- 内容是否与工单或维修场景相关
- 是否属于错误上传、错单上传或无关文件
不一致判定
以下情况应标记为黄色背景：
- 图片、视频、文件内容与工单描述明显不符
- 产品型号、序列码、设备标签与工单记录不一致
- 实际素材属于别的工单、别的产品或别的故障场景
步骤 6：图像质量检查
对于图片类素材，重点识别以下异常：
- 空白图
- 纯色图
- 黑图 / 白图
- 严重模糊
- 过曝 / 欠曝
- 分辨率过低
- 关键区域不可识别
若属于上述情况，优先标记为橙色背景，并在 异常标注 中明确说明是：
- 签字不清晰
- 故障点看不清
- 序列码无法识别
- 图片疑似空白
步骤 7：异常归类与写回
每行可同时存在多个异常，应按以下原则写入：
异常标注允许写入多个结论，用分号分隔- 若同一行有多个异常，颜色以“最高优先级异常”决定，可采用以下优先级：
- 红色（重复）
- 黄色（不一致）
- 橙色（空白/模糊/不清晰）
- 其它深色（其它异常） - 异常描述必须尽量具体，并引用：
- 工单号
- 行号
- 素材类型
- 判定依据
步骤 8：断点续跑与稳健执行
执行过程中必须保证不中断，即使遇到异常素材也要继续处理剩余记录。
必须实现的续跑机制
- 为每一行记录处理状态，例如：
-待处理
-处理中
-已完成
-处理失败 - 在本地持久化进度信息，例如保存：
- 已完成的行号
- 每行中间结果
- URL 下载缓存
- 内容指纹缓存 - 如果执行中断，再次启动时必须：
- 读取历史进度
- 跳过已完成行
- 从未完成行继续 - 不得因为单行失败而导致整批任务停止
- 对失败行保留失败原因，并在最终结果中写入“其它异常”说明
建议实现策略
数据处理建议
- 先复制原表，基于副本追加质检列
- 为每行分配稳定唯一键（优先工单号，其次行号）
- 将 URL 解析、下载、内容提取、重复检测、结果写回拆成独立阶段
重复检测建议
- URL 级：用于快速初筛
- 文件哈希级：识别字节完全一致
- 内容感知级：识别转码、压缩、换链接后的重复素材
- 语义级：识别素材内容是否与工单业务描述一致
容错建议
- 对网络请求设置超时、重试和失败记录
- 对无法识别的文件类型归入“其它异常”
- 对 OCR / 图像识别 / 视频抽帧失败保留错误上下文
最终交付要求
完成技能时，最终产物必须满足：
- 在
skills/quality-inspection-result/下输出技能文件SKILL.md - 技能描述必须覆盖：
- Excel 输入
- 多 URL 拆分
- 图片/视频/文件内容级比对
- 与工单内容一致性检查
- 颜色标记规则
-异常标注列要求
- 断点续跑机制 - 当该技能被调用执行时，默认目标是生成：
- 一份行数不变的质检结果Excel
- 清晰可读、可追溯的异常说明
- 可恢复的处理进度
执行时的硬性要求
- 不要删除原始数据列
- 不要修改原始记录顺序
- 不要只按 URL 字符串判断重复
- 不要在发现异常后提前停止
- 不要输出模糊结论，如“可能有问题”而不给出原因
- 必须优先保证结果可追溯、可复核、可续跑
