· engineering· 约 28 分钟精读

Offline Register Derived Status Cost Scale — Technical Analysis | KeyRotate Technology

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

同一句统计量,TagWorks 的仪表盘在 body 里读了十九处、每读一次就把整册重算一遍,SlingGuard 的同一屏把它写成了一个 let。本文不复现卡顿、不给毫秒数,只把两款端侧登记册的每一次全册扫描、每一次日历运算、每一字节整本重写数清楚,摊成四个规模挡位的账。

Offline Register Derived Status Cost Scale — Technical Analysis | KeyRotate Technology

一、这篇只数能数出来的东西

台账会长到多大是有公开口径的:SlingGuard 的规格书把免费档写成「Up to 20 Assets」、专业档写成「Unlimited Assets」,TagWorks 的免费额度常量是 25 件。代码里也确实找不到容量闸门——登记册就是一个 @Published 数组,装得下多少取决于剩余空间。「无限」于是被交给另一件事去回答:一台不联网的手机,要替这册东西干多少活。

回答它有两条路。一条是实测:接上 Instruments,用真机与真台账量解码耗时、每帧函数计数与掉帧。本文不走这条路,因此全文没有一个毫秒数,也不会用「卡顿」这个词。另一条是查账:源码里每一次 filter、contains、first(where:) 都可数,Calendar.current 的调用与 register.json 写出的字节数得清。本文只走第二条路,口径写进 scripts/scale_cost_model.py,改参数即可复跑。

二、台账不是被写长的,是被保留期钉长的

一款端侧检测应用的数据寿命不由产品决定,由法规决定,而且这些条款的方向全部是「只许留着,不许短留」。

出处条款保留期口径强度
AS/NZS 3760:20222.6.2检验测试记录宜保存 7 年,或监管机构要求的更长期限should
AS/NZS 3760:20222.6.1(新西兰侧)须保存记录,并附全部被检设备台账shall
澳洲 Model WHS 条例150(3)记录保存到下次测试、永久移除或处置为止,须写明执行人、日期、结果、下次日期四项法定
LOLER 1998reg 11(2)(a)(ii)吊装属具的报告在出具后保存两年法定
HSE ACOP L113para 373 / 374电子保存的系统应防未授权改动并应能出纸质件;记录宜存于使用现场建议
STFC Safety Code 26附录 7法定检验记录保存「当前 + 3 年」机构规程
STFC Safety Code 17附录 9现场与本地检测记录保存「当前 + 8 年」机构规程

这张表的两个方向都要看。长度上:七到八年意味着一台 2019 年进场的设备,它的每条记录至今仍须在册,而它自己又会被周期性复测——资产数与记录数各自单调增长,后者快于前者。位置上:ACOP 建议记录宜存于使用现场,端侧离线是这个建议最字面的实现。两件事叠加:法定保留期把行数堆高,端侧架构把行全留在同一台设备上。

新设备仍在持续进场:2026-11-20,一个超导线材基地的二期起重机采购发标(陕西,编号 20261120_649545890)。进场之后,它的每次检验、每份报告、每张放行单,都会落进某本至少要活两年的台账里。

三、一次 status 的解剖

两款应用的列表、仪表盘、报告与 CSV 都在问同一句话:这台设备现在算什么状态。TagWorks 侧的回答者是 ReportExporter.status(of:records:now:),它看起来像个纯函数——不持有状态、不写盘、不吃环境,这是它可测试的原因,也是它没有记忆的原因。

// Sources/TagWorks/Services/ReportExporter.swift:127-135
static func status(of asset: Asset, records: [TestRecord], now: Date = Date()) -> TestIntervalStatus {
    let latest = latestInspection(for: asset, records: records)
    let incomplete = latest.map { ... } ?? false
    return TestIntervalPolicy.status(
        for: asset,
        latestOutcome: latestOutcome(for: asset, records: records),
        hasIncompleteLatestInspection: incomplete,
        now: now)
}

把它沿调用链摊开,扫整册的地方有三处:

