LifeTrace

简体中文

English

简体中文

English

主题

LifeTrace 常见问题 ​

安装相关 ​

Q: 安装依赖时出现错误怎么办？ ​

A: 尝试以下解决方案：

  1. 使用国内镜像源：
bash
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  1. 升级 pip：
bash
pip install --upgrade pip
  1. 分别安装关键依赖：
bash
pip install rapidocr-onnxruntime
pip install chromadb
pip install flask

Q: RapidOCR 安装失败怎么办？ ​

A: RapidOCR 可能需要特定版本：

bash
# 卸载现有版本
pip uninstall rapidocr-onnxruntime

# 安装指定版本
pip install rapidocr-onnxruntime==1.3.0

在 macOS 上，可能需要安装 Xcode 命令行工具：

bash
xcode-select --install

Q: ChromaDB 初始化失败？ ​

A: 确保有足够的磁盘空间，并检查权限：

bash
# 创建数据目录
mkdir -p ./chromadb

# 检查权限
chmod -R 755 ./chromadb

# 重新初始化
python init_db.py

使用相关 ​

Q: 截屏服务没有自动启动？ ​

A: 检查以下几点：

  1. 确认服务是否正在运行：
bash
ps aux | grep screenshot_service
  1. 查看日志文件：
bash
tail -f logs/screenshot.log
  1. 手动启动服务：
bash
python screenshot_service.py --debug

Q: OCR 识别不准确怎么办？ ​

A: 可以尝试以下优化：

  1. 调整图片质量：
yaml
screenshot:
  quality: 95  # 提高质量（1-100）
  1. 更换 OCR 语言模型：
yaml
ocr:
  language: ch_en  # 中英文混合
  1. 启用后处理：
yaml
ocr:
  post_process: true

Q: 搜索结果不准确？ ​

A: 优化搜索配置：

  1. 调整相似度阈值：
yaml
search:
  similarity_threshold: 0.6  # 降低阈值（0-1）
  1. 增加返回结果数：
bash
curl -X POST http://localhost:5000/api/search \
  -d '{"query": "关键词", "limit": 50}'
  1. 使用语义搜索代替关键词搜索

Q: 存储空间占用太大怎么办？ ​

A: 优化存储策略：

  1. 降低图片质量：
yaml
screenshot:
  quality: 70
  1. 增加截屏间隔：
yaml
screenshot:
  interval: 300  # 5分钟
  1. 定期清理旧数据：
bash
lifetrace cleanup --before 2025-09-01
  1. 启用图片压缩：
yaml
screenshot:
  compress: true

性能相关 ​

Q: LifeTrace 占用 CPU 太高？ ​

A: 优化性能：

  1. 调整截屏间隔，减少频率
  2. 关闭实时 OCR，改为批量处理：
yaml
ocr:
  realtime: false
  batch_size: 10
  1. 限制 OCR 线程数：
yaml
ocr:
  max_threads: 2

Q: 数据库查询速度慢？ ​

A: 优化数据库：

  1. 重建索引：
bash
python manage.py rebuild-index
  1. 清理旧数据
  2. 增加内存缓存：
yaml
database:
  cache_size: 1024  # MB

Q: 前端界面卡顿？ ​

A: 前端优化：

  1. 减少单页显示数量
  2. 启用虚拟滚动
  3. 优化图片加载（懒加载）

隐私安全 ​

Q: 如何避免截取敏感信息？ ​

A: 设置应用黑名单：

yaml
screenshot:
  blacklist:
    - "1Password"
    - "Bitwarden"
    - "Banking App"
    - "Private Browser"

或者设置区域排除：

yaml
screenshot:
  exclude_regions:
    - x: 0
      y: 0
      width: 100
      height: 100

Q: 数据是否会上传到云端？ ​

A: LifeTrace 是完全本地运行的应用，所有数据都存储在本地，不会上传到任何云服务器。你的数据完全由你掌控。

Q: 如何加密存储数据？ ​

A: 启用数据加密：

yaml
security:
  encryption: true
  encryption_key: "your-secret-key"

或使用全盘加密（如 BitLocker、FileVault）。

功能相关 ​

Q: 支持多显示器吗？ ​

A: 是的，LifeTrace 支持多显示器：

yaml
screenshot:
  multi_monitor: true
  # 指定显示器（可选）
  monitors: [0, 1]  # 截取第1和第2个显示器

Q: 可以导出数据吗？ ​

A: 可以，支持多种格式：

bash
# JSON 格式
lifetrace export --format json --output data.json

# CSV 格式
lifetrace export --format csv --output data.csv

# 包含图片的打包导出
lifetrace export --format archive --output backup.zip

Q: 支持云同步吗？ ​

A: 当前版本不直接支持云同步，但你可以：

  1. 使用云盘同步数据目录
  2. 使用 rsync 定期备份
  3. 自行搭建同步服务

Q: 可以在多台设备上使用吗？ ​

A: 可以，但需要分别部署。如果需要数据共享：

  1. 使用共享存储
  2. 搭建中心化服务器
  3. 使用数据导出/导入功能

错误处理 ​

Q: 出现 "Port already in use" 错误？ ​

A: 端口被占用：

bash
# 查找占用端口的进程
lsof -i :5000

# 杀死进程
kill -9 <PID>

# 或者更换端口
python app.py --port 5001

Q: 出现 "Permission denied" 错误？ ​

A: 权限问题：

bash
# 检查文件权限
ls -la

# 修改权限
chmod -R 755 .

# 使用 sudo（谨慎）
sudo python app.py

Q: OCR 返回乱码？ ​

A: 编码问题：

  1. 检查系统编码：
bash
locale
  1. 设置正确的编码：
bash
export LANG=zh_CN.UTF-8
  1. 在配置文件中指定：
yaml
ocr:
  encoding: utf-8

开发相关 ​

Q: 如何贡献代码？ ​

A: 欢迎贡献！

  1. Fork 项目仓库
  2. 创建特性分支
  3. 提交代码
  4. 发起 Pull Request

详见 贡献指南

Q: 如何开发自定义插件？ ​

A: LifeTrace 支持插件系统：

python
# my_plugin.py
from lifetrace.plugin import Plugin

class MyPlugin(Plugin):
    def on_screenshot(self, screenshot):
        # 自定义处理
        pass

注册插件：

yaml
plugins:
  - path: ./plugins/my_plugin.py
    enabled: true

Q: API 文档在哪里？ ​

A: 启动服务后访问：

http://localhost:5000/api/docs

或查看 在线 API 文档

社区支持 ​

Q: 遇到问题如何获取帮助？ ​

A: 多种途径：

  1. 查看 GitHub Issues
  2. 提交新的 Issue
  3. 加入讨论社区
  4. 查看在线文档

Q: 如何报告 Bug？ ​

A: 在 GitHub 上提交 Issue，请包含：

  1. 详细的问题描述
  2. 复现步骤
  3. 系统环境信息
  4. 相关日志和错误信息
  5. 截图（如适用）

Q: 有计划添加新功能吗？ ​

A: 欢迎查看 路线图，或提交功能建议。

还有其他问题？ ​

如果以上内容没有解决你的问题，请：