跳转到主要内容
文档协作团队管理

团队与成员

创建团队、邀请成员、共享工作流与凭据、移交所有权。

Team 是 Braidrun 里的协作单位 —— 几个人一起维护同一批工作流、共享凭据、互相审批。这一页讲怎么建团队、邀请成员、迁移资源。

谁能用 Team

Team 功能从 Team 套餐开始可用。Free / Pro 套餐下你始终是「个人工作区」。可以在 订阅与定价 页查看套餐对比。

一张图看明白结构

  • 一个账号可以属于 多个 Team；在 UI 右上角下拉切换当前 Team。
  • 每个 Team 有自己独立的：
    • 工作流列表
    • 模板 / 模块库（自己 Promote 出来的模块共享给团队）
    • 凭据命名空间
    • 调度 / Webhook
    • 成员名单与权限
    • 执行历史 + 审计日志
    • 通知设置
    • 订阅与配额

创建团队

  1. 左侧导航「团队」→ 右上角「新建团队」。
  2. 填名称（其他成员会看到）、slug（URL 一部分）、描述。
  3. 选择套餐 —— 从当前账号已购买的套餐里选，或点"升级套餐"先买一个。
  4. 创建者自动成为 Team Owner。

邀请成员（邮件邀请，2026-04-27 起）

从 2026-04 起，邀请成员完全通过邮件而非 UUID 粘贴：

  1. Team 详情页 → 成员标签 → 「发送邀请」
  2. 填对方邮箱（一次一条；幂等：对同邮箱重发会复用 PENDING 邀请记录）+ 选预分配的角色
  3. 系统发邮件，包含一个 32 字节随机 token 的链接（256 bits 熵，不可枚举）
  4. 对方点链接 → 跳到 /teams/invitations/accept 兑换页
  5. 如果对方没登录，自动跳到登录页，登录后再回兑换页
  6. 兑换时系统校验：当前登录用户的邮箱必须与邀请邮箱（case-insensitive）一致 —— 转发的链接也不能被他人用
邀请的几个贴心细节
  • 对方邮箱还没注册 Braidrun？发出邀请后，对方点邮件链接会先跳到注册页并预填邮箱；注册完成后自动跳到兑换页。
  • 同一邮箱可同时被邀请到多个团队 —— 对方在 /teams/invitations/me 收件箱可以看到所有 PENDING 邀请。
  • TTL 默认 7 天，可在创建时改（最小 5 分钟，最大 30 天）；过期后 14 天宽限期内系统自动清理。
  • 可撤销：成员列表 → 邀请标签里找到 PENDING 邀请 → 撤销，链接立即失效。
  • 成员列表加了 ?enrich=true 模式 → 显示真实姓名 + 邮箱而不是 UUID。

用 API 创建邀请

curl -X POST 'https://braidrun.com/api/teams/{teamId}/invitations' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"email": "newmember@example.com"}'

对方端兑换：

curl -X POST 'https://braidrun.com/api/teams/invitations/accept' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"token": "<32-byte-token-from-email>"}'

角色分配

四种角色，从高到低：Owner / Admin / Editor / Viewer。具体每种角色能做什么见 权限与角色。

成员管理

在成员列表里，Admin 及以上可以：

  • 修改成员角色（降级 / 升级）
  • 移除成员（对方所有关联操作历史保留，但权限失效）
  • 看每个成员最近一次活跃时间
  • 看每个成员持有的凭据数量、创建的工作流数量
降级成 Viewer 之后

被降级的成员如果正在编辑某条 workflow，编辑锁会被强制释放，对方界面变成只读并弹 toast 提示。未保存的本地修改会丢失。

转移所有权

团队只能有一个 Owner。想把所有权转给别人：

  1. 团队设置 → 「转移所有权」。
  2. 选一个当前 Admin 作为新 Owner。
  3. 双因子验证 —— 需要当前 Owner 用邮箱或 TOTP 二次确认。
  4. 完成后当前 Owner 自动降级为 Admin；订阅账单归属也转移。

切换当前团队

右上角用户头像下拉 → 选择"当前团队"。切换后：

  • 侧边栏所有列表（工作流 / 凭据 / 调度 / 执行 / 审批）都重新加载到新团队的数据
  • URL 会带一个 team 参数，刷新后保留
  • 切换会把你已打开的工作流编辑器关闭（防止跨团队误改）

资源的跨团队移动

工作流移动到另一个团队

  1. 工作流详情页 → 设置 → "移动到团队"。
  2. 选目标团队 —— 你必须是目标团队的 Editor 以上角色。
  3. 系统校验工作流里引用的凭据是否在目标团队也存在同名的 —— 不存在的会被列出来让你选"跳过 / 建立同名凭据 / 取消移动"。
  4. 确认后工作流 + 历史 execution 一起迁移到新团队。

凭据的跨团队复制

凭据不能"移动"，只能"复制" —— 为了避免意外吊销原团队的权限。你会被要求重新输入值，然后创建一份同名凭据到目标团队。

团队审计

「团队设置 → 审计日志」记录所有变更：

  • 谁 / 什么时候 / 改了哪条工作流 / 哪个字段
  • 谁 / 什么时候 / 创建 / 删除 / 更新了哪条凭据
  • 谁 / 什么时候 / 发起 / 批准了哪条审批
  • 成员加入 / 退出 / 角色变更

审计日志保留 365 天（Team）/ 永久（Enterprise），支持 CSV 导出。

解散团队

Owner 才能解散。解散前系统会让你：

  1. 导出所有工作流（ZIP of YAML）
  2. 导出所有执行记录（CSV 或 JSON）
  3. 通知所有成员（自动发邮件）
  4. 双因子确认

解散后 30 天内可恢复；30 天后数据彻底清理，无法找回。

下一步