AI 视界 (AI Vision) 项目指南

🚀 快速开始

1. 环境准备

确保已安装 Python 3.8+ 和 PostgreSQL / Redis。

创建虚拟环境

# 如果 python 命令不可用，请尝试使用 py
python -m venv .venv
# 或者
py -m venv .venv

激活虚拟环境 (推荐)

# Windows (PowerShell)
.\.venv\Scripts\Activate.ps1

# Linux / Mac
source .venv/bin/activate

安装依赖

pip install -r requirements.txt

2. 启动服务

开发环境

python app.py

服务默认运行在 http://127.0.0.1:5000。

生产环境 (Gunicorn) 在 Linux 生产环境中，建议使用 Gunicorn 作为 WSGI 服务器以获得更好的性能和稳定性：

pip install gunicorn  # 如果尚未安装
gunicorn -w 4 -b 0.0.0.0:5000 app:app

• -w 4: 使用 4 个工作进程（通常设为 CPU 核心数 * 2 + 1）。
• -b 0.0.0.0:5000: 绑定所有 IP 且端口为 5000。
• app:app: 加载 app.py 中的 app 实例。

---

🛠️ 常用维护命令

数据库管理 (推荐)

本项目内置了自动化数据库管理工具 db_manager.py，用于处理模型变更和迁移。

一键自动同步 (最常用) 当您修改了 models.py 中的表结构后，运行此命令自动完成迁移：

python db_manager.py sync

分步操作 如果您需要更精细的控制：

• 初始化环境 (仅首次): python db_manager.py init
• 生成迁移脚本: python db_manager.py make "修改说明"
• 执行数据库变更: python db_manager.py up

系统配置更新

AI 模型、提示词模板等配置已移至数据库的 system_dicts 表中。

• 请登录 Web 后台管理界面 (/rbac) 进行可视化的添加和修改。
• 或直接操作数据库更新 system_dicts 表。

---

📂 目录结构说明

• app.py: 应用入口
• config.py: 配置文件
• models.py: 数据库模型定义
• blueprints/: 路由蓝图 (API 接口)
  • api.py: 核心业务接口 (Controller)
  • admin.py: 后台管理接口
  • auth.py: 认证接口
• services/: 业务逻辑层 (Service)
  • task_service.py: 异步任务处理 (生图/视频)
  • generation_service.py: 生成请求验证与计费
  • system_service.py: 系统配置与通知
  • history_service.py: 历史记录查询
• templates/: 前端 HTML 模板
• static/: 静态资源 (JS/CSS)