skills-lottery-picker/projects/Qihu-AIFlow

Qihu-AIFlow V1 项目记录

记录时间: 2026-06-07 首次完整检查: ✅ 已完成 当前状态: 代码已上传服务器（/www/wwwroot/Qihu-aiflow），Docker已安装但容器尚未启动

一、项目概览

项目	内容
项目名称	Qihu-AIFlow 智能自动化PaaS平台
当前版本	v2.0.1
构建日期	2026-06-02
开发平台	https://code.tokenpony.cn/ (前期开发)
服务器	210.16.161.214 (root/XHR521yhf)
程序路径	/www/wwwroot/Qihu-aiflow
外网域名	https://bot.qihuyun.com
Git	✅ 已初始化但暂无远端仓库

一句话定位

一套私有化部署、面向个人及小微企业的AI自动化SOP一站式PaaS平台。用户无需编码即可落地全流程AI自动化业务，支持AI对话、知识管理、技能市场、Token计费、会员订阅等完整闭环体验。

二、技术栈

层级	技术
前端	React 18 + TypeScript + Vite
后端	Python 3.11 + FastAPI + SQLAlchemy ORM
数据库	MySQL 8.0 (SQLAlchemy ORM, QueuePool 20~40)
缓存	Redis 7 (requirepass: pwd2026, AOF持久化)
容器化	Docker (v29.5.2) + Docker Compose
Web服务器	Nginx 1.30.1 (容器内监听8080, BT面板Nginx监听888)

端口映射（docker-compose）

服务	容器端口	宿主机端口
前端 (Nginx)	8080	12888
后端 (Uvicorn)	18080	18080
MySQL	3306	3306
Redis	6379	6379

三、文件结构（核心）

/www/wwwroot/Qihu-aiflow/
├── run.sh                    # 一键启动脚本（Docker + 本地双模式）
├── docker-compose.yml        # 服务编排（aiflow + mysql + redis）
├── Dockerfile                # 镜像构建
├── nginx.conf                # Nginx配置（SPA路由 + API代理）
├── .env                      # 环境变量
├── VERSION                   # v2.0.1
├── CHANGELOG.md              # 变更日志
├── migrations/               # 15个SQL迁移脚本 (001-015)
├── frontend/
│   ├── dist/                 # 已构建产物（1.6M）
│   ├── src/
│   │   ├── api/index.ts      # API接口封装
│   │   ├── pages/front/      # 13个前台页面
│   │   ├── pages/admin/      # 10个后台页面
│   │   ├── components/layout/ # AdminLayout + FrontLayout
│   │   ├── contexts/AuthContext.tsx
│   │   ├── types/index.ts
│   │   └── mock/data.ts
│   └── package.json
└── backend/python/
    ├── main.py               # 入口 (214行)
    ├── requirements.txt      # 19个依赖
    └── app/
        ├── config.py         # 配置（3级域名防护）
        ├── database.py       # DB连接（QueuePool）
        ├── models.py         # 数据模型 (937行, 35+ 表)
        ├── auth.py           # JWT认证
        ├── pipeline.py       # 进化Pipeline
        ├── event_bus.py      # Redis事件总线
        ├── platform_adapter.py  # 适配器基类
        ├── message_session.py   # 消息会话
        ├── message_components.py # 消息组件
        ├── services/         # 业务服务层
        ├── platform_adapters/   # 6个IM平台适配器
        ├── middleware/         # 日志中间件
        └── api/               # 10个API模块 + 9个admin子模块

统计: 后端45个py文件 + 前端51个源文件 = 96个源代码文件

四、功能模块清单

前台功能（8+ 模块）

模块	状态	说明
AI智能对话	✅	多模型切换、Agent/技能调用、知识库关联、会话管理
频道接入IM	✅	飞书/微信/钉钉/WhatsApp/Telegram/Slack，统一Webhook
知识库管理	✅	文档上传/解析、知识图谱(LLM实体关系提取)、Canvas可视化
应用市场	✅	Skill/Agent/MCP应用发布、安装/卸载、搜索去重
Token驾驶舱	✅	Token消耗统计、CSV导出、排行榜、余额管理
付费中心	✅	会员订阅(月/季/年)、优惠券、微信/支付宝支付、实名认证
资产管理	✅	文件上传/分类/预览(Office/PDF)、AI生成图片管理
AI进化系统	✅	进化Pipeline自动监控、知识图谱构建、自动恢复
个人中心	✅	用户资料、密码修改、API Key管理
消息通知	✅	系统公告、续费提醒、订单通知