结构被扫的集合谓词次数干了什么
latestInspection整册 recordsM挑出这台设备的 test/retest,取日期最大者
unresolvedFailure整册 recordsM同样先 filter 出这台设备的历史,再排序、回放四次写入
latestInspection(第二遍)整册 recordsM被 latestOutcome 在失败链之后再调一次
TestIntervalPolicy.status—2 次日历nextTestDue 的月份加法 + 一次 .day 差值

一次 status 的代价是三遍整册扫描:

Pstatus=3M+2 CcalP_{\mathrm{status}} = 3M + 2\,C_{\mathrm{cal}}

在 1,440 条记录的册子上,一次 status 是 4,320 遍谓词加两次日历运算。注意 M 是全册记录数,而不是这台设备自己的记录数——它平均只有 3 条:三遍扫描里真正属于本机的那几条只占九分之一强,其余都是对别人家设备的比对。

四、同一个函数,两处调用点扫的不是同一个集合

判定链上有个函数被两处调用,传进去的集合不在一个量级。validRetest 的第六项条件要在该设备的另一条记录里找合格修复,查找写在 records.contains { ... } 里,被扫的是它的入参。unresolvedFailure 内部调它时传的是回放用的 history(这台设备自己的几条);而 AssetDetailView.swift:28-31 直接传 store.records——整册。

调用点传入的 records外层 filter内层 contains 每次最坏合计
unresolvedFailure 内部(:35)该设备的 history(k 条)kkk 的平方
AssetDetailView 计算属性(:30)整册(M 条)MMM 的平方

同一个判定条件,在列表里是局部查询,在详情页里变成一次全册交叉比对。详情页还有三个同族计算属性(current 走 assets.first(where:)、history 走 records.filter、printableRecord 再走一遍失败链),它们在 body 里被多处读取,读一次算一次。单台设备的详情页看着最轻,其实是这款产品里谓词密度最高的一个屏幕。

五、Swift 的计算属性没有记忆

回到标题里那个数字。DashboardView.swift:6-8 是这样声明统计量的:

// Sources/TagWorks/Views/DashboardView.swift:6-8
private var summary: ReportExporter.Summary {
    ReportExporter.summary(assets: store.assets, records: store.records)
}

它是一个计算属性。Swift 的计算属性只是 getter 的语法糖,不缓存结果:每读一次属性名,getter 就完整跑一遍。而它的 body 里 summary 这个前缀一共出现十九次。

位置(body 内)读取处数语义
三枚单字段 stat 卡3Assets / Current / Due soon
Attention 卡与 tint 各含四个字段相加8同一句判断被拆成四次属性访问
进度条 value、total、currentValueLabel4分子分母各读两遍
通过率、首次测试、站点列表与其空态4站点集合算了两次
合计19每次读取都是整整一遍全册派生

于是一次仪表盘求值的账是(N 为在架资产数,M 为全册记录数):

Cdash=19×(3MN+6N+2M+N)+MN+5NC_{\mathrm{dash}} = 19 \times \left(3MN + 6N + 2M + N\right) + MN + 5N

括号里的后三项来自 summary 自身:六次状态筛选、两次记录筛选与一次资产字典;括号外那两项是仪表盘里「失败件」那一小段——records.filter 的内层还要一次 assets.first(where:),一次没有索引的嵌套遍历。代入 N=480、M=1,440:一次 summary 是 2,079,840 遍,十九次是 39,516,960,加上嵌套段是 40,210,560,日历运算 18,240 次。

这条链上没有一行代码写错。判定层是纯函数、可单测、可复用,这是它的优点;只是纯函数每次被调用都重新推导一遍世界,而 UI 层把同一个推导重复了十九遍。

六、姊妹应用的同一个屏幕

SlingGuard 的仪表盘显示六枚 KPI 卡与一个环形百分比,也同样在 body 里读取 summary. 十九次。区别只在第 15 行:

// Sources/SlingGuard/Views/DashboardView.swift:15
let summary = ReportExporter.summary(assets: store.assets, records: store.records, releases: store.releases)

