用途:在 GitHub 的 PR、Issue 或评论中附加截图或录屏作为证据,并验证附件确实上传到了预期位置。
主要能力:通过 gh pr create、edit、comment 或对应的 gh issue 命令使用 --attach 参数上传图片和视频。发布行为必须获得任务授权。纯文本证据应放在带语言标记的代码围栏中;--attach 接受图片和视频。
使用方式:先确认 gh --version 与认证状态。若已安装的 CLI 不支持 --attach,应继续准备证据并报告所需版本,上传证据的请求并不授权升级 CLI。需明确目标仓库、PR 或 Issue,以及目标是正文还是某条评论,并保留原有内容,不要提交证据文件。多行正文写入文件后用 --body-file 传入。当图片引用的目标路径与附件路径一致时,会被替换为上传后的 URL,例如:
,命令形如 gh pr edit <number> -R <owner/repo> --body-file <body-file> --attach '/abs/path/error.png'。追加附件时可用 --attach '/abs/path/error.png#Error state' 提供替代文本,多个文件重复该参数。视频在图片引用替代文本为空且独占一段时渲染为播放器。
验证与恢复:读取命令创建或修改的具体正文或评论,确认每个请求的文件在该目标位置都有对应的上传 URL,可结合命令结果与附件周边文本判断;线程中其他位置的附件不能证明本次上传成功。非零退出仍可能已创建 PR 或评论并上传部分文件,重试前应先检查结果,保留成功的上传,修正可恢复的错误,只对缺失文件编辑既有目标,切勿盲目重放创建或评论命令。若结果不确定或权限不允许修复,应报告已成功与仍待处理的部分。私有仓库需用已登录账号验证,匿名 403 或 404 不能证明失败。纯文本证据需要其预期的围栏内容,而不是附件 URL。
限制:资料未提供更多平台、收费或效果信息。