如何编写 GitHub 操作,以部署由 gopages 生成的 GitHub 页面站点

Hi (再次),

与 #74 类似，我也尝试创建一个 GitHub 动作，该动作将生成的文档部署到 GitHub 页面。我的工作流程如下所示：

name: Deploy documentation to GitHub pages
on:
  # 在针对默认分支的推送上运行
  push:
    branches: ["main"]
  # 允许您从"动作"选项卡手动运行此工作流程
  workflow_dispatch:
permissions:
  contents: read
  pages: write
  id-token: write
concurrency:
  group: "pages"
  cancel-in-progress: false
jobs:
  docs:
    runs-on: ubuntu-latest
    environment:
      name: GitHub-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: 从仓库中检出代码
      - uses: actions/checkout@v4
      - name: 使用 gopages 生成文档
        uses: actions/setup-go@v5
        with:
          go-version: '1.23'
        run: go run GitHub.com/johnstarich/go/gopages@latest \
          -brand-title '<repo>' \
          -brand-description '<repo>' \
          -internal
      - name: 上传生成的页面
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./dist
      - name: 部署到 GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4
当运行此动作时，我收到以下错误：

生成 godoc 静态页面... GitHub.com/devrev/airdrop-common pipe: pipe: pipe: 生成页面失败: [404] ... 一大堆 HTML 代码