现场标签识别入口的端侧工程：相机元数据识别、标识规范化与登记册查找的收敛

一、识别是合规链的第一道动作

配电间在地下二层，港口的堆场在港区外侧，共同点是手机没有信号。工程师站在设备前，手上唯一的依据是贴在那台机器上的标签，以及手机里那份不联网的台账。要把这两样对上，第一步动作不是测量，是识别。

识别的职责可以概括成一句：把”贴在那台机器上的那串字符”变成”本机台账里的那一条记录”。这句话里有三个动作——采集，把一维条码或二维符号读成一段文本；规范化，把这段文本折算成可以比较的身份键；查找，拿身份键在本机登记册里定位记录。每一步都有可核查的实现细节，也都有边界。

密旋科技的两款端侧工具各有一处识别入口。TagWorks 面向便携式电气设备的法定安全检测，按 AS/NZS 3760 组织检测记录与再检测周期[1]；SlingGuard 面向起重吊索具的现场核验，对标英国起重作业法规与美国吊索具规则[2][3]。两处入口都长成一个取景框的样子，但把源码读下来，实现并不相同，这份差异比相似更值得写。

二、两条通道的静态对照

把取景框拆开看，要回答的是一组具体问题：有没有真的打开相机、允许哪些符号、暗光怎么办、读到的字符串往哪里去、没读到或没查到时界面说什么。

其中最容易被忽略的一行是”采集会话”。左侧是真正的图像采集：设备输入、元数据输出、会话的开始与停止；右侧没有。写清楚这点不是为了比优劣，而是因为失败模式完全不同——相机通道会失败在权限、光线、符号质量与设备能力上，登记册通道会失败在”这个编号还没有被录入过”。同一个取景框外观，背后是两种责任。

三、真机采集会话：从授权三态到首读即停

TagWorks 的采集实现集中在一个一百多行的扫描视图文件里，界面与会话对象分居两半。会话对象在初始化时先处理授权，按系统给出的三态分派：已授权直接进入配置；尚未询问就发起一次访问请求，回调回到主队列后再分流；其余情况，被拒绝或被限制，标记为拒绝状态。这一处分派把”没有权限”处理成一个正常状态，而不是错误。

界面为拒绝状态准备了出口：一块不可用说明区域，写明需要到系统设置里授予相机权限才能扫描标签。被拒时用户看到的是解释与去向，不是空白页。这是端侧应用的一条底线——没有服务端帮你做降级判断，所有降级路径都在本机代码里，写没写决定用户能不能继续干活。

配置阶段按四步搭起会话：取默认视频设备、构造输入对象、在加入前确认会话能接受这个输入、再加一个元数据输出。输出把委托指定在主队列上，因为回调要直接改界面状态。

真正体现工程经验的是符号类型那一小段：它没有一次性写入三种类型，而是先读设备当前可用的元数据类型集合，再逐个判断是否包含，包含才追加。二维码是自家打印的标签载荷，Code 128 是常见的资产编号条码，EAN-13 是厂商产品条码。先探测再赋值，把设备能力差异挡在配置阶段：在不支持某类型的设备上强写该类型，会让整场会话配置失败。会话开始的动作放到后台队列执行，因为它是阻塞调用，在主线程上调用会卡住界面。

委托回调很短：取这一帧里的第一条机器可读码对象，读出字符串取值，写进发布属性，随即停止会话。这就建立了首读即停的一次性采集语义：同一张码在一个会话里只触发一次，去抖靠会话生命周期而不是计时器。代价同样明确——连续扫十件设备需要十次进入取景，批量提速靠的是另一条处理共享表单的通道。

读到值之后，界面监听到状态变化，动作是规范化、给一次成功触觉、关闭取景页。成功反馈用的触觉封装在整个仓库里只有一个定义，就在这个扫描视图文件里：识别成功是它唯一的原始用途，其它界面若要复用，得回头引用扫描视图。这类耦合解释了为什么一个取景框承担了比”读一个码”更多的职责。

暗光补偿是一只按钮：先确认设备存在且带手电，锁定配置后翻转手电模式，再解锁。没有手电的设备上点了没有效果，锁定失败时静默返回。这是可核查的边界——应用无法确认灯是否真的亮起，也无从判断现场光照是否够用。

权限文案是另一处要写实的边界：工程配置里的相机用途写的是”在检测过程中拍摄设备与标签”，扫描复用同一条授权，并没有单独的扫码用途说明。系统层面并无问题，但这里存在一层口径错位——用户以为你在拍照，你其实在读码。把这层错位写进设计文档，后续做隐私说明与审核材料时才不会自相矛盾。

四、一条没有采集会话的识别入口

SlingGuard 的入口在源码里叫二维码扫描视图，文件里只有界面框架的导入：没有相机框架、没有采集输入输出、没有会话，也没有相机权限声明。它呈现的是一个深色圆角取景框、一组取景角标、一个取景符号和一条横向渐变光带。光带是静态装饰，不做动画，也不与任何识别状态联动。

