Mantra 文档

简体中文

English

简体中文

English

主题

兼容性 ​

了解 Mantra 支持的 AI 工具、操作系统和版本要求，确保你的环境能够正常运行 Mantra。

版本更新

本页面会随着 Mantra 更新而更新。建议使用最新版本以获得最佳兼容性。

支持的 AI 工具 ​

Mantra 目前支持以下 AI 编程工具的对话记录导入和分析。

Claude Code ​

版本支持状态说明
1.0.0+✅ 完全支持推荐使用最新版本

支持的功能：

  • ✅ 对话记录导入
  • ✅ 时光旅行（代码快照）
  • ✅ 消息过滤
  • ✅ 内容脱敏
  • ✅ 工具调用查看
  • ✅ 代码块高亮
  • ✅ 文件树浏览

日志位置：

  • macOS/Linux：~/.claude/projects/
  • Windows：%USERPROFILE%\.claude\projects\

Gemini CLI ​

版本支持状态说明
1.0.0+✅ 完全支持推荐使用最新版本

支持的功能：

  • ✅ 对话记录导入
  • ✅ 时光旅行（代码快照）
  • ✅ 消息过滤
  • ✅ 内容脱敏
  • ⚠️ 工具调用查看（部分支持）
  • ✅ 代码块高亮
  • ✅ 文件树浏览

日志位置：

  • macOS/Linux：~/.gemini/
  • Windows：%USERPROFILE%\.gemini\

Gemini CLI 工具调用

部分旧版本的 Gemini CLI 日志格式可能不包含完整的工具调用信息。建议更新到最新版本以获得完整支持。

Cursor ​

版本支持状态说明
0.40.0+✅ 完全支持推荐使用最新版本
0.35.0 - 0.39.x⚠️ 部分支持部分功能可能受限
< 0.35.0❌ 不支持日志格式不兼容

支持的功能：

  • ✅ 对话记录导入
  • ✅ 时光旅行（代码快照）
  • ✅ 消息过滤
  • ✅ 内容脱敏
  • ✅ 工具调用查看
  • ✅ 代码块高亮
  • ✅ 文件树浏览

日志位置：

  • macOS：~/Library/Application Support/Cursor/User/workspaceStorage/
  • Windows：%APPDATA%\Cursor\User\workspaceStorage\
  • Linux：~/.config/Cursor/User/workspaceStorage/

Codex ​

版本支持状态说明
1.0.0+✅ 完全支持推荐使用最新版本

支持的功能：

  • ✅ 对话记录导入
  • ✅ 时光旅行（代码快照）
  • ✅ 消息过滤
  • ✅ 内容脱敏
  • ✅ 工具调用查看
  • ✅ 代码块高亮
  • ✅ 文件树浏览

日志位置：

  • macOS/Linux：~/.codex/
  • Windows：%USERPROFILE%\.codex\

Antigravity ​

版本支持状态说明
-🔜 即将支持敬请期待

功能支持矩阵 ​

下表展示了各 AI 工具对 Mantra 功能的支持情况：

功能Claude CodeGemini CLICursorCodexAntigravity
对话导入✅✅✅✅🔜
时光旅行✅✅✅✅🔜
代码快照✅✅✅✅🔜
消息过滤✅✅✅✅🔜
内容脱敏✅✅✅✅🔜
工具调用查看✅⚠️✅✅🔜
代码块高亮✅✅✅✅🔜
文件树浏览✅✅✅✅🔜
Git 历史匹配✅✅✅✅🔜
实时同步✅✅✅✅🔜

图例：✅ 完全支持 | ⚠️ 部分支持 | 🔜 即将支持 | ❌ 不支持

操作系统要求 ​

macOS ​

要求规格
最低版本macOS 12.0 (Monterey)
推荐版本macOS 13.0+ (Ventura 或更高)
架构支持Intel 和 Apple Silicon 原生支持
磁盘空间至少 500MB 可用空间
内存要求最低 4GB，推荐 8GB+

Apple Silicon 优化

