团队与成员

团队是 Clouisle 的资源隔离边界：Agent、工作流、知识库、工具、Skill 都归属某个团队。团队内的一切操作都要同时通过「全局角色权限」和「团队成员角色」两层检查。

本页覆盖团队的创建、成员增删改、离开、所有权转让、删除，以及每步失败时看到什么。角色权限的完整模型见角色与权限与权限与角色参考。

创建团队

1. 进入 Admin → Teams。
2. 点击 Create Team，填写：
   • Team Name（必填，全局唯一，重名时提示团队名已存在）
   • Description（可选）
   • Team Avatar（可选，从本地上传图片，支持 JPEG/PNG/GIF/WebP/SVG/ICO，建议 200×200、上限 10 MB）
3. 保存。

创建者自动成为该团队的 owner。

创建后在团队切换器里选择它。新建 Agent、工作流、知识库时确认当前团队，否则资源会落到错误的团队里，后续只能靠重建来纠正。

两个团队界面

团队切换器提供两个入口，权限与能力完全不同：

/app/team 页面的模型授权页签是只读的：展示当前团队已授权的模型、启用状态与今日用量/限额，并提示由系统管理员分配。模型授权的写操作全部要求超级管理员（见下）。

团队详情与成员

团队概览

/app/team 头部显示团队头像、名称、默认团队徽标以及你在该团队内的角色徽标。成员页签列出头像、用户名、邮箱与角色，并支持按用户名/邮箱本地过滤。

模型授权

模型授权是超级管理员专属能力：团队成员只能查看，授权、批量授权、修改配额、撤销都由管理员在 Admin → Teams 的团队详情里完成，或在管理当前团队的模型授权页签查看结果（该页签只读）。

可配置项包括每日/每月 Token 上限、每日/每月请求上限、启用状态与优先级。授权或撤销会向团队发送站内通知。细节见管理团队模型。

添加成员

1. 打开 /app/team 的成员页签，点击 Add Member（仅在有管理能力时显示）。
2. 在「用户名或邮箱」输入目标用户的完整用户名或邮箱。
3. 选择角色：Admin、Member、Viewer（不提供 Owner）。
4. 确认。

匹配规则与校验：

添加成功后：新成员收到团队通知，团队也收到一条汇总通知；成员身份立即生效，没有邀请/接受流程。

改变成员角色

1. 在成员列表找到目标成员，打开 ... 菜单。
2. 选择 Change Role，在新角色下拉中选 Admin / Member / Viewer。
3. 保存。

校验规则：

变更成功后目标用户收到通知。

界面还会额外隐藏按钮：你不能操作自己，团队 Admin 也看不到其他 Admin 与 Owner 的操作菜单。

移除成员

共同限制：Owner 永远不能被移除（包括自己）；目标不是成员时会提示成员不存在。

移除后：该用户立即失去该团队全部资源访问权限；只删除团队成员关系，不会删除他的对话、API 密钥或个人资源（对话因失去团队访问权而不可再访问）。团队与被移除者都会收到通知。之后可以重新添加。

离开团队

1. /app/team → Settings 页签 → 危险区域，点击 Leave Team。
2. 在确认对话框中确认。

离开后你失去该团队资源访问权；已有对话保留。团队列表会刷新，页面跳回 /app。

转让所有权

1. 打开 /app/team 成员列表，找到目标成员，... → Transfer Ownership（该菜单项只有 Owner 能看到）。
2. 确认对话框点击确认。

规则（按顺序执行）：

1. 目标必须是该团队成员，否则提示成员不存在。
2. 目标必须已经持有全局团队管理权限，否则操作被拒。同样地，先给全局角色，再转让。
3. 目标就是当前 Owner → 操作被拒。
4. 原 Owner 的成员角色被降级为 Admin，目标的成员角色改为 Owner。
5. 新旧 Owner 各收到一条通知。

编辑团队信息

需要团队管理权限且在该团队内是 Owner/Admin。

• /app/team → Settings 页签：可改团队名称、描述、头像（未通过校验时输入框禁用）。
• 管理台 Admin → Teams 的编辑对话框：同一批字段，需要管理台的团队修改权限。

