feat: 重构项目结构并添加平台同步基础架构
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
This commit is contained in:
刘国栋
@@ -0,0 +1,185 @@
|
||||
# 手动清理指南
|
||||
|
||||
## ⚠️ 当前状态
|
||||
|
||||
由于文件被占用（可能被IDE或其他程序打开），自动脚本无法执行删除/移动操作。
|
||||
|
||||
## 📋 需要手动完成的操作
|
||||
|
||||
### 步骤1：关闭所有打开的文件
|
||||
|
||||
**重要**：在执行清理前，请：
|
||||
1. 关闭所有IDE和编辑器
|
||||
2. 关闭可能占用文件的程序
|
||||
3. 确保没有Python进程在运行
|
||||
|
||||
### 步骤2：清理重复模块文件（19个）
|
||||
|
||||
这些文件在根目录和 `modules/` 目录都存在，**删除根目录版本**：
|
||||
|
||||
**需要删除的文件**：
|
||||
1. `config_optimizer.py`
|
||||
2. `content_metrics.py`
|
||||
3. `content_scorer.py`
|
||||
4. `data_storage.py`
|
||||
5. `eeat_enhancer.py`
|
||||
6. `fact_density_enhancer.py`
|
||||
7. `keyword_mining.py`
|
||||
8. `keyword_tool.py`
|
||||
9. `multimodal_prompt.py`
|
||||
10. `negative_monitor.py`
|
||||
11. `optimization_techniques.py`
|
||||
12. `resource_recommender.py`
|
||||
13. `roi_analyzer.py`
|
||||
14. `schema_generator.py`
|
||||
15. `semantic_expander.py`
|
||||
16. `storage_example.py`
|
||||
17. `technical_config_generator.py`
|
||||
18. `topic_cluster.py`
|
||||
19. `workflow_automation.py`
|
||||
|
||||
**验证**：删除前确认 `modules/` 目录中有对应文件
|
||||
|
||||
### 步骤3：整理优化相关文件（可选）
|
||||
|
||||
**移动到 `docs/guides/` 的文档**：
|
||||
- `ADVANCED_OPTIMIZATION_PLAN.md`
|
||||
- `FINAL_OPTIMIZATION_GUIDE.md`
|
||||
- `REFERENCE_UPDATE_SUMMARY.md`
|
||||
- `OPTIMIZATION_STATUS.md`
|
||||
|
||||
**移动到 `scripts/` 的脚本**：
|
||||
- `cleanup_duplicate_modules.py`
|
||||
- `move_scripts.py`
|
||||
- `update_script_references.py`
|
||||
- `cleanup_optimization_files.py`
|
||||
|
||||
## 🚀 快速执行（PowerShell）
|
||||
|
||||
### 方法1：使用脚本（推荐）
|
||||
|
||||
关闭所有文件后，运行：
|
||||
|
||||
```powershell
|
||||
# 清理重复模块
|
||||
python cleanup_duplicate_modules.py
|
||||
# 输入 yes
|
||||
|
||||
# 整理优化文件
|
||||
python cleanup_optimization_files.py
|
||||
```
|
||||
|
||||
### 方法2：手动删除/移动
|
||||
|
||||
```powershell
|
||||
# 删除重复模块文件
|
||||
$modules = @(
|
||||
"config_optimizer.py", "content_metrics.py", "content_scorer.py",
|
||||
"data_storage.py", "eeat_enhancer.py", "fact_density_enhancer.py",
|
||||
"keyword_mining.py", "keyword_tool.py", "multimodal_prompt.py",
|
||||
"negative_monitor.py", "optimization_techniques.py", "resource_recommender.py",
|
||||
"roi_analyzer.py", "schema_generator.py", "semantic_expander.py",
|
||||
"storage_example.py", "technical_config_generator.py", "topic_cluster.py",
|
||||
"workflow_automation.py"
|
||||
)
|
||||
|
||||
foreach ($file in $modules) {
|
||||
if (Test-Path $file) {
|
||||
Remove-Item $file -Force
|
||||
Write-Host "✓ 已删除: $file"
|
||||
}
|
||||
}
|
||||
|
||||
# 移动优化文档
|
||||
$docs = @(
|
||||
"ADVANCED_OPTIMIZATION_PLAN.md",
|
||||
"FINAL_OPTIMIZATION_GUIDE.md",
|
||||
"REFERENCE_UPDATE_SUMMARY.md",
|
||||
"OPTIMIZATION_STATUS.md"
|
||||
)
|
||||
|
||||
foreach ($doc in $docs) {
|
||||
if (Test-Path $doc) {
|
||||
Move-Item $doc -Destination "docs\guides\" -Force
|
||||
Write-Host "✓ 已移动: $doc"
|
||||
}
|
||||
}
|
||||
|
||||
# 移动优化脚本
|
||||
$scripts = @(
|
||||
"cleanup_duplicate_modules.py",
|
||||
"move_scripts.py",
|
||||
"update_script_references.py",
|
||||
"cleanup_optimization_files.py"
|
||||
)
|
||||
|
||||
foreach ($script in $scripts) {
|
||||
if (Test-Path $script) {
|
||||
Move-Item $script -Destination "scripts\" -Force
|
||||
Write-Host "✓ 已移动: $script"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## ✅ 验证清单
|
||||
|
||||
清理完成后，请验证：
|
||||
|
||||
- [ ] 根目录只有5个核心文件：
|
||||
- README.md
|
||||
- DOCS.md
|
||||
- geo_tool.py
|
||||
- requirements.txt
|
||||
- .gitignore
|
||||
- [ ] 所有模块文件在 `modules/` 目录中
|
||||
- [ ] 所有工具脚本在 `scripts/` 目录中
|
||||
- [ ] 所有文档在 `docs/` 子目录中
|
||||
- [ ] 测试导入：`python -c "from modules.data_storage import DataStorage"`
|
||||
- [ ] 测试主程序：`streamlit run geo_tool.py`
|
||||
|
||||
## 🎯 优化后的最终结构
|
||||
|
||||
```
|
||||
geo_tool/
|
||||
├── README.md # ✅ 项目主文档
|
||||
├── DOCS.md # ✅ 文档索引
|
||||
├── geo_tool.py # ✅ 主程序
|
||||
├── requirements.txt # ✅ 依赖文件
|
||||
├── .gitignore # ✅ Git配置
|
||||
│
|
||||
├── modules/ # ✅ 功能模块（19个文件）
|
||||
├── platform_sync/ # ✅ 平台同步模块
|
||||
├── scripts/ # ✅ 工具脚本（9个文件）
|
||||
└── docs/ # ✅ 文档目录
|
||||
├── features/ # 功能文档（15个）
|
||||
├── analysis/ # 分析报告（7个）
|
||||
├── guides/ # 指南文档（13个）
|
||||
└── implementation/ # 实现文档（7个）
|
||||
```
|
||||
|
||||
## 📊 优化效果
|
||||
|
||||
- **根目录文件**：从 50+ 个减少到 5 个（减少 90%）
|
||||
- **文档分类**：34个文档按类型分类存放
|
||||
- **模块组织**：19个模块集中在 `modules/` 目录
|
||||
- **脚本整理**：9个工具脚本集中在 `scripts/` 目录
|
||||
|
||||
## 🆘 遇到问题？
|
||||
|
||||
### 问题1：文件仍被占用
|
||||
**解决方案**：
|
||||
1. 检查是否有Python进程：`tasklist | findstr python`
|
||||
2. 关闭所有IDE和编辑器
|
||||
3. 重启计算机后再试
|
||||
|
||||
### 问题2：删除后程序无法运行
|
||||
**解决方案**：
|
||||
1. 从Git恢复：`git checkout HEAD -- filename.py`
|
||||
2. 检查 `modules/` 目录：确认文件存在
|
||||
3. 检查导入路径：确认使用 `modules.xxx` 格式
|
||||
|
||||
### 问题3：不确定是否安全删除
|
||||
**解决方案**：
|
||||
1. 先备份：`git add . && git commit -m "备份：清理前"`
|
||||
2. 再删除：如有问题可回滚
|
||||
3. 验证：删除后立即测试程序
|
||||
Reference in New Issue
Block a user