元境幻生 (MiragenFlow)

快速开始 · 功能介绍 · Render 部署 · Docker 部署 · 画布节点操作手册 · 画布快捷键 · 漏洞提交 · 待办事项

元境幻生是一款面向图片、文本和音频创作的开源工作台。它把无限画布编排、AI 生成、图片编辑和资产沉淀放在同一个界面里，适合连续探索视觉方案并管理生成结果。

Caution

项目目前处于开发阶段，不保证历史数据兼容。各种本地存储格式都可能直接调整，欢迎关注后续更新。

如果你需要稳定维护自己的分支，建议自行 fork 后独立开发。二次开发与 PR 请保留原作者信息和前端页面标识。

赞助商

	Atlas Cloud provides a unified AI API for image, text, and other model services. Instead of managing multiple vendor integrations, you connect once to access a broad model catalog. Check out Atlas Cloud's coding plan for budget-friendly API access.
	AI API 服务｜秘塔科技提供兼容 OpenAI 协议的模型 API 服务，适合接入图片、文本和音频创作流程。通过专属链接注册可领取优惠。
	元境幻生 × Infistar.ai 无限星河｜多模态 API 💡 提供兼容 OpenAI 标准接口的图片、文本和音频模型服务，支持透明的模型倍率与调用明细。通过专属链接注册可享优惠。

核心功能

首页与项目库：保留网站首页、多画布项目管理、导入导出和项目删除。
无限画布：节点拖拽缩放、连线、分组、小地图、撤销重做和多种画布背景。
AI 创作：通过同源平台网关提交图片、文本和音频异步任务，支持参考图编辑与 WebSocket 进度。
图片工具：反推提示词、多角度生成、裁剪、遮罩编辑、切分和本地放大。
资产与同步：本地资产库支持文本、图片和音频；WebDAV 可同步画布、资产及媒体文件。
平台目录：用户只选择公开模型产品、能力、分辨率和金币价格，供应商渠道由管理台配置。
管理后台：提供用户、认证消息、渠道、模型、套餐、账本、任务、存储和审计管理。

完整功能说明见功能介绍。

如果你在为担心没有合适的生图API来发愁，可以查看该免费生图项目：chatgpt2api

快速开始

画布和资产默认保存在浏览器 IndexedDB/localForage；认证由同源服务端处理，provider 凭证只保存在服务端密文中。WebDAV 可保存画布、资产和媒体文件。

本地开发

git clone https://git.awaioi.com/awaioi/MiragenFlow.git
cd MiragenFlow
npm --prefix admin install --ignore-scripts
cd web
bun install
bun run dev:all

统一入口为 http://localhost:3000：前台访问 /，后台管理台访问 /admin/。

Docker 运行

git clone https://git.awaioi.com/awaioi/MiragenFlow.git
cd MiragenFlow
cp .env.example .env
# Fill every production secret in .env before starting the stack.
docker compose up -d --build

该 Compose 文件会同时构建前台/后台静态资源、API 服务，并启动 PostgreSQL 与 Redis；首次启动需要完成镜像构建和数据库迁移。运行后默认只使用 3000 端口，可访问 http://localhost:3000；后台管理台位于 http://localhost:3000/admin/。

首次打开后注册或登录元境幻生账户。模型、渠道、余额和任务由平台服务端统一管理；用户端不保存供应商 Base URL、API Key 或自定义调用脚本。WebDAV 可在「存储设置」中配置，用于保存个人生成数据。