**仓库调度：Peter Evans 的 GitHub 动作指南**

本指南将详细介绍如何理解和操作 peter-evans/repository-dispatch 这一GitHub动作，该工具旨在轻松创建仓库调度事件，支持复杂的自动化工作流程。

1. 项目目录结构及介绍

仓库的结构紧凑且针对性强，主要服务于其核心功能——创建仓库调度事件。下面是关键的目录和文件说明：

• .github/workflows: 此目录存放着GitHub的工作流文件，其中就可能包含了使用repository-dispatch动作的示例。
• action.yml: 动作的核心配置文件，定义了输入参数、运行环境和其他元数据。
• LICENSE: 使用MIT许可证管理的开源许可文件。
• README.md: 包含了项目的概述、安装使用方法以及详细的操作实例。
• 源代码文件（如.ts, .js,配置文件等）: 实现仓库调度逻辑的TypeScript或JavaScript源码及其相关配置。

2. 项目的启动文件介绍

在本项目中，并不存在传统意义上的“启动文件”，因为这是一个GitHub Action，其执行是基于GitHub上的工作流配置文件(.github/workflows/*)触发的。当你的GitHub仓库中的工作流配置引用了此动作（比如使用uses: peter-evans/repository-dispatch@v3），即是“启动”了这个动作。因此，可以说，这些工作流配置文件间接充当了“启动文件”的角色。

3. 项目的配置文件介绍

主要配置：action.yml

• Description: 描述了动作的功能，即创建一个仓库调度事件。
• Inputs:
  • token: 必选，默认使用GITHUB_TOKEN，或自定义的具有相应权限的个人访问令牌(PAT)，用于确定写入权限。
  • repository: 目标仓库的全名，可以是当前仓库或指定的其他仓库。
  • event-type: 自定义事件类型，是触发工作流的关键。
  • client-payload: 可选，一个JSON字符串，允许附加信息到事件中。

示例配置：在工作流中的应用

在你的GitHub仓库的.github/workflows目录下创建一个新的YAML文件，例如dispatch-event.yaml，其中你可以配置类似以下内容来使用此动作：

name: Trigger Another Repo Workflow
on:
  schedule:
    - cron: '0 * * * *' # 每小时触发一次
jobs:
  dispatch:
    runs-on: ubuntu-latest
    steps:
      - name: Repository Dispatch
        uses: peter-evans/repository-dispatch@v3
        with:
          token: ${{ secrets.REPO_ACCESS_TOKEN }}
          repository: owner/other-repo # 假设的目标仓库
          event-type: custom-trigger
          client-payload: '{"message":"Triggered from primary repo"}'

请注意，在实际应用中，你需要替换owner/other-repo和设置正确的Personal Access Token（PAT）作为秘密变量REPO_ACCESS_TOKEN，以确保动作能够成功访问目标仓库并触发事件。

通过上述介绍，开发者可以高效地利用repository-dispatch这一工具，实现跨仓库的自动化触发机制，增强工作流程的灵活性和连贯性。