快速上手

本指南從 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