一个 let。视图构建函数允许在顶部声明局部常量,于是十九次读取共享同一个已求值的结构体。两款应用同期发布、同一套离线架构,在这一点上是两种写法。

对照项TagWorks 仪表盘SlingGuard 仪表盘
统计量的载体private var 计算属性body 内 let 局部常量
summary. 在 body 中出现19 次19 次
整册派生实际执行19 次1 次
N=480 挡位一次的谓词数40,210,5602,107,680

差别不是数量级,是同一数量级里的十九倍。它也不构成对前者的指责——两款都没有为此写过测试,都跑得动;这类差异要等到册子长到某个程度,才会从「无所谓」变成「值得改」。

七、分面、检索与滚动

列表屏的账更容易被忽视,因为它伪装成「只是看一眼」。

SlingGuard 顶部的六枚状态胶囊各算一遍:ForEach(AssetStatus.allCases) 里每一枚都执行 store.assets.filter { store.status(for: $0) == status }.count。渲染这一行就要六遍整册资产,每遍对每台设备走一次 status,而 status 内部又含两次 records.contains、一次对整册 releases 的遍历(命中的每条再对整册 records 做一次 first(where:))、以及一次 records.filter。胶囊下面的 filteredAssets 被读两处:一处判空态,一处喂 ForEach;滚动时每个首次出现的行再来一次。

TagWorks 这边有一条相反的口径:filtered(_:) 的 .all 分支直接 return assets,一次 status 都不算;代价全在另外三个分支——.due、.soon、.ok 每个分支都对全册逐个算 status,而 shown 同样被 body 读两处。同一次进入列表,切到「Attention」和停在「All」不是一回事。

一次列表屏求值TagWorksSlingGuard
分面/筛选触发的整册 statusAll 分支 0 次;Attention 分支每设备 1 次 × 2 处读取每设备 6 次(六枚胶囊各一遍)
列表行求值(按一屏 12 行)12 次12 次
N=480、M=1,440 挡位合计4,199,040(Attention)12,632,256
检索输入时的额外一遍无检索通道每敲一个字符重跑上述全部

按一屏 12 行计是保守算法:每台设备只在列表里第一次露出时需要一次 status,屏外的行不计,整册逐行求值的真实发生位置在滚动过程里。行是按屏批量生成还是逐行生成属于框架调度,本文不作推断;若按整册计,把上表两数乘上「全部行 / 可见行」即可,量级不变。

八、导出这一刀

导出是现场唯一会主动要求「把整册都算一遍」的动作。TagWorks 的 exportReport() 里,makeReport 是一个普通的同步调用:按钮动作 → 生成 PDF 数据 → 写临时文件 → 拉起分享面板,全在一条调用栈上。SlingGuard 的 generatePDF() 走的是另一条路:先把四个数组各赋给一个局部常量(Swift 数组的写时复制,等于取一份快照),再进后台队列,算完回主线程赋值。

这两款应用加起来,离开发育者所写线程的地方只有两处:SlingGuard 的这一处报告生成,和 TagWorks 相机会话的 startRunning。检测时照片导入用的是一句不带执行器标注的 Task { await importPhotos(items) },落在哪个线程由视图上下文决定,本文按源码不作推断。

// Sources/SlingGuard/Views/ReportPreviewView.swift:84-98(节选)
let assets = store.assets
let records = store.records
let releases = store.releases
DispatchQueue.global(qos: .userInitiated).async {
    let data = ReportExporter.makeReport(assets: assets, records: records, ...)
    DispatchQueue.main.async { self.pdfData = data }
}

导出内部的算量是「一遍 summary + 每台设备若干遍整册」:

导出产物结构N=480、M=1,440 一次
TagWorks PDF先 summary 一遍,再每台:records.filter + latestValidRelease + latestOutcome5,535,840
TagWorks 资产册 CSV每台:records.filter + status 三遍 + latestValidRelease3,456,000
TagWorks 历史 CSV先建一次 assetLookup 字典,再逐条记录查表与 M + N 同级
SlingGuard 资产册 CSV每台:status(三遍整册)+ activeQuarantine 再来一遍 + releases.filter2,810,880
SlingGuard PDF 报告summary 一遍 + 逐行 status 一遍 + 记录排序 + 隔离记录各扫一遍放行表4,231,872

