Git Manager

Git 仓库管理技能，支持五大平台批量操作和 Gitea 运维。

核心脚本

执行方式：

python scripts/batch_clone.py [args]
python scripts/batch_pull.py  [args]
python scripts/git_ops.py     [args]
python scripts/git_lfs.py      [args]

依赖： Python 3.8+，纯标准库，零额外依赖。

高频场景速查

批量克隆（batch_clone.py）

# GitHub org
python scripts/batch_clone.py --platform github --type org --id my-org --output ./repos

# GitLab group（含子组）
python scripts/batch_clone.py --platform gitlab --host https://gitlab.com 
  --type group --id 123456 --token $GITLAB_TOKEN --output ./repos

# GitHub → Gitea 迁移（启用镜像同步）
python scripts/batch_clone.py --platform gitea --host https://gitea.com 
  --migrate --src https://github.com/user/repo --name myrepo 
  --token $GITEA_TOKEN

# 创建 Gitea 组织（需管理员 token）
python scripts/batch_clone.py --platform gitea --host https://gitea.com 
  --create-org myorg --desc "Team" --token $GITEA_ADMIN_TOKEN

# 触发 Gitea 镜像同步
python scripts/batch_clone.py --platform gitea --host https://gitea.com 
  --sync --owner myuser --repo myrepo --token $GITEA_TOKEN

# 并发 + LFS + 过滤
python scripts/batch_clone.py --platform github --type org --id my-org 
  --output ./repos --workers 4 --lfs --filter api --limit 10

参数说明：

• --platform: github / gitlab / gitea / bitbucket / azure
• --type: org / group / user / project（按平台选填）
• --token: 支持 GITHUB_TOKEN / GITLAB_TOKEN / GITEA_TOKEN 环境变量
• --workers N: 并发克隆（默认 1，4-8 显著加速）
• --format json: JSON 输出便于程序化处理
• --dry-run: 仅预览不克隆
• --archived: 包含已归档仓库
• --recursive / --no-recursive: GitLab 子组控制（默认开启）

批量更新（batch_pull.py）

python scripts/batch_pull.py ./repos --rebase --stash --workers 4
python scripts/batch_pull.py ./repos --dry-run        # 预览

单仓库操作（git_ops.py）

# 克隆
python scripts/git_ops.py clone  [dest] [-b branch] [--depth N] [--lfs]

# 暂存 + 提交
python scripts/git_ops.py add     -A && 
python scripts/git_ops.py commit  -m "msg"

# 合并 / 衍合
python scripts/git_ops.py merge    --no-ff
python scripts/git_ops.py rebase  --branch main

# 查看
python scripts/git_ops.py diff   --staged
python scripts/git_ops.py log    --oneline --graph -n 20

# 进阶
python scripts/git_ops.py stash       --save "wip"
python scripts/git_ops.py reflog       -n 30      # 找回丢失提交
python scripts/git_ops.py worktree     --add ../feat -b feature
python scripts/git_ops.py bisect       --start HEAD v1.0.0
python scripts/git_ops.py cherry-pick  abc1234
python scripts/git_ops.py grep         "TODO" -n

Git LFS（git_lfs.py）

python scripts/git_lfs.py ./repo --install
python scripts/git_lfs.py ./repo --track "*.psd" "*.zip" "*.pdf"
python scripts/git_lfs.py ./repo migrate --pattern "*.zip" --to lfs

平台 ID 类型

用户意图 → 脚本映射

注意事项

1. Token 安全：使用环境变量而非命令行参数暴露 token
2. Rate Limit：GitHub 未认证仅 60次/小时，批量操作务必加 --token
3. rebase 风险：已推送的公共分支禁止 rebase
4. 冲突处理：merge/rebase 遇冲突后 git add + git merge/rebase --continue
5. GitLab group_id：Group → Settings → General 查看数字 ID
6. Gitea pull mirror：需服务器管理员在 app.ini 设置 PULL_REQUEST_PUSH_MIRRORS=true
7. LFS 依赖：目标机器需先安装 git-lfs

参考资料

完整示例见 examples.md，包含 13 个覆盖所有平台和 Gitea 运维的完整场景。