LifeTrace 使用方法

快速开始

启动服务

安装完成后，可以通过多种方式启动 LifeTrace 服务：

启动所有服务（推荐）：

python start_all_services.py

这将启动：

• 截屏录制服务
• OCR 处理器服务
• Web API 服务
• 向量数据库服务

启动单个服务：

# 启动录制器
python -m lifetrace_backend.recorder

# 启动处理器
python -m lifetrace_backend.processor

# 启动 OCR 服务
python -m lifetrace_backend.simple_ocr

# 启动 Web 服务器
python -m lifetrace_backend.server --port 8840

服务启动后会：

• 按照配置的间隔自动截屏
• 对截图进行 OCR 文字识别
• 将数据存储到向量数据库
• 提供 REST API 用于搜索和检索

项目结构

了解项目结构有助于定制和开发：

LifeTrace_app/
├── lifetrace_backend/          # 核心后端模块
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py               # Web API 服务
│   ├── models.py               # 数据模型
│   ├── config.py               # 配置管理
│   ├── storage.py              # 存储管理
│   ├── simple_ocr.py           # OCR 处理
│   ├── vector_service.py       # 向量服务
│   ├── multimodal_*.py         # 多模态服务
│   ├── processor.py            # 文件处理
│   ├── recorder.py             # 屏幕录制
│   ├── heartbeat.py            # 服务心跳
│   ├── rag_service.py          # RAG 服务
│   ├── retrieval_service.py    # 检索服务
│   ├── sync_service.py         # 同步服务
│   ├── utils.py                # 工具函数
│   └── templates/              # HTML 模板
├── config/                     # 配置文件
│   ├── config.yaml
│   └── default_config.yaml
├── doc/                        # 文档
├── front/                      # 前端应用
│   ├── components/             # React 组件
│   ├── services/               # API 服务
│   ├── public/                 # 静态资源
│   └── package.json            # 前端依赖
├── debug/                      # 调试和诊断工具
├── requirements/               # 依赖文件
│   ├── requirements.txt
│   ├── requirements_windows.txt
│   ├── requirements_macos.txt
│   ├── requirements_multimodal.txt
│   ├── requirements_rapidocr.txt
│   └── requirements_vector.txt
├── assets/                     # 静态资源
├── start_all_services.py       # 主服务启动器
├── init_database.py            # 数据库初始化
└── init_config.py              # 配置初始化

前端使用

搜索界面

LifeTrace 提供了 Web 前端界面，可以通过浏览器访问：

http://localhost:8840

主要功能：

🔍 搜索框

• 输入关键词或自然语言查询
• 支持高级搜索语法
• 实时搜索建议

📅 时间筛选

• 选择日期范围
• 快速选择（今天、昨天、本周、本月）
• 自定义时间段

🖼️ 结果展示

• 缩略图预览
• 文字内容高亮
• 时间戳显示
• 点击放大查看

📊 统计仪表板

• 使用时长统计
• 活动类型分布
• 热力图展示

配置选项

截屏设置

编辑 config.yaml 文件：

screenshot:
  # 截屏间隔（秒）
  interval: 60
  # 图片质量（1-100）
  quality: 85
  # 是否启用智能截屏（检测屏幕变化）
  smart_capture: true
  # 存储路径
  save_path: ./screenshots

OCR 设置

ocr:
  # OCR 引擎（rapidocr）
  engine: rapidocr
  # 语言（ch, en, ch_en）
  language: ch_en
  # 是否启用文本后处理
  post_process: true

搜索设置

search:
  # 默认返回结果数
  default_limit: 10
  # 最大返回结果数
  max_limit: 100
  # 相似度阈值（0-1）
  similarity_threshold: 0.7

命令行工具

LifeTrace 提供了命令行工具 lifetrace-cli：

# 搜索
lifetrace search "Python 教程"

# 查看统计
lifetrace stats

# 导出数据
lifetrace export --format json --output data.json

# 清理数据
lifetrace cleanup --before 2025-09-01

最佳实践

1. 性能优化

• 根据需求调整截屏间隔
• 定期清理旧数据
• 使用 SSD 存储以提高性能

2. 隐私保护

• 设置敏感应用黑名单，避免截取私密内容
• 定期备份数据
• 考虑加密存储

3. 存储管理

• 定期检查存储空间
• 设置自动清理策略
• 使用数据压缩

参与贡献

我们欢迎社区的贡献！以下是您可以参与的方式：

如何贡献

1. 🍴 Fork 项目 - 创建您自己的仓库副本
2. 🌿 创建功能分支 - git checkout -b feature/amazing-feature
3. 💾 提交您的更改 - git commit -m 'Add some amazing feature'
4. 📤 推送到分支 - git push origin feature/amazing-feature
5. 🔄 创建 Pull Request - 提交您的更改以供审查

可以贡献的领域

• 🐛 错误报告 - 帮助我们识别和修复问题
• 💡 功能建议 - 建议新功能
• 📝 文档 - 改进指南和教程
• 🧪 测试 - 编写测试并提高覆盖率
• 🎨 UI/UX - 增强用户界面
• 🔧 代码 - 实现新功能和改进

开发指南

• 遵循现有代码风格
• 编写清晰的提交信息
• 为新功能添加测试
• 根据需要更新文档
• 保持 Pull Request 专注且简洁

下一步

• 查看 常见问题 了解更多技巧
• 访问 GitHub 仓库 参与开发
• 加入社区讨论和反馈
• 探索 使用场景 获取灵感