fix(userscript): use raw install url on pages

Author: linull24

.github/workflows/deploy-pages.yml

@@ -86,6 +86,7 @@ jobs:
           BASE_PATH: /${{ github.event.repository.name }}
           PUBLIC_GITHUB_CLIENT_ID: ${{ secrets.NEOXK_GITHUB_CLIENT_ID }}
           PUBLIC_GITHUB_OAUTH_PROXY_URL: ${{ vars.PUBLIC_GITHUB_OAUTH_PROXY_URL }}
+          VITE_GITHUB_REPO: ${{ github.repository }}
 
       - uses: actions/upload-pages-artifact@v3
         with:

app/src/config/userscript.ts

@@ -5,12 +5,23 @@ export interface UserscriptConfig {
 	scriptUrl: string;
 }
 
+function resolveRepoSlug() {
+	return import.meta.env?.VITE_GITHUB_REPO ?? '129s/NeoSHUSchedulingHelper';
+}
+
 const DEFAULT_CONFIG: UserscriptConfig = {
 	helpUrl:
 		import.meta.env?.VITE_USERSCRIPT_HELP_URL ??
-		`https://github.com/${import.meta.env?.VITE_GITHUB_REPO ?? '129s/NeoSHUSchedulingHelper'}#readme`,
+		`https://github.com/${resolveRepoSlug()}#readme`,
 	// Prefer `.user.js` suffix to ensure userscript managers trigger install reliably.
-	scriptUrl: `${base || ''}/backenduserscript/backend.user.js`
+	//
+	// On GitHub Pages, some setups (e.g. service worker, COOP/COEP headers, or routing fallbacks)
+	// can interfere with userscript managers' install interception. A raw.githubusercontent.com
+	// URL is the most stable install source.
+	scriptUrl: import.meta.env?.PROD
+		? import.meta.env?.VITE_USERSCRIPT_INSTALL_URL ??
+			`https://raw.githubusercontent.com/${resolveRepoSlug()}/main/app/static/backenduserscript/backend.user.js`
+		: `${base || ''}/backenduserscript/backend.user.js`
 };
 
 export function getUserscriptConfig(overrides?: Partial<UserscriptConfig>): UserscriptConfig {