fix: 尝试修复 Update apifox 错误

feat: ogg opus格式支持 fix #1593

.github/workflows/release.yml

@@ -10,7 +10,7 @@ permissions: write-all
 
 env:
   OPENROUTER_API_URL: https://91vip.futureppo.top/v1/chat/completions
-  OPENROUTER_MODEL: "copilot/gemini-3-flash-preview"
+  OPENROUTER_MODEL: "gemini-3-flash-preview"
   RELEASE_NAME: "NapCat"
 
 jobs:
@@ -118,7 +118,7 @@ jobs:
           sudo apt update
           sudo apt install -y aria2 unzip zip p7zip-full curl jq
 
-      - name: Download QQ x64, Node.js and Assemble NapCat.Shell.Windows.Node.zip
+      - name: Download and Assemble NapCat.Shell.Windows.Node.zip
         run: |
           set -euo pipefail
           TMPDIR=$(mktemp -d)
@@ -127,11 +127,9 @@ jobs:
           # -----------------------------
           # 1) 下载 QQ x64
           # -----------------------------
-          # JS_URL="https://cdn-go.cn/qq-web/im.qq.com_new/latest/rainbow/windowsConfig.js"
+          NT_URL="https://dldir1v6.qq.com/qqfile/qq/QQNT/32876254/QQ9.9.27.45627_x64.exe"
-          # JS_URL="https://slave.docadan488.workers.dev/proxy?url=https://cdn-go.cn/qq-web/im.qq.com_new/latest/rainbow/windowsConfig.js"
-          # NT_URL=$(curl -fsSL "$JS_URL" | grep -oP '"ntDownloadX64Url"\s*:\s*"\K[^"]+')
-          NT_URL="https://dldir1v6.qq.com/qqfile/qq/QQNT/eb263b35/QQ9.9.23.42086_x64.exe"
           QQ_ZIP="$(basename "$NT_URL")"
+          echo "Downloading QQ installer: $QQ_ZIP"
           aria2c -x16 -s16 -k1M -o "$QQ_ZIP" "$NT_URL"
           
           QQ_EXTRACT="$TMPDIR/qq_extracted"
@@ -164,11 +162,18 @@ jobs:
           # -----------------------------
           # 5) 拷贝 QQ 文件到 NapCat.Shell.Windows.Node
           # -----------------------------
-          QQ_TARGETS=("avif_convert.dll" "broadcast_ipc.dll" "config.json" "libglib-2.0-0.dll" "libgobject-2.0-0.dll" "libvips-42.dll" "ncnn.dll" "opencv.dll" "package.json" "QBar.dll" "wrapper.node")
+          QQ_TARGETS=("avif_convert.dll" "broadcast_ipc.dll" "config.json" "libglib-2.0-0.dll" "libgobject-2.0-0.dll" "libvips-42.dll" "ncnn.dll" "opencv.dll" "package.json" "QBar.dll" "wrapper.node" "LightQuic.dll")
           for name in "${QQ_TARGETS[@]}"; do
             find "$QQ_EXTRACT" -iname "$name" -exec cp -a {} "$OUT_DIR" \; || true
           done
 
+          # -----------------------------
+          # 5.1) 拷贝 win64 目录下的文件
+          # -----------------------------
+          mkdir -p "$OUT_DIR/win64"
+          find "$QQ_EXTRACT" -ipath "*/win64/SSOShareInfoHelper64.dll" -exec cp -a {} "$OUT_DIR/win64/" \; || true
+          find "$QQ_EXTRACT" -ipath "*/win64/parent-ipc-core-x64.dll" -exec cp -a {} "$OUT_DIR/win64/" \; || true
+
           # -----------------------------
           # 6) 拷贝仓库文件 napcat.bat 和 index.js
           # -----------------------------
@@ -178,6 +183,7 @@ jobs:
           # -----------------------------
           # 7) 拷贝 Node.exe 到 NapCat.Shell.Windows.Node
           # -----------------------------
+          NODE_VER="22.11.0"
           cp -a "$NODE_EXTRACT/node-v$NODE_VER-win-x64/node.exe" "$OUT_DIR/" || true
 
       - name: Upload Artifact
@@ -442,3 +448,34 @@ jobs:
             NapCat.Shell.zip
             NapCat.Shell.Windows.OneKey.zip
           draft: true
+
+      
+      - name: Update apifox
+        env:
+          APIFOX_TOKEN: ${{ secrets.APIFOX_TOKEN }}
+        run: |
+          npm i -g pnpm
+          pnpm i
+          pnpm run build:openapi
+
+          # 读取并压缩 openapi.json 内容
+          OPENAPI_CONTENT=$(cat packages/napcat-schema/dist/openapi.json | tr -d '\n\r\t' | sed 's/  */ /g' | sed 's/"/\\"/g')
+
+          # 构建 JSON 数据
+          JSON_DATA=$(printf '{
+              "input": "%s",
+              "options": {
+                  "endpointOverwriteBehavior": "OVERWRITE_EXISTING",
+                  "schemaOverwriteBehavior": "OVERWRITE_EXISTING",
+                  "updateFolderOfChangedEndpoint": true,
+                  "moduleId": 1140714,
+                  "deleteUnmatchedResources": true
+              }
+          }' "$OPENAPI_CONTENT")
+
+          curl --location -g --request POST 'https://api.apifox.com/v1/projects/5348325/import-openapi?locale=zh-CN' \
+          --header 'X-Apifox-Api-Version: 2024-03-28' \
+          --header "Authorization: Bearer $APIFOX_TOKEN" \
+          --header 'Content-Type: application/json' \
+          --data-raw "$JSON_DATA"
+

package.json

@@ -10,6 +10,7 @@
     "build:framework": "pnpm --filter napcat-framework run build || exit 1",
     "build:webui": "pnpm --filter napcat-webui-frontend run build || exit 1",
     "build:plugin-builtin": "pnpm --filter napcat-plugin-builtin run build || exit 1",
+    "build:openapi": "pnpm --filter napcat-schema run build:openapi || exit 1",
     "dev:shell": "pnpm --filter napcat-develop run dev || exit 1",
     "typecheck": "pnpm -r --if-present run typecheck",
     "test": "pnpm --filter napcat-test run test",

packages/napcat-core/external/appid.json

