仓库管理¶
AgentHeaven 提供了强大的仓库管理功能，帮助您组织和管理AI智能体项目。每个仓库都包含项目的配置文件和本地设置。
1. 仓库目录结构¶
每个 AgentHeaven 仓库都包含一个 .ahvn/ 目录，类似于 Git 的 .git/ 目录：
your-project/
├── .ahvn/
│ └── config.yaml # 本地配置文件
├── your_files.py
└── ...
2. 初始化新仓库¶
2.1. 创建匿名仓库¶
在当前目录初始化一个新的 AgentHeaven 仓库：
ahvn repo init
这将在当前目录创建 .ahvn/ 目录和配置文件，但不会在全局注册该仓库。
2.2. 创建命名仓库¶
创建一个带名称的仓库，并自动注册到全局配置中：
ahvn repo init my-project
这不仅会初始化当前目录,还会将该仓库以 my-project 的名称注册到全局配置中,方便后续管理。
2.3. 重置现有仓库¶
如果需要重置仓库配置到默认值，使用--reset/-r：
ahvn repo init --reset
# 或
ahvn repo init my-project --reset
3. 缓存与清理¶
3.1. 清除缓存与临时文件¶
AgentHeaven 将缓存数据和临时文件存储在配置的目录中。您可以清理这些文件以释放磁盘空间或解决缓存损坏引起的问题：
ahvn clean
这将删除配置的 cache_path 和 tmp_path 目录中的所有缓存数据和临时文件。
3.2. 预览清理（试运行）¶
要预览将要删除的内容而不实际删除，使用 --dry-run/-n 选项：
ahvn clean --dry-run
# 或
ahvn clean -n
4. 全局仓库管理¶
4.1. 查看所有注册的仓库¶
列出所有在全局配置中注册的仓库，使用list或ls：
ahvn repo list
# 或
ahvn repo ls
输出示例：
Registered repos:
✓ my-project /path/to/my-project
✗ old-project /path/to/old-project # 路径不存在
✓ 表示仓库路径存在且有效
✗ 表示仓库路径不存在或无效
4.2. 查看仓库详细信息¶
查看特定仓库的详细信息，使用info：
ahvn repo info my-project
输出示例：
Repo: my-project
Path: /path/to/my-project
Exists: Yes
Created: 2024-01-15 10:30:45
Modified: 2024-01-20 14:22:33
4.3. 重命名仓库¶
重命名一个已注册的仓库，使用rename或rn：
ahvn repo rename old-name new-name
# 或
ahvn repo rn old-name new-name
4.4. 移除仓库¶
从全局配置中移除仓库注册（不会删除实际文件），使用remove或rm：
ahvn repo remove my-project
# 或
ahvn repo rm my-project