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进行交互，主要功能包括：

1. Get Latest Release: Use repo.get_latest_release() to get the latest release / 获取最新Release：使用repo.get_latest_release()获取最新发布版本
2. Get Release by Tag: Use repo.get_release(tag) to get the release for a specified tag / 获取指定Tag的Release：使用repo.get_release(tag)获取指定标签的Release
3. Get Asset List: Use release.get_assets() to get all downloadable assets / 获取资产列表：使用release.get_assets()获取所有可下载的资产
4. 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/repo

The script header already contains dependency declarations, uv will automatically resolve and install:

脚本头部已包含依赖声明，uv会自动解析并安装：

• pygithub
• requests
• click

Notes / 注意事项

1. Valid GitHub API access is required, authentication tokens may be needed in some cases / 需要有效的GitHub API访问，部分情况下可能需要配置认证令牌
2. Large asset files may require longer download times / 大型资产文件可能需要较长的下载时间
3. Please ensure sufficient disk space for saving downloaded files / 请确保有足够的磁盘空间用于保存下载的文件
4. Some private repositories may require appropriate access permissions / 部分私有仓库可能需要适当的访问权限
5. Authentication Token: If not specified via --token parameter, will automatically read from environment variable GITHUB_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.gz

Error 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 / 权限不足：对于私有仓库，需要提供有效的访问令牌