# 仓库与内容空间

使用 Space 和 Collection 组织仓库内容。

## 理解层级

**Organization** 管理成员与工作区，连接 **Repository**。每个仓库可以包含多个 **Space**，每个 Space 包含按内容结构划分的 **Collection**。

不同内容区域或网站可以使用独立 Space。Collection 将内容结构或编辑器配置相同的文件组织在一起。

## 发现已有内容

连接 GitHub 仓库并扫描配置的分支。确认前先检查候选内容。Prosefly 支持部分 Astro 内容配置、Fumadocs 的框架识别，以及用于 Hugo 内容的通用 Markdown Collection。

编辑器不会执行仓库代码。自定义 loader 或动态配置可能需要手动配置，也可能无法使用原生导航编辑。

账号授权、选择仓库和首次扫描的具体步骤，见[连接 GitHub 指南](/docs/zh-cn/connect-github/)。

## 配置 Space

Owner 和 Admin 可以管理 Space 配置、Collection 路径、编辑器配置和发布模式。第一次发布前请检查目标分支和内容路径。

## 管理网站导航

扫描可以识别支持的 Starlight、Lotus、Dahlia 和 Fumadocs 原生导航。确认检测到的绑定后，才可使用 Navigation 面板。

可写分组允许添加新页面及调整顺序。自动分组遵循文件路径；拖动导航条目不会移动 Markdown 文件。不支持或不明确的配置可能只能发布内容。

## 刷新与归档

Git 变更需要明确扫描和重新索引后才能显示，并非通过 GitHub webhook 自动同步。归档 Space 仍可查看，Owner 或 Admin 可以在容量允许时重新启用。断开仓库会归档其 Space；重新连接不会自动启用。

<figure>
  <img
    src="/images/github/6-repository-detail.png"
    alt="在仓库设置中查看目标分支、内容空间和索引状态。"
    width="2800"
    height="1858"
    loading="lazy"
  />
  <figcaption>在仓库设置中查看目标分支、内容空间和索引状态。</figcaption>
</figure>