Offline Standards Handbook Reference Data Versioning — Technical Analysis | KeyRotate Technology

一、现场没有网络，判据只能随包带走

先说一个具体的现场。地下室的配电间里，一名检测工程人员要把墙上那批移动电动工具逐台过一遍：插头是否有烧蚀、软线是否有压伤、保护接地连续性是否还在界限以内。地下室没有蜂窝信号；即使有，也很难让人站在配电箱前打开浏览器，去翻一份几百页的标准。

于是判断“合格还是不合格”所依赖的那组数字，必须已经在设备里。这就是端侧标准速查手册存在的理由。密旋科技的 TagWorks 在设置页放了一份“AS/NZS 3760 与 BS EN 50693 手册”，SlingGuard 在设置页放了一份“吊装安全与报废手册”。两者的位置相同、形态相同：随应用包一起发布、离线可读、只读。

需要先把一件容易混淆的事说清楚：手册不是记录，也不是证据。它是参考数据——是判定一台设备时所使用的阈值与规则的速查来源。记录回答的是“某年某月某日对某台设备做了什么、结果是什么”；手册回答的是“做这个判断时，标准里写的界限是多少”。两者住在同一个应用里，却处在完全不同的层。本文后面几节的取舍，几乎都从这个区分里长出来。

二、手册里放的究竟是什么

按 TagWorks 与 SlingGuard 的实际实现，一份端侧手册通常由四类内容构成：阈值速查、周期表、目视清单与法定框架摘要。它们都不是叙述性文字，而是被压缩成可现场扫读的条目。

以电气侧为例，保护接地连续性的界限被直接写成“Class I 类软线式器具不超过 1.0 欧（插头与插座的接触电阻约按 0.1 欧、软线按约每米 0.02 欧另计）”；绝缘电阻按“Class I 与 Class II 不低于 1.0 兆欧、发热元件与矿物绝缘不低于 0.1 兆欧、浪涌保护与 IT 类软线在 250 伏直流下不低于 1.0 兆欧”分档；接触泄漏电流按“Class I 不超过 5.0 毫安、Class II 不超过 1.0 毫安”；剩余电流装置的动作时间按“Type I（10 毫安）不超过 40 毫秒、Type II（30 毫安）不超过 300 毫秒”。周期表则是一张按环境分档的间隔表：建筑与拆除工地三个月、工厂与车间六个月、办公室中受反复弯折的软线十二个月、办公室内固定且不受力的设备五年、租赁设备三个月并另加每次交付前的目视与功能检查。

吊装侧的手册形态略有不同：合成纤维吊带的报废判据按“标签缺失或不清晰、酸碱灼伤、熔融或焊渣烧穿、破口露出承载芯纱、缝合线断裂、打结、紫外老化发硬褪色”逐条列出；合金链条按“链环伸长超过百分之五、链径磨损超过百分之十、横向裂纹或电弧打击凹坑、扭曲或弯折、Grade 80 在四百摄氏度以上的热损伤”列出；钢丝绳按“一个捻距内的随机分布断丝数、扭结或狗腿、鸟笼状鼓包、绳芯外露、端部套压件开裂”列出；结索与夹角则给出水平夹角与折减系数的对应关系。

这张表里最容易被读错的是最后一列的措辞。手册里的每一项都不是“结论”，而是“输入”。把这一列读错，后面所有的工程线都会跟着错。

三、单一真相源：展示层与判定层必须是同一组常量

手册里写着“接地连续性不超过 1.0 欧”，判定函数里也有一个上限常量。如果这两处是两份各自维护的数字，就会出现一种非常具体、也非常难查的故障：手册显示合格，判定却给出不合格，或者反过来。现场人员看到哪一个都不对——他把哪一个当真，都可能误放行一台有缺陷的设备，或者把一台好设备错误地停用。

TagWorks 的做法是不给第二个真相源留位置。判定逻辑被收拢在一个纯函数里，输入是接地电阻的毫欧值与绝缘电阻的兆欧值，输出是三态结论（合格、不合格、未测量），阈值全部来自同一组常量。手册里的交互计算器不自己写一套比较逻辑，它直接调用这个纯函数，把使用者输入的两个读数交进去，再按返回的三态结论渲染提示。换句话说，“手册上印的那个数字”和“判定用的那个数字”在代码里是同一个常量：改一次，两处同时变；漏改一次的可能性被结构性地消掉。

$t_{\mathrm{verdict}} = f_{\mathrm{pure}}(v_{\mathrm{reading}};\ \Theta_{\mathrm{edition}})$

其中 $\Theta_{\mathrm{edition}}$ 是某一版标准下的阈值常量集。这个式子的读法很朴素：结论由读数与阈值共同决定；手册负责把阈值讲清楚，判定负责把函数执行正确，两者不能各说一套。

这条例子的意义不止于少写重复代码。在离线产品里，手册是现场唯一的判据来源；一份与判定漂移的手册，等于给使用者递了一份会误导人的资料。

四、版本戳：标准是活文档

