Support passing JWT secret key on worker restart

Added the ability to pass a JWT secret key when restarting the worker process by updating environment variable handling and message passing. Improved port retry logic in the backend to allow multiple attempts on the same port before incrementing. Also refactored process API to use getter for pid property.

Ensure Electron app is ready before creating process manager

Adds a check to await electron.app.whenReady() if the Electron app is not yet ready before instantiating the ElectronProcessManager. This prevents potential issues when accessing Electron APIs before the app is fully initialized.

Add mirror selection support for version updates

Introduces the ability to specify and select GitHub mirror sources for fetching tags, releases, and action artifacts throughout the backend and frontend. Updates API endpoints, internal helper functions, and UI components to allow users to choose a mirror for version queries and updates, improving reliability in regions with limited GitHub access. Also enhances version comparison logic and improves artifact metadata display.

Refactor artifact fetching to use HTML parsing only

Removed all GitHub API dependencies for fetching workflow runs and artifacts. Now, workflow runs are parsed directly from the HTML of the Actions page, and artifact URLs are constructed using nightly.link. Also added workflow title and mirror fields to ActionArtifact, and simplified mirror list without latency comments.

packages/napcat-webui-backend/src/api/BaseInfo.ts

@@ -4,7 +4,7 @@ import { WebUiDataRuntime } from '@/napcat-webui-backend/src/helper/Data';
 import { sendSuccess } from '@/napcat-webui-backend/src/utils/response';
 import { WebUiConfig } from '@/napcat-webui-backend/index';
 import { getLatestTag, getAllTags, compareSemVer } from 'napcat-common/src/helper';
-import { getLatestActionArtifacts } from '@/napcat-common/src/mirror';
+import { getLatestActionArtifacts, getMirrorConfig } from '@/napcat-common/src/mirror';
 import { NapCatCoreWorkingEnv } from '@/napcat-webui-backend/src/types';
 
 export const GetNapCatVersion: RequestHandler = (_, res) => {
@@ -35,6 +35,7 @@ export interface VersionInfo {
   size?: number;
   workflowRunId?: number;
   headSha?: string;
+  workflowTitle?: string;
 }
 
 /**
@@ -47,11 +48,17 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
     const pageSize = parseInt(req.query['pageSize'] as string) || 20;
     const typeFilter = req.query['type'] as string | undefined; // 'release' | 'action' | 'all'
     const searchQuery = (req.query['search'] as string || '').toLowerCase().trim();
+    const mirror = req.query['mirror'] as string | undefined;
 
     let versions: VersionInfo[] = [];
     let actionVersions: VersionInfo[] = [];
     let usedMirror = '';
 
+    // If mirror is specified, report it as used (will be confirmed by actual fetching response)
+    if (mirror) {
+      usedMirror = mirror;
+    }
+
     // 懒加载：只获取需要的版本类型
     const needReleases = !typeFilter || typeFilter === 'all' || typeFilter === 'release';
     const needActions = typeFilter === 'action' || typeFilter === 'all';
@@ -59,9 +66,12 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
     // 获取正式版本（仅当需要时）
     if (needReleases) {
       try {
-        const result = await getAllTags();
-        usedMirror = result.mirror;
-        
+        const result = await getAllTags(mirror);
+        // 如果没有指定镜像，使用实际上使用的镜像
+        if (!mirror) {
+          usedMirror = result.mirror;
+        }
+
         versions = result.tags.map(tag => {
           const isPrerelease = /-(alpha|beta|rc|dev|pre|snapshot)/i.test(tag);
           return {
@@ -81,14 +91,19 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
     // 获取 Action Artifacts（仅当需要时）
     if (needActions) {
       try {
-        const artifacts = await getLatestActionArtifacts('NapNeko', 'NapCatQQ', 'build.yml', 'main');
+        const { artifacts, mirror: actionMirror } = await getLatestActionArtifacts('NapNeko', 'NapCatQQ', 'build.yml', 'main', 10, mirror);
 
         // 根据当前工作环境自动过滤对应的 artifact 类型
         const isFramework = WebUiDataRuntime.getWorkingEnv() === NapCatCoreWorkingEnv.Framework;
         const targetArtifactName = isFramework ? 'NapCat.Framework' : 'NapCat.Shell';
 
+        // 如果没有指定镜像，且 action 实际上用了一个镜像（自动选择的），更新 usedMirror
+        if (!mirror && actionMirror) {
+          usedMirror = actionMirror;
+        }
+
         actionVersions = artifacts
-          .filter(a => a.name === targetArtifactName)
+          .filter(a => a && a.name === targetArtifactName)
           .map(a => ({
             tag: `action-${a.id}`,
             type: 'action' as const,
@@ -99,6 +114,7 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
             size: a.size_in_bytes,
             workflowRunId: a.workflow_run_id,
             headSha: a.head_sha,
+            workflowTitle: a.workflow_title,
           }));
       } catch {
         // 获取失败时返回空列表
@@ -114,7 +130,9 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
       allVersions = allVersions.filter(v => {
         const tagMatch = v.tag.toLowerCase().includes(searchQuery);
         const nameMatch = v.artifactName?.toLowerCase().includes(searchQuery);
-        return tagMatch || nameMatch;
+        const titleMatch = v.workflowTitle?.toLowerCase().includes(searchQuery);
+        const shaMatch = v.headSha?.toLowerCase().includes(searchQuery);
+        return tagMatch || nameMatch || titleMatch || shaMatch;
       });
     }
 
@@ -155,3 +173,8 @@ export const SetThemeConfigHandler: RequestHandler = async (req, res) => {
   await WebUiConfig.UpdateTheme(theme);
   sendSuccess(res, { message: '更新成功' });
 };
+
+export const GetMirrorsHandler: RequestHandler = (_, res) => {
+  const config = getMirrorConfig();
+  sendSuccess(res, { mirrors: config.fileMirrors });
+};

packages/napcat-webui-backend/src/api/UpdateNapCat.ts

@@ -20,6 +20,8 @@ interface UpdateRequestBody {
   targetVersion?: string;
   /** 是否强制更新（即使是降级也更新） */
   force?: boolean;
+  /** 指定使用的镜像 */
+  mirror?: string;
 }
 
 // 更新配置文件接口
