用途:在 gh pr edit --body 出现静默失败(命令被接受但不持久化改动)时,提供通过 GitHub REST API 直接更新 PR 描述的回退方案;也适用于需要以多行内容程序化更新 PR 描述、或复杂 PR 模板编辑未生效的场景。
主要能力与使用方式:先用 gh pr view --json number -q '.number' 获取 PR 编号,再尝试标准做法 gh pr edit <PR_NUMBER> --body "$(cat <<'EOF'…EOF)";若无报错但改动未持久化,改用 gh api repos/OWNER/REPO/pulls/<PR_NUMBER> -X PATCH -f body="$(cat <<'EOF'…EOF)"。使用 heredoc 时必须用 <<'EOF'(单引号)以保留反引号、$变量与特殊字符,避免 shell 展开;必要时可用 --body-file 作为中间步骤。验证时可检查 API 返回 JSON 是否包含新正文,或用 gh pr view <PR_NUMBER> --json body -q '.body' 核对。
限制与注意:若 API 返回 422,需检查 PR 编号、仓库路径与 gh auth status 认证状态;若正文出现转义换行或格式问题,应改用单引号 heredoc;若命令成功但显示旧正文,可能受 GitHub API 最终一致性影响,可稍等、执行 gh pr view --refresh 或通过网页验证。资料未提供其他价格、平台或效果信息。