· engineering· 约 25 分钟精读

Restore Not Merge Multi Device Ledger Boundary — Technical Analysis | KeyRotate Technology

核心要点速览 · TL;DR 概要

对 TagWorks 与 SlingGuard 的跨设备数据通道做全量源码取证:备份恢复是整本替换而非增量应用,检验记录以本机生成的 UUID 互相咬合、从不随行于任何碎片化通道,两台设备撞出同名编号时两款导入器给出相反答案。再对照 LOLER 第 11 条、ACOP L113 第 373~374 段、AS/NZS 3760:2022 第 2.6 条与示范 WHS 条例第 150 条,说明合并不缺功能,它从未进入设计。

Restore Not Merge Multi Device Ledger Boundary — Technical Analysis | KeyRotate Technology

一、先数清门口:进出那本账的只有两种载体

密旋科技的两款现场工具都按”一台设备一本账”设计:TagWorks 把资产与检验记录写在 Documents/TagWorks/register.json,SlingGuard 把资产、检验记录、隔离放行与公司档案写在 rigging_register.json。所谓”一本账”,就是这台机器上的一份整册快照;跨设备搬运数据,靠的是人把文件从一台机挪到另一台机。

第一款要交代的事实是:两款工程的源码里,网络通道数为零。以 URLSession、MultipeerConnectivity 等近场传输框架为关键词在 tagworks/Sources 与 slingguard/Sources 全量检索,命中 0 处。没有同步服务,没有设备配对,没有”云端台账”——这不是功能被关掉了,而是这条产品线的立场:数据不出设备(《五份对外申报》与《静态数据保护》两篇已把这条立场的账目核到底)。

立场落到工程上,一本账能离开设备的载体就只剩两类,外加两条明确不算数的:

载体装了什么到达另一台机后法定记录跟不跟走
TagWorks 备份归档(JSON)资产、测试记录、照片、检验员档案整本替换本机台账跟走(随整本)
SlingGuard 备份归档(JSON)资产、检验记录、放行记录、公司档案整本替换本机四字段跟走(随整本)
登记册 CSV资产行(当前值快照)新建资产,无历史不跟走
测试/检验证据 CSV记录行,供人阅读无任何导入通道不跟走
报告 PDF排版后的证据文档只能给人看,不可回读不算数据通道
状态标签 / 打印件单件设备的现场标识物理世界流通不算数据通道

前四行是本文的全部素材。可以看出一个结构:整册走的通道不拆分,拆分的通道不带册。备份归档是全量语义,CSV 只有资产碎片而且丢掉历史。想”把 B 机的记录并进 A 机的册子”,需要一条”记录可碎片化导入”的通道,而这条通道在两款里都不存在——不是残缺,是没有设计。

两台设备、两本台账、一个只有两种答案的恢复闸口台账 A · 本机资产 · 记录 · 公司档案记录锚定本机 UUID照片文件名也是 UUID台账 B · 那台机同名编号两边各有一条记录与放行链自洽咬合两套 UUID 互不相识恢复闸口:整本替换槽位一 · 整本换入 A槽位二 · 整本换入 B槽位三 · 两本并册换入源码中没有这个槽位换出的旧册:TG 留安全点换出的旧册:SG 直接消失闸口之外:CSV 假合并资产行进得来二十六列仅六列回读记录与放行链不随行导入即新建资产撞号:TG 改名共存撞号:SG 跳行丢弃旧账留在原来那台机上端侧给的是「换一本」,不是「并两本」——两条通道都不产生第三本。store.assets = archive.assets两款工程源码全量检索:没有一个台账合并函数,唯一的并集写在照片引用集合上

左右滑动查看完整图表

二、恢复是整本替换:两款闸门的逐层对照

TagWorks 的恢复入口在设置页,文件选择器只放行 JSON。选完文件,BackupService.restore(url:into:) 按固定顺序执行六步:先做归档校验(引用照片读不齐即 incompleteArchive,整包拒绝);然后给当前本机台账留一份安全归档;再安装照片、按归档是否携带检验员档案决定替换与否;最后调 replaceSnapshot 把归档快照落盘、成功后才换入内存。任一步抛错,照片与档案回滚,台账在盘上和内存里都保持原样。

SlingGuard 的恢复入口同样在设置页,文件选择器放行 JSON 与通用数据;restoreBackup(from:into:) 是另一套性格:读取用 try?,读不出内容时不报错也不弹窗;解码整本快照,除 releases 一键可缺省,其余四个键都必须在场;版本闸门只有单向的一条 <=;全部通过后直接赋值四个字段——资产、记录、放行、公司档案一次换掉——再调 save(),而 save() 的编码与写盘同样被 try? 包住。

