feat: 重构项目结构并添加平台同步基础架构

- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
2026-01-30 10:21:29 +08:00
parent 77d5ec70f8
commit 8f7f082c3d
102 changed files with 33742 additions and 1526 deletions
@@ -0,0 +1,213 @@
+# 事实密度 + 结构化块功能说明
+
+## 📋 功能概述
+
+事实密度 + 结构化块增强模块是 GEO 工具的核心功能之一，用于提升内容的事实信息密度和结构化程度，从而提升内容在 AI 模型中的引用率和可读性。
+
+### 核心价值
+
+- **事实密度**：量化内容中的事实性信息，确保信息丰富、有数据支撑
+- **结构化块**：自动检测和优化内容的结构化元素，提升可读性和可引用性
+- **智能优化**：自动添加缺失的事实信息和结构化块，保持内容原意
+
+## 🎯 功能位置
+
+### 1. 内容生成模块（Tab2）
+
+在内容生成后，可以：
+
+1. **📊 评估事实密度**：评估生成内容的事实密度和结构化程度
+   - 显示事实密度得分（0-50分）
+   - 显示结构化得分（0-50分）
+   - 提供详细的事实分析和结构化分析
+
+2. **✨ 强化事实密度**：自动优化内容以提升事实密度和结构化
+   - 添加数据信息、案例信息、标准信息等
+   - 添加标题层级、清单列表、FAQ等结构化块
+
+### 2. 文章优化模块（Tab3）
+
+在文章优化后，可以：
+
+1. **📊 评估事实密度**：评估优化后文章的事实密度和结构化程度
+2. **✨ 强化事实密度**：对优化后的文章进行事实密度和结构化强化
+
+## 📊 评估维度
+
+### 事实密度（50分）
+
+评估内容中包含的事实性信息：
+
+1. **数据信息**（10分）
+   - 具体数字、百分比、统计数据
+   - 示例："80%的用户"、"2024年数据显示"
+
+2. **案例信息**（10分）
+   - 具体案例、实例、应用场景
+   - 示例："某企业案例"、"实际应用表明"
+
+3. **标准信息**（8分）
+   - 行业标准、规范、要求
+   - 示例："ISO标准"、"行业规范"
+
+4. **对比信息**（8分）
+   - 对比数据、差异说明
+   - 示例："相比传统方案提升30%"
+
+5. **时间信息**（7分）
+   - 时间节点、时效性
+   - 示例："2024年"、"最新版本"
+
+6. **来源信息**（7分）
+   - 数据来源、案例来源
+   - 示例："根据XX报告"、"参考XX研究"
+
+### 结构化块（50分）
+
+评估内容的结构化元素：
+
+1. **标题层级**（7分）
+   - 是否有清晰的标题层级（H1/H2/H3）
+
+2. **结论摘要**（7分）
+   - 是否有开头的结论摘要（80-120字）
+
+3. **清单列表**（7分）
+   - 是否有清单、列表、要点（- 或 1. 格式）
+
+4. **FAQ部分**（7分）
+   - 是否有常见问题解答
+
+5. **代码块**（6分）
+   - 技术内容是否有代码示例（如适用）
+
+6. **对比表格**（6分）
+   - 是否有对比表格或对比列表
+
+7. **步骤说明**（5分）
+   - 是否有步骤、流程说明
+
+8. **总结部分**（5分）
+   - 是否有结尾总结
+
+## 🔄 强化功能
+
+### 事实密度强化
+
+系统会自动添加以下类型的事实信息：
+
+1. **数据信息**
+   - 在合适位置添加数据占位
+   - 示例："根据XX数据显示，约XX%的企业"
+
+2. **案例信息**
+   - 添加实际案例或应用场景（用占位符）
+   - 示例："某企业案例表明"
+
+3. **标准信息**
+   - 提及相关标准或规范
+   - 示例："按照XX标准"、"参考XX规范"
+
+4. **对比信息**
+   - 添加对比数据或差异说明
+   - 示例："相比传统方案，提升约XX%"
+
+5. **时间信息**
+   - 明确时间节点或时效性
+   - 示例："2024年最新"、"当前版本"
+
+6. **来源信息**
+   - 标注数据来源
+   - 示例："根据XX行业报告"、"参考XX研究"
+
+### 结构化块强化
+
+系统会自动添加以下结构化元素：
+
+1. **标题层级**：确保有清晰的标题层级（H1/H2/H3）
+2. **结论摘要**：在开头添加结论摘要（80-120字）
+3. **清单列表**：将要点整理为清单格式
+4. **FAQ部分**：至少3-5个常见问题解答
+5. **代码块**：技术内容添加代码示例（如适用）
+6. **对比表格**：如有多个选项，用表格或列表对比
+7. **步骤说明**：如有流程，用步骤格式说明
+8. **总结部分**：在结尾添加总结部分
+
+## 🔄 工作流程
+
+### 推荐工作流程
+
+1. **生成或优化内容**
+   - 在 Tab2 生成内容，或在 Tab3 优化现有文章
+
+2. **评估事实密度**
+   - 点击"📊 评估事实密度"按钮
+   - 查看事实密度和结构化得分
+   - 查看详细的事实分析和结构化分析
+
+3. **强化事实密度**（如需要）
+   - 如果评估分数较低（<75分），点击"✨ 强化事实密度"
+   - 系统会自动添加事实信息和结构化块
+   - 查看强化详情
+
+4. **验证效果**
+   - 在 Tab4 进行多模型验证
+   - 查看品牌提及率是否提升
+
+## 📊 评分标准
+
+### 总分（100分）
+
+- **事实密度**（50分）：评估内容中的事实性信息
+- **结构化**（50分）：评估内容的结构化元素
+
+### 评分等级
+
+- **90-100分**：优秀（绿色）
+- **75-89分**：良好（蓝色）
+- **60-74分**：中等（橙色）
+- **0-59分**：需改进（红色）
+
+## 💡 使用建议
+
+1. **优先评估**：在强化前先评估，了解当前水平
+2. **针对性强化**：根据评估结果，重点关注低分维度
+3. **事实信息**：确保至少添加数据信息、案例信息、来源信息
+4. **结构化块**：确保至少包含标题层级、结论摘要、清单列表、FAQ
+5. **保持原意**：强化不会改变内容的核心信息和原意
+
+## ⚠️ 注意事项
+
+1. **不编造数据**：所有事实信息使用占位符，不要编造具体数据
+2. **保持原意**：事实密度强化不会改变内容的核心信息和原意
+3. **平台适配**：不同平台对结构化块的要求可能不同
+4. **验证效果**：强化后建议在 Tab4 进行验证，确认效果
+
+## 🔗 相关功能
+
+- **E-E-A-T 强化**：在 Tab2 和 Tab3 中提供
+- **内容质量评分**：在 Tab2 内容生成后自动进行
+- **多模型验证**：在 Tab4 验证品牌提及率
+- **历史记录**：在 Tab5 查看历史优化记录
+
+## 🎯 最佳实践
+
+1. **分阶段优化**：
+   - 首先生成或优化内容
+   - 然后评估事实密度和结构化
+   - 最后根据评估结果进行强化
+
+2. **质量优先**：
+   - 关注事实密度分析中的各类信息数量
+   - 确保各类事实信息都有一定数量
+   - 确保结构化块完整
+
+3. **验证优化**：
+   - 使用强化后的内容生成内容
+   - 在 Tab4 验证提及率
+   - 根据验证结果调整策略
+
+---
+
+**版本**：v1.0  
+**更新日期**：2025-01-26