GitHub CLI 支援 --attach：終端直接上圖上片，代理可直接交付畫面結果
2026 年 9 月 1 日，GitHub 於官方 Changelog〈GitHub CLI: Media in issues, pull requests, and comments〉宣布，gh 命令列工具加入可重複使用的 --attach 旗標，可把本機圖片或影片上傳，並內嵌到 issue、pull request 或留言正文。同日 cli/cli 發布 v2.99.0。經核對 GitHub Changelog、v2.99.0 Release notes，以及官方 X 帳戶 @github 帖文後，來源真實性已驗證；X 帖文僅作發現線索。
一、核心事件：文字 CLI 補上「看得見的證據」
技術細節
先前用 gh 開 issue 或 PR，正文只能寫 Markdown 文字；要附截圖或示範短片，必須改用瀏覽器拖放檔案，再把連結貼回終端。官方明言這打斷了「同一條指令完成報錯」的節奏。--attach 把上傳與寫正文合成一步：可重複指定多個檔案，適用於 gh issue create／edit／comment，以及 gh pr create／edit／comment。
支援格式包括 PNG、JPEG、GIF、WebP、SVG，以及 MP4、MOV、WebM。替代文字（alt）可寫在路徑後的 #，例如 --attach './login.png#The login error state'；省略則回退為檔名。若正文已引用本機路徑（如 ），gh 會就地改寫為上傳後的資產 URL；只附加、未在正文引用的檔案則附加在文末。
權限與額度方面：上傳使用既有 gh auth login OAuth 權杖或經典個人存取權杖（PAT）；官方 Changelog 要求對目標倉庫具備寫入權限。容量與網頁上傳一致——圖片／GIF 10 MB；免費方案影片 10 MB，付費方案影片 100 MB。此版本不支援 GitHub Enterprise Server；GitHub.com 與 GitHub Enterprise Cloud 可用，並對所有方案一般開放（無預覽期）。升級方式：把 gh 更新至 v2.99.0。
官方特別點出：coding agents 亦可受益——代理不必只「描述」結果，可直接附上畫面或短片。這把 CLI 從「文字遙控器」推向「可交付視覺證據的代理介面」。
二、技術原理深度解析
1. 把附件納入「寫 Markdown 的同一命令」
本質不是另開一個媒體 API 產品，而是讓 CLI 的寫作指令取得與網頁留言框相同的資產上傳通道。開發者（或代理）在本機產物（截圖、錄屏）生成後，不必切換上下文：一條 gh issue create --attach ./repro.png 同時完成建單與證據掛載。這降低了「口頭描述 UI bug」造成的來回澄清成本。
2. 路徑改寫與可重複旗標
Release notes 說明：若 body 已引用本機路徑，會改寫為上傳 URL；否則附加在結尾。可重複 --attach 讓一次呼叫送出多個檔案（例如 PR 前後對照）。工程上，這接近把「資產暫存 → 置換 Markdown → 提交」收斂進單一 CLI 編排，減少人手複製連結時出錯。
3. 權限閘門與代理自動化邊界
Changelog 要求寫入權限；社群後續議題亦指出唯讀報告者、GitHub App installation token 等路徑仍可能失敗。對企業與代理流水線，含義是：自動化開單的服務帳號必須具備明確寫入範圍，且不能假設「網頁能拖圖、CLI 一定能上圖」。權限模型與網頁不完全對稱，是採用前必須寫進 runbook 的一點。
4. 與代理式開發工作流的交會
當 Cursor、Copilot 等代理會本地執行指令、截圖或錄屏時，--attach 成為「結果可審計」的出口：評審不必拉分支，也能先看畫面。它不取代程式碼審視，但把「看得見的回歸／缺陷」提前塞進 PR 敘事。
四、日常應用場景
1. 開發者與技術團隊
適合 UI 缺陷、渲染結果、錯誤對話框等「講不清、一看就懂」的案例。本地更新 gh 後，可把截圖納入既有 issue／PR 腳本；代理流水線可在失敗時自動 --attach 失敗畫面，縮短值班排查。
2. 企業與隱私敏感行業
附件會進入 GitHub 託管的使用者資產空間。含客戶畫面、內部系統截圖或未脫敏資料的錄影，仍須遵守資料分類與出境政策；寫入權杖亦屬高敏感憑證。受規管行業應先定義哪些倉庫允許 CLI 上圖、哪些必須人工審核後才貼。
3. 一般用戶
個人與開源倉庫即可使用（需寫入權限）。Enterprise Server 用戶此版尚不可用，須等後續支援或繼續用網頁上傳。
4. 香港與亞洲市場視角
香港外包與產品團隊大量以 GitHub 作交付中樞；遠端協作時，「截圖來回貼」往往拖慢驗收。--attach 讓終端與 CI／代理同一路徑交證據，對按里程碑計費的外包專案尤其有用。同時，涉及客戶內部系統畫面時，仍要處理 PDPO 與合約中的影像／螢幕錄影條款——工具變快，不等於合規自動過關。
若企業需要穩定的遠端開發產能（含美國 VPS、一年約、全遠端），可參考 YSK Limited 的遠端開發者外判：HK$2,000／月起。見 https://ysk.hk/services/outsourcing 。
五、專業評價與潛在考量
優勢
- 官方把痛點說清楚：CLI 只寫字、視覺證據要繞瀏覽器；
--attach直接補洞。 - 與 coding agents 敘事對齊，適合代理時代「結果可展示」的協作。
- 格式、容量、改寫規則寫在 Changelog／Release，工程落地門檻低。
- 全方案一般可用，無需另開預覽申請。
需要留意的地方
- 需要倉庫寫入權；唯讀報告者與部分 App token 路徑仍可能失敗（社群已開 enhancement）。
- 不支援 GitHub Enterprise Server（此版）。
- 附件仍在 GitHub 雲端；敏感畫面要先脫敏或改走內部工單系統。
- 影片額度依方案分級，長錄影可能要先壓縮。
結語
--attach 看似小旗標，實際把 GitHub CLI 從「文字工單機」推進到「可交付視覺證據的代理介面」。對香港開發與外包團隊，它能縮短 UI／回歸缺陷的澄清回合；對企業，則要同步管好寫入權杖與畫面敏感度。若你正以遠端協作交付產品，可了解 YSK Limited 的遠端開發者外判（HK$2,000／月起）：https://ysk.hk/services/outsourcing 。
參考來源
- GitHub CLI: Media in issues, pull requests, and comments（GitHub Changelog，2026-09-01）
- GitHub CLI 2.99.0 Release
- X 發現線索：@github 帖文（僅發現，非事實來源）
- YSK Limited，遠端開發者外判：https://ysk.hk/services/outsourcing