【鸿蒙心迹】碰一碰进机房:把巡检照片精准落进设备台账的运维构想与接入方案

摘要: 机房巡检最痛的不是跑腿,是照片入台账——拍了几十张照片,回工位后逐张对照"这是哪台机器",插错行、传丢图、序列号抄错是常态。HarmonyOS 7(API 26)的碰一碰·精准分享给了这个问题一个很自然的解法:手机轻碰台账里目标设备所在的行,照片直接落到那一行的"巡检照片"格子里,落点即台账行。本文基于真实运维巡检流程拆解这个场景:传统照片入台账的四段损耗、碰一碰方案的用户旅程与触发链路、坐标到表格行的换算方案、幂等与插错行的防呆设计,以及 OCR 补录型号序列号的进阶玩法。工程链路沿用姊妹篇《碰哪传哪》的状态机与坐标转换设计,本文聚焦"落点是表格行"这一具体映射怎么做。

适用版本: HarmonyOS 7 / API 26.0.0 / DevEco Studio 6.x(Beta 阶段接口以当前 SDK 文档为准)

环境说明: 本文的巡检流程、痛点细节来自本人真实机房运维工作;碰一碰的接入方案沿用《碰哪传哪:HarmonyOS 7 碰一碰精准分享工程化落地》一文中已验证的坐标回调链路。文中未实测的效率数据均标注"估算",不编造实测数字。

开篇:12F-03 的照片,插到 12F-07 那行去了

“12F-03 的照片,插到 12F-07 那行去了。”

这句话是我在台账评审时听到的。当时季度盘点刚做完,两百多台设备的巡检照片整理了整整一个下午,自以为没毛病,评审时被同事一眼看出两行照片插反了——两台机器长得几乎一样,铭牌朝向也相同,插错行没人能当场发现。

先交代下背景。我做运维,每周例行机房巡检,机柜上服务器、交换机、防火墙混着部署。巡检的要求是:每台设备的铭牌、指示灯面板、仪表读数都要拍照留档,回工位后填进设备资产台账——一张包含设备编号、机柜位置、型号、序列号、巡检日期、巡检照片列的表格。

真正耗时的不是巡检本身,是照片入台账这一步。上个月季度盘点我拍了 86 张照片,流程是这样的:先用微信传输助手把照片传电脑,结果十几张被压缩糊了,指示灯状态看不清,又用数据线重传了一遍。然后打开台账逐张对照——这张是哪个机柜的?那台机器的序列号是多少?逐行把照片插进对应单元格,手填型号和序列号。光这一步就是四五个小时。

这中间的损耗可以拆成四段:
碰一碰进机房:把巡检照片精准落进设备台账的运维构想与接入方案|图 1

四段里最要命的是第三段"逐张对照归位":传输工具不管你的业务,照片永远落在下载目录;台账表格也不知道照片该去哪,全靠人眼对照文件名和机柜位置。内容已经到了电脑,但离"落到正确的位置"还差最贵的一公里。

看到「碰哪传哪」话题里"精准分享"这个能力的时候,我第一反应就是:这不就是为这种场景做的吗——落点不是模糊的"下载目录",而是台账里具体的那一行。

本文会把这条链路讲透:台账场景下触点坐标怎么换算成表格行,插错行怎么防,以及照片之外还能顺手解决什么。工程底座(knock 注册、坐标回调、幂等写入)在姊妹篇里已经展开过,本文不重复,只讲台账这个具体映射。

一、为什么是台账:落点有明确业务含义的场景

姊妹篇里我给"落点即指令"定过四条判定标准:落点有业务含义、内容可轻预览、失败可撤销、单链路不超过三步。拿这四条去套运维巡检,会发现台账场景几乎是教科书级的命中:

落点有业务含义:台账表格的每一行就是一台设备,行本身有唯一编号(设备编码 + 机柜位置)。触点落在哪一行,指令就是"照片插到这一行的巡检照片列"——不是"放进某个文件夹",而是精确到单元格。这是精准分享所有应用场景里语义最明确的一类。

内容可轻预览:巡检照片是单张 JPG,落在触点旁给个缩略图加"确认插入",一两秒就能确认。不存在"2GB 压缩包预览不出来"的尴尬。

失败可撤销:插错了行,撤销操作直接从表格里移除这张图,不留副作用。低风险场景甚至可以免确认直插。

单链路 ≤3 步:拍照(或相册选图)→ 碰台账行 → 完成。传统流程里"传输、下载、找文件、对照、插入"五步全被压掉。

对照一下两种链路的差异:

环节传统流程碰一碰流程
照片传输微信助手/数据线,可能压缩、遗漏不需要,直接投递
照片定位人眼对照文件名与机柜位置触点坐标即行号
插入位置手动点到目标单元格自动命中"巡检照片"列
序列号抄录照着铭牌手打可选 OCR 自动填充
单台耗时2-3 分钟(估算)10 秒级(估算)

