用途：验证 GitHub Pages（及 Netlify、Vercel、Cloudflare Pages、S3+CloudFront 等 CDN 前端站点）部署后是否真的在提供新内容，而非仅完成合并。
主要能力：提供有界轮询函数 poll_deploy，接受 URL、标记字符串和最大尝试次数；给出四种明确结果——LIVE（成功返回 0）、HTTP FAILURE、STALE CONTENT、TIMEOUT（均返回非零），并把构建状态查询推迟到尝试上限之后，避免多余 API 调用。支持同步 until 循环与后台运行（run_in_background: true）两种模式。
必要用法：轮询标记必须选取部署前不存在的字符串，例如新增的 CSS 规则、类名、token 值、文案或 meta 标签中的新 commit 哈希；不要用此前已存在的元素选择器或仅值变动的 token 名。避免写入 sleep 35 && curl 这类被 Bash 工具阻塞的定时链，改用有界函数。可用 git diff HEAD~1 -- . | grep '^+' 获取候选标记。
限制：gh api repos/.../pages/builds/latest 只是参考，不具权威性，会滞后于实际内容，应以 curl 生产 URL 为准；自定义域名与 CDN 边缘（Cloudflare、Fastly）可能延长传播时间，需据预期窗口设置尝试上限；若部署由 CI 工作流控制，先 gh run watch 看工作流，再单独用 curl 循环确认内容传播。若轮询对通常需 30 秒以上的平台不到约 5 秒就成功，说明标记匹配了旧内容，应重新选择。deploy_status 命令与尝试次数由采用者自定。