513 lines
15 KiB
Markdown
513 lines
15 KiB
Markdown
# 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、下一步行动建议功能说明 |
|