StudioX 是一个原生 macOS AI 创作工作台。只需配置一个 KIE API Key,即可在同一应用中使用图像、音频和视频模型,管理提示词, 并通过无限画布组织多步骤创作流程。
应用使用 SwiftUI、AppKit 和 SwiftData 构建,不包含 Electron、WebView 或 Node.js 运行时。界面遵循 macOS 原生交互,并使用系统 Liquid Glass 效果。
- 快速生成:在统一表单中完成图像、音乐、语音、角色和视频生成。
- 多模型选择:根据图像、音频、视频分类选择模型,并显示对应参数。
- 参考素材:支持选择或拖入图像、视频和音频,上传后显示缩略图与状态。
- 批量任务:使用同一提示词一次提交 1–4 个任务,并在任务队列中查看进度。
- 任务复用:一键重新生成,或将历史任务的提示词、模型参数和参考素材载回输入区。
- 提示词管理:按项目保存提示词,以一级标题作为名称,并可快捷插入生成表单。
- 无限画布:使用提示词、任务、素材、输出、备注和分组节点搭建工作流。
- 原生预览:直接预览图片、音频和视频,支持手动下载与自动下载。
- 本地优先:API Key、任务、提示词、画布和设置均保存在本机。
| 类型 | 模型 |
|---|---|
| 图像 | GPT Image 2、Nano Banana 2、Grok Imagine、Gemini Omni Character |
| 音频 | Suno Music、Gemini Omni Audio |
| 视频 | Gemini Omni Video |
模型由 KIE API 提供。实际可用性、计费和内容政策以 KIE 当前服务为准。
- Apple Silicon Mac
- macOS 26 或更高版本
- Xcode 26,或兼容 Swift 6.2+ 的开发工具链
- KIE API Key
当前仓库提供源码构建,暂未提供经过 Developer ID 签名和公证的安装包。
git clone https://github.com/jdbd25414-ops/studiox-macos.git
cd studiox-macos
./script/build_and_run.sh --verify脚本会完成以下操作:
- 停止正在运行的旧 StudioX 实例。
- 使用 Swift Package Manager 构建应用。
- 生成并临时签名
StudioX.app。 - 安装到
~/Applications/StudioX.app。 - 启动应用并确认进程正常运行。
完成后,可以从“应用程序”或 Spotlight 打开 StudioX。
- 打开 StudioX,在工具栏进入“设置”。
- 填写 KIE API Key。
- 选择下载目录,并决定是否启用自动下载。
- 返回“快速生成”,选择模型并输入提示词。
- 如需参考素材,可点击“选择文件”,或将文件直接拖入窗口。
- 点击“开始生成”,在右侧任务队列查看状态和结果。
提示词第一行可使用 # 标题。任务队列会使用该标题和创建时间命名任务;没有一级标题时,
任务仅显示创建时间。
- 使用项目整理不同主题的提示词。
- 每条提示词必须以
# 标题开头,该标题会作为索引名称。 - 支持创建、重命名、删除、搜索和一键复制。
- 可以从快速生成的提示词菜单或编辑器右键菜单直接导入。
- 在侧栏打开“无限画布”,创建画布项目。
- 通过右键菜单添加提示词、任务、素材和输出节点。
- 将提示词或素材连接到任务节点,再将任务连接到输出节点。
- 在任务节点中选择模型并调整参数。
- 点击输出节点的运行按钮,生成状态和结果会直接显示在节点中。
画布支持平移、缩放、框选、多选、复制、剪切、粘贴、分组和文件拖入。画布、节点、连线 与视口均保存在本机,当前版本不提供云同步或多人协作。
- 默认下载位置为系统“下载”文件夹,也可以在设置中选择其他目录。
- 每个画布输出节点可以使用独立保存位置。
- 文件重名时会自动编号,不覆盖已有文件。
- Release 构建使用 macOS Keychain 保存 API Key。
- 设置使用
UserDefaults,任务、提示词和画布使用 SwiftData 保存。 - 上传素材会发送至 KIE 文件服务,生成请求会发送至对应的 KIE API。
请勿在 Issue、日志或截图中公开 API Key 和私人素材。
构建并运行:
./script/build_and_run.sh运行测试:
swift test主要目录:
Sources/App/:应用入口、菜单和窗口场景。Sources/Models/:模型配置、生成参数、任务和画布数据结构。Sources/Stores/:应用状态、本地持久化和任务轮询。Sources/Services/:KIE 请求、上传、下载和 Keychain。Sources/Views/:快速生成、提示词管理、任务队列和无限画布界面。Sources/Support/:错误处理、编码和文件辅助。Tests/:Payload、模型限制、持久化和文件处理测试。
更详细的架构与实现边界见 PROJECT.md。
欢迎通过 GitHub Issues 报告问题或提出建议。 提交问题时请说明 macOS 版本、所用模型、复现步骤和可公开的错误信息。
StudioX 与 KIE、OpenAI、Google、xAI、Suno 等服务提供方没有官方隶属关系。