后台管理（10 大模块）

模块	状态	说明
平台驾驶舱	✅	用户/模型/订单/Token统计概览
用户管理	✅	用户CRUD、角色管理、封禁/激活
大模型库管理	✅	模型供应商管理、模型配置、全局默认模型
网站基础设置	✅	站点信息、邮件/SMTP/SMS/AI文案生成
支付渠道配置	✅	微信支付、支付宝商户配置
增值服务管理	✅	服务定价、上下架
会员订阅体系	✅	会员等级、订阅计划、自动化规则
广告位管理	✅	Banner图片上传、AI图像生成
应用市场审核	✅	应用审批、优惠券管理
日志与风控	✅	操作日志、API调用日志、付费日志审计

五、数据库概览（35+ 表）

models.py 937行，包含完整数据模型：

• 用户体系（users, roles, api_keys, login_logs等）
• 对话管理（conversations, chat_messages, session_contexts等）
• 模型管理（model_providers, models, default_models等）
• 知识库（knowledge_bases, documents, chunks, graph_nodes等）
• 应用市场（apps, app_categories, app_purchases等）
• 频道（channels, channel_oauth_states等）
• 支付（orders, subscriptions, transactions等）
• Token（token_usage, token_balance等）
• 资产（assets, asset_categories等）
• 日志（operation_logs, audit_logs, api_call_stats等）
• 广告（ad_banners）
• 进化（evolution_pipelines, build_records）

迁移脚本: 15个 (001_init ~ 015_production_fixes)

六、配置信息

配置项	值
APP_ACCESS_URL	https://bot.qihuyun.com
MYSQL_USER/PASSWORD	root / pwd2026
MYSQL_DATABASE	aiflow
REDIS_PASSWORD	pwd2026
SECRET_KEY	aiflow-secret-key-change-in-production-2026
DEBUG	false

七、已知技术亮点

1. 统一Webhook架构 — 借鉴AstrBot，通过适配器模式统一处理多平台IM消息
2. Redis事件总线 — 支持跨服务异步通信
3. Pipeline自动恢复 — 系统重启后自动恢复运行中的进化Pipeline
4. Canvas知识图谱 — 节点拖拽、悬停高亮、点击详情面板
5. 日志防删除 — 数据库层禁止DELETE操作日志
6. 智能SSL参数检测 — run.sh自动检测MySQL SSL兼容性
7. 智能密码检测 — 仅在哈希无效时重置admin密码
8. 三级域名防护 — 自动检测临时域名并覆盖为正式域名
9. Office/PDF在线预览 — 文件类型映射和预览

八、当前服务器环境

环境	状态
操作系统	Linux (BT面板管理)
BT面板	✅ 监听888端口
Docker	✅ v29.5.2
Nginx (BT)	✅ v1.30.1 监听888端口
Docker容器	❌ 尚未运行
MySQL	❌ 待Docker部署
Redis	❌ 待Docker部署
后端服务 :18080	❌ 不可达
前端页面 :12888	❌ 不可达
Git远端仓库	⚠️ 未设置
域名 bot.qihuyun.com	⚠️ 已指向但服务未启动

端口占用

端口	用途
22	SSH
53	systemd-resolve DNS
888	BT面板 Nginx
18521	BT面板

九、检查状态清单

检查项	状态	备注
源码完整性	✅	后端45py + 前端51src + 15SQL
前端构建产物	✅	dist/ 1.6M 存在
Dockerfile	✅	存在
docker-compose.yml	✅	3服务编排完整
nginx.conf	✅	SPA路由+API代理正确
.env 配置	✅	正式域名已配置
run.sh 启动脚本	✅	智能检测+自动迁移
CHANGELOG	✅	完整记录
VERSION	✅	v2.0.1
README	✅	完整文档
服务运行	❌	容器未启动
数据库	❌	待Docker部署
Git远端	⚠️	已初始化未设置远端

十、首次启动（待执行）

cd /www/wwwroot/Qihu-aiflow
docker compose up -d --build

# 验证
curl http://localhost:18080/app/api/health
curl http://localhost:12888/
docker compose logs -f aiflow

首次启动MySQL容器初始化约30-60秒，aiflow容器等待MySQL健康后才开始。

---

V1 记录完毕。部署运行并验证功能后更新至 V1.1 或 V2。