同一列里还有一处不对称:同样是导出,TagWorks 的历史 CSV 建了 assetLookup 字典,逐条记录只是查表;资产册 CSV 不建索引,每台设备都要扫一遍别人的记录。两处代码在同一个 Services 目录下相邻摆放。

导出还有第二条账:产物本身的尺寸。TagWorks 的报告是「封面一页 + 每站点若干页,每页约 23 行」,页数与资产数同阶;SlingGuard 的报告是「封面 + 站点汇总(每页约 43 行)+ 每条记录独占一页 + 收尾一页」,页数与记录数同阶。四个挡位下的页数:

挡位N / MTagWorks PDF 页数SlingGuard PDF 页数
免费额度顶格25 / 755 页81 页
一个班组三年120 / 3609 页366 页
中型工地多年480 / 1,44025 页1,454 页
企业级台账1,500 / 4,50069 页4,538 页

以上按四个站点均分、每台设备有配套证据行计。一条记录一页不是排版失误——逐条摊开本就是这份报告的目的;它只是意味着保留期把记录数推多高,PDF 页数就跟着长多高,而这件产物要在同一台手机上渲染。

九、写这一侧:整本快照、防抖与整本重写

写这一侧的账更简单,因为它不依赖册子的内容结构:每次落盘写出的是整个快照。

// Sources/TagWorks/Services/RegisterStore.swift:221-224 与 :253-258
func save() -> Bool { ... return write(Snapshot(assets: assets, records: records)) }
private func scheduleSaveIfNeeded() {
    saveTask?.cancel()
    saveTask = Task { try? await Task.sleep(nanoseconds: 400_000_000); ... _ = self?.save() }
}

@Published var assets 与 var records 各自带一个 didSet,任何一处改动都触发防抖:TagWorks 400 毫秒、SlingGuard 300 毫秒。防抖把短时间内的多次改动合并成一次写出,这很有效;但被合并的是次数,不是体积——那一次写出仍然包含整册资产、整册记录(SlingGuard 还多一条放行数组和企业档案)。

盘上的体积按 Codable 合成编码的字段表算:一条资产 229 字节(八个键,含 36 字符 UUID 与一个双精度秒日期),一条记录 316 字节(十一个键;把仪器型号、序列号、校准日期、程序引用四项可选字段填全再加 246 字节)。

规模挡位资产 / 记录register.json一次保存写出一天 60 次保存
免费额度顶格25 / 7529,425 B(29 KiB)29,425 B1.7 MiB
一个班组三年120 / 360141,240 B(138 KiB)141,240 B8.1 MiB
中型工地多年480 / 1,440564,960 B(552 KiB)564,960 B32.3 MiB
企业级台账1,500 / 4,5001,765,500 B(1.7 MiB)1,765,500 B101.0 MiB

写次数由作业节奏决定:一次检验保存触发一组改动(追加记录、回写末检日期),落在同一个防抖窗口里就是一次写出。.atomic 让这次写先进临时文件再改名换上,好处是永远看不到半本册子,代价是同一份字节被完整产出一次。这一侧没有 flash 磨损与 I/O 吞吐的实测,只有一条结构事实:写出的字节数与本次改了几条无关。

两款在启动时还有一处不同。TagWorks 的 load() 把两个数组的赋值包在 suppressAutomaticSave = true 的窗口里,读完不回写;SlingGuard 的 load() 直接把四个 @Published 字段逐个赋值,四次赋值各触发一次防抖,取消三次之后,剩下那次在 300 毫秒后把刚读进来的整册原样写回磁盘——480 件挡位下,每次冷启动多写 552 KiB。它的 storeURL 还是一个每次读取都会执行目录创建的计算属性,load() 与 save() 各读一次。两处都不是错误,是取舍;但既然「无限资产」写进了对外口径,这类常数开销的乘数就值得先算一遍。

十、冷启动排在第一帧之前