86 张照片按这个差值算,四五个小时的对照工作理论上能压到半小时以内——当然这是估算,等真正接入后我会用实测数字来修订。

这里多说一句为什么"传统分享"在这个场景里特别难受。普通分享回答的是"传给谁",而台账场景的问题是"传到哪一行"——这两个问题根本不是一回事。微信传文件再方便,也回答不了第二个问题;精准分享的坐标恰恰就是第二个问题的答案。

二、用户旅程:从拍照到入账的一次完整碰触碰一碰进机房:把巡检照片精准落进设备台账的运维构想与接入方案|图 2

有几个细节值得展开。

碰的对象是"行"而不是"表格"。用户的心智是"碰这台设备",所以命中区域按行划分,整行都是有效落点,不需要精准点到某个单元格——碰在行的任何位置,照片都进那一行的照片列。这和文档场景"碰页边距=插到页尾"是同一个设计思想:落点语义按区域定义,宽容度比精确度高。

轻预览必须显示行号。光给缩略图不够,还要把"插入至 12F-03(核心交换机)“这样的目标信息一起亮出来。运维场景里设备长得都一样,用户真正要确认的不是"图对不对”,而是"行对不对"——预览文案要把行身份说清楚。

多张连拍的处理。现场经常对一台设备连拍两三张(铭牌一张、面板一张、读数一张)。方案是碰一次落一批:最近 3 分钟内同一台设备方向拍摄的连续照片打包成一个投递批次,预览时以缩略图条展示,确认后全部入行。这个"3 分钟 + 连续拍摄"的批次规则是我暂定的,边界值需要实测调。

三、坐标到表格行:换算链与区域命中

这是整个方案里技术上最核心的一环。接收端从 knock 回调拿到的是屏幕坐标(screenX / screenY),要经过四次换算才能落到单元格:

数据行

表头行

冻结区/滚动条

screenX screenY
屏幕坐标

窗口坐标
减去窗口原点

表格视口坐标
减去工具栏/表头

滚动补偿
加上 scrollTop

行列命中
行高与列宽求模

命中区域判定

定位巡检照片列

拒绝 + 提示碰数据行

几个工程要点,都来自姊妹篇踩过的坑,在台账场景有具体形态:

滚动补偿不能忘。台账两百多行必然要滚动,触点坐标是屏幕系的,表格行是文档系的,中间差一个 scrollTop。漏掉这个补偿,碰出来的行号会随滚动位置漂移——这是坐标转换链里最容易翻车的一环。

表头和冻结区要明确拒绝。台账通常冻结首行表头,碰在表头上没有任何业务含义,要给出"请碰目标设备所在行"的明确提示,不能静默失败让用户以为碰坏了。

列命中可以做减法。行是必选的(落点即行),列其实可以不依赖触点——照片列位置固定,直接按行定位到该行的照片列即可。这样换算链里"求列"这一步就退化成了查表,出错面更小。触点列坐标只用来辅助判断(比如碰在"序列号"列时提示"要不要顺手 OCR 录入",见第五节)。

窗口校验沿用 targetWindowId。多显示器多窗口是运维工位的常态(左边台账右边监控大屏),碰之前先校验命中的窗口是不是台账应用,不是就直接交给系统默认行为,不抢事件。

换算链落到代码上是这几步(按姊妹篇的坐标转换改写,去掉列求模):

// 1. 屏幕坐标 → 窗口坐标
const winX = screenX - windowRect.x
const winY = screenY - windowRect.y

// 2. 窗口坐标 → 表格视口坐标(扣掉工具栏与表头)
const viewY = winY - headerHeight - toolbarHeight

// 3. 滚动补偿:屏幕系 → 文档系,漏掉会导致行号随滚动漂移
const docY = viewY + scrollTop

// 4. 行命中:按行高取模,照片列固定查表,不再依赖触点列坐标
const rowIndex = Math.floor(docY / rowHeight)

function resolveTarget(rowIndex: number): PhotoCell | null {
  if (rowIndex < 0 || rowIndex >= rows.length) return null   // 越界
  if (rows[rowIndex].kind === 'header') return null          // 表头行明确拒绝
  return rows[rowIndex].cells.photo                           // 定位该行的巡检照片列
}
// 防呆与幂等:一次物理碰触只投递一次 + 内容指纹去重
const dedupeKey = `${rowIndex}:${photoFingerprint}`
if (recentDeliveries.has(dedupeKey)) return   // 手抖连碰,直接丢弃

await appendPhoto(rowIndex, photoUri, {
  shotAt: exifDateTime,       // 追溯用:拍摄时间
  operator,                    // 操作人
  undoToken,                   // 对接表格撤销栈
})
recentDeliveries.add(dedupeKey, { ttl: 2000 })

四、防呆设计:插错行这种乌龙,必须在链路上消灭

