快速上手

本指南从 GitHub 网盘安装并启动后开始。

提示

还没有安装？前往下载与安装。

1. 连接 GitHub 或使用只读模式

首次启动时，选择所需的仓库访问方式：

• 连接 GitHub App（推荐）：应用会复制一次性验证码并打开 GitHub 授权页面。输入验证码、安装 GitHub App，再选择允许 GitHub 网盘访问的仓库。
• 以只读模式继续：无需登录即可浏览兼容的公开仓库，但不能上传或修改文件。
• Personal Access Token（高级）：仅在 GitHub App 授权不可用时用于兼容或故障排查。

凭据保存在操作系统凭据库中。之后可以在“账号”页面重新连接、调整仓库授权或退出登录。

2. 添加仓库

打开“主页”，选择“添加仓库”。你可以：

• 创建新的网盘仓库。
• 使用完整的 所有者/仓库名 添加已有兼容仓库。

新建仓库时，应用会自动创建所需的 netdisk.json 结构。

创建仓库需要先登录。如果只想临时打开仓库，可以进入“浏览”，输入 所有者/仓库名、选择分支，再点击“打开”。兼容仓库必须在该分支包含 netdisk.json。

3. 浏览与管理文件

“浏览”工具栏支持上传、下载、另存为、重命名、删除、刷新和新建文件夹，也可以递归下载整个文件夹。

对单个文件选择“生成链接”，可以得到适合分享的 GitHub 网盘下载页；只有小于 1.9 GiB 且未分片的文件才能生成原始 Release 直链。

公开仓库无需登录即可浏览；修改内容需要当前账号拥有该仓库的写入权限。

4. 查看传输任务

打开“任务”，可以查看下载、上传、已完成和失败任务。传输过程中可以暂停、恢复或取消任务；也可以移除旧记录，或在文件夹中显示已完成的下载。

大文件会自动分片与合并，下载完成后使用 SHA-256 校验。源文件未发生变化时，恢复上传还会复用 GitHub 上已经完成的分片。

5. 调整应用设置

打开“设置”，可以调整：

• 主题、云母效果、界面语言与缩放比例。
• 系统托盘行为，以及关闭主窗口时是否退出应用。
• 文件夹优先排序与默认下载位置。
• aria2 及其可执行文件路径。
• 公开仓库下载的最快镜像。
• 自动检查更新。

应用链接

安装后的应用会注册 github-netdisk:// 协议。受支持的链接可以打开仓库或预先填写传输任务；应用会展示解析后的内容，并在执行前请求确认。

github-netdisk://new-task/download/repo/?uri=owner/repo@branch/path/to/file&filename=file.bin
github-netdisk://new-task/upload/url/?uri=https%3A%2F%2Fexample.com%2Fupload&filename=/local/file.bin
github-netdisk://browse-repo/?repo=owner/repo&branch=main