# 项目记忆（长期沉淀）

> 本文件保存**长期不变 / 不易频繁更新**的项目元信息。
> 当前实现进度、工单状态、未完结事项等"短期快照"请见 [.trae/rules/项目/04-即时状态记忆.md](../rules/项目/04-即时状态记忆.md)。
> 项目划分、依赖方向、运行模式见 [.trae/rules/项目/01-项目架构.md](../rules/项目/01-项目架构.md)。

## 关键依赖版本（含具体小版本号）

- **运行时**：.NET 10.0（SDK 10.0.201）
- **C# 语言**：C# 13
- **EF Core**：10.0（SQLite Provider）
- **API 文档**：Swashbuckle 10.1.7
- **前端**：Vue 3 / TypeScript 5 / Vite 5；Axios + Pinia
- **桌面**：Avalonia（Linux/Windows/macOS）
- **跨平台原生**：MAUI（Android/iOS/Windows/macOS）

## 重要历史决策（不在即时状态记忆中重复记录）

- **.NET 10 适配**：针对 .NET 10 预览版特性（如 Windows TFM bug）进行规避与适配
- **Android 稳定性**：移除自动初始化 Provider，解决 AndroidX 相关崩溃
- **多平台构建开关**：通过 `Directory.Build.props` 优化非目标平台的构建依赖
- **跨平台热键平台拆分**：Avalonia 与 MAUI 各自实现 `IGlobalHotKeyService`，平台目录分离

## 历史变更时间轴

- 2026-04-10：项目初始化与基础记忆建立
- 2026-04-13：升级至 v1.2.8，同步 CloudSync 与 DynamicApi 文档
- 2026-06：术语统一与目录中文化（详见 `04-即时状态记忆.md` § 五）