在 `fastapi-amis-admin` 中，`AdminGroup` 是用于组织和管理页面导航分组的重要概念。它可以帮助开发者将多个相关的管理页面进行分类展示，从而提升后台系统的可维护性和用户体验[^1]。 要实现 `AdminGroup` 的使用，首先需要定义一个或多个继承自 `AdminGroup` 的类，并为其设置合适的标签（label）和图标（icon）。然后，在 `AdminApp` 中通过 `register_admin_group` 方法注册这些分组。接下来，可以将具体的页面类（继承自 `PageSchemaAdmin`）注册到对应的 `AdminGroup` 中，以实现页面的分类展示。 以下是一个完整的示例代码： ```python from fastapi_amis_admin import amis, admin # 定义 AdminGroup 子类 class UserGroup(admin.AdminGroup): label = "用户管理" icon = "fa fa-user" class ProductGroup(admin.AdminGroup): label = "产品管理" icon = "fa fa-product-hunt" # 假设已经有一个 AdminSite 实例 app app = admin.AdminSite() # 注册 AdminGroup 到 AdminApp app.register_admin_group(UserGroup) app.register_admin_group(ProductGroup) # 定义具体的 PageSchemaAdmin 页面类 class UserListAdmin(admin.PageSchemaAdmin): group = UserGroup # 指定该页面属于 UserGroup 分组 label = "用户列表" page_schema = amis.PageSchema(label="用户列表", icon="fa fa-list") async def get_page(self, request): return amis.Page(title="用户列表", body="这里是用户列表页面") class ProductListAdmin(admin.PageSchemaAdmin): group = ProductGroup # 指定该页面属于 ProductGroup 分组 label = "产品列表" page_schema = amis.PageSchema(label="产品列表", icon="fa fa-list") async def get_page(self, request): return amis.Page(title="产品列表", body="这里是产品列表页面") # 将页面注册到 AdminApp 中 app.register_admin(UserListAdmin) app.register_admin(ProductListAdmin) ``` 在上述示例中，首先创建了两个 `AdminGroup` 的子类 `UserGroup` 和 `ProductGroup`，并分别为它们设置了标签和图标。接着，定义了两个 `PageSchemaAdmin` 的子类 `UserListAdmin` 和 `ProductListAdmin`，并通过 `group` 属性指定了它们分别属于哪个 `AdminGroup`。最后，将这些页面注册到 `AdminApp` 中，这样它们就会按照所属的分组在后台应用中显示出来。 此外，如果页面涉及权限控制，可以通过 `router` 获取用户对象，并利用 `user.has_perm` 函数来验证用户是否拥有访问特定页面所需的权限。默认情况下，页面会要求 `${prefix}_list` 格式的权限名称[^2]。