后端与全仓代码质量清理（golangci 扩展集 · 测试质量 · 并发安全 · 文档同步）

代码质量全量清理，零行为变化：golangci 扩展集 13 类 linter（gosec/modernize/perfsprint/canonicalheader/usestdlibvars/wastedassign/intrange/errorlint/forcetypeassert/recvcheck/exhaustive/unparam）全量修复，测试代码质量（testifylint/thelper/usetesting）25→0，frpc 进程生命周期真 bug（进程组击杀）、全仓 go test -race 6 类数据竞争（含 1 个生产竞争）、SPDX license 头补齐 131 文件、前端测试套件 next-intl 迁移后 44 失败→全绿、过期 swagger 文档重新生成、pnpm-workspace 构建审批。

Experiments: #2-#17, #18, #20, #21, #23
Metric: total_issues 108 → 8 (-92.6%)

pkg/util/version_compare.go

@@ -1,13 +1,13 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 package util
 
 import "strconv"
 
 func compareVersionNumbers(left, right VersionInfo) int {
-	maxLen := len(left.Numbers)
-	if len(right.Numbers) > maxLen {
-		maxLen = len(right.Numbers)
-	}
-	for index := 0; index < maxLen; index++ {
+	maxLen := max(len(right.Numbers), len(left.Numbers))
+	for index := range maxLen {
 		leftValue := 0
 		rightValue := 0
 		if index < len(left.Numbers) {
@@ -37,11 +37,8 @@ func compareGitDescribeDistance(left, right VersionInfo) int {
 }
 
 func compareGitDescribeTails(left, right VersionInfo) int {
-	maxLen := len(left.GitDescribeTail)
-	if len(right.GitDescribeTail) > maxLen {
-		maxLen = len(right.GitDescribeTail)
-	}
-	for index := 0; index < maxLen; index++ {
+	maxLen := max(len(right.GitDescribeTail), len(left.GitDescribeTail))
+	for index := range maxLen {
 		if index >= len(left.GitDescribeTail) {
 			return -1
 		}
@@ -69,11 +66,8 @@ func comparePrereleaseIdentifiers(left, right VersionInfo) int {
 		return -1
 	}
 
-	maxLen := len(left.Prerelease)
-	if len(right.Prerelease) > maxLen {
-		maxLen = len(right.Prerelease)
-	}
-	for index := 0; index < maxLen; index++ {
+	maxLen := max(len(right.Prerelease), len(left.Prerelease))
+	for index := range maxLen {
 		if index >= len(left.Prerelease) {
 			return -1
 		}