版本與升級
這裡是 AppFuse 消費端的升級入口。無論只升級 Web、只升級 Server，或同時升級整個 workspace，都先從本頁開始。
升級前先確認三件事
- 在當前發布線確認目標版本與執行環境基線。
- 依目標版本類型閱讀正確的 Changelog：
- 正式版讀取對應版本區段。
alpha、beta、rc、SNAPSHOT讀取[Unreleased]。
- 按照框架升級指南完成預檢、依賴更新、migration 與驗證，不只修改版本號。
依需求選擇入口
| 我現在要做什麼 | 從這裡開始 |
|---|---|
| 確認最新 Web／Server 版本與相容基線 | 當前發布線 |
| 評估升級風險與完整操作順序 | 框架升級指南 |
| 查看 Web 新功能、移除項目與修正 | Web Changelog |
| 查看 Server 新功能、migration 與破壞性變更 | Server Changelog |
| 理解 SemVer、CalVer 與 pre-release 規則 | 版本編號 |
建議升級順序
確認目標版本
→ 閱讀 Changelog
→ 搜尋 Removed / Deprecated API 使用點
→ 更新依賴
→ 執行 migration
→ build / test
→ 部署 smoke test
→ 核對 runtime 版本與 build commit
Web 與 Server 透過 HTTP 契約整合，沒有要求兩個框架版本號逐位綁定；但同一個 workspace 同時使用兩者時，仍須分別核對實際依賴版號、完成兩份 Changelog migration， 並執行整合測試。不要假設參考實作已經使用本頁列出的最新框架版本。
:::caution 不要只看版號是否安裝成功 依賴解析成功不代表升級完成。資料庫 migration、設定鍵、預設行為與公開 API 移除都可能只在 編譯、啟動或部署後出現。 :::