L′=LarchL' = L_{\mathrm{arch}}

两款殊途同归:恢复后的台账等于归档里的那本,本机原册不参与运算。公式里没有 LAL_{\mathrm{A}},没有并集,没有映射。全工程唯一一个”并集”字样的操作是 formUnion,它并进的是备份清单里的照片引用集合,为的是核对证据齐不齐,与合并台账无关。

对照层TagWorksSlingGuard
入口文件类型仅 JSONJSON 与通用数据,门更宽
归档内容校验照片不齐整包拒绝四键必在场,缺键整体解码失败
事前确认弹窗无无
本机旧册去向换册前写安全归档不保留,直接覆盖
公司/人员档案归档携带则替换无条件替换
落盘与换内存次序先写盘,失败不露头先换内存,写盘吞错
失败语义照片与档案回滚仅解码/版本两类错误弹窗
事后呈现报资产数、记录数、照片数与安全点文件名一句”已恢复”,无数字

两处细节值得单独指出。其一,TagWorks 的安全归档生成同样是 fail-closed:本机台账若引用了读不出的照片,安全归档造不出来,恢复在动任何数据之前就中止——保护旧册的那道锁,也会成为拒绝换册的理由。其二,SlingGuard 恢复替换掉的不止是数据,还有署名:公司名、资质编号、检验员与签名位图随档案整格换入,恢复完成的那一刻起,这台设备再出的任何报告页眉都是 B 家的身份。对”分包队伍合并、设备收编”这类场景,这是特性还是事故,取决于操作的人是否知道会发生什么——而界面上没有任何一处提前说明。

三、记录为什么”顺不带”:外键是建账那天本机生成的 UUID

既然备份归档能整本搬,为什么不能反过来,只把 B 册里的记录挑出来并进 A 册?答案藏在数据的连接方式里。

对象挂靠方式换机之后的命运
TagWorks 测试记录assetID 指向资产 UUID脱离原资产即成孤儿
修复/复检/放行链linkedRecordID 指向记录 UUID链条只在本册内咬合
SlingGuard 检验记录assetId 指向资产 UUID同上
隔离放行记录linkedQuarantineRecordID 指向隔离记录 UUID无锁可挂即失效
照片证据文件名为建账时生成的 UUID名字先断,内容再孤

两台设备各自建账时,UUID 在本地生成:

UA∩UB=∅\mathcal{U}_{\mathrm{A}} \cap \mathcal{U}_{\mathrm{B}} = \varnothing

这个集合为空是好事——同机之内永不串号,改名、换编号、重排都不影响记录归属;它同时意味着两套集合互不相识,跨机合并时没有任何一条记录能凭外键找到自己的资产。若把 B 册的记录数组直接 append 进 A 册,得到的是一批指向虚无的外键:判定函数找不到资产,报告分组找不到行,状态机把整批新纪录视为噪声。

唯一在两台机器之间仍然稳定的键,是人看得见的编号:TagWorks 的 identifier、SlingGuard 的 tagId。但记录从来不挂在人读键上——设计上这是”端侧自洽”的自然结果,它换来的是单机的健壮;跨机视角下它就成了硬约束:法定历史不是一种可以被随身携带的行集,而是一个只在整本内成立的闭合结构。这也是为什么”整本替换”反而是正确语义:B 的记录、放行链、照片在 B 的那本里自洽咬合,换整本则闭合结构完整迁移,换半本则必然破碎。

四、两个”TG-001”相遇:两台导入器给出相反的答案

跨机数据里唯一走得动的碎片是资产行,于是问题变得很具体:B 册导出的 CSV 里有一行 TG-001,A 机台账里已经有一行 TG-001,导入时发生什么?两款给出了方向相反的两种答案。

TagWorks 的解析器以本机现有编号全集为种子做查重:撞车的行不会被拒绝,也不会覆盖旧行,解析器把新行改名为 TG-001-2 并在预览里给出一条警告,随后 addBatch 把资产直接追加进册。也就是说,“合并”后的台账里同时存在两台机各自的电钻,同名不同档,靠后缀分家。

SlingGuard 的解析器同样感知本机状态——它的查重直接查询 store.assets——但结论相反:撞车行被整行跳过,计数进 skipped,附一句”该 Tag ID 已在册”。B 机的这条资产进不来,除非先在 A 机改掉旧行或删掉旧行(而删除会级联销毁记录,这是另一篇《免费额度》已经算过的账)。

场景:B 册 TG-001 撞 A 册 TG-001TagWorksSlingGuard
查重是否感知本机是(解析期种子)是(导入期查册)
撞车行的去向改名共存跳行丢弃
旧行是否被动不动不动
新行有无历史无,落成未测无,没进来

