导入向导

将你的 AI 编程对话导入 Mantra，开始时光旅行。

概述

导入向导帮助你将 AI 编程工具中的对话记录导入到 Mantra，让你可以回顾、搜索和分析这些对话。

导入向导功能

自动检测项目：Mantra 会自动扫描你电脑上的 AI 工具项目
增量导入：只导入新增的对话，避免重复
数据完整性：完整保留对话的上下文和代码片段
批量操作：支持一次导入多个项目

支持的 AI 工具

工具	版本要求	日志格式	支持状态
Claude Code	1.0.0+	JSONL	✅ 完全支持
Gemini CLI	0.20.0+	JSON	✅ 完全支持
Cursor	0.40.0+	SQLite	✅ 完全支持
Codex	1.0.0+	JSONL	✅ 完全支持
Antigravity	-	-	🔜 即将支持

提示

Claude Code 是最常用的导入来源，大多数用户从这里开始。

通用导入流程

所有工具的导入流程基本一致：

打开导入向导 - 点击 Mantra 顶部的「导入」按钮
选择 AI 工具 - 从列表中选择你要导入的工具类型
选择项目 - 在检测到的项目列表中选择要导入的项目
等待完成 - 导入过程通常只需几秒钟

Claude Code 导入

关于 Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程 CLI 工具，提供强大的代码辅助功能。它将对话记录存储在本地项目目录中。

版本要求

最低支持版本：1.0.0
推荐版本：最新稳定版

版本检查

运行 claude --version 查看你的 Claude Code 版本。

日志文件位置

Claude Code 将对话记录存储在以下位置：

macOSWindowsLinux

bash

~/.claude/projects/

bash

%USERPROFILE%\.claude\projects\

bash

~/.claude/projects/

目录结构示例：

~/.claude/projects/
├── my-project-1/
│   ├── conversations/
│   │   ├── 2025-01-15_session1.jsonl
│   │   └── 2025-01-16_session2.jsonl
│   └── settings.json
└── my-project-2/
    └── conversations/
        └── 2025-01-17_session1.jsonl

导入步骤

打开 Mantra，点击顶部的导入按钮

选择 Claude Code 作为导入来源

等待项目扫描，Mantra 会自动检测你的 Claude Code 项目
选择要导入的项目，可以选择一个或多个

点击导入，等待导入完成

常见问题

项目没有出现在列表中？

可能原因：

项目路径不在默认位置 - Claude Code 可能使用了非默认路径
- 解决方案：在设置中添加自定义扫描路径
项目没有对话记录 - 新项目可能还没有产生对话
- 解决方案：先在 Claude Code 中进行一次对话，然后重新扫描
权限问题 - Mantra 可能没有读取该目录的权限
- 解决方案：检查目录权限设置

导入后对话显示不完整？

可能原因：

对话文件损坏 - JSONL 文件可能存在格式问题
- 解决方案：尝试重新导入，或检查原始文件
版本兼容问题 - 旧版本 Claude Code 的格式可能略有不同
- 解决方案：升级 Claude Code 到最新版本后重新使用

导入速度很慢？

优化建议：

检查项目中的对话数量，大型项目可能需要更长时间
确保磁盘读取速度正常
关闭其他占用磁盘的程序

Gemini CLI 导入

关于 Gemini CLI

Gemini CLI 是 Google 推出的命令行 AI 助手工具，支持代码生成、问答等功能。

版本要求

最低支持版本：0.20.0
推荐版本：最新稳定版

版本检查

运行 gemini --version 查看你的 Gemini CLI 版本。

日志文件位置

Gemini CLI 将对话记录存储在以下位置：

macOSWindowsLinux

bash

~/.gemini/

bash

%USERPROFILE%\.gemini\

bash

~/.gemini/

目录结构示例：

~/.gemini/
├── tmp/
│   └── <project_hash>/
│       ├── checkpoint_1.json
│       └── checkpoint_2.json
├── settings.json
└── history/
    ├── session_20250115.json
    └── session_20250116.json

导入步骤

打开 Mantra，点击顶部的导入按钮
选择 Gemini CLI 作为导入来源
等待项目扫描，Mantra 会自动检测你的 Gemini CLI 对话记录
选择要导入的会话，可以选择部分或全部
点击导入，等待导入完成

