79 lines
2.4 KiB
Markdown
79 lines
2.4 KiB
Markdown
|
# 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. **数据备份**：可以添加定期备份功能
|