如何追踪自建GitHub Composite Action的跨仓库使用情况？

• GitHub搜索直接定位
  在GitHub搜索框输入uses: 你的用户名/你的action仓库名@指定版本（比如uses: octocat/my-composite-action@v1），就能找到所有公开仓库里引用该Action的Workflow文件。如果是私有仓库，加上org:你的组织名限定搜索范围，前提是你有这些仓库的访问权限。

• GitHub API批量查询
  写个简单脚本调用GitHub Search Code API批量获取引用记录，适合需要批量导出数据的场景。示例curl命令：

  curl -H "Authorization: token 你的GitHub令牌" \
  "https://api.github.com/search/code?q=uses%3Aoctocat%2Fmy-composite-action%40v1"
  

  注意API有请求限额，访问私有仓库必须带有权限的令牌。

• 维护内部使用登记清单
  如果是团队内部使用，要求所有引用该Action的仓库在README、团队共享表格或者专门的文档里登记仓库地址、负责人和使用场景。也可以在Action的README里明确要求使用者提交登记信息，或者在Issue模板里加“使用登记”项，方便统一管理。

• 在Action里添加使用日志
  在你的Composite Action中加一个步骤，每次被调用时记录调用方的仓库信息到中央位置，比如Action仓库的Issue、团队内部日志系统。示例步骤：

  - name: 记录使用信息
    run: |
      echo "该Action被仓库 ${{ github.repository }} 调用" >> $GITHUB_STEP_SUMMARY
      # 可选：发送到内部日志服务
      curl -X POST https://你的日志服务地址/log \
        -H "Content-Type: application/json" \
        -d '{"action": "你的Composite Action名称", "repo": "${{ github.repository }}", "分支": "${{ github.ref }}"}'
  

  这样每次调用都会留下痕迹，方便后续统计。

• 利用GitHub仓库依赖图
  打开你的Action仓库的「Insights」标签，查看「Dependency graph」部分，这里会显示部分依赖该Action的仓库（这个功能主要针对代码依赖，但部分Workflow引用也会被识别到，可作为补充手段）。

内容的提问来源于stack exchange，提问作者Mohamed Hussain