常见问题

找不到 Gemini CLI 的对话记录？

可能原因：

未进行过对话 - Gemini CLI 只有在首次对话后才会创建目录
- 解决方案：先在 Gemini CLI 中进行一次对话
配置了自定义路径 - 你可能修改了默认存储位置
- 解决方案：检查 Gemini CLI 配置文件中的存储路径设置

部分对话内容丢失？

可能原因：

对话未正常结束 - 异常退出可能导致对话未完整保存
- 解决方案：检查原始 JSON 文件的完整性
旧版格式不兼容 - 早期版本的格式可能不被完全支持
- 解决方案：升级 Gemini CLI 后重新使用

Cursor 导入

关于 Cursor

Cursor 是一款基于 VS Code 的 AI 编程 IDE，集成了强大的 AI 辅助编码功能。

版本要求

最低支持版本：0.40.0
推荐版本：最新稳定版

版本检查

在 Cursor 中，点击菜单 Help > About 查看版本信息。

日志文件位置

Cursor 将对话记录存储在 SQLite 数据库中，位于以下位置：

macOSWindowsLinux

bash

~/Library/Application Support/Cursor/

bash

%APPDATA%\Cursor\

bash

~/.config/Cursor/

目录结构示例：

~/Library/Application Support/Cursor/
├── User/
│   ├── workspaceStorage/
│   │   └── <workspace_id>/
│   │       └── state.vscdb
│   ├── globalStorage/
│   │   └── state.vscdb
│   └── settings.json
└── Cache/

注意

Cursor 使用 SQLite 数据库存储对话，请确保在导入时 Cursor 已关闭，以避免数据库锁定问题。

导入步骤

关闭 Cursor（推荐），以确保数据库不被锁定
打开 Mantra，点击顶部的导入按钮
选择 Cursor 作为导入来源
等待数据库解析，Mantra 会读取并解析 SQLite 数据库
选择要导入的项目/对话
点击导入，等待导入完成

常见问题

提示"数据库被锁定"？

解决方案：

完全关闭 Cursor（检查系统托盘）
等待几秒钟后重试
如果问题持续，重启电脑后再尝试

Cursor 数据库位置找不到？

可能原因：

Cursor 是全新安装 - 还没有产生对话记录
- 解决方案：先在 Cursor 中使用 AI 功能进行一次对话
安装在非默认位置 - 如果你自定义了 Cursor 的安装位置
- 解决方案：在 Mantra 设置中手动指定数据库路径

导入的对话与项目关联不正确？

说明：

Cursor 的对话记录可能跨越多个项目，Mantra 会尽量根据上下文识别所属项目。如果关联不正确，你可以在导入后手动调整项目归属。

Codex 导入

关于 Codex

Codex 是 OpenAI 推出的命令行 AI 编程助手，支持代码生成、调试和自动化任务。它将对话记录存储在本地目录中，按日期组织。

版本要求

最低版本：0.75.0+
推荐版本：最新稳定版

版本检查

运行 codex --version 查看你的 Codex 版本。

日志文件位置

Codex 将对话记录存储在以下位置：

macOSWindows (WSL)Linux

bash

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl

bash

/mnt/c/Users/{用户名}/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl

bash

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl

目录结构示例：

~/.codex/
├── sessions/
│   └── 2025/
│       └── 01/
│           └── 15/
│               ├── rollout-1705312800000-abc123.jsonl
│               └── rollout-1705316400000-def456.jsonl

提示

Codex 按日期（年/月/日）组织会话文件，每个 JSONL 文件对应一个独立的编程会话。

导入步骤

打开 Mantra，点击顶部的导入按钮
选择 Codex 作为导入来源

等待会话扫描，Mantra 会自动检测你的 Codex 会话记录
选择要导入的会话，可以选择部分或全部
点击导入，等待导入完成

常见问题

找不到 Codex 的会话记录？

可能原因：

未进行过对话 - Codex 只有在首次对话后才会创建 sessions 目录
- 解决方案：先在 Codex 中进行一次对话
配置了自定义路径 - 你可能修改了默认存储位置
- 解决方案：检查 Codex 配置文件中的存储路径设置
Windows 非 WSL 环境 - 目前仅支持 WSL 环境下的 Codex
- 解决方案：确保在 WSL 中运行 Codex

