常见问题 (FAQ)
基础问题
Mantra 是什么？
Mantra 是一款本地优先的 AI 编程伴侣工具，围绕「回放 · 掌控 · 安全」三大核心构建。它帮助开发者：
- 回放：回看 AI 编程的每一步，回放会话、时光旅行查看历史代码
- 掌控：统一管理 MCP 服务和 Skills，配置一次、所有 AI 工具共享
- 安全：检测 AI 生成内容中的敏感信息，防止密钥和凭证泄露
目前支持 Claude Code、Cursor 和 Gemini CLI，Codex 和 Antigravity 即将支持。
Mantra 支持哪些平台？
目前 Mantra 支持：
- macOS (Intel & Apple Silicon)
- Windows 10/11
- Linux (Ubuntu 20.04+, Fedora 36+)
Mantra 是免费的吗？
所有本地功能永久免费，没有任何限制——无限会话和项目、MCP Hub、Git 时光旅行、全文搜索、本地脱敏引擎，全部包含。
此外还提供可选的增值服务：
- Sync 同步（$4/月起）：跨设备会话同步，端到端加密
- Publish 分享（$8/月/站点起）：一键生成 Web 回放链接，支持自定义域名
详见 定价页面。
数据与隐私
我的数据存储在哪里？
所有数据都存储在您的本地设备上。具体位置（v0.11.0+）：
配置文件：
- macOS:
~/Library/Application Support/com.gonewx.mantra/ - Windows:
%APPDATA%\com.gonewx.mantra\ - Linux:
~/.config/com.gonewx.mantra/
应用数据（数据库、Skills、备份等）：
- macOS:
~/Library/Application Support/com.gonewx.mantra/ - Windows:
%APPDATA%\com.gonewx.mantra\ - Linux:
~/.local/share/com.gonewx.mantra/
缓存：
- macOS:
~/Library/Caches/com.gonewx.mantra/ - Windows:
%LOCALAPPDATA%\com.gonewx.mantra\cache\ - Linux:
~/.cache/com.gonewx.mantra/
如果从旧版本升级，Mantra 会自动将 ~/.mantra/ 中的数据迁移到新路径。
Mantra 会上传我的数据吗？
不会上传您的代码或会话内容。Mantra 是一款本地优先的应用程序：
- 所有会话数据、MCP 配置和 Skills 均保存在本地
- 匿名使用统计默认开启（可在设置中关闭）
- 绝不收集代码、会话内容或个人信息
所有核心功能（会话回放、MCP Hub、Skills Hub、敏感信息检测）都在您的设备上完成。
Mantra 会把我的对话或代码上传吗？
不会。核心功能全部在本地运行，我们不会上传您的对话或代码。可选的 Sync 和 Publish 使用端到端加密，我们无法读取您同步或分享的内容。
Sync 和 Publish 的数据存在哪里？
Sync 和 Publish 的数据在加密后由您选择的存储或托管服务保存；我们无法解密或访问。您始终拥有数据的控制权。
如何删除我的数据？
您可以通过以下方式删除数据：
- 在应用内使用「清除数据」功能
- 直接删除数据目录
- 卸载应用时选择「删除所有数据」
功能相关
什么是「时间旅行」功能？
时间旅行功能让您可以拖拽时间轴，回放 AI 编程会话的每个时刻，同时查看当时的代码状态。这有助于：
- 理解代码变更的上下文
- 回顾 AI 的思考过程
- 学习和总结编程模式
敏感信息检测支持哪些类型？
Mantra 的本地 Rust 引擎可以检测：
- API 密钥 (OpenAI, Anthropic, AWS 等)
- 数据库密码
- 访问令牌 (GitHub, GitLab 等)
- 私钥文件
- 环境变量中的敏感值
全文搜索是如何工作的？
Mantra 使用本地索引技术，支持：
- 跨项目搜索
- 跨会话搜索
- 实时结果预览
- 高亮显示匹配内容
技术支持
如何报告 Bug？
您可以通过以下渠道报告问题：
- GitHub Issues（推荐）：mantra-hq/mantra-releases/issues
- 邮箱：mantra@gonewx.com
- Discord：加入社区
- Twitter：@decker502
如何请求新功能？
我们欢迎功能建议！请通过 GitHub Issues、Discord 社区或邮件联系我们。
最后更新: 2026 年 3 月