
# 仓库

**仓库**保存组织的 Git 仓库，由网关之后私有的 Forgejo 提供服务。用你的 Acahti 账号或令牌，通过 HTTPS 从 `<instance>/<org>/<repo>.git` 克隆。

![合成示例工作区中的仓库](/images/repos.png "仓库列表，显示语言、未合并的 PR、最近提交和最新流水线。")

## 列表

每个仓库显示语言、星标、复刻、未合并的 PR、最近提交、最新流水线和主题。可按团队、类型和语言筛选，按最近更新、名称或星标排序。组织管理员可以归档仓库，使其只读、对成员隐藏并在 CI 中跳过（`repo_archive`）；管理员仍可打开并恢复它。

## 仓库内部

| 标签页 | 显示 |
|---|---|
| 文件 | 某个分支或标签下的目录树和文件内容 |
| 提交 | 分支的历史，以及每个提交的 diff |
| Graph | 跨分支和合并的提交图 |
| 分支、标签 | 每个分支和标签及其最新提交 |
| Pull requests | 未合并、已合并和已关闭的 PR |
| 流水线 | 本仓库的运行，以及成功率和运行时长 |
| 权限 | 谁有权限（通过团队或直接授予）；重命名、移到其他团队、归档 |
| 密钥 | 流水线密钥；值只写入一次，之后不再显示 |

## PR

PR 页面显示它的进度（已开启、检查、可合并，然后是已合并或已关闭）、描述和评论，以及 head 上的流水线运行。只有 head 上最新的流水线通过时，**合并**才可用；`pr_merge` 遵循同样的规则。在标题、正文或分支里写了待办或工单编号的 PR，会在「评审」下加入该条目的[追踪](mainline.md)流程。

![合成示例工作区中的 PR](/images/pull.png "一个 PR 的进度、检查和流水线运行。")

## Agent 访问

Agent 通过 `repo_list`、`repo_get`、`branch_list`、`pr_create`、`checks_wait` 和 `pr_merge` 或 CLI 使用同样的仓库。提交带着 `whoami` 给出的身份。参见 [MCP 工具](mcp.md)和 [CLI](cli.md)。