四种组合里没有一个产出”合并”:一个新增了两套无历史的同名档,另一个直接丢掉一方。更值得记录的是两款查重版图的错位——TagWorks 手工新增走 add 的判重闸门,CSV 通道绕开它改用改名;SlingGuard 手工新增干脆不判重,反倒是 CSV 通道在判。同一个”编号唯一”的关切,在两款里各自只守住了两条通道中的一条。

至于编号本身,标准与法条都没有给跨设备的唯一性兜底:AS/NZS 3760:2022 第 1.4 条的二十四项术语里没有”唯一设备标识符”这个概念,LOLER 第 7 条只强制额定载荷与特性标记,示范 WHS 条例第 150(3) 条要求写明的只有执行人、测试日期、测试结果、下次日期四项。两台机各自编号 TG-001 在法定意义上不构成违规,在工程意义上构成一次必须有人裁决的碰撞——而裁决目前只以”改名”或”丢弃”两种无意识形式发生。

五、安全点是回滚素材,不是合并的另一半

TagWorks 在换册前留下的那份 TagWorks-before-restore-时间戳.json,是本文最接近”合并素材”的东西:它是换册前本机台账的完整镜像,含资产、记录与全部被引用照片(照片以 Base64 内嵌,体积约膨胀三分之一)。它确实让人有路可退——再执行一次恢复,选这份安全归档,本机旧册原样回来。

但看清这条路的形状很重要:它的终点是”换回去”,不是”并起来”。想要 A 册,恢复 A 的安全点;想要 B 册,恢复 B 的归档;想要两本都要,没有第三道门。安全点与外来归档在恢复闸口上是同一类输入——都是”那本将成为唯一的册”——选择永远在两个整本之间做。

还有一层更少人注意的:这份安全归档写在应用沙盒的 Documents 里,而两款工程都没有声明 UIFileSharingEnabled(《静态数据保护》篇已普查到零),“文件”应用看不见这个目录。用户无法在系统层面把安全点取出来过目,也无法在应用内重新选中它——它是应用在关键时刻给自己留的自救索,不是一份可管理、可移交的账册副本。Recovery 目录只写不删的存储放大,同一篇已经算过,此处不重复。

SlingGuard 则连这层素材都没有:换册前不留副本,成功提示只有”已恢复”一句。误恢复的代价是本机旧册当场消失,唯一的事前保护是用户自己记得先导出过备份。更冷的一条边角在空册上:若 B 家交来的归档恰好是一本空台账,恢复照法执行——四字段换空、空册落盘;下次启动时 assets.isEmpty 判真,自动播种程序把 3 台演示吊索具与 3 条合格记录写进这本刚空掉的册子,页眉署名还是刚换入的 B 家身份。“清空”与”演示数据”在同一台机器上会师,而这本混合册会照常通过报告页的全部格式检查。

六、法定侧讲保存与可及,从不要求合并

把四份文本翻一遍,会发现”合并两台设备的记录”不是任何一条义务的缺失项——它根本不在义务清单上。

文本与条款实际要求对”两台手机”意味着什么
LOLER 1998 第 11(2) 条报告保存分四支:设备用到弃用为止、属具报告后两年、安装类至移离该处为止、下次报告或两年取晚保存责任以”册在不在、到期没到期”计,不以功能计
ACOP L113 第 373、374 段电子保存应防未授权改动、可出纸质;宜存于现场,存于他处须随手可及、控制人知其所在“知其所在”在多机组织里变成”账在哪台机上”
AS/NZS 3760:2022 第 2.6 条澳侧记录宜保存,新侧应保存并附全部受检设备台账;保留期宜七年register 义务在 NZ 侧是硬话,字段未列举
示范 WHS 条例第 150(3) 条记录须写明四项,保存至下次测试或处置四项要素都不要求”来自哪台设备”
ISO/IEC 17025:2017 第 7.4.2 条(设计参照)唯一标识系统,确保物品在实物、记录与文件中不被混淆在意的是”不混”,不是”能并”

对照下来,两款工具的实际姿态与法条是自洽的:整本替换保证任何时刻册内闭合结构完整;照片证据随册迁移、缺一即拒绝生成;电子台账可出纸质件。真正悬空的是一件法条不管、组织必须管的事——ACOP 第 374 段要求”控制人知道记录在哪里”,当台账分散在若干台手机时,这个”哪里”退化成一个从未被数据记录的元事实:归档的扉面字段只有版本号、导出时间,SlingGuard 多一枚构建版本号,没有任何一处写下”这本账产自哪台设备”。设备是谁,账本不知道;账本在谁手里,只有人知道。