真正的输入面在取景框下面。上面一块是横向滚动的已登记编号，取登记册里的前六枚，每枚是带小图标的胶囊按钮，点一下就用这个编号去查找。下面一块是手工输入行：等宽字体的输入框，启用全大写输入，右侧一个查找按钮。两块共用同一个处理函数，函数只做两件事——去掉首尾空格、转成大写，再在本机登记册里找第一条编号相同的资产。找到就回调并关闭页面，找不到显示一句提示，原文是 No equipment registered under Tag ID 加上编号，语义是登记册里没有这条编号。

这句措辞值得记录：它说的是”这条编号没有登记”，而不是”扫不到”。把失败归因放在登记册而不是识别上，与实际行为一致。相较之下，TagWorks 未命中时不报错，而是把规范化后的编号带进新建资产表单预填，让工程师就地补录；若存量已达免费档容量上限，则转入付费说明页。同一个”没找到”，两种下一步：一个补录，一个提示。

还有一处未接上的线：这个视图声明了一个表示”正在扫描”的状态变量，通读全文件没有任何引用。取景框看起来像在扫描，代码里却没有”扫描中”这个状态。它不影响行为，但提醒一件事——界面呈现的语义与代码里真正存在的语义可能并不一致，审查这类入口，读源码比看截图可靠。

五、规范化：从原始字符串到身份键

相机给出的是一段原始字符串，内容取决于贴上去的是什么码。TagWorks 的自印标签载荷是竖线分隔的键值序列，依次是固定前缀、编号、设备名称、设备等级、检测日期、下次检测日期与结论；生成端按这个顺序拼装，扫描端按同一个约定解析。

规范化函数的逻辑只有四步：去掉首尾空白与换行；判断是否以固定前缀开头，不是就原样返回；按竖线切分并保留空字段，跳过第一段，找第一个以编号字段名开头的部分；取标记之后的内容再去一次首尾空白，为空则回落整串。

第二步最要紧，它是一道分界。厂商条码、仓库商品条码被读到之后，因为不带自家前缀，会被原样当作标识带进表单。也就是说，“自产标签”与”外来码”的区别不是靠符号类型划的，而是靠前缀划的——符号类型只决定能不能读出来，前缀才决定读出来算不算数。这个次序是有意为之：若先用符号类型过滤，EAN-13 会被整体丢弃，而现场确实存在只贴厂商条码的老设备，那时工程师需要的是”读进来再人工确认”。

有一处口径必须写清：规范化只去空白，不做大小写折叠，同一个编号写成大写与小写，会被当成两个身份键。SlingGuard 则有三处转大写——手工新增落库、批量导入、查找时两侧比较，因此它大小写不敏感。两款口径不同而各自自洽：TagWorks 的编号由自家标签生成器产出，写法可控；SlingGuard 的编号可能来自旧纸质台账与外部工单，要求严格相等，就会出现”贴着同一个编号却查不到”。

六、判重闸门与那条绕过闸门的路径

判重是身份键真正开始起作用的地方。TagWorks 的新建表单在提交时先把输入规范化，再查登记册是否已有同编号资产，查到就提示该编号已分配给某台设备、建议查看已有资产，随后放弃这次写入；存储层的添加函数内部再做一次同样的判断，命中就返回失败。界面与存储两层都拦，是这个功能看起来稳的原因。

登记册查找函数有一个容易忽视的写法：传入的编号与库中已存记录的编号各自经过一次规范化再比较。库里若存了解包前的整串载荷或带空白的编号，新输入规范化后相等仍能命中。凡把规范化只做在入口一处的实现，都会在数据里留下一批匹配不上的旧值。

唯一的绕行路径在批量导入。导入视图解析完文件之后调用的是批量追加接口，而它只做一件事——把数组接到现有资产之后并触发一次落盘刷新，不规范化，也不与现有台账判重。导入器自己确实做了两件事，但目标都不是判重：把字段裁剪空白，以及对同一份文件内重复出现的编号加序号后缀改名。它保证的是”这份文件内部不重号”，而不是”与本机已有台账不重号”。

由此有两条边界必须写清。第一，文件内部重号会被改名，而与本机已有记录重号的条目照落不误。第二，导入的行不经过载荷解包，若某一行误填了整串标签载荷，或者把编号写成了另一种大小写，生成的身份键就与扫码路径分叉，同一台设备会在台账里出现两条记录，检测历史与到期时间从此各算各的。这类后果不会当场报错，往往在几个月后的复检清单里才显形：一台设备被列出两次，一次已到期、一次还早。现场处置有三条：接管存量台账时把编号列改成与自印标签一致的写法；导入前先导出本机台账做差集核对；对已出现的重复用查找入口逐条确认后删除多余记录。

