GitHub CLI现在可以通过命令行添加文件 例如上传图片或视频附加到PR中

GitHub CLI现在可以通过命令行添加文件 例如上传图片或视频附加到PR中

💡 原文中文,约1100字,阅读约需3分钟。
📝

内容提要

GitHub CLI 2.99.0版新增附件上传功能,支持通过命令行将本地图片或视频直接附加到Issue、PR及评论中。用户需升级至该版本,免费用户单文件上限10MB,付费用户视频可达100MB。支持PNG、JPEG、GIF等格式,并自动替换MD引用路径。

🔎

延伸解读

适用场景与命令覆盖

该功能覆盖了创建、编辑和评论Issue及PR的常用命令,如gh issue create、gh pr comment等。这意味着开发者可以在不离开终端的情况下,为问题报告或代码审查补充截图或视频证据,减少上下文切换,提升工作流效率。

文件大小与格式限制

附件大小限制与网页版一致:免费用户图片和视频均为10MB,付费用户视频可至100MB。支持PNG、JPEG、GIF、WebP、SVG、MP4、MOV、WebM等常见格式。开发者需注意,上传大文件或特定格式时,需确认自己的套餐权限,避免操作失败。

自动处理Markdown引用

若Markdown中已有类似![alt](./login.png)的引用,CLI会自动将本地路径替换为上传后的远程URL,并保留alt文本。未引用的附件则追加至末尾。这简化了文档维护,但开发者需确保路径正确,以免替换错误。

Q&A

GitHub CLI 2.99.0 新增了什么功能?

GitHub CLI 2.99.0 新增了附件上传功能,允许用户通过命令行将本地图片或视频直接上传到 Issue、PR 以及评论中。

如何使用 GitHub CLI 在评论中附加图片?

使用命令 `gh issue comment --attach ./screenshot.png` 即可在评论中附加图片。该命令会自动上传文件并附加到正文中。

GitHub CLI 附加文件支持哪些格式?

支持常见的图片和视频格式,包括 PNG、JPEG、GIF、WebP、SVG、MP4、MOV、WebM。

GitHub CLI 上传文件的大小限制是多少?

免费用户单个文件上限为 10MB,付费用户视频最高可达 100MB。图片和动态图最高为 10MB。

GitHub CLI 如何为附加的图片指定替代文本?

在文件路径后使用 `#` 指定 Alt 文本,例如 `--attach './login.png#登录错误界面'`。注意需使用英文半角的单引号包裹。

GitHub CLI 附加文件时,如果 Markdown 中已有图片引用会怎样?

如果 Markdown 中已有 `![alt](./login.png)` 类型的引用,GitHub CLI 会自动将路径替换为上传后的 GitHub 远程资源引用地址,并保留原有的说明文本。未在正文引用的附件会被自动追加到末尾。

使用 GitHub CLI 附加文件需要什么权限?

上传附件时需要同时拥有目标仓库的写入权限。

🏷️

标签

➡️

继续阅读