github-api-uploadlisted
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