组织
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
什么是组织?
“什么是组织?”章节通过组织,您可以在与团队共享应用的同时,精确控制每个人的权限。每个 Capgo 账户都至少属于一个组织,您可以根据需要创建多个组织。
访问权限通过以下方式进行管理: 基于角色的访问控制 (RBAC)。每位团队成员都会被分配一个角色(可在组织级别或针对特定应用进行授权),从而决定其可见内容和操作权限。此外,您还可以通过针对特定 Channel 的权限覆盖来实现更精细的访问控制。
组织设置概览
“组织设置概览”章节
点击以下图标即可进入组织设置页面: 设置 位于左侧边栏,然后选择顶部的 组织 选项卡。在此,您可以切换至以下板块:
| 选项卡 | 描述 |
|---|---|
| 常规 | 查看并编辑组织名称、Logo 及管理邮箱 |
| 成员 | 管理团队成员及其权限 |
| 分组 | 创建并管理用户组,实现批量角色分配 |
| API 密钥 | 管理用于编程访问的 API 密钥 |
| 套餐 | 查看并管理你的订阅计划 |
| 额度 | 查看并购买额外额度 |
| 安全 | 配置安全策略(2FA、密码要求) |
| 使用情况 | 监控组织的用量统计数据 |
| 审计日志 | 查看组织的活动日志 |
| Webhooks | 配置 Webhook 集成 |
| 计费 | 管理账单信息与发票 |
如何切换组织
标题为“如何切换组织”的章节点击 组织选择器 侧边栏左上角的下拉菜单,用于查看并切换你有权访问的组织。
管理成员
标题为“管理成员”的章节查看成员
“查看成员”章节
Members 章节会列出所有拥有组织访问权限的用户,并显示其:
- 成员• 头像与姓名
- 角色• 当前角色(Super Admin、Admin、Billing Manager 或 Member)以及 活跃 或 待处理 状态标签
- 操作: 编辑角色、管理应用级权限或将其从组织中移除
活跃成员按角色优先级排序。待处理的邀请将显示橙色 待处理 徽章。
邀请成员
标题为“邀请成员”的区块- 点击 + 添加 Members 区块中的按钮
- 一套 选择角色 将弹出模态框 — 请为新成员选择组织级角色:

可选的组织级角色如下:
- 成员 — 只读权限
- 账单管理员 — 仅账单权限
- 管理员 — 完全管理权限(不可管理账单或删除)
- 超级管理员 — 最高控制权限
- 点击 确认,然后填写邀请表单(邮箱、可选的姓氏/名字、验证码)并点击 发送邀请.
受邀用户将收到一封包含魔术链接的邮件。接受邀请后,他们将以所选角色加入该组织。
分配应用级角色
“分配应用级角色”章节除了组织级角色,您还可以通过更精准的角色,授予成员对特定应用的访问权限。点击 访问控制 成员旁边的按钮(盾牌图标)以打开应用访问弹窗:

通过此弹窗,您可以:
- 搜索并选择应用
- 从下拉菜单中选择应用级角色

可用的应用级角色包括:
- 应用管理员 — 应用的全权管理权限
- 应用开发者 — 可上传 bundle、管理设备,但无法执行破坏性操作
- App 上传器 — 读取应用数据并上传 bundle
- App 阅读器 — 应用的只读访问权限
- 点击 分配 以授予该角色。
编辑成员角色
标题为“编辑成员角色”的部分点击成员旁边的编辑按钮(扳手图标)来更改其组织级角色。随后 选择一个角色 将弹出模态框,并预选当前角色。
限制条件:
- 您无法更改组织创建者的角色
- 您无法移除最后一位 Super Admin —— 组织内必须始终至少保留一位
- 提升或降级 Super Admin 的权限需要您本人也是 Super Admin
移除成员
“移除成员”章节
点击成员旁边的删除按钮(垃圾桶图标)。随后会弹出确认对话框,提示此操作不可逆。点击 删除 以确认。这会立即撤销该成员对组织、其应用和 channel 的所有访问权限。
角色概览
“角色概览”章节Capgo 使用 基于角色的访问控制 角色按作用域划分。您可以在 组织 层级(拥有全部访问权限)分配角色,也可以将作用域缩小到单个 应用. 您可以通过针对特定 Channel 的权限覆盖来进一步自定义访问权限。
组织角色
“组织角色”章节在邀请成员时分配。这些权限适用于整个组织。
| 角色 | 内部名称 | 描述 |
|---|---|---|
| 超级管理员 | org_super_admin | 完全控制权 — 包含账单、删除和转让。组织创建者将自动获得此权限。 |
| 管理员 | org_admin | 完全管理权 — 管理成员、App 和 Channel。不具备账单和删除权限。 |
| 账单管理员 | org_billing_admin | 仅限账单 — 查看/更新付款、发票及账单审计。无法访问应用或成员。 |
| 成员 | org_member | 对整个组织及其所有应用拥有只读权限。 |
App 角色
“应用角色”章节权限范围仅限单个应用。当团队成员仅需负责某个特定应用而非整个组织时,请使用此类角色。
| 角色 | 内部名称 | 描述 |
|---|---|---|
| 应用管理员 | app_admin | 拥有单个应用的完全控制权 — 频道、设备及团队。无法删除或转移该应用。 |
| 应用开发者 | app_developer | 上传 bundle、管理设备、触发 build 以及更新 channel。无法删除或更改设置。 |
| App 上传器 | app_uploader | 具备读取权限 + 上传新的 bundle 版本。 |
| App 阅读器 | app_reader | 只读权限 — 查看统计数据、bundles、channels、logs 和 devices。 |
频道权限覆盖
“Channel 权限覆盖”章节By default, channel access is inherited from the app role. You can override specific channel permissions per user or group — for example, allowing an App Reader to also associate bundles on the staging channel 上关联 bundles。请参阅 应用级访问管理 下文了解如何进行配置。
每个 App 都有一个专属的 访问权 标签页,您可以在此处管理用户对 App 的访问权限及其操作范围——包括 App 角色和针对特定 Channel 的权限覆盖。
查看 App 访问权限
“Viewing app access”章节
导航至您的应用并点击 访问权 选项卡。访问列表会显示每个用户或组及其:
- 邮箱 — 用户邮箱(或组名)
- 角色 — 应用级角色(App Admin、App Developer、App Uploader 或 App Reader)
- 授予时间 — 角色分配的时间
- 操作 — 频道权限(盾牌图标)、编辑角色(扳手图标)以及移除(垃圾桶图标)
更改应用角色
“更改应用角色”章节点击 编辑 用户旁边的按钮(扳手图标),用于更改其应用级角色:

