兼容性
了解 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 Code | Gemini CLI | Cursor | Codex | Antigravity |
|---|---|---|---|---|---|
| 对话导入 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 时光旅行 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 推演模式 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 代码快照 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 消息过滤 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 内容脱敏 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 工具调用查看 | ✅ | ⚠️ | ✅ | ✅ | 🔜 |
| 上下文因果 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 代码块高亮 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 文件树浏览 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Git 历史匹配 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 实时同步 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| MCP Hub 接管 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Skills Hub 接管 | ✅ | ✅ | ✅ | ✅ | - |
| 会话实时更新 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| 远程 SSH 接入 | ✅ | ✅ | ✅ | ✅ | 🔜 |
图例：✅ 完全支持 | ⚠️ 部分支持 | 🔜 即将支持 | ❌ 不支持
操作系统要求
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系统资源建议
根据你的使用场景，以下是推荐的系统配置：
| 使用场景 | 内存 | 磁盘空间 | 说明 |
|---|---|---|---|
| 轻度使用 | 4GB | 500MB | 少量项目，偶尔使用 |
| 日常使用 | 8GB | 1GB | 多个项目，频繁使用 |
| 重度使用 | 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 提交功能请求。
版本历史
最近更新
| 版本 | 日期 | 重要变更 |
|---|---|---|
| 0.11.0 | 2026-03-03 | 推演模式、上下文因果分析 |
| 0.10.0 | 2026-02-22 | 会话实时更新、远程 SSH 项目接入 |
| 0.9.1 | 2026-02-15 | 搜索结果精准定位与多匹配导航、Skills Hub 项目集成增强 |
| 0.9.0 | 2026-02-14 | Skills Hub 统一 Skills 管理 |
| 0.8.2 | 2026-02-12 | 项目级 MCP 管理、作用域配置导入 |
| 0.8.1 | 2026-02-09 | 品牌更名 (MCP Hub)、单实例运行锁 |
| 0.8.0 | 2026-02-09 | 自动更新系统、设置页面重构、工具配置路径管理 UI |
| 0.7.0 | 2026-02-03 | MCP Hub、内置 Inspector、系统托盘集成 |
| 0.6.0 | 2026-01-25 | 逻辑项目聚合、重命名与解除关联 |
| 0.5.0 | 2026-01-20 | 精简模式 (Refine Mode)、撤销/重做、Token 统计 |
| 0.4.0 | 2026-01-10 | 隐私安全模块、自定义检测规则 |
| 0.3.0 | 2025-12-30 | 隐私脱敏引擎、多源聚合、Gemini 支持 |
| 0.2.0 | 2025-12-15 | 消息过滤、代码快照、全局搜索 |
| 0.1.0 | 2025-12-01 | 初始 Alpha 发布 |
兼容性变更说明
0.11.0 版本：
- 推演模式 (Replay Mode)：在安全的本地工作区内逐步重建和验证 AI 操作的全新推演体验
- 上下文因果 (Context Causality)：自动分析并在界面中关联“参考文件”与“代码变更”的逻辑因果
0.10.0 版本：
- 会话实时更新：支持实时监听四大 AI 工具（Claude Code、Codex、Cursor、Gemini CLI）的进行中会话，本地和远程均支持
- 远程 SSH 接入：无需在远程服务器安装软件，通过 SSH 直接导入和实时监听远程会话
- 导入页面重设计：采用位置分组布局，本地和远程来源在同一页面统一展示
0.9.1 版本：
- 搜索结果导航：点击全局搜索结果精准跳转到目标消息，多匹配项可用键盘快速导航
- Skills Hub 项目集成增强：SkillContextCard 新卡片、未管理 Skill 提醒横幅、双向页面导航
0.9.0 版本：
- Skills Hub：全新的统一 Skills 管理功能，支持从 Claude Code、Cursor、Codex、Gemini CLI 导入 Skills
- 跨工具分发：通过 symlink 实现一次导入、处处可用
- 项目关联：支持用户级和项目级 Skill 关联，与 MCP Hub 对称设计
0.8.2 版本：
- 项目级 MCP 管理：从项目右键菜单直接管理 MCP 服务关联
- 作用域配置导入：基于项目作用域自动扫描和过滤
- AppImage 兼容：修复 AppImage 环境下外部进程启动问题
0.8.0/0.8.1 版本：
- 自动更新：引入了内置的自动更新系统，支持增量更新和后台下载。
- 设置重构：设置页面重构为侧边栏导航结构，提升了可扩展性。
- 品牌更名："MCP Gateway" 正式更名为 "MCP Hub"，相关术语和界面已更新。
0.7.0 版本：
- MCP Hub: 深度集成 Model Context Protocol，支持 SSE 服务端
- MCP Hub: 统一管理 MCP 服务、环境变量和 OAuth 凭证
- 工具权限管理: 实现项目级的工具粒度拦截与授权 (Tool Policy)
- 系统托盘: 支持后台运行与快速唤起
- 交互优化: 全面迁移至 Action Sheet 交互模型，提升复杂表单体验