GitHub Actions 生成器

GitHub Actions 是 GitHub 官方的 CI/CD 平台：把 YAML 工作流放进 .github/workflows/，事件（push、PR、tag、定时）触发后 GitHub 会在托管运行器上按步骤执行。本工具把最常见的「检出 → 装环境 → 缓存依赖 → lint → 测试 → 构建」流水线固化成表单，生成缩进正确、版本官方（actions/checkout@v4、setup-node@v4 等）的配置。

YAML 缩进与结构要点

workflow 的骨架是 on → jobs → job → steps 四层，每层缩进两个空格；steps 列表中 - name: 与 uses: / run: 的关系最易写错。本工具生成后请勿手工调空格，直接整文件提交；改步骤请回到表单重新生成。

依赖缓存为什么重要

Node 项目把 cache: 'npm' 写进 setup-node 即可按 package-lock 自动缓存；Python 用 setup-python 的 cache: 'pip'，Go 的 setup-go 默认开启模块缓存。缓存命中后安装步骤普遍快 1-3 分钟，免费额度下的分钟数消耗也随之下降。锁文件缺失时缓存会告警但不影响运行。

触发条件的组合

push.branches 与 pull_request.branches 控制「哪些分支的活动跑 CI」；tag 模式（如 v*）常用于发版流水线；schedule.cron 按 UTC 计时，北京时间需减 8 小时换算；勾选 workflow_dispatch 可在 Actions 页面点按钮手动触发，方便补跑。

常见问题

• 部署步骤为什么是占位？部署强依赖你的平台（Vercel / SSH / Docker Registry）与密钥，工具生成 echo 占位步骤，替换为官方 action 或 run 命令即可。
• cron 什么时候真正执行？GitHub 对 schedule 触发有排队延迟，高峰期可能晚几分钟甚至跳过一次；需要强时效请改用外部调度或 workflow_dispatch。
• 生成的 actions 版本过时了怎么办？本工具固定引用 checkout@v4、setup-node@v4 等当前主版本；升级大版本前用 Actions 页面的运行日志确认新行为。