XHGit · 产品文档

组织与团队

成员邀请、团队分工、仓库归属及权限边界。

01

阅读导览

组织把多人共同维护的仓库、软件包和自动化设置归在同一主体下,团队负责把成员与仓库权限连接起来。加入组织、加入某个团队和获得仓库写入权限是不同操作。应按实际职责授权,并用成员视角核对结果。

02

创建组织并确定拥有者

  1. 从顶栏创建菜单选择新建组织,按页面填写可用名称、显示名称和可见性。
  2. 创建后检查组织主页及拥有者团队,确认谁负责成员、仓库和安全管理。
  3. 在组织设置中维护头像、描述和相关资料,避免把私密联系信息放在公开简介。
  4. 约定组织内仓库命名、默认可见性和审查流程,再邀请更多成员。

能否创建组织由站点策略决定。组织拥有者是高权限角色,应该只授予确实承担管理职责且具备可靠登录方式的人。

03

邀请和管理成员

组织成员页面用于查看并管理成员,团队页面用于具体分配职责。由有权限的管理者使用页面提供的添加或邀请操作,确认账号名,而不是只凭相同显示名称识别用户。

  1. 先确认对方已有可用的站点账号。
  2. 添加到组织后,再加入完成工作需要的团队。
  3. 检查成员关系是否公开,以及实际能够访问的仓库。
  4. 人员离开时及时移出相应团队或组织,并核对个人令牌、部署密钥等独立凭据是否需要撤销。

移除成员关系不等于从其他人设备删除已经合法取得的本地代码副本。

04

按职责建立团队

在组织“团队”中新建团队,填写名称与说明,选择仓库范围及可用的功能权限,再添加成员。可以分别安排只读观察、开发、议题管理和发布维护,减少把每个成员都设为管理员的需要。

团队可关联选定仓库,也可能按配置访问组织全部仓库。启用更广范围前,应确认是否会包含后来新建的仓库。不同单元的权限可以不同:能管理议题的人不一定能改代码,能写代码的人也不一定能编辑 Actions 或软件包。

05

理解权限如何生效

  1. 确认用户加入了预期团队,且团队确实包含目标仓库。
  2. 检查团队对代码、议题、合并请求、项目、Wiki、发布和 Actions 等单元的权限。
  3. 检查仓库本身是否关闭了该功能,或已归档、是镜像、尚未初始化。
  4. 最后检查分支和标签保护,确定写入者是否仍需通过评审。

一个用户可能从多个团队或单独协作关系得到权限。收回某个团队的权限后仍能访问时,要继续排查其他授权来源。私有仓库的有意公开单元也需要仓库管理员单独审查。

06

在组织下创建或转入仓库

具有相应权限时,打开创建仓库并选择组织拥有者。已有仓库需要转移时,由当前仓库管理员按照“设置”中的转移流程操作,核对目标组织及接收要求。

转移前检查团队、Webhook、Actions 凭据、包关联和外部工具中的地址。转移改变归属,不能假设所有外部系统都会自动更新。转移后让组织成员验证浏览、克隆和常用协作操作,再更新项目说明中的链接。仓库操作详见仓库管理。

07

共享组织资源

组织可以集中管理当前启用的软件包、项目、Webhook 及 Actions 设置。组织级 Runner、Secrets 或变量可能供多个授权仓库使用,配置前先明确可访问范围。敏感值只交给可信的工作流和执行环境,不能把组织级密钥视为普通公开配置。

组织项目适合关联权限允许的事项,软件包用于发布组织依赖,Webhook 用于事件通知。具体操作见项目看板、软件包、Runner与集成。

08

改名、退出与删除前核对

组织改名或仓库归属改变后,应检查克隆地址、构建源地址、包管理器源和第三方回调配置。退出组织前把尚未交接的评审、任务和管理职责处理完。

删除组织属于高影响操作,只有符合条件的拥有者可按页面要求执行。先核对仓库和资源归属、必要备份以及待处理事项,阅读确认范围后再操作。普通成员遇到入口缺失时应联系组织拥有者,站点管理员才负责站点级限制与账号异常。