🤖 青峰侠-Agent

一个基于大语言模型的智能体，让 AI 大模型帮助你辟除谣言

---

✨ 功能特性

功能	描述
🤖 多模型切换	支持 Doubao / Qwen / Ernie 三大模型自由切换
💬 流式对话	基于 SSE 的实时流式响应，体验丝滑流畅
🔍 智能辟谣	自动识别可疑信息，调用大模型进行事实核查
📝 历史记录	本地 SQLite 持久化存储，对话历史随时回溯
⚡ 桌面端体验	基于 Electron 的独立桌面应用，无需浏览器
🌙 深色主题	现代化 UI 设计，支持深色/浅色模式切换

🛠️ 技术架构

┌─────────────────────────────────────────┐ │ Electron 桌面壳 │ ← 独立窗口应用 ├─────────────────────────────────────────┤ │ React 18 + Vite + Tailwind CSS + Zustand │ ← 前端界面 ├─────────────────────────────────────────┤ │ FastAPI + SQLAlchemy + SQLite │ ← 后端服务 ├─────────────────────────────────────────┤ │ 火山引擎Ark / 通义千问 / 文心一言 │ ← AI 大模型 └─────────────────────────────────────────┘

🚀 快速开始

环境要求

• Node.js >= 18
• Python >= 3.10

安装步骤

#```bash

1. 克隆项目 git clone https://github.com/Sun-Qinglin/Qingfengxia_Agent.git cd Qingfengxia_Agent

2. 安装前端依赖 npm install

3. 安装 Python 依赖 pip install -r requirements.txt

4. 配置 API Key（参考下方配置说明） cp .env.example .env

5. 启动开发环境 npm run dev

⚙️ 配置说明

在应用设置面板或 .env 文件中配置以下 API Key：

模型	变量名	获取地址
火山引擎 Doubao	DOUBAO_API_KEY	火山引擎 Ark
通义千问 Qwen	QWEN_API_KEY	阿里云百炼
文心一言 Ernie	ERNIE_API_KEY	百度智能云千帆

💡 至少配置一个模型的 API Key 即可使用

📁 项目结构

Qingfengxia_Agent/ ├── backend/ # FastAPI 后端服务 │ ├── ai_clients/ # AI 模型客户端封装 │ ├── models/ # 数据模型定义 │ ├── schemas/ # Pydantic 数据校验 │ ├── services/ # 业务逻辑层 │ ├── config.py # 配置管理 │ ├── database.py # 数据库连接 │ └── main.py # 服务入口 ├── frontend/ # React 前端 │ ├── src/ │ │ ├── components/ # UI 组件 │ │ ├── api/ # API 请求封装 │ │ ├── store/ # Zustand 状态管理 │ │ └── hooks/ # 自定义 Hooks │ └── package.json ├── electron/ # Electron 主进程 ├── main.js └── preload.js ├── .env.example # 环境变量示例 ├── requirements.txt # Python 依赖 └── package.json # Node.js 依赖

📸 界面预览

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建功能分支：git checkout -b feature/xxx
3. 提交更改：git commit -m "feat: xxx"
4. 推送分支：git push origin feature/xxx
5. 提交 Pull Request

📄 许可证

MIT © 2026 Sun-Qinglin