用户分组管理：高效组织团队访问权限

当团队人数增长到一定规模，逐个管理用户的分享权限就会变得非常繁琐。MarkStackAI 的用户分组功能应运而生——它允许你将用户组织成逻辑分组，然后在分享页中一键导入整组成员。本文将详细介绍分组管理的完整流程和实际应用场景。

理解用户分组

用户分组是一种将多个用户名组织在一起的逻辑容器。它的核心目的是简化分享页的访问控制管理。创建分享页时，你可以从现有分组中一键导入全部成员到用户白名单，而不需要逐个搜索和添加用户名。

分组的关键特性：

• 基于用户名关联：分组成员通过用户名而非用户 ID 关联。这意味着你可以提前将尚未注册的用户名添加到分组中——当该用户注册后，自动获得分组对应的权限
• 多分组归属：一个用户可以同时属于多个分组，分组之间不互斥
• 独立于角色系统：分组用于管理分享页的访问范围，与系统角色（管理员/编辑者等）是两套独立的机制
• 管理员集中管理：分组的创建和成员管理在管理后台中进行，普通用户无法自行创建分组

创建和管理分组

在管理后台创建分组

管理员进入管理后台（AdminView），向下滚动到「分组管理」区域。操作步骤：

1. 创建新分组
   点击「新建分组」按钮，输入分组名称（如「前端团队」「产品组」「外部合作方」）并确认。分组名称建议简短且具有辨识度。
2. 添加成员
   点击分组右侧的「管理成员」按钮，打开成员管理对话框。在搜索框中输入用户名或昵称，系统会实时搜索匹配的已注册用户，展示头像、用户名和昵称。选择要添加的用户即可。
3. 批量设置成员
   你也可以使用批量设置功能，直接输入用户名列表来覆盖分组的全部成员。这在初始化大分组时非常高效。
4. 移除成员
   在成员列表中，每个成员右侧有移除按钮。移除操作会立即生效，但不会影响该用户已经获得的分享页访问权限——只是下次从分组导入时不会再包含该用户。

预添加未注册用户

分组成员是基于用户名字符串关联的，这意味着你可以提前规划好团队成员的用户名，将它们添加到分组中。当这些用户将来注册账号（使用对应的用户名）时，他们会自动被分组中已导入的分享页白名单所覆盖。

注意：预添加用户名时需要确保与将来实际注册的用户名完全一致。建议提前与团队成员确认用户名。

在分享页中使用分组

从分组导入到白名单

当你在分享管理页面创建或编辑分享页时，对话框底部会显示所有可用的分组列表。点击分组名称，该分组的全部成员用户名会立即被导入到当前分享页的「允许访问的用户」列表中。

导入行为是追加式的——如果白名单中已有部分用户名，导入分组不会覆盖它们，只会添加分组中尚未在列表中的用户名。这让你可以安全地从多个分组导入，而不会丢失手动添加的用户。

多分组叠加

一个分享页的白名单可以从多个分组导入。例如，一个跨团队项目的分享页可以同时导入「前端团队」和「设计团队」两个分组的成员，然后再手动添加几个特定的外部合作者用户名。

实际应用场景

分组管理的最佳实践

命名规范

制定统一的分组命名规范可以让管理更加清晰。推荐的命名模式：

• 部门分组：使用部门名称，如「工程部」「产品部」「运营部」
• 项目分组：使用项目名加前缀，如「P-重构计划」「P-新版官网」
• 角色分组：使用角色描述，如「技术评审」「管理层」
• 外部分组：使用「外部-」前缀，如「外部-客户A」「外部-设计外包」

定期审查

建议每月或每季度审查分组成员：移除已离职的成员、更新项目分组的人员变动、清理不再使用的临时分组。保持分组的准确性是访问控制有效性的基础。

与直接分享配合使用

分组适合管理长期、稳定的访问关系。对于临时的一次性分享，直接使用书签分享功能更为便捷。两种方式结合使用，可以覆盖团队协作中的各种分享需求。

API 接口参考

分组管理的所有功能也可以通过 API 调用实现，方便与其他系统集成：

GET    /user-groups              # 获取所有分组列表
POST   /user-groups              # 创建新分组
DELETE /user-groups/{id}         # 删除分组
PUT    /user-groups/{id}/members # 批量设置分组成员
POST   /user-groups/{id}/members # 添加成员
DELETE /user-groups/{id}/members # 移除成员

所有分组 API 端点都需要管理员权限认证。成员操作支持批量处理，一次请求可以添加或移除多个用户名。