Ever Teams 集成清单:如何连接 GitHub、GitLab、JIRA 等 20+ 开发工具
Ever Teams 集成清单:如何连接 GitHub、GitLab、JIRA 等 20+ 开发工具
Ever Teams 是一款开源的工作与生产力管理平台,它的集成能力可以直接连接 GitHub、JIRA、Asana、Linear、Trello 等开发协作工具,把外部问题(Issue)自动同步为平台内的任务,并支持日历、白板、视频会议等内建能力。本文带你一次性看清 Ever Teams 的集成清单:入口在哪、每个工具怎么连、同步规则是什么,以及遇到问题时去哪里排查。
在哪里打开集成设置
集成的统一入口是 团队设置 → 集成(Integrations) 页面:
- 该页面由团队管理员(Manager)管理,普通成员只能只读查看集成状态;
- 页面源码位于 integrations-settings-page.tsx,可以直观看到页面由 GitHub、Linear、Asana、Trello、Jira 五个区块加导入入口组成;
- 页面展示的集成目录由服务端按组织下发,未开通的组织会显示 "No integration is offered to this organization"。
Settings → Integrations
├─ GitHub (安装应用 → 选择仓库 → 自动同步)
├─ Jira (站点连接 → 状态映射 → 双向同步)
├─ Linear (工作区映射 → 一次性导入 + 持续同步)
├─ Asana (OAuth 连接 → 工作区映射)
├─ Trello (OAuth 连接 → 看板映射)
├─ 时间数据导入(Time Import)
└─ Ever Platform 内建能力(白板 / 日历 / 会议 / 客服)
GitHub 集成:安装、选仓库、自动同步任务
GitHub 是 Ever Teams 中体验最完整的开发工具集成,连接流程如下:
- 打开集成页面,找到 GitHub 卡片,点击 Install(安装),跳转到 GitHub 完成应用安装与授权;
- 返回页面后,卡片会显示连接状态(已连接 / 已暂停)、安装时间、可访问的仓库数量;
- 在你的项目下 选择一个仓库 建立关联;
- 打开 任务自动同步(Auto Sync) 开关后,GitHub 的 Issue 会自动同步为任务;
- 如需只同步部分任务,可再开启 标签同步(Label Sync),并配置一个同步标签(Sync Tag),只有带该标签的任务才参与同步。
💡 注意依赖关系:标签同步必须先在自动同步开启之后才会生效,同步标签配置项也只有在标签同步开启后才出现。这套依赖逻辑写在 github-provider.tsx 中。
集成状态异常时(例如被暂停或无法访问 GitHub),页面会给出明确的错误提示和 Retry(重试) 按钮,也可以在危险操作区解除集成,相关代码见 github-provider.tsx。
Jira 集成:站点连接与状态双向映射
Jira 集成面向企业级场景,核心能力有三个:
- 连接 Jira 站点(Site):支持多站点管理,连接后自动拉取 Jira 项目列表;
- 状态映射(Status Map):把 Jira 的 Issue 状态映射到 Ever Teams 的任务状态分类上,映射关系可视化展示,并显示有多少字段存在无效映射,映射逻辑见 integration-jira-status-map.ts;
- 双向同步(Direction):可选择同步方向,同步运行(Run)完成后会生成报告,失败的 Issue 会列出前 5 条以便定位问题,冲突项可通过筛选器查看,实现位于 jira-provider.tsx(约 1300 行,含运行报告与冲突处理 UI)。
其他项目管理工具 —— Linear、Asana、Trello —— 遵循同一套交互模式:
- 通过 OAuth 在新窗口完成授权;
- 将外部的工作区 / 项目 / 看板 映射 到 Ever Teams 内的项目;
- 执行一次性 Import(导入),进度面板会实时显示导入的 Issue、评论、标签、附件数量;
- 开启持续同步后,外部变更会在固定时间间隔内自动更新;
- 同步过来的任务会带上 来源徽标,成员可以直接 "在 Linear / Asana / Trello 中打开" 原 Issue。
这套行为契约完整记录在功能规格文档 integrations-settings/spec.md 中,建议管理员先读一遍再批量配置映射。
平台内建能力与时间数据导入
除了第三方工具,集成区还包含以下 无需外部服务 的能力:
| 能力 | 说明 | 代码位置 |
|---|---|---|
| 白板 | 基于 Excalidraw 的协作画板,用于评审与设计讨论 | integration/boards/ |
| 日历 | FullCalendar 排期日历,与任务、工时联动 | integration/calendar/ |
| 视频会议 | LiveKit 自托管会议(含会议控制条、成员面板)与 Meet 集成 | integration/livekit/、integration/meet/ |
| 客服 | Chatwoot 客服聊天小组件 | integration/chatwoot/ |
| 时间导入 | 从其他系统批量导入历史时间记录,每位成员可导入自己的数据 | import-section.tsx |
⏱️ 如果你正从其他工具迁移,建议先完成任务集成,再通过 Time Import 补齐历史工时,这样报表数据会更完整。
常见问题:为什么看不到某个集成?
问:集成页面里没有我想连的工具?
集成目录是"三层过滤"的结果:① 服务端运行时开关(如 NEXT_PUBLIC_INTEGRATION_ASANA_ENABLED、…_LINEAR_…、…_TRELLO_…,GitHub 默认存在);② 平台侧是否安装了该插件;③ 组织是否开通。三层任一层不满足,该集成就会被隐藏。各开关的判断逻辑见 integration-jira-enabled.ts、integration-linear-enabled.ts 等同名文件。
问:解除集成后,导入的任务会消失吗? 不会。断开连接后同步停止,但已导入的任务会保留,来源徽标与跳转链接依然可用(见 spec.md 的 2.1 场景)。
问:同步报错(如 token 过期)怎么办? 集成卡片会变为 "需要处理(needs attention)" 状态并显示原因,点击 Reconnect 重新授权即可。同步冲突可以按筛选器在任务列表中定位,相关代码在 use-run-conflict-filter.ts。
问:GitLab 呢? 截至当前版本,核心代码库中内置的任务同步集成是 GitHub、Jira、Linear、Asana、Trello 五个(入口见 integrations-settings-page.tsx);平台架构预留了按组织扩展更多集成类型的机制(integration-type.ts),后续工具会以插件形式逐步加入。


