SuperAPI AI 工具集

gitload

编程与开发

查看项目

更新于 10-15 18:41

技能介绍

用途:gitload 用于从 GitHub URL 下载文件、文件夹或整个仓库内容。它通过 GitHub API 获取内容,不保留 git 历史,因此不适合需要完整提交记录的场景;这类需求应改用 git clone,且它只面向 GitHub 仓库。

主要能力:下载整个仓库、指定分支下的文件夹或单个文件;可用 -o 指定输出目录,或输出到当前目录;可用 -z 保存为 ZIP;支持私有仓库或缓解速率限制的认证,认证优先级为 --token 高于 GITHUB_TOKEN 环境变量,再次为 --gh。

使用方式:可直接用 npx 运行 npx gitload-cli https://github.com/user/repo,或全局安装 npm install -g gitload-cli 后使用 gitload 命令。基本示例:下载整个仓库用 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;自定义输出位置用 -o ./my-source,平铺到当前目录用 -o .;保存为 ZIP 用 -z ./repo.zip。私有仓库认证可用 --gh(需先 gh auth login)、--token ghp_xxxx,或设置 export GITHUB_TOKEN=ghp_xxxx。

适用场景:从模板目录搭建项目脚手架、抓取示例代码、离线保存文档、获取单个配置文件等,尤其适合只想要部分内容而不想克隆完整历史的情况。

限制:不保留 git 历史;仓库已本地克隆或使用非 GitHub 仓库时不宜使用;大仓库可能耗时,建议只下载特定文件夹。常见错误中,404 需确认 URL 存在且可访问,限流需认证,私有仓库令牌需具备 repo 权限,网络错误需检查连接。输出目录不存在时会自动创建。定价、平台支持范围等事实暂未提供。