SuperAPI AI 工具集

working-with-qt

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:在构建或修改 PySide6 Qt 桌面应用时提供一套架构与编码规则,规范信号、异步集成、经理模式与包装层写法。

主要能力与规则:选用 PySide6(LGPL、无系统依赖)而非 PyQt;禁止阻塞事件循环,不得使用 subprocess.run()、time.sleep() 或同步 HTTP;用 qasync 桥接 asyncio 与 Qt 事件循环;用 ThreadPoolExecutor 包装阻塞式第三方 API;对无类型库使用类型化包装,并通过 ruff banned-api 强制;信号定义在类级别而非 init 中;Qt 事件处理器用 camelCase(忽略 ruff N802),自有槽函数用 snake_case。

架构分层:UI(MainWindow、Dialogs、TrayIcon)经 signals/slots 连接 Manager(协调并发出信号),Manager 通过 QAsyncSignalBridge 异步调用 Service(异步操作),Service 依赖类型化接口访问 Wrapper(类型化第三方访问),Wrapper 再连接第三方库。

快速模式:从 Qt 发起异步操作使用 self._bridge.run_async(self._service.do_work(data), on_success=self._on_success, on_error=self._on_error);在异步上下文中调用阻塞库使用 result = await loop.run_in_executor(self._executor, self._sync_method);信号定义示例为 class MyManager(QObject): 内声明 work_completed = Signal(str) 与 work_failed = Signal(str)。

适用场景:PySide6 Qt 桌面应用的开发与改造,尤其是需要异步任务、第三方阻塞库集成、系统托盘、键盘快捷键、锁定管理器及用 pytest-qt 测试的项目。

限制:资料未提供安装命令、价格、平台要求或完整代码示例,更多完整模式需参见 guides/qt-patterns.md。