主题
核心特性总览
框架把桌面应用里反复出现的「脏活累活」沉淀成约定与基础设施，让你（和 AI）专注业务。
工程化能力一览
| 特性 | 一句话 |
|---|---|
| 🏛️ 五层架构 | App · Widget · Service · Core · Utils，依赖只向下；MainWindow 瘦壳，逻辑拆进各 Manager。 |
| ⚙️ 类型安全配置 | 借鉴 Flameshot ValueHandler。一行 AGILE_CONFIG_BOOL/INT/COLOR… 宏，自动生成 getter / setter / 信号 / reset，并按类型匹配设置 UI。 |
| 🗄️ 双 SQLite 数据层 | 内存库扛高频读写、磁盘库做 WAL 持久化；Entity 带 Active Record，QueryBuilder 链式构造，Migration 管版本。 |
| 🧱 Tool / Plugin 系统 | Tool 走策略 + 工厂（借鉴 Flameshot CaptureTool），Plugin 带完整生命周期与动态加载。 |
| 📡 EventBus | 类型安全的发布 / 订阅，订阅随 QObject 自动注销，让 Manager 间彻底解耦。 |
| 🖥️ 平台抽象层 | 热键 / 托盘 / 通知 / 自启动跨平台统一接口；#ifdef Q_OS_* 只许出现在 platform/。 |
| 🎨 主题与语义色板 | 亮 / 暗 / 自定义 + 跟随系统，借鉴 KDE KColorScheme，切主题不崩、支持高对比度。 |
| ↩️ 命令模式 · 撤销重做 | Command + CommandStack 封装 QUndoStack，支持宏命令与异步命令；命令面板（Ctrl+Shift+P）开箱即用。 |
还有这些
- Service 层：网络、加密、脚本、AI、更新、快捷键、国际化等业务服务，单例即用。
- QML 脚本扩展点：ScriptService 暴露 Hook 机制给用户脚本，主体仍是 QWidget。
- 国际化：
tr()→ lupdate → Linguist → lrelease 全链路 + 运行时切换语言。 - 测试与质量：Qt Test + CTest，clang-format / clang-tidy 统一风格与静态分析。
- 打包发布：CPack + windeployqt / macdeployqt + NSIS / DMG / AppImage + 自动更新。
提示
这一页只做「鸟瞰」。每一项特性背后，都对应着一个或多个可被 AI 自动激活的技能。