Configure GitHub Packages restore in CI

Author: LouisDing

.github/workflows/cd.yml

@@ -51,13 +51,35 @@ jobs:
             exit 1
           }
 
+      - name: Verify GitHub Packages token
+        shell: pwsh
+        env:
+          GH_PACKAGES_TOKEN: ${{ secrets.GH_PACKAGES_TOKEN }}
+        run: |
+          if ([string]::IsNullOrWhiteSpace($env:GH_PACKAGES_TOKEN)) {
+            Write-Error "Missing repository secret GH_PACKAGES_TOKEN. Create a classic PAT with read:packages permission for GitHub Packages restore."
+            exit 1
+          }
+
       # ── 3. 設定 .NET 8 ───────────────────────────────────────────────────────
       - name: Setup .NET 8
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: "8.0.x"
 
       # ── 4. Restore & Publish（self-contained, win-x64）──────────────────────
+      - name: Configure GitHub Packages NuGet source
+        shell: pwsh
+        env:
+          GH_PACKAGES_TOKEN: ${{ secrets.GH_PACKAGES_TOKEN }}
+        run: |
+          dotnet nuget add source `
+            --username JJDing-Louis `
+            --password $env:GH_PACKAGES_TOKEN `
+            --store-password-in-clear-text `
+            --name JJDing-Louis `
+            "https://nuget.pkg.github.com/JJDing-Louis/index.json"
+
       - name: Restore NuGet packages
         run: dotnet restore YTDownloader.sln
 

.github/workflows/ci.yml

@@ -19,6 +19,28 @@ jobs:
         with:
           dotnet-version: "8.0.x"
 
+      - name: Verify GitHub Packages token
+        shell: pwsh
+        env:
+          GH_PACKAGES_TOKEN: ${{ secrets.GH_PACKAGES_TOKEN }}
+        run: |
+          if ([string]::IsNullOrWhiteSpace($env:GH_PACKAGES_TOKEN)) {
+            Write-Error "Missing repository secret GH_PACKAGES_TOKEN. Create a classic PAT with read:packages permission for GitHub Packages restore."
+            exit 1
+          }
+
+      - name: Configure GitHub Packages NuGet source
+        shell: pwsh
+        env:
+          GH_PACKAGES_TOKEN: ${{ secrets.GH_PACKAGES_TOKEN }}
+        run: |
+          dotnet nuget add source `
+            --username JJDing-Louis `
+            --password $env:GH_PACKAGES_TOKEN `
+            --store-password-in-clear-text `
+            --name JJDing-Louis `
+            "https://nuget.pkg.github.com/JJDing-Louis/index.json"
+
       - name: Restore NuGet packages
         run: dotnet restore YTDownloader.sln
 

docs/PUBLIC_RELEASE_REPO.md

@@ -33,7 +33,7 @@ release-repo-template/
 
 ## Required Secret
 
-The private source repository needs a GitHub Actions secret:
+The private source repository needs a GitHub Actions secret for public release publishing:
 
 ```text
 RELEASE_REPO_TOKEN
@@ -50,6 +50,28 @@ Use a fine-grained personal access token with access only to the public release
 - Contents: Read and write
 - Metadata: Read
 
+## Required NuGet Package Secret
+
+The private source repository also needs a GitHub Actions secret for restoring private GitHub Packages:
+
+```text
+GH_PACKAGES_TOKEN
+```
+
+Use a personal access token classic with:
+
+```text
+read:packages
+```
+
+The workflow uses this token to add:
+
+```text
+https://nuget.pkg.github.com/JJDing-Louis/index.json
+```
+
+as a NuGet source before running `dotnet restore`.
+
 ## Publish Flow
 
 1. Create or update the private source repository.

docs/RELEASE.md

@@ -47,7 +47,10 @@ The CD workflow will:
 6. create a GitHub Release in `JJDing-Louis/YTDownloader-Release`;
 7. upload the installer and hash file to the public release repository.
 
-The workflow requires the private source repository secret `RELEASE_REPO_TOKEN`.
+The workflow requires these private source repository secrets:
+
+- `RELEASE_REPO_TOKEN`: fine-grained PAT that can write releases to `JJDing-Louis/YTDownloader-Release`.
+- `GH_PACKAGES_TOKEN`: classic PAT with `read:packages` permission so GitHub Actions can restore `JJNET.DataAccess` and `JJNET.Utility` from GitHub Packages.
 
 ## Local Installer Build