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,139 @@
+# 快速重组项目目录结构
+
+## ⚡ 快速执行步骤
+
+### 步骤1：关闭所有打开的文件
+**重要**：在移动文件之前，请关闭所有在IDE或编辑器中打开的文件，否则会出现"文件被占用"的错误。
+
+### 步骤2：执行文件移动
+
+#### 方法A：使用PowerShell脚本（推荐）
+
+在项目根目录打开PowerShell，执行：
+
+```powershell
+# 移动功能模块
+$modules = @(
+    "data_storage.py", "keyword_tool.py", "content_scorer.py", "eeat_enhancer.py",
+    "semantic_expander.py", "fact_density_enhancer.py", "schema_generator.py",
+    "topic_cluster.py", "multimodal_prompt.py", "roi_analyzer.py",
+    "workflow_automation.py", "keyword_mining.py", "optimization_techniques.py",
+    "content_metrics.py", "technical_config_generator.py", "negative_monitor.py",
+    "resource_recommender.py", "config_optimizer.py", "storage_example.py"
+)
+foreach ($file in $modules) {
+    if (Test-Path $file) {
+        Move-Item $file -Destination "modules\" -Force -ErrorAction SilentlyContinue
+        Write-Host "✓ $file"
+    }
+}
+
+# 移动功能文档
+Get-ChildItem -Filter "*_FEATURE.md" | ForEach-Object {
+    Move-Item $_.FullName -Destination "docs\features\" -Force -ErrorAction SilentlyContinue
+    Write-Host "✓ $($_.Name)"
+}
+
+# 移动分析报告
+$analysis = @(
+    "ANALYSIS_ACCURACY_REPORT.md", "CODE_DOCUMENTATION_ANALYSIS.md",
+    "DOCUMENTATION_REVERSE_VERIFICATION.md", "FEATURE_ANALYSIS.md",
+    "FEATURE_PRIORITY_ANALYSIS.md", "FUNCTION_VERIFICATION_REPORT.md",
+    "GEO_COMPLIANCE_ANALYSIS.md"
+)
+foreach ($file in $analysis) {
+    if (Test-Path $file) {
+        Move-Item $file -Destination "docs\analysis\" -Force -ErrorAction SilentlyContinue
+        Write-Host "✓ $file"
+    }
+}
+
+# 移动指南文档
+$guides = @(
+    "QUICK_START_GUIDE.md", "STORAGE_GUIDE.md", "PLATFORM_SETUP.md",
+    "LAYOUT_UPGRADE_GUIDE.md", "DECISION_GUIDE.md"
+)
+foreach ($file in $guides) {
+    if (Test-Path $file) {
+        Move-Item $file -Destination "docs\guides\" -Force -ErrorAction SilentlyContinue
+        Write-Host "✓ $file"
+    }
+}
+
+# 移动实现文档
+$implementation = @(
+    "IMPLEMENTATION_SUMMARY.md", "PLATFORM_SYNC_ANALYSIS.md",
+    "PLATFORM_SYNC_IMPLEMENTATION.md", "PLATFORM_SYNC_TEST.md",
+    "INTEGRATION_NOTES.md", "FEATURES_COMPLETE_LIST.md", "ADVANCED_FEATURES.md"
+)
+foreach ($file in $implementation) {
+    if (Test-Path $file) {
+        Move-Item $file -Destination "docs\implementation\" -Force -ErrorAction SilentlyContinue
+        Write-Host "✓ $file"
+    }
+}
+
+Write-Host "`n✅ 文件移动完成！"
+```
+
+#### 方法B：手动移动（如果脚本失败）
+
+如果PowerShell脚本因为文件被占用而失败，请：
+
+1. 关闭所有IDE和编辑器
+2. 手动将文件拖拽到对应目录
+3. 参考 `PROJECT_STRUCTURE_ANALYSIS.md` 中的文件清单
+
+### 步骤3：更新导入路径
+
+```powershell
+python scripts/update_imports.py
+```
+
+### 步骤4：更新文档引用
+
+```powershell
+python scripts/update_doc_references.py
+```
+
+### 步骤5：验证
+
+```powershell
+# 测试导入是否正常
+python -c "from modules.data_storage import DataStorage; print('✓ 导入成功')"
+```
+
+## 📋 完整执行清单
+
+- [ ] 关闭所有打开的文件（IDE、编辑器等）
+- [ ] 执行文件移动（PowerShell脚本或手动）
+- [ ] 运行 `python scripts/update_imports.py`
+- [ ] 运行 `python scripts/update_doc_references.py`
+- [ ] 测试导入：`python -c "from modules.data_storage import DataStorage"`
+- [ ] 运行主程序：`streamlit run geo_tool.py`
+- [ ] 检查文档链接是否正常
+
+## 🆘 遇到问题？
+
+### 问题1：文件被占用
+**解决方案**：
+1. 关闭所有IDE和编辑器
+2. 检查是否有Python进程在运行：`tasklist | findstr python`
+3. 如果仍有问题，重启计算机后再试
+
+### 问题2：导入错误
+**解决方案**：
+1. 确认文件已移动到 `modules/` 目录
+2. 确认 `modules/__init__.py` 存在
+3. 检查 `geo_tool.py` 中的导入路径是否正确
+
+### 问题3：文档链接失效
+**解决方案**：
+1. 运行 `python scripts/update_doc_references.py`
+2. 手动检查 `README.md` 中的链接
+3. 使用相对路径而不是绝对路径
+
+## 📚 相关文档
+
+- `PROJECT_STRUCTURE_ANALYSIS.md` - 详细的项目结构分析
+- `docs/DIRECTORY_STRUCTURE_OPTIMIZATION.md` - 完整的优化方案