@StateObject private var store = RegisterStore() 里的初始化闭包在应用启动时执行;RegisterStore 标着 @MainActor,于是 init() 里的 load()——先 Data(contentsOf:) 把整个文件读进内存,再 JSONDecoder 把 N+M 个结构体逐个还原——同步排在界面第一帧之前。这里没有 async、没有分块、没有进度态,Data 与解码出的对象同时存在,内存峰值在解码结束前是盘上体积的两倍多一点。

这条链的失败面此前已经写过(读不到与解不开折成两种提示、落盘失败连坐整本),本文只补一句结构性的话:把全部数据留在设备上的应用,也把这册数据的全部读写代价留在了设备上——没有服务端可以分摊,没有索引服务可以借用,「加载」与「首屏」也没法分开。这不是缺点,这是它的隐私承诺的价格标签。

十一、按 id 建的索引有四处,没有一处是台账要的那张

两款应用一共写了四处字典,键全是资产 id:

位置键值用途
TagWorks ReportExporter.summary :147资产 id设备类别记录级通过率的分母
TagWorks CSVExporter.makeHistoryCSV :68资产 id资产本体历史行补设备名与站点
SlingGuard ReportExporter.makeReport :112资产 id资产本体报告逐条记录补行
SlingGuard CSVExporter.makeInspectionCSV :39资产 id资产本体检验证据 CSV 补列

四处都是「id → 资产/类别」。台账真正需要的那张倒排——「资产 → 它自己的记录」——一次也没建过。于是每次 status 都得从整册里现场捞自己的那几条,捞完即扔,下一台设备再从头捞;activeQuarantine 里那个 releasedIDs 集合也是每次求值现建的,算不上留存索引。

十二、四个规模挡位下的账

把上面所有的计数汇成一张表。列名里的谓词数是一次完整求值的量,不是累计量,也不是任何时间口径。

先数读侧三屏(R 为放行记录数;四挡均按 k = 3 均匀分布计):

挡位N / M / R仪表盘列表 All列表 Attention
免费额度顶格25 / 75 / 3115,0502,70013,950
一个班组三年120 / 360 / 122,535,84012,960272,160
中型工地多年480 / 1,440 / 4840,210,56051,8404,199,040
企业级台账1,500 / 4,500 / 150391,878,000162,00040,662,000

再导出面与对照(末列是同一批规模下「整册派生只算一遍、并先建好倒排」的状态表代价):

挡位导出 CSV导出 PDFSlingGuard 列表屏一次性状态表
25 / 75 / 39,37515,32536,936300
120 / 360 / 12216,000347,160799,3441,440
480 / 1,440 / 483,456,0005,535,84012,632,2565,760
1,500 / 4,500 / 15033,750,00054,019,500123,013,80018,000

现状与末列之比在 383 到 21,771 倍之间,随规模增大。

派生链上的四千万次比较计数单位是谓词求值次数,本文不含任何墙钟实测一次 status 的解剖status(of:)第一遍 最近一次检验第二遍 未关闭的失败第三遍 又算一次检验三遍扫的都是整册记录,另加两次日历运算同一次求值被乘了几次2,079,840 × 19 次 = 39,516,960再加失败件嵌套扫册 = 40,210,560仪表盘一次 body 求值(TagWorks)25 件 / 75 条(免费额度顶格)115,050120 件 / 360 条(一个班组三年)2,535,840480 件 / 1,440 条(中型工地多年)40,210,5601,500 件 / 4,500 条(企业级台账)391,878,000换成一张一次性状态表M + 3 × k × N = 5,760判定结构不变,只是不再扫整册480 件挡位下的比值:6,981 倍写侧的整本重写不在这张表里分面这一侧:SlingGuard 六枚状态胶囊各扫一遍全册,一次列表渲染 12,632,256 次TagWorks 的 All 分面直接返回整个数组,零次求值;痛感在切到 Attention 那一下没有一行代码写错:量全部来自「每次读取都重算」与「每次都扫整册」这两条口径

左右滑动查看完整图表

十三、四条可以落地的改法

