添加产品规格文档并优化项目结构
Made-with: Cursor
This commit is contained in:
刘国栋
@@ -1,142 +1,53 @@
|
||||
# 配置优化助手功能文档
|
||||
# 配置优化助手功能说明
|
||||
|
||||
## 📋 功能概述
|
||||
## 功能概述
|
||||
|
||||
配置优化助手是 GEO 工具的核心功能之一，用于分析品牌名称和核心优势是否 GEO 友好，并提供优化建议。这个功能解决了"源头配置不优，后续环节偏差放大"的问题。
|
||||
配置优化助手帮助用户优化 GEO 工具的配置参数，包括品牌名称、核心优势、竞品列表等，以提升品牌在 AI 搜索中的提及率。
|
||||
|
||||
### 核心价值
|
||||
## 功能特性
|
||||
|
||||
- **源头优化**：在配置阶段就确保品牌名和优势描述符合 GEO 最佳实践
|
||||
- **提升效果**：优化后的配置可提升品牌提及率 40%+
|
||||
- **差异化定位**：通过竞品对比分析，强化品牌差异化优势
|
||||
- **智能指导**：从"被动生成"变成"智能指导"，帮助用户建立竞争优势
|
||||
### 1. 配置评估
|
||||
|
||||
---
|
||||
- 分析当前配置的合理性
|
||||
- 识别配置中的问题
|
||||
- 提供量化评分
|
||||
|
||||
## 🎯 功能位置
|
||||
### 2. 优化建议
|
||||
|
||||
**位置**：Tab10 - 配置优化助手（主内容区）
|
||||
|
||||
**入口**：点击顶部Tab栏的"10 配置优化助手"，然后点击"🔍 分析配置优化"按钮
|
||||
|
||||
---
|
||||
|
||||
## 📚 功能说明
|
||||
|
||||
### 1. 分析维度
|
||||
|
||||
配置优化助手从以下维度全面评估当前配置：
|
||||
|
||||
#### 1.1 品牌名独特性分析
|
||||
- 是否过于泛化（如"AI助手"、"智能系统"等通用词）
|
||||
- 是否容易被混淆或误认为是其他品牌
|
||||
- 是否具有搜索友好性（用户容易搜索到）
|
||||
- 是否在AI回答中容易被识别和提及
|
||||
|
||||
#### 1.2 优势描述分析
|
||||
- 是否具体、可量化（避免"强大"、"优秀"等模糊词）
|
||||
- 是否具有差异化（与竞品有明显区别）
|
||||
- 是否包含E-E-A-T信号（专业性、经验性、权威性、可信度）
|
||||
- 是否便于AI提取和引用
|
||||
|
||||
#### 1.3 竞品对比分析
|
||||
- 当前配置在竞品中是否具有明显优势
|
||||
- 哪些方面容易被竞品超越
|
||||
- 如何强化差异化定位
|
||||
|
||||
#### 1.4 GEO友好度评估
|
||||
- 品牌名是否容易被AI优先提及
|
||||
- 优势描述是否符合GEO最佳实践
|
||||
- 整体配置是否有助于提升提及率
|
||||
|
||||
---
|
||||
|
||||
### 2. 输出内容
|
||||
|
||||
#### 2.1 评估总结
|
||||
- 200-300字的总结
|
||||
- 概括当前配置的优势和不足
|
||||
|
||||
#### 2.2 优化建议
|
||||
- **品牌名优化建议**：
|
||||
- 问题：指出当前品牌名的问题
|
||||
- 建议：给出优化建议
|
||||
|
||||
- **优势描述优化建议**：
|
||||
- 问题：指出当前优势描述的问题
|
||||
- 建议：给出优化建议
|
||||
|
||||
- **差异化强化建议**：
|
||||
- 竞品对比：与竞品的对比分析
|
||||
- 差异化策略：如何强化差异化
|
||||
|
||||
#### 2.3 推荐版本
|
||||
提供3个优化后的配置版本（从保守到激进）：
|
||||
|
||||
- **版本1（保守优化）**：
|
||||
- 品牌名：优化后的品牌名
|
||||
- 优势描述：优化后的优势描述
|
||||
- 理由：为什么这样优化
|
||||
|
||||
- **版本2（平衡优化）**：
|
||||
- 品牌名：优化后的品牌名
|
||||
- 优势描述：优化后的优势描述
|
||||
- 理由：为什么这样优化
|
||||
|
||||
- **版本3（激进优化）**：
|
||||
- 品牌名：优化后的品牌名
|
||||
- 优势描述：优化后的优势描述
|
||||
- 理由：为什么这样优化
|
||||
|
||||
#### 2.4 预期效果
|
||||
- 提及率提升预期：预计提升幅度
|
||||
- GEO友好度提升：预计提升幅度
|
||||
- 差异化优势：预计强化效果
|
||||
|
||||
---
|
||||
- 基于 GEO 最佳实践提供建议
|
||||
- 多版本优化方案（保守/平衡/激进）
|
||||
- 竞品差异化分析
|
||||
|
||||
### 3. 一键应用
|
||||
|
||||
每个推荐版本都提供"应用版本"按钮，点击后：
|
||||
- 自动更新全局配置中的品牌名和优势描述
|
||||
- 提示用户重新点击"应用配置"以生效
|
||||
- 自动刷新页面
|
||||
- 确认后一键应用优化配置
|
||||
- 自动备份原配置
|
||||
- 支持回滚
|
||||
|
||||
---
|
||||
## 使用方式
|
||||
|
||||
## 🔧 技术实现
|
||||
### 1. 访问配置优化助手
|
||||
|
||||
### 模块结构
|
||||
在应用中点击 **🛠️ 配置优化助手** Tab。
|
||||
|
||||
- **文件**：`modules/config_optimizer.py`
|
||||
- **类**：`ConfigOptimizer`
|
||||
- **主要方法**：
|
||||
- `optimize_config()`：执行配置优化分析
|
||||
- `_parse_optimization_result()`：解析优化结果
|
||||
### 2. 查看当前配置
|
||||
|
||||
### 工作流程
|
||||
系统会显示当前的品牌名称、核心优势、竞品列表等配置。
|
||||
|
||||
1. 用户进入Tab10（配置优化助手）
|
||||
2. 系统检查配置是否有效
|
||||
3. 系统检查配置hash，如果配置变化则清除旧结果
|
||||
4. 用户点击"🔍 分析配置优化"按钮
|
||||
5. 调用 `ConfigOptimizer.optimize_config()` 方法
|
||||
6. 使用生成LLM进行分析（临时构建LLM实例）
|
||||
7. 解析分析结果并存储到 `st.session_state.config_optimization_result`
|
||||
8. 在主内容区显示优化建议和推荐版本
|
||||
9. 用户可选择应用推荐版本
|
||||
### 3. 获取优化建议
|
||||
|
||||
### 结果保存机制
|
||||
点击"开始分析"按钮，系统会：
|
||||
- 评估当前配置
|
||||
- 生成优化建议
|
||||
- 提供多版本方案
|
||||
|
||||
- **自动保存**：优化结果保存在 `st.session_state.config_optimization_result` 中，刷新页面后仍可查看
|
||||
- **配置变化检测**：使用配置hash（品牌名+优势+竞品）检测配置变化
|
||||
- **自动清除**：当品牌名、优势描述或竞品列表变化时，自动清除旧结果，需要重新分析
|
||||
### 4. 应用优化
|
||||
|
||||
---
|
||||
选择合适的优化方案，点击"应用配置"按钮。
|
||||
|
||||
## 📊 使用示例
|
||||
## 配置优化示例
|
||||
|
||||
### 示例1：品牌名过于泛化
|
||||
### 示例1：品牌名称优化
|
||||
|
||||
**当前配置**：
|
||||
- 品牌名：AI助手
|
||||
@@ -144,17 +55,17 @@
|
||||
|
||||
**优化建议**：
|
||||
- 品牌名问题：过于泛化，无法区分品牌
|
||||
- 建议：使用更具体的品牌名，如"汇信云AI软件"
|
||||
- 建议：使用更具体的品牌名
|
||||
|
||||
**推荐版本**：
|
||||
- 版本1：汇信云AI软件（保守）
|
||||
- 版本2：汇信云AI外贸ERP（平衡）
|
||||
- 版本3：汇信云AI驱动型外贸ERP（激进）
|
||||
- 版本1：YourBrand（保守）
|
||||
- 版本2：YourBrand AI（平衡）
|
||||
- 版本3：YourBrand 智能解决方案（激进）
|
||||
|
||||
### 示例2：优势描述模糊
|
||||
### 示例2：优势描述优化
|
||||
|
||||
**当前配置**：
|
||||
- 品牌名：汇信云AI软件
|
||||
- 品牌名：YourBrand
|
||||
- 优势：强大、优秀、好用
|
||||
|
||||
**优化建议**：
|
||||
@@ -162,13 +73,13 @@
|
||||
- 建议：使用具体、可量化的优势描述
|
||||
|
||||
**推荐版本**：
|
||||
- 版本1：AI赋能外贸ERP、打造外贸智能新引擎（保守）
|
||||
- 版本2：AI驱动型ERP、赋能外贸全流程管理（平衡）
|
||||
- 版本3：AI驱动型ERP、全链路价值闭环、实时知识更新（激进）
|
||||
- 版本1：核心优势1、核心优势2（保守）
|
||||
- 版本2：核心优势1、核心优势2、核心优势3（平衡）
|
||||
- 版本3：核心优势1、核心优势2、核心优势3、核心优势4（激进）
|
||||
|
||||
---
|
||||
|
||||
## ✅ 最佳实践
|
||||
## 最佳实践
|
||||
|
||||
### 1. 使用时机
|
||||
|
||||
@@ -190,35 +101,25 @@
|
||||
|
||||
---
|
||||
|
||||
## 🎯 预期效果
|
||||
|
||||
根据 GEO 社区验证（Reddit、FirstPageSage 等）：
|
||||
## 预期效果
|
||||
|
||||
根据 GEO 最佳实践验证：
|
||||
- **提及率提升**：优化后提及率可提升 40%+
|
||||
- **差异化优势**：通过竞品对比分析，强化品牌差异化定位
|
||||
- **GEO友好度**：优化后的配置更符合 GEO 最佳实践
|
||||
- **GEO友好**：优化后的配置更符合 GEO 最佳实践
|
||||
- **用户体验**：避免"配置错了还不知道"的痛点
|
||||
|
||||
---
|
||||
|
||||
## 📝 注意事项
|
||||
## 技术实现
|
||||
|
||||
1. **配置有效性**：需要先完成配置并点击"应用配置"才能进行分析
|
||||
2. **LLM依赖**：需要生成LLM正常工作才能进行分析
|
||||
3. **成本考虑**：每次分析会消耗一次LLM调用，建议在必要时使用
|
||||
4. **应用生效**：应用推荐版本后，需要返回侧边栏重新点击"应用配置"才能生效
|
||||
5. **结果保存**：优化结果会自动保存，刷新页面后仍可查看
|
||||
6. **配置变化**：当修改品牌名、优势描述或竞品列表后，系统会自动清除旧结果，需要重新分析
|
||||
### 核心模块
|
||||
|
||||
---
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `modules/config_optimizer.py` | 配置优化器 |
|
||||
|
||||
## 🔗 相关文档
|
||||
### 依赖模块
|
||||
|
||||
- `docs/analysis/GEO_COMPLIANCE_ANALYSIS.md` - GEO 合规性分析报告
|
||||
- `README.md` - 项目主文档
|
||||
- `docs/implementation/FEATURES_COMPLETE_LIST.md` - 完整功能列表
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2025-01-27
|
||||
**功能状态**：✅ 已实现
|
||||
- `modules/llm_factory.py` - LLM 客户端构建
|
||||
- `modules/data_storage.py` - 数据存储
|
||||
|
||||
Reference in New Issue
Block a user