集成: Jira, Azure DevOps, GitHub Issues, Slack, Teams 和 Telegram
Nexus StudioQA 可连接六项服务: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams 和 Telegram. 各项服务默认关闭, 只有您主动开启后才会启用, 且均直接从您的计算机连接, 绝不经过我们的服务器. 本页介绍各项服务的功能, 读取的密钥以及绝不会执行的操作.
最后更新:
作者:Nexus StudioQA 团队,Verdict System LLC. 2026年10月9日。
各项集成的工作方式
- 默认关闭,直到您主动开启。 每项服务都有独立的开关:
JIRA_ENABLED、AZURE_BOARDS_ENABLED、GITHUB_ISSUES_ENABLED、SLACK_ENABLED、TEAMS_ENABLED和TELEGRAM_ENABLED。所有开关的默认值均为false。 - 从你的计算机直接连接。 引擎从运行测试的计算机调用各项服务自身的 API。所有数据均不经过我们的服务器,我们也绝不会看到你的问题、告警或结果。
- 密钥保留在工作区中。 令牌和密钥以配置行的形式保存在你磁盘上工作区的
.env文件中。你可以在设置的集成部分编辑它们,所有令牌、密钥和 webhook 均以隐藏敏感内容的形式显示。 - 沙盒运行不参与问题管理。 沙盒运行用于尚在构建中的测试,不代表发现了问题:它绝不会创建问题、添加评论或关闭问题。
每个测试在持续失败期间只对应一个问题
Jira、Azure Boards 和 GitHub Issues 遵循相同的生命周期,且可通过工单设置调整每个步骤。问题关联的是测试,而不是某次运行,因此,每晚都失败的测试会对应一个带有历史记录的问题,而不是每晚新建一个问题。
- 首次失败时创建一个问题。 运行以 BREACHED, BREACHED_FLAKY, CHAOS_BREACHED 或 TIMEOUT 结束时,会为该测试创建一个问题,并附上错误信息和失败截图。
- 再次失败时添加评论。 只要该问题尚未关闭,后续失败就会在该问题下添加评论,并附上新的截图。两个浏览器同时失败时,也会更新同一个问题。
- 全部直接通过后关闭问题。 当一次运行中所有浏览器上的测试都无需重试便通过时,系统会在问题下添加评论说明情况,并将其转为已完成状态。如果工作流中没有对应的转换或状态,则仅添加评论。
- 之后再次失败会创建新问题。 如果失败所对应的问题已被删除或移动,也会创建新问题。
附件: 默认仅附上截图。只有在设置中通过 NEXUS_ISSUE_ATTACH_TRACE=true 主动启用后,才会同时附上 Playwright 跟踪文件和运行日志,因为其中可能包含会话数据:Cookie、授权标头和输入过的密码。每个附件的大小上限为 10 MB。
FLAKY 绝不会创建问题:运行失败后重试通过并不算缺陷。BLOCKED, UNREACHABLE, CRASHED 或配置错误也不会创建问题,因为它们涉及的是环境,而不是你的应用程序 (判定结果的确定方式)。问题与测试的对应关系保存在工作区的 evidence/integrations/issue-map.json 中。
分步指南
每份指南都会说明所需条件、如何获取凭据、如何验证连接是否正常,并列出常见错误及其原因和解决方法。
将失败信息发送到更多地方
另外五个目标服务遵循与上述服务相同的规则。它们默认均处于关闭状态,需手动启用,并使用你自己的密钥从你的计算机直接连接。
- Linear: 在你选择的团队中,为每个失败的测试创建一个工单;再次失败时添加评论,测试完全通过时则移至第一个已完成状态。配置项:
LINEAR_ENABLED、LINEAR_API_KEY和LINEAR_TEAM_ID。 - GitLab Issues: 在 GitLab 项目中采用相同的生命周期:测试完全通过时关闭,问题复现时重新打开。配置项:
GITLAB_ISSUES_ENABLED、GITLAB_ISSUES_TOKEN和GITLAB_ISSUES_PROJECT。令牌仅通过 https 传输。 - PagerDuty: 测试失败时触发事件,再次失败时向同一事件追加信息,测试完全通过时解决该事件。配置项:
PAGERDUTY_ENABLED和PAGERDUTY_ROUTING_KEY。 - Opsgenie: 以告警形式采用相同的生命周期,测试完全通过时关闭。配置项:
OPSGENIE_ENABLED和OPSGENIE_API_KEY。 - TestRail: 将每次运行的结果报告到测试中通过
// nexus:testrail C123注释指定的用例。配置项:TESTRAIL_ENABLED、TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY和TESTRAIL_PROJECT_ID。
按根本原因分组是工单设置中的一条规则,默认关闭。启用后,如果某个测试失败时出现的错误与另一个已有未关闭工单的测试相同,系统会在该工单中添加评论,而不是创建第二个工单;且归入该组的测试完全通过时,也绝不会关闭第一个测试的工单。
请 AI 助手引导你操作
任何 AI 助手都可以引导你按照这些指南操作。将指南的地址或 integrations-guide.json 的地址提供给它,后者列出了每个键、其有效格式、检查方法,以及各项错误的原因和解决方法。
- 切勿将令牌、密钥、密码或 Webhook URL 粘贴到聊天中。凭据只能在 Studio 的设置、集成中输入。助手绝不需要这些信息。
- 只向它提供非机密信息:站点地址、项目名称以及 Studio 显示的完整错误行。
- 以 Studio 自身的检查结果为准。连接是否正常,应由检查连接、发送测试消息和创建测试工单的结果来判断,而不是由助手判断。
- 如果你已经将凭据粘贴到聊天中,请在相应服务中撤销该凭据并创建新凭据。
Jira Cloud
- 连接: 使用你的 Atlassian 账户邮箱和在 id.atlassian.com 创建的 API 令牌。在设置的集成部分粘贴你的 Jira 站点中的任意链接:Studio 会保留站点地址和项目键。站点地址
JIRA_BASE_URL必须使用 https。检查连接会验证这些配置,不会创建任何内容。 - 问题: 在
JIRA_PROJECT_KEY指定的项目中创建缺陷类型的问题,并遵循上述生命周期。测试无需重试便通过后,问题会执行JIRA_DONE_TRANSITION中指定名称的转换,默认值为 Done, 按名称匹配且不区分大小写。 - 避免重复: 如果过去 24 小时内已创建过摘要相同的缺陷,则不会再创建一个。
- 多个 Jira 站点: 在工单下, 添加另一个 Jira 站点可添加一个目标, 并为其单独指定站点、项目键和问题类型. 每个启用的目标都会生成独立的工单. 站点必须是 Atlassian Cloud 地址, https://<name>.atlassian.net, 同一 Atlassian 账户的所有站点共用一个邮箱地址和 API 令牌. 令牌只会发送到您列出的站点.
- 手动操作: 你可以选择通过 Evidence Locker 将失败信息发送到 Jira。
Azure DevOps: Boards, Test Plans 和 Pipelines
一个个人访问令牌 (PAT) 和一个项目,分别通过 AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> 或 https://<org>.visualstudio.com) 和 AZURE_DEVOPS_PROJECT 配置。PAT 仅发送到 Azure DevOps 自有的主机,绝不会出现在日志行中。在设置的集成下, 连接 Azure DevOps会检查项目和工作项类型,不会创建任何内容。
- Azure Boards: 设置
AZURE_BOARDS_ENABLED=true后,测试失败会按照上述生命周期创建类型为AZURE_BOARDS_WORK_ITEM_TYPE的工作项,默认为 Bug. 测试完全通过时,工作项会转为AZURE_BOARDS_DONE_STATE中指定的状态,默认为 Resolved; 如果流程不允许该状态,则仅添加评论。PAT 需要工作项权限 (读取 & 写入). 也可以通过 Evidence Locker 手动将失败结果发送到 Azure Boards. - Azure Test Plans: CI/CD 页面生成的
azure-pipelines.yml使用PublishTestResults@2任务发布本次运行的 JUnit XML, 因此每次流水线运行都会显示在 Test Plans 的运行列表中。 - Azure Pipelines:
nexus ci-remote --provider=azure会将AZURE_PIPELINE_ID指定的流水线加入运行队列,等待其完成,然后将其 JUnit XML 取回本机。为此,PAT 需要构建权限 (读取 & 执行).
GitHub Issues
- 连接: 在
GITHUB_ISSUES_TOKEN中设置一个对指定仓库具有 Issues (读写) 权限的细粒度个人访问令牌, 并在GITHUB_ISSUES_REPO中以 owner/repo 格式指定仓库. 在设置的集成下, 连接 GitHub Issues会显示令牌所属用户, 并且仅列出该令牌可访问且已启用 Issues 的仓库 (分步指南). - 问题: 设置
GITHUB_ISSUES_ENABLED=true后, 测试失败时会创建一个带有工单标签的问题, 并遵循上述生命周期. 测试全部通过时, 会为该问题添加评论, 并将其以已完成状态关闭. - 其他仓库: 在工单下, GitHub 目标可指定与
.env中不同的 owner/repo.
Slack
- 连接: 在
SLACK_WEBHOOK_URL中配置一个传入 Webhook URL. 设置中提供了发送测试消息按钮。 - 接收的内容: Block Kit 消息:运行摘要,以及在设置
NEXUS_SLACK_NOTIFY=true后,为每个失败测试、不稳定测试、混沌测试或视觉回归测试发送的一条消息。如果失败结果有关联的 Jira 事项,消息中会附上该事项的链接。 - 手动操作: Evidence Locker 可以将失败结果的文本摘要发布到 Slack. 不会向 Slack 发送任何文件。
Microsoft Teams
- 连接: 在
TEAMS_WEBHOOK_URL中设置一个频道的 Workflows webhook URL. Teams Workflows 需要 Microsoft 365 工作或学校账户. 设置中提供保存 & 发送测试功能 (分步指南). - 接收内容: 以自适应卡片形式接收与 Slack 相同的消息: 运行摘要, 以及在设置
NEXUS_TEAMS_NOTIFY=true后, 为每个失败、不稳定、混沌或视觉回归测试分别发送的一条消息. - URL 的发送范围: 仅限 Microsoft 自有 webhook 主机上的 https 地址 (logic.azure.com, webhook.office.com, api.powerplatform.com). 其他所有 URL 均会被拒绝, 不会发送任何内容.
Telegram
- 连接: 使用 @BotFather 创建一次专属机器人,并在
TELEGRAM_TOKEN中配置其令牌。在设置中, 扫码连接会关联你的聊天并填入TELEGRAM_CHAT_ID. 不使用共享机器人。 - 接收的内容: 失败提醒,设置
NEXUS_TELEGRAM_NOTIFY=true后每个测试发送一条,以及你选择从 Studio 分享的报告和文件。 - 启用前须知: Telegram 可以接收报告和 PDF 等文件,这些文件会发送到 Telegram 的服务器。如果你所在的环境受监管,请先咨询合规团队。
工单: 何时创建、包含什么、发送到哪里
在设置中的集成下,工单页面用于设置测试失败时向 Jira、Azure Boards 或 GitHub Issues 提交的内容。证据库的分享功能使用同一模板。配置保存到工作区的 nexus-tickets.config.json 中,该文件不含任何机密信息,可保存在代码仓库中。没有此文件时,工单按上述方式处理。如果文件无效,则使用默认设置,日志会说明原因。
- 触发条件: 哪些判定结果会创建工单(默认为 BREACHED 和 TIMEOUT)、连续失败多少次后创建、每次运行的数量上限、适用于本地运行、CI 运行还是两者、要包含或排除的测试 ID、测试完全通过后的处理方式(关闭、仅添加评论或不操作),以及失败再次出现时是否重新打开已关闭的工单而非新建工单。
- 内容: 标题模板,可使用
{type}、{testId}、{browser}和{error.firstLine}。{testId}为必填项,因为标题是 24 小时内的去重键。还可设置发送哪些描述章节及其顺序、包含多少错误内容、标签、各判定结果的优先级、负责人、组件、自定义字段和团队备注。 - 附件: 默认附加屏幕截图。跟踪文件、视频和报告仅在勾选后附加,每项均受大小上限限制。
- 目标位置: 每个跟踪系统有一个目标位置,各有独立开关。目标位置可覆盖 Jira 站点、项目和问题类型、GitHub 仓库或 Azure 工作项类型的设置。
- 预览与测试: 保存前,页面会按目标位置显示最近一次失败将生成的工单。创建测试工单会据此提交一个真实工单,并添加
nexus-test标签。
工单绝不包含的内容
- 仅发送您勾选的内容。 未选择的章节或附件会保留在您的计算机上。
- 先脱敏机密信息。 提交前,每行文本都会经过脱敏处理,涵盖授权和 Cookie 标头、Bearer 和 Basic 令牌、JWT、已知服务商的密钥格式、URL 中的密码,以及名称类似机密信息字段的值。它能识别日志和错误中机密信息的常见形式,但无法识别自由文本中可能包含的所有机密信息,因此除非确有需要,否则请勿启用跟踪文件附件。
- 文件中不含令牌。
nexus-tickets.config.json不允许使用名称涉及机密信息的字段,也不允许包含用户名和密码的 URL。令牌保留在.env中。
密钥
每个配置键在工作区的 .env 中各占一行。所有配置键都可以在设置中编辑。
| 服务 | 配置键 | 默认值 |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | 关闭;项目 QA; 转为 Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | 关闭;类型为缺陷;状态为已解决 |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | 关闭 |
| 问题附件 | NEXUS_ISSUE_ATTACH_TRACE | 关闭:仅截图 |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | 关闭 |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | 关闭 |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | 关闭 |
在流水线中,除 AZURE_PIPELINE_ID 外,这些相同的键均为流水线的机密变量,未设置的键会使对应服务保持关闭(CI/CD 中的机密)。
问题
Nexus StudioQA 能看到我的 Jira 或 Azure DevOps 数据吗?
不会. 引擎使用您的密钥, 直接从您的计算机与 Jira, Azure DevOps, GitHub Issues, Slack, Teams 和 Telegram 通信. 所有通信均不经过我们的服务器.
不稳定的测试会创建工单吗?
不会。FLAKY 不会创建任何工单。BREACHED_FLAKY 则会:失败本身并不稳定,重试也无法掩盖这一点。
一个测试本周失败了 30 次。这会产生多少个问题?
一个,首次失败后的每次失败都会附上一条评论和一张新截图,直到该测试在所有浏览器上均顺利通过。
我可以同时使用 Jira、Azure Boards 和 GitHub Issues 吗?
可以。每个系统都会为每项测试维护独立的问题,每个额外的 Jira 站点也是如此。