这些改法不动判定语义,也不动法定字段,因此不需要重跑法定阈值的验证。它们动的是「算几次」。

改法落点一次渲染的量级变化必须同时回答的问题
把统计量收进 body 顶部的 letTagWorks DashboardView.swift:619 倍无(SlingGuard 已是现成范本)
建一次「资产 → 记录」倒排,status 改吃局部集合判定链入口(两款)约 3M 变 3k,M=1,440 时是 480 倍倒排的生命周期:谁写记录谁作废它
一张 id → 状态 表 + 版本号失效列表屏与 KPI 屏共用4,199,040 降到 5,760跨日界的作废:到期判定吃墙钟,缓存需要一条按天作废的边界
导出统一离开主线程,并让进度可见TagWorks exportReport()数量不变,位置改变导出中改账的语义:先取快照再进队列,报告反映的是快照时刻

第二与第三条是同一件事的两面:建索引让 status 不再扫整册,缓存状态表让同一份推导被复用。两者都带来一个新问题——失效。失效源只有三个:资产数组变化(含末检日期回写)、记录数组变化、墙钟跨过到期比较的那一天。前两个是数组赋值点,可静态定位;第三个不是代码事件,它与「端侧时间可信性」一篇讨论的是同一个边界。缓存不制造新问题,它把一直存在但未被承认的问题变成必须处理的问题。

第四条的代价最清楚:SlingGuard 用两行局部常量把整册取成快照再进后台,换来导出期间列表仍可滑动;TagWorks 把导出与界面绑在一条调用栈上,换来导出内容必然包含这一秒的改动。两种取舍都合法,只是页脚那句免责文字并不区分这两种「最新」。

十四、能力边界

一,本文所有数字是谓词求值与字节的计数,不是耗时:同样四千万遍谓词在不同机型、系统版本与内存压力下表现完全不同,本文没测也不代测。二,计数以「一次 body 求值」为分母,SwiftUI 何时重求 body 不能从源码推出,一屏 12 行是保守取值。三,日历运算的次数可数,Calendar.current 每次求值的实际代价没测。四,均匀分布是假设:真实现场里少数设备的记录链更长,量级不变而常数变化明显。五,记录数与资产数之比不固定:只补录年检的租户可长期停在 1:1,每日点检的工地会走向 1:20。六,本文对 25 件以下的册子不构成提醒——免费额度替多数试用规模挡住了这件事,这张账只对长期用专业档的现场成立。

要往下走,值得实测的是四件事:冷启动的解码时长与内存峰值、两屏每次求值的耗时与函数计数、导出期间的掉帧、一次全量 .atomic 写落在闪存上的实际字节。测完之后,本表的量级才有资格换成毫秒。

参考资料

  • [1] AS/NZS 3760:2022:在役电气设备检验与测试标准条目页(第 2.6 节记录与台账)。SAI Global
  • [2] HSE ACOP L113:《LOLER 1998 与 PUWER 1998 规程建议与实例》第二版,第 373、374 段(电子记录的防改动与存放位置)。HSE
  • [3] 澳洲 Model WHS 条例工作场所电气风险代码实务(含 reg 150(3) 四项记录要素)。ACT 立法通知
  • [4] STFC Safety Code 26《起重设备与属具的安全使用》Rev 1.12 附录 7 文档保留策略。STFC SHE
  • [5] Apple WWDC16 Session 416《Understanding Swift Performance》:值类型、引用计数与堆分配的代价维度。Apple
  • [6] Apple 开发者文档《Core Data Program Guide: Performance》:数据量、抓取限制与 BLOB 处置的官方口径。Apple
  • [7] Apple WWDC26 SwiftData Group Lab:大数据集的行数、抓取限制与分页建议。Apple
  • [8] 西安聚能超导线材科技有限公司研发生产基地二期起重机采购项目招标公告(2026-11-20,陕西)。乙方宝招标

本文的代码事实取自 TagWorks 与 SlingGuard 当前发布源码;全部计数由 scripts/scale_cost_model.py 按源码遍历结构复算,不含任何真机墙钟实测。

Share:
Back to Blog