Skip to content

About

A local desktop reader for Claude export archives.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ClaudeReader

ClaudeReader 是一个面向 Claude 官方导出档案的本地桌面阅读器。它在本机导入 Claude 导出 ZIP,建立 IndexedDB 索引,并以适合长对话阅读的方式展示消息、分支、思考过程、工具调用、附件和时间节点。

它不是 AI 聊天应用,不调用模型,不需要 API,也不会把聊天记录上传到服务器。

下载与使用

Windows 用户可以在 GitHub Releases 下载:

ClaudeReader-v0.1.0-windows-x64-portable.zip
  1. 下载 ZIP 后完整解压到一个普通文件夹。
  2. 双击 ClaudeReader.exe。
  3. 首次打开时选择 Claude 官方导出的 ZIP 数据包,不需要提前解压。
  4. 等待本地解析和索引完成,然后开始阅读。

这是免安装目录版。ClaudeReader.exe 必须和同目录下的 resources、locales、DLL 等文件一起使用,不能只把 EXE 单独复制出去。

Windows 可能因为应用尚未购买代码签名证书而显示 SmartScreen 提示。确认文件来自本项目的 GitHub Releases 后,可点击“更多信息”再选择“仍要运行”。

数据与隐私

  • Claude 导出 ZIP 只在本机读取和解压。
  • 对话索引保存在 Electron 的本地 IndexedDB 中。
  • 应用不会上传聊天记录,也不会把导入数据写回原始 ZIP。
  • 免安装指程序无需安装;本地索引仍会保存在 Windows 当前用户的应用数据目录中。
  • 清空应用数据或更换电脑后,需要重新导入 Claude 导出 ZIP。

主要功能

  • 导入 Claude 官方导出 ZIP
  • 会话搜索、排序、收藏和阅读位置恢复
  • 长对话连续滚动和右侧时间轨道定位
  • 按消息树恢复 Claude 对话分支并切换分支
  • thinking、tool use、tool result 折叠阅读
  • Markdown、GFM 表格、数学公式和代码块
  • 附件与 Claude 生成文件阅读
  • 完整档案和精简档案导出
  • 米白、暖黄、深色及其他阅读主题
  • 数据完全本地处理

当前限制

  • 仅提供 Windows x64 便携版。
  • 未购买 Windows 代码签名证书,因此首次运行可能出现 SmartScreen 提示。
  • Claude 导出数据不能可靠恢复会话与 Project 的归属关系,应用不会猜测或伪造这种关系。
  • 某些只有文件引用、没有实际内容的附件无法在离线状态下还原。
  • 应用读取的是导出时的数据快照,不会与 Claude 网站实时同步。

从源码运行

需要 Node.js LTS。克隆仓库后运行:

npm.cmd install
npm.cmd run dev

启动 Electron 桌面窗口:

npm.cmd run build
npm.cmd run desktop

生成 Windows 免安装目录版:

npm.cmd run build
npm.cmd run desktop:portable

成品位于 release/ClaudeReader-win-x64/。

开发验证

npm.cmd test
npm.cmd run typecheck
npm.cmd run build

安全约定

仓库不会包含 data/raw/、original/ 或任何用户导出的 Claude 对话数据。请勿在 Issue、截图或日志中上传自己的完整对话档案。

许可证

源码采用 MIT License 发布。

版本

当前首个公开测试版:v0.1.0。

About

A local desktop reader for Claude export archives.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages