LifeTrace 使用方法

快速开始

启动服务

启动后端服务

首次设置:首次运行时,如果 config.yaml 不存在,系统会自动从 default_config.yaml 复制创建。您可以通过编辑 lifetrace/config/config.yaml 来自定义设置。

启动服务器:

python -m lifetrace.server

自定义提示词:如果您想修改不同功能的 AI 提示词,可以编辑 lifetrace/config/prompts/ 目录下的 YAML 文件。

启动前端服务

前端是使用 LifeTrace 的必需组件。启动前端开发服务器:

cd frontend
pnpm install
pnpm dev

前端开发服务器将在 http://localhost:3000 启动,API 请求会自动代理到后端的 8000 端口。

开始使用

两个服务启动后,在浏览器中访问 http://localhost:3000 开始使用 LifeTrace! 🎉

项目结构

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

LIfeTrace/
├── 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:3000

主要功能：

🔍 搜索框

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

📅 时间筛选

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

🖼️ 结果展示

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

📊 统计仪表板

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

配置选项

截屏设置

编辑 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

最佳实践

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 - 增强用户界面
• 🔧 代码 - 实现新功能和改进

开发指南

• 重要：参考.github/目录下的guidelines文件，了解代码规范和提交流程。
• 遵循现有代码风格
• 编写清晰的提交信息
• 为新功能添加测试
• 根据需要更新文档
• 保持 Pull Request 专注且简洁

下一步

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