~/notes/cyber-probe-03-settings-form-and-calibration-anchor.md1083 字

项目实战Cyber Probe 监控系统学习笔记 · 03/03

Cyber Probe(三):设置表单如何保留流量校准锚点

从读取保存值到服务端 resolveSavedCalibration,讲解为什么实时用量不能填回校准字段,以及无关编辑如何保留锚点。

目录 5 节

Cyber Probe 的流量展示使用“校准基线加锚定后的网卡增量”。页面看到的当前已用量是计算结果,设置里保存的基线则是计算输入。两个数字很相近,却承担不同职责。

本篇围绕 9 月 27 日的设置修复展开:重新打开主机编辑弹窗时如何恢复输入,以及只修改名称或价格时,服务端如何避免重新锚定。

一、重新打开设置,不能重新设定锚点

9 月 27 日的修复处理了一个很容易忽略的问题:实时节点数据里的“当前用量”,不是设置里保存的“校准基线”。

用户打开设置,只改主机名或价格,并没有打算重新校准流量。如果表单拿当前用量填充校准字段,提交时就可能把一次普通编辑变成重新设定锚点。

现在编辑弹窗会单独读取已保存的设置,取得实际基线,再加载流量输入区域。读取失败时禁止保存,避免把初始占位值零写回去,意外取消校准。

服务端也保持相同约定:只有基线确实改变才重新锚定,其他配置编辑保留原锚点。当前版本中,基线填零表示取消校准,直接回到网卡累计口径。

前端 HostEditDialog.tsx 的关键顺序是先取保存值,再允许提交。省略错误提示和生命周期处理后,可以概括成:

const res = await fetch(`/api/v1/nodes/${nodeId}/settings`);
if (!res.ok) throw new Error(`服务返回 ${res.status}`);

const saved = await res.json();
setDraft((prev) => ({
  ...prev,
  bandwidth_used: saved.bandwidth_used || 0,
}));
setSettingsLoaded(true);

// 提交入口先检查:if (!settingsLoaded) return;

实际代码会编码节点 ID,并在组件关闭后忽略迟到结果。这里的 settingsLoaded 不只是加载提示,它防止占位值被当成真实配置写回。

这次修复让我特别注意表单与状态接口的区别。实时接口用于展示当前结果,设置接口用于恢复可编辑输入;字段看起来相似,也不能互相替代。

二、服务端也要保护保存语义

前端读取正确基线还不够,提交后服务端必须判断基线是否真的变化。pkg/server/api.go 的 resolveSavedCalibration 按三个分支处理。下面省略上行、下行锚点字段,只保留合计逻辑:

switch {
case ns.BandwidthUsed == 0:
    ns.BandwidthBaseCounter = 0
case prev == nil || ns.BandwidthUsed != prev.BandwidthUsed:
    ns.BandwidthBaseCounter = liveUp + liveDown
default:
    ns.BandwidthBaseCounter = prev.BandwidthBaseCounter
}

第一种取消校准,第二种把新基线锚定到当前网卡值,第三种保留已有锚点。完整实现对两个方向执行对应处理,不能只复制合计片段替代原函数。

三、为什么每次保存都重新锚定会丢流量

假设已保存基线是 1000 字节,锚点是 5000 字节,目前网卡累计达到 15000 字节,当前用量应为 11000 字节。只改主机名时,如果重新把锚点设为 15000,公式就会变成 1000 加零,此前累计的 10000 字节从展示中消失。

这些字节数只是简化示例。billing_test.go 的 TestResolveSavedCalibrationKeepsAnchorsOnUnrelatedEdits 正是保护这条关系:相同基线保留锚点,新基线重新锚定,取消校准清空锚点,首次校准采用当前值。

四、从真实修复提炼表单规则

这条路径给设置编辑增加了两项要求:占位零值在读取完成前不能提交,实时计算结果不能替代保存的输入值。否则一次普通编辑也可能触发算法状态变化。

本文依据 9465e5f 及当前对应代码整理,没有重新执行回归测试。继续阅读时,先跟踪 HostEditDialog.tsx 的读取与保存,再对照服务端三个分支,最后用测试中的数值检验锚点是否保持。

项目代码:wildalley/probe。

系列阅读

上一章:Cyber Probe(二):流量校准基线与计数器重置

  1. Cyber Probe(一):探测事件去重与真实丢包统计
  2. Cyber Probe(二):流量校准基线与计数器重置
  3. Cyber Probe(三):设置表单如何保留流量校准锚点