ChatAtlas Local

ChatAtlas Local

在自己的电脑上搜索 ChatGPT 和 Claude 聊天记录。
向 Claude 询问这些记录。所有数据都留在你的设备上。

你已经和 AI 助手进行了数百次对话。那些有用的回答、做出的决定和未完成的计划散落在 ChatGPT 和 Claude 中，而它们自带的搜索功能几乎帮不上忙。

ChatAtlas Local 会读取它们提供的数据导出文件，并将所有聊天记录保存在你电脑上的一个文件中。之后你可以：

• 一次搜索所有内容，无论是在终端还是浏览器中。
• 向 Claude 询问相关内容：“ChatGPT 之前对我的酸面团发酵剂说了什么？”或者“找到我计划花坛的那次聊天。”Claude Desktop、Claude Code、Cursor、VS Code 等工具可以通过 MCP 读取你的存档。
• 永久保存记录，以纯 Markdown 文件或备份的形式保存，不受应用变化的影响。

无需账户或服务端，也没有遥测。它绝不会连接互联网。

开始使用

你需要 Node.js 22.16 或更高版本（或 24）。然后：

npm install -g chatatlas-local

_{在 npm 首次发布之前，可直接从 GitHub 安装：npm install -g github:hnt504/chatatlas-local}

1. 申请导出文件

• **ChatGPT：**设置 → 数据控制 → 导出数据。你会收到一封包含 .zip 链接的电子邮件。
• **Claude：**设置 → 隐私 → 导出数据。流程相同：收到电子邮件，然后下载 .zip。

2. 导入数据

chatatlas-local import ~/Downloads/<your ChatGPT export>.zip ~/Downloads/<your Claude export>.zip

✓ 6720ab…-2026-10-21.zip: ChatGPT, 1,284 chats (1,284 new)
✓ data-2026-10-21.zip: Claude, 412 chats (412 new)

每当你拿到更新的导出文件，都可以再次导入：新聊天会被加入，变更的聊天会被更新，不会产生重复项。也可以让它自动完成（参见导出文件夹）。

3. 浏览记录

chatatlas-local search sourdough starter
chatatlas-local open            # the browser view in the screenshot above

连接 Claude（及其他工具）

Claude Desktop

你可以从最新版本下载 chatatlas-local-<version>.mcpb，然后用 Claude Desktop 打开它（它会询问导出文件的位置，无需使用终端）；也可以在安装好命令后运行：

chatatlas-local setup claude-desktop --write

完全退出 Claude Desktop 后重新打开。然后问它类似这样的问题：“搜索我以前的聊天记录，找到厨房翻新预算。”

**关于红色警告。**打开扩展时，Claude Desktop 会提示安装它“将授予此扩展访问你电脑上所有内容的权限”。从文件安装而非 Anthropic 目录安装的每个扩展都会收到此提示，因为扩展是以你的身份运行的程序。这个扩展实际会做的是：读取你的导出文件和自己的存档文件，不连接互联网，并向 Claude 提供只读工具。所有代码都在这里，可以供你检查。

Claude Code

将它作为插件安装（包括 MCP 工具，以及一个用于教 Claude 何时查看这里的技能）：

/plugin install chatatlas-local --marketplace hnt504/chatatlas-local

或者，在安装好命令后运行：

chatatlas-local setup claude-code --write   # the MCP tools, for every project
chatatlas-local skill                       # teaches Claude Code when to look here

Cursor、VS Code、Windsurf、Gemini CLI、Codex

chatatlas-local setup                 # shows each app's settings, and whether it's connected
chatatlas-local setup cursor --write  # or vscode, windsurf, gemini-cli, codex

--write 会在修改应用的旧设置文件之前，先在其旁边保存一份副本。

ChatGPT 呢？

ChatGPT 无法访问你电脑上的文件，因此无法在这里读取你的存档。你仍然可以导入 ChatGPT 导出文件，并通过 Claude、终端或浏览器界面搜索记录。

助手可以做什么

所有操作均为只读。助手可以查找和阅读你的聊天记录，但不能修改、添加标签或删除任何内容。

工具	功能
search_chats	查找包含你查询的所有词语的聊天记录，并引用最匹配的消息
list_chats	按平台、日期、标题中的词语或标签浏览
read_chat	逐条阅读对话消息（较长的对话每次显示一页）
recent_topics	按周查看你在一段时间内聊过的话题
archive_overview	查看归档中的内容及其涵盖的时间范围

导出文件夹

将 ChatAtlas Local 指向一个文件夹（例如“下载”文件夹），你保存到其中的任何 ChatGPT 或 Claude 导出文件都会自动导入。其他文件不会受到影响，每个文件只会读取一次。

chatatlas-local watch ~/Downloads                              # until you press Ctrl+C
chatatlas-local setup claude-desktop --inbox ~/Downloads --write  # whenever Claude Desktop is open

安装 Claude Desktop 扩展时，它会询问这个文件夹。

命令

