GitHub CLI --attach是什麼:2026年9月命令列附圖全解析
GitHub 9月1日寫:gh v2.99.0 增加可重複的 --attach。Changelog 與 cli/cli 發布說明同一件事:命令列附圖進 Issue / PR。Enterprise Server 本版不支援。
2026 年 9 月 1 日,GitHub Changelog 寫:GitHub CLI 新增可重複的 --attach。同一天 cli/cli 打上 v2.99.0。兩邊寫的是同一件事:把本機圖片或影片寫進 Issue、Pull Request 或評論。
此前 gh 只寫文字。要加截圖,得打開瀏覽器、拖進評論框、再把託管位址抄回來。Changelog 寫:--attach 把圖放進寫 Markdown 的那條命令。
公開條目寫了什麼
| 條目 | 公開寫法 | 邊界 |
|---|---|---|
| 開關 | 可重複的 --attach | 不是新的一套 CLI |
| 命令 | issue / pr 的 create、edit、comment | 未寫其他子命令 |
| 體積 | 跟網頁上傳一致 | 免費影片 10 MB,付費 100 MB |
| 託管 | GitHub.com 與 Enterprise Cloud | Enterprise Server 本版不支援 |
怎麼讀這次發布
- 1
這是 CLI 補上媒體
官方寫:以前只能寫文字。現在同一條命令可以把本機圖或影片上傳並引用。不要當成新的評審產品。
- 2
正文引用會被改寫
路徑已出現在 Markdown 裡時,gh 原地換成上傳位址並保留 alt。從未引用的附件追加在文末。替代文字可寫在路徑後的 #。
- 3
權杖沒有另開一套
上傳沿用 gh auth login 的 OAuth,或經典 personal access token。對倉庫要有寫入權限。Changelog 點了編碼代理也能用這個開關。
- 4
Server 不在本版
全方案正式可用,沒有預覽期。v2.99.0 寫 GitHub.com 與 Enterprise Cloud。Enterprise Server 被明確排除。
同頁還點了什麼
格式與替代文字
圖片:PNG、JPEG、GIF、WebP、SVG。影片:MP4、MOV、WebM。省略 # 說明時,退回檔名。
體積跟網頁走
圖片和 GIF 10 MB。免費方案影片 10 MB,付費方案影片 100 MB。官方寫與網頁上傳相同。
文件短鏈
發布說明指向 gh.io/gh-attach。Changelog 文末有編輯注:9 月 1 日更新了文件連結。
邊界
官方沒有寫 Enterprise Server 的補齊日期。下一步是 Changelog 與 gh.io/gh-attach。需要短會且不想再開一套帳號時,回 wbstorm 用房間號即可,另見 建立或加入房間 和 白板基礎。
# Sources
# github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments
# GitHub cli/cli v2.99.0, 2026-09-01
# CloudNinjas, 2026-09-02Enterprise Server 能用 --attach 嗎?
Changelog 寫:本版不支援 GitHub Enterprise Server。v2.99.0 寫附件可用在 GitHub.com 與 Enterprise Cloud。
必須開瀏覽器拖檔案嗎?
官方寫:以前是。現在同一條寫 Markdown 的命令可以帶 --attach。本文不是逐步教學。
這是產品使用教學嗎?
不是。本文只核對 9 月 1 日 Changelog 與 v2.99.0 發布說明,不是 gh 操作手冊。