主图进入转码前检时用户通常希望尽快把它放进“可以继续”或“需要处理”的桶里。但字段读取不是转码结果预览看起来正常也不是质量结论。如果页面把“已读取”直接显示成“可转码”用户会在最早的检查阶段就失去人工判断机会。这次工程为每个直播封面保留待检查、需复核、已读取三种本地状态并展示WebPMetadata的原始字段、读取阶段和错误边界。它的作用是把下一步需要人工看的信息摆出来而不是代替转码器、发布系统或素材负责人作决定。一、转码前分流最怕把“读到了”看成“可以继续”1.1 “已读取”只表示一次本机调用完成页面中的“已读取”来自当前选中样本调用readImageMetadataByType()后的本地状态更新。它说明页面完成了读取尝试并把当前设备返回的字段展示出来不说明转码参数已经生成也不说明输出文件会符合发布要求。用户在看到“已读取”时应先检查字段是否完整、错误区是否为空、样本是不是当前要分流的主图再决定是否需要复核。把状态词留在“已读取”比直接贴“可转码”更能阻止过早放行。1.2 分流依据必须能回到字段与样本用户把素材送进人工复核前至少应能回看文件名、直播间或素材来源、样本类型、资源大小、字段状态和错误信息。只留下一个绿色或黄色标签下一位处理者无法知道这个标签基于什么。这也是“需复核”存在的意义它把判断从一个看似确定的桶里拉回可核对的原始事实不让预览效果、历史印象或默认值偷偷成为分流依据。二、字段标签应怎样服务人工而不是替人工决定2.1 五个字段显示的是读取事实工程读取WEBP_METADATA后展示 Canvas 宽高、帧延迟、未限制帧延迟和循环次数并计算已返回字段数量constwebpmetadata.webPMetadata;this.canvasWidththis.valueText(webp?.canvasWidth);this.canvasHeightthis.valueText(webp?.canvasHeight);this.delayTimethis.valueText(webp?.delayTime);this.unclampedDelayTimethis.valueText(webp?.unclampedDelayTime);this.loopCountthis.valueText(webp?.loopCount);this.fieldSummarywebpundefined?WEBP 元数据对象为空:已返回字段${provided}/5;这段代码能证明页面如何显示当前读取到的字段和数量。它不能证明这些字段满足某个转码规则也不能替用户给主图贴上“合格”“不合格”的标签。用户可以依据字段发现需要继续看的地方但应把“选择什么转码方案”留给有明确业务规则的人而不是由N/5自动回答。2.2 预览区只能帮助确认对象不承担字段判断页面可展开预览帮助用户确认眼前是不是那张主图。但预览区不会补全WEBP_METADATA也不会生成转码输出。即使画面显示正常缺失字段仍然是缺失字段即使画面看起来异常也不能仅凭预览把读取结果改成失败。把预览与字段表并排而不是互相替代能让用户在分流前同时确认“我看的对象是谁”和“当前系统真实返回了什么”。三、什么时候应停在“需复核”而不是自动归类3.1 字段不完整或对象为空时先保留未知当webPMetadata为空页面明确显示“WEBP 元数据对象为空”字段未提供时单项仍保留“未提供”。这些状态的正确出口是“需复核”而不是把空值替换为默认参数后继续转码。这样做不会让流程停死。用户仍然可以保留样本、读取阶段和错误信息交由人工决定是否补充样本、重试读取或采用其他已批准的处理方式。3.2 读取失败时不要把异常塞进“已读取”调用失败时页面把状态改为“样本读取失败”“读取调用失败”并保留具体错误信息。错误信息说明本轮读取没有得到可用字段它不能直接说明文件损坏、不能转码或已被拒绝。“已读取”“需复核”“读取失败”应保持不同的动作出口前者进入字段核对第二种进入人工判断第三种先处理读取条件。把三者合并为一类后续分流只会越来越难追溯。四、提交人工复核前页面应该交代什么人工复核不是只转发一张预览图。至少应同时带上当前样本标识、素材类型、资源大小、五个字段的原始展示值、字段汇总、读取阶段、错误边界以及“本次仅做本机读取”的限制。工程的“批量生成本机检查记录”只会生成当前可见素材的本机检查草稿代码明确没有调用转码、发布、服务端接口或外部队列。它可以帮助人工整理信息不能把草稿名称写成“已完成转码记录”。五、分流入口与真正的转码结果要分开保存从检查页进入“需复核”只表示用户把当前事实交给下一步判断它不生成新文件、不替换主图也不改变发布状态。真正的转码结果至少需要有输出文件、对应任务状态和业务系统记录当前页面都没有实现。对产品体验而言这种克制并不是多一道卡点。用户知道“我已把问题交给谁”和“我没有完成什么”才能在等待期间继续处理其他主图而不会把一个本机字段状态当成最终结果。必要条件运行门禁G1SDK/API门禁确认 HarmonyOS 6.1.1 API 24 已安装Hvigor 能构建entry模块。G2Kit门禁确认本文页面的 Kit import 可解析并使用 API 24 支持的接口。G3模块/页面门禁确认 Stage 模块、页面路由、设备类型和相关模块配置完整。G4权限门禁确认静态声明存在Camera/AI字幕等运行时能力在真正调用前完成动态授权。G5系统能力门禁确认目标设备声明并实际提供所需摄像头、麦克风、地图、视觉或文件能力。任一门禁未通过停止进入核心操作。MapKit文章在 G5 放行前增加服务配置门禁AppGallery Connect 中已选择正确项目应用包名和签名证书与工程一致MapKit 服务已开通且应用服务凭据/授权配置已完成。不得在文章或源码中暴露服务密钥。