一个完全基于大模型 API 实现的 AI 服务，不依赖任何文档处理库（如 PyPDF2、python-docx 等），所有功能都通过调用大模型 API 来实现。

• 贡献指南
• 行为准则
• 更新日志
• 许可证

• 纯 AI 驱动: 所有功能通过大模型 API 实现，无需第三方处理库。实时显示硅基流动平台账户余额和状态。
• 动态模型管理: 从硅基流动平台获取模型列表，用户自主选择配置可用模型 🆕
• 功能丰富: 文本分析、代码辅助、智能对话、OCR 识别、图像描述、AI 图片编辑等
• 用户认证系统: 完整的 JWT 认证、用户注册登录、滑动验证码保护
• 现代化前端: 基于 Vue 3 + Ant Design Vue 的美观 Web 界面
• 请求日志: 完整记录所有 API 请求和响应，便于调试 🆕
• 高度可扩展: 轻松添加新的 AI 功能
• 极简架构: 只保留必要的文件和依赖
• 高可靠调用: 后端使用异步 httpx 调用硅基流动 API，支持流式响应并强化错误处理

• 跨页面模型列表自动更新: 在模型管理页面修改模型配置后，所有页面的模型下拉列表会立即更新
• 智能模型切换: 如果当前选择的模型被移除，会自动切换到可用的模型
• 事件总线机制: 使用发布订阅模式实现组件间通信，无需刷新页面

• 自定义模型顺序: 在模型管理页面可以通过拖拽调整已选模型的显示顺序
• 实时排序预览: 拖拽后立即看到新的排序，并显示序号
• 快捷移除功能: 可以直接在排序列表中移除不需要的模型
• 持久化保存: 保存配置后，所有页面的模型下拉列表将按照你设置的顺序显示

• 模型列表获取及自主配置: 从硅基流动平台实时获取所有可用模型，可自行选择并启用需要的模型，支持按类型、子类型筛选，支持模型名称模糊搜索。 一键过滤 Pro/ 开头的付费模型。模型配置保存到 data/models_config.json

• 实时余额账户状态监控: 导航栏显示硅基流动平台账户余额，显示账户状态（正常/异常），路由切换时自动更新账户信息

• 完整记录: 记录所有 API 请求参数和响应内容，显示每个请求的处理时间，格式化输出

• 首页模型滚动展示: 动态滚动显示所有配置的模型，替代单一数字

• 移除默认模型: 要求用户必须先配置模型才能使用
• 移除硬编码配置: 删除 siliconflow_models.py，改为动态配置
• 环境变量更新: 更新 .env.example，注释掉已弃用的配置

ai-service/
│
├── app/                        # 应用主目录
│   ├── api/                   # API接口
│   │   ├── ai_endpoints.py   # AI服务端点
│   │   ├── auth_endpoints.py # 认证端点
│   │   └── __init__.py
│   │
│   ├── core/                  # 核心配置
│   │   ├── config.py         # 应用配置
│   │   ├── logger.py         # 日志配置
│   │   ├── auth.py           # JWT认证逻辑
│   │   ├── user_manager.py   # 用户管理
│   │   ├── models_config_manager.py  # 模型配置管理器
│   │   ├── request_logging_middleware.py  # 请求日志中间件
│   │   └── __init__.py
│   │
│   ├── services/              # 服务层
│   │   ├── pure_ai_service.py # 纯AI服务实现
│   │   └── __init__.py
│   │
│   └── __init__.py
│
├── frontend/                  # 前端项目（Vue 3 + Ant Design Vue）
│   ├── src/                  # 源代码
│   │   ├── views/           # 页面组件
│   │   │   ├── Home.vue            # 首页
│   │   │   ├── Login.vue           # 登录页面
│   │   │   ├── TextAnalysis.vue    # 文本分析
│   │   │   ├── CodeAssist.vue      # 代码助手
│   │   │   ├── Chat.vue            # 智能对话
│   │   │   ├── OCR.vue             # 文字识别
│   │   │   ├── ImageDescription.vue # 图像描述
│   │   │   ├── ImageEdit.vue       # 图片编辑
│   │   │   └── ModelsManagement.vue # 模型管理 🆕
│   │   ├── components/      # 组件
│   │   │   └── SliderCaptcha.vue   # 滑动验证码 🆕
│   │   ├── services/        # API服务
│   │   │   └── api.js              # API封装
│   │   ├── App.vue          # 根组件
│   │   └── main.js          # 入口文件
│   ├── package.json         # 前端依赖
│   ├── vite.config.js       # 构建配置
│   └── README.md            # 前端说明
│
├── data/                      # 数据目录
│   ├── users.json            # 用户数据
│   └── models_config.json    # 模型配置 🆕
├── logs/                      # 日志目录
├── .env                       # 环境变量配置
├── .env.example              # 环境变量示例
├── .gitignore                # Git忽略文件
├── main.py                   # 主程序入口
├── start.py                  # 快速启动脚本
├── requirements.txt          # Python依赖
├── test_ai_service.py        # 测试脚本
└── README.md                 # 项目说明文档