SlingGuard 侧的分工正好相反：批量导入在写入前会检查登记册里是否已有同一编号，命中就跳过并计数；而手工新增那条路直接插入数组，不做任何判重。结果是同一个编号可以并存多条，查找取的是数组里第一条命中。风险是处置可能落到另一条记录上，而记录级的检验员署名会把这个偏差留在证据链里，由人工核对而不是由存储层拦截。

七、端侧边界与隐私面

识别结果去了哪里，这是离线工具与联网工具最本质的分界。TagWorks 的识别结果进入本机登记册快照对象，整体快照加原子写入盘；SlingGuard 的查找结果指向本机索具存储里的资产对象。两条通道的识别与查找环节都没有网络调用，没有云端码库比对，也没有第三方校验服务。

相机权限是这条链路唯一的外部能力，被拒绝不是异常，而是有出口的状态。代价同样明确：没有云端，就没有跨设备的编号唯一性保障，同一批设备若由两位工程师各自录入，重复只能靠事后核对发现。

近七日内入库的共享情报里，教育领域与政务系统的商用密码应用安全性评估、国产化适配与等级保护测评采购占据明显比例，这类采购的共同点是把数据边界与合规要求前置为验收条件。对端侧工具来说，识别入口是数据产生的第一站：能不出设备的部分，从一开始就不出门。

演示路径的纪律也要写明。TagWorks 用两个启动参数开启模拟取景与固定扫码载荷：参数存在时，以纯色填充替代视频预览并注入一段预设字符串，原因是模拟器与录屏环境下视频预览无法呈现画面。这段代码只在启动参数存在时生效，生产构建路径不可达，注释里也写明不用于生产。SlingGuard 的快捷标签入口性质不同，它是长期存在的人工兜底通道，用于标签不可读时定位记录。两者外观相似，性质不同。

八、这套识别设计的能力边界

能够做到的：读到的编号只在本机比较与本机落盘；识别成功后立刻给出触觉反馈，首读即停保证同一张码不会被算成两次；未命中不是死路，一个转入预填编号的新建表单，一个明确提示登记册无此编号；新建路径的判重由界面与存储两层拦截；规范化把自产标签与外来码分开，让老设备的厂商条码也能被读进来再人工确认。

做不到的至少有六条。第一，读码成功不等于资产归属确认，标签可以换贴、复用或被另一张盖住，识别只证明”这串字符现在贴在这里”。第二，没有云端码库与在线校验，编号的真伪由现场制度保证，工具只负责字符串比较。第三，二维码的纠错码与 Code 128 的校验位都只能发现符号层面的损伤，它们都不回答”这段字符串是不是本台账里的编号”。第四，首读即停决定了连续扫多件要逐个进入，批量提速要靠另一条通道。第五，手电与授权失败都不在本机自检范围内。第六，两款产品的规范化口径不同，一侧大小写敏感、一侧不敏感，跨产品的台账不能直接合并，合并前必须先统一口径。

九、结语

识别入口的工程价值不在识别本身，而在它决定了身份键从哪里来、与谁对齐、由谁兜底。三条入口收敛到一个身份键，是本机台账能够自洽的前提；把绕过判重闸门的那条批量路径写清楚，比声称流程处处可控更接近现场事实。密旋科技的两款端侧工具把这条链路完整放在设备本地：识别在本机完成，归一本机完成，查找与判重在本机完成，全程不经云端。它给出的答案有明确上限——在既没有网络也请不到第二位同事确认的现场，工程师手上的设备仍能把他与那台实物之间的那条记录对上，并且知道这条对上意味着什么、不意味着什么。

参考文献

[1] Standards New Zealand. AS/NZS 3760:2022 In-service safety inspection and testing of electrical equipment and RCDs. https://www.standards.govt.nz/shop/asnzs-37602022

[2] UK Legislation. The Lifting Operations and Lifting Equipment Regulations 1998. https://www.legislation.gov.uk/uksi/1998/2307/contents/made

[3] U.S. Occupational Safety and Health Administration. 29 CFR 1910.184 — Slings. https://www.ecfr.gov/current/title-29/subtitle-B/chapter-XVII/part-1910/subpart-N/section-1910.184

[4] ISO/IEC 18004:2024. Information technology — Automatic identification and data capture techniques — QR code bar code symbology specification. https://www.iso.org/standard/83389.html

[5] ISO/IEC 15417:2007. Information technology — Automatic identification and data capture techniques — Code 128 bar code symbology specification. https://www.iso.org/standard/43896.html

[6] Apple Developer Documentation. AVCaptureMetadataOutput — Reading machine-readable codes from video. https://developer.apple.com/documentation/avfoundation/avcapturemetadataoutput

[7] Apple Developer Documentation. AVMetadataObject.ObjectType — Machine-readable code types. https://developer.apple.com/documentation/avfoundation/avmetadataobject/objecttype

[8] Apple Developer Documentation. Requesting authorization to capture and save media. https://developer.apple.com/documentation/avfoundation/requesting-authorization-to-capture-and-save-media