使用说明
🎨 Figma AI设计师
使用AI将文本提示转化为专业的Figma设计。
Figma AI Designer是一个全栈应用程序,它利用大型语言模型(LLM)从简单的文本描述生成可编辑的、支持自动布局的Figma设计。它由一个用于用户交互的React前端、一个用于AI处理的Flask后端(由Groq提供支持)和一个实时渲染设计的自定义Figma插件组成。
✨ 特性
- 🤖 人工智能发电:使用最先进的LLM(通过Groq API)将自然语言提示转换为结构化设计命令。
- 📐 自动布局支持:生成具有嵌套自动布局框架、填充、间隙和对齐的完全响应式设计。
- ⚡ 实时更新:使用轮询机制将命令从后端直接流式传输到Figma画布。
- 🎨 上下文感知迭代:可以读取当前的设计状态以进行迭代更新(例如,“主标题应该更大”)。
- 🖼️ 丰富元素支持:支持框架、文本(使用谷歌字体/Inter)、矩形、椭圆和图像(来自URL)。
- 🔐 用户认证:安全的登录和注册流程由 职员 身份验证。
- 💻 现代仪表板:一个时尚的深色模式仪表板,由 反应, 维特,以及 顺风CSS.
🏗️ 建筑
该系统在三层架构中运行:
- 前端(React+Vite):
- 用户登录并输入设计提示(例如,“创建现代登录卡”)。
- 通过HTTP POST将提示发送到后端。
- 后端(Python+Flask):
- 收到提示。
- 使用系统提示(
backend/prompts/system_prompt.txt)和Groq API生成设计的JSON表示。 - 将命令对象推入内存中的队列。
- Figma插件(JavaScript):
- 轮询后端(
/mcp/figma/next)每1秒。 - 检索挂起的命令并使用Figma插件API(
figma.createFrame,figma.loadFontAsync等等)在画布上绘制元素。
- 轮询后端(
🛠️ 技术栈
前端
- 框架:React 19(Vite)
- 样式:顺风CSS v4
- 认证:职员(@职员/职员反应)
- 路由:React Router DOM v7
- 图标:Lucide React
后端
- 服务器:Flask(Python)
- AI引擎:Groq SDK(支持以下模型
llama-3,mixtral等等) - 排队系统python
queue.Queue(内存中)
Figma插件
- 环境:Figma插件API(清单v1)
- 逻辑:普通JavaScript(异步/等待)
🚀 入门指南
先决条件
- Node.js (v18+)
- python (v3.10+)
- Figma桌面应用程序
- Groq API密钥 (用于AI生成)
- 办事员API钥匙 (前端可发布密钥)
1.后端设置
- 导航到
backend目录:cd backend - 创建虚拟环境(可选但推荐):
python -m venv venv # Windows: .\venv\Scripts\activate # Mac/Linux: source venv/bin/activate - 安装依赖项:
pip install flask flask-cors groq python-dotenv mistralai - 创建一个
.env文件在backend文件夹:GROQ_API_KEY=your_groq_api_key_here - 启动服务器:服务器将在以下时间运行
python main.pyhttp://127.0.0.1:4000
2.前端设置
- 导航到
frontend目录:cd frontend - 安装依赖项:
npm install - 创建一个
.env.local文件在frontend使用您的职员钥匙的文件夹:VITE_CLERK_PUBLISHABLE_KEY=pk_test_... - 启动开发服务器:应用程序将在以下时间运行
npm run devhttp://localhost:5173
3.插件设置
- 打开 Figma桌面应用程序.
- 首选 菜单 > 插件 > 发展 > 从清单导入插件。..
- 选择
manifest.json文件内部figma-plugin此项目的文件夹。 - 应出现插件“Figma AI Designer”(或清单中定义的类似名称)。
🎮 使用指南
- 启动堆栈:确保后端(
port 4000)和前端(port 5173)正在奔跑。 - 打开Figma:打开新的设计文件。
- 运行插件:右键单击画布>插件> Figma AI设计师.
- 您应该看到一条通知:“MCP Figma插件正在运行…”
- 生成设计:
- 转到Web仪表板(
http://localhost:5173). - 登录。
- 输入提示。, 在卡片上画一张联系人表格,上面有姓名、电子邮件输入和提交按钮
- 点击 生成.
- 转到Web仪表板(
- 观看魔术:切换回Figma。使用 跑 如果需要,可以在插件中使用命令(或者如果是自动轮询,它会自动出现)。
📁 项目结构
├── backend/
│ ├── main.py # Flask Server & AI Logic
│ ├── prompts/ # System prompts for LLM
│ ├── output.txt # Log of generated commands
│ └── current_design.json # State of latest design
├── figma-plugin/
│ ├── code.js # Plugin Logic (Polling & Rendering)
│ ├── manifest.json # Plugin Configuration
│ └── ui.html # (Optional) Plugin UI
├── frontend/
│ ├── src/ # React Source Code
│ ├── components/ # UI Components
│ └── App.jsx # Main App Routing
└── README.md # Project Documentation
⚠️ 故障排除
- 插件未更新?
- 检查后端服务器是否正在运行。
- 确保
code.js指向正确的URL(http://127.0.0.1:4000/mcp/figma/next). - 检查Figma控制台(插件>开发>打开控制台)是否有错误。
- AI返回错误?
- 验证您的
GROQ_API_KEY在backend/.env. - 检查
output.txt在后端文件夹中查看原始JSON响应的样子。
- 验证您的