diff --git a/README.md b/README.md index 06527770..064f58f7 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ English | [简体中文](./README.zh-CN.md) ChatLab is an open-source desktop app for understanding your social conversations. It combines a flexible SQL engine with AI agents so you can explore patterns, ask better questions, and extract insights from chat data, all on your own machine. -Currently supported: **WhatsApp, LINE, QQ, Discord, Instagram, Telegram, and iMessage**. Coming next: **Messenger and KakaoTalk**. +Currently supported: **WhatsApp, LINE, QQ, Discord, Instagram, Telegram, iMessage, and Google Chat**. Coming next: **Messenger and KakaoTalk**. > New install? Start here: [Getting started](https://docs.chatlab.fun/usage/quick-start) diff --git a/README.zh-CN.md b/README.zh-CN.md index ec5b5542..711b081b 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -14,7 +14,7 @@ ChatLab 是一个专注于聊天记录分析的本地化应用。通过 AI Agent和灵活的 SQL 引擎,你可以自由地分析你的聊天记录数据。 -目前已支持:**WhatsApp、LINE、QQ、Discord、Instagram、Telegram、iMessage**。即将支持:Messenger、KakaoTalk。 +目前已支持:**WhatsApp、LINE、QQ、Discord、Instagram、Telegram、iMessage、Google Chat**。即将支持:Messenger、KakaoTalk。 > 首次安装?从这里开始:[快速开始](https://docs.chatlab.fun/cn/usage/quick-start) diff --git a/docs/cn/usage/how-to-export.md b/docs/cn/usage/how-to-export.md index 2e4d83a4..b312765f 100644 --- a/docs/cn/usage/how-to-export.md +++ b/docs/cn/usage/how-to-export.md @@ -107,6 +107,21 @@ ChatLab 支持**旧版 QQ 原生导出的 txt 格式**(通过 QQ 消息管理 - **格式**:工具会按会话导出 ChatLab 标准 JSON 文件,将导出的 `.json` 文件拖入 ChatLab 即可。 - **提示**:该工具会读取 macOS 本机 Messages 数据库。使用前请仔细阅读项目文档,并确认您拥有读取与分析相关聊天记录的合法权限。 +## Google Chat + +对于 Google Chat,目前已适配 Google 官方 Takeout 导出的 ZIP 格式。 + +- **导出方式**: + 1. 打开 [Google Takeout](https://takeout.google.com/),用您的 Google 账号登录。 + 2. 点击「取消全选」,然后仅勾选 **Google Chat**(按需减小导出体积)。 + 3. 选择文件类型为 **.zip**(暂不支持 .tgz 格式)。 + 4. 点击「创建导出」,等待 Google 处理完成后下载。 +- **格式**:将下载的 `.zip` 文件直接拖入 ChatLab,ChatLab 会扫描压缩包内的所有会话并显示选择列表,勾选后逐个导入即可。 +- **提示**: + - 仅支持 ZIP 格式,如果 Takeout 提供的是 .tgz,请重新导出时选择 .zip。 + - 首次导出请求可能需要等待数小时,Google 会通过邮件通知下载就绪。 + - 附件(图片、文件等)目前不会随聊天记录一并导入。 + ## Q&A:小红书/企微/钉钉等的聊天记录能分析吗? ChatLab 的功能是 **对已导出的固定文本格式的聊天记录进行分析**,但前提是**您已经通过合法合规的渠道导出了聊天记录**。 diff --git a/docs/en/usage/how-to-export.md b/docs/en/usage/how-to-export.md index 4e662fd3..4186dae9 100644 --- a/docs/en/usage/how-to-export.md +++ b/docs/en/usage/how-to-export.md @@ -78,6 +78,21 @@ For Telegram, we currently support the official export feature provided by Teleg - **Format**: Import the main JSON file from the export folder (usually `result.json`) into ChatLab. - **Tip**: Telegram's official export entry is on desktop. For some accounts, the first export request may be delayed for security reasons and must be completed later on the same device. +## Google Chat + +For Google Chat, we currently support the ZIP archive exported by Google Takeout. + +- **Export Method**: + 1. Go to [Google Takeout](https://takeout.google.com/) and sign in with your Google account. + 2. Click "Deselect all", then check only **Google Chat** to reduce the export size. + 3. Select **.zip** as the file type (**.tgz is not currently supported**). + 4. Click "Create export" and wait for Google to process it — you'll receive an email when the download is ready. +- **Format**: Drag the downloaded `.zip` file directly into ChatLab. ChatLab will scan all conversations inside the archive and show a selection list. Check the conversations you want and import them one by one. +- **Tips**: + - Only ZIP format is supported. If Google Takeout offers .tgz, re-export and select .zip instead. + - The first export request may take several hours to process. + - Attachments (images, files, etc.) are not imported along with the chat history in the current version. + ## Q&A: Can I analyze chat records from other chat applications? For various chat analysis needs, here's a unified response: diff --git a/docs/tw/usage/how-to-export.md b/docs/tw/usage/how-to-export.md index 35bea7da..f1568a5d 100644 --- a/docs/tw/usage/how-to-export.md +++ b/docs/tw/usage/how-to-export.md @@ -65,6 +65,21 @@ Tips:歡迎訪問 [加入社群](https://chatlab.fun/tw/other/community),討 - **格式**:工具會按會話匯出 ChatLab 標準 JSON 檔案,將匯出的 `.json` 檔案拖入 ChatLab 即可。 - **提示**:該工具會讀取 macOS 本機 Messages 資料庫。使用前請仔細閱讀項目文件,並確認您擁有讀取與分析相關聊天記錄的合法權限。 +## Google Chat + +對於 Google Chat,目前已適配 Google 官方 Takeout 匯出的 ZIP 格式。 + +- **匯出方式**: + 1. 前往 [Google Takeout](https://takeout.google.com/),以您的 Google 帳號登入。 + 2. 點擊「取消全選」,再單獨勾選 **Google Chat**(可縮小匯出體積)。 + 3. 選擇檔案類型為 **.zip**(暫不支援 .tgz 格式)。 + 4. 點擊「建立匯出」,等待 Google 處理完成後下載(系統會寄送電子郵件通知)。 +- **格式**:將下載的 `.zip` 檔案直接拖入 ChatLab,ChatLab 會掃描壓縮包內所有對話並顯示選擇清單,勾選後逐一匯入即可。 +- **提示**: + - 僅支援 ZIP 格式,若 Takeout 提供的是 .tgz,請重新匯出時選擇 .zip。 + - 首次匯出請求可能需要等候數小時。 + - 附件(圖片、檔案等)目前不會隨聊天記錄一併匯入。 + ## Q&A:飛書/企微/千牛等的聊天記錄能分析嗎? 針對各種聊天分析的需求,統一回覆: