用途：在 GitHub PR 和 issue 中嵌入截图、图片、图表、GIF 与录屏；也可在 PR 尚未创建时于分支上暂存素材，PR 打开后自动提升并汇总为一条受管理的附件评论。
主要能力：支持通过 uploads screenshot 从 URL 或本地 HTML 页面直接截图并托管，可设置 viewport、等待条件、选择器、全页、减少动效、隐藏覆盖层等；支持 put/attach 上传已有文件，按 PR、issue、分支或键生成稳定公共 URL，并返回可直接粘贴的 markdown。可为素材打上 --state before/after、--meta path=/route 等可查询标签，并支持 uploads find 与上传元数据保留。还提供 change feed：uploads feed create owner/repo 或 --repo owner/repo --pr 123，生成按仓库或按 PR 的最新优先页面。
使用方式：已有 PR 时用 uploads put shot.png --pr 123 或 uploads attach shot.png；PR 未创建时在非默认分支上直接执行 uploads put 或 uploads screenshot 即可暂存，PR 打开后自动提升并生成评论。没有 shell 的环境走托管 MCP（https://agents.uploads.sh/mcp），使用 put 配合 contentBase64 + filename 或 contentUrl + repo + pr/branch。截图可用 uploads screenshot <url|file.html>，必要时通过 --wait-for 等待应用进入可交互状态再执行 --eval。
适用场景：PR 内的前后对比截图、UI 变更说明、流程 GIF/录屏、测试或 Lighthouse 报告等非媒体文件、需要在 Slack 或文档中复用的稳定公共图片链接，以及按仓库或按 PR 聚合的截图动态页。
限制：gh --attach 仅支持 10 MB 以内的图片/视频（付费计划视频至 100 MB），需 push 权限且 PR/issue 已存在；GitHub 没有公开 REST 上传端点。分支暂存自动提升只对已绑定工作区的仓库生效，未绑定会静默无操作，需用 uploads github link --status 确认绑定，或 PR 创建后显式运行 uploads attach --promote。托管 MCP 上没有 attach 工具，评论为 bot-only。受管理评论内联最多 16 张图片，超出会折叠。GIF 和视频不会被优化器改写，仅 PNG/JPEG 会转为 WebP。同一 PR 内建议只选一种方式，避免评论历史混乱。