# Developer 组织


Organization（组织）是同事共同管理活动、课程、数据和资金的工作范围。你用个人账号登录，再以当前组织的 Owner（所有者）、Admin（管理员）或 Member（成员）身份工作。

## 创建新组织，还是加入已有组织？

活动邀请码或推荐码不是组织成员邀请。同事已经在某个组织管理这项工作时，请向那个组织的 Owner 或 Admin 申请加入**原组织**。

要为自己的工作建立独立组织，登录后进入[组织创建页](https://developer.humanbased.ai/onboarding)。填写组织名称和 URL slug，等两项可用性检查都通过，再选择 **Create organization**（创建组织）。组织在这一步立即创建并生效。

名称或 slug 已被占用或受保护时，换用你有权使用的组织身份。你代表该组织、且页面提供 **Apply to claim this identity**（申请认领这个身份）时，可以提交官方域名、公开证明链接和说明，等待审核。

创建后，页面进入 **Invite Team**（邀请成员）这一步：可以填写同事邮箱发出邀请，也可以先进入 Dashboard。配置资源前，先到 **Members**（成员）核对新组织和自己的角色。

## 查看并切换当前组织

Developer 左下角的账户区域显示你的名字和当前组织名称。点开它，选择 **Organization**（组织）。先核对组织名称，再去编辑活动、创建 Key 或查看账单。

在 **Members** 页签，你自己的那一行带有 **(You)**（你）标记。这一行的 **Role**（角色）和 **Permissions**（权限范围）就是你在当前组织的身份。

| 角色 | 成员列表显示的范围 |
| --- | --- |
| Owner | Full access（全部权限）；General 中受限的组织设置由 Owner 修改 |
| Admin | Campaigns、Data、Agents |
| Member | Campaigns、Data |

具体动作仍有各自的权限检查。**General**（基本信息）页签显示 **Only the owner can change these settings**（只有 Owner 可以修改这些设置）时，请当前组织的 Owner 处理。角色按组织分别设定，你在另一个组织的角色只在那个组织有效。

### 切换到另一个组织

账号属于多个组织时，账户菜单顶部会列出这些组织。每一行显示组织名称和你在其中的角色，当前组织带有对勾。

1. 点开左下角的账户菜单。
2. 选择要进入的组织。
3. 等页面重新加载，再核对账户区域显示的组织名称。

切换后，你看到的活动、Key 和账单都属于新选中的组织，各组织的资源仍留在原处。这次选择在本次登录期间有效，重新登录后会先进入你最近加入的那个组织。

列表里找不到目标组织，说明你的账号还没有加入它，请它的 Owner 或 Admin 邀请你。页面提示 **Couldn't switch organization — try again.**（切换失败，请重试）时，你仍在原来的组织。

## 个人资料与组织资料

| 页面 | 管理什么 | 谁能修改 |
| --- | --- | --- |
| **Account**（账户） | 你的姓名、邮箱和登录绑定 | 你本人 |
| **Organization → General**（组织 → 基本信息） | 组织名称、Slug、Logo 和账单联系信息 | Owner |
| **Organization → Public profile**（组织 → 公开主页） | 组织的对外介绍和主页可见性 | Owner |
| **Organization → Verification**（组织 → 组织验证） | 组织的法律主体信息和验证状态 | Owner |

**Public profile** 的可见性有两档：**Public**（公开）让任何人都能查看组织主页，**Hidden**（隐藏）让主页对外消失。用 **Preview as contributor**（以贡献者视角预览）核对贡献者会看到的介绍和链接。账单联系信息和成员记录只在组织内部可见。修改个人 **Account** 只影响你自己，组织资料保持原样。

## 受邀加入已有组织

你收到的可能是发到你邮箱的邮件邀请，也可能是同事转来的邀请链接。两者的完成方式不同，但都要先登录 Developer；账号还没有 Developer 使用资格时，先按[账户与登录](/zh/start/account)取得。

**邮件邀请。** 邮件里的链接会打开一个页面，标题是 **Join**（加入）加上组织名称。页面列出邀请人、拟授予的角色、受邀邮箱和到期时间。用受邀邮箱对应的账号登录，再选择 **Accept invitation**（接受邀请）。页面显示 **You're in**（已加入）后会进入 Dashboard。已经用受邀邮箱登录时，Developer 页面顶部也会出现同一份邀请，选择 **Accept**（接受）即可。

**邀请链接。** 链接打开同样标题的页面，按钮是 **Request to join**（申请加入）。选择后页面显示 **Request sent**（申请已提交），此时申请在等 Owner 或 Admin 处理。对方批准后你才成为成员，角色由批准的人选定。

| 你看到的提示 | 含义 | 你现在做什么 |
| --- | --- | --- |
| **Sign in to accept**（登录后接受） | 你还没有登录 | 用受邀邮箱登录，再接受邀请 |
| **This invitation is for a different account**（这份邀请是发给另一个账户的） | 你登录的是另一个邮箱 | 选择 **Sign in with that address**（用那个邮箱登录） |
| **This invitation has expired**（这份邀请已经过期） | 邀请的 7 天有效期已过 | 请 Owner 或 Admin 重新发送 |
| **This invitation is no longer valid**（这份邀请已经失效） | 邀请被撤销，或已被新邀请取代 | 打开最新的那封邮件，或请对方重新邀请 |
| **Request sent** 或 **Request already sent**（申请已提交过） | 申请在等 Owner 或 Admin 处理，你还不是成员 | 告诉给你链接的人，等待对方决定 |
| **This invitation was already used**（这份邀请已经使用过了）或 **You're already a member**（你已经是成员了） | 成员关系已经存在 | 打开 Dashboard，切换到这个组织 |

确认结果时，先看左下账户区域的组织名称；账号属于多个组织时，先切换到新组织。再打开 **Organization** 的 **Members** 页签，找到带 **(You)** 的那一行。这一行的 **Role** 应当与邀请方告诉你的角色一致。

组织还可以放行整个公司邮箱域名。页面提示你的邮箱域名与某个组织匹配时，选择 **Join** 并确认，你会以 Member 身份加入。

## 邀请成员与处理加入申请

Owner 和 Admin 在 **Organization** 的 **Members** 页签管理成员。Member 在这里只看到成员列表。

| 加入方式 | 谁来设置 | 新成员做什么 | 得到的角色 |
| --- | --- | --- | --- |
| 邮件邀请 | Owner 或 Admin，每次邀请一个邮箱 | 7 天内用受邀邮箱接受 | 邀请时选定的 Member 或 Admin |
| 邀请链接 | Owner 或 Admin，每个组织同时只有一个有效链接 | 提交加入申请，等待批准 | 批准时选定的 Member 或 Admin |
| 放行邮箱域名 | Owner，在 **Domains**（域名）页签 | 确认加入提示，无需审批 | Member |

### 用邮件邀请一个人

1. 在 **Invite team members**（邀请团队成员）区域填写对方的 **Email address**（邮箱地址）。
2. 选择要授予的角色：Member 或 Admin。
3. 选择 **Invite**（邀请）。

这个邮箱会出现在 **Pending Invitations**（待处理的邀请）里，并带有 **Pending**（待处理）标记。对方收到的邮件链接 7 天内有效，用受邀邮箱接受后才成为成员。

把鼠标移到这条待处理记录上，会出现两个按钮。**Resend**（重新发送）发出新链接，旧链接随即失效。**Revoke**（撤销）取消这次邀请。

### 分享邀请链接并处理申请

1. 在 **Invite link**（邀请链接）区域选择 **Generate invite link**（生成邀请链接），再选择 **Copy**（复制）。
2. 把链接发给需要申请加入的人。
3. 申请出现在 **Join Requests**（加入申请）后，核对申请人的姓名和邮箱。
4. 在这一行选择 Member 或 Admin，再选择 **Approve**（通过）；要驳回则选择 **Reject**（驳回）。

通过后，对方立即以你选定的角色出现在成员列表。拿到链接的人都能提交申请，所以链接传得太广时，用 **Regenerate**（重新生成）换一个，或用 **Revoke** 关闭它。旧链接随即失效。

### 核对结果

| 你在 Members 看到 | 含义 | 你现在做什么 |
| --- | --- | --- |
| **Pending Invitations** 里有一条 **Pending** 记录 | 邀请已发出，对方尚未接受 | 等对方接受，或用 **Resend**、**Revoke** 处理 |
| **Join Requests** 里有一条申请 | 有人用了邀请链接，还不是成员 | 选好角色，再选择 **Approve** 或 **Reject** |
| 对方出现在成员列表 | 成员关系已生效，角色见 **Role** 一列 | 请新成员在自己的页面核对同一个组织和角色 |
| 红色提示，例如 **We could not confirm invite delivery**（无法确认邀请是否送达） | 页面没能确认你刚才的操作 | 刷新后先查看提示里提到的列表，再决定是否重做 |

### 调整角色或移除成员

在成员列表中，用成员所在行的 **Role** 下拉框把对方改为 Member 或 Admin。要移除成员，把鼠标移到对方那一行，选择 **Remove**（移除），再选择 **Confirm**（确认）。两种变更都会用邮件通知对方。移除只结束对方在本组织的成员关系，个人账号仍然保留。对方创建过的 API Key 仍保持有效，请到 **API Keys**（API 密钥）逐一查看，撤销应当停用的那些。

你自己的那一行和 Owner 的那一行没有这些控件。Owner 身份只通过下文的 **Transfer ownership**（转让所有权）交接。

### 放行公司邮箱域名

**Domains** 页签只有 Owner 能看到。在 **Allowed email domains**（允许加入的邮箱域名）下输入公司域名，选择 **Add domain**（添加域名）。此后，用该域名的已验证邮箱登录的人会看到加入提示，确认后立即成为 Member。gmail.com 这类公共邮箱域名会被拒绝；列表留空时，按域名加入保持关闭。

## 组织验证影响什么

组织验证确认的是组织的法律主体身份。成员的角色保持原样。

验证由 Owner 在 **Organization** 的 **Verification** 页签提交。**Organization verification (KYB)**（组织认证（KYB））卡片需要三项信息：**Legal entity**（法律主体名称）、**Registry / tax number**（注册号 / 税号）和 **Registry country**（注册国家/地区）。

填好后选择 **Submit for review**（提交审核）。营业执照、登记文件等材料可以在 **Supporting documents**（证明材料）上传。卡片随后显示 **In review**（审核中），审核结束后显示 **Verified**（已认证），或显示 **Rejected**（已驳回）和审核人给出的原因。

验证结果对业务的影响如下。从账户菜单打开 **Trust**（信任与合规）页面，可以看到每一项的当前状态。

| 你要做的事 | 需要什么 | 在哪里核对 |
| --- | --- | --- |
| 开展固定奖励、公开数据的标准活动 | 无需组织验证 | **Trust** 页面的 **What each level unlocks**（各等级分别解锁什么）区域，**Standard campaigns**（标准活动）标为 **Now**（当前） |
| 发布 **Data Assets**（数据资产）或 **Agents**（智能体） | 组织已通过验证，并且信任等级达到 L3 且保持 30 天 | **Trust** 页面的 **Publishing + expert work**（发布与专家级任务）卡片会写明还差哪一项 |
| 在组织名称旁向贡献者显示已验证标记 | 组织已通过验证 | **Public profile** 页签的 **Publisher panel**（发布方面板）中 **Verification** 一行 |

通过验证不等于资产已经发布。信任等级是另一项条件，每个资产还要走自己的发布步骤。

### 通过 GitHub 或 Hugging Face 验证

**External verification**（外部认证）连接你在 GitHub 或 Hugging Face 上的组织，把对方的认证标记作为本组织的域名验证证明。选择 **Connect**（连接），登录对应平台并选择组织；只能连接你在该平台担任管理员的组织。每个连接显示 **Verified**（已认证）或 **Not verified on**（未在该平台验证），**Disconnect**（解除关联）可以移除连接。

<a id="campaign-roles"></a>
## 活动角色与访问

每个活动有自己的角色，与组织角色分开。活动设置中的 **Team & access**（团队与权限）显示你的角色：

| 角色 | 可以做什么 |
| --- | --- |
| **Owner**（所有者） | 发布、暂停、结束、充值和删除活动，并管理谁有访问权限 |
| **Editor**（编辑者） | 修改简介、工作流、奖励和设置，并审核提交 |
| **Viewer**（查看者） | 查看活动信息 |

组织成员可以申请编辑某个活动，申请出现在 **Access requests**（访问申请）中，由 Owner 选择 **Grant**（授予）或 **Decline**（拒绝）。**Grant** 授予的是对方申请的角色，按钮上会写明。要授予其他角色，先拒绝申请，再用 **Add a collaborator**（添加协作者）选择角色添加。要直接加人，使用 **Add a collaborator**（添加协作者），填写对方登录用的邮箱；对方必须已经在该活动所属的组织中。

## 退出、转让所有权与删除组织

这三件事结束的对象不同，动手前先分清你要做的是哪一件。

| 操作 | 谁能做 | 会改变什么 | 动手前先确认 |
| --- | --- | --- | --- |
| **Leave organization**（退出组织） | Admin 或 Member | 只结束你的成员关系；活动、数据、Key 和账单都留在组织里 | 手上的工作由谁接手；你创建过哪些 API Key，之后由谁管理 |
| **Transfer ownership**（转让所有权） | Owner | 接收人接受后成为 Owner，你变为 Admin；组织的其他内容保持原样 | 接收人已是成员并且同意接手；对方清楚要接管的账单联系信息、资金和 Key |
| **Delete organization**（删除组织） | Owner | 永久删除组织，全部成员、Key、订阅和账单数据一并删除 | 没有运行中的活动或程序还依赖它；需要的对账单和回执已保存；已就剩余余额询问[支持团队](mailto:hello@humanbased.ai) |

### Admin 或 Member 退出

打开 **Organization** 的 **General** 页签，找到 **Leave organization** 区域。选择 **Leave organization**，再选择 **Confirm**。退出后，页面进入你所属的另一个组织；这是你唯一的组织时，页面显示 **No organization**（没有组织）。

你创建的 API Key 在你退出后仍保持有效，直到 Owner 或 Admin 撤销。退出前先撤销已经停用的 Key，其余的交代给 Owner 或 Admin，做法见[创建和使用 API Key](/zh/api/api-auth)。以后想回到这个组织，需要重新获得邀请或批准。

Owner 在同一位置看到的是一行提示：**As the owner you must transfer ownership before you can leave this organization.**（你是所有者，退出组织前需要先转让所有权）

### Owner 转让所有权

1. 先在 **Members** 确认接收人已经是成员；对方还没有加入时，先邀请对方。
2. 打开 **Organization** 的 **General** 页签，找到 **Transfer ownership** 区域。
3. 在 **Select a member…**（选择一位成员）中选定接收人。
4. 按上方 **Name**（名称）字段当前显示的内容逐字输入组织名称，再选择 **Transfer ownership**。大小写和空格都要一致；**Name** 尚未保存的改动也会改变需要输入的内容。
5. 请接收人打开 Developer。页面顶部会出现接管所有权的提示，对方在 7 天内选择 **Accept** 或 **Decline**（拒绝）。
6. 对方接受后，双方都到 **Members** 核对：接收人是 Owner，你是 Admin。

接收人接受之前，你仍是 Owner，这个区域显示 **Transfer pending**（转让待接受）。刚发起时，这里提供 **Cancel transfer**（取消转让）。之后若看不到这个按钮，请接收人选择 **Decline**，因为同一时间只能有一个待处理的转让。超过 7 天后，**Accept**、**Decline** 和 **Cancel transfer** 都不再生效，而这条记录仍然占着那唯一的位置，组织无法重新发起；这种情况带上组织名称和接收人邮箱联系 [支持团队](mailto:hello@humanbased.ai)，由支持团队清除这条记录。

### Owner 删除组织

**General** 页签的 **Danger zone**（危险操作）区域里有 **Delete organization**。它不是退出组织或排查权限问题的办法：删除会让所有成员失去这个组织。确定要删除时，选择 **Delete organization**，输入与 **Name** 字段完全一致的组织名称，再次选择 **Delete organization**。删除后无法恢复。

关闭个人账号是另一件事，与以上三项分开处理。

页面结果与这里的说明不一致时，带上组织名称和当前提示联系[支持团队](mailto:hello@humanbased.ai)。新工作、课程、数据和账务的入口见[从数据需求开始](/zh/start/developer-start)。