# GEO平台 用户操作手册

> **文档版本**: v1.0
> **创建日期**: 2026-05-02
> **适用版本**: GEO平台 MVP v1.0

---

## 目录

1. [快速开始](#1-快速开始)
2. [品牌管理](#2-品牌管理)
3. [竞品管理](#3-竞品管理)
4. [AI数据采集](#4-ai数据采集)
5. [数据分析与评分](#5-数据分析与评分)
6. [竞品对比](#6-竞品对比)
7. [报告导出](#7-报告导出)
8. [常见问题](#8-常见问题)

---

## 1. 快速开始

### 1.1 登录账号

**步骤1**: 打开浏览器，访问 http://localhost:3000

**步骤2**: 输入管理员账号信息
- 邮箱: `admin@example.com`
- 密码: `admin@123`

**步骤3**: 点击"登录"按钮进入系统

### 1.2 首次使用引导

首次登录后，建议按以下顺序操作：

1. **添加要监控的品牌** → 品牌管理
2. **添加竞争对手品牌** → 竞品管理
3. **触发首次数据采集** → AI数据采集
4. **查看分析结果** → 数据分析

---

## 2. 品牌管理

### 2.1 添加品牌

**入口**: 左侧菜单 → 品牌管理

**步骤**:

1. 点击"添加品牌"按钮

2. 填写品牌信息表单：

| 字段 | 说明 | 示例 |
|------|------|------|
| 品牌名称 | 必填，您的品牌名称 | 深度求索 |
| 品牌别名 | 逗号分隔的别名 | DeepSeek, DeepSeek AI |
| 官方网站 | 可选，品牌官网URL | https://deepseek.com |
| 行业 | 可选，品牌所属行业 | 人工智能 |
| 监控平台 | 多选，要监控的AI平台 | 文心一言、Kimi、通义 |

3. 点击"确认添加"

**支持的AI平台**:

| 平台 | 说明 |
|------|------|
| 文心一言 | 百度AI助手 |
| Kimi | 月之暗面AI助手 |
| 通义 | 阿里云AI助手 |
| 豆包 | 字节跳动AI助手 |
| 讯飞 | 科大讯飞AI助手 |
| 天工 | 昆仑万维AI助手 |
| 清言 | 智谱AI助手 |

### 2.2 编辑品牌

**步骤**:

1. 在品牌列表中找到要编辑的品牌
2. 点击操作列的"编辑"按钮
3. 修改品牌信息
4. 点击"保存"

### 2.3 删除品牌

**步骤**:

1. 在品牌列表中找到要删除的品牌
2. 点击操作列的"删除"按钮
3. 在确认对话框中点击"确定"

**注意**: 删除品牌会同时删除关联的竞品数据和查询记录

---

## 3. 竞品管理

### 3.1 添加竞品

**入口**: 品牌详情页 → 竞品管理模块

**步骤**:

1. 进入某个品牌的详情页
2. 在竞品管理模块点击"添加竞品"

3. 填写竞品信息：

| 字段 | 说明 | 示例 |
|------|------|------|
| 竞品名称 | 必填，竞品品牌名称 | OpenAI |
| 竞品别名 | 逗号分隔的别名 | ChatGPT, GPT |

4. 点击"确认添加"

**限制**: 每个品牌最多添加5个竞品

### 3.2 删除竞品

**步骤**:

1. 进入品牌详情页的竞品管理模块
2. 找到要删除的竞品
3. 点击操作列的"删除"按钮
4. 在确认对话框中点击"确定"

---

## 4. AI数据采集

### 4.1 触发采集

**入口**: 品牌详情页

**步骤**:

1. 进入要采集的品牌详情页
2. 点击右上角"立即查询"按钮
3. 系统将自动在7大AI平台进行数据采集

**等待时间**: 通常需要30秒-2分钟完成所有平台采集

### 4.2 查看采集状态

采集过程中可以：

- 查看各平台的采集状态（采集中/成功/失败）
- 实时显示已获取的引用数据条数
- 采集完成后自动更新评分数据

### 4.3 采集结果说明

采集完成后会返回：

| 数据项 | 说明 |
|--------|------|
| 引用文本 | AI助手中提到品牌的内容片段 |
| 引用位置 | 品牌在结果中的排名 |
| 情感倾向 | 正面/中性/负面 |
| 置信度 | 结果的可靠程度（0-1） |

---

## 5. 数据分析与评分

### 5.1 查看评分

**入口**: 左侧菜单 → Dashboard

**Dashboard展示内容**:

1. **综合评分卡片**
   - 大数字显示评分（满分100）
   - 显示较昨日变化（↑或↓）

2. **平台评分列表**
   - 7个AI平台的独立评分
   - 进度条可视化

3. **最近查询记录**
   - 最近10条查询的详情

### 5.2 评分指标说明

| 指标 | 说明 | 计算方式 |
|------|------|----------|
| 综合评分 | 品牌整体AI曝光度 | MIN(100, 各项加权求和) |
| 提及率得分 | 品牌被引用频率 | (引用次数/查询总次数)×100×30% |
| SOV得分 | 品牌在竞品中的占比 | (品牌引用/品牌+竞品引用)×100×40% |
| 引用质量得分 | 引用内容的质量评估 | 情感×0.4+位置×0.3+长度×0.3)×100×30% |

### 5.3 评分计算公式

```
综合评分 = MIN(100, 提及率得分×30% + SOV得分×40% + 引用质量得分×30%)
```

---

## 6. 竞品对比

### 6.1 进入对比页面

**入口**: 左侧菜单 → 竞品对比

### 6.2 选择对比品牌

**步骤**:

1. 在页面顶部下拉框选择要对比的品牌
2. 系统自动加载该品牌及其竞品的评分数据

### 6.3 查看对比结果

对比表格显示：

| 指标 | 您的品牌 | 竞品A | 竞品B | ... |
|------|---------|-------|-------|-----|
| 综合评分 | 85 | 78 | 72 | ... |
| 提及率得分 | 80 | 75 | 68 | ... |
| SOV得分 | 88 | 65 | 70 | ... |
| 引用质量得分 | 82 | 80 | 75 | ... |
| 引用次数 | 156 | 98 | 87 | ... |

### 6.4 差异高亮说明

- **绿色背景 + 深绿文字**: 品牌优于所有竞品
- **红色背景 + 深红文字**: 品牌弱于所有竞品
- **绿色文字**: 该竞品优于您的品牌
- **红色文字**: 该竞品弱于您的品牌

---

## 7. 报告导出

### 7.1 导出CSV报告

**入口**: 品牌详情页 或 竞品对比页

**步骤**:

1. 进入要导出的页面
2. 点击"导出CSV"按钮
3. 浏览器将自动下载CSV文件

### 7.2 报告内容

CSV报告包含：

| 列名 | 说明 |
|------|------|
| 查询时间 | 数据采集的时间 |
| 关键词 | 触发采集的搜索词 |
| 品牌名称 | 被分析的品牌 |
| 引用文本 | AI助手中的原文 |
| 引用位置 | 排名位置 |
| 情感倾向 | positive/neutral/negative |
| 置信度 | 0-1之间的小数 |

---

## 8. 常见问题

### Q1: 登录失败怎么办？

**可能原因**:
- 邮箱或密码错误
- 账号已被禁用

**解决方案**:
- 确认使用正确账号: `admin@example.com`
- 确认密码为: `admin@123`
- 联系管理员检查账号状态

### Q2: 采集失败怎么办？

**可能原因**:
- 网络连接问题
- AI平台服务暂时不可用
- API调用频率超限

**解决方案**:
- 检查网络连接
- 稍后重试采集
- 查看各平台的独立状态

### Q3: 评分显示为0怎么办？

**可能原因**:
- 尚未执行数据采集
- 采集结果无有效引用

**解决方案**:
- 执行"立即查询"进行数据采集
- 等待采集完成
- 检查品牌名称和别名是否正确设置

### Q4: 如何添加更多竞品？

**限制**: 每个品牌最多添加5个竞品

**解决方案**:
- 删除不再需要对比的竞品
- 然后添加新的竞品

### Q5: 忘记密码怎么办？

**请联系管理员重置密码**

管理员可使用数据库管理工具直接更新用户密码。

### Q6: 数据显示延迟？

**正常现象**: 数据采集和分析需要一定时间

**建议**: 采集完成后等待1-2分钟再查看最新数据

---

## 附录

### A. 技术支持

- 后端API文档: http://localhost:8000/docs
- 前端地址: http://localhost:3000

### B. 版本信息

| 组件 | 版本 |
|------|------|
| 后端 | FastAPI + SQLAlchemy |
| 前端 | Next.js 14 |
| 数据库 | PostgreSQL |
| AI模型 | DeepSeek Chat |

---

**文档更新记录**:

| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v1.0 | 2026-05-02 | 初始版本 |