开头说的那次乌龙(12F-03 插到 12F-07),根因不是人马虎,是流程里没有任何一行代码或一个步骤知道"照片和行"的对应关系——对应关系只存在于拍摄者脑子里,靠人肉记忆维持。防呆要从两个方向做:

方向一:让错误更难发生。轻预览显示目标行号 + 设备编号,碰错了在确认前就能发现;对长得像的设备(同型号同朝向),可以在预览里附上该行已有的旧照片对比,一眼看出是不是这台。

方向二:让错误能被追溯。每次插入记录完整元数据:照片 EXIF 的拍摄时间、拍摄时的 GPS 粗定位(机房内可用蓝牙信标细化到机柜,可选)、触点行号、操作人。插入动作带 undoToken 对接表格的撤销栈,Ctrl+Z 直接撤。评审时如果发现照片与设备不符,元数据能还原"这张是什么时候、碰哪一行插进来的"——乌龙从"无法解释"变成"可定位"。

幂等同样要管住。手抖连碰两次不能插两张图。沿用姊妹篇的事件防抖(一次物理碰触只产生一次投递)加内容指纹去重(同一批次同一行已存在同指纹照片则跳过)双保险。

还有一条是台账场景特有的:巡检照片是留档证据,不允许覆盖。目标行已有照片时,默认追加而不是替换,替换必须走显式操作并留痕。这个约束比一般文档场景严,因为台账照片对得上对不上,事后是要担责任的。

五、进阶:一次碰触,把铭牌信息也录了

照片落行解决的是"对号入座",但台账里还有型号、序列号这些字段要手填。这两个字段全部印在铭牌上——也就是照片本身拍下来的东西。所以自然的进阶方案是:

照片入行后,本地 OCR 识别铭牌区域的型号、序列号文本,自动填充到该行对应列,人工只需扫一眼确认。识别置信度低的字段不高亮自动填、而是弹出候选让运维点选,宁可慢一点也不静默填错——序列号填错比留空更麻烦,资产盘点时会对不上。

这一步不依赖任何新系统能力,纯软件实现,但要注意两个边界:

  • 铭牌反光、贴膜、老化是常态,OCR 在机房实拍图上的准确率需要先拿自己的历史照片跑一轮评估,不要拿官方 demo 图的识别率做预期;
  • 涉密机房的设备信息能不能过 OCR 服务、能不能出内网,是接入前必须先问清楚的红线——离线端侧识别优先,这个方向鸿蒙端侧能力是够的。

把两条链路合起来,完整方案是这样:

阶段动作依赖能力
现场拍铭牌 + 面板照相机(现有)
碰触轻碰目标设备所在行knock 坐标回调(API 26)
落行照片写入巡检照片列坐标换算 + 区域命中
补录OCR 填型号/序列号端侧文本识别(现有)
追溯元数据留痕 + 可撤销undoToken + 插入日志

六、落地节奏与诚实的边界

这个方案我不打算停在纸面上,落地按三步走:

  1. 先跑通最小闭环:照片碰入台账行,不做 OCR、不做批次,把坐标到行号的换算链在自己机房的真实台账上调稳;
  2. 再补防呆与幂等:预览行号、连拍批次、去重、撤销栈对接;
  3. 最后评估 OCR:拿历史巡检照片测识别率,达标再开自动填充。

要诚实说明的边界有三条:一是 PC 端台账应用如果是第三方软件(比如直接用网页版表格),应用侧没有接入点,方案只适用于自研台账或支持扩展的表格组件——我们用的是自研运维平台,这条路是通的;二是 API 26 还在 Beta,接口形态可能调整,动手前以当前 SDK 文档为准;三是本文的效率对比全部是估算,跑通后我会用实测数据修订,包括 86 张照片场景下真实的耗时对比。

机房是运维的主场,台账是运维的证据链。"碰哪传哪"在消费场景里是方便,在运维场景里是准确——照片永远落在正确的行,这件事对留档追溯的价值,比省下的四五个小时更大。

七、总结与评论引导

回顾一下本文的三个核心结论:

  1. 台账是"落点即指令"的教科书场景:行即设备,触点即行号,四条判定标准全命中;
  2. 换算链的核心是"滚动补偿 + 行定位":列可以不依赖触点直接查表,出错面更小;
  3. 防呆比效率更重要:预览显行号、插入可撤销、照片不覆盖,把人肉记忆维持的对应关系变成链路保证的对应关系。

你在机房巡检或资产盘点时,被"照片对不上行"坑过吗?你们台账现在是怎么管理巡检照片的?评论区聊聊,如果你也在做运维平台的跨设备能力,欢迎交流接入细节。下一篇我会把最小闭环的实测数据带回来。

本文是「碰哪传哪」系列的第三篇:第一篇讲工程化落地的 5 个坑(坐标回调与幂等设计),第二篇讲五个可直接立项的应用构想,本篇是构想一"参考图直插文档"在运维台账场景的具体化。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