Skip to content

About

原生 macOS 多模态 AI 创作工作台:快速生成、提示词管理与无限画布

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

StudioX for macOS

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

脚本会完成以下操作:

  1. 停止正在运行的旧 StudioX 实例。
  2. 使用 Swift Package Manager 构建应用。
  3. 生成并临时签名 StudioX.app。
  4. 安装到 ~/Applications/StudioX.app。
  5. 启动应用并确认进程正常运行。

完成后,可以从“应用程序”或 Spotlight 打开 StudioX。

首次使用

  1. 打开 StudioX,在工具栏进入“设置”。
  2. 填写 KIE API Key。
  3. 选择下载目录,并决定是否启用自动下载。
  4. 返回“快速生成”,选择模型并输入提示词。
  5. 如需参考素材,可点击“选择文件”,或将文件直接拖入窗口。
  6. 点击“开始生成”,在右侧任务队列查看状态和结果。

提示词第一行可使用 # 标题。任务队列会使用该标题和创建时间命名任务;没有一级标题时, 任务仅显示创建时间。

提示词管理

  • 使用项目整理不同主题的提示词。
  • 每条提示词必须以 # 标题 开头,该标题会作为索引名称。
  • 支持创建、重命名、删除、搜索和一键复制。
  • 可以从快速生成的提示词菜单或编辑器右键菜单直接导入。

无限画布

  1. 在侧栏打开“无限画布”,创建画布项目。
  2. 通过右键菜单添加提示词、任务、素材和输出节点。
  3. 将提示词或素材连接到任务节点,再将任务连接到输出节点。
  4. 在任务节点中选择模型并调整参数。
  5. 点击输出节点的运行按钮,生成状态和结果会直接显示在节点中。

画布支持平移、缩放、框选、多选、复制、剪切、粘贴、分组和文件拖入。画布、节点、连线 与视口均保存在本机,当前版本不提供云同步或多人协作。

下载与本地数据

  • 默认下载位置为系统“下载”文件夹,也可以在设置中选择其他目录。
  • 每个画布输出节点可以使用独立保存位置。
  • 文件重名时会自动编号,不覆盖已有文件。
  • 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 等服务提供方没有官方隶属关系。

About

原生 macOS 多模态 AI 创作工作台:快速生成、提示词管理与无限画布

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages