适用场景

Agile-Qt 为有一定复杂度、需要长期维护的桌面应用而生。

它最擅长这些

类型	为什么适合
📝 笔记 / 编辑器	双 SQLite + Active Record + 工作空间 + 命令面板 + QML 脚本扩展，QOwnNotes 同款基因。
🧰 工具集合 / 效率软件	Tool / Plugin 可插拔架构，新功能即新工具，配置系统自动生成设置 UI。
📸 截图 / 系统小工具	平台抽象层统一热键 / 托盘 / 通知，自定义绘制 + 命令撤销重做，Flameshot 同款基因。
🤖 AI 集成应用	内置 AI 服务封装（Claude / OpenAI 流式响应）、MCP 集成，做 AI 助手类桌面端事半功倍。

典型能力组合

你要做的	开箱即用的能力
本地数据持久化	双 SQLite + Migration + QueryBuilder
全局热键 + 托盘常驻	system-integration 技能 + 平台抽象层
暗色 / 跟随系统主题	ThemeManager + 语义化色板
插件化扩展	Plugin 生命周期 + ToolRegistry
自动更新 + 安装包	updateservice + CPack + 双仓库发布

诚实地说，它不适合……

• 纯网页应用 —— 那是 Web 框架的主场。
• 极简单页小工具 —— 只有一个按钮的程序，套五层架构反而是负担。
• 移动端 App —— 框架聚焦 Windows / macOS / Linux 桌面端。
• 重 3D / 游戏引擎 —— 需要专门的渲染管线，不在框架定位内。

判断标准

桌面端 · 有数据 · 要长期维护 · 希望 AI 高效参与开发——越符合，越适合 Agile-Qt。