Graphic-AI-Studio
一站式图像生成编辑平台
Grafi
原项目未提供可用图片
Grafi 是一个本地 PyQt6 桌面图像创作工具，围绕 AI 图像生成、图像编辑、画廊管理、批量生成和模型配置提供完整工作流。项目支持 OpenAI-compatible 风格接口，可配置 API Key、模型、代理和用量查询，并内置 prompt 案例库，便于快速复用和批量创作。
界面预览
项目 Logo 使用 code/icons/logo2.jpg。如果需要在 GitHub 首页展示界面效果，可将脱敏后的应用截图放入根目录 image/，然后在本节补充截图引用，例如：
注意：请不要提交包含 API Key、个人路径、私人图片、聊天记录或未脱敏账号信息的截图。
功能特性
- 创作：输入提示词并生成图像，支持会话历史、参考图和结果复用。
- 编辑：提供画布、尺寸、颜色、元素、图层和 AI 辅助编辑能力。
- 画廊：管理生成结果，支持预览、收藏、删除、清空和复用提示词。
- 批量：基于提示词和内置案例库批量生成多张变体图。
- 设置：配置供应商、API Key、默认模型、代理、模型测试和用量查询。
- 本地存储：运行数据默认写入
database/和bufferData/，便于与源码分离。
技术栈
- Python 3.9+
- PyQt6
- httpx
- socksio
- SQLite
- PyInstaller（可选，用于打包）
目录结构
Grafi/ code/ Grafi_app/ main.py # 应用启动入口 app_shell.py # 主窗口与页面装配 ui.py # 兼容导出入口 pages/ # 创作、编辑、画廊、批量、设置页面 widgets/ # 跨页面复用控件 common/ # 公共资源、样式和工具 services.py # 应用服务 storage.py # SQLite 存储 icons/ # 图标资源 prompt/ # 内置 prompt 案例库 pyproject.toml doc/ # 项目文档 Grafi.spec # PyInstaller 打包配置环境准备
建议使用虚拟环境运行：
python -m venv .venvWindows:
.venv\Scripts\activateLinux / macOS:
source .venv/bin/activate安装项目依赖：
pip install -e code启动应用
从项目根目录直接启动：
python code/Grafi_app/main.py或安装后使用模块方式启动：
python -m Grafi_app如果已安装命令行入口，也可以运行：
Grafi配置说明
首次启动时，应用会自动创建本地运行数据目录：
database/app.db：本地设置、会话、画廊记录等数据。bufferData/images/：生成图片缓存。bufferData/thumbnails/：缩略图缓存。database/exports/：导出文件。
可以通过环境变量自定义数据目录：
APP_DATA_DIR=your/data/path项目提供 code/.env.example作为配置示例。真实 API Key、代理账号和本地私有配置不应提交到 GitHub。
打包
项目根目录提供 Grafi.spec，可使用 PyInstaller 打包：
pip install pyinstallerpyinstaller Grafi.spec打包配置会包含 code/icons和 code/prompt资源目录。
开发检查
提交代码前建议执行静态编译检查：
python -m compileall code/Grafi_app如果只修改了少量文件，也可以单独检查：
python -m py_compile code/Grafi_app/main.py发布注意事项
发布到 GitHub 前请确认以下内容没有被提交：
database/bufferData/.env.idea/.vscode/.claude/.agents/__pycache__/- 真实 API Key、Token、代理密码和私人截图
.gitignore已默认排除运行数据、缓存、IDE 配置和本地 agent 状态。根目录 image/可用于存放公开的 README 截图，但提交前需要确认截图已脱敏。
语言组成
仓库未提供语言统计。
文件结构
查看完整文件清单（1 个文件）
README.md
关键源码
当前抓取数据未包含该项目的关键源码。项目介绍和已提供的文件清单保留如上。