@@ -124,7 +126,7 @@ async function downloadFile (url: string, dest: string): Promise<void> {
 export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
   try {
     // 从请求体获取目标版本（可选）
-    const { targetVersion, force } = req.body as UpdateRequestBody;
+    const { targetVersion, force, mirror } = req.body as UpdateRequestBody;
 
     // 确定要下载的文件名
     const ReleaseName = WebUiDataRuntime.getWorkingEnv() === NapCatCoreWorkingEnv.Framework ? 'NapCat.Framework.zip' : 'NapCat.Shell.zip';
@@ -150,20 +152,21 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
 
       // 根据当前工作环境确定 artifact 名称
       const artifactName = ReleaseName.replace('.zip', ''); // NapCat.Framework 或 NapCat.Shell
-      
+
       // Action artifacts 通过 nightly.link 下载
       // 格式：https://nightly.link/{owner}/{repo}/actions/runs/{run_id}/{artifact_name}.zip
       const baseUrl = `https://nightly.link/NapNeko/NapCatQQ/actions/runs/${runId}/${artifactName}.zip`;
       actualVersion = targetTag;
 
       webUiLogger?.log(`[NapCat Update] Action artifact URL: ${baseUrl}`);
-      
+
       // 使用 mirror 模块查找可用的 nightly.link 镜像
       try {
         downloadUrl = await findAvailableDownloadUrl(baseUrl, {
           validateContent: true,
           minFileSize: 1024 * 1024,
           timeout: 10000,
+          customMirror: mirror,
         });
         webUiLogger?.log(`[NapCat Update] Using download URL: ${downloadUrl}`);
       } catch (error) {
@@ -178,6 +181,7 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
       const release = await getGitHubRelease('NapNeko', 'NapCatQQ', targetTag, {
         assetNames: [ReleaseName, 'NapCat.Framework.zip', 'NapCat.Shell.zip'],
         fetchChangelog: false, // 不需要 changelog，避免 API 调用
+        mirror,
       });
 
       const shellZipAsset = release.assets.find(asset => asset.name === ReleaseName);
@@ -193,6 +197,7 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
         validateContent: true,           // 验证 Content-Type 和状态码
         minFileSize: 1024 * 1024,        // 最小 1MB，确保不是错误页面
         timeout: 10000,                  // 10秒超时
+        customMirror: mirror,
       });
     }