GitHub Push — 安全自动推送工具

支持以下特性的自动化 GitHub 推送：

• 自动 SSH 配置：自动检测并加载 SSH 密钥
• 自动远程仓库配置：自动添加 git remote origin
• 自动冲突解决：自动执行 pull + rebase + force
• 防封禁机制：限速控制 + 提交批处理 + 智能校验

安装

无需外部依赖。仅使用标准 Git CLI（系统默认可用）。

使用示例

# 快速推送（自动完成全部配置）
python3 scripts/github_upload.py --repo owner/repo --path ./files --message "Update"

# 试运行（不执行真实推送）
python3 scripts/github_upload.py --repo owner/repo --path ./files --dry-run

# 强制推送（自动解决冲突）
python3 scripts/github_upload.py --repo owner/repo --path ./files --force

# 显示版本信息
python3 scripts/github_upload.py --version

配置

创建 config.yaml 文件以持久化保存配置项：

defaults:
  safe_mode: true
  min_delay: 3  # 操作间最小延迟（秒）
  max_delay: 5  # 操作间最大延迟（秒）
  batch_commits: true
  enable_validation: true
  dry_run: false
  
safety:
  max_commits_per_hour: 100
  max_pushes_per_hour: 50
  min_time_between_pushes: 180  # 推送冷却时间（秒），即 3 分钟

安全阈值

故障排查

错误：“Too frequent pushes”（推送过于频繁）

解决方案：下次推送前至少等待 3 分钟。

错误：“Repository not found”（仓库未找到）

解决方案：确认仓库存在且您拥有推送权限；验证 SSH 密钥已正确添加至 GitHub。

错误：“Permission denied (publickey)”（公钥权限拒绝）

解决方案：

# 加载 SSH 密钥
ssh-add ~/.ssh/id_ed25519

# 验证 SSH 连接
ssh -T git@github.com

错误：“Merge conflict”（合并冲突）

解决方案：脚本会通过 pull + rebase + force 自动处理该问题。若问题持续，请检查仓库当前状态。

错误：“Validation failed”（校验失败）

解决方案：

• 确认指定路径存在且可访问
• 确保待提交文件大小不超过 100MB（GitHub 限制）
• 检查是否存在敏感模式文件（例如 .env、id_rsa）

不适用场景

• 仅浏览 GitHub 内容
• 创建 Issue 或 PR
• 代码审查（review）

参考资料

• references/ —— 详细的配置与 API 文档
• scripts/ —— 完整的代码示例

MIT License — OpenClaw Skill Standard