@@ -521,10 +521,14 @@
   },
   "9.9.27-45627": {
     "appid": 537340060,
-    "qua": "V1_WIN_NQ_9.9.26_45627_GW_B"
+    "qua": "V1_WIN_NQ_9.9.27_45627_GW_B"
   },
   "6.9.88-44725": {
     "appid": 537337594,
     "qua": "V1_MAC_NQ_6.9.88_44725_GW_B"
+  },
+  "3.2.25-45758": {
+    "appid": 537340249,
+    "qua": "V1_LNX_NQ_3.2.25_45758_GW_B"
   }
 }

packages/napcat-core/external/napi2native.json

@@ -166,5 +166,17 @@
   "6.9.88-44725-arm64": {
     "send": "2313C68",
     "recv": "09693E4"
+  },
+  "3.2.25-45758-x64": {
+    "send": "5CF8F30",
+    "recv": "31667E0"
+  },
+  "3.2.25-45758-arm64": {
+    "send": "3EB6554",
+    "recv": "149AF0C"
+  },
+  "9.9.27-45758-x64": {
+    "send": "0A6A6BC",
+    "recv": "1E87EC1"
   }
 }

packages/napcat-core/external/packet.json

@@ -674,5 +674,17 @@
   "6.9.88-44725-arm64": {
     "send": "3D79168",
     "recv": "3D7BA78"
+  },
+  "3.2.25-45758-x64": {
+    "send": "AAC4E00",
+    "recv": "AAC88A0"
+  },
+  "9.9.27-45758-x64": {
+    "send": "2E5C4A0",
+    "recv": "2E5FA20"
+  },
+  "3.2.25-45758-arm64": {
+    "send": "6D6F9A0",
+    "recv": "6D73350"
   }
 }

packages/napcat-core/services/NodeIKernelLoginService.ts

