# SuperGEO

**Repository Path**: DS-ADMIN/super-geo

## Basic Information

- **Project Name**: SuperGEO
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SuperGeo - AI 生成引擎优化平台

## 系统简介

SuperGeo 是一个一站式 AI 内容生产、多渠道分发、AI 引擎收录监控和效果优化平台。系统核心功能包括:

- **AI 内容生成**: 基于 DeepSeek、豆包、通义千问、Kimi 等大模型生成高质量内容
- **多渠道分发**: 支持微信公众号、微博、知乎、百家号、抖音、快宝等平台
- **收录监控**: 实时监控 AI 引擎收录情况和关键词排名
- **数字员工**: 核心差异化功能,提供个性化 AI 助手服务

## 技术栈

### 后端
- FastAPI (Python 3.10+)
- SQLAlchemy (异步 ORM)
- PostgreSQL
- Redis
- Celery (异步任务队列)
- Pydantic (数据验证)

### 前端
- Vue 3
- TypeScript
- Element Plus
- Vite
- Vue Router
- Pinia

## 项目结构

```
super-geo/
├── backend/                 # 后端项目
│   ├── app/
│   │   ├── api/            # API 路由
│   │   │   └── v1/         # API v1 版本
│   │   ├── core/           # 核心功能
│   │   │   ├── ai_provider.py
│   │   │   └── config.py
│   │   ├── models/         # 数据模型
│   │   │   ├── base.py
│   │   │   ├── user.py
│   │   │   ├── customer.py
│   │   │   ├── project.py
│   │   │   ├── keyword.py
│   │   │   ├── content.py
│   │   │   ├── publish_task.py
│   │   │   ├── monitoring_probe.py
│   │   │   ├── workflow.py
│   │   │   └── digital_employee.py
│   │   ├── schemas/        # Pydantic 模型
│   │   │   ├── user.py
│   │   │   ├── customer.py
│   │   │   ├── project.py
│   │   │   ├── keyword.py
│   │   │   ├── content.py
│   │   │   ├── publish_task.py
│   │   │   ├── monitoring_probe.py
│   │   │   ├── workflow.py
│   │   │   └── digital_employee.py
│   │   ├── tasks/          # Celery 任务
│   │   │   ├── celery_app.py
│   │   │   ├── ai_tasks.py
│   │   │   ├── publish_task.py
│   │   │   └── monitoring_probe.py
│   │   └── utils/          # 工具函数
│   ├── alembic/            # 数据库迁移
│   ├── main.py             # 应用入口
│   └── requirements.txt    # 依赖
├── frontend/               # 前端项目
│   ├── src/
│   │   ├── views/         # 页面组件
│   │   │   ├── auth/      # 认证相关
│   │   │   │   └── LoginView.vue
│   │   │   ├── dashboard/ # 仪表盘
│   │   │   │   └── DashboardView.vue
│   │   │   ├── project/   # 项目管理
│   │   │   │   ├── ProjectListView.vue
│   │   │   │   └── ProjectDetailView.vue
│   │   │   ├── keyword/   # 关键词管理
│   │   │   │   └── KeywordListView.vue
│   │   │   ├── content/   # 内容管理
│   │   │   │   └── ContentListView.vue
│   │   │   ├── publish/   # 发布管理
│   │   │   │   └── PublishListView.vue
│   │   │   ├── monitor/   # 监控管理
│   │   │   │   └── MonitorView.vue
│   │   │   ├── customer/  # 客户管理
│   │   │   │   └── CustomerListView.vue
│   │   │   ├── digital-employee/ # 数字员工
│   │   │   │   ├── DigitalEmployeeListView.vue
│   │   │   │   ├── DigitalEmployeeChatView.vue
│   │   │   │   └── components/
│   │   │   │       └── EmployeeDialog.vue
│   │   │   └── settings/  # 系统设置
│   │   │       └── SettingsView.vue
│   │   ├── layouts/       # 布局组件
│   │   │   └── MainLayout.vue
│   │   ├── router/        # 路由配置
│   │   │   └── index.ts
│   │   ├── api/           # API 调用
│   │   │   ├── index.ts
│   │   │   ├── auth.ts
│   │   │   └── digital-employee.ts
│   │   ├── types/         # TypeScript 类型
│   │   │   └── digital-employee.ts
│   │   ├── store/         # 状态管理
│   │   ├── assets/        # 静态资源
│   │   ├── App.vue
│   │   └── main.ts
│   ├── public/
│   │   └── index.html
│   ├── package.json
│   ├── tsconfig.json
│   ├── tsconfig.node.json
│   └── vite.config.ts
└── doc/                    # 文档
```

## 快速开始

### 环境要求

- Python 3.10+
- Node.js 18+
- PostgreSQL 14+
- Redis 6+

### 后端启动

```bash
cd backend

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件,配置数据库、Redis、AI API 密钥等

# 创建数据库
createdb supergeo

# 运行数据库迁移
alembic upgrade head

# 启动应用
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# 启动 Celery Worker
celery -A app.tasks.celery_app worker --loglevel=info

# 启动 Celery Beat
celery -A app.tasks.celery_app beat --loglevel=info
```

### 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

**访问地址:**
- 前端应用: http://localhost:3000
- API 文档: http://localhost:8000/docs

## 核心功能

### 1. 数字员工 (Digital Employee)

数字员工是系统的核心差异化功能,提供个性化的 AI 助手服务。

**主要特性:**
- 自定义角色和性格
- 专属知识库
- 多种能力配置
- 交互历史记录

**API 端点:**
- `POST /api/v1/digital-employees/` - 创建数字员工
- `GET /api/v1/digital-employees/` - 获取员工列表
- `GET /api/v1/digital-employees/{id}` - 获取员工详情
- `PUT /api/v1/digital-employees/{id}` - 更新员工信息
- `DELETE /api/v1/digital-employees/{id}` - 删除员工
- `POST /api/v1/digital-employees/{id}/interact` - 与员工交互

### 2. AI 内容生成

支持多种 AI 模型:
- DeepSeek
- 豆包 (Volcengine)
- 通义千问 (Qwen)
- Kimi (Moonshot)

**主要功能:**
- 关键词生成
- 内容创作
- SEO 评分
- 合规检查

### 3. 多渠道分发

支持平台:
- 微信公众号
- 微博
- 知乎
- 百家号
- 抖音
- 快宝

### 4. 收录监控

- 实时监控 AI 引擎收录情况
- 关键词排名跟踪
- 品牌提及监控
- 效果分析报告

## 配置说明

### 环境变量 (.env)

```env
# 数据库
DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/supergo

# Redis
REDIS_URL=redis://localhost:6379/0

# AI API 密钥
DEEPSEEK_API_KEY=your_deepseek_api_key
DOUBAO_API_KEY=your_doubao_api_key
TONGYI_API_KEY=your_tongyi_api_key
KIMI_API_KEY=your_kimi_api_key

# JWT
SECRET_KEY=your_secret_key
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30

# Celery
CELERY_BROKER_URL=redis://localhost:6379/1
CELERY_RESULT_BACKEND=redis://localhost:6379/2
```

## 开发指南

### 代码规范

- Python: PEP 8
- TypeScript: ESLint + TypeScript
- 提交规范: Conventional Commits

### 测试

```bash
# 后端测试
pytest

# 前端测试
npm run test:unit
```

### 文档

- API 文档: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

## 许可证

MIT License

## 联系方式

如有问题,请提交 Issue 或联系开发团队。