# Github Publish Windows

> Use when publishing to GitHub on Windows: 代理、gh 登录、API 上传。

- Skill: `liberation8/github-publish-windows` (Agent Skill)
- Install (CLI): `npx skillmds@latest add liberation8/github-publish-windows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/liberation8/github-publish-windows/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: liberation8 (https://skillmd.com/u/liberation8)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/liberation8/github-publish-windows

---


# Windows 上发布内容到 GitHub（代理环境实战）

在 Windows（国内网络/Clash 代理环境）上把文件或技能发布到 GitHub 的完整流程。
已实战验证：解决 GitHub 访问、安装 gh、设备流登录、创建仓库、API 上传、公开化。

## 核心要点

1. **GitHub 访问不通的根因通常是代理没运行**：检查 Clash 内核端口（默认 7897）是否 LISTENING + 系统代理 ProxyEnable 是否=1。
2. **gh 的 HTTP 请求不读 Windows 系统代理，只读环境变量**：运行 gh 前必须 `export HTTPS_PROXY=http://127.0.0.1:7897`。
3. **git push 走代理可能 SSL 失败**（schannel/openssl 都不行、Clash 分流 github.com 不稳）→ **改用 gh api 上传文件**（api.github.com 走代理稳定）。
4. **gh 交互式登录在 pty 后台的坑**：卡在 "Press Enter to open..." 时，`process submit` 传空数据无效，必须用 `process write` 发 `\r`（Windows 回车）。
5. **git 直连 github.com 有时通有时超时**（DNS 轮询到不同 IP），curl/PowerShell 测试结果可能矛盾，以 PowerShell Invoke-WebRequest 为准。

## 标准流程

### 1. 检查并修复网络（GitHub 访问不了时）
```bash
# 检查代理端口
netstat -ano | grep -E "7897"          # 无输出 = Clash 内核没跑
# 检查系统代理
powershell -NoProfile -Command "Get-ItemProperty 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' | Select ProxyEnable,ProxyServer"
# 干净网络测试（PowerShell 为准，别信 git-bash curl 的偶然 200）
powershell -NoProfile -Command "Invoke-WebRequest -Uri 'https://github.com' -UseBasicParsing -TimeoutSec 10 | Select StatusCode"
```
修复：启动 Clash Verge（`Start-Process 'D:\Clash Verge\clash-verge.exe'`，路径以实际为准），
等 6 秒确认 7897 LISTENING，然后开系统代理：
```powershell
Set-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' -Name ProxyEnable -Value 1
Set-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' -Name ProxyServer -Value '127.0.0.1:7897'
# 广播变更（wininet.dll InternetSetOption, 选项 39 和 37）
```

### 2. 安装 gh CLI
```bash
winget install --id GitHub.cli --accept-source-agreements --accept-package-agreements --silent
export PATH="$PATH:/c/Program Files/GitHub CLI"   # 新 shell 需手动加
```

### 3. gh 设备流登录（浏览器授权）
```bash
export HTTPS_PROXY="http://127.0.0.1:7897" ; export HTTP_PROXY="http://127.0.0.1:7897" ; export ALL_PROXY="http://127.0.0.1:7897"
gh auth login --hostname github.com --git-protocol https --web
```
用 background + pty 启动，然后：
1. 遇到 "Authenticate Git with your GitHub credentials?" → `process submit` 发 `Y`
2. 拿到 "one-time code: XXXX-XXXX" → 用 Edge 打开 https://github.com/login/device（`Start-Process msedge 'https://github.com/login/device'`），让用户登录账户并输入 code 授权
3. **卡在 "Press Enter to open..." 时用 `process write` 发 `\r`**（submit 空数据无效）
4. 授权后轮询成功输出 "✓ Authentication complete."，验证：
```bash
gh auth status   # 应显示 Logged in to github.com account <用户名>
```

### 4. 创建仓库
```bash
gh repo create <repo-name> --private --source . --push --description "..." 
# 或先建空仓库再上传：
gh repo create <repo-name> --private --description "..."
```

### 5. 上传文件（git push SSL 失败时的可靠替代）
```bash
# 方案 A：git（代理下可能失败，失败见方案 B）
git config http.proxy http://127.0.0.1:7897
git push -u origin main

# 方案 B（推荐，稳定）：gh api 上传，内容 base64
cd <repo-dir>
gh api --method PUT "repos/<owner>/<repo>/contents/<path>" \
  -f message="Add <path>" \
  -f content="$(base64 -w0 <本地文件>)" --jq '.content.html_url'
```
注意：文件路径含目录（如 autonomous-ai-agents/xxx/SKILL.md）直接作为 contents/ 参数即可，自动建目录。

### 6. 公开化 + 完善
```bash
# 公开必须带后果确认标志，否则报错
gh repo edit <owner>/<repo> --visibility public --accept-visibility-change-consequences
# Topics
gh repo edit <owner>/<repo> --add-topic "topic1,topic2"
# LICENSE（MIT 模板 + 上传）
gh api --method PUT "repos/<owner>/<repo>/contents/LICENSE" -f message="Add MIT License" -f content="$(base64 -w0 LICENSE)"
# 验证
gh repo view <owner>/<repo> --json visibility,url
```

## 陷阱清单

- **git-bash 转义**：PowerShell 命令在 bash 里执行时 `$` 写 `\$`，内部双引号写 `\"`。
- **gh repo create --push 失败**：仓库已创建但 push 失败（SSL），远程已存在；后续直接用 gh api 上传即可，不用重建。
- **一次性验证码有效期**：约 15 分钟，过期需重新 gh auth login。
- **`--visibility` 报错**：必须加 `--accept-visibility-change-consequences`。
- **gh token 获取**：`gh auth token` 可拿到 token（供脚本用），注意别打印到日志。
- **hermes .env 里的 GITHUB_TOKEN 可能是注释占位符**（`# GITHUB_TOKEN=ghp_xx...`），不是有效凭据，别浪费时间用它。
- **Edge 打开 github.com/login/device 会累积标签页**：每次 Start-Process 新开标签，操作前先清理或指定当前标签。

## 验证步骤

1. `gh auth status` 显示已登录账户
2. `gh repo view <owner>/<repo>` 显示正确可见性
3. `gh api repos/<owner>/<repo>/contents` 列出所有文件
4. 浏览器打开仓库 URL 确认内容可访问