- 💡 提示:ChatLab 支持多种聊天记录格式(.json、.jsonl、.txt),包括 QQ、微信、Discord - 等平台。将导出的文件直接拖拽到导入区域即可开始分析。 -
-- 📦 对于超大规模聊天记录(>100万条),建议使用 JSONL 格式,可避免内存溢出问题。 -
-
- ChatLab 定义了一套聊天记录分析用标准格式,支持两种文件格式。只需在文件中包含
-
- chatlab
-
- 对象即可被识别。
-
- 以下是 JSON 格式规范示例。JSONL 格式规范请参考
- .docs/guide/chatLabJsonlFormat.md
-
{
- "chatlab": {
- "version": "0.0.1", // 必填:格式版本号
- "exportedAt": 1732924800, // 必填:导出时间(秒级时间戳)
- "generator": "Your Tool Name", // 可选:生成工具名称
- "description": "自定义描述" // 可选:描述信息(自定义内容)
- },
- "meta": {
- "name": "群聊名称", // 必填:群名/对话名
- "platform": "qq", // 必填:qq | wechat | discord | mixed | unknown 等
- "type": "group", // 必填:group(群聊)| private(私聊)
- "groupId": "123456789", // 可选:群ID(仅群聊)
- "groupAvatar": "data:image/jpeg;base64,..." // 可选:群头像(Data URL)
- },
- "members": [
- {
- "platformId": "123456789", // 必填:用户唯一标识(QQ号/微信ID等)
- "accountName": "用户昵称", // 必填:账号名称
- "groupNickname": "群昵称", // 可选:群昵称(仅群聊)
- "avatar": "data:image/jpeg;base64,..." // 可选:用户头像(Data URL)
- }
- ],
- "messages": [
- {
- "sender": "123456789", // 必填:发送者 platformId
- "accountName": "发送时昵称", // 必填:发送时的账号名称
- "groupNickname": "发送时群昵称", // 可选:发送时的群昵称
- "timestamp": 1732924800, // 必填:秒级 Unix 时间戳
- "type": 0, // 必填:消息类型(见下方说明,0=文本)
- "content": "消息内容" // 必填:消息内容(null 表示非文本)
- }
- ]
-}
- 基础消息类型 (0-19)
-交互消息类型 (20-39)
-系统消息类型 (80+)
-
- 头像字段(
- avatar
- 、
- groupAvatar
- )使用 Data URL 格式:
-
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...
-
- 支持的 MIME 类型:
- image/jpeg
- 、
- image/png
- 、
- image/gif
- 、
- image/webp
-
建议导出时压缩处理,100*100像素即可满足需求
-chatlab.versionchatlab.exportedAtmeta.name / platform / type
-
- members[].platformId / accountName
-
- messages[] 所有基础字段chatlab.generator / description
- meta.groupId / groupAvatarmembers[].groupNickname / avatar
- messages[].groupNickname
- 💡 文件名以
- .json
- 或
- .jsonl
- 结尾,包含
- chatlab
- 对象即可被识别。
-
- 📖 JSON 格式规范:
- .docs/guide/chatLabFormat.md
-
- 📖 JSONL 格式规范:
- .docs/guide/chatLabJsonlFormat.md
-