标准不是刻在石头上的。AS/NZS 3760 在 2012 版之后换到了 2022 版，阈值与间隔都可能随之调整。国内也处在相近的节奏里：本季度集中发布的一批量子核心器件国家标准就是例子——其中一项的发布日期是 2026 年 9 月 28 日，而实施日期排在 2027 年 4 月 1 日。发布日期与实施日期被刻意分开，中间留出一段过渡窗口，让产业界有时间调整试验方法、标签与流程。这是标准这类文件的常态，不是例外。

对端侧手册而言，这意味着三件事。

第一，阈值必须带版本戳。手册里写的“1.0 欧”是哪一版标准下的 1.0 欧，要被明确标注；否则同一份手册在两版标准之间就失去了可解释性。TagWorks 在设置页的版本条目里直接写明“检测间隔依据 AS/NZS 3760:2022”，并把“始终以你所在辖区适用的标准为准”放在同一条里，这就是版本戳的可见形态。

第二，报告与记录要写明判定所用的阈值版本。一份几年前的合格记录，其“合格”是在当年的阈值下成立，而不是在今天的阈值下成立。如果报告只留下“合格”两个字、不留下“按哪版阈值判定”，这份记录在若干年后就不可复核。

第三，也是最容易被做错的一条：历史记录按测试当时生效的版本解释，不按当前版本回溯重判。若产品在换版时按新阈值重新判定所有旧记录，一次纯粹的标准更新就会变成一次对历史结论的集体改写——原本当年合规的检测被判成不合格。反过来，也不该拿新阈值去豁免当年的不合格。版本戳的作用，正是把“当时的判据”与“当下的判据”分开保存。

过渡窗口的处理，与国内那批新标准“发布在先、实施在后”的节奏是同一个逻辑：文件已经存在，但它还没有开始管人。产品若把这两个日期混为一谈，就会在窗口期里用一份尚未生效的阈值去否定一份当时合规的检测。

五、单位与量纲卫生

手册里的数字都带单位，而现场错判往往发生在单位上，而不是数值上。接地连续性用毫欧与欧两种写法出现在不同资料里；绝缘电阻用兆欧；泄漏电流用毫安；剩余电流装置动作用毫秒；链条伸长与磨损用百分数；热损伤用摄氏度；吊装侧的额定工作载荷则要在吨、短吨与磅之间切换——合成纤维吊带的国际色标按吨给出，而同一批吊带在北美资料里常按磅标注。

因此手册里的每一条阈值都要自带单位，并与判定用的量纲严格对应。TagWorks 的手册在计算器处把单位直接印在输入框旁（毫欧、兆欧），判定函数接收的也是这两个量纲的数值，中间不做隐式换算。这看似琐碎，却挡住了一类真实的错误：把 0.1 欧当成 0.1 毫欧输入，或者把 12.5 兆欧当成 12.5 欧。

还有一处更细的边界：显示精度与判定精度是两件事。手册上写“不超过 1.0 欧”，是为了让人看懂；判定函数内部用的是毫欧值与原子的比较。如果为了让界面好看，先把读数四舍五入到一位小数再送去判定，就会在临界点上改变结论——一个 1049 毫欧的读数与一个 1051 毫欧的读数，在“一位小数”的显示下可能看不出差别，在判定上却分属两侧。稳妥的次序是：判定用原始读数，显示才做取整，绝不让取整后的值回流进判定。

六、计算器的能力边界：输入的是读数，不是测量

手册里的交互计算器很容易被误解成一台仪器。它其实只做一件事：把使用者手里已有的读数，与手册里配置的阈值做一次比对。它不产生读数、不发出测试电流、不替代任何一台便携式电器测试仪表。

这条边界在实现上有两个具体的落点。其一，当输入为空或无法解析为数值时，返回的结论是“未测量”，而不是“合格”。这是一个有意的选择：缺省不能被解释为通过，因为现场最危险的状态，恰恰是“没有测”被当成“测过且合格”。其二，即使输入了读数，返回的措辞也只是“落在配置限值之内”，并把“请与有资质人员确认适用规程与要求”一类提示一并给出。手册给出的是比对结果，最终判定与放行仍然由现场的胜任人员承担。

这两点合起来说明：手册的定位是“把判据讲清楚”，而不是“替人做判定”。把手册设计成会下结论的裁判，会让使用者把责任从人转移到工具上，这与离线合规工具的用途恰好相反。

七、只读资源与审计链的隔离

手册是随包发布的只读资源，这一点和记录不同。记录是会被追加、会被签名、会进入防篡改审计链的事件流；手册不会。现场人员不能修改手册里的阈值，应用也不会把手册条目写进审计链——它没有理由那样做，因为手册是“判据来源”，而不是“判定事件”。

这条隔离带来两个好处。其一，判定的一致性有了前提：如果阈值可以被现场随手改动，那么两台设备、两个班组对同一台电器就可能给出不同的合格线，“合规”二字随之失效。其二，判定的可复核性有了抓手：记录里锚定所用阈值版本（例如“依据 AS/NZS 3760:2022 的接地连续性 1.0 欧”），复核者拿着同一版手册就能重建当年的比较过程，而不必依赖产品的内部状态。

