GitHub Release Downloader / GitHub Release 下载器
Overview / 概述
This is a Claude Skill for downloading the latest Release assets from GitHub repositories. Using the PyGithub library, this skill can fetch the latest release version of a repository, list all available asset files, and download specified assets to a local directory based on user needs.
这是一个用于从GitHub仓库下载最新Release资产的Claude Skill。通过使用PyGithub库，该技能可以获取仓库的最新发布版本，列出所有可用的资产文件，并根据用户需求下载指定的资源到本地目录。
Features / 功能特点
- Automatically fetch the latest Release info from GitHub repositories / 自动获取GitHub仓库的最新Release信息
- Support downloading historical releases by specifying Release tags / 支持指定Release标签（Tag）下载历史版本
- Automatically filter and only download executables and archives (.exe,.zip,.tar.gz,.tar.zst,.dmg,.tar.bz2,.tar.xz) / 自动过滤只下载可执行文件和压缩包
- List all Release assets with name, size, and download URL / 列出所有Release资产的名称、大小和下载URL
- Support filtering and downloading specific assets by name / 支持按名称筛选并下载特定资产
- Support downloading all assets to a specified directory / 支持下载所有资产到指定目录
- Provide detailed download progress and status information / 提供详细的下载进度和状态信息
- Support custom download paths / 支持自定义下载路径
Usage / 使用方法
Basic Syntax / 基本语法
Please help me download Release from [owner]/[repo]
Examples:
Please help me download Release from octocat/Hello-World
Please help me download the latest Release from microsoft/vscode to ./origin/vscode
Please help me download "react.zip" from facebook/react请帮我从 [owner]/[repo] 下载Release资源
例如：
请帮我从 octocat/Hello-World 下载Release
请帮我从 microsoft/vscode 下载最新的Release到 ./origin/vscode 目录
请帮我从 facebook/react 下载名为 "react.zip" 的资源Parameter Description / 参数说明
- owner: GitHub repository owner username or organization name / GitHub仓库所有者用户名或组织名称
- repo: GitHub repository name / GitHub仓库名称
- download_path (optional): Download save directory path, defaults to "origin/{repo}" folder under current directory / 下载保存的目录路径，默认为当前目录下的"origin/{repo}"文件夹
- asset_name (optional): Specific asset name to download, downloads all assets if not specified / 要下载的特定资产名称，如果不指定则下载所有资产
- tag (optional): Specify Release tag (e.g., v1.0.0), downloads latest Release if not specified / 指定Release标签（如 v1.0.0），如果不指定则下载最新Release
Download All Assets / 下载所有资源
When not specifying a specific asset name, all asset files of that Release will be downloaded:
当不指定具体资产名称时，将下载该Release的所有资产文件：
Please help me download all Release assets from owner/repo
请帮我从 owner/repo 下载所有Release资源Download Specific Assets / 下载指定资源
You can filter and download specific asset files by name:
可以通过名称筛选下载特定的资源文件：
Please help me download "example-linux-x64.tar.gz" from owner/repo
请帮我从 owner/repo 下载名为 "example-linux-x64.tar.gz" 的资源Download Specific Tag Release / 下载指定Tag的Release
You can download a specific version's Release assets by specifying a Tag:
可以通过指定Tag来下载特定版本的Release资源：
Please help me download Release v1.0.0 from owner/repo
Please help me download Release v1.0.0 from owner/repo to ./history directory
请帮我从 owner/repo 下载 v1.0.0 版本的Release
请帮我从 owner/repo 下载 v1.0.0 版本到 ./history 目录Technical Implementation / 技术实现
This Skill uses PyGithub library to interact with GitHub API, main features include:
该Skill使用PyGithub库与GitHub API进行交互，主要功能包括：
- Get Latest Release: Use
repo.get_latest_release()to get the latest release / 获取最新Release：使用repo.get_latest_release()获取最新发布版本 - Get Release by Tag: Use
repo.get_release(tag)to get the release for a specified tag / 获取指定Tag的Release：使用repo.get_release(tag)获取指定标签的Release - Get Asset List: Use
release.get_assets()to get all downloadable assets / 获取资产列表：使用release.get_assets()获取所有可下载的资产 - Download Assets: Directly download asset files through
browser_download_url/ 下载资产：通过browser_download_url直接下载资产文件
Dependencies / 依赖要求
- Python 3.12+ / Python 3.12+
- PyGithub library / PyGithub库
- requests library (for file downloads) / requests库（用于文件下载）
- click library (CLI) / click库（命令行界面）
Direct Run (Recommended) / 直接运行（推荐）
This script supports uv auto-installing dependencies, just run directly:
该脚本支持uv自动安装依赖，直接运行即可：
# Direct run, uv will auto-install dependencies
uv run scripts/download_release.py owner repo
# With parameters
uv run scripts/download_release.py owner repo --tag v1.0.0
uv run scripts/download_release.py owner repo --asset-name "linux" --save-dir ./origin/repo# 直接运行，uv会自动安装依赖
uv run scripts/download_release.py owner repo
# 指定参数
uv run scripts/download_release.py owner repo --tag v1.0.0
uv run scripts/download_release.py owner repo --asset-name "linux" --save-dir ./origin/repoThe script header already contains dependency declarations, uv will automatically resolve and install:
脚本头部已包含依赖声明，uv会自动解析并安装：
- pygithub
- requests
- click
Notes / 注意事项
- Valid GitHub API access is required, authentication tokens may be needed in some cases / 需要有效的GitHub API访问，部分情况下可能需要配置认证令牌
- Large asset files may require longer download times / 大型资产文件可能需要较长的下载时间
- Please ensure sufficient disk space for saving downloaded files / 请确保有足够的磁盘空间用于保存下载的文件
- Some private repositories may require appropriate access permissions / 部分私有仓库可能需要适当的访问权限
- Authentication Token: If not specified via
--tokenparameter, will automatically read from environment variableGITHUB_TOKEN/ 认证令牌：如果未通过--token参数指定，将自动从环境变量GITHUB_TOKEN读取
Example Output / 示例输出
Example output when download is successful:
成功下载时的输出示例：
Fetching latest Release info from owner/repo...
Release version: v1.0.0
Release title: Initial Release
Number of assets: 3
Available assets:
1. example-linux-x64.tar.gz (size: 45.2 MB)
2. example-macos-x64.tar.gz (size: 48.1 MB)
3. example-windows-x64.zip (size: 50.3 MB)
Downloading: example-linux-x64.tar.gz
Download complete: ./origin/repo/example-linux-x64.tar.gz正在获取 owner/repo 的最新Release信息...
Release版本: v1.0.0
发布标题: Initial Release
资产数量: 3
可用资产：
1. example-linux-x64.tar.gz (大小: 45.2 MB)
2. example-macos-x64.tar.gz (大小: 48.1 MB)
3. example-windows-x64.zip (大小: 50.3 MB)
正在下载: example-linux-x64.tar.gz
下载完成: ./origin/repo/example-linux-x64.tar.gzError Handling / 错误处理
Common error situations and handling:
常见的错误情况及处理方式：
- Repository not found: Check if owner and repo names are correct / 仓库不存在：检查owner和repo名称是否正确
- No Release: The repository may not have published any Release yet / 无Release：该仓库可能尚未发布任何Release
- Network error: Check network connection or try using a proxy / 网络错误：检查网络连接或尝试使用代理
- Insufficient permissions: For private repositories, provide a valid access token / 权限不足：对于私有仓库，需要提供有效的访问令牌