Skip to content

STARTUP_GUIDE.md

Latest commit

 

History

History
175 lines (137 loc) · 3.43 KB

STARTUP_GUIDE.md

File metadata and controls

175 lines (137 loc) · 3.43 KB

Jazz Design Agent - 启动指南

🚀 快速启动

前置条件

  • Python 3.9+
  • Node.js 16+
  • 配置好的 .env 文件

一键启动脚本

macOS/Linux

# 启动后端
cd backend
source venv/bin/activate
python -m uvicorn app.main:app --reload --port 8000

# 新终端窗口，启动前端
cd frontend
npm run dev

Windows

# 启动后端
cd backend
venv\Scripts\activate
python -m uvicorn app.main:app --reload --port 8000

# 新终端窗口，启动前端
cd frontend
npm run dev

访问地址

🎨 使用流程

工作区模式（推荐）

  1. 访问 http://localhost:5173
  2. 输入设计需求（如："设计一个科技感十足的电商海报"）
  3. 点击"开始创作"
  4. 自动跳转到工作区页面
  5. 在画板中查看生成的图片
  6. 通过右侧对话框继续调整：
    • "把背景改成蓝色"
    • "添加一些文字"
    • "让主体更大一些"
  7. 使用画板工具：
    • 选中: 点击图片
    • 移动: 拖拽
    • 缩放/旋转: 使用控制点
    • 删除: 图层面板中点击删除
  8. 导出作品：点击工具栏"导出"按钮

调试模式

  1. 访问 http://localhost:5173/debug
  2. 输入设计需求
  3. 一次性生成
  4. 查看详细评估信息

🔧 故障排查

前端白屏

# 检查浏览器控制台错误
# 确保后端服务正常运行
curl http://localhost:8000/api/v1/health

# 重启前端服务
cd frontend
pkill -f "vite"
npm run dev

后端错误

# 检查后端日志
# 确保环境变量配置正确
cat backend/.env

# 重启后端服务
cd backend
pkill -f "uvicorn"
source venv/bin/activate
python -m uvicorn app.main:app --reload --port 8000

数据库问题

# 重新初始化数据库
cd backend
source venv/bin/activate
python -c "from app.db import init_db; init_db()"

📊 技术架构

后端

  • 框架: FastAPI + SQLAlchemy
  • 数据库: SQLite (本地持久化)
  • AI模型:
    • Doubao (文本生成、视觉理解)
    • SeedDream (图片生成)
  • Agent: LangGraph 多Agent协作

前端

  • 框架: React + TypeScript
  • 状态管理: Redux Toolkit
  • 路由: React Router
  • 画板: React Konva
  • 样式: Tailwind CSS
  • 实时通信: SSE (Server-Sent Events)

🎯 核心功能

智能对话

  • ✅ 上下文理解
  • ✅ 增量调整（"改成蓝色"）
  • ✅ 引用历史（"基于第2张图"）
  • ✅ 持续优化

交互式画板

  • ✅ 拖拽、缩放、旋转
  • ✅ 多图层管理
  • ✅ 实时预览
  • ✅ 画板导出

AI 评估

  • ✅ 4维度评分（相关性、质量、构图、创意）
  • ✅ 视觉理解模型
  • ✅ 图片内容描述
  • ✅ 改进建议

📝 环境变量

创建 backend/.env 文件：

# Doubao API
DOUBAO_API_KEY=your_api_key
DOUBAO_ENDPOINT=https://ark.cn-beijing.volces.com/api/v3
DOUBAO_MODEL=doubao-seed-1-6-thinking-250715
DOUBAO_VISION_MODEL=doubao-seed-1-6-vision-250815

# SeedDream / Image Generation
SEEDDREAM_API_KEY=your_api_key
SEEDDREAM_ENDPOINT=https://ark.cn-beijing.volces.com/api/v3
SEEDDREAM_MODEL=doubao-seedream-4-0-250828

# Others
GENERATED_IMAGES_DIR=generated_images

🎉 开始创作！

一切准备就绪！现在访问 http://localhost:5173 开始您的 AI 设计之旅！