字段与约束：名称必填且全局唯一（重名时提示团队名已存在）；描述可选；头像由上传组件写入。没有团队 slug、别名、域名等字段。

删除团队

1. 在团队列表点击目标团队的 ... → Delete Team（默认团队不显示该项）。
2. 确认对话框点击确认——对话框只要求确认，不需要输入团队名。
3. 默认团队会被拒绝：默认团队不能删除。

删除影响：

团队角色与权限

团队角色是四个固定值 Owner / Admin / Member / Viewer，不单独携带权限清单，只作为团队门限。实际能力是全局角色权限与团队门限的交集。

门限规则

• 团队管理类动作（改团队信息、管理成员、删除工具等）必须同时具备对应的全局权限且在该团队内是 Owner/Admin。
• 团队 Viewer 只能查看与执行（对话、运行工作流、检索知识库、执行工具与 Skill），其余写操作一律被拒绝。
• 超级管理员直接绕过成员关系与团队门限。

团队管理权限

团队内资源权限

默认团队角色

站点设置中可以指定默认团队与默认成员角色，默认角色只接受 Viewer / Member / Admin（其他值回退为 Member，默认值也是 Member）。新用户注册与 SSO 自动创建时生效，已存在的成员关系不会被覆盖。Owner 永远不会被自动分配。

自定义团队角色

未实现。 团队只有 Owner、Admin、Member、Viewer 四个固定角色，每个角色对应一组固定门限规则，不能为单个团队增删权限。需要精细权限时改用全局自定义角色（见角色与权限）。

团队协作与通知

团队协作通过共享资源实现：Agent、工作流、知识库、工具、Skill 在团队内共享，成员按角色门限访问。工作流执行历史对团队成员可见（受权限约束），可以看到谁在何时运行过。

团队相关自动通知（发送渠道由管理员在站点设置里配置，见通知与外部渠道）：

未实现 / Roadmap：没有按团队的通知配置，没有 @提及、共享对话、团队活动流、文档评论或团队内消息。

故障排除

无法访问团队资源

1. 确认左侧团队切换器选中了正确的团队。
2. 确认你是该团队成员（能打开 /app/team 说明是）。
3. 确认全局角色具备所需能力；团队 Viewer 只能读与执行。
4. 确认资源是否私有：私有资源对非创建者不可见，会被拒绝访问。

无法改变角色 / 菜单里没有「Change Role」

• 只有 Owner（或超级管理员）能改角色。
• 界面还会隐藏：你不能操作自己，团队 Admin 看不到其他 Admin 与 Owner 的操作菜单。
• 目标是 Owner 时不可改，要换人只能转让所有权。
• 想把某人升为团队 Admin，他必须已有全局团队管理权限。

加成员提示用户不存在

输入必须是完整用户名或完整邮箱（邮箱忽略大小写）。片段、昵称、显示名都匹配不到——系统不做模糊搜索。

加成员被拒绝

角色选了 Admin，但目标用户没有全局团队管理权限。先给他 Team Admin 全局角色，再设为团队 Admin。

转让所有权被拒

• 你不是 Owner（也不是超级管理员）。
• 目标不是团队成员，先加成员。
• 目标没有全局团队管理权限。
• 目标已经是 Owner。

无法离开团队 / 没有离开按钮

Owner 不能离开，默认团队也不显示该按钮。先转让所有权；默认团队需要管理员先在站点设置里改默认团队。

无法删除团队

• 入口只在管理台 Admin → Teams，需要管理台的团队删除权限。
• 默认团队不能删除。

角色变更后权限没变

浏览器缓存的前端权限快照可能过期：刷新页面或重新登录即可。后端每次请求实时判定，不需要等缓存过期。

相关文档

• Teams API — 端点、请求/响应结构与错误码
• 权限与角色参考 — 权限目录与角色矩阵
• 角色与权限 — 全局角色、团队门限与失败排查
• 用户管理 — 用户账户与全局角色指派
• 管理团队模型 — 模型授权与配额