刘国栋
8f7f082c3d
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
140 lines
4.2 KiB
Markdown
140 lines
4.2 KiB
Markdown
# 快速重组项目目录结构
|
||
|
||
## ⚡ 快速执行步骤
|
||
|
||
### 步骤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` - 完整的优化方案
|