SuperAPI AI 工具集

multi-ui-architecture

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:适用于需要多界面的应用,例如同时提供 GUI 与 CLI,或计划后续增加 API 的项目。核心原则是界面即插件,业务逻辑位于领域层,新增界面不应改动业务逻辑。

架构分层从上到下为:表现层(Qt GUI/PySide6、CLI/typer,可选 API/FastAPI)、领域层(Managers 负责编排、Models 为 dataclasses 与 TypedDicts、Services 承载业务规则与纯逻辑)、工具层(Helpers 无状态函数、Wrappers 带类型的第三方接口、Platform 平台相关实现)。依赖只能向下流动,领域层不得导入表现层。

主要能力与用法:通过 main.py 统一入口,依据命令行参数判断走 CLI 还是 GUI;GUI 与 CLI 复用同一个 manager,分别处理终端输出与界面显示。资料也提到 FastAPI 可作为另一种表现层消费同一领域层,但明确 GUI + CLI 是主要关注点。

限制:资料未提供安装命令、配置文件、测试方式、性能数据或具体 GUI/CLI 框架版本;示例中的错误处理与返回结构来自资料原文。