Hub documentation

预发布模型页面

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

预发布模型页面

此功能适用于采用 Enterprise 套餐或更高套餐的组织 — 或者 联系我们。

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

资格

  • 您的组织必须订阅 Enterprise 或更高级别的套餐。
  • 模型仓库必须位于组织命名空间下(例如 my-org/my-upcoming-model)。用户拥有的仓库不符合条件。
  • 模型仓库必须是私有的。将模型设为公开即会发布该模型(参见下文)。

宣布你的模型

要将私有模型的页面转换为预发布页面,请在模型卡元数据(即仓库README.md文件顶部的 YAML 部分)中添加release_date字段:

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

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

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

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

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

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

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

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

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

成员可见的内容

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

  • 模型页面上的横幅会提示该模型处于预发布阶段。点击 预览页面 — 或在模型 URL 后附加 ?preview — 即可查看访客所看到的内容。
  • 在模型列表中,该模型会显示一个 Pre-release 徽章。
Banner on the model page indicating that the model is in pre-release, with a Preview the page button

在发布时通知您的订阅者

当您准备发布时:

  1. 将模型文件推送到仓库。
  2. 将模型设为公开。这将发布该模型:预发布页面将变为常规模型页面——无需删除release_date字段。
  3. 具有写入权限的仓库成员会看到一个横幅,上面写着“N 位用户正在等待接收此版本发布的通知”,并附带一个 发送版本发布通知 按钮。
  4. 点击 发送发布通知,通过电子邮件通知每位订阅者,您的模型现已在 Hugging Face 上可用。
Banner on the model page showing the number of users waiting to be notified, with a Send release notifications button

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

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

需要注意的事项

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