后端文件：

• main.py: FastAPI 应用主入口，配置中间件和路由
• start.py: 便捷启动脚本，一键运行服务
• .env: 配置 API 密钥和服务参数
• app/services/pure_ai_service.py: 核心 AI 服务类，所有功能通过大模型 API 实现
• app/core/models_config_manager.py: 动态模型配置管理器
• data/models_config.json: 用户配置的可用模型列表

前端文件：

• frontend/: Vue 3 前端项目目录
• frontend/dist/: 前端构建后的静态文件（部署到 Nginx）

git clone https://github.com/yak33/ai-service.git
cd ai-service

# 使用pip直接安装
pip install -r requirements.txt

# 或使用conda环境
conda create -n ai-service python=3.11
conda activate ai-service
pip install -r requirements.txt

cd frontend

# 使用pnpm（推荐）
npm install -g pnpm
pnpm install

# 或使用npm
npm install

复制 .env.example 为 .env，然后配置：

cp .env.example .env

编辑 .env 文件：

# 应用基本配置
APP_NAME='Pure AI Service'
DEBUG=false
HOST=0.0.0.0
PORT=8000

# AI服务配置 - 硅基流动平台
OPENAI_API_KEY=your_siliconflow_api_key_here

# 默认参数配置（模型需在模型管理页面配置）
# DEFAULT_MODEL=  # 已弃用，请在模型管理页面选择模型
DEFAULT_TEMPERATURE=0.7
DEFAULT_MAX_TOKENS=2000

# 认证配置
DEFAULT_ADMIN_USERNAME=admin
DEFAULT_ADMIN_PASSWORD=123456
JWT_SECRET_KEY=your-secret-key-change-this
JWT_ALGORITHM=HS256
JWT_EXPIRE_MINUTES=1440

重要提醒:

• 请将 your_siliconflow_api_key_here 替换为你的真实 API 密钥
• 请修改 JWT_SECRET_KEY 为随机字符串
• 请修改默认管理员密码
• 首次使用前，请访问"模型管理"页面配置可用模型
• 确保 .env 文件已添加到 .gitignore 中，避免密钥泄露

适用于本地开发，支持热重载：

# 终端1：启动后端服务
python main.py
# 或
python start.py

# 终端2：启动前端开发服务器
cd frontend
pnpm dev  # 或 npm run dev

前端会自动在浏览器打开 http://localhost:3000

# 方式1：使用快速启动脚本
python start.py

# 方式2：使用main.py
python main.py

# 方式3：使用uvicorn命令
uvicorn main:app --reload --host 0.0.0.0 --port 8000

开发模式（推荐用于本地开发）:

• 🎨 前端界面: http://localhost:3000 （Vue 开发服务器，热重载）
• 🔌 后端 API: http://localhost:8000 （FastAPI 服务）
• 📚 API 文档: http://localhost:8000/docs （可交互测试）
• 📊 ReDoc 文档: http://localhost:8000/redoc （只读文档）

💡 说明: 前端运行在 3000 端口，通过 Vite 代理自动调用后端 8000 端口的 API 接口

生产部署（Linux 服务器）:

• 🎨 前端界面: 通过 Nginx 服务（如 http://your-domain.com 或 http://your-ip:80）
• 🔌 后端 API: 8000 端口（通过 Nginx 反向代理到 /api 路径）
• 📚 API 文档: http://your-domain.com/docs

💡 部署说明: 前端静态文件由 Nginx 直接服务，API 请求通过 Nginx 代理到后端 8000 端口

默认账号:

• 👤 用户名: admin
• 🔑 密码: 123456 （首次启动自动创建）

• 开发模式: 访问 http://localhost:3000 （前端自动代理后端 8000 端口）
• 生产环境: 访问你的域名或服务器 IP（由 Nginx 配置）

使用默认账号登录

