# GEO平台 用户操作手册

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

---

## 目录

1. [快速开始](#1-快速开始) - 5分钟快速上手
2. [新用户引导](#2-新用户引导) - 引导向导使用说明
3. [品牌健康中心](#3-品牌健康中心) - Dashboard健康状态看板
4. [品牌管理](#4-品牌管理)
5. [竞品管理](#5-竞品管理)
6. [AI数据采集](#6-ai数据采集)
7. [数据分析与评分](#7-数据分析与评分)
8. [竞品对比](#8-竞品对比)
9. [下一步行动](#9-下一步行动) - 智能行动建议
10. [报告导出](#10-报告导出)
11. [常见问题](#11-常见问题)

---

## 1. 快速开始

### 1.1 登录账号

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

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

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

### 1.2 5分钟快速上手

GEO平台设计为**5分钟快速体验价值**：

```
第1分钟 → 输入品牌名称
第2分钟 → 确认竞品（可跳过）
第3分钟 → 选择监控平台（默认全选）
第4分钟 → 查看品牌健康报告
第5分钟 → 获取下一步行动建议
```

---

## 2. 新用户引导

### 2.1 什么是引导向导？

首次登录后，系统会自动展示**新用户引导向导**，帮助您：
- 快速了解平台功能
- 5分钟内看到品牌健康报告
- 获得个性化行动建议

### 2.2 引导流程（5步）

**Step 1: 输入品牌名称**

```
┌─────────────────────────────────────────────────────────────┐
│  🔍 请输入您的品牌名称                                       │
│                                                             │
│  [深度求索                                           ]     │
│                                                             │
│                           [开始分析 →]                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

**Step 2: 确认竞品（可跳过）**

系统根据您的品牌推荐3个竞品，您可以选择：
- ☑ 保留推荐竞品
- ☐ 取消选择不需要的
- [添加其他竞品]
- [跳过此步]

**Step 3: 选择监控平台（可跳过）**

默认全选7个AI平台：
- ☑ 文心一言 ☑ Kimi ☑ 通义
- ☑ 豆包 ☑ 讯飞 ☑ 天工 ☑ 智谱

**Step 4: 查看健康报告**

系统生成品牌健康报告，包含：
- 综合评分（0-100）
- 健康等级（优秀/良好/及格/危险）
- 与竞品对比概览

**Step 5: 下一步行动建议**

系统根据您的品牌状态，推荐最需要做的事情：

```
┌─────────────────────────────────────────────────────────────┐
│  🎯 为您推荐的下一步行动                                   │
│                                                             │
│  ⚠️ 主要: 您的品牌在Kimi平台落后竞品15分                │
│     [查看差距分析 →]                                      │
│                                                             │
│  💡 次要: 添加更多查询词以获得更完整的分析                  │
│     [添加查询词 →]                                        │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

### 2.3 跳过引导

如果不想使用引导向导：
- 可以随时点击"跳过"
- 后续可以在品牌列表页重新触发引导
- 跳过引导不会影响正常使用

---

## 3. 品牌健康中心

### 3.1 Dashboard概览

登录后首先看到的是**品牌健康中心**（Dashboard），这是您品牌的"体检报告"。

### 3.2 核心指标卡片

```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  综合评分        竞品地位        趋势          监控平台    │
│  ┌─────┐      ┌─────┐      ┌─────┐      ┌─────┐      │
│  │ 78  │      │ 领先 │      │ +3% │      │ 7/7 │      │
│  │/100 │      │超2竞品│      │ 本月 │      │ 平台 │      │
│  │🟢良好│      └─────┘      └─────┘      └─────┘      │
│  └─────┘                                                  │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

### 3.3 健康等级说明

| 等级 | 分数范围 | 颜色 | 含义 |
|------|---------|------|------|
| 🟢 优秀 | 80-100 | 绿色 | 品牌在AI中表现优异 |
| 🟡 良好 | 60-79 | 黄色 | 品牌在AI中表现良好 |
| 🟠 及格 | 40-59 | 橙色 | 品牌在AI中表现一般 |
| 🔴 危险 | 0-39 | 红色 | 品牌在AI中表现较差 |

### 3.4 平台评分列表

每个平台的评分可视化展示：

```
┌─────────────────────────────────────────────────────────────┐
│  各平台评分                                                │
│                                                             │
│  文心一言  ████████████░░░░░░░░░░░░  85分  ↑领先5分   │
│  通义千问  ████████████████░░░░░░░░░  92分  ↑领先12分  │
│  Kimi     ██████████░░░░░░░░░░░░░░░  68分  ↓落后15分⚠️│
│  豆包     ██████████░░░░░░░░░░░░░░░  65分  ↓落后8分   │
│  讯飞星火  ████████████░░░░░░░░░░░░░  78分  ↑领先3分   │
│  天工AI   ██████████░░░░░░░░░░░░░░░  62分  ↓落后10分  │
│  智谱清言  ███████████░░░░░░░░░░░░░░░  70分  持平      │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

**图例说明**:
- 进度条 = 评分（0-100）
- ↑ = 领先竞品（绿色）
- ↓ = 落后竞品（红色）
- ⚠️ = 危险信号，需要关注

---

## 4. 品牌管理

### 4.1 添加品牌

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

**步骤**:

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

2. 填写品牌信息表单：

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

3. 点击"确认添加"

### 4.2 编辑品牌

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

### 4.3 删除品牌

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

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

---

## 5. 竞品管理

### 5.1 添加竞品

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

**步骤**:

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

3. 填写竞品信息：

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

4. 点击"确认添加"

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

### 5.2 删除竞品

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

---

## 6. AI数据采集

### 6.1 触发采集

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

**步骤**:

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

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

### 6.2 查看采集状态

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

### 6.3 采集结果说明

采集完成后会返回：

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

---

## 7. 数据分析与评分

### 7.1 查看评分

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

**Dashboard展示内容**:

1. **综合评分卡片** - 大数字显示评分 + 健康等级
2. **平台评分列表** - 7个AI平台的独立评分 + 进度条
3. **竞品对比** - 与竞品的差距分析
4. **行动建议** - 下一步应该做什么

### 7.2 评分指标说明

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

### 7.3 评分计算公式

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

---

## 8. 竞品对比

### 8.1 进入对比页面

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

### 8.2 选择对比品牌

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

### 8.3 查看对比结果

对比表格显示：

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

### 8.4 差异高亮说明

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

---

## 9. 下一步行动

### 9.1 什么是行动建议？

系统根据您品牌的当前状态，智能推荐最应该做的事情。

### 9.2 行动优先级

| 优先级 | 标签 | 说明 |
|--------|------|------|
| 主要行动 | ⚠️ 红色边框 | 最紧急，需要立即关注的问题 |
| 次要行动 | 💡 蓝色边框 | 建议优化项 |
| 可选行动 | 🔔 灰色边框 | 高级功能 |

### 9.3 行动示例

**当您的品牌评分较低时**:
```
⚠️ 主要: 您的品牌在Kimi平台落后竞品15分
   [查看差距分析 →]

💡 次要: 添加更多查询词以获得更完整的分析
   [添加查询词 →]
```

**当您领先竞品时**:
```
💡 主要: 您的品牌表现优异！继续保持
   [查看详细报告 →]

🔔 可选: 设置竞品超越预警
   [立即设置 →]
```

### 9.4 行动建议出现位置

- Dashboard底部（固定显示）
- 品牌详情页底部
- 竞品对比页底部

---

## 10. 报告导出

### 10.1 导出CSV报告

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

**步骤**:

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

### 10.2 报告内容

CSV报告包含：

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

---

## 11. 常见问题

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

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

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

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

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

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

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

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

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

### Q4: 什么是健康等级？

**说明**:
- 🟢 优秀(80-100): 品牌在AI中表现优异
- 🟡 良好(60-79): 品牌在AI中表现良好
- 🟠 及格(40-59): 品牌在AI中表现一般
- 🔴 危险(0-39): 品牌在AI中表现较差

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

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

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

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

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

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

### Q7: 引导向导可以跳过吗？

**可以**:
- 引导向导每一步都可以跳过
- 后续可以在品牌列表页重新触发引导
- 跳过引导不会影响正常使用

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

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

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

---

## 附录

### A. 技术支持

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

### B. 版本信息

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

---

**文档更新记录**:

| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v1.0 | 2026-05-02 | 初始版本 |
| v2.0 | 2026-05-04 | 新增新用户引导向导、健康状态Dashboard、下一步行动建议功能说明 |
