已配置workflow_dispatch仍无法手动触发GitHub Action，求排查

你的工作流YAML中同时配置push自动触发和workflow_dispatch手动触发是完全合法的，两者不会互相冲突，问题大概率出在其他环节，按以下步骤排查：

1. 确认工作流文件位置 #

工作流文件必须放在仓库根目录的.github/workflows/文件夹下，文件名后缀为.yml或.yaml。如果文件位置错误，GitHub会识别不到该工作流，自然不会显示手动触发按钮。

2. 检查账号权限 #

只有仓库所有者、拥有写入权限的协作者，才能看到并手动触发工作流。如果你的账号只有读取权限，手动触发选项会被隐藏。

3. 验证工作流语法 #

虽然自动触发能运行，但还是建议确认workflow_dispatch的语法规范。你的写法是最简合法形式，没有问题：

workflow_dispatch:

4. 检查仓库Actions权限设置 #

进入仓库的「Settings」→「Actions」→「General」页面：

• 确认「Workflow permissions」设置为Read and write permissions，否则即使触发工作流，后续的git推送等步骤会因权限不足失败；
• 确认相关Actions启用选项未被禁用（核心是读写权限配置）。

5. 页面缓存或浏览器问题 #

有时候GitHub页面会缓存旧状态，尝试刷新页面、使用无痕模式或更换浏览器，确认手动触发按钮是否出现。

6. 查看工作流历史记录 #

如果怀疑已触发但未成功，进入仓库的「Actions」页面，找到该工作流（Create-Doc-Nightly），查看是否有手动触发的运行记录。若有失败记录，点击进入查看具体错误日志（比如token权限、git命令执行问题等）。

另外，你的工作流中有重复的git配置步骤（Step3和Step6都设置了remote、用户信息），可以统一提取为一个步骤减少冗余，但这不会影响手动触发功能。

内容的提问来源于stack exchange，提问作者Jack Stockley