聊天数据接入
了解如何将聊天数据接入 Rethink AI
title: 聊天数据接入 description: 了解如何将聊天数据接入 Rethink AI category: chatlogIntegration order: 3
本文档详细介绍如何将您的聊天数据接入 Rethink AI 进行智能查询和分析。
数据接入方式
Rethink AI 支持两种方式访问聊天数据，均在本地完成，数据不会上传到任何服务器。
| 接入方式 | 适用场景 | 依赖 |
|---|---|---|
| 本地解密 | 本机已安装 IM 客户端 | 无额外依赖 |
| Docker 容器 | 需要隔离运行 IM 环境 | Docker Desktop |
本地解密方式 (推荐)
本地解密方式直接读取并解密您设备上的聊天数据库文件，无需额外安装 Docker。
工作原理
IM 客户端在本地存储了 SQLite 格式的加密数据库文件。Rethink AI 使用原生 C 实现的解密模块，在本地解密这些数据库，提取联系人、群聊和聊天记录数据。
配置步骤
- 确保 IM 客户端已在本机安装并登录
- 打开 Rethink AI 设置面板
- 找到 本地解密 配置区域
- 设置聊天数据库路径：
- macOS: 通常自动检测，位于 IM 客户端的应用数据目录中
- Windows: 通常位于用户文档目录下的 IM 数据文件夹中
- 点击 启动解密服务
- 等待解密完成
支持的数据类型
- 联系人: 用户名、昵称、备注名
- 群聊: 群名称、成员列表
- 聊天记录: 消息内容、时间戳、发送者
- 图片: 支持解密和查看聊天图片
Docker 容器方式
Docker 容器方式通过在隔离环境中运行 IM 客户端来获取数据。
前置条件
- 已安装 Docker Desktop
- 确保 Docker 服务正在运行
配置步骤
- 打开 Rethink AI 设置面板
- 找到 IM 运行时 配置区域
- 配置以下参数：
- Docker 镜像: 使用默认镜像或指定自定义镜像
- VNC 端口: 用于远程连接 IM 客户端界面 (默认 5900)
- 数据挂载路径: 容器内聊天数据的本地映射路径
- 点击 启动容器
- 通过 VNC 客户端连接并登录 IM
- 登录成功后，数据将自动同步到本地
环境检查
在启动容器前，应用会自动检查：
- Docker 服务是否运行
- 端口是否可用
- 镜像是否已下载
CDC 实时同步
CDC (Change Data Capture) 功能可以自动监测聊天数据库文件的变更，实时增量解密新消息。
启用 CDC
- 在设置中找到 CDC 同步 配置
- 开启 CDC 功能开关
- 配置监控目录 (通常为聊天数据库所在目录)
工作机制
- 事件驱动: 使用文件系统监听器检测数据库文件变更
- 定时轮询: 每 60 秒执行一次数据对账
- 增量解密: 仅处理变更部分，减少资源消耗
- 失败重试: 指数退避策略，最大间隔 10 分钟
数据存储
所有接入的聊天数据均存储在本地 SQLite 数据库中：
- 位置: 应用数据目录内
- 格式: SQLite 数据库文件
- 清理: 可随时手动删除数据库文件
常见问题
解密失败怎么办？
- 确认 IM 客户端正在运行且已登录
- 检查数据库文件路径是否正确
- 查看应用日志获取详细错误信息
- 确保客户端版本兼容
Docker 容器无法启动？
- 确认 Docker Desktop 已启动
- 检查所需端口 (如 VNC 端口) 是否被占用
- 尝试手动拉取 Docker 镜像
数据同步延迟？
启用 CDC 实时同步可以减少延迟。如未启用 CDC，您需要手动重启解密服务以获取最新数据。
支持多账号吗？
目前仅支持单个 IM 账号的数据访问。如需切换账号，请在 IM 客户端切换后重新启动解密服务。
下一步
数据接入完成后，请阅读 使用说明 了解如何通过 AI 对话查询和分析您的聊天数据。