← ClaudeAtlas

github-api-uploadlisted

git push 因 github.com 被墙(443 连接失败/超时)时,改用 gh CLI + GitHub API(api.github.com)通道上传文件并创建提交。支持空仓库初始化、多文件单次提交、绕过网络封锁。
rosalynthompson32-a11y/github-api-upload · ★ 1 · Code & Development · score 70
Install: claude install-skill rosalynthompson32-a11y/github-api-upload
# GitHub API 通道上传(绕过 github.com 封锁) ## 原理 `gh` CLI 走 `api.github.com`(GitHub 官方 API 域名,通常未被封锁),用 Git Data API 直接创建 blob / tree / commit 并更新分支引用,完全不需要经过 `github.com:443`。 ## 依赖 - gh CLI 已安装且 `gh auth status` 显示已登录 - Python 3 ## 用法 ```bash python scripts/upload_to_github.py <本地目录> <owner/repo> [文件1 文件2 ...] ``` - 不传文件列表时,自动上传目录内全部文件(非递归) - 依赖 gh 位置:默认 `C:\Program Files\GitHub CLI\gh.exe`,可用环境变量 `GH_BIN` 覆盖 ## 流程(脚本内部) 1. 检查远端 `refs/heads/main` 是否存在;不存在(空仓库)则用 contents API `PUT` 第一个文件,自动初始化 main 分支 2. 其余文件:Git Data API 创建 blob(UTF-8 直传) 3. 用所有 blob sha 创建 tree 4. 创建 commit(指向 tree) 5. `PATCH refs/heads/main` 指向新 commit ## 踩坑记录(2026-08-25 实测) - **gh api 参数顺序敏感**:endpoint 必须放在 `--input` 之前,否则报 `accepts 1 arg(s), received 0` - **空仓库不能直接用 Git Data API**:报 `Git Repository is empty`(HTTP 409),必须先 contents API 初始化首个提交 - **API 提交绕过本地 git**:本地仓库与远端会分叉;网络恢复后需 `git fetch` + merge/rebase 协调 - 文本文件走 Git Data API UTF-8 直传最快;二进制文件应在脚本内 base64 后走 contents API