MindPainting

MindPainting - AI友好的辅助绘图软件

MindPainting 是一个现代化的AI辅助绘图软件，集成了像素绘制、图形绘制和AI生成功能。通过MCP协议与各种AI模型通信，为用户提供智能的绘图辅助体验。

✨ 主要特性

• 🎨 多样化绘图工具: 支持画笔、橡皮擦、几何图形等多种绘图工具
• 🤖 AI智能辅助: 集成OpenAI DALL-E、Stability AI等多种AI模型
• 📱 响应式设计: 支持桌面和移动设备，跨平台使用
• 💾 云端同步: 作品自动保存到云端，随时随地访问
• 🔧 素材管理: 支持导入和管理各种绘图素材
• 🌐 国际化支持: 支持中文和英文界面
• 🐳 容器化部署: 使用Docker实现一键部署

🏗️ 技术架构

前端

• 框架: Vue.js 3 + Composition API
• UI库: Element Plus
• 状态管理: Pinia
• 构建工具: Vite
• 样式: SCSS
• 画布: HTML5 Canvas + Konva.js

后端

• 运行时: Node.js
• 框架: Express.js
• 数据库: MySQL 8.0
• 认证: JWT
• 文件处理: Sharp
• AI集成: OpenAI API, Stability AI API

部署

• 容器化: Docker + Docker Compose
• 反向代理: Nginx
• 缓存: Redis (可选)

🚀 快速开始

环境要求

• Node.js 18+
• MySQL 8.0+
• Docker & Docker Compose (推荐)

使用Docker部署 (推荐)

1. 克隆项目

git clone <repository-url>
cd MindPainting

2. 配置环境变量

cp backend/.env.example backend/.env
# 编辑 .env 文件，配置数据库和AI API密钥

3. 启动服务

docker-compose up -d

4. 访问应用

• 前端: http://localhost:3000
• 后端API: http://localhost:5000
• 数据库: localhost:3306

本地开发

1. 安装依赖

# 前端依赖
cd frontend
npm install

# 后端依赖
cd ../backend
npm install

2. 配置数据库

# 创建数据库
mysql -u root -p < sql/create.sql

3. 配置环境变量

cp backend/.env.example backend/.env
# 编辑配置文件

4. 启动开发服务器

# 启动后端 (终端1)
cd backend
npm run dev

# 启动前端 (终端2)
cd frontend
npm run dev

📖 API文档

认证接口

• POST /api/auth/register - 用户注册
• POST /api/auth/login - 用户登录
• GET /api/auth/profile - 获取用户信息
• PUT /api/auth/profile - 更新用户信息

画布接口

• POST /api/canvas/save - 保存作品
• GET /api/canvas/load/:id - 加载作品
• GET /api/canvas/list - 获取作品列表
• PUT /api/canvas/:id - 更新作品
• DELETE /api/canvas/:id - 删除作品

AI接口

• GET /api/ai/models - 获取可用AI模型
• POST /api/ai/generate-image - 生成图像
• POST /api/ai/enhance-image - 图像增强
• GET /api/ai/history - 获取生成历史

素材接口

• POST /api/assets/upload - 上传素材
• GET /api/assets/list - 获取素材列表
• DELETE /api/assets/:id - 删除素材

🔧 配置说明

环境变量

变量名	说明	默认值
NODE_ENV	运行环境	development
PORT	服务端口	5000
DB_HOST	数据库主机	localhost
DB_USER	数据库用户	mindpainting
DB_PASSWORD	数据库密码	root
DB_NAME	数据库名称	mindpainting
JWT_SECRET	JWT密钥	-
OPENAI_API_KEY	OpenAI API密钥	-
STABILITY_API_KEY	Stability AI API密钥	-

AI模型配置

支持的AI模型:

• OpenAI DALL-E 3: 高质量图像生成
• Stability AI SDXL: 开源图像生成模型
• Stability AI SD3: 最新版本Stable Diffusion

🎨 使用指南

基础绘图

1. 选择绘图工具（画笔、橡皮擦、几何图形等）
2. 调整画笔大小和颜色
3. 在画布上进行绘制
4. 使用撤销/重做功能修正错误

AI辅助绘图

1. 点击"AI助手"按钮打开侧边栏
2. 选择AI模型
3. 输入描述文字
4. 点击"生成图像"
5. 将生成的图像导入画布

作品管理

1. 使用"保存"功能保存作品到云端
2. 在"画廊"中查看和管理所有作品
3. 支持搜索、标签分类等功能

🔒 安全特性

• JWT身份认证
• 密码加密存储
• 文件类型验证
• 请求速率限制
• XSS和CSRF防护
• 安全HTTP头设置

🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

• Vue.js - 渐进式JavaScript框架
• Element Plus - Vue 3组件库
• Express.js - Node.js Web框架
• OpenAI - AI模型提供商
• Stability AI - 开源AI模型

📞 支持

如果您遇到任何问题或有建议，请：

• 提交 Issue
• 发送邮件至: support@mindpainting.com
• 查看 文档

---

MindPainting - 让AI成为您的绘画伙伴 🎨✨ An AI-powered drawing assistant that transforms your thoughts, flowcharts, and ideas into precise visuals through natural language interaction (MCP), bridging the gap between conception and creation.