feat: 重构项目结构并添加平台同步基础架构
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
This commit is contained in:
刘国栋
@@ -0,0 +1,224 @@
|
||||
# 配置优化助手功能文档
|
||||
|
||||
## 📋 功能概述
|
||||
|
||||
配置优化助手是 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
|
||||
**功能状态**：✅ 已实现
|
||||
Reference in New Issue
Block a user