用途:把截图、图片或视频附加到 PR 或 issue,或在 GitHub 评论中嵌入图片。
主要能力:通过 gh 命令的 --attach 参数上传文件,支持在文件名后用 # 添加替代文本;gh pr create、gh pr edit、gh issue create、gh issue edit 也接受可重复的 --attach 标志,最多 50 个文件。若在正文中引用同一路径,GitHub 会把该 Markdown 引用重写为已上传的资源;未被引用的附件会追加到评论末尾。
使用方式:先确认版本,gh --version,必要时 brew upgrade gh。附加到新评论:gh pr comment <n> --attach './shot.png#Alt text' 或 gh issue comment <n> --attach './shot.png#Alt text'。在正文中嵌入图片:printf '\n' | gh pr comment <n> --body-file - --attach './shot.png#Alt text'。
限制:没有独立的“获取 URL”命令,资源 URL 存在于已发布的评论中,可用 gh api repos/{owner}/{repo}/issues/comments/<id> --jq .body 读回。需 GitHub CLI 2.99 或更新版本。