/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
巡检软件显示“距离 0.0 m”时，操作者可能理解为目标就在相机旁边，也可能理解为当前没有测距。一个数值同时承担两种含义，后面的告警、记录和地图显示都会变得含糊。
Tofu6 的 T-JSON 距离信息是否出现、采用何种来源，与工作场景和设备配置有关；硬件指南也给出激光测距经配套串口服务器接入的路径。因此，在具体设备没有核实之前，不应把所有距离字段统一标成“激光距离”。以下讨论客户端的数据表达，不提供测距精度承诺。
1. 数值与来源必须一同保存
一个完整的观测记录至少包括值、单位、来源、时间和有效性。来源可由项目定义为已核实的传感器测量、模型估计或未知。不要仅根据字段名字猜测来源；如果协议没有直接携带来源标记，应依据出厂配置和已验证的工作模式建立映射，并保留配置版本。
有效性也不等于数值是否为正。正数可能已经过期，也可能属于上一目标；零可能是真实边界值，也可能是设备约定的无效值。具体规则必须来自协议或实测确认，不能由界面设计人员自行决定。缺少字段时，应进入“未提供”，而不是强行补零。
图1：作者绘制的工程概念示意，非设备实测。
2. 给观测加上新鲜度
假设最后一次有效距离在十秒前收到，随后设备切换了观察对象。界面若继续显示旧值而不标记时间，视觉上就像完成了新测量。客户端可将最后接收时间和目标上下文一起保存；目标改变、连接重建或模式切换时，使旧值失去当前有效性。
新鲜度阈值应根据业务更新周期和现场需求决定。本文不规定所有设备通用的秒数。对快速变化的观察过程，阈值可能较短；对静态记录，保留历史值可能有用，但必须明确显示“上次有效值”和对应时间。
时间差计算采用单调时钟，导出记录同时保留可读时间。两者职责不同：前者用于可靠超时，后者用于人员查阅。若跨设备对齐，还需要额外处理时钟同步误差，不能以客户端到达时刻代替精确采样时刻。
3. 显示层避免制造精度错觉
接口保留一位小数，只说明输出格式，不证明测量精度达到十分之一米。界面不应自行补成更多小数位，也不应在来源未知时显示高精度范围环。需要距离误差范围时，应使用对应传感器、算法与条件下的验证结果，不能通过输出位数推算。
可把“当前有效”“历史有效”“未提供”“来源未确认”做成不同状态。颜色只是辅助，文字必须说清楚，避免仅靠红绿变化。导出文件同样保留状态列，不要在导出时把所有缺测都变成数值零。
图2：作者绘制的工程概念示意，非设备实测。
4. 为什么不能直接混合平均
两路距离若来自不同测量机制，不能看到两个数就取平均。首先要确认测的是同一对象、同一时刻以及同一种距离定义；斜距、水平距离、镜头到对象的距离可能不同。然后才能讨论误差模型和融合权重。
举例说，两条记录分别为100和120，简单平均得到110，但这并不自动比任一路更准确。如果其中一条对应前景遮挡物，平均只是生成第三个错误数。没有关联证据时，保留两路原始记录比输出一个看似稳定的合成值更有解释力。这里的数值只是逻辑算例。
5. 把异常情况写进验收
验收表应包括未配置测距设备、测距暂不可用、字段缺失、连接中断、目标切换及模式改变等情况。每次检查界面、告警和导出文件是否一致。重点不是所有情况下都有数字，而是无效数据没有被下游当成有效观测。
图3：作者绘制的工程概念示意，非设备实测。
如果项目把距离用于自动判断，还需逐一检查边界条件：未知是否会触发默认告警，过期数据是否被持续使用，历史记录能否追溯来源。设备原始报文、配置快照与客户端解释规则应同时留档。完成这些步骤，距离显示才从一个文本框变成可以审查的数据链。
资料与说明
– T-JSON 协议，距离字段说明：https://www.tofuwiki.com/cn/docs/TJSON
– Tofu6 硬件使用指南：https://www.tofuwiki.com/cn/docs/tofu6hardware
本文由 Tofu Intelligence 设备提供方撰写，涉及自有设备的技术应用说明。文中的架构、算例和验收方法为工程分析建议，不代表已实现的固件功能、客户案例或性能承诺。文字和原创示意图使用 AI 辅助整理，技术内容依据官方资料核对；实际支持范围以设备型号、固件和出厂配置为准。