需要如实说明的是，只读带来确定性，也带来不灵活。手册不能在现场临时放宽某一条限值，哪怕作业环境看起来很特殊；真正的放宽只能来自标准本身或主管机关的解释，而这属于产品之外的事。

八、非法定解释与版权边界

一份内置手册必须把话说在前面：它是阈值与要点的摘录，不是标准全文，也不构成对标准的法定解释。现场判定应以标准原文、主管机关的要求与胜任人员的意见为准。TagWorks 在设置页的版本条目里保留了一句直白的话：“始终以你所在辖区适用的标准为准。” 这不是免责套话，而是能力边界的如实声明。

这条边界还有一层现实原因：标准文本受版权保护。把一部标准的全文塞进应用，既不合规，也不是必需的——现场真正需要的是那几行界限与那几个步骤，而不是整本书。因此手册的做法是给出阈值、周期、清单与法定框架的要点，并注明版本与出处：可检索、可复核，但不可被引为标准本身。

从这里可以推出一条产品纪律：手册里出现的每一个数字，都要能回溯到它所属的版本与条款出处；一个来路不明的阈值，宁可不要放进手册。

九、离线更新与版本闸门

既然手册随包发布，它的更新通道就只有一条：应用版本更新。没有网络，就没有热更新；也没有任何办法从远端补一条阈值进去。

这听起来像限制，但它同时也是这套设计最稳的一部分。阈值不能被静默改动，历史记录也就不会因为一次偷改而莫名其妙地改变合格性。换版时采取的动作因此被约束为：新增一个阈值版本、明确它的生效点、让此后写入的记录携带新的版本锚，而不去动已有记录。

有一处代价必须诚实交代：在一台长期不升级的设备上，手册会停留在它出厂时的版本。如果标准在此期间换版，这台设备仍会按旧版阈值判定。这不是缺陷，而是离线产品固有的事实——它是“确定”的代价。产品能做的是把“本机手册版本”在界面上说清楚，让使用者自己判断是否需要升级。

十、这套参考数据保证不了什么

把边界写完整。

它能做到的，是让阈值在地下班组、在码头、在矿井里随时可查；让手册上的数字与判定用的数字是同一个；让每一次判定都能锚定到它所依据的版本；并让这些判据在断网时依然完整。

它做不到的，是替使用者解释标准。手册不裁决辖区适用性、不解释条款歧义、不发资格证明。它也不做测量：所有读数仍来自现场测试仪表。它更不保证最新：一台不升级的设备，其手册就停在出厂版本上。此外，版本戳能锁定“当时用的是哪版阈值”，却不能证明“当时真的按那个阈值做了判断”——后者只能靠记录与审计链去回答。

最后一条，也是最需要说清的一条：一个能离线查阈值的工具，不等于一次合格的检测。合格与否，取决于现场是否真的测了、是否按规程判了、以及与设备及其使用环境相称的判断是否成立。手册只负责让“判据”不缺席，其余的部分，仍然在人的手上。

结语

离线优先的承诺是数据不出设备。顺着这个承诺往下走，会发现“不出设备”的还有另一类东西：判据。既然现场没有网络，那么把设备判合格与否所依据的那组数字，就必须和记录一起，被装进同一个离线沙盒。于是端侧手册不再是一份附属的说明，而是判定链路上的一等公民：它必须是展示与判定共同的唯一来源，必须带版本戳，必须随包只读，也必须在最显眼处承认自己不是标准的替身。把这些琐碎的事做对，工程师手里那本手册才配得上“可复核”三个字。

参考文献

[1] Standards Australia / Standards New Zealand, AS/NZS 3760:2022 In-service safety inspection and testing of electrical equipment. https://www.standards.org.au/ [2] Health and Safety Executive (UK), Lifting Operations and Lifting Equipment Regulations 1998 (LOLER), Regulation 9 and Schedule 1. https://www.hse.gov.uk/work-equipment-machinery/loler.htm [3] U.S. Occupational Safety and Health Administration, 29 CFR 1910.184 Slings. https://www.ecfr.gov/current/title-29/section-1910.184 [4] 国家标准化管理委员会 · 全国标准信息公共服务平台，量子压缩光源技术规范 GB/T 48222-2026（2026-09-28 发布，2027-04-01 实施）. https://std.samr.gov.cn/gb/gbQuery [5] European Committee for Standardization, EN 1492-1 Textile slings — Safety — Flat woven webbing slings made of man-made fibres. https://standards.iteh.ai/ [6] American Society of Mechanical Engineers, ASME B30.9 Slings. https://www.asme.org/codes-standards/find-codes-standards/b30-9-slings [7] Health and Safety Executive (UK), Thorough examination of lifting equipment: A simple guide for employers. https://www.hse.gov.uk/pubns/indg422.pdf