# AiAgent

**Repository Path**: xiaowangdada/ai-agent

## Basic Information

- **Project Name**: AiAgent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 聚合服务平台（ai-aggregation-platform）

> 1:1 复刻 bb.lk666.ai 财神 AI 平台 — 数据驱动 + 多端可分发的 AI 聚合服务平台。
>
> 一期目标：视觉 + 数据展示 + 用户基础 + 后台 CMS + 网关骨架 + 代理分销骨架 + 白标 + 工作流骨架（Mock 适配器返回真实可见示例数据）。
>
> 详细需求、设计、任务拆分见 `.kiro/specs/ai-aggregation-platform/` 下的 `requirements.md` / `design.md` / `tasks.md` / `deployment.md`。

## 项目简介

聚合 500+ 全球顶尖大模型（GPT / Claude / Gemini / 豆包 / 千问 / DeepSeek / 可灵 / Vidu / Pix / Suno …），覆盖：

- **大模型工作区**：聊天 / 图片 / 视频 / 音频 4 大类共 60+ 模型
- **智能体工作区**：API 开放接口、AI 漫剧、电商一键生图等 7+ 智能体
- **灵感广场**：80+ 风格标签 + 30+ 作品瀑布流
- **管理后台**：13 个 CMS 模块（用户 / 模型 / 智能体 / 灵感 / 公告 / 反馈 / 客服 / 价格 / API 文档 / 代理 / 站点配置 / 网关 / 工作流监控）
- **代理分销**：无限层级 + 实时分账 + 钱包提现 + 白标多租户
- **AI 网关**：统一适配器 + 多 Key 池 + 故障转移 + 健康巡检

## 技术栈

| 分层 | 技术 |
| --- | --- |
| 后端 | ThinkPHP 8.x（PHP ≥ 8.1） + think-orm + think-filesystem |
| 鉴权 | firebase/php-jwt（JWT Bearer） |
| 测试 | PHPUnit 10 + giorgiosironi/eris（属性测试 PBT） |
| 数据 | **生产**：腾讯云 TencentDB for MySQL 8.0（高可用版，内网 `10.0.0.5:3306`）+ Redis 6+；**开发/回滚**：本地 MySQL 5.7+/8.0 + Redis（`127.0.0.1`） |
| 工具 | phpoffice/phpspreadsheet（Excel 导入）、predis/predis（Redis 客户端） |
| 前端 | Uniapp（Vue 3 + Vite） + uni-ui + Pinia |
| 富文本 | vditor（H5 后台编辑） + marked + DOMPurify（H5）+ mp-html（小程序/App） |
| 表格 / 图表 | xlsx、qiun-data-charts（uni-app 图表） |

## 目录结构

```
test.wwwcaishen.cn/             # 仓库根 = ThinkPHP 后端根（平铺，无 backend/ 子目录）
├─ app/                         # ThinkPHP 应用代码（Controller / Service / Model / Validate / Middleware / Command）
├─ config/                      # 框架配置
├─ extend/                      # PSR-0 扩展类库
├─ public/                      # Web 入口（同源部署）：
│  ├─ index.php                 #   ThinkPHP 入口（受 .gitignore 保护，不被前端构建覆盖）
│  ├─ .htaccess / router.php    #   Apache / 内置 PHP server 路由
│  ├─ index.html                #   ⬅ 前端 H5 构建产物（Vite outDir 写入）
│  ├─ assets/                   #   ⬅ 前端打包后的 JS/CSS/字体/图（带 hash）
│  └─ storage/                  #   上传 + demo 资源（init:demo-assets 写入）
├─ route/                       # 路由（api.php / admin.php / dealer.php）
├─ runtime/                     # 缓存/日志（git 忽略）
├─ vendor/                      # composer 依赖（git 忽略）
├─ frontend-uniapp/             # 前端 Uniapp 工程（独立 package.json）
│  ├─ src/                      #   pages / components / store / utils / api
│  ├─ package.json
│  ├─ vite.config.ts            #   outDir = '../public'，emptyOutDir = false
│  └─ tsconfig.json
├─ composer.json                # 后端依赖
├─ think                        # ThinkPHP CLI（php think <command>）
├─ .env.example                 # 环境变量模板
├─ .editorconfig                # 编辑器约定（4 空格 PHP / 2 空格 JS-Vue）
├─ .php-cs-fixer.dist.php       # PSR-12 规则
└─ .kiro/specs/                 # 需求 / 设计 / 任务 / 部署文档
   └─ ai-aggregation-platform/
      ├─ requirements.md
      ├─ design.md
      ├─ tasks.md
      └─ deployment.md
```

> 构建产物 `index.html` + `assets/` 直接落入仓库根 `public/`，与 `index.php` 同源 — **无需 CORS、无需独立 Nginx server 块**。`emptyOutDir: false` 保证 ThinkPHP 入口文件不会被前端 build 删除。

## 环境要求

- PHP **8.1+**（推荐 8.2，需启用 `mbstring openssl curl pdo_mysql fileinfo zip bcmath intl gd opcache`）
- Composer 2.x
- Node.js **18+**（推荐 20 LTS）+ pnpm 9
- MySQL 5.7+ 或 8.0（生产已切换为腾讯云 RDS，详见下文）
- Redis 6+

## 数据库连接（重要）

生产环境的 MySQL 已迁移到 **腾讯云 TencentDB for MySQL 8.0**（实例 `cdb-12or7bk4`，成都一区，2 核 4 GB / SSD 100 GB）。两套地址按场景使用：

