STABLE 0.3.0
从安装到出图,
一份文档讲明白。
本文档面向 第一次使用 GUIMAA Studio 的用户, 按从安装到出第一张图的顺序,覆盖所有必须设置项、 每个节点的用法、以及常见问题排查。
5 分钟快速上手
最短路径 · 跑通第一张图
- ① 安装下载并运行安装包
- ② 注册在 api.guimaa.cn 注册
- ③ 取 Key控制台 → 创建 Token
- ④ 填 Key设置 → 性能优化
- ⑤ 出图画布 → 智能设计节点
1
软件简介
GUIMAA Studio 是一款节点式 AI 创作工作台。 你通过在画布上添加节点、连接节点,组装出自己的 AI 工作流——文本节点输入提示词、图片节点喂参考图、生成节点产出结果,全程可视化。
🎨
节点式画布
所见即所得,无需写脚本
🤖
多 Agent 协同
智能设计节点内置 5 Agent 流水线
🔌
多模型聚合
即梦、可灵、Gemini、DeepSeek 一网打尽
系统要求
- ✓操作系统:Windows 10 / 11(64 位)
- ✓内存:建议 8 GB 或以上
- ✓磁盘:预留 2 GB 以上空间用于安装与缓存
- ✓网络:能正常访问
api.guimaa.cn
2
安装与首次启动
- 从官方渠道下载
GUIMAA Studio Setup.exe安装包。 - 双击运行安装包,按向导完成安装(默认路径即可)。
- 安装完成后,桌面会出现 GUIMAA Studio 图标,双击启动。
- 首次启动可能因加载本地缓存服务器稍慢一些,请耐心等待 5 ~ 15 秒。
- 启动完成后会进入空白画布,左下角状态栏显示
Core Service Online即为正常。
📷
截图位置:
docs/screenshots/01-general.png建议标注:① 顶部菜单 ② 画布 ③ 左下角状态栏(Core Service Online)
3
第一次启动 · 基础设置
点击右上角 ⚙ 设置 进入设置面板。设置面板共有 5 个选项卡:
① 通用设置
语言 / 服务器 / 历史
② API 配置
模型供应商 / Key
③ 模型库
收藏 / 自定义模型
④ 性能优化
智能设计 KEY / 缓存
⑤ 关于版本
日志 / 诊断包
3.1 「通用设置」要做的事
- 语言:简体中文 / English,按需切换。
- 主题:深色 / 浅色,默认深色(推荐,护眼且贴合节点视觉)。
- 本地资源服务器:默认
http://127.0.0.1:9527,普通用户保持默认。 - 历史记录上限:超过此值会自动清理旧记录,建议 100 ~ 500。
- 资产隔离打包 (Zip):导出项目时自动打包引用素材,跨电脑迁移用。
📷
截图位置:
docs/screenshots/02-general.png建议标注:① 语言切换 ② 主题切换 ③ 本地资源服务器 ④ 历史记录上限
4
核心配置 · API 与 KEY ⚠ 必读
💡
软件本身不内置任何 AI 模型,所有出图/出文能力都通过你提供的 API Key 调用云端服务。
所以——不填 Key = 不能用。本章是必看。
4.1 智能设计 KEY 推荐先配这个
这是「智能设计生成」节点的专属 KEY,新手最快出图的入口。
① 获取
- 访问 https://api.guimaa.cn/console/token
- 登录账号 → 「创建新 Token」 → 复制 Key(形如
sk-xxxx)
② 填写
设置 → 性能优化 → 找到「智能设计 KEY」 → 粘贴 → 自动保存。
📷
截图位置:
docs/screenshots/03-smart-key.png建议标注:① 性能优化 Tab ② 智能设计 KEY 输入框 ③「获取 key」链接
4.2 全局 API Key 与 Base URL
用于所有没有单独配置的模型,相当于「兜底 Key」。
位置:设置 → API 配置 → 顶部
全局 API Key
sk-xxxxxxxxxxxxxxxxxx
从 你的中转站 控制台获取
全局 Base URL
https://api.guimaa.cn
一般是中转站地址,不要带/
4.3 添加 / 编辑 / 测试模型
设置 → API 配置 中下部的「API 配置列表」是所有模型的入口。
快速添加常用服务商
在「常用服务商」区点击对应卡片(OpenAI、Google、即梦、可灵、火山、DeepSeek 等),自动套用预设 Base URL。
手动添加模型
- 点击 「+ 添加模型」。
- 填写:
Provider、Model Name、Display Name、Type(chat / image / video)、Key、Base URL。 - Base URL 选项:「全局」=用顶部的全局 URL;「自定义」=填该模型专属地址。
- 填完点击 「测试」(Wifi 图标),状态灯变绿即成功。
批量测试 / Ping 全部
点击右上角 「Ping 全部」,一次性检测所有模型可用性。
📷
截图位置:
docs/screenshots/04-api-config.png建议标注:① 全局 Key ② 全局 Base URL ③ 常用服务商卡片 ④ 添加模型按钮 ⑤ Ping 全部
状态指示灯
绿 · 可用
黄 · 限流 / 测试中
红 · Key 错误 / 网络异常
4.4 URL 说明(什么时候要改)
API 全局 Base URL
默认
https://api.guimaa.cn仅在使用别的中转站、企业内网网关、官方临时备用域名时才改。不要带尾斜杠。
本地资源服务器 URL
默认
http://127.0.0.1:9527仅在 9527 端口被占用,或你把本地服务跑到其他端口时才改。改完需重启软件。
5
主界面概览
左侧工具栏
撤销/重做、保存项目、导入导出、运行全部、设置入口。
画布(中心区域)
所有节点工作的主舞台。鼠标拖拽平移,滚轮缩放,右键添加节点。
右侧历史面板
所有生成结果的时间线,可重看、复用、下载。
左下状态栏
本地服务器状态、缓存连接、运行中任务计数。
📷
截图位置:
docs/screenshots/05-ui-overview.png建议标注:① 顶部工具栏 ② 画布 ③ 历史面板 ④ 状态栏 ⑤ 设置入口
6
节点全景
画布右键 → 选择类型即可添加节点。每类节点的用途与连接关系如下:
🖼
输入图片
从本地上传或从历史拖入。作为下游生成节点的参考素材。支持遮罩绘制(gen-image 节点专用)。
📝
文本节点
独立的提示词存放器。多个文本节点可同时连入一个生成节点,自动拼接。
⚡
智能设计生成 推荐
5 Agent 协同(理解→策划→分析→生成→审校),输入自然语言需求直接产出可交付级设计图。需要在「设置→性能优化」填智能设计 KEY。
🎨
图片生成(gen-image)
面向单模型出图的精细控制。支持参考图、遮罩、变量、批量。可选择即梦/可灵/Gemini 等具体模型。
🎬
视频生成(gen-video)
输入图片 + 文字描述 → 输出视频片段。可灵、即梦视频等模型支持。
💬
文本生成(text-gen)
调 LLM 生成文案、改写、润色。常用于先生文案再喂给图片节点的工作流。
👁
预览节点
把任意上游输出固化为可放大查看的"展板"。多用于结果对比。
⚖
图片对比
左右滑动对比两张图,常用于前后修图、AB 方案。
📋
批量表格
导入 Excel/CSV,每行作为一次任务。配合提示词里的
{{变量}} 实现批量出图/出文。🗂
批量预览
批量任务的瀑布流展示,可一键全选导出。
7
工作流基础操作
7.1 添加节点
- • 画布空白处双击 → 选择节点类型。
- • 节点出现后按住拖动可移动位置。
7.2 连接节点
- • 节点边缘有圆形端口,按住端口拖到目标节点端口即可连线。
- • 不同颜色端口代表不同数据类型(图片 / 文本 / 表格 / 蒙版)。
- • 删除连线:选中连线 → Delete,或右键删除。
7.3 运行节点
- • 单节点:选中后点击节点上的 ▶ 生成 按钮。
- • 整组运行:把节点圈进同一群组,点击群组运行按钮。
- • 运行全部:顶部工具栏「▶ 全部运行」按依赖顺序执行画布上所有可运行节点。
7.4 使用变量 {{变量名}}
把批量表格节点连接到任意提示词输入框时,表格的每列名都会变成可用变量:
为 {{产品名}} 设计一张主图,主色调 {{主色}},风格 {{风格}}
点击节点底部的「可用变量」橙色标签可一键插入。运行时表格每行替换变量,自动批量产出。
7.5 群组与整理
- • 框选多个节点 → 右键 → 创建群组,方便整体管理与批量运行。
- • 群组可命名、可整体拖动、可整体删除。
8
性能优化与缓存
设置 → 性能优化 选项卡内,从上到下:
撤销队列上限(5–200)
允许撤销的最大操作步数。值越大消耗内存越高,建议 20 ~ 50。
启动时同时打开浏览器
开启后启动时会同时在系统默认浏览器打开同一应用,浏览器渲染性能更好。两者共享同一服务器与数据,可任选其一使用。
智能设计 KEY ★
已在 4.1 节详细介绍。
本地缓存服务
把远程素材缓存到本地,重复加载可秒开。强烈建议保持开启。
重新下载已有缓存
开启后忽略已存在文件,重新下载历史图片/视频。仅在缓存损坏时偶尔启用一次。
启动时缓存历史记录
软件启动时预先把历史素材拉到本地,后续浏览更顺滑。代价是启动稍慢。
9
历史记录 & 自动保存
历史面板
- • 右侧抽屉,所有生成结果按时间排序。
- • 点击缩略图可大图查看 / 下载 / 复用提示词。
- • 支持拖拽到画布作为新节点的输入。
- • 超出「历史记录上限」会自动清理最早记录。
图片自动保存
- • 设置 → 通用设置 → 「图片自动保存」。
- • 开启后所有生成图片自动写入本地文件夹。
- • 点击「自动设置桌面路径」一键填好。
- • 文件名包含时间戳,避免覆盖。
10
常用快捷键
| 快捷键 | 作用 |
|---|---|
| Ctrl + Z | 撤销 |
| Ctrl + Y | 重做 |
| Ctrl + S | 保存项目 |
| Ctrl + C / V | 复制 / 粘贴节点 |
| Delete | 删除选中节点 / 连线 |
| Space + 拖动 | 平移画布 |
| 滚轮 | 缩放画布 |
| 右键空白 | 添加节点菜单 |
| 框选 + 右键 | 创建群组 |
11
关于版本(诊断与日志)
设置 → 关于版本,遇到问题需要技术支持时常用:
📁 打开日志目录
在文件管理器里打开运行日志文件夹,可查看启动错误、闪退记录。
📦 导出诊断包
一键打包当前日志、配置、运行环境信息,报问题时附上这个文件。
12
常见问题(FAQ)
提示「请输入智能设计生成 API Key」? ▾
① 设置 → 性能优化 → 智能设计 KEY 是否已粘贴;② Key 是否完整(前缀
sk-);③ 节点本地是否填了一个错误的 Key(节点本地优先)。
提示「Key 看起来不是有效密钥」? ▾
软件检测到你粘贴的内容像文件路径、Base64、脚本命令。重新到 api.guimaa.cn/console/token 复制纯字符串。
普通图片生成节点测试连接是红色? ▾
① 该模型对应的 Provider Key 是否填对;② Base URL 是「全局」还是「自定义」,自定义时是否漏了
https://;③ Model Name 是否拼写正确(注意大小写);④ 你的账号是否有该模型的调用权限。
本地缓存「未就绪」? ▾
本地服务器(默认
http://127.0.0.1:9527)没启动或被占用。① 重启软件;② 在任务管理器查 9527 占用进程;③ 改其他空闲端口并同步修改设置。
批量表格运行后只跑了第一行? ▾
① 提示词里没用
{{变量}} 占位符;② 表格列名包含特殊字符(建议只用中英文+数字);③ 表格未连到生成节点的输入端口。
Key 会同步到云端吗?换电脑要重填? ▾
仅保存在本机(localStorage),不会上传任何服务器。换电脑、重装系统、清浏览器缓存都需要重新填。
软件闪退 / 启动卡住怎么办? ▾
① 设置 → 关于版本 → 「导出诊断包」发给技术支持;② 尝试关闭「启动时缓存历史记录」后重启;③ 检查杀毒软件是否拦截了本地服务器端口。