SuperAPI AI 工具集

desktop-gui-dev

编程与开发

查看项目

更新于 10-27 16:26

技能介绍

Desktop GUI Dev 是一个面向桌面 GUI 应用开发全流程的技能,旨在帮助开发者选择、构建、调试、打包和审查桌面应用。它适用于 Codex 在需要脚手架或修改 Tauri、Electron 或版本感知的 Wails 应用时使用。

用途 该技能将桌面 GUI 应用视为两种类型之一:Web 外壳应用或原生工具包应用。Web 外壳应用(如 Tauri、Electron、Wails)具有四个耦合面:UI 外壳、原生桥接、本地数据与持久化、平台集成。原生工具包应用(如 Qt、SwiftUI、WinUI、GTK、.NET MAUI)将 UI 和原生层合并为一个代码库,但仍需明确状态、持久化、后台工作和打包的边界。技能强调保持契约、权限、打包元数据和运行时行为在所有接触面上对齐。

主要能力

  • 框架选择:根据需求推荐 Tauri、Electron、Wails 或原生工具包。
  • 实现路径选择:为 Web 外壳应用采用桥接优先架构,为原生工具包采用原生应用架构。
  • 确定性脚手架:提供各框架的创建和运行时命令参考。
  • 跨层同步:确保共享负载、命名约定、迁移、权限声明和用户可见文案一致。
  • 用户数据与系统状态保护:建议使用临时配置、夹具数据,避免删除真实数据或修改系统行为。
  • 任务特定工作流:涵盖新应用、UI 交互、原生桥接、持久化、平台集成和打包发布。
  • 发布前验证:运行 lint、类型检查、构建和测试,启动桌面运行时,验证主要用户路径和平台功能。

使用方式 首先确定用户需求:新桌面应用、功能添加、错误修复还是打包发布变更。识别目标平台、所需原生能力以及现有技术栈是否固定。尽早确定应用家族:Web 外壳或原生工具包。对于 Wails 仓库,立即从导入路径、CLI 或文档域确认版本边界。在编辑前阅读实际构建文件和应用清单,优先使用源代码而非过时文档。对于脚手架命令、安装先决条件、打包步骤和安全敏感默认值,优先使用官方文档。使用 rg 进行搜索,并将更改范围限制在保持跨层一致性的最小文件集。根据任务选择性加载参考文档:框架选择、桌面架构、发布清单,以及所选技术栈的一个实现指南。

适用场景

  • 构建带系统托盘和自动启动的桌面应用。
  • 使用 React 和本地 SQLite 存储脚手架 Tauri 应用。
  • 修复 Electron 预加载桥接并收紧渲染器安全边界。
  • 将现有 Web 应用转换为桌面应用。
  • 创建 macOS 菜单栏应用。
  • 为桌面应用添加全局快捷键、通知和深度链接。
  • 打包并签名 Windows 安装程序和 macOS 构建。
  • 在添加更新器支持前审查桌面应用架构。
  • 在发布前审计桌面应用发布计划。
  • 在添加登录项支持前审查 SwiftUI 菜单栏应用。
  • 修复 WinUI 应用,使窗口状态和本地设置重启后保留。
  • 脚手架 Qt 桌面应用并保持服务与控件代码分离。

限制 该技能不适用于仅浏览器 Web 应用、仅移动应用、后端服务或仅 CLI 工具。也不适用于网站设计或前端工作,除非请求明确包含桌面打包、原生集成或桌面运行时行为。对于 Qt、SwiftUI、WinUI、GTK 和 .NET MAUI,该技能主要用于技术栈选择、架构、跨层设计和发布就绪审查,具体工具包 API 和模板应参考官方工具包文档。对于签名、公证、安装程序或更新器发布工作,应以匹配的技术栈参考和官方平台文档为准。