GitHub CLI 2.99 更新说明：issue/PR 媒体附件上传与 issue develop worktree
GitHub CLI 于 2026 年 9 月 1 日发布 2.99.0。本版本把媒体附件能力带进了 gh 命令行：在 issue、pull request 与评论中直接上传图片和视频，并扩展了 gh issue develop 的 worktree 支持。
核心新能力
--attach 媒体附件：可重复使用的 --attach 标志把本地图片/视频上传到 GitHub.com 与 GitHub Enterprise Cloud，并自动写入正文：
# 创建/编辑 issue 时附带文件
gh issue create --attach './repro.png#The error state'
gh issue edit 123 --attach ./walkthrough.mp4
# 创建/编辑 PR 时附带
gh pr create --attach ./before.png
gh pr edit 456 --attach ./after.png
# 评论附带
gh issue comment 123 --attach ./repro.png
若正文已引用本地路径，gh 会用上传后的 URL 替换；否则追加到正文。单次调用可重复传入多个文件（单批上限 50 个）。详情见 https://gh.io/gh-attach。
gh issue develop 支持 worktree：可为 issue 创建关联分支并在新的 Git worktree 中检出，不打扰当前工作区：
gh issue develop 123 --checkout --worktree /path/to/wt-feature
其他变化
gh被编码代理（coding agent）调用时使用纯文本 spinner 输出，日志更干净；- 修复
repo sync在 linked worktree 下的分支占用提示与潜在损坏、pr merge --delete-branch对 linked worktree 的安全处理、issue develop对非空 worktree 目标的拒绝、view --comments与--json互斥校验； - Codex 用户技能安装目录调整为
~/.agents/skills，并尊重PI_CODING_AGENT_DIR。
适用场景
- 命令行重度用户提交 bug 复现（截图/录屏）时可直接内联附件；
- 多 worktree 工作流用户可安全使用
gh issue develop --checkout --worktree。