github-autosetup

GitHub AutoSetup v2 — 自动化 GitHub/git 配置（纯 Git Bash 驱动）

把 pi（或任意 agent）机器上的 GitHub/git 一次性配置到"提交即自动推送"，全程敏感信息零明文。所有自动化通过 Git Bash 完成（agent 的 bash 工具或用户 Git Bash 终端）。

为什么不用 PowerShell（v1 血泪教训）：Windows PowerShell 5.1 有三大坑 —— UTF-8 无 BOM 按 GBK 误读、Encoding::UTF8 写文件带 BOM 破坏 #!/bin/sh、原生命令引号解析（逗号列表绑成单串/内嵌引号被吞）。bash 侧这些全部不存在。本 skill 从 v1 失败中重建，已验证：Windows 11 + Git Bash + 大陆网络（github.com:443 被阻断）场景。

---

0. 敏感信息传递 SOP（先读，违反即事故）

铁律：任何密钥、令牌、口令、cookie 都不得进入对话文本、仓库、日志明文。

操作模式：agent 打印"终端复制块"（用户在自己 Git Bash 执行）或直接用自身 bash 工具执行；agent 只验证结果（gh auth status / ssh-add -l / git ls-remote），全程看不见秘密。验证输出一律掩码（sed 's/Token: .*/Token: ***/'）。

---

1. 环境探测（只读，bash）

bash "/scripts/probe.sh"

输出：git/gh/GCM/ssh-agent、git 身份、网络通道（github.com:443 / api.github.com:443 / github.com:22 / ssh.github.com:443）、现有密钥、gh 认证态（token 类型掩码）。

通道决策表：

2. 认证（HITL，两处需用户本人 Git Bash 操作）

① gh 浏览器 OAuth（未认证或令牌是 fine-grained PAT 时）：

gh auth login -h github.com -p  -w

• 前提核查：gh auth status 显示 Token: github_pat_* → fine-grained PAT 无法建仓（GitHub 官方限制），必须重走浏览器 OAuth（ghp_ 才可建仓）。
• 认证后核查：gh auth status 显示 (keyring) 即合格；hosts.yml 只应含元数据。

② SSH 密钥（带口令）+ agent（用户 Git Bash）：

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_gh -C "autopush"   # 输入口令两次，别留空
ssh-add ~/.ssh/id_ed25519_gh

• agent 未启用：powershell -c "Set-Service ssh-agent -StartupType Automatic; Start-Service ssh-agent"（仅此一步用 PowerShell，或用户管理员终端）。
• 注册公钥：gh ssh-key add ~/.ssh/id_ed25519_gh.pub --title "autopush"（token 无权限时用户网页粘贴 .pub，.pub 可公开展示）。
• ~/.ssh/config 追加（多密钥防混乱）：

  Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_gh
    IdentitiesOnly yes
  

• 验证：ssh -T git@github.com 应回 Hi <用户名>!。

3. 建仓与推送（agent bash）

gh config set git_protocol ssh --host github.com   # 或 https，按通道决策
gh repo create  -- --source <本地仓库目录> --remote origin --push

• 可见性必须向用户确认（代码/思考类 private；可发布 skill 类 public）。
• 本地目录先确保已 git init -b main + 首次 commit。
• 推送失败：网络（§1 决策表）/分支名（统一 main）/remote 协议。

4. 自动推送（提交即推 + 计划任务兜底）

bash "/scripts/install-autopush.sh" -d "D:/Agent Workspace" -t AutoSync -m 30 \
  "D:/Agent Workspace/Ziggy" "D:/Agent Workspace/Skill/meme-digger" ...

脚本自动完成（全 bash）：

1. 每个仓库装 .git/hooks/post-commit（printf 写 LF，零凭据）：

   #!/bin/sh
   branch=$(git symbolic-ref --short HEAD 2>/dev/null || echo main)
   [ "$branch" = "main" ] || exit 0
   git push origin "$branch" -q 2>/dev/null || echo "[autopush] push failed - retried by scheduler" >&2
   

2. 生成 autopush.sh（仓库清单内嵌 + ssh-add 告警 + 日志）。
3. 注册计划任务（默认每 30 分钟）：schtasks //create //tn AutoSync //tr "\"\" \"\"" //sc MINUTE //mo 30 //f。

验证（必做）：任一仓库提交临时文件 → git ls-remote origin main 与本地 HEAD 一致 → 清理。重启后提醒用户 ssh-add ~/.ssh/id_ed25519_gh（agent 重启清空）。

5. 收尾核查（安全自检）

• gh auth status → (keyring)；hosts.yml 无明文 token（掩码核查）
• 私钥有口令（ssh-keygen -y -P '' -f 应失败）；~/.ssh 权限收紧
• 无 token/口令出现在 git log、仓库文件、聊天、日志
• schtasks //query //tn <任务名> 存在；hook 文件为 LF
• cookie 类配置：gitignore 的 config、临时文件已删、git status 无敏感文件

6. 故障排查

7. 相关

• scripts/：probe.sh（探测）/ install-autopush.sh（安装）/ autopush.sh（生成式同步）
• 参考实现与测试记录：SgtBaixiao/github-autosetup；验证环境 Windows 11 + Git Bash
• v1 教训归档：Ziggy .scratch/github-bash-setup/issues/01-v1-lessons.md