名称： gitload
描述： >
当用户要求“从 GitHub 下载文件”、“从仓库获取文件夹”、“从 GitHub 获取代码”、“下载 GitHub 仓库”、“从 GitHub URL 获取文件”、“仅克隆文件夹”，或需要在不克隆整个仓库的情况下下载 GitHub 上的特定文件/文件夹时，应使用此技能。

gitload

使用 gitload CLI 从 GitHub URL 下载文件、文件夹或整个仓库。

使用场景

在以下情况下使用 gitload：
- 从仓库下载特定文件夹（而非整个仓库）
- 从 GitHub 获取单个文件
- 下载仓库内容（不含 git 历史记录）
- 创建 GitHub 内容的 ZIP 归档
- 通过身份验证访问私有仓库

不要在以下情况下使用 gitload：
- 需要完整的 git 历史记录（请改用 git clone）
- 仓库已克隆到本地
- 处理非 GitHub 仓库

前提条件

通过 npx 运行 gitload（无需安装）：

npx gitload-cli https://github.com/user/repo

或全局安装：

npm install -g gitload-cli

基本用法

下载整个仓库

gitload https://github.com/user/repo

在当前目录创建 repo/ 文件夹。

下载特定文件夹

gitload https://github.com/user/repo/tree/main/src/components

仅下载该文件夹内容，并创建 components/ 文件夹。

下载单个文件

gitload https://github.com/user/repo/blob/main/README.md

下载到自定义位置

gitload https://github.com/user/repo/tree/main/src -o ./my-source

将内容扁平化下载到当前目录

gitload https://github.com/user/repo/tree/main/templates -o .

下载为 ZIP 文件

gitload https://github.com/user/repo -z ./repo.zip

身份验证（用于私有仓库或速率限制）

使用 gh CLI（推荐）

gitload https://github.com/user/private-repo --gh

需要先运行 gh auth login。

使用显式令牌

gitload https://github.com/user/repo --token ghp_xxxx

使用环境变量

export GITHUB_TOKEN=ghp_xxxx
gitload https://github.com/user/repo

令牌优先级： --token > GITHUB_TOKEN > --gh

URL 格式

gitload 接受标准 GitHub URL：
- 仓库根目录： https://github.com/user/repo
- 文件夹： https://github.com/user/repo/tree/branch/path/to/folder
- 文件： https://github.com/user/repo/blob/branch/path/to/file.ext

常见模式

从模板文件夹搭建项目

gitload https://github.com/org/templates/tree/main/react-starter -o ./my-app
cd my-app && npm install

获取示例代码

gitload https://github.com/org/examples/tree/main/authentication

下载文档以供离线阅读

gitload https://github.com/org/project/tree/main/docs -z ./docs.zip

获取单个配置文件

gitload https://github.com/org/configs/blob/main/.eslintrc.json -o .

选项参考

错误处理

如果 gitload 失败：
1. 404 错误： 确认 URL 存在且可访问
2. 速率限制错误： 使用 --gh 或 --token 添加身份验证
3. 权限错误： 对于私有仓库，确保令牌具有 repo 权限范围
4. 网络错误： 检查网络连接

注意事项

• gitload 通过 GitHub API 下载内容，而非 git 协议
• 不保留 git 历史记录（如需历史记录，请使用 git clone）
• 大型仓库可能需要较长时间；建议下载特定文件夹
• 如果输出目录不存在，会自动创建