insomnia团队协作需通过git同步、git凭证配置、日常同步操作、共享工作区直连及json导出导入五种方式实现统一。启用git同步将api资源版本化；配置git凭证确保权限有效；日常执行commit/pull/push保障变更一致；共享工作区支持实时协作者同步；离线场景可用加密json文件交换完整api资产。
如果您在团队中使用Insomnia开发API，但多个成员的请求集合、环境配置或测试用例无法保持一致，则可能是由于缺乏统一的同步机制。以下是实现团队协作同步的具体操作路径：
一、启用Git同步功能
Git同步将Insomnia项目映射为标准Git仓库结构，使所有API资源（如请求、环境、插件配置）以可版本化文件形式存储，便于多人协同编辑与历史追溯。
1、启动Insomnia客户端，打开需共享的API工作区。
2、点击顶部菜单栏的Git图标，或通过File → Git Sync进入同步设置界面。
3、选择Initialize Git Repository，浏览并指定本地项目根目录（建议与已有Git仓库根目录一致）。
4、在弹出窗口中填写远程仓库URL，格式为https://gitcode.com/用户名/仓库名.git或SSH地址。
5、点击Initialize完成初始化，此时项目文件夹内将生成.git目录及Insomnia专用的insomnia.*.json资源文件。
二、配置Git凭证与身份认证
Insomnia需凭据访问远程Git仓库执行Push/Pull操作，凭证信息决定提交作者标识与权限有效性，避免因认证失败导致同步中断。
1、点击右上角用户头像，选择Settings，切换至Credentials选项卡。
2、点击Create Git Credential，选择Access Token方式。
3、依次填入：Author Email（如team@domain.com）、Author Name（如API-Team）、Username（Git平台登录名）、Git Access Token（从Git平台个人设置中生成的token）、Base URL（如https://gitcode.com/api/v1）。
4、点击Save Credential，系统立即验证连接状态并显示绿色对勾标记。
三、执行日常同步操作
团队成员通过标准化Git操作保障本地修改与远程主干实时对齐，避免覆盖冲突或丢失变更，每次同步均生成可审计的提交记录。
1、修改请求参数、新增环境变量或调整工作区结构后，点击Git面板中的Commit按钮。
从 AI 编程会话日志（Clawdbot、Claude Code、Codex）中提取对话记录。该功能用于在用户要求导出提示词历史、会话日志或 `.jsonl` 格式的会话文件时使用。
2、在提交弹窗中输入清晰描述（如“更新支付网关测试环境URL”），勾选待提交的文件，点击Commit。
3、开始协作前，先点击Pull拉取远程最新提交，Insomnia自动合并非冲突变更。
4、确认本地无未提交更改后，点击Push将本次提交推送至远程仓库主分支。
四、使用共享工作区直连协作
Insomnia支持基于云服务的实时工作区共享，无需手动管理Git分支，适用于快速迭代场景或Git权限受限的团队环境。
1、在左侧导航栏点击Workspaces，选择当前工作区右侧的⋯菜单。
2、点击Share Workspace，输入合作者邮箱地址，从下拉列表中选择对应权限级别：Viewer（仅查看）、Editor（可编辑）、Admin（可管理成员）。
3、点击Send Invite，受邀成员将在Insomnia通知中心收到链接，点击后自动加载该工作区全量数据。
4、所有成员对同一工作区的修改将在5秒内实时同步，响应区顶部显示当前在线协作者头像缩略图。
五、导出导入JSON实现离线协作
当团队成员无法接入Git或云服务时，可通过结构化JSON文件交换完整API资产，确保核心测试逻辑与参数配置不丢失。
1、在工作区右键菜单中选择Export Workspace，格式选择Insomnia v4 (JSON)。
2、保存文件命名为api-collection-team-v2.json，通过加密邮件或内部网盘分发给其他成员。
3、接收方在Insomnia中点击左上角+ → Import Data，选择该JSON文件。
4、导入完成后，新工作区自动包含全部请求、环境、认证凭据（敏感字段默认加密，需手动解密输入密码）。
