通过REST API操作GitLab仓库，支持读写文件、分支管理、项目列表等完整仓库操作
说明：
## 核心用法
GitLab API 技能提供通过 REST API 与 GitLab 仓库交互的能力，支持 GitLab.com 及私有化部署实例。核心功能包括：
**认证配置**：通过 `~/.config/gitlab/api_token` 存储个人访问令牌，支持 `api` 或 `read_api+write_repository` 权限范围；私有化部署可通过 `~/.config/gitlab/instance_url` 配置自定义地址。
**仓库操作**：
– 项目管理：列出项目、获取项目ID（支持 `namespace/project` 路径编码）
– 文件操作：读取（自动 base64 解码）、创建/更新（POST/PUT）、删除文件
– 目录浏览：递归列出目录树结构
– 分支管理：列出分支、创建新分支
– 归档下载：获取仓库压缩包
**辅助工具**：提供 `gitlab_api.sh` 脚本封装常用命令，简化交互流程。
## 显著优点
1. **完整覆盖**：涵盖 GitLab API v4 核心端点，满足日常仓库管理需求
2. **灵活部署**：同时支持 SaaS 和私有化 GitLab 实例
3. **标准化流程**：采用标准 curl + JSON 交互模式，易于理解和扩展
4. **脚本化支持**：内置 helper 脚本降低重复命令编写成本
## 潜在缺点与局限性
1. **手动配置依赖**：Token 和实例地址需手动文件配置，无交互式引导
2. **速率限制敏感**：GitLab.com 限制 300请求/分钟，批量操作需自行控制频率
3. **无高级功能**：不包含 CI/CD 触发、Issue 管理、Merge Request 操作等扩展能力
4. **base64 编解码**：文件内容需手动 base64 处理，增加使用复杂度
5. **路径编码要求**：项目路径中的 `/` 需手动编码为 `%2F`
## 适合人群
– 需要自动化 GitLab 仓库操作的开发者和 DevOps 工程师
– 在 CI/CD 流水线外需要快速脚本化仓库管理的场景
– 使用私有化 GitLab 实例的团队运维人员
## 常规风险
– **令牌泄露风险**：Token 以明文存储于本地文件，需确保 `~/.config/gitlab/` 目录权限正确（建议 `chmod 700`）
– **误操作不可逆**：文件删除、分支覆盖等操作直接生效，无二次确认机制
– **权限放大**：`api` scope 权限过大，建议按最小权限原则配置 `read_api` + `write_repository`
– **网络暴露**：curl 命令可能通过进程列表暴露 Token，建议在受控环境执行
会员专属
