// Package version 承载"这个二进制是什么"的构建期身份。 // // 三个值**全部由构建期注入**(正本 §6.1:版本号只有一个来源,且要能从产物读回来): // // go build -trimpath \ // -ldflags "-X knowledge-governance/internal/version.Number=$(python3 scripts/version.py) \ // -X knowledge-governance/internal/version.CommitSHA=$(git rev-parse --short=12 HEAD) \ // -X knowledge-governance/internal/version.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \ // ./cmd/api // // 三条纪律: // // 1. **不要**把它们改成编译期常量,也**不要**另建仓库根的 VERSION 文件 —— // 版本号的唯一来源是 CHANGELOG.md,由 scripts/version.py 解析。 // 放第二份副本的结果是发版要改两处,忘一处就漂移。 // 2. **不要**给这些变量设"看起来正常的默认值"。未注入时保持下面的零值, // 好让"忘了注入"表现成一个显眼的 dev,而不是一个假的正经版本号。 // 3. `Number` 的正确性由 internal/version 的契约测试兜底:注入进去的号 // 必须等于 CHANGELOG.md 顶部的已发布版本(CI 会带 -ldflags 跑它, // 并额外断言"没有 SKIP" —— 被跳过的断言等于没有断言)。 package version // Number / CommitSHA / BuildTime 由 -ldflags -X 注入;未注入时保持下面的值。 var ( Number = "dev" CommitSHA = "unknown" BuildTime = "unknown" )