刘国栋
8f7f082c3d
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
225 lines
6.9 KiB
Markdown
225 lines
6.9 KiB
Markdown
# 配置优化助手功能文档
|
||
|
||
## 📋 功能概述
|
||
|
||
配置优化助手是 GEO 工具的核心功能之一，用于分析品牌名称和核心优势是否 GEO 友好，并提供优化建议。这个功能解决了"源头配置不优，后续环节偏差放大"的问题。
|
||
|
||
### 核心价值
|
||
|
||
- **源头优化**：在配置阶段就确保品牌名和优势描述符合 GEO 最佳实践
|
||
- **提升效果**：优化后的配置可提升品牌提及率 40%+
|
||
- **差异化定位**：通过竞品对比分析，强化品牌差异化优势
|
||
- **智能指导**：从"被动生成"变成"智能指导"，帮助用户建立竞争优势
|
||
|
||
---
|
||
|
||
## 🎯 功能位置
|
||
|
||
**位置**：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友好度提升：预计提升幅度
|
||
- 差异化优势：预计强化效果
|
||
|
||
---
|
||
|
||
### 3. 一键应用
|
||
|
||
每个推荐版本都提供"应用版本"按钮，点击后：
|
||
- 自动更新全局配置中的品牌名和优势描述
|
||
- 提示用户重新点击"应用配置"以生效
|
||
- 自动刷新页面
|
||
|
||
---
|
||
|
||
## 🔧 技术实现
|
||
|
||
### 模块结构
|
||
|
||
- **文件**：`modules/config_optimizer.py`
|
||
- **类**：`ConfigOptimizer`
|
||
- **主要方法**：
|
||
- `optimize_config()`：执行配置优化分析
|
||
- `_parse_optimization_result()`：解析优化结果
|
||
|
||
### 工作流程
|
||
|
||
1. 用户进入Tab10（配置优化助手）
|
||
2. 系统检查配置是否有效
|
||
3. 系统检查配置hash，如果配置变化则清除旧结果
|
||
4. 用户点击"🔍 分析配置优化"按钮
|
||
5. 调用 `ConfigOptimizer.optimize_config()` 方法
|
||
6. 使用生成LLM进行分析（临时构建LLM实例）
|
||
7. 解析分析结果并存储到 `st.session_state.config_optimization_result`
|
||
8. 在主内容区显示优化建议和推荐版本
|
||
9. 用户可选择应用推荐版本
|
||
|
||
### 结果保存机制
|
||
|
||
- **自动保存**：优化结果保存在 `st.session_state.config_optimization_result` 中，刷新页面后仍可查看
|
||
- **配置变化检测**：使用配置hash（品牌名+优势+竞品）检测配置变化
|
||
- **自动清除**：当品牌名、优势描述或竞品列表变化时，自动清除旧结果，需要重新分析
|
||
|
||
---
|
||
|
||
## 📊 使用示例
|
||
|
||
### 示例1：品牌名过于泛化
|
||
|
||
**当前配置**：
|
||
- 品牌名：AI助手
|
||
- 优势：强大的AI能力
|
||
|
||
**优化建议**：
|
||
- 品牌名问题：过于泛化，无法区分品牌
|
||
- 建议：使用更具体的品牌名，如"汇信云AI软件"
|
||
|
||
**推荐版本**：
|
||
- 版本1：汇信云AI软件（保守）
|
||
- 版本2：汇信云AI外贸ERP（平衡）
|
||
- 版本3：汇信云AI驱动型外贸ERP（激进）
|
||
|
||
### 示例2：优势描述模糊
|
||
|
||
**当前配置**：
|
||
- 品牌名：汇信云AI软件
|
||
- 优势：强大、优秀、好用
|
||
|
||
**优化建议**：
|
||
- 优势描述问题：过于模糊，缺乏具体性
|
||
- 建议：使用具体、可量化的优势描述
|
||
|
||
**推荐版本**：
|
||
- 版本1：AI赋能外贸ERP、打造外贸智能新引擎（保守）
|
||
- 版本2：AI驱动型ERP、赋能外贸全流程管理（平衡）
|
||
- 版本3：AI驱动型ERP、全链路价值闭环、实时知识更新（激进）
|
||
|
||
---
|
||
|
||
## ✅ 最佳实践
|
||
|
||
### 1. 使用时机
|
||
|
||
- **首次配置**：在开始使用工具前，先进行配置优化
|
||
- **效果不佳时**：如果品牌提及率较低，重新优化配置
|
||
- **竞品变化时**：当竞品发生变化时，重新评估配置
|
||
|
||
### 2. 优化策略
|
||
|
||
- **保守优化**：适合已有一定品牌认知的情况
|
||
- **平衡优化**：适合大多数情况，推荐使用
|
||
- **激进优化**：适合新品牌或需要快速建立认知的情况
|
||
|
||
### 3. 应用建议
|
||
|
||
- 优化后建议重新运行关键词蒸馏和内容创作
|
||
- 对比优化前后的验证结果，评估优化效果
|
||
- 根据实际效果调整配置
|
||
|
||
---
|
||
|
||
## 🎯 预期效果
|
||
|
||
根据 GEO 社区验证（Reddit、FirstPageSage 等）：
|
||
|
||
- **提及率提升**：优化后提及率可提升 40%+
|
||
- **差异化优势**：通过竞品对比分析，强化品牌差异化定位
|
||
- **GEO友好度**：优化后的配置更符合 GEO 最佳实践
|
||
- **用户体验**：避免"配置错了还不知道"的痛点
|
||
|
||
---
|
||
|
||
## 📝 注意事项
|
||
|
||
1. **配置有效性**：需要先完成配置并点击"应用配置"才能进行分析
|
||
2. **LLM依赖**：需要生成LLM正常工作才能进行分析
|
||
3. **成本考虑**：每次分析会消耗一次LLM调用，建议在必要时使用
|
||
4. **应用生效**：应用推荐版本后，需要返回侧边栏重新点击"应用配置"才能生效
|
||
5. **结果保存**：优化结果会自动保存，刷新页面后仍可查看
|
||
6. **配置变化**：当修改品牌名、优势描述或竞品列表后，系统会自动清除旧结果，需要重新分析
|
||
|
||
---
|
||
|
||
## 🔗 相关文档
|
||
|
||
- `docs/analysis/GEO_COMPLIANCE_ANALYSIS.md` - GEO 合规性分析报告
|
||
- `README.md` - 项目主文档
|
||
- `docs/implementation/FEATURES_COMPLETE_LIST.md` - 完整功能列表
|
||
|
||
---
|
||
|
||
**最后更新**：2025-01-27
|
||
**功能状态**：✅ 已实现
|