# 预发布模型页面

> [!WARNING]
> 此功能适用于企业版或更高版本套餐的组织 — 或联系我们。

预发布模型页面允许您的组织在模型仍处于私有状态时提前宣布即将发布的模型。访客看到的将不再是 404 页面，而是一个专门的公告页面，其中包含指向发布日期的实时倒计时以及一个 **点赞并在发布时通知** 按钮，这样他们就能在您的模型发布时立即收到电子邮件通知。当您将该模型设为公开时，即视为已发布，公告页面将被模型卡片替换。

## 资格

- 您的组织必须订阅 [Enterprise](https://huggingface.co/enterprise) 或更高级别的套餐。
- 模型仓库必须位于**组织命名空间**下（例如 `my-org/my-upcoming-model`）。用户拥有的仓库不符合条件。
- 模型仓库必须是**私有**的。将模型设为公开即会发布该模型（参见[下文](#notify-your-subscribers-on-release)）。

## 宣布你的模型

要将**私有**模型的页面转换为预发布页面，请在模型卡元数据（即仓库`README.md`文件顶部的 YAML 部分）中添加`release_date`字段：

```yaml
---
release_date: 2026-07-27
description: "A short tagline shown on the pre-release page"
---
```

`release_date` 字段接受 YAML 日期，或者如果你想指定具体时间，则接受带引号的 ISO 8601 时间戳：

```yaml
release_date: "2026-07-27T15:00:00Z"
```

无效值会被元数据验证器拒绝并忽略。日期不一定要在未来：如果日期在过去，页面将显示“即将上线”而非倒计时。日期以 UTC 时区显示。

几个可选的元数据字段可用于自定义预发布页面：

| 字段 | 效果 |
| --- | --- |
| `description` | 预发布页面的主标语，同时用作该页面的元描述。 |
| `pretty_name` | 在英雄标题中显示在仓库名称之前的人类可读名称。 |
| `approximate_eta` | 如果 `release_date` 仅为估算值，请将其设置为 `true`：该日期将标记为 **当前预计时间** 徽章。 |
| `thumbnail` | 自定义社交分享图片的 URL，用于替换自动生成的图片。 |

```yaml
---
release_date: 2026-07-27
approximate_eta: true
pretty_name: "My Upcoming Model"
description: "A short tagline shown on the pre-release page"
---
```

还有几点需要了解：

- 您的模型卡 Markdown 正文（YAML 元数据下方的所有内容）是访客在预发布页面上阅读的部分——请利用它来描述即将推出的内容、展示预告、链接到论文等。
- 您现在无需上传任何权重：在整个公告期间，仓库只需要`README.md`。您可以随时准备好后再上传模型文件。
- 编辑模型卡元数据后，预发布页面可能需要几秒钟才能开启或关闭。

## 访客看到的内容

当模型为私有且已设置 `release_date`（并且您的组织符合条件）时，访客将看到预发布页面，而不是 404 页面：

- 带有 **即将发布** 标签的英雄区域，包含模型名称、您的标语，以及到发布日期的实时 **倒计时**。英雄区域的颜色源自您组织的头像。
- 一个 **点赞并在发布时通知** 按钮：点击它即可为仓库点赞，并订阅该版本的邮件通知。用户需要处于登录状态，取消点赞模型则会取消订阅。
- 模型卡片的内容。
- 侧边栏显示点赞数（即**等待发布**的用户数）、最近的点赞者、预计发布日期以及您组织的最新模型。
- 一个专用的社交分享缩略图，使用与主视觉相同的颜色。

    
    

> [!TIP]
> 预发布页面会渲染你的模型卡片内容——在公告期间，你在 `README.md` 正文中编写的所有内容（包括其中引用的图片和视频）都将公开可见。仓库的其余部分保持私有：文件、讨论和 API 访问权限仍仅限于成员，且该模型不会公开列出。

当倒计时归零时，页面会显示 **"即将上线"** — 预发布页面会一直保留，直到您将模型设为公开。

## 成员可见的内容

所有对仓库拥有**读取权限**的用户仍会看到常规模型页面，因此您的团队可以在公告发布期间继续管理文件和设置：

- 模型页面上的横幅会提示该模型处于预发布阶段。点击 **预览页面** — 或在模型 URL 后附加 `?preview` — 即可查看访客所看到的内容。
- 在模型列表中，该模型会显示一个 **Pre-release** 徽章。

    
    

## 在发布时通知您的订阅者

当您准备发布时：

1. 将模型文件推送到仓库。
2. 将模型设为**公开**。这将发布该模型：预发布页面将变为常规模型页面——无需删除`release_date`字段。
3. 具有写入权限的仓库成员会看到一个横幅，上面写着“N 位用户正在等待接收此版本发布的通知”，并附带一个 **发送版本发布通知** 按钮。
4. 点击 **发送发布通知**，通过电子邮件通知每位订阅者，您的模型现已在 Hugging Face 上可用。

    
    

模型变为公开时不会自动发送通知：由您决定何时发送。以下几点需要了解：

- 订阅者是模型在预发布期间点赞该模型的用户，因此横幅中显示的数字可能低于总点赞数。
- 每位订阅者最多会收到一封电子邮件，通知发送完毕后横幅即会消失。
- 通知会遵循每位用户的[通知偏好设置](https://huggingface.co/settings/notifications)（“您订阅的发布版本已可用”）。

## 需要注意的事项

- **页面在日期过后仍保持在线**：到达发布日期不会自动下线预发布页面；请将模型设为公开以正式发布，并切换回常规模型页面。
- **将模型设为公开即为发布**：只有当模型公开后，才能发送发布通知。
- 在模型仍处于私有状态时移除 **`release_date`**，预发布页面将会下线：访客将再次看到 404 页面，与任何私有模型的情况相同。
- 在 `release_date` 仍然设置的情况下，将 **模型重新设为私有** 会重新启用预发布页面。

