# 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远端 | ⚠️ | 已初始化未设置远端 |

## 十、首次启动（待执行）

```bash
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。*