中国商用密码体系侧的类比同样落点在保管而非功能:《商用密码检测机构管理办法》第十九条要求原始记录与报告归档留存、保证可追溯、保存不少于六年——这是对检测机构的规定,不是对端侧 App 的义务,但”可追溯、有期限、在有人负责的处所”三件套,与 LOLER 时代的英国实务守讲的是同一类语言。合并功能在哪一边都不曾是条文。

七、第三种形态:QubitLab 连迁移通道都没有

第三款产品给出光谱的另一端。QubitLab 的学习进度只有一个落点:@AppStorage 里的一个键,应用内没有任何导出、导入、分享通道——前两款至少有一本可整册搬运的归档,它连归档都不产。跨设备的唯一路径是 iOS 系统级的整机迁移或加密备份恢复:房间整体搬家,两间屋子仍然不会合成一间。付费权益跟着 Apple 账户走,新设备可以重新验得;星数不跟账户走,新机从零开始。“合并”在这里无从谈起,因为进度这本”账”从未设想离开诞生它的那台设备——与《付费权益裁决》《静态数据保护》两篇的结论正好接榫。

三款并排看:无通道、整本换、整本换加碎片旁路——这是端侧离线产品对”跨设备”这件事能给的全部三种答案。

八、可行的作业方式与绕不过去的能力边界

不虚构产品做不到的事,把现实里能走通的方式列清楚:

  1. 单册记录点。指定一台设备为”那本账”,其余设备不承担记录义务;流动作业者现场测得的读数,回到册机重新录入一条测试。代价藏在日期里:TagWorks 的检验日期在保存瞬间写死、补录在模型层不可表达,重录就是把到期链整体前移;SlingGuard 允许用日期选择器挑一个过去的日子,但挑得到”哪一天”、挑不回”几点”——两篇旧文(《检验日期上没有钟点》《设备时间可信性》)量过的账,多机作业会把它常态化。
  2. 整本交接。设备或队伍更替时,用备份归档做原子交接:新机整本换入,旧机按《设备退役与数据清除》一文的流程处置。交接的粒度是一本,这要求交接双方对”此刻哪本是最新的”有共识。
  3. 整机迁移。个人换机走系统级通道,数据随房间搬。它解决”换设备”,不解决”合两设备”。
  4. 真正的并册。若把它当需求看待,至少要四件东西:法定记录的归档导入通道、UUID 重映射表、同名编号的冲突裁决与会审记录、并册动作本身的审计线。这是一个新功能面,两款现有结构(整本快照、单向版本闸门、无实体级编辑接口)都没有为它留门。

能力边界,六条:恢复语义是替换,且界面文案从不预告这一点;CSV 只携带资产当前值,法定历史从不随行;查重机制的目标是防混淆,不是跨机对账;安全归档只服务于换回,且对用户不可见;归档不记录来源设备,“账在哪台机上”永远由人记;最后一条是立场的背面——端侧隔离换来的每一份数据主权,都对应着一次放弃:没有云同步,也就没有自动合并。本文的普查结论并不指向”缺失”,它指向的是一笔早就付掉、只是少有人对着账单看的价格。

九、结语

两台手机各自工作的那几个月,谁都没有错;把它们拼成一本的那次操作,才会让人看清这两款工具对”台账”二字的一致性理解:台账不是行集,是一台设备上闭合自洽的一整本。恢复尊重这个定义,所以只能换;CSV 不尊重这个定义,所以只能残缺。把这句话印在界面上只需要一行小字,把它改写成”合并”则需要一整套新的数据生命观——那是另一件产品,不是这一件。

参考文献

  1. [1] 英国《1998 年起重操作与起重设备条例》(LOLER 1998, SI 1998/2306)第 7、11 条及附表 1,引自 HSE 官方实务守则 L113 重印全文。HSE L113
  2. [2] HSE, Managing and using lifting equipment: Thorough examination(INDG422)。INDG422
  3. [3] AS/NZS 3760:2022《在用电气设备与剩余电流装置的服务安全检验与测试》,第 1.4、2.6 条款。SAI Global
  4. [4] 澳大利亚示范《职业健康与安全条例》第 150(3) 条四项要素,引自 ACT 通知的执业规范《Managing electrical risks in the workplace》。legislation.act.gov.au
  5. [5] ISO/IEC 17025:2017《检测和校准实验室能力的通用要求》第 7.4.2 条;等同采用 GB/T 27025-2019。ISO OBP
  6. [6] Apple 开发者文档:UIFileSharingEnabled 键与沙盒 Documents 暴露规则。Apple Developer
  7. [7] IETF RFC 4180:CSV 的记法约定及其无类型本质。RFC 4180
  8. [8] 《商用密码检测机构管理办法》(国家密码管理局令第 2 号)第十九条:归档留存、可追溯、保存不少于六年。国务院公报
Share:
Back to Blog