一句话看懂：GitHub CLI（gh）在其 v2.99.0 版本中正式上线了一个可重复使用的 --attach 参数，允许开发者直接在命令行里为 issues、pull requests 和评论附加图片或视频，并在正文中自动生成内联引用。
事件核心：发生了什么
根据 GitHub Changelog 9月1日的官方更新，GitHub CLI 引入了 --attach 标志，适用于 gh issue create、gh issue edit、gh issue comment、gh pr create、gh pr edit 和 gh pr comment 这六个会写入 Markdown 文本的命令。用户只需将本地路径传给该标志，即可上传并将文件内联在正文中。该功能已对所有用户和所有套餐正式开放，无需预览期，但需要将 gh 更新至 v2.99.0。支持的文件类型包括 PNG、JPEG、GIF、WebP、SVG、MP4、MOV 和 WebM。上传大小限制与网页端一致：图片和 GIF 为 10 MB，免费套餐视频为 10 MB，付费套餐视频为 100 MB。
为什么重要
此前 gh 只能写入纯文本，开发者若要提交一个带截图或录屏的 bug 报告，必须中断命令行操作、打开浏览器、拖拽文件并复制回传结果。这一工作流的中断看似小事，却直接影响开发效率，尤其是在自动化脚本或 AI 编程代理（coding agents）的应用场景中。通过加入 --attach，GitHub 将命令行从纯文本输出升级为多媒体输入输出接口，让代码工具链可以无缝处理视觉信息。这也意味着 AI 编程代理现在有能力在提交 issue 时附带实际渲染结果或报错画面，而不仅仅是文字描述，这对自动化漏洞报告、PR 审查和结果验证场景的价值显著。目前公开信息显示，GitHub Enterprise Server 暂不支持此功能，表明官方优先保障 SaaS 云端生态的一致性。
对用户/开发者/创作者的影响
对于日常依赖命令行管理仓库的开发者，--attach 消除了“开浏览器上传”的切换成本，尤其是处理 UI bug 或视觉效果变更时，可以直接在同一个终端会话中完成“写 Markdown + 贴图”的整个流程。如果你写的正文中已经通过本地路径引用了图片，例如 ，gh 会原地重写该路径为上传后的资源地址，并保留原有 alt 文本；未被引用的附加文件会自动追加到正文末尾。此外，alt 文本可以通过路径后加 # 来指定，例如 --attach './login.png#The login error state'，省略时则回退为文件名，这为可访问性提供了一定的便利。安全方面，上传过程复用 gh auth login 的 OAuth token 或经典个人访问令牌，并要求对目标仓库具有写权限，权限模型与网页端保持一致。
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
值得关注的后续
首先是生态跟进：GitHub 作为最大的代码托管平台，其 CLI 原生支持多媒体附件后，是否会推动 GitLab CLI 或 Bitbucket 等竞品在相应命令行工具中补齐类似能力，值得观察。其次是 AI 编程助手的受益程度：随着 gh 可以将截图和视频直接纳入 issue 或 PR 上下文，基于大模型的代码审查工具或自动修 bug 代理将获得更丰富的输入信号，这可能会间接提升 AI 在视觉化 bug 定位和修复上的能力上限。最后是限制边界：100 MB 的视频上传上限（付费套餐）与网页端一致，但这是否会对大规模测试录像或长时录屏造成瓶颈，以及未来是否会引入压缩或转码服务，都是可以持续关注的细节。