选择新角色并点击 确认。可选角色如下:
- 应用开发者 — 可上传 bundle、管理设备,但无法执行破坏性操作
- App 上传器 — 可读取应用数据并上传 bundle
- App 阅读器 — 只读权限
覆盖 channel 权限
标题为“覆盖 channel 权限”的章节点击 channel 权限 用户旁边的按钮(盾牌图标),用于覆盖其默认的 Channel 权限:

该模态框显示用户当前的 App 角色,并列出所有 Channel 及其可单独覆盖的三项权限:
| 权限 | 描述 |
|---|---|
| 读取 | 查看 Channel 及其当前 Bundle |
| 历史记录 | 查看 Bundle 分配历史 |
| 关联 Bundle | 设置或更改该 Channel 的当前 Bundle |
每项权限默认设为 默认(允许) — 表示它继承自应用角色。你可以将任意权限显式改为 允许 或 拒绝 针对特定 channel,让你无需更改用户的整体应用角色即可精细控制。
分组让你可以一次性为一组用户分配角色,而不用逐个管理成员。分组属于一个组织,可在任意范围(组织或 app)持有角色绑定。
示例: 创建一个“QA Team”分组,并为其分配 应用开发者 在您的生产应用中拥有特定角色,该组的所有成员都会立即获得该应用的 Developer 权限。当成员加入或退出团队时,只需将其从组中添加或移除即可 —— 无需修改单个角色的绑定关系。
分组机制
标题为“分组工作原理”的章节- 分组是指 组织范围内的 —— 它属于一个组织,不能跨越多个组织。
- 您为分组分配角色的方式与为用户分配角色相同 —— 该分组在角色绑定中作为一个主体出现。
- 当检查用户的权限时,系统会自动解析其所属的所有分组。如果其任何一个分组拥有的角色具备所需的权限,则授予访问权限。
- 用户可以属于多个分组,所有分组的权限将会合并。
查看分组
标题为“查看分组”的章节
前往组织设置中的 分组 选项卡。分组列表显示了每个分组的 名称, 描述, 角色, 创建日期,以及 操作 (编辑或删除)。
创建分组
标题为“创建分组”的部分点击 + 添加 打开创建分组页面的按钮:

填写以下内容:
- 名称 (必填)以及 描述 (可选)
- 组织角色 — 可选:分配组织级角色(None、Admin、Billing Manager 或 Member)
- 访问控制 标签页 — 通过点击来分配应用级角色 + 添加应用,选择一个应用并指定角色(例如 App Uploader、App Developer)
您需要 超级管理员 或 管理员 创建分组。
管理组成员
标题为“管理组成员”的章节点击分组以打开详情视图。切换到 成员 标签页:

在这里可以查看当前成员及其邮箱。点击 + 添加 即可添加成员:

弹窗中会显示所有组织成员。按姓名搜索,勾选要添加的成员,然后点击 添加成员.
仅 超级管理员 (org_super_admin) 以及 账单管理员 (org_billing_admin) 可管理账单。订阅方案与组织绑定,而非您的个人账户。
常见问题
标题为“FAQ”的部分我可以创建多个组织吗?
标题为“我可以创建多个组织吗?”的章节可以。您可以根据需要创建任意数量的组织,并使用侧边栏中的组织选择器进行切换。
如何配置安全策略?
标题为“如何配置安全策略?”的章节超级管理员可以在以下位置配置 2FA 强制执行、密码策略以及 API 密钥安全 安全 标签页。查看 组织安全 详情。
我可以只给某人一个 App 或 Channel 的访问权限吗?
标题为“我可以只给某人一个 App 或 Channel 的访问权限吗?”的章节可以 —— 为其分配应用级角色(例如 应用开发者 或 App 阅读器),可通过 Members 页面或应用的 Access 标签页操作。你还可以按 channel 进一步微调其访问权限,使用 渠道权限覆盖。请参阅 访问控制参考 查看完整角色列表。
Admin 和 App Admin 有什么区别?
章节标题:“Admin 和 App Admin 有什么区别?”管理员 (org_admin) 拥有整个组织的最高权限 —— 涵盖所有 App、所有 Channel 以及所有成员。 应用管理员 (app_admin) 拥有同级别的控制权,但仅限于特定的 App 及其 Channel。如果你想在不授予组织其他部分访问权限的情况下,委派某个 App 的完整控制权,请使用 App Admin。
继续探索组织设置
标题为“继续探索组织设置”的章节如果你正在使用 组织 要规划 dashboard 和 API 操作,请将其连接到 API 概览 关于 API Overview 中的实现细节, 简介 关于 Introduction 中的实现细节, API 密钥 有关 API Keys 的实现细节, 设备 有关 Devices 的实现细节,以及 Bundle 有关 Bundles 中的实现细节。