Repository navigation
v1.4.1
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.sh415 / 0、verify-interop.sh8 / 0。
升级
无数据库迁移;update.sh 照常。二进制体积与启动时间量级不变。