Files
NexusGate/panel-go/golden
aaaamoooo b49c134513 feat(agent+panel): sing-box core version probe and display (round-2 #4)
agent-go: engineReport gains singBoxVersion. The probe runs
`sing-box version` once, parses the version token from its first line
('unknown' from unstamped builds reports empty), and caches it keyed by
the binary's mtime+size — re-probed only when an engine install/update
replaces the file. Steady-state heartbeats pay one stat, no subprocess.
Agent version stays 0.6.8.

panel-go: EngineState.singBoxVersion persisted from heartbeats (old
agents without the field keep showing '-'), servers table core-version
column now renders it. Golden gains heartbeatWithEngine +
serversAfterEngineHeartbeat sections locking the full chain, plus a
listen-address (<hostip>) normalization for the sandbox bind address.
singboxversion_test.go covers parsing, cache hits, and re-probe on
binary replacement.
2026-10-21 11:18:00 +08:00
..

Go 面板金标准回归基线(golden)

2026-10-21 起 Node 实现冻结退役、Go 单一真源,difftest(Node 差分)随之退役。 本目录把 Go 面板在种子库上的当前行为冻结为回归基线,替代 difftest 的 守门角色:

  • golden.mjs — 抓取/校验脚本。复用 ../difftest/ 的种子库(seed.json) 与学习式 Normalizer(../difftest/lib.mjs):以种子副本启动一个 Go 面板, 按固定剧本驱动(登录 → 种子 agent 心跳 → 列表 → 凭据 → 订阅全格式 → 建服务器/注册 agent → 建客户/节点/分配/部署并 drain 部署任务 → 用量上报 两轮 → 呈现投影 → UI 式全量 PATCH 节点 → /api/system 结构 → 备份导出 → 错误用例),全部响应归一化后存入 golden.json(25 个 section)。
  • golden.json — 冻结的行为快照(2026-10-21,基线提交时的 Go 现状, 二进制由 HEAD 156a31c 构建)。

用法:

node golden.mjs capture [--bin /path/to/nexusgate-panel]   # 重新冻结(仅在确认行为变更为预期时)
node golden.mjs verify  [--bin /path/to/nexusgate-panel]   # 与基线比对,有差异退出码 1 并打印首个 diff 路径

约定:

  • verify 出现 diff 时,先判定是预期变更(本版 9 项修改各自的预期 diff 在 NEXT-ROUND-REPORT.md 中逐项登记)还是回归;预期变更在对应项提交里 一并重新 capture 并在提交说明中注明 section 名。
  • /api/system 的数值多为实时采样,脚本只保留结构与确定性计数 (nodesTotal/customersTotal/online* /connections),其余数值与 IP 压成 占位;uptime 类键同样压平。其余 section 的数值都是剧本确定性结果, 逐字比对。
  • 剧本对时间的依赖已被窗口设计吸收(presence 180s 窗口、心跳在线判定), 正常复跑应恒 PASS;偶发 FAIL 先复跑一次区分抖动与真回归。