- AppCore 增加 System.Data.Odbc 8.0.1，用于 ODBC/Access 数据源快照；本机 64 位 Access 与 dBASE 驱动实测通过。
- PDF 使用应用内标准 CJK 文本 PDF 输出，不增加第三方 PDF 库。
- AppCore 增加 SSH.NET 2026.0.0，用于密码/私钥认证、主机指纹验证和本地转发；NuGet 还原已通过。
- 下方为历史阶段记录；当前 Avalonia/AtomUI/Dock 的实际版本以项目文件为准。
本文档记录 Avalonia 迁移项目各阶段锁定的 NuGet 依赖版本组合，确保可复现构建。 对应
avalonia-migration-detailed-plan.md阶段 0 的"版本锁定"风险应对。
| 包 | 版本 | 说明 |
|---|---|---|
| Avalonia | 11.3.20 | 生态兼容基座（AtomUI/Dock/MessageBox 均基于 Avalonia 11） |
| Avalonia.Desktop | 11.3.20 | |
| Avalonia.Themes.Fluent | 11.3.20 | 基础主题 |
| Avalonia.Fonts.Inter | 11.3.20 | 默认字体 |
| CommunityToolkit.Mvvm | 8.4.2 | MVVM 源生成器 |
| Microsoft.Extensions.DependencyInjection | 8.0.1 | DI 容器 |
| AtomUI.Desktop.Controls | 5.1.4 | Ant Design 风格主题（对齐原 AntdUI 视觉）；依赖 Avalonia 11.3.10。旧入口包 AtomUI 已弃用，2026-08-25 由 AtomUI 5.0.2 迁移而来 |
| Dock.Avalonia | 11.3.12.1 | 停靠布局系统；依赖 Avalonia 11.3.x |
| MessageBox.Avalonia | 3.3.1.1 | 消息框 |
| ReactiveUI.Avalonia | 11.3.8 | 由 AtomUI 传递引入；提供 UseReactiveUI() |
- 为何固定 Avalonia 11.3.x：计划所选的核心生态库（AtomUI.Desktop.Controls 5.1.4、Dock.Avalonia 11.3.x、MessageBox.Avalonia 3.3.x）均基于 Avalonia 11 构建；Avalonia 12 需 AtomUI 6.x / Dock 12.x 才支持，属于后续升级项。
- AtomUI 包重构迁移（2026-08-25）：官方已弃用旧入口包
AtomUI，重构为AtomUI.Desktop.Controls系列（主包 + 可选 DataGrid/ColorPicker/Extras）。本项目仅用基础控件（Button/CheckBox/ComboBox/TabControl/TextBox），只需主包。API 变更：- 初始化：
builder.UseOSSControls()→builder.UseDesktopControls() - C# 命名空间：
AtomUI.Controls→AtomUI.Desktop.Controls（UseAtomUI 扩展在AtomUI命名空间） - XAML 命名空间：
xmlns:atom="using:AtomUI.Controls"→xmlns:atom="https://atomui.net"（5.1.4 起 using 形式失效）
- 初始化：
- 尚未引入：
Ursa.Avalonia、OxyPlot.Avalonia、Icons.Avalonia.FontAwesome等按阶段计划在对应阶段接入（部分包名/版本需在接入时复核）。
当 Avalonia 12 生态成熟后，可将基座升级至 Avalonia 12.1.x + AtomUI 6.x + Dock 12.x，届时同步更新本表。