| 场景 | 地址 | 端口 | 说明 |
| --- | --- | --- | --- |
| 生产应用（轻量服务器 1.14.48.166） | `10.0.0.5` | `3306` | VPC 内网，写入 `.env`；轻量需先开「内网互联」/CCN 接入 RDS 所在 VPC |
| 本地 / 临时调试（Navicat 等） | `cd-cdb-12or7bk4.sql.tencentcdb.com` | `20650` | 公网，需在 RDS 控制台开外网 + 安全组放行你的公网 IP；用完关闭外网 |

账号 / 库名沿用：`wwwcaishen_cn` / `wwwcaishen_cn`，字符集 `utf8mb4` / `utf8mb4_unicode_ci`。
完整接入步骤、安全组、数据迁移、备份命令见 [`.kiro/specs/ai-aggregation-platform/deployment.md §1.7 / §9.1`](.kiro/specs/ai-aggregation-platform/deployment.md)。

> 生产 `.env` 的 `HOSTNAME` **永远写内网 `10.0.0.5`**；外网地址只用于本机 Navicat 调试。

## 启动顺序（开发期）

### 1. 后端

```bash
# 1. 拉依赖
composer install

# 2. 复制环境变量并按需修改 DB / JWT_SECRET / REDIS
cp .env.example .env

# 3. 数据库迁移（任务 3 完成后可用）
php think migrate:run

# 4. 一键种子（一期"真实可见"必跑；写入模型 / 智能体 / 灵感 / 标签 / 网关示例 / 分销 / 白标 / demo 任务）
php think init:all

# 5. 启动开发服务器（默认 http://127.0.0.1:8000）
php think run
```

### 2. 前端（Uniapp，H5 开发）

```bash
cd frontend-uniapp
pnpm install
pnpm run dev:h5            # 默认 http://127.0.0.1:5173
```

开发期前端独立运行 vite dev server；接口请求经 `/api/*` `/admin/*` 通过 `vite.config.ts` 的代理转发到后端 `php think run`（任务 16 在 `vite.config.ts` 中追加 `server.proxy`）。

### 3. 前端构建（生产 / 部署）

```bash
cd frontend-uniapp
pnpm run build:h5
# 产物自动输出到仓库根 public/index.html + public/assets/
# 与 ThinkPHP 入口 index.php 同源部署，参见 .kiro/specs/ai-aggregation-platform/deployment.md
```

其他端构建：`pnpm run build:mp-weixin`（微信小程序）/ `pnpm run build:app`（App，需配合 HBuilderX 云打包）。

## Demo 账号

由 `php think init:admin` 与 `php think init:demo-dealers` 写入，统一密码读取 `.env DEMO_PASSWORD`（默认 `Demo@2025`）：

| 角色 | 账号 | 说明 |
| --- | --- | --- |
| 管理员 | `admin@demo.local` | role=admin，可访问 /pages/admin/* |
| 总代 | `boss@demo.local` | dealer_level=3 |
| 一级代理 | `agent1@demo.local` | dealer_level=2 |
| 二级代理 | `agent2@demo.local` | dealer_level=1 |
| 终端用户 | `user@demo.local` | role=user |

详见 `.kiro/specs/ai-aggregation-platform/deployment.md` §7 验收清单。

## 部署

完整部署手册（含 Nginx 同源 server 块、HTTPS、白标多域名、备份、安全清单）见：

> [`.kiro/specs/ai-aggregation-platform/deployment.md`](.kiro/specs/ai-aggregation-platform/deployment.md)

简言之：

```bash
# 服务器 /var/www/wwwcaishen_cn/ 即仓库根
composer install --no-dev --optimize-autoloader
cp .env.example .env && vim .env       # 改 DB / JWT_SECRET
php think migrate:run
php think init:all

cd frontend-uniapp
pnpm install --frozen-lockfile
pnpm run build:h5                       # 产物落入仓库根 public/

# Nginx 单 server 块：root = /var/www/wwwcaishen_cn/public
#   /api、/admin   → index.php（ThinkPHP）
#   /              → index.html（前端 SPA fallback）
systemctl reload nginx php8.2-fpm
```

## 代码规范

- PHP 走 `vendor/bin/php-cs-fixer fix`（PSR-12 + 短数组 + 单引号）
- 前端 `cd frontend-uniapp && pnpm run lint && pnpm run format`
- 全局 `.editorconfig`：PHP 4 空格 / JS-Vue-JSON 2 空格 / UTF-8 / LF

## 文档导航

| 文件 | 内容 |
| --- | --- |
| [.kiro/specs/ai-aggregation-platform/requirements.md](.kiro/specs/ai-aggregation-platform/requirements.md) | 完整需求（28 个 Requirement，含验收标准） |
| [.kiro/specs/ai-aggregation-platform/design.md](.kiro/specs/ai-aggregation-platform/design.md) | 架构设计、组件、数据模型、ER 图、流程时序 |
| [.kiro/specs/ai-aggregation-platform/tasks.md](.kiro/specs/ai-aggregation-platform/tasks.md) | 实施计划（24 大任务 + 12 个 wave 依赖图） |
| [.kiro/specs/ai-aggregation-platform/deployment.md](.kiro/specs/ai-aggregation-platform/deployment.md) | 部署手册（同源单 server 块、HTTPS、安全） |

## License

Apache-2.0（沿用 ThinkPHP 协议）。