Skip to content

v1.4.1

Choose a tag to compare

@github-actions github-actions released this 11 Oct 19:08
· 19 commits to main since this release

v1.4.1 —— 补丁:会话归属残留、设置页英文译文与文档校正

v1.4.0 换引擎后的收尾修复。无数据库迁移、无配置变更、无破坏性改动,升级即换二进制。

1. 会话被丢弃后仍带着旧设备 ID(cwmp)

v1.4.0 加了「会话指纹撞车就丢弃该会话」的保护(同一 NAT/CGNAT 出口、同型号同固件的
两台设备会撞进同一个会话,bindDevice 无条件覆盖 DeviceID 会让 A 设备的回执写进
B 设备名下)。但 dropLocked 只从 byID/byKey/byDevice 三个 map 删了索引,
没清会话对象自身的 DeviceID。

那个 *Session 可能还被别处持有(inflight 的 HTTP 请求、Cookie 重放)。带着旧
DeviceID 的它一旦被继续使用,回执还是会落到那台设备名下 —— 正是那次修复要防的事。
现在 dropLocked 会把 s.DeviceID 置 0;置 0 也让 bindDevice 的「已属于别的设备」
判断重新成立(0 = 未绑定)。

这条是补回归测试时被断言查出来的(修复 bindDevice 时只顾着清 map,漏了对象字段)。

2. 三处修复的回归测试

v1.4.0 的三个修复原本一条测试都没有,下次重构把它们悄悄改回去不会有人发现。
本次补上,并把「测试守得住」验证过(把事务改回去,同窗口立刻插出 9 条而不是 1 条):

  • cwmp/session_bind_test.go:撞车拒绝改绑 + byDevice 不得残留(残留会让
    hasSession 恒真,任务再也不排队)、同设备顶掉旧会话、同设备反复重绑幂等;
  • store/optical_history_test.go:8 路并发写同一窗口,-race 下仍只合并成 1 条;
  • web/settings_listen_test.go:normalizeListen 此前零测试 —— 它是唯一挡住
    「面板被绑到意外地址」的一道关(设成 0.0.0.0 的后果是静默的),7 个合法 +
    6 个非法输入。

3. 设置页提示语的英文译文(web)

英文界面下改端口 / 改密码 / 设 token 全会露出中文 —— 而这几个恰是管理员最常做的动作。
补 9 条(含「已保存」「密码至少 6 位」「两次输入的密码不一样」与三条 token 校验)。

附带一条经验:带动态尾巴的("保存失败:" + err)必须写成带 %s 占位符的词条,
否则 TSmart 的整串匹配查不到(catalog 里没有那个完整串),会静默回落成中文 ——
光看词条表「有没有这条」查不出问题,得实跑。

4. 文档校正

  • README 徽章不再裂图:GitHub 会把所有 README 图片经 Camo 代理回源,而 shields.io
    在这条路径上稳定超时(直连 200 / 0.4s,经代理 504 / 4.6s)。CI 与 Release 徽章改用
    GitHub 官方的 actions/workflows/<file>/badge.svg,Go 与 License 徽章改为仓库内自带的
    SVG(docs/images/badges/),从此不依赖任何外部图床。
  • 鉴权语义写对:README / DOCKER.md 原文是「开了面板鉴权时,/api 与 /metrics 认两种
    凭据」—— 这个限定在 v1.4.0 已不成立。现在写清:配了 token 就一定校验,与面板账号是否
    启用无关;不配则跟随面板自身鉴权。
  • 补上 v1.4.0 漏记的功能:/inventory 资产盘点页、/help 使用帮助、设置页一键下载
    Prometheus 抓取配置与 Grafana 看板;目录结构补 idl/ 与 biz/。
  • 验收项数:CONTRIBUTING 写的「当前 373 项」实为 415 项,已更正。
  • 部署文档:K8s 镜像示例跟随版本;DOCKER.md 补 compose 层的 LIGHTCAT_* 变量表
    (含 LIGHTCAT_PASS 的 :? 校验对所有子命令生效这条易踩的规则)。

已知边角

TSmart 对嵌套括号拼出来的句子翻不干净(如 无线组网(信号 75%(3/4 格)):外层翻了、
里头的「/4 格」留着)。根因是非贪婪捕获加后续字面量锚定在嵌套括号处提前闭合,而译文里
又保留着中文括号;加兜底会被同一条词条的宽松正则再匹配回去形成死循环。属于该匹配策略的
固有局限,修它需要换成按括号配平切段,是独立一件事,本次不扩大改动面。

验收

  • go build / go vet / gofmt 干净,go test ./... 与 -race 全绿;
  • verify-s1.sh 415 / 0、verify-interop.sh 8 / 0。

升级

无数据库迁移;update.sh 照常。二进制体积与启动时间量级不变。