ChatLab

ChatLab是一款完全免费开源的本地化聊天记录分析工具，支持多平台聊天数据格式的统一适配与导入处理，结合结构化查询与模型辅助分析能力，完成聊天数据的多维度统计与深度解析。工具全程采用本地计算模式运行，分析过程无需依赖云端服务，在大幅提升数据处理效率的同时，全方位保障用户的聊天数据隐私安全。

ChatLab支持活跃趋势、时间分布、成员统计等多种可视化分析结果的直观展示，同时提供可扩展的工具调用能力，进一步优化数据处理与分析全流程。依托多线程与流式处理机制，系统可以轻松应对大规模聊天数据分析场景，适配个人数据整理、社交行为复盘等多种使用需求。

软件特色

1、极致性能

采用流式计算搭配多线程并行架构，即便是百万条量级的海量聊天记录，也能保持流畅的交互体验与快速响应速度。

2、保护隐私

所有聊天记录与配置文件都存储在用户本地数据库中，全流程分析运算都在本地设备完成，仅AI相关功能需联网调用外部服务。

3、智能 AI Agent

集成十余种Function Calling工具，支持动态调度运行，能深度挖掘聊天记录里更多容易被忽略的细节与趣味内容。

4、多维数据可视化

提供活跃度趋势、时间规律分布、成员互动排行等多个维度的直观分析图表，数据结果一目了然。

5、格式标准化

依托强大的数据抽象层，抹平不同聊天软件之间的格式差异，几乎所有主流平台导出的聊天记录都能完成统一分析。

ChatLab使用指南

一、导出聊天记录

ChatLab核心定位是已导出数据的分析工具，本身不提供聊天记录抓取功能。

你需要先通过官方导出通道，或是开源社区的第三方合规工具，把对应平台的聊天记录完整导出后，再导入ChatLab开展后续分析。

二、导入聊天记录

完成聊天记录导出操作后，直接在ChatLab的首页操作即可：

1、把提前导出好的数据文件直接拖拽到页面指定的上传区域。

2、等待系统自动完成文件解析，就能进入后续的数据分析环节。

三、如何配置 AI 模型

这里以deepseek模型为例演示操作，其他大模型的配置逻辑可以自行搜索对应教程完成：

1、打开Deepseek官方网站，进入API开放平台板块，完成账号注册与登录操作。

2、点击左侧菜单栏的充值选项，按需充值对应金额，建议首次充值10元，日常使用足够支撑很长时间。

3、进入左侧的API Keys页面，点击创建新的API key，自定义填写一个标识标题后，生成并复制对应的API Key内容。

4、打开ChatLab软件，点击右下角的设置按钮，依次进入「模型配置」>「添加新配置」页面，把刚才复制的API Key粘贴到对应输入框中，点击验证确认连接正常后，点击右下角的添加按钮，就能正常使用所有AI相关功能。

5、在Deepseek平台左侧的用量信息页面，你可以随时查看账户的充值余额与消费明细。

常见问题 FAQ

导入失败

症状：拖拽文件上传后，页面弹出解析失败提示

排查步骤：

确认上传文件的格式是否在支持范围内，仅支持.json / .jsonl / .txt三类格式

检查文件是否存在损坏情况，可以用常规文本编辑器打开查看内容完整性

查看软件日志文件中标记为[Parser]的相关错误记录，定位具体问题点

AI 功能无响应

症状：在AI实验室板块发送消息后，长时间没有收到任何回复

排查步骤：

确认是否已经在设置页面完成了API Key的配置，路径为设置 > AI 设置

点击配置页的「验证」按钮，确认当前API的网络连接状态正常

查看软件日志文件中标记为[LLM]或[Agent]的相关错误记录

常见原因：

填写的API Key无效，或是对应账户余额不足

API服务商触发了访问限流规则

数据库错误

症状：打开历史分析会话时，页面弹出系统错误提示

排查步骤：

查看软件日志文件中标记为[Database]的相关错误记录

检查本地存储的数据库文件是否正常存在，没有被误删或损坏

更新日志

v0.30.0版本

新增面向Agent的独立使用入口，同步优化了聊天记录筛选、导出、头像导入与多端同步的全流程使用体验。