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

- 重构项目目录结构,将功能模块移至 modules/ 目录
- 创建平台同步基础架构,包括发布器基类和 GitHub 发布器
- 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态
- 更新依赖配置,添加平台同步所需依赖 (httpx, pyperclip)
- 整理文档结构,将所有文档分类移至 docs/ 目录
- 添加 .cursorrules 文件定义项目开发规范
- 清理根目录重复文件,保持项目结构整洁
This commit is contained in:
刘国栋
2026-01-30 10:21:29 +08:00
parent 77d5ec70f8
commit 8f7f082c3d
102 changed files with 33742 additions and 1526 deletions
+78
View File
@@ -0,0 +1,78 @@
# SQLite 持久化集成说明
## ✅ 已完成的功能
### 1. 数据自动保存
-**关键词生成**:自动保存到数据库
-**内容生成**:每生成一篇文章自动保存
-**文章优化**:优化记录自动保存
-**验证结果**:验证结果自动保存
### 2. 历史记录查看(新增 Tab5)
- ✅ 统计数据总览(关键词、文章、优化、验证数量)
- ✅ 历史文章列表和详情查看
- ✅ 历史优化记录和详情查看
- ✅ 历史验证结果和可视化
## 📁 数据库文件
- **位置**`geo_data.db`(项目根目录)
- **格式**SQLite 单文件数据库
- **已添加到**`.gitignore`(不会提交到版本控制)
## 🚀 使用方法
### 正常使用
所有数据会自动保存,无需额外操作。只需正常使用各个功能模块即可。
### 查看历史记录
1. 点击 **"5 历史记录"** Tab
2. 查看统计数据
3. 浏览历史文章、优化记录、验证结果
4. 点击选择框查看详情
## 🔧 技术细节
### 错误处理
- 所有数据库操作都包含 try-except 错误处理
- 即使数据库保存失败,也不会影响主要功能
- 会显示警告提示,但不会中断流程
### 数据存储结构
- **keywords 表**:关键词列表
- **articles 表**:生成的文章内容
- **optimizations 表**:优化记录
- **verify_results 表**:验证结果
## 📊 性能
- SQLite 是轻量级数据库,性能优秀
- 单文件存储,易于备份和迁移
- 支持复杂查询和统计分析
## 🔄 数据迁移
如果需要迁移数据:
1. 复制 `geo_data.db` 文件即可
2. 或使用 SQLite 工具导出/导入
## ⚠️ 注意事项
1. **首次运行**:会自动创建数据库文件
2. **数据持久化**:关闭应用后数据不会丢失
3. **多品牌支持**:数据按品牌分类存储
4. **清空功能**:侧边栏的"重置全部结果"只清空 Session State**不会删除数据库记录**
## 🐛 故障排除
如果遇到数据库相关错误:
1. 检查是否有写入权限
2. 检查 `geo_data.db` 文件是否被其他程序占用
3. 可以删除 `geo_data.db` 文件重新创建(会丢失所有历史数据)
## 📝 后续扩展建议
1. **数据导出**:可以添加导出功能,将数据导出为 CSV/Excel
2. **数据搜索**:可以添加搜索功能,按关键词搜索历史记录
3. **数据统计**:可以添加更详细的统计分析
4. **数据备份**:可以添加定期备份功能