命令
import <file...>	ChatGPT 或 Claude 导出文件（.zip 文件、其中的 conversations.json 或解压后的文件夹），或 ChatAtlas 备份
search <words...>	查找包含所有词语的聊天记录。每个词也能匹配以其开头的较长词语（“plan”可匹配“planning”）；不区分变音符号
list	按时间从新到旧排列
show <id>	阅读一段聊天记录。使用 --md 输出 Markdown，使用 --json 输出数据。提供 id 的开头部分即可
topics	查看你最近聊过的话题（--days 90）
stats	按平台统计聊天记录、按月统计聊天记录，以及查看你的标签
open	打开浏览器视图。可使用 --read-only、--port 8765、--no-browser
tag <id> <tag...>	为聊天记录添加标签（使用 --remove 移除标签）
forget <id...>	将聊天记录从归档中移除
export <folder>	将每段聊天记录导出为 Markdown 文件，或使用 --format chatatlas 导出为一个备份文件
watch <folder>	导入保存到该文件夹中的导出文件，并持续监视
setup [app] [--write]	连接助手
skill	安装 Claude Code skill
doctor	检查 Node、归档、搜索索引和所有已连接的应用
where	查看归档文件的位置

search、list、export 和 topics 的筛选条件：--platform chatgpt、--tag work、 --since 2025-03、--until 2026、--title garden、--limit 50、--offset 50、--json。

隐私政策

ChatAtlas Local 是一款在你的电脑上运行的程序。它没有服务器，也不需要账户。

• **收集哪些信息：**不收集任何信息。它没有分析、遥测或崩溃报告功能，也绝不会建立网络连接。
• **存储什么以及存储位置：**存储你导入的导出文件中的聊天记录，以及你添加的标签，保存在电脑上的一个 SQLite 文件中：~/.chatatlas-local/chatatlas.db（chatatlas-local where 会显示确切位置）。可使用 --db <file> 或 CHATATLAS_LOCAL_DB 设置来指定其他文件。它会读取你的导出文件，但不会修改或删除这些文件。
• **共享：**ChatAtlas Local 不会与任何人共享信息，包括其作者。如果你连接了 AI 助手（Claude Desktop、Claude Code、Cursor 等），在你提出要求时，该助手可以通过只读工具搜索和阅读你的归档；它读取的内容会成为你与该助手对话的一部分，并受该助手自身隐私政策约束。
• **浏览器视图：**仅监听 127.0.0.1，只响应发给它的请求，且每个请求都需要一个随机密钥，只有它打开的标签页知道该密钥。
• **保留时长：**除非你删除，否则会一直保留。chatatlas-local forget <id> 会移除一段聊天记录；删除 ~/.chatatlas-local 文件夹会移除所有内容。你的 ChatGPT 和 Claude 账户不会受到任何影响。
• **安装：**npm（对于 Claude Desktop 扩展，则是 GitHub）会根据各自的条款提供下载；安装后，不会有任何内容通过网络传输。
• **联系：**如有疑问，请通过 GitHub issues 联系；可能会泄露他人聊天记录的问题，请私下通过 安全公告 联系。

ChatAtlas Local 和 ChatAtlas Pro

ChatAtlas Local 免费且开源，并将一直保持如此。 ChatAtlas Pro 是托管版本，适合需要更多功能的用户：

	Local	Pro
ChatGPT 和 Claude 导出文件	✓	✓
按关键词搜索	✓	✓
Claude Desktop、Claude Code、Cursor 等	✓	✓
数据保存在自己的电脑上	✓	保存在自己的账户中
Gemini、Grok、Perplexity、DeepSeek 等	通过 ChatAtlas 备份	✓
按含义搜索		✓
网页版 ChatGPT 和 claude.ai		✓
文件夹、项目、任意设备		✓

它们使用相同的备份格式：chatatlas-local export <folder> --format chatatlas 会生成一个 ChatAtlas Pro 可导入的文件；ChatAtlas 备份也可以用相同方式导入 ChatAtlas Local。

常见问题

需要哪个 Node 版本？ 22.16 或更高版本，或者 24 及以上版本（23 不行），因为 ChatAtlas Local 使用 Node 内置的 SQLite 数据库。运行 chatatlas-local doctor 可进行检查。

我昨天的聊天记录不见了。 存档只包含你导入的导出文件中的内容。 重新导出并导入（或将文件放进导出文件夹）即可。

它能读取 Gemini 或其他应用的导出文件吗？ 目前还不能直接读取。ChatAtlas 备份可以包含来自任何平台的 聊天记录，也欢迎通过拉取请求添加对更多导出格式的支持。

它会占用多大空间？ 大约与导出文件的文本大小相当。一个包含 3,000 条聊天记录、大小为 60 MB 的导出文件， 导入约需两秒，搜索耗时远不到十分之一秒。

参与贡献

欢迎提交 Bug 报告和拉取请求。请参阅 CONTRIBUTING.md。

许可证

MIT。由 Heather Turner 制作，她也开发了 ChatAtlas。