YunQiao Image Studio云桥图像工坊 / 云桥Pro是一款开源的 AI 图像生成与编辑桌面工具基于 Electron、React 和 TypeScript 构建。它面向电商、短剧、自媒体、设计团队和商业内容生产场景支持文生图、图生图、批量生产、行业模板、素材管理、AI 修图工具箱和云端存储。项目默认使用 OpenAIgpt-image-2模型完成图片生成和图片编辑文生图调用图片生成接口图生图、局部重绘和 AI 修图调用图片编辑接口。最新版本当前发布版本v0.1.10GitHub Release 下载页https://github.com/jxb412/YunQiao-Image-Studio/releases/tag/v0.1.10客户端文件Windows x64 便携版YunQiao-Image-Studio-0.1.10-win-x64-portable.exemacOS Intel x64YunQiao-Image-Studio-0.1.10-mac-x64.dmgmacOS Apple Silicon arm64YunQiao-Image-Studio-0.1.10-mac-arm64.dmgWindows 版本下载后双击即可运行不需要安装 Node.js、npm 或 Electron。macOS 版本当前未做 Apple Developer ID 签名和公证首次打开方式见本文的 macOS 说明。核心功能文生图创作行业模板、提示词组合、尺寸/质量/格式参数控制。图生图继续编辑载入本地图片或生成结果继续二次创作。AI 修图工具箱扩图、去杂物、换背景、统一色调、商品光影、人像精修、局部重绘等。批量生产工坊支持 Excel 导入、多任务队列、批量图生图、底图文件夹绑定、暂停/继续/停止、失败重试和日志导出。行业模板库内置电商、短剧、自媒体、漫画动漫、人物图像、二次元头像、潮流社交、虚拟IP、游戏美术、餐饮、品牌广告等模板。作品素材库保存生成结果、提示词、参数快照、本地路径和云端 URL。云端存储支持 OSS、COS、OBS、七牛、MinIO、FTP、SFTP。固定接口API Base URL 固定为https://api.0029.org。本机安全存储API Key 和云存储密钥只保存在本机安全存储中。跨平台配置同一套代码支持 Windows 和 macOS 构建。v0.1.10 更新重点新增年轻化行业模板人物图像、二次元头像、潮流社交、虚拟IP。人物图像覆盖社交头像写真、AI 写真大片、城市街拍、年轻职场形象照、国风汉服写真、情侣头像、校园青春毕业照、音乐人宣传照等。二次元头像覆盖日系清透头像、酷感少年少女头像、Q 版萌系头像、二次元情侣头像、动漫手机壁纸、二次元表情包、偶像应援头像等。潮流社交覆盖 Y2K 潮流海报、多巴胺封面、赛博朋克头像、独立音乐封面、社交热梗表情图、手机锁屏壁纸、穿搭灵感板等。虚拟IP覆盖虚拟主播头像、虚拟人设定稿、直播间虚拟背景、虚拟 IP 表情包、品牌吉祥物 IP、IP 盲盒概念图、角色资料卡等。扩充自媒体内容、漫画动漫、游戏美术、潮玩玩具、个人 IP 等热门方向模板数量。更新中文行业模板文档和模板种子配置便于阅读、导入和二次开发。重新构建并发布 Windows、macOS Intel、macOS Apple Silicon 三个客户端。技术栈ElectronElectron ViteReactTypeScriptLucide ReactOpenAI 兼容图片接口默认图片模型gpt-image-2快速开始安装依赖npm install启动开发环境npm run dev代码检查npm run lint npm run typecheck npm test npm run buildAPI 设置在应用内打开API与云端存储设置页面填写API Base URL固定为https://api.0029.org界面不提供自定义修改。API Key由服务商提供只保存在本机安全存储中。请求超时时间默认 300 秒最高 600 秒。测试 API可在设置页直接测试 API Key 与接口连通性并查看状态码、耗时和返回摘要。如果使用0029.org服务需要先到0029.org购买套餐并生成秘钥。图片生成说明本项目的图片生成和图片编辑能力均围绕gpt-image-2设计文生图使用gpt-image-2生成图片。图生图使用gpt-image-2基于输入图片继续编辑。局部重绘 / AI 修图使用gpt-image-2图片编辑能力处理原图。当前默认每次生成或编辑 1 张图片不主动传递多图数量参数。这样可以避免部分中转接口把数量参数转换成tools[0].n后被官方接口拒绝。图生图和编辑接口使用本地文件上传方式避免把本地图片错误地以application/octet-stream的 URL 形式传给接口。AI 修图工具箱支持局部遮罩可在图片上绘制需要修改的区域保存遮罩后会随下一次图片编辑请求一起提交。批量生产说明Excel 列顺序项目、行业、模板、数量、提示词、尺寸可选。每条任务可单独绑定底图有底图时走图生图没有底图时走文生图。可选择一个图片文件夹批量绑定底图系统会按任务顺序循环分配。队列支持暂停、继续、停止、失败重试和任务日志导出。设置页和作品库支持真实云上传测试、URL 清单导出和素材包打包。模板与项目管理创作页支持填写项目名称生成作品会自动归入对应项目。行业模板库支持新增、编辑、导入和导出 JSON 模板包。模板库会按行业目标数量自动补足常用场景热门行业会提供更多模板。新增模板已按gpt-image-2尺寸规则检查默认不超过 2K。人物、二次元和虚拟 IP 模板默认加入肖像、版权、未成年人和低俗内容规避提示。作品素材库支持搜索、项目筛选、云端状态筛选、预览、继续编辑、修图和打开本地文件位置。顶部工具栏支持检查 GitHub 最新 Release方便下载新版客户端。GitHub Release 自动构建推送v*tag 会触发.github/workflows/release.ymlWindows runner 构建 Windows x64 便携版。macOS runner 分别构建 Intel x64 DMG 和 Apple Silicon arm64 DMG。所有平台会先运行lint、typecheck、test和build。构建成功后自动上传到 GitHub Release。Windows 构建生成便携版scripts\build-win-portable.cmd或npm run dist:win-portable产物默认输出到release/macOS 构建Windows 不能直接生成 macOS.app或.dmg需要在 macOS 或 GitHub Actions 的 macOS Runner 上构建。生成.app目录bash scripts/build-mac-dir.sh生成.dmgbash scripts/build-mac.sh更多说明见 MAC_BUILD.md。macOS 客户端打开方式当前开源版本未做 Apple Developer ID 签名和公证macOS 首次打开时可能提示“无法验证开发者”或“已损坏无法打开”。下面方法只适用于你确认来源可信的软件不明来源软件不要绕过系统安全检查。方法 1右键打开单次临时放行。打开 DMG把应用拖到Applications。在Applications中找到应用。右键点击.app选择打开。弹窗提示无法验证时再次点击打开。这种方式较安全但有时重启或重新打开后需要再次确认。方法 2终端移除隔离标记永久放行。打开“终端”执行下面命令。可以把.app直接拖进终端自动补全路径xattr -cr /Applications/你的软件名.app示例xattr -cr /Applications/云桥Pro.app这条命令会删除 macOS 给下载应用添加的隔离检疫属性之后通常可以正常双击打开。方法 3临时关闭安全策略不推荐。仅在你清楚风险时临时使用用完务必恢复# 关闭公证拦截 sudo spctl --master-disable # 恢复系统默认安全策略 sudo spctl --master-enable项目结构src/main/ Electron 主进程 src/preload/ 预加载桥接层 src/renderer/ React 前端界面 src/shared/ 共享类型、API 适配、尺寸校验、提示词合成 config/ 示例配置和模板数据 docs/ PRD、UI、API 和交付文档 scripts/ Windows/macOS 构建与图标脚本 build/ 应用图标资源文档用户使用说明产品 PRDUI 设计规范技术与 API 规范行业提示词模板库编译打包与交付说明macOS 构建说明安全说明不要把真实 API Key、云存储 AccessKey、SecretKey 提交到 Git。.env、本地配置、构建产物和依赖目录已通过.gitignore排除。config/api.example.json只保留示例配置。生成的图片和云端 URL 由用户自行管理请注意版权、隐私和平台合规要求。开源协作欢迎提交 Issue 和 Pull Request。适合优先完善的方向更多行业模板和提示词变量。更完整的自动更新、签名和安装包分发流程。更多兼容 OpenAI 图片接口的服务适配。发布签名、自动更新和多平台 Release 流程。