1. 点击导航栏的"模型管理"菜单
2. 点击"刷新列表"按钮，从硅基流动平台获取可用模型
3. 使用筛选和搜索功能找到需要的模型
4. 勾选需要使用的模型（建议勾选"仅显示免费模型"）
5. 在右侧"已选模型"区域，可以拖拽模型调整显示顺序（拖动左侧图标即可）
6. 点击"保存配置"按钮

配置完模型后，即可使用各项 AI 功能：

• 文本分析、代码助手、智能对话等

本系统支持从硅基流动平台动态获取所有可用模型，用户可以自主选择并配置需要使用的模型。

以下是一些常用的免费模型，您可以在模型管理页面搜索并启用：

文本对话模型：

• zai-org/GLM-4.5 - 智谱 AI 对话模型（推荐）
• moonshotai/Kimi-K2-Instruct-0905 - Moonshot AI 对话模型

视觉模型：

• zai-org/GLM-4.5V - 智谱 AI 视觉语言模型（OCR 识别）
• OpenGVLab/InternVL2-26B - 视觉理解模型

图片编辑模型：

• Qwen/Qwen-Image-Edit-2509 - 通义千问图片编辑模型
  • 支持背景更换、物体添加/移除
  • 支持颜色调整、风格转换
  • 基于自然语言指令的智能编辑

注意： 模型可用性和免费额度可能随时变化，请以硅基流动平台实际为准。建议在模型管理页面勾选"仅显示免费模型"来过滤付费模型。

1. API 密钥: 确保配置了正确的硅基流动平台 API 密钥
2. 速率限制: 免费模型有调用频率限制（通常 10-20 次/分钟）
3. Token 限制: 不同模型有不同的最大 Token 限制
4. 费用: 部分模型是收费的，请查看模型列表了解价格
5. 图片编辑: 编辑后的图片 URL 有效期为 1 小时，建议及时下载保存

• fastapi: Web 框架
• uvicorn[standard]: ASGI 服务器
• httpx: 异步 HTTP 客户端
• pydantic: 数据验证
• python-dotenv: 环境变量
• loguru: 日志管理
• aiofiles: 异步文件处理
• python-multipart: 文件上传支持
• PyJWT: JWT Token 认证 🆕
• passlib: 密码加密 🆕
• python-jose: JWT 编码解码 🆕

• Vue 3: 渐进式 JavaScript 框架
• Ant Design Vue: Vue 3 组件库
• Vue Router: 官方路由管理器
• Axios: HTTP 客户端
• Vite: 现代化构建工具
• npm/pnpm: 包管理器

本项目采用"AI-First"设计理念：

• 所有文档处理通过 AI 理解而非解析库（无需 PyPDF2、python-docx 等）
• OCR 通过视觉语言模型而非 tesseract
• 代码分析通过代码模型而非 AST 解析
• 图片编辑通过 AI 模型而非传统图像处理库（支持自然语言指令）
• 充分利用大模型的理解和生成能力

• 服务无法启动: 检查 Python 版本（需要 3.8+）、确认依赖已正确安装、查看日志文件 logs/app.log
• API 调用失败: 检查 API 密钥是否正确、确认网络可以访问 api.siliconflow.cn、查看具体错误信息
• 模型不可用: 某些模型可能需要特殊权限、使用免费模型进行测试、查看模型列表确认可用模型

• 依赖安装失败: 尝试使用不同的镜像源、清理缓存后重新安装、使用 pnpm 替代 npm
• 页面无法访问: 检查端口是否被占用、确认后端服务已启动、检查代理配置
• API 请求失败: 确认后端服务运行正常、检查网络连接、查看浏览器控制台错误信息

我们欢迎并感谢所有形式的贡献！

1. 🐛 报告 Bug - 在 Issues 中提交问题
2. 💡 提出建议 - 分享你的想法和改进建议
3. 📝 改进文档 - 帮助完善文档和示例
4. 🔧 提交代码 - Fork 项目并提交 Pull Request

详细的贡献指南请查看 CONTRIBUTING.md

ZHANGCHAO

本项目采用 MIT License 开源协议。

这意味着你可以自由地：

• ✅ 商业使用
• ✅ 修改代码
• ✅ 分发
• ✅ 私人使用

但需要：

• ⚠️ 包含许可证和版权声明

如果这个项目对你有帮助，请给它一个 Star ⭐️

• 📧 提交 Issue
• 💬 参与 讨论

Made with ❤️ by ZHANGCHAO