需在Hoppscotch中创建团队级共享集合、配置可见性权限、添加团队环境变量、邀请成员并校验权限、使用文件夹模块化协作，以实现API请求的团队协同维护与测试。

如果您已在Hoppscotch中创建团队并希望成员共同维护和测试API请求，则需正确配置共享集合及其权限。以下是实现团队级集合协作与权限管理的具体操作路径：

一、创建团队级共享集合

团队级集合直接绑定至团队工作区，所有具备对应权限的成员均可访问，避免依赖个人本地导入导出。该集合在团队上下文中持久存在，其元数据（如名称、描述、变量）由团队统一托管。

1、登录Hoppscotch后，点击顶部导航栏的“Workspace”下拉菜单。

2、选择“Team Workspace”，进入已加入或创建的团队工作区。

3、在左侧边栏点击“Collections”，再点击“Add new”按钮。

4、在弹出表单中输入集合名称（必须至少6个字符）和可选描述，勾选“Create as team collection”选项。

5、点击“Create”完成创建，该集合即自动归属当前团队，并出现在所有拥有查看权限成员的集合列表中。

二、为团队集合分配细粒度访问权限

Hoppscotch不提供集合粒度的独立角色设置，而是通过团队角色继承与集合可见性策略协同控制访问。集合本身支持三种可见性状态，须结合成员角色共同生效。

1、在团队工作区中，找到目标集合，点击右侧“⋯”更多操作按钮。

2、选择“Edit Collection”进入编辑页。

3、向下滚动至“Visibility”区域，从下拉菜单中选择：Team only（仅团队内可见）、Private（仅创建者可见）或Public link（生成可分享链接，需额外授权）。

4、保存更改后，系统依据成员在团队中的角色（OWNER/ADMIN/EDITOR/VIEWER）叠加可见性策略：例如，即使设为“Team only”，VIEWER角色成员仍无法编辑该集合中的任何请求。

三、向集合添加团队环境变量并启用继承

团队环境变量是实现跨成员配置一致性的核心机制。当集合引用团队级变量时，所有成员调用该请求均自动解析同一套值，无需各自维护。

1、在团队工作区中，点击顶部导航栏“Environments”选项卡。

2、点击“Add new environment”，输入环境名称（如“dev-team-shared”），并确保勾选“Team environment”复选框。

3、在变量列表中添加键值对，例如：base_url = https://api-dev.example.com、auth_token = {{token}}。

4、返回目标集合，在任意请求的URL或Headers字段中使用双花括号语法引用，如{{base_url}}/users。

5、保存请求，此时所有拥有该集合访问权限的成员，在执行该请求时将自动注入团队环境变量值。

四、批量邀请成员并校验集合可见性

新成员加入团队后，默认不会自动获得已有集合的访问权限，需确保其角色满足可见性要求，且集合未被设为Private。邀请动作本身不触发权限同步，需人工确认角色匹配。

1、进入团队设置页，点击“Invite Members”按钮。

2、输入成员邮箱，从角色下拉菜单中选择：EDITOR（可编辑集合）、VIEWER（仅查看）或OWNER（完全控制）。

3、发送邀请，待成员接受后，登录其账户，前往“Collections”面板验证目标集合是否显示。

4、若集合未出现，检查该成员角色是否低于集合所需最低权限——例如，集合设为“Team only”但成员为VIEWER，则其可见；若集合设为“Private”，则无论角色如何均不可见。

五、使用集合文件夹实施模块化协作隔离

在大型团队中，单一集合易产生编辑冲突。通过在团队集合内创建受控文件夹，并配合请求级权限提示，可实现逻辑分组与协作边界软隔离。

1、在团队集合上右键，选择“New Folder”，输入文件夹名称（如“Payment-APIs”）。

2、将相关支付类请求拖入该文件夹，确保其归属明确。

3、在文件夹内任一请求的“Settings”中，点击“Permissions”标签页（若可见），确认无个人覆盖权限设置——团队集合内的文件夹及请求默认继承集合可见性与团队角色权限。

4、通知团队成员按文件夹分工：例如，A组负责“Authentication”文件夹，B组负责“Billing”文件夹，降低并发编辑概率。