---
title: "管理触发测试方法 - 手动触发"
language: "zh"
url: "https://docs.testany.io/zh/docs/managing-test-manual-trigger/"
markdown_url: "https://docs.testany.io/zh/docs/managing-test-manual-trigger.md"
translation: "https://docs.testany.io/en/docs/managing-test-manual-trigger.md"
last_updated: "2026-03-03T14:24:54+08:00"
---

# 管理触发测试方法 - 手动触发

## 概述

手动触发用于按需执行一个或多个测试流水线，不需要等待计划任务（Plan）时间点，也不依赖外部Webhook事件（Gatekeeper）。

典型场景包括：

- 热修复上线前快速回归
- 环境恢复后立即复测关键链路
- 人工发起标准化多流水线验收

## 核心概念

| 概念 | 说明 |
| --- | --- |
| 手动触发标识 | 手动触发模板的唯一标识，格式 `M-{workspace_key}-{4~5位大写十六进制}` |
| 触发ID | 触发对象ID。对 Manual Trigger 来说就是 `M-{workspace_key}-{4~5位大写十六进制}` |
| 触发实例ID | 同一触发ID下某次执行的序号（例如 `00007`） |
| 手动触发负责人 | 可编辑/删除该手动触发的用户 |
| 手动触发执行人 | 对某一次 Trigger Instance 实际点击“执行”的用户 |
| Trigger Instance | 同一个手动触发模板下的一次执行事件，例如 `M-WKS-00001-00007` |

## 开始前准备

请先确认您具备：

- 目标工作区
- 至少一条可执行的测试流水线
- 该工作区下创建/编辑手动触发的权限

## 创建手动触发

1. 进入目标工作区，打开 **触发器** -> **手动触发**。

   ![手动触发列表页](https://docs.testany.io/docs/images/zh/manual-trigger-list-page.png)

2. 点击 **创建手动触发**。

   ![创建手动触发弹窗](https://docs.testany.io/docs/images/zh/manual-trigger-create-dialog.png)

3. 填写以下信息：
   - **名称**（必填）
   - **描述**（选填）
   - **Pipeline**（可选多条）
4. 点击 **创建** 完成。

## 管理手动触发

创建后可进入详情页维护配置。

![手动触发详情页](https://docs.testany.io/docs/images/zh/manual-trigger-detail-page.png)

您可以在详情页维护：

- 名称与描述
- 关联流水线集合
- 负责人与标签
- 结果通知设置


> **备注**
>
> 单次手动触发可以包含多条流水线。若其中某条流水线不满足执行条件（例如缺少可执行定义），该条流水线可能显示为 `skipped`，其余流水线仍可正常执行。


## 执行手动触发

1. 在列表页或详情页点击 **执行**。
2. 在确认弹窗核对本次将触发的流水线。
3. 点击 **确认执行**。

![执行确认弹窗](https://docs.testany.io/docs/images/zh/manual-trigger-run-confirm.png)

## 查看执行结果

常用查看入口有两个：

- **详情页**：展示最近 10 次 Trigger Instance
- **执行记录页**：查看完整历史，并可使用 `triggered_by` 与 `trigger_source=manual_trigger` 过滤

![按手动触发过滤的执行记录](https://docs.testany.io/docs/images/zh/manual-trigger-execution-history.png)

您可以展开某一条 Trigger Instance，查看该次执行下的流水线级状态明细。

## 负责人 vs 执行人

`手动触发负责人` 与 `手动触发执行人` 是两个不同概念：

- **负责人（Owner）**：手动触发模板资源的所有者，负责维护该模板。
- **执行人（Executor）**：发起某一次执行的实际操作人。

因此，同一个手动触发模板下，某次执行的执行人可以与负责人不同。

## 相关文档

- [触发测试执行](https://docs.testany.io/zh/docs/managing-test-executions.md)
- [管理触发测试方法 - 计划任务触发](https://docs.testany.io/zh/docs/managing-test-plan.md)
- [管理触发测试方法 - 门卫触发](https://docs.testany.io/zh/docs/managing-test-gatekeeper.md)
- [Testany平台状态解读：全面指南](https://docs.testany.io/zh/docs/understanding-statuses-on-testany-platform-your-co.md)

## 本页术语

- [手动触发 (Manual Trigger)](https://docs.testany.io/zh/docs/glossary.md#manual-trigger)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)
- [测试流水线 (Test Pipeline)](https://docs.testany.io/zh/docs/glossary.md#test-pipeline)
- [计划任务 (Plan)](https://docs.testany.io/zh/docs/glossary.md#plan)
- [门卫 (Gatekeeper)](https://docs.testany.io/zh/docs/glossary.md#gatekeeper)
- [环境 (Environment)](https://docs.testany.io/zh/docs/glossary.md#environment)
- [手动触发标识 (Manual Trigger Key)](https://docs.testany.io/zh/docs/glossary.md#manual-trigger-key)
- [触发ID (Trigger ID)](https://docs.testany.io/zh/docs/glossary.md#trigger-id)
- [触发实例ID (Trigger Instance ID)](https://docs.testany.io/zh/docs/glossary.md#trigger-instance-id)
- [手动触发负责人 (Manual Trigger Owner)](https://docs.testany.io/zh/docs/glossary.md#manual-trigger-owner)
- [用户 (User)](https://docs.testany.io/zh/docs/glossary.md#user)
- [手动触发执行人 (Manual Trigger Executor)](https://docs.testany.io/zh/docs/glossary.md#manual-trigger-executor)
- [触发实例 (Trigger Instance)](https://docs.testany.io/zh/docs/glossary.md#trigger-instance)
- [工作区 (Workspace)](https://docs.testany.io/zh/docs/glossary.md#workspace)
- [执行器（Executor）](https://docs.testany.io/zh/docs/glossary.md#executor)