导入后部分对话内容缺失？

可能原因：

JSONL 文件损坏 - 文件可能存在格式问题
- 解决方案：检查原始 JSONL 文件的完整性
会话被中断 - 异常退出可能导致记录不完整
- 解决方案：这是正常现象，Mantra 会尽可能恢复可用内容

支持推理模型（o1/o3）的思考过程吗？

支持！

Codex 使用 OpenAI 的推理模型时会记录思考过程，Mantra 完整支持这些内容的导入和展示。你可以在时光旅行中看到 AI 的推理步骤。

高级配置

自定义日志路径

如果你的 AI 工具使用了非默认的存储路径，可以在 Mantra 设置中添加自定义扫描路径：

打开 Mantra 设置（点击右上角齿轮图标）
找到「导入设置」部分
在「自定义路径」中添加你的路径

示例配置：

json

{
  "customPaths": {
    "claude": [
      "~/work/.claude/projects/",
      "/data/ai-projects/claude/"
    ],
    "gemini": [
      "~/custom/.gemini/"
    ],
    "cursor": [
      "/opt/cursor-data/"
    ],
    "codex": [
      "~/custom/.codex/sessions/"
    ]
  }
}

批量导入

如果你有多个项目需要导入，可以使用批量导入功能：

在项目选择界面，勾选多个项目
或者点击「全选」按钮选择所有检测到的项目
点击「批量导入」开始导入

提示

批量导入会按顺序处理每个项目，导入进度会实时显示。

故障排除

通用导入问题

问题	可能原因	解决方案
扫描不到任何项目	AI 工具未使用过	先在 AI 工具中进行一次对话
导入按钮灰色不可点击	没有选择任何项目	在列表中选择至少一个项目
导入过程中断	磁盘空间不足	清理磁盘空间后重试
导入完成但看不到对话	刷新延迟	重启 Mantra 或刷新页面

工具特定问题汇总

Claude Code：

确认 ~/.claude/projects/ 目录存在
检查 JSONL 文件格式是否正确
确认有读取权限

Gemini CLI：

确认 ~/.gemini/ 目录存在
检查 JSON 文件格式是否正确
升级到最新版本

Cursor：

确保 Cursor 已关闭
检查 SQLite 数据库文件是否存在
确认数据库文件未损坏

Codex：

确认 ~/.codex/sessions/ 目录存在
检查 JSONL 文件格式是否正确
Windows 用户需确保在 WSL 环境下运行

获取帮助

如果以上方案都无法解决你的问题，请：

查阅常见问题获取更多帮助
在 GitHub Issues 中搜索类似问题
加入 Discord 社区与其他用户交流
提交新的 Issue，附上详细的错误信息和操作步骤

导入向导 ​

概述 ​

导入向导功能 ​

支持的 AI 工具 ​

通用导入流程 ​

Claude Code 导入 ​

关于 Claude Code ​

版本要求 ​

日志文件位置 ​

导入步骤 ​

常见问题 ​

Gemini CLI 导入 ​

关于 Gemini CLI ​

版本要求 ​

日志文件位置 ​

导入步骤 ​

常见问题 ​

Cursor 导入 ​

关于 Cursor ​

版本要求 ​

日志文件位置 ​

导入步骤 ​

常见问题 ​

Codex 导入 ​

关于 Codex ​

版本要求 ​

日志文件位置 ​

导入步骤 ​

常见问题 ​

高级配置 ​

自定义日志路径 ​

批量导入 ​

故障排除 ​

通用导入问题 ​

工具特定问题汇总 ​

获取帮助 ​

导入向导

概述

导入向导功能

支持的 AI 工具

通用导入流程

Claude Code 导入

关于 Claude Code

版本要求

日志文件位置

导入步骤

常见问题

Gemini CLI 导入

关于 Gemini CLI

版本要求

日志文件位置

导入步骤

常见问题

Cursor 导入

关于 Cursor

版本要求

日志文件位置

导入步骤

常见问题

Codex 导入

关于 Codex

版本要求

日志文件位置

导入步骤

常见问题

高级配置

自定义日志路径

批量导入

故障排除

通用导入问题

工具特定问题汇总

获取帮助