LifeTrace

简体中文

English

简体中文

English

主题

LifeTrace 安装流程 ​

系统要求 ​

在安装 LifeTrace 之前，请确保你的系统满足以下要求：

操作系统 ​

  • Windows 10/11
  • macOS 10.14+
  • Linux (Ubuntu 18.04+ 或其他主流发行版)

软件依赖 ​

  • Python 3.13+
  • pip 包管理器
  • Git (用于克隆仓库)

硬件要求 ​

  • 内存：建议 4GB 以上
  • 硬盘：至少 10GB 可用空间（用于存储截图和数据库）
  • 处理器：支持多核处理器
  • 可选：CUDA 支持（用于 GPU 加速）

安装步骤 ​

1. 克隆项目仓库 ​

首先，从 GitHub 克隆 LifeTrace 项目：

bash
git clone https://github.com/tangyuanbo1/LifeTrace_app.git
cd LifeTrace_app

2. 创建虚拟环境 ​

为了避免依赖冲突，建议创建 Python 虚拟环境：

bash
# Windows
python -m venv venv
venv\Scripts\activate

# macOS/Linux
python3 -m venv venv
source venv/bin/activate

3. 安装依赖包 ​

所有依赖文件位于 requirements/ 目录下。根据您的操作系统安装相应的依赖：

对于 Windows：

bash
pip install -r requirements/requirements_windows.txt

对于 macOS：

bash
pip install -r requirements/requirements_macos.txt

主要依赖包括：

  • FastAPI - Web 框架
  • RapidOCR - OCR 识别引擎
  • ChromaDB - 向量数据库
  • Pillow - 图像处理
  • mss - 截屏工具
  • 多模态模型 - 用于高级搜索功能

4. 配置环境变量 ​

配置文件位于 config/ 目录下。LifeTrace 使用 YAML 格式配置：

bash
config/
├── config.yaml              # 用户配置
└── default_config.yaml      # 默认配置

编辑 config/config.yaml 配置必要的参数：

yaml
screenshot:
  interval: 60              # 截屏间隔（秒）
  quality: 85               # 图片质量（1-100）
  save_path: ./screenshots  # 存储路径

ocr:
  engine: rapidocr          # OCR 引擎
  language: ch_en           # 语言（ch, en, ch_en）

database:
  chromadb_path: ./chromadb # 向量数据库路径

api:
  port: 8840                # API 端口

5. 初始化数据库 ​

运行初始化脚本，创建数据库和必要的目录：

bash
python init_database.py

6. 启动服务 ​

LifeTrace 提供多种启动服务的方式：

启动所有服务（推荐）：

bash
python start_all_services.py

仅启动 Web 服务：

bash
python -m lifetrace_backend.server --port 8840

启动单个服务：

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

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

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

服务启动后，你应该能看到类似以下的输出：

 * Running on http://127.0.0.1:8840
 * LifeTrace service started successfully

7. 验证安装 ​

访问 API 健康检查端点：

bash
curl http://localhost:8840/health

如果返回以下 JSON，说明安装成功：

json
{
  "status": "healthy",
  "version": "1.0.0"
}

常见安装问题 ​

依赖安装失败 ​

如果遇到依赖安装问题，尝试使用国内镜像源：

bash
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

OCR 引擎问题 ​

如果 RapidOCR 安装失败，可以手动安装：

bash
pip install rapidocr-onnxruntime

ChromaDB 问题 ​

确保 ChromaDB 版本兼容：

bash
pip install chromadb==0.4.0

下一步 ​

安装完成后，请查看 使用方法 了解如何使用 LifeTrace。