跳转到主要内容
Base 目前处于 beta 阶段,可能会发生变化。
验证 Base 中的页面,让团队了解哪些页面是最新的。添加属性(例如负责人),记录谁对页面负责以及页面的其他详细信息。 每个页面的 frontmatter 都会存储其验证状态和属性。通过 MCP 服务器或你的 Git 仓库读取 Base 的 AI 工具,会在读取页面内容的同时看到验证状态和其他属性。 验证和属性仅适用于 Base 项目中的页面,在文档项目中不可用。

验证状态

验证页面

要验证 Teamspace 页面或更改其状态,你必须拥有编辑者或管理员角色。要验证私有页面,你必须在该页面上拥有 Editor 或 Full Access 角色。任何可以打开页面的人都能看到其状态。
  1. 在编辑器中打开页面。
  2. 将鼠标悬停在页面标题上方,以显示 Add verification 按钮。
  3. 点击 Add verification。
  4. 选择验证的有效期:For 90 days、For 30 days、For 7 days、Indefinitely 或 Pick a date。
页面的验证状态会显示在顶部栏中。点击该状态可查看最后验证该页面或将其标记为已过时的人。

更改页面状态

点击顶部栏中的验证状态即可更改其状态。
  • 要更改验证的结束时间,请使用 Expiration 菜单选择新的日期。
  • 要将已验证的页面标记为已过时,请点击 Mark Outdated。
  • 要重新验证已过时或已过期的页面,请选择新验证的有效期。
  • 要将页面恢复为 Not verified,请点击 Remove verification。

收件箱中的验证通知

当同事验证页面、将其标记为已过时或移除其验证,或者页面的验证过期时,Mintlify 会向页面负责人的收件箱发送通知;如果页面被标记为已过时、被移除验证或已过期,还会通知最后验证该页面的人。 你不会收到有关自己所做更改的通知。

添加属性

一个页面可以有一个负责人和任意数量的自定义属性。
  • Owner:负责该页面的同事。当页面的验证状态发生变化时,负责人会收到收件箱通知。
  • 自定义属性:由你自行命名的字段,例如发布日期或团队。可从以下类型中选择:Text、Number、Date、Person、Select、Multi-select、URL 和 Checkbox。
要添加属性,你必须拥有编辑者或管理员角色。要为私有页面添加属性,你必须在该页面上拥有 Editor 或 Full Access 角色。任何可以打开页面的人都能看到其属性。
  1. 在编辑器中打开页面。
  2. 将鼠标悬停在页面标题上方,以显示 Page properties 菜单。
  3. 要添加负责人,请选择 Owner 并选择一位同事。
  4. 要添加自定义属性,请选择 New property 并选择一种类型。
有值的属性会显示在页面标题下方。你也可以在 Page settings 面板的 Properties 部分查看和添加属性。

Git 中的验证和属性

编辑器会将页面的验证状态写入 verification frontmatter 键,并将其负责人和属性写入 metadata 键。
Example verification frontmatter
要通过编辑文件更改页面状态,请将 verification.status 设置为 verified、outdated 或 not_verified。对于已验证的页面,请将 expiresAt 设置为验证结束的时间,格式为 ISO 8601 日期和时间。如果省略 expiresAt,页面将无限期保持已验证状态。 如果你通过编辑文件更改页面状态,编辑器不会显示是谁验证了该页面,也不会有人收到收件箱通知。 metadata 键通过 Mintlify 用户 ID 引用同事。请在编辑器中编辑负责人和属性。