项目管理
Mantra 采用创新的**逻辑项目（Logical Project）**视图，帮助你统一管理来自不同 AI 工具的编程会话。
核心概念
逻辑项目 vs 物理路径
在 Mantra 中，项目不再仅仅是某个工具的一个工作区，而是基于物理路径的聚合视图：
- 物理路径：你硬盘上的实际文件夹（例如
/Users/decker/projects/mantra）。 - 逻辑项目：Mantra 自动将所有指向同一物理路径的会话（无论来自 Claude、Gemini 还是 Cursor）聚合在一起，形成一个统一的"逻辑项目"。
这意味着，你在同一个代码仓库中使用不同 AI 工具产生的会话，现在可以在 Mantra 中集中查看和管理。
支持的来源
Mantra 目前支持聚合以下来源的会话：
- Claude Code: 基于项目目录。
- Gemini CLI: 基于项目哈希或手动关联的路径。
- Cursor: 基于工作区路径。
- Codex: 基于会话文件路径。
功能特性
1. 自动聚合
当你导入不同工具的日志时，Mantra 会自动检测它们关联的物理路径。如果路径相同，它们会被自动合并到同一个逻辑项目下。
在项目列表中，你可以看到每个项目包含的会话来源图标（如 Claude、Gemini 等）。
2. 手动关联与路径修正
有些工具（如 Gemini CLI）可能无法自动提供准确的物理路径（显示为 gemini-project:xxx 或 "需关联"）。
- 关联路径：在项目详情页，你可以点击"关联真实路径"按钮，手动选择该项目对应的本地文件夹。
- 自动合并：关联后，如果该路径下已有其他项目，Mantra 会自动将它们合并为一个逻辑项目。
3. 项目重命名
你可以自定义逻辑项目的显示名称，方便识别。
- 右键点击项目 -> 选择 重命名。
- 这只会修改 Mantra 中的显示名称，不会影响你硬盘上的文件夹名称。
4. 解除关联
如果你希望将某个来源从逻辑项目中分离出来：
- 打开项目详情页。
- 在"聚合来源"列表中找到该来源。
- 点击 解除关联 按钮。
解除关联后，该来源将恢复为独立的（通常是虚拟路径的）项目状态。
5. MCP 服务关联与工具策略 (v0.7.0+)
在项目详情页，你可以深度定制 AI 对该项目的访问权限：
- 关联 MCP 服务：你可以为每个项目独立勾选所需的 MCP 服务。AI 仅能访问该项目已关联的服务，确保上下文的安全边界。
- 工具权限策略 (Tool Policy)：针对项目中的特定工具（如
read_file,write_file,execute_command），你可以设置：- 始终允许：提升操作流畅度。
- 询问许可：关键操作（如删除文件）建议开启。
- 禁止：完全切断 AI 对该高危工具的访问。
6. Git 集成
Mantra 会实时检测逻辑项目关联的物理路径下是否存在 Git 仓库。
- 如果存在，项目列表右侧会显示 Git 分支图标。
- 你可以直接在 Mantra 中查看该项目的 Git 状态和历史。