Hugging Face Hub Collections 创建及管理教程

要是模型、数据集、Space 和论文散在各个页面，最头疼的根本不是点收藏那一下，而是过了一周再回头看，压根记不起当初为啥把它们凑一块儿。Hugging Face Hub 的 Collections 就是专门解决这个问题的：能把这些 Hub 里的条目整成一个带标题、有说明、还能排序的专属页面。个人账号可以用它做自己的资源清单，组织也能把 Collection 当成大家一起维护的项目入口。

创建前先捋清楚归属和权限

先登录你打算长期维护这个 Collection 的账号，再想好它是归个人还是归组织。个人的 Collection 全由你自己管；组织的 Collection 可以让成员一起维护，但只读成员只能看，得有 Write 或更高的组织权限，才能创建、添加、编辑和移除里面的条目。

另外还得提前定好可见范围。Public 类型的 Collection 会显示在个人或组织的资料页，访客都能点开看；Private 类型的不会出现在公开资料页，就算别人拿到地址，没权限也打不开。组织的 Private Collection 只有组织成员能看到。Team 与 Enterprise 方案里的 Gating Group Collection 和 Resource Group 属于额外的权限功能，普通的 Collection 不会自动批量控制模型或者数据集的访问权限。

从空白清单做出一个好维护的 Collection

第一步：从个人主页或者组织页新建

入口在哪：创建个人 Collection 时，登录后在个人主页左上角找 + New；创建组织 Collection 时，先进入目标组织页面，再找页面上方的 + New。两个菜单里都有 Collection 选项。

具体操作：点击 Collection，填个能说明用途的标题和简短描述，再确认归属的账号或组织就行。也可以在仓库页第一次做添加操作的时候，选 + Create new collection 顺手创建，更方便。

怎么算成功：页面会跳转到新的 Collection 页，标题显示在主内容区，右边能看到添加条目、主题、历史和可见性等管理选项。出问题怎么办：要是菜单里找不到 Collection，先确认账号已经登录；组织页没这个入口的话，检查自己有没有 Write 或更高权限，再确认是不是不小心进了同名的个人主页。

图里编号 1 是个人主页入口，编号 2 是组织页入口。两边都是先点 + New，再选菜单里的 Collection；前者创建个人 Collection，后者创建组织 Collection。

第二步：把模型、数据集、Space 或者论文加入清单

入口在哪：从某个仓库出发的话，打开仓库页面右上方的更多菜单，选 Add to collection；从 Collection 出发的话，在右侧菜单点 + Add to collection，再搜索想加的仓库名称就行。

具体操作：选中目标 Collection 并确认添加就好。条目不一定非得是自己的，公开可访问的外部仓库也能收进个人清单。加的时候一次核对一个目标，尤其要留意名字相近但命名空间不同的仓库，别加错了。

怎么算成功：目标模型、数据集或 Space 卡片会出现在 Collection 主区域。出问题怎么办：搜不到目标的时候，先检查完整的仓库名称和类型；能看到仓库却加不了的话，核对下 Collection 的归属和自己的编辑权限。怕重复加的话先回 Collection 页面确认，别连续点造成误判。

左边的画面适合“看到一个仓库就随手收进去”，右边的画面适合“已经在整理清单，按着名字补条目”。两个入口的结果是一样的。

第三步：用历史记录核对协作修改

入口在哪：进入组织的 Collection 页面，在右侧菜单里找 View history。

具体操作：打开历史窗口，按时间线检查谁创建了 Collection、谁添加或移除了条目、哪些条目被更新了。多人维护的时候，要是发现内容突然少了，先看这里再决定要不要补回去，别着急操作。

怎么算成功：Collection history 窗口会列出操作者、操作对象和发生时间。出问题怎么办：历史记录里没有预期变化的话，先刷新下 Collection 页面，确认看的是正确归属和正确名称的；只读成员没法通过历史窗口恢复内容，得找有写权限的成员来修正。

这里最该留意的是动作动词：added、removed、updated 和 created，靠它们能快速还原一条内容的变化过程。

第四步：调整 Collection 和条目的展示顺序

入口在哪：Collection 页面左侧列表里的每个 Collection 名称旁都有拖动手柄；主内容区每个条目旁也有手柄，鼠标移到对应区域后会更清楚。

具体操作：按住手柄拖动就行，先排好各个 Collection 的先后顺序，再排当前 Collection 内部的条目。最重要的内容放前面，因为资料页会直接展示靠前的 Collection，Collection 预览也只会先露出前几个条目。

怎么算成功：松开鼠标后，名称或条目停在新位置，刷新页面也还是这个顺序。出问题怎么办：拖动没反应的话，确认按住的是三横线手柄而不是卡片正文；组织的 Collection 还要再检查下写权限。排序后立刻刷新又变回旧位置，说明变更可能没保存上，可以重新拖一次，等页面稳定了再离开。

编号 1 管的是左侧 Collection 的顺序，编号 2 管的是单个 Collection 里条目的顺序。别把这两个层级搞混了哈。

第五步：给条目补一段好懂的备注

入口在哪：把鼠标移到 Collection 里的某个条目上，右侧会弹出上下文操作按钮，铅笔加号的图标就是 Add note。

具体操作：点一下图标，写清这个条目为啥被收录、适合什么任务，或者下次要核对啥内容。备注是纯文本的，不支持 Markdown；需要有条理的话，用短句和正常标点写就可以了。

怎么算成功：保存后，备注会出现在对应条目附近，离开页面再回来也还能看到。出问题怎么办：悬停后没出现按钮的话，先确认账号登录了而且有编辑权限；格式符号原样显示不是故障，因为备注本来就不解析 Markdown。内容太长的话，把结论留在备注里，详细说明放回仓库卡片或者项目文档就行。

图里的按钮只有在条目右侧浮出来后才好找。点之前看准铅笔加号图标，别误碰旁边的垃圾桶。

第六步：移除单个条目或者删除整个 Collection

入口在哪：移除单个条目的话，把鼠标移到目标条目上，点右侧的垃圾桶图标；删除整个 Collection 的话，用页面右侧菜单里的 Delete collection。

具体操作：先搞清楚要删的是一张条目卡片，还是整个 Collection。移除条目只影响当前清单，不会删掉原模型、数据集或 Space；删除整个 Collection 会清掉这套清单，需要在确认窗口里再确认一次。

怎么算成功：移除条目后，其余条目和 Collection 都还在；删除 Collection 后，它就不会再出现在左侧列表和资料页里了。出问题怎么办：按钮不可用的话先检查编辑权限；误删单个条目可以按仓库名称重新加回来。官方文档没提供整个 Collection 的恢复入口，误删后只能按之前留存的条目记录重新创建，所以确认窗口弹出来的时候务必再核对一次标题。

编号 1 只移除当前条目，编号 2 删除整个 Collection。俩位置离得很近，但影响范围完全不一样，可别点错了。

收尾前对着这份检查清单过一遍

• Collection 归属在预期的个人账号或组织下，组织维护者具备 Write 或更高权限。
• 标题和简短描述能说清清单用途，可见性设置和公开或内部使用的场景一致。
• 模型、数据集、Space 或论文来自正确的命名空间，没把同名仓库加错。
• 刷新页面后，Collection 和条目顺序仍保持不变，资料页优先展示的内容排在前面。
• 需要协作说明的条目已经写入纯文本备注，历史窗口的记录和最近的修改对得上。
• 删除操作前分清单个条目和整个 Collection；清理后再刷新一次确认结果。