用途：在截图上加注手绘风格的框、箭头、标签、自由笔迹和遮盖（redact），让评审者或同事快速看到改动或问题所在。当用文字说不清位置（如“看右上角”），或截图含密钥需要分享前隐藏时使用。
两种命令，共用同一份 JSON spec（{ "version": 1, "annotations": [...] }）：
- uploads screenshot <url|file.html> --annotate <spec>：抓取实时页面，支持 CSS 选择器（优先）或像素坐标。
- uploads annotate <image> --spec <spec>：处理已有 PNG/JPEG，仅支持像素坐标，选择器会被拒绝。
标注类型：box（x,y,w,h 或 selector）、arrow（from、to 或 selector）、label（text，加 target/at 或 selector）、draw（points，至少 2 个 [x,y] 点，仅像素）、redact（x,y,w,h 或 selector，style 为 blur 或 solid）、svg（原始 SVG 片段）。几何类标注只能二选一提供像素几何或选择器；draw 和 svg 不接受选择器。样式（颜色、线宽、手绘粗糙度、字体）固定，仅支持单条标注颜色覆盖。
示例：选择器模式 uploads screenshot http://localhost:4321/settings --via local --annotate ./callouts.json --out settings.png；像素模式 uploads annotate ./before.png --spec ./callouts.json --out ./before.marked.png；从 stdin 读取用 --spec -。
注意：像素模式坐标是图像像素而非 CSS 像素，--viewport 1280x800@2x 时图像为 2560x1600，需换算，故有实时页面时优先用选择器。uploads.sh 对象上传后公开，截图含密钥、令牌、密码、会话 cookie 等秘密时须加 style: "solid" 的 redact 遮盖；blur 可能被还原，仅用于非敏感视觉清理。v1 中选择器解析仅限本地后端，--via remote 会拒绝含选择器的 spec。无效 spec 会逐条报错，选择器无匹配会直接失败。该技能止于生成标注后的 PNG，托管与嵌入 PR 由 github-screenshots 技能负责。完整参数见 uploads annotate --help 与 uploads screenshot --help。