27. Upgrade and version numbers
[!ref] Full details in the User Manual, "Upgrade, backup and sync".
27.0 Config directory brand migration (zcode → avlcode)
From v0.6.30-alpha the internal identifier migrates from zcode to avlcode, completed automatically on startup / workspace open, with a toast, keeping old names for dual-read fallback:
| Old | New |
|---|---|
Global config dir ~/.config/zcode/ |
~/.config/avlcode/ |
In-workspace .zcode/ (incl. rag/, sbom.*, etc.) |
.avlcode/ |
Env vars ZCODE_… (e.g. ZCODE_DISABLE_VENV_AUTODETECT) |
AVLCODE_… |
Config YAML and frontmatter fields (x-zcode-…, etc.) |
corresponding avlcode / x-avlcode-… |
UA trailing token zCode/<ver> |
avlcode/<ver> |
SSH remote ~/.zcode, remote workspace .zcode |
~/.avlcode, .avlcode |
Any residual "zCode" in the UI or external output is unified to "AVL Code". If you've hard-coded the old paths / variables in scripts, switch to the new names.
27.1 Version format
MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
| Segment | Meaning |
|---|---|
| MAJOR | Incompatible change (data migration / config break) |
| MINOR | New feature (backwards-compatible) |
| PATCH | Fix / optimisation (backwards-compatible) |
| PRERELEASE | alpha.<n> / beta.<n> / rc.<n> |
| BUILD | Build metadata; not part of version comparison |
27.2 Upgrade paths
| Path | Cadence | Description |
|---|---|---|
| In-app upgrade | Daily check by default | Recommended |
| Manual download (install-free) | As needed | Official download page www.avlcode.cn/#download; download, replace and run; config preserved |
| Internal marketplace | Per team config | Org admin controls versions |
The official download page provides per-platform builds (Windows x64 / macOS Universal · Apple Silicon / Linux x64 · AppImage · Snap · WebKit 4.1 / Kylin V10 SP1 / UOS V20) on the alpha channel — always the latest build.
27.3 Upgrade signature
| Step | Description |
|---|---|
| Download | Pulled from internal upgrade source to local cache |
| Verify | GM signature + embedded public key |
| Replace | Atomic swap of the main binary on verify success |
| Rollback | Auto-rollback on verify or launch failure |