内容提要
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中已有类似的引用,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 中已有 `` 类型的引用,GitHub CLI 会自动将路径替换为上传后的 GitHub 远程资源引用地址,并保留原有的说明文本。未在正文引用的附件会被自动追加到末尾。
使用 GitHub CLI 附加文件需要什么权限?
上传附件时需要同时拥有目标仓库的写入权限。