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