第二十七节 升级与版本号
[!ref] 详解见用户手册「升级、备份与同步」节。
27.0 配置目录品牌迁移（zcode → avlcode）
自 v0.6.30-alpha 起，内部标识统一由 zcode 迁移为 avlcode，启动 / 打开工作区时自动完成、有 toast 提示、保留旧名双读回退：
| 旧 | 新 |
|---|---|
全局配置目录 ~/.config/zcode/ |
~/.config/avlcode/ |
工作区内 .zcode/（含 rag/、sbom.* 等） |
.avlcode/ |
环境变量 ZCODE_…（如 ZCODE_DISABLE_VENV_AUTODETECT） |
AVLCODE_… |
配置 YAML 与 frontmatter 字段（x-zcode-… 等） |
对应 avlcode / x-avlcode-… |
UA 尾部令牌 zCode/<ver> |
avlcode/<ver> |
SSH 远端 ~/.zcode、远程工作区 .zcode |
~/.avlcode、.avlcode |
界面与对外输出里残留的「zCode」统一为「AVL Code」。脚本里写死过旧路径 / 旧变量的，建议改用新名。
27.1 版本号格式
MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
| 段 | 含义 |
|---|---|
| MAJOR | 不兼容更改（数据迁移 / 配置不兼容） |
| MINOR | 新功能（向后兼容） |
| PATCH | 修复 / 优化（向后兼容） |
| PRERELEASE | alpha.<n> / beta.<n> / rc.<n> |
| BUILD | 构建元数据，不参与版本比较 |
27.2 升级路径
| 路径 | 频率 | 说明 |
|---|---|---|
| 应用内升级 | 默认每天检查 | 推荐 |
| 手动下载（免安装） | 按需 | 官网下载页 www.avlcode.cn/#download，下载直接替换运行，配置目录不动 |
| 内部市场 | 视团队配置 | 组织管理员控制版本 |
官网下载页按平台提供构建（Windows x64 / macOS 通用版·Apple 芯片版 / Linux x64·AppImage·Snap·WebKit4.1 / 银河麒麟 V10 SP1 / 统信 UOS V20），走 alpha 渠道、恒为最新构建。
27.3 升级签名
| 步骤 | 说明 |
|---|---|
| 下载 | 从内部升级源拉到本地缓存 |
| 验签 | 国密签名 + 嵌入公钥校验 |
| 替换 | 验签通过后原子替换主二进制 |
| 回滚 | 验签失败 / 启动失败时自动回滚到上一版本 |