@@ -8,6 +8,7 @@ export interface LoginInitConfig {
   commonPath: string;
   clientVer: string;
   hostName: string;
+  externalVersion: boolean;
 }
 
 export interface PasswordLoginRetType {

packages/napcat-core/services/NodeIKernelNodeMiscService.ts

@@ -1,15 +1,17 @@
 import { GeneralCallResult } from './common';
 
 export interface NodeIKernelNodeMiscService {
-  writeVersionToRegistry(version: string): void;
+  writeVersionToRegistry (version: string): void;
 
-  getMiniAppPath(): unknown;
+  getMiniAppPath (): unknown;
 
-  setMiniAppVersion(version: string): unknown;
+  setMiniAppVersion (version: string): unknown;
 
-  wantWinScreenOCR(imagepath: string): Promise<GeneralCallResult>;
+  wantWinScreenOCR (imagepath: string): Promise<GeneralCallResult>;
 
-  SendMiniAppMsg(arg1: string, arg2: string, arg3: string): unknown;
+  SendMiniAppMsg (arg1: string, arg2: string, arg3: string): unknown;
 
-  startNewMiniApp(appfile: string, params: string): unknown;
+  startNewMiniApp (appfile: string, params: string): unknown;
+
+  getQimei36WithNewSdk (): Promise<string>;
 }

packages/napcat-core/wrapper.ts

@@ -87,9 +87,9 @@ export interface NodeQQNTWrapperUtil {
 
   fullWordToHalfWord (word: string): unknown;
 
-  getNTUserDataInfoConfig (): unknown;
+  getNTUserDataInfoConfig (): Promise<string>;
 
-  pathIsReadableAndWriteable (path: string): unknown; // 直接的猜测
+  pathIsReadableAndWriteable (path: string, type: number): Promise<number>; // type 2 , result 0 成功
 
   resetUserDataSavePathToDocument (): unknown;
 
@@ -158,7 +158,7 @@ export interface NodeIQQNTStartupSessionWrapper {
   stop (): void;
   start (): void;
   createWithModuleList (uk: unknown): unknown;
-  getSessionIdList (): unknown;
+  getSessionIdList (): Promise<Map<unknown, unknown>>;
 }
 export interface NodeIQQNTWrapperSession {
   getNTWrapperSession (str: string): NodeIQQNTWrapperSession;

packages/napcat-develop/loadNapCat.cjs

@@ -32,6 +32,7 @@ if (versionFolders.length === 0) {
 const BASE_DIR = path.join(versionsDir, selectedFolder, 'resources', 'app');
 console.log(`BASE_DIR: ${BASE_DIR}`);
 const TARGET_DIR = path.join(__dirname, 'dist');
+const TARGET_WIN64_DIR = path.join(__dirname, 'dist', 'win64');
 const QQNT_FILE = path.join(__dirname, 'QQNT.dll');
 const NAPCAT_MJS_PATH = path.join(__dirname, '..', 'napcat-shell', 'dist', 'napcat.mjs');
 
@@ -46,6 +47,12 @@ const itemsToCopy = [
   'package.json',
   'QBar.dll',
   'wrapper.node',
+  'LightQuic.dll'
+];
+
+const win64ItemsToCopy = [
+  'SSOShareInfoHelper64.dll',
+  'parent-ipc-core-x64.dll'
 ];
 
 async function copyAll () {
@@ -53,13 +60,23 @@ async function copyAll () {
   const configPath = path.join(TARGET_DIR, 'config.json');
   const allItemsExist = await fs.pathExists(qqntDllPath) &&
     await fs.pathExists(configPath) &&
-    (await Promise.all(itemsToCopy.map(item => fs.pathExists(path.join(TARGET_DIR, item))))).every(exists => exists);
+    (await Promise.all(itemsToCopy.map(item => fs.pathExists(path.join(TARGET_DIR, item))))).every(exists => exists) &&
+    (await Promise.all(win64ItemsToCopy.map(item => fs.pathExists(path.join(TARGET_WIN64_DIR, item))))).every(exists => exists);
 
   if (!allItemsExist) {
     console.log('Copying required files...');
     await fs.ensureDir(TARGET_DIR);
+    await fs.ensureDir(TARGET_WIN64_DIR);
     await fs.copy(QQNT_FILE, qqntDllPath, { overwrite: true });
     await fs.copy(path.join(versionsDir, 'config.json'), configPath, { overwrite: true });
+
+    // 复制 win64 目录下的文件
+    await Promise.all(win64ItemsToCopy.map(async (item) => {
+      await fs.copy(path.join(BASE_DIR, 'win64', item), path.join(TARGET_WIN64_DIR, item), { overwrite: true });
+      console.log(`Copied ${item} to win64`);
+    }));
+
+    // 复制根目录下的文件
     await Promise.all(itemsToCopy.map(async (item) => {
       await fs.copy(path.join(BASE_DIR, item), path.join(TARGET_DIR, item), { overwrite: true });
       console.log(`Copied ${item}`);

packages/napcat-shell/base.ts

@@ -109,6 +109,7 @@ async function initializeLoginService (
     commonPath: dataPathGlobal,
     clientVer: basicInfoWrapper.getFullQQVersion(),
     hostName: hostname,
+    externalVersion: false,
   });
 }
 

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

@@ -157,6 +157,8 @@ async function downloadFile (url: string, destPath: string, customMirror?: strin
 async function extractPlugin (zipPath: string, pluginId: string): Promise<void> {
   const PLUGINS_DIR = getPluginsDir();
   const pluginDir = path.join(PLUGINS_DIR, pluginId);
+  const dataDir = path.join(pluginDir, 'data');
+  const tempDataDir = path.join(PLUGINS_DIR, `${pluginId}.data.backup`);
 
   console.log(`[extractPlugin] PLUGINS_DIR: ${PLUGINS_DIR}`);
   console.log(`[extractPlugin] pluginId: ${pluginId}`);
@@ -169,8 +171,19 @@ async function extractPlugin (zipPath: string, pluginId: string): Promise<void>
     console.log(`[extractPlugin] Created plugins root directory: ${PLUGINS_DIR}`);
   }
 
-  // 如果目录已存在，先删除
+  // 如果目录已存在，先备份 data 文件夹，再删除
+  let hasDataBackup = false;
   if (fs.existsSync(pluginDir)) {
+    // 备份 data 文件夹
+    if (fs.existsSync(dataDir)) {
+      console.log(`[extractPlugin] Backing up data directory: ${dataDir}`);
+      if (fs.existsSync(tempDataDir)) {
+        fs.rmSync(tempDataDir, { recursive: true, force: true });
+      }
+      fs.renameSync(dataDir, tempDataDir);
+      hasDataBackup = true;
+    }
+
     console.log(`[extractPlugin] Directory exists, removing: ${pluginDir}`);
     fs.rmSync(pluginDir, { recursive: true, force: true });
   }
@@ -179,11 +192,36 @@ async function extractPlugin (zipPath: string, pluginId: string): Promise<void>
   fs.mkdirSync(pluginDir, { recursive: true });
   console.log(`[extractPlugin] Created directory: ${pluginDir}`);
 
+  try {
     // 解压
     await compressing.zip.uncompress(zipPath, pluginDir);
 
     console.log(`[extractPlugin] Plugin extracted to: ${pluginDir}`);
 
+    // 恢复 data 文件夹
+    if (hasDataBackup && fs.existsSync(tempDataDir)) {
+      // 如果新版本也有 data 文件夹，先删除
+      if (fs.existsSync(dataDir)) {
+        fs.rmSync(dataDir, { recursive: true, force: true });
+      }
+      console.log(`[extractPlugin] Restoring data directory: ${dataDir}`);
+      fs.renameSync(tempDataDir, dataDir);
+    }
+  } catch (e) {
+    // 解压失败时，尝试恢复 data 文件夹
+    if (hasDataBackup && fs.existsSync(tempDataDir)) {
+      console.log(`[extractPlugin] Extract failed, restoring data directory`);
+      if (!fs.existsSync(pluginDir)) {
+        fs.mkdirSync(pluginDir, { recursive: true });
+      }
+      if (fs.existsSync(dataDir)) {
+        fs.rmSync(dataDir, { recursive: true, force: true });
+      }
+      fs.renameSync(tempDataDir, dataDir);
+    }
+    throw e;
+  }
+
   // 列出解压后的文件
   const files = fs.readdirSync(pluginDir);
   console.log(`[extractPlugin] Extracted files:`, files);

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

@@ -34,8 +34,11 @@ export const QQCheckLoginStatusHandler: RequestHandler = async (_, res) => {
   const qqLoginStatus = WebUiDataRuntime.getQQLoginStatus();
   // 必须同时满足：已登录且在线（online 必须明确为 true）
   const isLogin = qqLoginStatus && isOnline === true;
+  // 检测掉线状态：已登录但不在线
+  const isOffline = qqLoginStatus && isOnline === false;
   const data = {
     isLogin,
+    isOffline,
     qrcodeurl: WebUiDataRuntime.getQQLoginQrcodeURL(),
     loginError: WebUiDataRuntime.getQQLoginError(),
   };
@@ -80,7 +83,17 @@ export const QQGetLoginListNewHandler: RequestHandler = async (_, res) => {
 
 // 获取登录的QQ的信息
 export const getQQLoginInfoHandler: RequestHandler = async (_, res) => {
-  const data = WebUiDataRuntime.getQQLoginInfo();
+  const basicInfo = WebUiDataRuntime.getQQLoginInfo();
+  // 从 OneBot 上下文获取实时的 selfInfo.online 状态
+  const oneBotContext = WebUiDataRuntime.getOneBotContext();
+  const selfInfo = oneBotContext?.core?.selfInfo;
+  const online = selfInfo?.online ?? undefined;
+  const avatarUrl = selfInfo?.avatarUrl;
+  const data = {
+    ...basicInfo,
+    online,
+    avatarUrl,
+  };
   return sendSuccess(res, data);
 };
 

packages/napcat-webui-backend/src/assets/sw_template.js

@@ -1,24 +1,157 @@
-const CACHE_NAME = 'napcat-webui-v{{VERSION}}';
+/**
-const ASSETS_TO_CACHE = [
+ * NapCat WebUI Service Worker
-  '/webui/'
+ * 
-];
+ * 路由缓存策略设计：
+ * 
+ * 【永不缓存 - Network Only】
+ *   - /api/*                          WebUI API
+ *   - /plugin/:id/api/*               插件 API
+ *   - /files/theme.css                动态主题 CSS
+ *   - /webui/fonts/CustomFont.woff    用户自定义字体
+ *   - WebSocket / SSE 连接
+ * 
+ * 【强缓存 - Cache First】
+ *   - /webui/assets/*                 前端静态资源（带 hash）
+ *   - /webui/fonts/*                  内置字体（排除 CustomFont）
+ *   - q1.qlogo.cn                     QQ 头像
+ * 
+ * 【网络优先 - Network First】
+ *   - /webui/* (HTML 导航)            SPA 页面
+ *   - /plugin/:id/page/*              插件页面
+ *   - /plugin/:id/files/*             插件文件系统静态资源
+ * 
+ * 【后台更新 - Stale-While-Revalidate】  
+ *   - /plugin/:id/mem/*               插件内存静态资源
+ */
+
+const CACHE_NAME = 'napcat-webui-v{{VERSION}}';
+
+// 缓存配置
+const CACHE_CONFIG = {
+  // 静态资源缓存最大条目数
+  MAX_STATIC_ENTRIES: 200,
+  // QQ 头像缓存最大条目数
+  MAX_AVATAR_ENTRIES: 100,
+  // 插件资源缓存最大条目数
+  MAX_PLUGIN_ENTRIES: 50,
+};
+
+// ============ 路由匹配辅助函数 ============
+
+/**
+ * 检查是否为永不缓存的请求
+ */
+function isNeverCache (url, request) {
+  // WebUI API
+  if (url.pathname.startsWith('/api/')) return true;
+
+  // 插件 API: /plugin/:id/api/*
+  if (/^\/plugin\/[^/]+\/api(\/|$)/.test(url.pathname)) return true;
+
+  // 动态主题 CSS
+  if (url.pathname === '/files/theme.css' || url.pathname.endsWith('/files/theme.css')) return true;
+
+  // 用户自定义字体
+  if (url.pathname.includes('/webui/fonts/CustomFont.woff')) return true;
+
+  // WebSocket 升级请求
+  if (request.headers.get('Upgrade') === 'websocket') return true;
+
+  // SSE 请求
+  if (request.headers.get('Accept') === 'text/event-stream') return true;
+
+  // Socket 相关
+  if (url.pathname.includes('/socket')) return true;
+
+  return false;
+}
+
+/**
+ * 检查是否为 WebUI 静态资源（强缓存）
+ */
+function isWebUIStaticAsset (url) {
+  // /webui/assets/* - 前端构建产物（带 hash）
+  if (url.pathname.startsWith('/webui/assets/')) return true;
+
+  // /webui/fonts/* - 内置字体（排除 CustomFont）
+  if (url.pathname.startsWith('/webui/fonts/') &&
+    !url.pathname.includes('CustomFont.woff')) return true;
+
+  return false;
+}
+
+/**
+ * 检查是否为外部头像（强缓存）
+ */
+function isQLogoAvatar (url) {
+  return url.hostname === 'q1.qlogo.cn' || url.hostname === 'q2.qlogo.cn';
+}
+
+/**
+ * 检查是否为插件文件系统静态资源（网络优先）
+ */
+function isPluginStaticFiles (url) {
+  // /plugin/:id/files/*
+  return /^\/plugin\/[^/]+\/files(\/|$)/.test(url.pathname);
+}
+
+/**
+ * 检查是否为插件内存静态资源（Stale-While-Revalidate）
+ */
+function isPluginMemoryAsset (url) {
+  // /plugin/:id/mem/*
+  return /^\/plugin\/[^/]+\/mem(\/|$)/.test(url.pathname);
+}
+
+/**
+ * 检查是否为插件页面（Network First）
+ */
+function isPluginPage (url) {
+  // /plugin/:id/page/*
+  return /^\/plugin\/[^/]+\/page(\/|$)/.test(url.pathname);
+}
+
+// ============ 缓存管理函数 ============
+
+/**
+ * 限制缓存条目数量
+ */
+async function trimCache (cacheName, maxEntries) {
+  const cache = await caches.open(cacheName);
+  const keys = await cache.keys();
+  if (keys.length > maxEntries) {
+    // 删除最早的条目
+    const deleteCount = keys.length - maxEntries;
+    for (let i = 0; i < deleteCount; i++) {
+      await cache.delete(keys[i]);
+    }
+    console.log(`[SW] Trimmed ${deleteCount} entries from cache`);
+  }
+}
+
+/**
+ * 按类型获取缓存限制
+ */
+function getCacheLimitForRequest (url) {
+  if (isQLogoAvatar(url)) return CACHE_CONFIG.MAX_AVATAR_ENTRIES;
+  if (isPluginStaticFiles(url) || isPluginMemoryAsset(url)) return CACHE_CONFIG.MAX_PLUGIN_ENTRIES;
+  return CACHE_CONFIG.MAX_STATIC_ENTRIES;
+}
+
+// ============ Service Worker 生命周期 ============
 
-// 安装阶段：预缓存核心文件
 self.addEventListener('install', (event) => {
-  self.skipWaiting(); // 强制立即接管
+  console.log('[SW] Installing new version:', CACHE_NAME);
-  event.waitUntil(
+  self.skipWaiting();
-    caches.open(CACHE_NAME).then((cache) => {
-      // 这里的资源如果加载失败不应该阻断 SW 安装
-      return cache.addAll(ASSETS_TO_CACHE).catch(err => console.warn('Failed to cache core assets', err));
-    })
-  );
 });
 
-// 激活阶段：清理旧缓存
 self.addEventListener('activate', (event) => {
+  console.log('[SW] Activating new version:', CACHE_NAME);
   event.waitUntil(
-    caches.keys().then((cacheNames) => {
+    (async () => {
-      return Promise.all(
+      // 清理所有旧版本缓存
+      const cacheNames = await caches.keys();
+      await Promise.all(
         cacheNames.map((cacheName) => {
           if (cacheName.startsWith('napcat-webui-') && cacheName !== CACHE_NAME) {
             console.log('[SW] Deleting old cache:', cacheName);
@@ -26,107 +159,178 @@ self.addEventListener('activate', (event) => {
           }
         })
       );
-    })
+      // 立即接管所有客户端
+      await self.clients.claim();
+    })()
   );
-  self.clients.claim(); // 立即控制所有客户端
 });
 
-// 拦截请求
+// ============ 请求拦截 ============
+
 self.addEventListener('fetch', (event) => {
   const url = new URL(event.request.url);
+  const request = event.request;
 
-  // 1. API 请求：仅网络 (Network Only)
+  // 1. 永不缓存的请求 - Network Only
-  if (url.pathname.startsWith('/api/') || url.pathname.includes('/socket')) {
+  if (isNeverCache(url, request)) {
+    // 不调用 respondWith，让请求直接穿透到网络
     return;
   }
 
-  // 2. 强缓存策略 (Cache First)
+  // 2. WebUI 静态资源 - Cache First
-  // - 外部 QQ 头像 (q1.qlogo.cn)
+  if (isWebUIStaticAsset(url)) {
-  // - 静态资源 (assets, fonts)
+    event.respondWith(cacheFirst(request, url));
-  // - 常见静态文件后缀
-  const isQLogo = url.hostname === 'q1.qlogo.cn';
-  const isCustomFont = url.pathname.includes('CustomFont.woff'); // 用户自定义字体，不强缓存
-  const isThemeCss = url.pathname.includes('files/theme.css'); // 主题 CSS，不强缓存
-  const isStaticAsset = url.pathname.includes('/webui/assets/') ||
-    url.pathname.includes('/webui/fonts/');
-  const isStaticFile = /\.(js|css|png|jpg|jpeg|gif|svg|woff|woff2|ttf|eot|ico)$/i.test(url.pathname);
-
-  if (!isCustomFont && !isThemeCss && (isQLogo || isStaticAsset || isStaticFile)) {
-    event.respondWith(
-      caches.match(event.request).then((response) => {
-        if (response) {
-          return response;
-        }
-
-        // 跨域请求 (qlogo) 需要 mode: 'no-cors' 才能缓存 opaque response，
-        // 但 fetch(event.request) 默认会继承 request 的 mode。
-        // 如果是 img标签发起的请求，通常 mode 是 no-cors 或 cors。
-        // 对于 opaque response (status 0), cache API 允许缓存。
-        return fetch(event.request).then((response) => {
-          // 对 qlogo 允许 status 0 (opaque)
-          // 对其他资源要求 status 200
-          const isValidResponse = response && (
-            response.status === 200 ||
-            response.type === 'basic' ||
-            (isQLogo && response.type === 'opaque')
-          );
-
-          if (!isValidResponse) {
-            return response;
-          }
-
-          const responseToCache = response.clone();
-          caches.open(CACHE_NAME).then((cache) => {
-            cache.put(event.request, responseToCache);
-          });
-          return response;
-        });
-      })
-    );
     return;
   }
 
-  // 3. HTML 页面 / 导航请求 -> 网络优先 (Network First)
+  // 3. QQ 头像 - Cache First（支持 opaque response）
-  if (event.request.mode === 'navigate') {
+  if (isQLogoAvatar(url)) {
-    event.respondWith(
+    event.respondWith(cacheFirstWithOpaque(request, url));
-      fetch(event.request)
-        .then((response) => {
-          const responseToCache = response.clone();
-          caches.open(CACHE_NAME).then((cache) => {
-            cache.put(event.request, responseToCache);
-          });
-          return response;
-        })
-        .catch(() => {
-          return caches.match(event.request);
-        })
-    );
     return;
   }
 
-  // 4. 其他 Same-Origin 请求 -> Stale-While-Revalidate
+  // 4. 插件文件系统静态资源 - Network First
-  // 优先返回缓存，同时后台更新缓存，保证下次访问是新的
+  if (isPluginStaticFiles(url)) {
+    event.respondWith(networkFirst(request));
+    return;
+  }
+
+  // 5. 插件内存静态资源 - Stale-While-Revalidate
+  if (isPluginMemoryAsset(url)) {
+    event.respondWith(staleWhileRevalidate(request, url));
+    return;
+  }
+
+  // 6. 插件页面 - Network First
+  if (isPluginPage(url)) {
+    event.respondWith(networkFirst(request));
+    return;
+  }
+
+  // 7. HTML 导航请求 - Network First
+  if (request.mode === 'navigate') {
+    event.respondWith(networkFirst(request));
+    return;
+  }
+
+  // 8. 其他同源请求 - Network Only（避免意外缓存）
   if (url.origin === self.location.origin) {
-    event.respondWith(
+    // 不缓存，直接穿透
-      caches.match(event.request).then((cachedResponse) => {
+    return;
-        const fetchPromise = fetch(event.request).then((networkResponse) => {
+  }
+
+  // 9. 其他外部请求 - Network Only
+  return;
+});
+
+// ============ 缓存策略实现 ============
+
+/**
+ * Cache First 策略
+ * 优先从缓存返回，缓存未命中则从网络获取并缓存
+ */
+async function cacheFirst (request, url) {
+  const cachedResponse = await caches.match(request);
+  if (cachedResponse) {
+    return cachedResponse;
+  }
+
+  try {
+    const networkResponse = await fetch(request);
     if (networkResponse && networkResponse.status === 200) {
-            const responseToCache = networkResponse.clone();
+      const cache = await caches.open(CACHE_NAME);
-            caches.open(CACHE_NAME).then((cache) => {
+      cache.put(request, networkResponse.clone());
-              cache.put(event.request, responseToCache);
+      // 异步清理缓存
-            });
+      trimCache(CACHE_NAME, getCacheLimitForRequest(url));
     }
     return networkResponse;
-        });
+  } catch (error) {
-        // 如果有缓存，返回缓存；否则等待网络
+    console.error('[SW] Cache First fetch failed:', error);
-        return cachedResponse || fetchPromise;
+    return new Response('Network error', { status: 503 });
-      })
+  }
-    );
+}
-    return;
+
+/**
+ * Cache First 策略（支持 opaque response，用于跨域头像）
+ */
+async function cacheFirstWithOpaque (request, url) {
+  const cachedResponse = await caches.match(request);
+  if (cachedResponse) {
+    return cachedResponse;
   }
 
-  // 默认：网络优先
+  try {
-  event.respondWith(
+    const networkResponse = await fetch(request);
-    fetch(event.request).catch(() => caches.match(event.request))
+    // opaque response 的 status 是 0，但仍可缓存
+    const isValidResponse = networkResponse && (
+      networkResponse.status === 200 ||
+      networkResponse.type === 'opaque'
     );
-});
+
+    if (isValidResponse) {
+      const cache = await caches.open(CACHE_NAME);
+      cache.put(request, networkResponse.clone());
+      trimCache(CACHE_NAME, getCacheLimitForRequest(url));
+    }
+    return networkResponse;
+  } catch (error) {
+    console.error('[SW] Cache First (opaque) fetch failed:', error);
+    return new Response('Network error', { status: 503 });
+  }
+}
+
+/**
+ * Network First 策略
+ * 优先从网络获取，网络失败则返回缓存
+ */
+async function networkFirst (request) {
+  try {
+    const networkResponse = await fetch(request);
+    if (networkResponse && networkResponse.status === 200) {
+      const cache = await caches.open(CACHE_NAME);
+      cache.put(request, networkResponse.clone());
+    }
+    return networkResponse;
+  } catch (error) {
+    console.log('[SW] Network First: network failed, trying cache');
+    const cachedResponse = await caches.match(request);
+    if (cachedResponse) {
+      return cachedResponse;
+    }
+    return new Response('Offline', { status: 503 });
+  }
+}
+
+/**
+ * Stale-While-Revalidate 策略
+ * 立即返回缓存（如果有），同时后台更新缓存
+ */
+async function staleWhileRevalidate (request, url) {
+  const cache = await caches.open(CACHE_NAME);
+  const cachedResponse = await cache.match(request);
+
+  // 后台刷新缓存
+  const fetchPromise = fetch(request).then((networkResponse) => {
+    if (networkResponse && networkResponse.status === 200) {
+      cache.put(request, networkResponse.clone());
+      trimCache(CACHE_NAME, getCacheLimitForRequest(url));
+    }
+    return networkResponse;
+  }).catch((error) => {
+    console.log('[SW] SWR background fetch failed:', error);
+    return null;
+  });
+
+  // 如果有缓存，立即返回缓存
+  if (cachedResponse) {
+    return cachedResponse;
+  }
+
+  // 没有缓存，等待网络
+  const networkResponse = await fetchPromise;
+  if (networkResponse) {
+    return networkResponse;
+  }
+
+  return new Response('Network error', { status: 503 });
+}

packages/napcat-webui-frontend/src/components/chat_input/components/show_structed_message.tsx

@@ -10,6 +10,7 @@ const ShowStructedMessage = ({ messages }: ShowStructedMessageProps) => {
   return (
     <Snippet
       hideSymbol
+      codeString={JSON.stringify(messages, null, 2)}
       tooltipProps={{
         content: '点击复制',
       }}

packages/napcat-webui-frontend/src/components/onebot/display_card/render.tsx

@@ -121,6 +121,7 @@ const OneBotItemRender = ({ data, index, style }: OneBotItemRenderProps) => {
                 <PopoverContent>
                   <Snippet
                     hideSymbol
+                    codeString={JSON.stringify(msg, null, 2)}
                     tooltipProps={{
                       content: '点击复制',
                     }}

packages/napcat-webui-frontend/src/components/onebot/display_card/response.tsx

@@ -41,6 +41,7 @@ const OneBotDisplayResponse: React.FC<OneBotDisplayResponseProps> = ({
           <PopoverContent>
             <Snippet
               hideSymbol
+              codeString={JSON.stringify(data.data, null, 2)}
               tooltipProps={{
                 content: '点击复制',
               }}

packages/napcat-webui-frontend/src/components/toaster.tsx

@@ -12,6 +12,8 @@ export const Toaster = () => {
           borderRadius: '20px',
           background: isDark ? '#333' : '#fff',
           color: isDark ? '#fff' : '#333',
+          maxWidth: '400px',
+          wordBreak: 'break-word',
         },
       }}
     />

packages/napcat-webui-frontend/src/controllers/qq_manager.ts

@@ -21,7 +21,8 @@ export default class QQManager {
   public static async checkQQLoginStatus () {
     const data = await serverRequest.post<
       ServerResponse<{
-        isLogin: string;
+        isLogin: boolean;
+        isOffline?: boolean;
         qrcodeurl: string;
       }>
     >('/QQLogin/CheckLoginStatus');
@@ -31,7 +32,7 @@ export default class QQManager {
 
   public static async checkQQLoginStatusWithQrcode () {
     const data = await serverRequest.post<
-      ServerResponse<{ qrcodeurl: string; isLogin: string; loginError?: string; }>
+      ServerResponse<{ qrcodeurl: string; isLogin: boolean; isOffline?: boolean; loginError?: string; }>
     >('/QQLogin/CheckLoginStatus');
 
     return data.data.data;

packages/napcat-webui-frontend/src/layouts/default.tsx

@@ -68,8 +68,8 @@ const Layout: React.FC<{ children: React.ReactNode; }> = ({ children }) => {
           isOnlineRef.current = false;
           dialog.confirm({
             title: '账号已离线',
-            content: '您的 QQ 账号已下线，请重新登录。',
+            content: '您的 QQ 账号已掉线，是否重启进程以重新登录？',
-            confirmText: '重新登陆',
+            confirmText: '重启进程',
             cancelText: '退出账户',
             onConfirm: async () => {
               setIsRestarting(true);
@@ -115,7 +115,12 @@ const Layout: React.FC<{ children: React.ReactNode; }> = ({ children }) => {
   const checkIsQQLogin = async () => {
     try {
       const result = await QQManager.checkQQLoginStatus();
-      if (!result.isLogin) {
+      // 掉线状态由 checkOnlineStatus 定期检测并弹窗处理，这里只处理未登录
+      if (result.isOffline) {
+        // 已登录但掉线，标记状态，等待 checkOnlineStatus 弹窗
+        isOnlineRef.current = false;
+      } else if (!result.isLogin) {
+        // 未登录状态：跳转到登录页面
         if (isAuth) {
           navigate('/qq_login', { replace: true });
         } else {

packages/napcat-webui-frontend/src/pages/dashboard/extension.tsx

@@ -132,8 +132,8 @@ export default function ExtensionPage () {
                     <div className='flex items-center gap-2'>
                       {tab.icon && <span>{tab.icon}</span>}
                       <span
-                        className='cursor-pointer hover:underline'
+                        className='cursor-pointer hover:underline truncate max-w-[6rem] md:max-w-none'
-                        title='点击在新窗口打开'
+                        title={`插件：${tab.pluginName}\n点击在新窗口打开`}
                         onClick={(e) => {
                           e.stopPropagation();
                           openInNewWindow(tab.pluginId, tab.path);
@@ -141,7 +141,7 @@ export default function ExtensionPage () {
                       >
                         {tab.title}
                       </span>
-                      <span className='text-xs text-default-400'>({tab.pluginName})</span>
+                      <span className='text-xs text-default-400 hidden md:inline'>({tab.pluginName})</span>
                     </div>
                   }
                 />

packages/napcat-webui-frontend/src/pages/dashboard/plugin_config_modal.tsx

@@ -4,7 +4,7 @@ import { Input } from '@heroui/input';
 import { Select, SelectItem } from '@heroui/select';
 import { Switch } from '@heroui/switch';
 import { useEffect, useState, useRef, useCallback } from 'react';
-import toast from 'react-hot-toast';
+import toast from '@/utils/toast';
 import { EventSourcePolyfill } from 'event-source-polyfill';
 import PluginManager, { PluginConfigSchemaItem } from '@/controllers/plugin_manager';
 import key from '@/const/key';

packages/napcat-webui-frontend/src/pages/dashboard/plugin_store.tsx

@@ -9,6 +9,7 @@ import toast from 'react-hot-toast';
 import { IoMdRefresh, IoMdSearch, IoMdSettings } from 'react-icons/io';
 import clsx from 'clsx';
 import { EventSourcePolyfill } from 'event-source-polyfill';
+import { useLocalStorage } from '@uidotdev/usehooks';
 
 import PluginStoreCard, { InstallStatus } from '@/components/display_card/plugin_store_card';
 import PluginManager, { PluginItem } from '@/controllers/plugin_manager';
@@ -226,12 +227,22 @@ export default function PluginStorePage () {
     }
   };
 
+  const [backgroundImage] = useLocalStorage<string>(key.backgroundImage, '');
+  const hasBackground = !!backgroundImage;
+
   return (
     <>
       <title>插件商店 - NapCat WebUI</title>
       <div className="p-2 md:p-4 relative">
+        {/* 固定头部区域 */}
+        <div className={clsx(
+          'sticky top-14 z-10 backdrop-blur-sm py-4 px-4 rounded-sm mb-4 -mx-2 md:-mx-4 -mt-2 md:-mt-4 transition-colors',
+          hasBackground
+            ? 'bg-white/20 dark:bg-black/10'
+            : 'bg-transparent'
+        )}>
           {/* 头部 */}
-        <div className="flex mb-6 items-center justify-between flex-wrap gap-4">
+          <div className="flex mb-4 items-center justify-between flex-wrap gap-4">
             <div className="flex items-center gap-4">
               <h1 className="text-2xl font-bold">插件商店</h1>
               <Button
@@ -269,7 +280,7 @@ export default function PluginStorePage () {
           </div>
 
           {/* 搜索框 */}
-        <div className="mb-6">
+          <div className="mb-4">
             <Input
               placeholder="搜索插件名称、描述、作者或标签..."
               startContent={<IoMdSearch className="text-default-400" />}
@@ -279,15 +290,7 @@ export default function PluginStorePage () {
             />
           </div>
 
-        {/* 标签页 */}
+          {/* 标签页导航 */}
-        <div className="relative">
-          {/* 加载遮罩 - 只遮住插件列表区域 */}
-          {loading && (
-            <div className="absolute inset-0 bg-zinc-500/10 z-30 flex justify-center items-center backdrop-blur-sm rounded-lg">
-              <Spinner size='lg' />
-            </div>
-          )}
-
           <Tabs
             aria-label="Plugin Store Categories"
             className="max-w-full"
@@ -296,16 +299,30 @@ export default function PluginStorePage () {
             classNames={{
               tabList: 'bg-white/40 dark:bg-black/20 backdrop-blur-md',
               cursor: 'bg-white/80 dark:bg-white/10 backdrop-blur-md shadow-sm',
+              panel: 'hidden',
             }}
           >
             {tabs.map((tab) => (
               <Tab
                 key={tab.key}
                 title={`${tab.title} (${tab.count})`}
-              >
+              />
-                <EmptySection isEmpty={!categorizedPlugins[tab.key]?.length} />
+            ))}
+          </Tabs>
+        </div>
+
+        {/* 插件列表区域 */}
+        <div className="relative">
+          {/* 加载遮罩 - 只遮住插件列表区域 */}
+          {loading && (
+            <div className="absolute inset-0 bg-zinc-500/10 z-30 flex justify-center items-center backdrop-blur-sm rounded-lg">
+              <Spinner size='lg' />
+            </div>
+          )}
+
+          <EmptySection isEmpty={!categorizedPlugins[activeTab]?.length} />
           <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5 justify-start items-stretch gap-x-2 gap-y-4">
-                  {categorizedPlugins[tab.key]?.map((plugin) => {
+            {categorizedPlugins[activeTab]?.map((plugin) => {
               const installInfo = getPluginInstallInfo(plugin);
               return (
                 <PluginStoreCard
@@ -318,9 +335,6 @@ export default function PluginStorePage () {
               );
             })}
           </div>
-              </Tab>
-            ))}
-          </Tabs>
         </div>
       </div>
 

packages/napcat-webui-frontend/src/pages/qq_login.tsx

@@ -222,7 +222,7 @@ export default function QQLoginPage () {
                 isDisabled={isLoading}
                 size='lg'
                 selectedKey={activeTab}
-                onSelectionChange={(key) => setActiveTab(key.toString())}
+                onSelectionChange={(key) => key !== null && setActiveTab(key.toString())}
               >
                 <Tab key='shortcut' title='快速登录'>
                   <QuickLogin

packages/napcat-webui-frontend/src/utils/toast.ts

@@ -0,0 +1,60 @@
+/**
+ * Toast 工具模块
+ * 包装 react-hot-toast，自动截断长路径避免溢出
+ */
+import hotToast, { ToastOptions, Renderable, ValueOrFunction, Toast } from 'react-hot-toast';
+import { truncateErrorMessage } from './truncate';
+
+type Message = ValueOrFunction<Renderable, Toast>;
+
+/**
+ * 包装后的 toast 对象
+ * 对 error 类型的 toast 自动应用路径截断
+ */
+const toast = {
+  /**
+   * 显示错误 toast，自动截断长路径
+   */
+  error: (message: Message, options?: ToastOptions) => {
+    const truncatedMessage = typeof message === 'string'
+      ? truncateErrorMessage(message)
+      : message;
+    return hotToast.error(truncatedMessage, options);
+  },
+
+  /**
+   * 显示成功 toast
+   */
+  success: (message: Message, options?: ToastOptions) => {
+    return hotToast.success(message, options);
+  },
+
+  /**
+   * 显示加载中 toast
+   */
+  loading: (message: Message, options?: ToastOptions) => {
+    return hotToast.loading(message, options);
+  },
+
+  /**
+   * 显示普通 toast
+   */
+  custom: hotToast.custom,
+
+  /**
+   * 关闭 toast
+   */
+  dismiss: hotToast.dismiss,
+
+  /**
+   * 移除 toast
+   */
+  remove: hotToast.remove,
+
+  /**
+   * Promise toast
+   */
+  promise: hotToast.promise,
+};
+
+export default toast;

packages/napcat-webui-frontend/src/utils/truncate.ts

@@ -0,0 +1,141 @@
+/**
+ * 路径截断工具函数
+ *
+ * 用于解决前端提示框中长路径导致内容溢出的问题。
+ * 当错误消息包含过长的文件路径时，会导致提示框显示异常。
+ *
+ * 使用场景：
+ * - Toast 消息中包含文件路径
+ * - 错误提示中包含配置文件路径
+ * - 任何可能因路径过长导致 UI 溢出的场景
+ *
+ * 兼容性：
+ * - Windows 路径：D:\folder\subfolder\file (使用 \ 作为分隔符)
+ * - Linux/Unix 路径：/home/user/folder/file (使用 / 作为分隔符)
+ *
+ * 示例：
+ * - Windows: D:\NapCat.Shell-1\NapCat.Shell-2\...\data → D:\NapCat.Shell-1\...\napcat-plugin-builtin\data
+ * - Linux: /home/user/projects/napcat/plugins/data → /home/user/...\plugins/data
+ */
+
+/**
+ * 截断长路径，保留开头和结尾部分
+ *
+ * @param path - 需要截断的路径（支持 Windows 和 Linux 路径格式）
+ * @param maxLength - 最大允许长度，默认 60 字符
+ * @returns 截断后的路径，中间用 ... 替代
+ *
+ * @example
+ * // Windows 路径
+ * truncatePath('D:\\folder1\\folder2\\folder3\\file.txt', 30)
+ * // 返回: 'D:\\...\\folder3\\file.txt'
+ *
+ * @example
+ * // Linux 路径
+ * truncatePath('/home/user/projects/deep/nested/file.txt', 30)
+ * // 返回: '/home/user/.../nested/file.txt'
+ */
+export function truncatePath (path: string, maxLength: number = 60): string {
+  if (path.length <= maxLength) {
+    return path;
+  }
+
+  // 自动检测路径分隔符，兼容 Windows (\) 和 Linux/Unix (/)
+  const separator = path.includes('\\') ? '\\' : '/';
+  const parts = path.split(separator);
+
+  if (parts.length <= 3) {
+    // 如果路径段太少（如 D:\folder\file），直接尾部截断
+    return path.substring(0, maxLength - 3) + '...';
+  }
+
+  // 保留第一段（Windows 驱动器号如 D: 或 Linux 根目录）和最后两段（父目录+文件名）
+  const firstPart = parts[0];
+  const lastParts = parts.slice(-2).join(separator);
+
+  const truncated = `${firstPart}${separator}...${separator}${lastParts}`;
+
+  // 如果截断后仍然超长，回退到简单的尾部截断
+  if (truncated.length > maxLength) {
+    return path.substring(0, maxLength - 3) + '...';
+  }
+
+  return truncated;
+}
+
+/**
+ * 智能截断消息文本，特别处理包含路径的错误消息
+ *
+ * 此函数会自动检测消息中的文件路径（Windows 和 Linux 格式）并截断过长的路径，
+ * 以防止 UI 组件（如 Toast、Alert）因内容过长而溢出。
+ *
+ * @param message - 需要处理的消息文本
+ * @param maxLength - 最终消息的最大长度，默认 100 字符
+ * @returns 处理后的消息，路径被截断，整体长度受限
+ *
+ * @example
+ * // 处理包含 Windows 路径的错误消息
+ * truncateErrorMessage("Save failed: Error updating config: EPERM: operation not permitted, open 'D:\\very\\long\\path\\config.json'")
+ * // 返回: "Save failed: Error updating config: EPERM: operation not permitted, open 'D:\\...\\path\\config.json'"
+ *
+ * @example
+ * // 处理包含 Linux 路径的错误消息
+ * truncateErrorMessage("Failed to read /home/user/projects/napcat/very/deep/nested/config.json")
+ * // 返回: "Failed to read /home/user/.../nested/config.json"
+ */
+export function truncateErrorMessage (message: string, maxLength: number = 100): string {
+  if (message.length <= maxLength) {
+    return message;
+  }
+
+  // Windows 路径正则：匹配 盘符:\路径 格式，如 D:\folder\file.txt
+  // 排除空白字符和引号，避免匹配到路径外的内容
+  const windowsPathRegex = /[A-Za-z]:\\[^\s'"]+/g;
+
+  // Linux/Unix 路径正则：匹配 /开头的多级路径，如 /home/user/file
+  // 要求至少有两级目录，避免匹配单独的 /
+  const unixPathRegex = /\/[^\s'"]+(?:\/[^\s'"]+)+/g;
+
+  let result = message;
+
+  // 处理 Windows 路径
+  const windowsPaths = message.match(windowsPathRegex);
+  if (windowsPaths) {
+    for (const path of windowsPaths) {
+      if (path.length > 40) {
+        result = result.replace(path, truncatePath(path, 40));
+      }
+    }
+  }
+
+  // 处理 Unix 路径
+  const unixPaths = message.match(unixPathRegex);
+  if (unixPaths) {
+    for (const path of unixPaths) {
+      if (path.length > 40) {
+        result = result.replace(path, truncatePath(path, 40));
+      }
+    }
+  }
+
+  // 如果处理路径后消息仍然超长，直接尾部截断
+  if (result.length > maxLength) {
+    return result.substring(0, maxLength - 3) + '...';
+  }
+
+  return result;
+}
+
+/**
+ * 截断普通文本（简单截断，不做路径检测）
+ *
+ * @param text - 需要截断的文本
+ * @param maxLength - 最大长度，默认 50 字符
+ * @returns 截断后的文本，超长部分用 ... 替代
+ */
+export function truncateText (text: string, maxLength: number = 50): string {
+  if (text.length <= maxLength) {
+    return text;
+  }
+  return text.substring(0, maxLength - 3) + '...';
+}

packages/napcat-webui-frontend/vite.config.ts

@@ -30,6 +30,7 @@ export default defineConfig(({ mode }) => {
         },
         '/api': backendDebugUrl,
         '/files': backendDebugUrl,
+        '/plugin': backendDebugUrl,
         '/webui/fonts/CustomFont.woff': backendDebugUrl,
         '/webui/sw.js': backendDebugUrl,
       },