Mantra 针对 Apple Silicon 芯片进行了优化，M1/M2/M3 系列芯片用户可获得最佳性能体验。

Windows ​

要求规格
最低版本Windows 10 (版本 1903+)
推荐版本Windows 11
架构支持x64 (64位)
磁盘空间至少 500MB 可用空间
内存要求最低 4GB，推荐 8GB+

Windows 7/8 不支持

由于技术限制，Mantra 不支持 Windows 7 和 Windows 8/8.1。请升级到 Windows 10 或更高版本。

Linux ​

要求规格
发行版支持Ubuntu 20.04+、Fedora 35+、Debian 11+
架构支持x64 (64位)
磁盘空间至少 500MB 可用空间
内存要求最低 4GB，推荐 8GB+

支持的发行版：

  • Ubuntu 20.04 LTS、22.04 LTS、24.04 LTS
  • Fedora 35、36、37、38、39
  • Debian 11 (Bullseye)、12 (Bookworm)
  • Linux Mint 20+
  • Arch Linux（需要 AUR）

依赖要求：

bash
# Debian/Ubuntu
sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6

# Fedora
sudo dnf install gtk3 libnotify nss libXScrnSaver libXtst

系统资源建议 ​

根据你的使用场景，以下是推荐的系统配置：

使用场景内存磁盘空间说明
轻度使用4GB500MB少量项目，偶尔使用
日常使用8GB1GB多个项目，频繁使用
重度使用16GB+2GB+大量项目，大型对话

性能提示

  • 使用 SSD 可显著提升项目加载速度
  • 关闭不使用的项目可降低内存占用
  • 定期清理缓存可释放磁盘空间

已知限制 ​

Claude Code 限制 ​

  • 极早期版本（beta 测试版）的日志格式可能不兼容
  • 某些自定义配置的日志路径需要手动指定
  • 加密的日志文件无法导入

Gemini CLI 限制 ​

  • 1.0.0 之前的版本日志格式不兼容
  • 部分工具调用信息可能不完整
  • 离线模式下的对话可能缺少时间戳

Cursor 限制 ​

  • 0.35.0 之前的版本日志格式不兼容
  • Composer 模式的对话需要 0.40.0+ 版本
  • 某些插件生成的对话可能无法正确解析

通用限制 ​

限制项说明建议
单个项目消息数超过 5000 条可能影响性能按时间段分割查看
单条消息大小超过 1MB 可能加载缓慢正常使用无需担心
并发项目数建议不超过 10 个同时打开关闭不使用的项目
Git 仓库大小超大仓库（>5GB）匹配可能较慢耐心等待或使用浅克隆

即将支持 ​

我们正在积极开发以下功能和支持：

更多 AI 工具 ​

工具状态预计时间
Windsurf🔜 开发中即将发布
Codeium📋 计划中待定
GitHub Copilot📋 计划中待定

功能增强 ​

  • 🔜 团队协作：多人共享项目分析
  • 🔜 云端同步：跨设备数据同步
  • 🔜 AI 分析报告：自动生成代码质量报告
  • 📋 插件系统：支持社区扩展

功能请求

如果你希望 Mantra 支持其他 AI 工具或功能，欢迎在 GitHub Issues 提交功能请求。

版本历史 ​

最近更新 ​

版本日期重要变更
1.2.02025-01新增 Cursor 0.40+ 完整支持
1.1.02024-12新增内容脱敏功能
1.0.02024-11正式版发布

兼容性变更说明 ​

1.2.0 版本：

  • 新增对 Cursor Composer 模式的支持
  • 改进 Gemini CLI 工具调用解析
  • 修复部分 Windows 路径问题

1.1.0 版本：

  • 新增内容脱敏功能
  • 改进大项目加载性能
  • 新增 Linux ARM64 支持

1.0.0 版本：

  • 首个正式版本
  • 支持 Claude Code、Gemini CLI、Cursor
  • 核心功能：时光旅行、消息过滤、内容导出

下一步 ​