- 增加图片分辨率检测,提示用户图片超过2K分辨率 - 对大于2K分辨率图片进行自动缩放压缩,确保宽高不超过2048 - 在生成Base64时保持图片原格式,非PNG格式转为JPEG并设定压缩质量为0.9 - 优化上传流程,避免因大图影响性能和加载速度 - 提示文字及状态更新,提升用户体验 |
||
|---|---|---|
| .agent/workflows | ||
| .shared/ui-ux-pro-max | ||
| blueprints | ||
| middlewares | ||
| migrations | ||
| services | ||
| static | ||
| templates | ||
| .gitignore | ||
| app.py | ||
| config.py | ||
| db_manager.py | ||
| extensions.py | ||
| models.py | ||
| README.md | ||
| requirements.txt | ||
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。
🛠️ 常用维护命令
数据库管理 (推荐)
本项目内置了自动化数据库管理工具 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)