fix: 刷新二维码清楚错误信息

Set NAPCAT_DISABLE_MULTI_PROCESS environment variable to '1' to disable restart and multi-process features during development.

.github/prompt/default.md

@@ -2,17 +2,42 @@
 [使用文档](https://napneko.github.io/)
 
 ## Windows 一键包
-我们提供了轻量化一键部署方案，内置 QQ 和 NapCat，详见使用文档。
+我们为提供了的轻量化一键部署方案
+相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考
 
-可下载文件：
-- NapCat.Shell.Windows.Node.zip（无头模式）
+你可以下载 
 
-## 注意事项
-**推荐 QQ 版本：9.9.23+，最低支持 9.9.22**
-**默认 WebUI 密钥为随机密码，请在控制台查看**
+NapCat.Shell.Windows.OneKey.zip (无头)
 
-## 运行库
-如果 Windows x64 缺少 xxx.dll，请安装 [VC++ 运行库](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+启动后可自动化部署一键包,教程参考使用文档安装部分
 
-## 更新内容
-详见 commit 历史。
+## 警告
+**注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本**
+**默认WebUi密钥为随机密码 控制台查看**
+
+**[9.9.26-44343 X64 Win](https://dldir1.qq.com/qqfile/qq/QQNT/40d6045a/QQ9.9.26.44343_x64.exe)**
+[LinuxX64 DEB 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_amd64.deb)
+[LinuxX64 RPM 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_x86_64.rpm)
+[LinuxArm64 DEB 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_arm64.deb)
+[LinuxArm64 RPM  44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_aarch64.rpm)
+[MAC   DMG   40990 ](https://dldir1v6.qq.com/qqfile/qq/QQNT/c6cb0f5d/QQ_v6.9.82.40990.dmg)
+## 如果WinX64缺少运行库或者xxx.dll？
+[安装运行库](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+
+## 更新
+
+### 🐛 修复
+1. 修复 WebUI 主题配置在有未保存更改时卸载组件导致字体重置的问题 (ae42eed6)
+
+### ✨ 新增
+1. 文件上传相关接口（UploadGroupFile/UploadPrivateFile）新增 `upload_file` 参数支持 (91e0839e)
+2. 消息发送逻辑支持 PTT（语音）元素过滤，确保语音消息正确独立发送 (47983e29)
+
+### 🔧 优化
+1. 优化合并转发消息（GetForwardMsg）的获取与解析逻辑，提高兼容性 (334c4233)
+2. 改进消息发送方法中发送者 UIN 的处理逻辑 (71bb4f68)
+3. 增强 WebUI 系统信息界面中对构建产物的处理与展示 (cb061890)
+
+---
+
+**完整更新日志**: [v4.10.6...v4.10.7](https://github.com/NapNeko/NapCatQQ/compare/v4.10.6...v4.10.7)

.github/prompt/release_note_prompt.txt

@@ -4,7 +4,7 @@
 
 ## 核心规则
 
-1. **版本号**：第一行必须是 `# {VERSION}`，使用用户提供的版本号（如 v4.10.2），不要添加额外的 V 前缀
+1. **版本号**：第一行必须是 `# {VERSION}`，使用用户提供的版本号，如果版本号是小写 v 开头（如 v4.10.2），必须转换为大写 V（如 V4.10.2）
 2. **语言**：全部使用简体中文
 3. **格式**：严格按照下方模板输出，不要添加额外的 markdown 格式
 
@@ -24,26 +24,36 @@
 - **控制数量**：最终保持 5-15 条更新要点
 - **保留 commit hash**：每条末尾附上短 hash，格式 `(a1b2c3d)`
 
-## 输出模板
+## 输出模板 - 必须严格遵守以下格式
 
 ```
 # {VERSION}
 [使用文档](https://napneko.github.io/)
 
 ## Windows 一键包
-我们提供了轻量化一键部署方案，内置 QQ 和 NapCat，详见使用文档。
+我们为提供了的轻量化一键部署方案
+相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考
 
-可下载文件：
-- NapCat.Shell.Windows.Node.zip（无头模式）
+你可以下载 
 
-## 注意事项
-**推荐 QQ 版本：9.9.23+，最低支持 9.9.22**
-**默认 WebUI 密钥为随机密码，请在控制台查看**
+NapCat.Shell.Windows.OneKey.zip (无头)
 
-## 运行库
-如果 Windows x64 缺少 xxx.dll，请安装 [VC++ 运行库](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+启动后可自动化部署一键包,教程参考使用文档安装部分
 
-## 更新内容
+## 警告
+**注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本**
+**默认WebUi密钥为随机密码 控制台查看**
+
+**[9.9.26-44343 X64 Win](https://dldir1.qq.com/qqfile/qq/QQNT/40d6045a/QQ9.9.26.44343_x64.exe)**
+[LinuxX64 DEB 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_amd64.deb)
+[LinuxX64 RPM 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_x86_64.rpm)
+[LinuxArm64 DEB 44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_arm64.deb)
+[LinuxArm64 RPM  44343 ](https://dldir1.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_aarch64.rpm)
+[MAC   DMG   40990 ](https://dldir1v6.qq.com/qqfile/qq/QQNT/c6cb0f5d/QQ_v6.9.82.40990.dmg)
+## 如果WinX64缺少运行库或者xxx.dll？
+[安装运行库](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+
+## 更新
 
 ### 🐛 修复
 1. 修复 xxx 问题 (a1b2c3d)
@@ -62,6 +72,13 @@
 **完整更新日志**: [{PREV_VERSION}...{VERSION}](https://github.com/NapNeko/NapCatQQ/compare/{PREV_VERSION}...{VERSION})
 ```
 
+**格式要求 - 务必严格遵守：**
+- "Windows 一键包"部分的文本必须完全一致，不要修改任何措辞
+- "警告"部分必须包含所有 QQ 版本下载链接，保持原有格式
+- "如果WinX64缺少运行库或者xxx.dll？"这一行必须保持原样
+- QQ 版本号和下载链接保持不变（40990 版本）
+- 只有"## 更新"部分下面的内容需要根据实际 commit 生成
+
 ## 重要约束
 
 1. 如果某个分类没有内容，则完全省略该分类

.github/workflows/auto-release.yml

@@ -46,8 +46,8 @@ jobs:
         env:
             GH_TOKEN: ${{ secrets.NAPCAT_BUILD }}
             NAPCAT_VERSION: ${{ env.latest_tag }}
-            QQ_VERSION_X86_64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/8015ff90/linuxqq_3.2.21-42086_x86_64.AppImage' # 写死 QQ 版本
-            QQ_VERSION_ARM64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/8015ff90/linuxqq_3.2.21-42086_arm64.AppImage' # 写死 QQ 版本
+            QQ_VERSION_X86_64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_x86_64.AppImage' # 写死 QQ 版本
+            QQ_VERSION_ARM64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_arm64.AppImage' # 写死 QQ 版本
         run: |
             echo "Debug: Triggering Release NapCat AppImage with napcat_version=${NAPCAT_VERSION}, qq_version_x86_64=${QQ_VERSION_X86_64}, qq_version_arm64=${QQ_VERSION_ARM64}"
             curl -X POST \
@@ -72,8 +72,8 @@ jobs:
         env:
             GH_TOKEN: ${{ secrets.NAPCAT_BUILD }}
             NAPCAT_VERSION: ${{ env.latest_tag }}
-            QQ_VERSION_X86_64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/8015ff90/linuxqq_3.2.21-42086_x86_64.AppImage' # 写死 QQ 版本
-            QQ_VERSION_ARM64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/8015ff90/linuxqq_3.2.21-42086_arm64.AppImage' # 写死 QQ 版本
+            QQ_VERSION_X86_64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_x86_64.AppImage' # 写死 QQ 版本
+            QQ_VERSION_ARM64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_arm64.AppImage' # 写死 QQ 版本
         run: |
             echo "Debug: Triggering Release NapCat AppImage with napcat_version=${NAPCAT_VERSION}, qq_url_amd64=${QQ_VERSION_X86_64}, qq_url_arm64=${QQ_VERSION_ARM64}"
             curl -X POST \

.github/workflows/release.yml

@@ -10,7 +10,7 @@ permissions: write-all
 
 env:
   OPENROUTER_API_URL: https://91vip.futureppo.top/v1/chat/completions
-  OPENROUTER_MODEL: "Antigravity/gemini-3-flash-preview"
+  OPENROUTER_MODEL: "copilot/ant/gemini-3-flash-preview"
   RELEASE_NAME: "NapCat"
 
 jobs:
@@ -198,6 +198,10 @@ jobs:
         with:
           path: ./artifacts
 
+      - name: Download NapCat.Shell.Windows.OneKey.zip
+        run: |
+            curl -L -o NapCat.Shell.Windows.OneKey.zip https://github.com/NapNeko/NapCatResource/raw/main/NapCat.Shell.Windows.OneKey.zip
+
       - name: Zip Artifacts
         run: |
             cd artifacts
@@ -434,4 +438,5 @@ jobs:
             NapCat.Shell.Windows.Node.zip
             NapCat.Framework.zip
             NapCat.Shell.zip
+            NapCat.Shell.Windows.OneKey.zip
           draft: true

package.json

@@ -28,7 +28,6 @@
   },
   "dependencies": {
     "express": "^5.0.0",
-    "silk-wasm": "^3.6.1",
     "ws": "^8.18.3"
   }
 }

packages/napcat-common/package.json

@@ -17,8 +17,7 @@
     },
     "dependencies": {
         "ajv": "^8.13.0",
-        "file-type": "^21.0.0",
-        "silk-wasm": "^3.6.1"
+        "file-type": "^21.0.0"
     },
     "devDependencies": {
         "@types/node": "^22.0.1"

packages/napcat-common/src/audio-worker.ts

@@ -1,20 +0,0 @@
-import { encode } from 'silk-wasm';
-import { parentPort } from 'worker_threads';
-
-export interface EncodeArgs {
-  input: ArrayBufferView | ArrayBuffer
-  sampleRate: number
-}
-export function recvTask<T> (cb: (taskData: T) => Promise<unknown>) {
-  parentPort?.on('message', async (taskData: T) => {
-    try {
-      const ret = await cb(taskData);
-      parentPort?.postMessage(ret);
-    } catch (error: unknown) {
-      parentPort?.postMessage({ error: (error as Error).message });
-    }
-  });
-}
-recvTask<EncodeArgs>(async ({ input, sampleRate }) => {
-  return await encode(input, sampleRate);
-});

packages/napcat-common/src/mirror.ts

@@ -114,6 +114,16 @@ export const GITHUB_RAW_MIRRORS = [
   'https://gh-proxy.net/https://raw.githubusercontent.com',
 ];
 
+/**
+ * Nightly.link 镜像
+ * 用于访问 GitHub Actions artifacts
+ * 优先使用官方服务，出现问题时可切换镜像
+ */
+export const NIGHTLY_LINK_MIRRORS = [
+  'https://nightly.link',
+  // 可以添加其他 nightly.link 镜像（如果有的话）
+];
+
 // ============== 镜像配置接口 ==============
 
 export interface MirrorConfig {
@@ -123,6 +133,8 @@ export interface MirrorConfig {
   apiMirrors: string[];
   /** Raw 文件镜像 */
   rawMirrors: string[];
+  /** Nightly.link 镜像（用于 Actions artifacts） */
+  nightlyLinkMirrors: string[];
   /** 超时时间（毫秒） */
   timeout: number;
   /** 是否启用镜像 */
@@ -137,6 +149,7 @@ const defaultConfig: MirrorConfig = {
   fileMirrors: GITHUB_FILE_MIRRORS,
   apiMirrors: GITHUB_API_MIRRORS,
   rawMirrors: GITHUB_RAW_MIRRORS,
+  nightlyLinkMirrors: NIGHTLY_LINK_MIRRORS,
   timeout: 10000, // 10秒超时，平衡速度和可靠性
   enabled: true,
   customMirror: undefined,
@@ -530,7 +543,11 @@ export async function findAvailableDownloadUrl (
   // 获取镜像列表
   let mirrors = options.mirrors;
   if (!mirrors) {
-    if (useFastMirrors) {
+    // 检查是否是 nightly.link URL
+    if (originalUrl.includes('nightly.link')) {
+      // 使用 nightly.link 镜像列表（保持完整的 URL 格式）
+      mirrors = currentConfig.nightlyLinkMirrors;
+    } else if (useFastMirrors) {
       // 使用懒加载的快速镜像列表
       mirrors = await getFastMirrors();
     } else {
@@ -564,11 +581,20 @@ export async function findAvailableDownloadUrl (
     return originalUrl;
   }
 
-  // 3. 测试镜像源（已按延迟排序）
+  // 3. 测试镜像源
   let testedCount = 0;
   for (const mirror of mirrors) {
     if (!mirror) continue; // 跳过空字符串
-    const mirrorUrl = buildMirrorUrl(originalUrl, mirror);
+    
+    // 特殊处理 nightly.link URL
+    let mirrorUrl: string;
+    if (originalUrl.includes('nightly.link')) {
+      // 替换 nightly.link 域名
+      mirrorUrl = originalUrl.replace('https://nightly.link', mirror.startsWith('http') ? mirror : `https://${mirror}`);
+    } else {
+      mirrorUrl = buildMirrorUrl(originalUrl, mirror);
+    }
+    
     testedCount++;
     if (await testWithValidation(mirrorUrl)) {
       return mirrorUrl;
@@ -748,13 +774,13 @@ interface TagsCache {
   timestamp: number;
 }
 
-// 缓存 tags 结果（5 分钟有效）
-const TAGS_CACHE_TTL = 5 * 60 * 1000;
+// 缓存 tags 结果（10 分钟有效，release 版本不会频繁变动）
+const TAGS_CACHE_TTL = 10 * 60 * 1000;
 const tagsCache: Map<string, TagsCache> = new Map();
 
 /**
  * 获取所有 GitHub tags（带缓存）
- * 使用懒加载的快速镜像列表，按测速延迟排序依次尝试
+ * 优化：并行请求多个镜像，使用第一个成功返回的结果
  */
 export async function getAllGitHubTags (owner: string, repo: string): Promise<{ tags: string[], mirror: string; }> {
   const cacheKey = `${owner}/${repo}`;
@@ -779,7 +805,7 @@ export async function getAllGitHubTags (owner: string, repo: string): Promise<{
   };
 
   // 尝试从 URL 获取 tags
-  const fetchFromUrl = async (url: string): Promise<string[] | null> => {
+  const fetchFromUrl = async (url: string, mirror: string): Promise<{ tags: string[], mirror: string; } | null> => {
     try {
       const raw = await PromiseTimer(
         RequestUtil.HttpGetText(url),
@@ -793,7 +819,7 @@ export async function getAllGitHubTags (owner: string, repo: string): Promise<{
 
       const tags = parseTags(raw);
       if (tags.length > 0) {
-        return tags;
+        return { tags, mirror };
       }
       return null;
     } catch {
@@ -801,40 +827,57 @@ export async function getAllGitHubTags (owner: string, repo: string): Promise<{
     }
   };
 
-  // 获取快速镜像列表（懒加载，首次调用会测速，已按延迟排序）
+  // 获取快速镜像列表
   let fastMirrors: string[] = [];
   try {
     fastMirrors = await getFastMirrors();
-  } catch (e) {
-    // 忽略错误，继续使用空列表
+  } catch {
+    // 忽略错误
   }
 
-  // 构建 URL 列表（快速镜像 + 原始 URL）
-  const mirrorUrls = fastMirrors.filter(m => m).map(m => ({ url: buildMirrorUrl(baseUrl, m), mirror: m }));
-  mirrorUrls.push({ url: baseUrl, mirror: 'github.com' }); // 添加原始 URL
+  // 构建 URL 列表（取前 5 个快速镜像 + 原始 URL 并行请求）
+  const topMirrors = fastMirrors.slice(0, 5);
+  const mirrorUrls = [
+    { url: baseUrl, mirror: 'github.com' }, // 原始 URL
+    ...topMirrors.filter(m => m).map(m => ({ url: buildMirrorUrl(baseUrl, m), mirror: m })),
+  ];
 
-  // 按顺序尝试每个镜像（已按延迟排序），成功即返回
-  for (const { url, mirror } of mirrorUrls) {
-    const tags = await fetchFromUrl(url);
-    if (tags && tags.length > 0) {
-      // 缓存结果
-      tagsCache.set(cacheKey, { tags, mirror, timestamp: Date.now() });
-      return { tags, mirror };
+  // 并行请求所有镜像，使用 Promise.any 获取第一个成功的结果
+  try {
+    const result = await Promise.any(
+      mirrorUrls.map(async ({ url, mirror }) => {
+        const res = await fetchFromUrl(url, mirror);
+        if (res) return res;
+        throw new Error('Failed');
+      })
+    );
+    
+    // 缓存结果
+    tagsCache.set(cacheKey, { tags: result.tags, mirror: result.mirror, timestamp: Date.now() });
+    return result;
+  } catch {
+    // Promise.any 全部失败，回退到顺序尝试剩余镜像
+  }
+
+  // 回退：顺序尝试剩余镜像
+  const remainingMirrors = fastMirrors.slice(5).filter(m => m);
+  for (const mirror of remainingMirrors) {
+    const url = buildMirrorUrl(baseUrl, mirror);
+    const result = await fetchFromUrl(url, mirror);
+    if (result) {
+      tagsCache.set(cacheKey, { tags: result.tags, mirror: result.mirror, timestamp: Date.now() });
+      return result;
     }
   }
 
-  // 如果快速镜像都失败，回退到原始镜像列表
-  const allMirrors = currentConfig.fileMirrors.filter(m => m);
+  // 最后尝试所有镜像
+  const allMirrors = currentConfig.fileMirrors.filter(m => m && !fastMirrors.includes(m));
   for (const mirror of allMirrors) {
-    // 跳过已经尝试过的镜像
-    if (fastMirrors.includes(mirror)) continue;
-
     const url = buildMirrorUrl(baseUrl, mirror);
-    const tags = await fetchFromUrl(url);
-    if (tags && tags.length > 0) {
-      // 缓存结果
-      tagsCache.set(cacheKey, { tags, mirror, timestamp: Date.now() });
-      return { tags, mirror };
+    const result = await fetchFromUrl(url, mirror);
+    if (result) {
+      tagsCache.set(cacheKey, { tags: result.tags, mirror: result.mirror, timestamp: Date.now() });
+      return result;
     }
   }
 
@@ -850,49 +893,276 @@ export interface ActionArtifact {
   created_at: string;
   expires_at: string;
   archive_download_url: string;
+  workflow_run_id?: number;
+  head_sha?: string;
+}
+
+// ============== Action Artifacts 缓存 ==============
+
+interface ArtifactsCache {
+  artifacts: ActionArtifact[];
+  timestamp: number;
+}
+
+// 缓存 artifacts 结果（10 分钟有效）
+const ARTIFACTS_CACHE_TTL = 10 * 60 * 1000;
+const artifactsCache: Map<string, ArtifactsCache> = new Map();
+
+/**
+ * 清除 artifacts 缓存
+ */
+export function clearArtifactsCache (): void {
+  artifactsCache.clear();
+}
+
+/**
+ * 通过解析 GitHub Actions HTML 页面获取 workflow runs（备用方案）
+ * 当 api.github.com 不可用时使用
+ * 页面格式: https://github.com/{owner}/{repo}/actions/workflows/{workflow}
+ */
+async function getWorkflowRunsFromHtml (
+  owner: string,
+  repo: string,
+  workflow: string = 'build.yml',
+  maxRuns: number = 10
+): Promise<Array<{ id: number; created_at: string; }>> {
+  const baseUrl = `https://github.com/${owner}/${repo}/actions/workflows/${workflow}`;
+  
+  // 尝试使用镜像获取 HTML
+  const mirrors = ['', ...currentConfig.fileMirrors.filter(m => m)];
+  
+  for (const mirror of mirrors) {
+    try {
+      const url = mirror ? buildMirrorUrl(baseUrl, mirror) : baseUrl;
+      
+      const html = await PromiseTimer(
+        RequestUtil.HttpGetText(url),
+        10000
+      );
+      
+      // 从 HTML 中提取 run IDs 和时间
+      // 格式: href="/NapNeko/NapCatQQ/actions/runs/20676123968"
+      // 时间格式: <relative-time datetime="2026-01-03T10:37:29Z"
+      const runPattern = new RegExp(`href="/${owner}/${repo}/actions/runs/(\\d+)"`, 'gi');
+      const timePattern = /<relative-time\s+datetime="([^"]+)"/gi;
+      
+      // 提取所有时间
+      const times: string[] = [];
+      let timeMatch;
+      while ((timeMatch = timePattern.exec(html)) !== null) {
+        times.push(timeMatch[1]);
+      }
+      
+      const runs: Array<{ id: number; created_at: string; }> = [];
+      const foundIds = new Set<number>();
+      let timeIndex = 0;
+      
+      let match;
+      while ((match = runPattern.exec(html)) !== null && runs.length < maxRuns) {
+        const id = parseInt(match[1]);
+        if (!foundIds.has(id)) {
+          foundIds.add(id);
+          // 尝试获取对应的时间，每个 run 通常有两个时间（桌面和移动端显示）
+          // 所以每找到一个 run，跳过两个时间
+          const created_at = times[timeIndex] || new Date().toISOString();
+          timeIndex += 2; // 跳过两个时间（桌面端和移动端各一个）
+          runs.push({
+            id,
+            created_at,
+          });
+        }
+      }
+      
+      if (runs.length > 0) {
+        return runs;
+      }
+    } catch {
+      continue;
+    }
+  }
+  
+  return [];
+}
+
+/**
+ * 通过 API 获取最新的 workflow runs，然后直接拼接 nightly.link 下载链接
+ * 无需解析 HTML，直接使用固定的 URL 格式
+ * 
+ * 策略：
+ * 1. 优先使用 GitHub API
+ * 2. API 失败时，从 GitHub Actions HTML 页面解析
+ */
+async function getArtifactsFromNightlyLink (
+  owner: string,
+  repo: string,
+  workflow: string = 'build.yml',
+  branch: string = 'main',
+  maxRuns: number = 10
+): Promise<ActionArtifact[]> {
+  let workflowRuns: Array<{ id: number; head_sha?: string; created_at: string; }> = [];
+  
+  // 策略1: 优先尝试 GitHub API
+  try {
+    const endpoint = `https://api.github.com/repos/${owner}/${repo}/actions/workflows/${workflow}/runs?branch=${branch}&status=success&per_page=${maxRuns}`;
+    
+    const runsResponse = await PromiseTimer(
+      RequestUtil.HttpGetJson<{
+        workflow_runs: Array<{ id: number; head_sha: string; created_at: string; }>;
+      }>(endpoint, 'GET', undefined, {
+        'User-Agent': 'NapCat',
+        'Accept': 'application/vnd.github.v3+json',
+      }),
+      10000
+    );
+
+    if (runsResponse.workflow_runs && runsResponse.workflow_runs.length > 0) {
+      workflowRuns = runsResponse.workflow_runs;
+    }
+  } catch {
+    // API 请求失败，继续尝试 HTML 解析
+  }
+
+  // 策略2: API 失败时，从 HTML 页面解析
+  if (workflowRuns.length === 0) {
+    workflowRuns = await getWorkflowRunsFromHtml(owner, repo, workflow, maxRuns);
+  }
+
+  if (workflowRuns.length === 0) {
+    return [];
+  }
+
+  // 直接拼接 nightly.link URL
+  // 格式: https://nightly.link/{owner}/{repo}/actions/runs/{run_id}/{artifact_name}.zip
+  const artifacts: ActionArtifact[] = [];
+  const artifactNames = ['NapCat.Framework', 'NapCat.Shell']; // 已知的 artifact 名称
+
+  for (const run of workflowRuns) {
+    for (const artifactName of artifactNames) {
+      const mirror = currentConfig.nightlyLinkMirrors[0] || 'https://nightly.link';
+      artifacts.push({
+        id: run.id,
+        name: artifactName,
+        size_in_bytes: 0,
+        created_at: run.created_at,
+        expires_at: new Date(Date.now() + 90 * 24 * 60 * 60 * 1000).toISOString(),
+        archive_download_url: `${mirror}/${owner}/${repo}/actions/runs/${run.id}/${artifactName}.zip`,
+        workflow_run_id: run.id,
+        head_sha: run.head_sha,
+      });
+    }
+  }
+
+  return artifacts;
+}
+
+/**
+ * 通过 GitHub API 获取 artifacts（主要方案）
+ */
+async function getArtifactsFromAPI (
+  owner: string,
+  repo: string,
+  workflow: string = 'build.yml',
+  branch: string = 'main',
+  maxRuns: number = 10
+): Promise<ActionArtifact[]> {
+  const endpoint = `https://api.github.com/repos/${owner}/${repo}/actions/workflows/${workflow}/runs?branch=${branch}&status=success&per_page=${maxRuns}`;
+
+  const runsResponse = await PromiseTimer(
+    RequestUtil.HttpGetJson<{
+      workflow_runs: Array<{ id: number; head_sha: string; created_at: string; }>;
+    }>(endpoint, 'GET', undefined, {
+      'User-Agent': 'NapCat',
+      'Accept': 'application/vnd.github.v3+json',
+    }),
+    10000
+  );
+
+  const workflowRuns = runsResponse.workflow_runs;
+  if (!workflowRuns || workflowRuns.length === 0) {
+    throw new Error('No successful workflow runs found');
+  }
+
+  // 获取所有 runs 的 artifacts
+  const allArtifacts: ActionArtifact[] = [];
+
+  for (const run of workflowRuns) {
+    try {
+      const artifactsEndpoint = `https://api.github.com/repos/${owner}/${repo}/actions/runs/${run.id}/artifacts`;
+      const artifactsResponse = await PromiseTimer(
+        RequestUtil.HttpGetJson<{
+          artifacts: ActionArtifact[];
+        }>(artifactsEndpoint, 'GET', undefined, {
+          'User-Agent': 'NapCat',
+          'Accept': 'application/vnd.github.v3+json',
+        }),
+        10000
+      );
+
+      if (artifactsResponse.artifacts) {
+        // 为每个 artifact 添加 run 信息
+        for (const artifact of artifactsResponse.artifacts) {
+          artifact.workflow_run_id = run.id;
+          artifact.head_sha = run.head_sha;
+          allArtifacts.push(artifact);
+        }
+      }
+    } catch {
+      // 单个 run 获取失败，继续下一个
+    }
+  }
+
+  return allArtifacts;
 }
 
 /**
  * 获取 GitHub Action 最新运行的 artifacts
  * 用于下载 nightly/dev 版本
+ * 
+ * 策略：
+ * 1. 检查缓存（10分钟有效）
+ * 2. 优先尝试从 nightly.link 获取（无需认证，更稳定）
+ * 3. 如果失败，回退到 GitHub API
  */
 export async function getLatestActionArtifacts (
   owner: string,
   repo: string,
   workflow: string = 'build.yml',
-  branch: string = 'main'
+  branch: string = 'main',
+  maxRuns: number = 10
 ): Promise<ActionArtifact[]> {
-  const endpoint = `https://api.github.com/repos/${owner}/${repo}/actions/workflows/${workflow}/runs?branch=${branch}&status=success&per_page=1`;
-
-  try {
-    const runsResponse = await RequestUtil.HttpGetJson<{
-      workflow_runs: Array<{ id: number; }>;
-    }>(endpoint, 'GET', undefined, {
-      'User-Agent': 'NapCat',
-      'Accept': 'application/vnd.github.v3+json',
-    });
-
-    const workflowRuns = runsResponse.workflow_runs;
-    if (!workflowRuns || workflowRuns.length === 0) {
-      throw new Error('No successful workflow runs found');
-    }
-
-    const firstRun = workflowRuns[0];
-    if (!firstRun) {
-      throw new Error('No workflow run found');
-    }
-    const runId = firstRun.id;
-    const artifactsEndpoint = `https://api.github.com/repos/${owner}/${repo}/actions/runs/${runId}/artifacts`;
-
-    const artifactsResponse = await RequestUtil.HttpGetJson<{
-      artifacts: ActionArtifact[];
-    }>(artifactsEndpoint, 'GET', undefined, {
-      'User-Agent': 'NapCat',
-      'Accept': 'application/vnd.github.v3+json',
-    });
-
-    return artifactsResponse.artifacts || [];
-  } catch {
-    return [];
+  const cacheKey = `${owner}/${repo}/${workflow}/${branch}`;
+  
+  // 检查缓存
+  const cached = artifactsCache.get(cacheKey);
+  if (cached && (Date.now() - cached.timestamp) < ARTIFACTS_CACHE_TTL) {
+    return cached.artifacts;
   }
+
+  let artifacts: ActionArtifact[] = [];
+
+  // 策略1: 优先使用 nightly.link（更稳定，无需认证）
+  try {
+    artifacts = await getArtifactsFromNightlyLink(owner, repo, workflow, branch, maxRuns);
+  } catch {
+    // nightly.link 获取失败
+  }
+
+  // 策略2: 回退到 GitHub API
+  if (artifacts.length === 0) {
+    try {
+      artifacts = await getArtifactsFromAPI(owner, repo, workflow, branch, maxRuns);
+    } catch {
+      // API 获取失败
+    }
+  }
+
+  // 缓存结果（即使为空也缓存，避免频繁请求）
+  if (artifacts.length > 0) {
+    artifactsCache.set(cacheKey, {
+      artifacts,
+      timestamp: Date.now(),
+    });
+  }
+
+  return artifacts;
 }

packages/napcat-common/src/status-interface.ts

@@ -21,4 +21,4 @@ export interface IStatusHelperSubscription {
   on (event: 'statusUpdate', listener: (status: SystemStatus) => void): this;
   off (event: 'statusUpdate', listener: (status: SystemStatus) => void): this;
   emit (event: 'statusUpdate', status: SystemStatus): boolean;
-}
+}

packages/napcat-core/apis/file.ts

@@ -33,7 +33,7 @@ export class NTQQFileApi {
       'http://ss.xingzhige.com/music_card/rkey',
       'https://secret-service.bietiaop.com/rkeys',
     ],
-    this.context.logger
+      this.context.logger
     );
   }
 
@@ -138,7 +138,7 @@ export class NTQQFileApi {
     })).urlResult.domainUrl;
   }
 
-  async uploadFile (filePath: string, elementType: ElementType = ElementType.PIC, elementSubType: number = 0) {
+  async uploadFile (filePath: string, elementType: ElementType = ElementType.PIC, elementSubType: number = 0, uploadGroupFile = true) {
     const fileMd5 = await calculateFileMD5(filePath);
     const extOrEmpty = await fileTypeFromFile(filePath).then(e => e?.ext ?? '').catch(() => '');
     const ext = extOrEmpty ? `.${extOrEmpty}` : '';
@@ -146,24 +146,33 @@ export class NTQQFileApi {
     if (fileName.indexOf('.') === -1) {
       fileName += ext;
     }
-
-    const mediaPath = this.context.session.getMsgService().getRichMediaFilePathForGuild({
-      md5HexStr: fileMd5,
-      fileName,
-      elementType,
-      elementSubType,
-      thumbSize: 0,
-      needCreate: true,
-      downloadType: 1,
-      file_uuid: '',
-    });
-
-    await this.copyFile(filePath, mediaPath);
     const fileSize = await this.getFileSize(filePath);
+    if (uploadGroupFile) {
+      const mediaPath = this.context.session.getMsgService().getRichMediaFilePathForGuild({
+        md5HexStr: fileMd5,
+        fileName,
+        elementType,
+        elementSubType,
+        thumbSize: 0,
+        needCreate: true,
+        downloadType: 1,
+        file_uuid: '',
+      });
+
+      await this.copyFile(filePath, mediaPath);
+
+      return {
+        md5: fileMd5,
+        fileName,
+        path: mediaPath,
+        fileSize,
+        ext,
+      };
+    }
     return {
       md5: fileMd5,
       fileName,
-      path: mediaPath,
+      path: filePath,
       fileSize,
       ext,
     };

packages/napcat-core/external/appid.json

@@ -502,5 +502,21 @@
   "9.9.26-44175": {
     "appid": 537336450,
     "qua": "V1_WIN_NQ_9.9.26_44175_GW_B"
+  },
+  "9.9.26-44343": {
+    "appid": 537336603,
+    "qua": "V1_WIN_NQ_9.9.26_44343_GW_B"
+  },
+  "3.2.23-44343": {
+    "appid": 537336639,
+    "qua": "V1_LNX_NQ_3.2.23_44343_GW_B"
+  },
+  "9.9.26-44498": {
+    "appid": 537337416,
+    "qua": "V1_WIN_NQ_9.9.26_44498_GW_B"
+  },
+  "9.9.26-44725": {
+    "appid": 537337569,
+    "qua": "V1_WIN_NQ_9.9.26_44725_GW_B"
   }
 }

packages/napcat-core/external/napi2native.json

@@ -87,6 +87,10 @@
     "send": "23B0330",
     "recv": "0957648"
   },
+  "3.2.21-42086-arm64": {
+    "send": "3D6D98C",
+    "recv": "14797C8"
+  },
   "3.2.21-42086-x64": {
     "send": "5B42CF0",
     "recv": "2FDA6F0"
@@ -130,5 +134,25 @@
   "9.9.26-44175-x64": {
     "send": "0A0F2EC",
     "recv": "1D3AD4D"
+  },
+  "9.9.26-44343-x64": {
+    "send": "0A0F7BC",
+    "recv": "1D3C3CD"
+  },
+  "3.2.23-44343-arm64": {
+    "send": "3C867DC",
+    "recv": "1404938"
+  },
+  "3.2.23-44343-x64": {
+    "send": "59A27B0",
+    "recv": "2FFBE90"
+  },
+  "9.9.26-44498-x64": {
+    "send": "0A1051C",
+    "recv": "1D3BC0D"
+  },
+  "9.9.26-44725-x64": {
+    "send": "0A18D0C",
+    "recv": "1D4BF0D"
   }
 }

packages/napcat-core/external/packet.json

@@ -642,5 +642,25 @@
   "9.9.26-44175-x64": {
     "send": "2CD84A0",
     "recv": "2CDBA20"
+  },
+  "3.2.23-44343-x64": {
+    "send": "A46F140",
+    "recv": "A472BE0"
+  },
+  "9.9.26-44343-x64": {
+    "send": "2CD8EE0",
+    "recv": "2CDC460"
+  },
+  "3.2.23-44343-arm64": {
+    "send": "6926F60",
+    "recv": "692A910"
+  },
+  "9.9.26-44498-x64": {
+    "send": "2CDAE40",
+    "recv": "2CDE3C0"
+  },
+  "9.9.26-44725-x64": {
+    "send": "2CEBB20",
+    "recv": "2CEF0A0"
   }
 }

packages/napcat-core/helper/audio.ts

@@ -1,19 +1,8 @@
 import fsPromise from 'fs/promises';
 import path from 'node:path';
 import { randomUUID } from 'crypto';
-import { EncodeResult, getDuration, getWavFileInfo, isSilk, isWav } from 'silk-wasm';
 import { LogWrapper } from '@/napcat-core/helper/log';
-import { EncodeArgs } from 'napcat-common/src/audio-worker';
 import { FFmpegService } from '@/napcat-core/helper/ffmpeg/ffmpeg';
-import { runTask } from 'napcat-common/src/worker';
-import { fileURLToPath } from 'node:url';
-
-const ALLOW_SAMPLE_RATE = [8000, 12000, 16000, 24000, 32000, 44100, 48000];
-
-function getWorkerPath () {
-  // return new URL(/* @vite-ignore */ './audio-worker.mjs', import.meta.url).href;
-  return path.join(path.dirname(fileURLToPath(import.meta.url)), 'audio-worker.mjs');
-}
 
 async function guessDuration (pttPath: string, logger: LogWrapper) {
   const pttFileInfo = await fsPromise.stat(pttPath);
@@ -22,51 +11,23 @@ async function guessDuration (pttPath: string, logger: LogWrapper) {
   return duration;
 }
 
-async function handleWavFile (
-  file: Buffer,
-  filePath: string,
-  pcmPath: string
-): Promise<{ input: Buffer; sampleRate: number }> {
-  const { fmt } = getWavFileInfo(file);
-  if (!ALLOW_SAMPLE_RATE.includes(fmt.sampleRate)) {
-    const result = await FFmpegService.convert(filePath, pcmPath);
-    return { input: await fsPromise.readFile(pcmPath), sampleRate: result.sampleRate };
-  }
-  return { input: file, sampleRate: fmt.sampleRate };
-}
-
 export async function encodeSilk (filePath: string, TEMP_DIR: string, logger: LogWrapper) {
   try {
-    const file = await fsPromise.readFile(filePath);
     const pttPath = path.join(TEMP_DIR, randomUUID());
-    if (!isSilk(file)) {
+    if (!(await FFmpegService.isSilk(filePath))) {
       logger.log(`语音文件${filePath}需要转换成silk`);
-      const pcmPath = `${pttPath}.pcm`;
-      // const { input, sampleRate } = isWav(file) ? await handleWavFile(file, filePath, pcmPath): { input: await FFmpegService.convert(filePath, pcmPath) ? await fsPromise.readFile(pcmPath) : Buffer.alloc(0), sampleRate: 24000 };
-      let input: Buffer;
-      let sampleRate: number;
-      if (isWav(file)) {
-        const result = await handleWavFile(file, filePath, pcmPath);
-        input = result.input;
-        sampleRate = result.sampleRate;
-      } else {
-        const result = await FFmpegService.convert(filePath, pcmPath);
-        input = await fsPromise.readFile(pcmPath);
-        sampleRate = result.sampleRate;
-      }
-      const silk = await runTask<EncodeArgs, EncodeResult>(getWorkerPath(), { input, sampleRate });
-      fsPromise.unlink(pcmPath).catch((e) => logger.logError('删除临时文件失败', pcmPath, e));
-      await fsPromise.writeFile(pttPath, Buffer.from(silk.data));
-      logger.log(`语音文件${filePath}转换成功!`, pttPath, '时长:', silk.duration);
+      await FFmpegService.convertToNTSilkTct(filePath, pttPath);
+      const duration = await FFmpegService.getDuration(filePath);
+      logger.log(`语音文件${filePath}转换成功!`, pttPath, '时长:', duration);
       return {
         converted: true,
         path: pttPath,
-        duration: silk.duration / 1000,
+        duration: duration,
       };
     } else {
       let duration = 0;
       try {
-        duration = getDuration(file) / 1000;
+        duration = await FFmpegService.getDuration(filePath);
       } catch (e: unknown) {
         logger.log('获取语音文件时长失败, 使用文件大小推测时长', filePath, (e as Error).stack);
         duration = await guessDuration(filePath, logger);

packages/napcat-core/helper/ffmpeg/ffmpeg-adapter-interface.ts

@@ -27,21 +27,27 @@ export interface IFFmpegAdapter {
   readonly name: string;
 
   /** 是否可用 */
-  isAvailable(): Promise<boolean>;
+  isAvailable (): Promise<boolean>;
 
   /**
      * 获取视频信息(包含缩略图)
      * @param videoPath 视频文件路径
      * @returns 视频信息
      */
-  getVideoInfo(videoPath: string): Promise<VideoInfoResult>;
+  getVideoInfo (videoPath: string): Promise<VideoInfoResult>;
 
   /**
      * 获取音视频文件时长
      * @param filePath 文件路径
      * @returns 时长(秒)
      */
-  getDuration(filePath: string): Promise<number>;
+  getDuration (filePath: string): Promise<number>;
+
+  /**
+   * 判断是否为 Silk 格式
+   * @param filePath 文件路径
+   */
+  isSilk (filePath: string): Promise<boolean>;
 
   /**
      * 转换音频为 PCM 格式
@@ -49,7 +55,7 @@ export interface IFFmpegAdapter {
      * @param pcmPath 输出 PCM 文件路径
      * @returns PCM 数据 Buffer
      */
-  convertToPCM(filePath: string, pcmPath: string): Promise<{ result: boolean, sampleRate: number }>;
+  convertToPCM (filePath: string, pcmPath: string): Promise<{ result: boolean, sampleRate: number; }>;
 
   /**
      * 转换音频文件
@@ -57,12 +63,14 @@ export interface IFFmpegAdapter {
      * @param outputFile 输出文件路径
      * @param format 目标格式 ('amr' | 'silk' 等)
      */
-  convertFile(inputFile: string, outputFile: string, format: string): Promise<void>;
+  convertFile (inputFile: string, outputFile: string, format: string): Promise<void>;
 
   /**
      * 提取视频缩略图
      * @param videoPath 视频文件路径
      * @param thumbnailPath 缩略图输出路径
      */
-  extractThumbnail(videoPath: string, thumbnailPath: string): Promise<void>;
+  extractThumbnail (videoPath: string, thumbnailPath: string): Promise<void>;
+
+  convertToNTSilkTct (inputFile: string, outputFile: string): Promise<void>;
 }

packages/napcat-core/helper/ffmpeg/ffmpeg-addon-adapter.ts

@@ -5,7 +5,7 @@
 
 import { platform, arch } from 'node:os';
 import path from 'node:path';
-import { existsSync } from 'node:fs';
+import { existsSync, openSync, readSync, closeSync } from 'node:fs';
 import { writeFile } from 'node:fs/promises';
 import type { FFmpeg } from './ffmpeg-addon';
 import type { IFFmpegAdapter, VideoInfoResult } from './ffmpeg-adapter-interface';
@@ -87,6 +87,22 @@ export class FFmpegAddonAdapter implements IFFmpegAdapter {
     return addon.getDuration(filePath);
   }
 
+  /**
+   * 判断是否为 Silk 格式
+   */
+  async isSilk (filePath: string): Promise<boolean> {
+    try {
+      const fd = openSync(filePath, 'r');
+      const buffer = Buffer.alloc(10);
+      readSync(fd, buffer, 0, 10, 0);
+      closeSync(fd);
+      const header = buffer.toString();
+      return header.includes('#!SILK') || header.includes('\x02#!SILK');
+    } catch {
+      return false;
+    }
+  }
+
   /**
      * 转换为 PCM
      */
@@ -106,6 +122,11 @@ export class FFmpegAddonAdapter implements IFFmpegAdapter {
     await addon.decodeAudioToFmt(inputFile, outputFile, format);
   }
 
+  async convertToNTSilkTct (inputFile: string, outputFile: string): Promise<void> {
+    const addon = this.ensureAddon();
+    await addon.convertToNTSilkTct(inputFile, outputFile);
+  }
+
   /**
      * 提取缩略图
      */

packages/napcat-core/helper/ffmpeg/ffmpeg-addon.ts

@@ -70,4 +70,6 @@ export interface FFmpeg {
      */
   decodeAudioToPCM (filePath: string, pcmPath: string, sampleRate?: number): Promise<{ result: boolean, sampleRate: number; }>;
   decodeAudioToFmt (filePath: string, pcmPath: string, format: string): Promise<{ channels: number; sampleRate: number; format: string; }>;
+
+  convertToNTSilkTct (inputFile: string, outputFile: string): Promise<void>;
 }

packages/napcat-core/helper/ffmpeg/ffmpeg-exec-adapter.ts

@@ -3,7 +3,7 @@
  * 使用 execFile 调用 FFmpeg 命令行工具的适配器实现
  */
 
-import { readFileSync, existsSync, mkdirSync } from 'fs';
+import { readFileSync, existsSync, mkdirSync, openSync, readSync, closeSync } from 'fs';
 import { dirname, join } from 'path';
 import { execFile } from 'child_process';
 import { promisify } from 'util';
@@ -154,6 +154,22 @@ export class FFmpegExecAdapter implements IFFmpegAdapter {
     }
   }
 
+  /**
+   * 判断是否为 Silk 格式
+   */
+  async isSilk (filePath: string): Promise<boolean> {
+    try {
+      const fd = openSync(filePath, 'r');
+      const buffer = Buffer.alloc(10);
+      readSync(fd, buffer, 0, 10, 0);
+      closeSync(fd);
+      const header = buffer.toString();
+      return header.includes('#!SILK') || header.includes('\x02#!SILK');
+    } catch {
+      return false;
+    }
+  }
+
   /**
      * 转换为 PCM
      */
@@ -241,4 +257,8 @@ export class FFmpegExecAdapter implements IFFmpegAdapter {
       throw new Error(`提取缩略图失败: ${(error as Error).message}`);
     }
   }
+
+  async convertToNTSilkTct (_inputFile: string, _outputFile: string): Promise<void> {
+    throw new Error('convertToNTSilkTct is not implemented in FFmpegExecAdapter');
+  }
 }

packages/napcat-core/helper/ffmpeg/ffmpeg.ts

@@ -64,7 +64,10 @@ export class FFmpegService {
     }
     return this.adapter;
   }
-
+  public static async convertToNTSilkTct (inputFile: string, outputFile: string): Promise<void> {
+    const adapter = await this.getAdapter();
+    await adapter.convertToNTSilkTct(inputFile, outputFile);
+  }
   /**
      * 设置 FFmpeg 路径并更新适配器
      * @deprecated 建议使用 init() 方法初始化
@@ -92,11 +95,27 @@ export class FFmpegService {
   /**
      * 转换音频文件
      */
-  public static async convertFile (inputFile: string, outputFile: string, format: string): Promise<void> {
+  public static async convertAudioFmt (inputFile: string, outputFile: string, format: string): Promise<void> {
     const adapter = await this.getAdapter();
     await adapter.convertFile(inputFile, outputFile, format);
   }
 
+  /**
+   * 获取音频时长
+   */
+  public static async getDuration (filePath: string): Promise<number> {
+    const adapter = await this.getAdapter();
+    return adapter.getDuration(filePath);
+  }
+
+  /**
+   * 判断是否为 Silk 格式
+   */
+  public static async isSilk (filePath: string): Promise<boolean> {
+    const adapter = await this.getAdapter();
+    return adapter.isSilk(filePath);
+  }
+
   /**
      * 转换为 PCM 格式
      */

packages/napcat-core/index.ts

@@ -17,7 +17,6 @@ import {
   WrapperSessionInitConfig,
 } from '@/napcat-core/wrapper';
 import { LogLevel, LogWrapper } from '@/napcat-core/helper/log';
-import { NodeIKernelLoginService } from '@/napcat-core/services';
 import { QQBasicInfoWrapper } from '@/napcat-core/helper/qq-basic-info';
 import { NapCatPathWrapper } from 'napcat-common/src/path';
 import path from 'node:path';
@@ -126,7 +125,7 @@ export class NapCatCore {
     container.bind(TypedEventEmitter).toConstantValue(this.event);
     ReceiverServiceRegistry.forEach((ServiceClass, serviceName) => {
       container.bind(ServiceClass).toSelf();
-      //console.log(`Registering service handler for: ${serviceName}`);
+      // console.log(`Registering service handler for: ${serviceName}`);
       this.context.packetHandler.onCmd(serviceName, ({ seq, hex_data }) => {
         const serviceInstance = container.get(ServiceClass);
         return serviceInstance.handler(seq, hex_data);
@@ -178,8 +177,10 @@ export class NapCatCore {
 
     msgListener.onKickedOffLine = (Info: KickedOffLineInfo) => {
       // 下线通知
-      this.context.logger.logError('[KickedOffLine] [' + Info.tipsTitle + '] ' + Info.tipsDesc);
+      const tips = `[KickedOffLine] [${Info.tipsTitle}] ${Info.tipsDesc}`;
+      this.context.logger.logError(tips);
       this.selfInfo.online = false;
+      this.event.emit('KickedOffLine', tips);
     };
     msgListener.onRecvMsg = (msgs) => {
       msgs.forEach(msg => this.context.logger.logMessage(msg, this.selfInfo));
@@ -278,7 +279,6 @@ export interface InstanceContext {
   readonly wrapper: WrapperNodeApi;
   readonly session: NodeIQQNTWrapperSession;
   readonly logger: LogWrapper;
-  readonly loginService: NodeIKernelLoginService;
   readonly basicInfoWrapper: QQBasicInfoWrapper;
   readonly pathWrapper: NapCatPathWrapper;
   readonly packetHandler: NativePacketHandler;

packages/napcat-core/listeners/NodeIKernelLoginListener.ts

@@ -53,6 +53,8 @@ export class NodeIKernelLoginListener {
 
   onLoginState (..._args: any[]): any {
   }
+  onLoginRecordUpdate (..._args: any[]): any {
+  }
 }
 
 export interface QRCodeLoginSucceedResult {

packages/napcat-core/packet/handler/eventList.ts

@@ -1,6 +1,7 @@
 import { TypedEventEmitter } from './typeEvent';
 
 export interface AppEvents {
-  'event:emoji_like': { groupId: string; senderUin: string; emojiId: string, msgSeq: string, isAdd: boolean, count: number };
+  'event:emoji_like': { groupId: string; senderUin: string; emojiId: string, msgSeq: string, isAdd: boolean, count: number; };
+  KickedOffLine: string;
 }
 export const appEvent = new TypedEventEmitter<AppEvents>();

packages/napcat-core/packet/message/element.ts

@@ -510,15 +510,15 @@ export class PacketMsgPttElement extends IPacketMsgElement<SendPttElement> {
   }
 
   override buildElement (): NapProtoEncodeStructType<typeof Elem>[] {
-    return [];
-    // if (!this.msgInfo) return [];
-    // return [{
-    //     commonElem: {
-    //         serviceType: 48,
-    //         pbElem: new NapProtoMsg(MsgInfo).encode(this.msgInfo),
-    //         businessType: 22,
-    //     }
-    // }];
+    //return [];
+    if (!this.msgInfo) return [];
+    return [{
+      commonElem: {
+        serviceType: 48,
+        pbElem: new NapProtoMsg(MsgInfo).encode(this.msgInfo),
+        businessType: 22,
+      }
+    }];
   }
 
   override toPreview (): string {

packages/napcat-core/types/msg.ts

@@ -181,7 +181,7 @@ export interface MessageElement {
   tofuRecordElement?: TofuRecordElement,
   taskTopMsgElement?: TaskTopMsgElement,
   recommendedMsgElement?: RecommendedMsgElement,
-  actionBarElement?: ActionBarElement
+  actionBarElement?: ActionBarElement;
 }
 
 /**
@@ -337,7 +337,7 @@ export interface InlineKeyboardElementRowButton {
  */
 export interface InlineKeyboardElement {
   rows: [{
-    buttons: InlineKeyboardElementRowButton[]
+    buttons: InlineKeyboardElementRowButton[];
   }],
   botAppid: string;
 }
@@ -441,14 +441,14 @@ export interface TipGroupElement {
       uid: string;
       card: string;
       name: string;
-      role: NTGroupMemberRole
+      role: NTGroupMemberRole;
     };
     member: {
-      uid: string
+      uid: string;
       card: string;
       name: string;
-      role: NTGroupMemberRole
-    }
+      role: NTGroupMemberRole;
+    };
   };
 }
 
@@ -498,6 +498,7 @@ export interface RawMessage {
   sendStatus?: SendStatusType;// 消息状态
   recallTime: string;// 撤回时间，"0" 是没有撤回
   records: RawMessage[];// 消息记录
+  emojiLikesList?: Array<{ emojiId: string; emojiType: string; likesCnt: string; isClicked: string; }>;
   elements: MessageElement[];// 消息元素
   sourceType: MsgSourceType;// 消息来源类型
   isOnlineMsg: boolean;// 是否为在线消息
@@ -508,9 +509,9 @@ export interface RawMessage {
  * 查询消息参数接口
  */
 export interface QueryMsgsParams {
-  chatInfo: Peer & { privilegeFlag?: number };
+  chatInfo: Peer & { privilegeFlag?: number; };
   // searchFields: number;
-  filterMsgType: Array<{ type: NTMsgType, subType: Array<number> }>;
+  filterMsgType: Array<{ type: NTMsgType, subType: Array<number>; }>;
   filterSendersUid: string[];
   filterMsgFromTime: string;
   filterMsgToTime: string;
@@ -554,7 +555,7 @@ export interface MsgReqType {
   queryOrder: boolean,
   includeSelf: boolean,
   includeDeleteMsg: boolean,
-  extraCnt: number
+  extraCnt: number;
 }
 
 /**

packages/napcat-core/types/webapi.ts

@@ -73,7 +73,7 @@ export interface WebApiGroupNoticeFeed {
   fn: number;
   cn: number;
   vn: number;
-  settings: {
+  settings?: {
     is_show_edit_card: number
     remind_ts: number
     tip_window_type: number

packages/napcat-develop/loadNapCat.cjs

@@ -73,6 +73,8 @@ async function copyAll () {
   process.env.NAPCAT_QQ_PACKAGE_INFO_PATH = path.join(TARGET_DIR, 'package.json');
   process.env.NAPCAT_QQ_VERSION_CONFIG_PATH = path.join(TARGET_DIR, 'config.json');
   process.env.NAPCAT_DISABLE_PIPE = '1';
+  // 禁用重启和多进程功能
+  process.env.NAPCAT_DISABLE_MULTI_PROCESS = '1';
   process.env.NAPCAT_WORKDIR = TARGET_DIR;
   // 开发环境使用固定密钥
   process.env.NAPCAT_WEBUI_JWT_SECRET_KEY = 'napcat_dev_secret_key';

packages/napcat-framework/napcat.ts

@@ -73,7 +73,7 @@ export async function NCoreInitFramework (
   // 过早进入会导致addKernelMsgListener等Listener添加失败
   // await sleep(2500);
   // 初始化 NapCatFramework
-  const loaderObject = new NapCatFramework(wrapper, session, logger, loginService, selfInfo, basicInfoWrapper, pathWrapper, nativePacketHandler);
+  const loaderObject = new NapCatFramework(wrapper, session, logger, selfInfo, basicInfoWrapper, pathWrapper, nativePacketHandler);
   await loaderObject.core.initCore();
 
   // 启动WebUi
@@ -94,7 +94,6 @@ export class NapCatFramework {
     wrapper: WrapperNodeApi,
     session: NodeIQQNTWrapperSession,
     logger: LogWrapper,
-    loginService: NodeIKernelLoginService,
     selfInfo: SelfInfo,
     basicInfoWrapper: QQBasicInfoWrapper,
     pathWrapper: NapCatPathWrapper,
@@ -106,7 +105,6 @@ export class NapCatFramework {
       wrapper,
       session,
       logger,
-      loginService,
       basicInfoWrapper,
       pathWrapper,
     };

packages/napcat-framework/vite.config.ts

@@ -8,7 +8,6 @@ import react from '@vitejs/plugin-react-swc';
 import napcatVersion from 'napcat-vite/vite-plugin-version.js';
 // 依赖排除
 const external = [
-  'silk-wasm',
   'ws',
   'express',
 ];
@@ -60,7 +59,6 @@ const FrameworkBaseConfig = () =>
       lib: {
         entry: {
           napcat: path.resolve(__dirname, 'napcat.ts'),
-          'audio-worker': path.resolve(__dirname, '../napcat-common/src/audio-worker.ts'),
           'worker/conoutSocketWorker': path.resolve(__dirname, '../napcat-pty/worker/conoutSocketWorker.ts'),
         },
         formats: ['es'],

packages/napcat-onebot/action/file/GetRecord.ts

@@ -1,7 +1,6 @@
 import { GetFileBase, GetFilePayload, GetFileResponse } from './GetFile';
 import { ActionName } from '@/napcat-onebot/action/router';
 import { promises as fs } from 'fs';
-import { decode } from 'silk-wasm';
 import { FFmpegService } from '@/napcat-core/helper/ffmpeg/ffmpeg';
 
 const out_format = ['mp3', 'amr', 'wma', 'm4a', 'spx', 'ogg', 'wav', 'flac'];
@@ -21,19 +20,13 @@ export default class GetRecord extends GetFileBase {
       if (!out_format.includes(payload.out_format)) {
         throw new Error('转换失败 out_format 字段可能格式不正确');
       }
-      const pcmFile = `${inputFile}.pcm`;
       const outputFile = `${inputFile}.${payload.out_format}`;
       try {
         await fs.access(inputFile);
         try {
           await fs.access(outputFile);
         } catch {
-          if (FFmpegService.getAdapterName() === 'FFmpegAddon') {
-            await FFmpegService.convertFile(inputFile, outputFile, payload.out_format);
-          } else {
-            await this.decodeFile(inputFile, pcmFile);
-            await FFmpegService.convertFile(pcmFile, outputFile, payload.out_format);
-          }
+          await FFmpegService.convertAudioFmt(inputFile, outputFile, payload.out_format);
         }
         const base64Data = await fs.readFile(outputFile, { encoding: 'base64' });
         res.file = outputFile;
@@ -46,15 +39,4 @@ export default class GetRecord extends GetFileBase {
     }
     return res;
   }
-
-  private async decodeFile (inputFile: string, outputFile: string): Promise<void> {
-    try {
-      const inputData = await fs.readFile(inputFile);
-      const decodedData = await decode(inputData, 24000);
-      await fs.writeFile(outputFile, Buffer.from(decodedData.data));
-    } catch (error) {
-      console.error('Error decoding file:', error);
-      throw error; // 重新抛出错误以便调用者可以处理
-    }
-  }
 }

packages/napcat-onebot/action/go-cqhttp/GetForwardMsg.ts

@@ -100,7 +100,7 @@ export class GoCQHTTPGetForwardMsgAction extends OneBotAction<Payload, {
 
     // 3. 定义协议回退逻辑函数
     const protocolFallbackLogic = async (resId: string) => {
-      const ob = (await this.obContext.apis.MsgApi.parseMessageV2(createFakeForwardMsg(resId)))?.arrayMsg;
+      const ob = (await this.obContext.apis.MsgApi.parseMessageV2(createFakeForwardMsg(resId), true))?.arrayMsg;
       if (ob) {
         return {
           messages: (ob?.message?.[0] as OB11MessageForward)?.data?.content,
@@ -122,7 +122,7 @@ export class GoCQHTTPGetForwardMsgAction extends OneBotAction<Payload, {
 
     if (rootMsg) {
       // 5. 获取消息内容
-      const data = await this.core.apis.MsgApi.getMsgsByMsgId(rootMsg.Peer, [rootMsg.MsgId]);
+      const data = await this.core.apis.MsgApi.getMsgHistory(rootMsg.Peer, rootMsg.MsgId, 1);//getMsgsIncludeSelf
 
       if (data && data.result === 0 && data.msgList.length > 0) {
         const singleMsg = data.msgList[0];

packages/napcat-onebot/action/go-cqhttp/UploadGroupFile.ts

@@ -12,6 +12,7 @@ const SchemaData = Type.Object({
   name: Type.String(),
   folder: Type.Optional(Type.String()),
   folder_id: Type.Optional(Type.String()), // 临时扩展
+  upload_file: Type.Boolean({ default: true }),
 });
 
 type Payload = Static<typeof SchemaData>;
@@ -41,7 +42,7 @@ export default class GoCQHTTPUploadGroupFile extends OneBotAction<Payload, Uploa
       peer,
       deleteAfterSentFiles: [],
     };
-    const sendFileEle = await this.obContext.apis.FileApi.createValidSendFileElement(msgContext, downloadResult.path, payload.name, payload.folder ?? payload.folder_id);
+    const sendFileEle = await this.obContext.apis.FileApi.createValidSendFileElement(msgContext, downloadResult.path, payload.name, payload.folder ?? payload.folder_id, payload.upload_file);
     msgContext.deleteAfterSentFiles.push(downloadResult.path);
     const returnMsg = await this.obContext.apis.MsgApi.sendMsgWithOb11UniqueId(peer, [sendFileEle], msgContext.deleteAfterSentFiles);
 

packages/napcat-onebot/action/go-cqhttp/UploadPrivateFile.ts

@@ -11,6 +11,7 @@ const SchemaData = Type.Object({
   user_id: Type.Union([Type.Number(), Type.String()]),
   file: Type.String(),
   name: Type.String(),
+  upload_file: Type.Boolean({ default: true }),
 });
 
 type Payload = Static<typeof SchemaData>;
@@ -51,7 +52,7 @@ export default class GoCQHTTPUploadPrivateFile extends OneBotAction<Payload, Upl
       }, ContextMode.Private),
       deleteAfterSentFiles: [],
     };
-    const sendFileEle: SendFileElement = await this.obContext.apis.FileApi.createValidSendFileElement(msgContext, downloadResult.path, payload.name);
+    const sendFileEle: SendFileElement = await this.obContext.apis.FileApi.createValidSendFileElement(msgContext, downloadResult.path, payload.name, '', payload.upload_file);
     msgContext.deleteAfterSentFiles.push(downloadResult.path);
     const returnMsg = await this.obContext.apis.MsgApi.sendMsgWithOb11UniqueId(await this.getPeer(payload), [sendFileEle], msgContext.deleteAfterSentFiles);
 

packages/napcat-onebot/action/group/GetGroupNotice.ts

@@ -7,19 +7,26 @@ interface GroupNotice {
   publish_time: number;
   notice_id: string;
   message: {
-    text: string
+    text: string;
     // 保持一段时间兼容性 防止以往版本出现问题 后续版本可考虑移除
     image: Array<{
-      height: string
-      width: string
-      id: string
+      height: string;
+      width: string;
+      id: string;
     }>,
     images: Array<{
-      height: string
-      width: string
-      id: string
-    }>
+      height: string;
+      width: string;
+      id: string;
+    }>;
   };
+  settings?: {
+    is_show_edit_card: number,
+    remind_ts: number,
+    tip_window_type: number,
+    confirm_required: number;
+  };
+  read_num?: number;
 }
 
 const SchemaData = Type.Object({
@@ -59,6 +66,8 @@ export class GetGroupNotice extends OneBotAction<Payload, GroupNotice[]> {
           image,
           images: image,
         },
+        settings: retApiNotice.settings,
+        read_num: retApiNotice.read_num
       };
       retNotices.push(retNotice);
     }

packages/napcat-onebot/action/index.ts

@@ -86,6 +86,7 @@ import { GetGroupMemberList } from './group/GetGroupMemberList';
 import { GetGroupFileUrl } from '@/napcat-onebot/action/file/GetGroupFileUrl';
 import { GetPacketStatus } from '@/napcat-onebot/action/packet/GetPacketStatus';
 import { GetCredentials } from './system/GetCredentials';
+import { SetRestart } from './system/SetRestart';
 import { SendGroupSign, SetGroupSign } from './extends/SetGroupSign';
 import { GoCQHTTPGetGroupAtAllRemain } from './go-cqhttp/GetGroupAtAllRemain';
 import { GoCQHTTPCheckUrlSafely } from './go-cqhttp/GoCQHTTPCheckUrlSafely';
@@ -266,6 +267,7 @@ export function createActionMap (obContext: NapCatOneBot11Adapter, core: NapCatC
     new GetGroupFileSystemInfo(obContext, core),
     new GetGroupFilesByFolder(obContext, core),
     new GetPacketStatus(obContext, core),
+    new SetRestart(obContext, core),
     new GroupPoke(obContext, core),
     new FriendPoke(obContext, core),
     new GetUserStatus(obContext, core),

packages/napcat-onebot/action/msg/GetMsg.ts

@@ -36,6 +36,15 @@ class GetMsg extends OneBotAction<Payload, OB11Message> {
     if (!msg) throw Error('消息不存在');
     const retMsg = await this.obContext.apis.MsgApi.parseMessage(msg, config.messagePostFormat);
     if (!retMsg) throw Error('消息为空');
+    retMsg.emoji_likes_list = [];
+    msg.emojiLikesList?.map(emoji => {
+      retMsg.emoji_likes_list?.push({
+        emoji_id: emoji.emojiId,
+        emoji_type: emoji.emojiType,
+        likes_cnt: emoji.likesCnt,
+      });
+    });
+    // 烘焙emoji_likes_list 仅此处烘焙
     try {
       retMsg.message_id = MessageUnique.createUniqueMsgId(peer, msg.msgId)!;
       retMsg.message_seq = retMsg.message_id;

packages/napcat-onebot/action/msg/SendMsg.ts

@@ -317,11 +317,11 @@ export class SendMsgBase extends OneBotAction<OB11PostSendMsg, ReturnDataType> {
 
           const MixElement = sendElements.filter(
             element =>
-              element.elementType !== ElementType.FILE && element.elementType !== ElementType.VIDEO && element.elementType !== ElementType.ARK
+              element.elementType !== ElementType.FILE && element.elementType !== ElementType.VIDEO && element.elementType !== ElementType.ARK && element.elementType !== ElementType.PTT
           );
           const SingleElement = sendElements.filter(
             element =>
-              element.elementType === ElementType.FILE || element.elementType === ElementType.VIDEO || element.elementType === ElementType.ARK
+              element.elementType === ElementType.FILE || element.elementType === ElementType.VIDEO || element.elementType === ElementType.ARK || element.elementType === ElementType.PTT
           ).map(e => [e]);
 
           const AllElement: SendMessageElement[][] = [MixElement, ...SingleElement].filter(e => e !== undefined && e.length !== 0);

packages/napcat-onebot/action/router.ts

@@ -81,7 +81,7 @@ export const ActionName = {
   CanSendRecord: 'can_send_record',
   GetStatus: 'get_status',
   GetVersionInfo: 'get_version_info',
-  // Reboot : 'set_restart',
+  Reboot: 'set_restart',
   CleanCache: 'clean_cache',
   Exit: 'bot_exit',
   // go-cqhttp

packages/napcat-onebot/action/stream/DownloadFileRecordStream.ts

@@ -4,7 +4,6 @@ import { Static, Type } from '@sinclair/typebox';
 import { NetworkAdapterConfig } from '@/napcat-onebot/config/config';
 import { StreamPacket, StreamStatus } from './StreamBasic';
 import fs from 'fs';
-import { decode } from 'silk-wasm';
 import { FFmpegService } from '@/napcat-core/helper/ffmpeg/ffmpeg';
 import { BaseDownloadStream, DownloadResult } from './BaseDownloadStream';
 
@@ -38,7 +37,6 @@ export class DownloadFileRecordStream extends BaseDownloadStream<Payload, Downlo
           throw new Error('转换失败 out_format 字段可能格式不正确');
         }
 
-        const pcmFile = `${downloadPath}.pcm`;
         const outputFile = `${downloadPath}.${payload.out_format}`;
 
         try {
@@ -46,13 +44,8 @@ export class DownloadFileRecordStream extends BaseDownloadStream<Payload, Downlo
           await fs.promises.access(outputFile);
           streamPath = outputFile;
         } catch {
-          // 尝试解码 silk 到 pcm 再用 ffmpeg 转换
-          if (FFmpegService.getAdapterName() === 'FFmpegAddon') {
-            await FFmpegService.convertFile(downloadPath, outputFile, payload.out_format);
-          } else {
-            await this.decodeFile(downloadPath, pcmFile);
-            await FFmpegService.convertFile(pcmFile, outputFile, payload.out_format);
-          }
+          // 尝试解码 amr 到 out format直接 ffmpeg 转换
+          await FFmpegService.convertAudioFmt(downloadPath, outputFile, payload.out_format);
           streamPath = outputFile;
         }
       }
@@ -82,15 +75,4 @@ export class DownloadFileRecordStream extends BaseDownloadStream<Payload, Downlo
       throw new Error(`Download failed: ${(error as Error).message}`);
     }
   }
-
-  private async decodeFile (inputFile: string, outputFile: string): Promise<void> {
-    try {
-      const inputData = await fs.promises.readFile(inputFile);
-      const decodedData = await decode(inputData, 24000);
-      await fs.promises.writeFile(outputFile, Buffer.from(decodedData.data));
-    } catch (error) {
-      console.error('Error decoding file:', error);
-      throw error;
-    }
-  }
 }

packages/napcat-onebot/action/system/SetRestart.ts

@@ -0,0 +1,14 @@
+import { ActionName } from '@/napcat-onebot/action/router';
+import { OneBotAction } from '../OneBotAction';
+import { WebUiDataRuntime } from 'napcat-webui-backend/src/helper/Data';
+
+export class SetRestart extends OneBotAction<void, void> {
+  override actionName = ActionName.Reboot;
+
+  async _handle () {
+    const result = await WebUiDataRuntime.requestRestartProcess();
+    if (!result.result) {
+      throw new Error(result.message || '进程重启失败');
+    }
+  }
+}

packages/napcat-onebot/api/file.ts

@@ -19,16 +19,18 @@ export class OneBotFileApi {
     this.core = core;
   }
 
-  async createValidSendFileElement (context: SendMessageContext, filePath: string, fileName: string = '', folderId: string = ''): Promise<SendFileElement> {
+  async createValidSendFileElement (context: SendMessageContext, filePath: string, fileName: string = '', folderId: string = '', uploadGroupFile: boolean = false): Promise<SendFileElement> {
     const {
       fileName: _fileName,
       path,
       fileSize,
-    } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.FILE);
+    } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.FILE, 0, uploadGroupFile);
     if (fileSize === 0) {
       throw new Error('文件异常，大小为0');
     }
-    context.deleteAfterSentFiles.push(path);
+    if (uploadGroupFile) {
+      context.deleteAfterSentFiles.push(path);
+    }
     return {
       elementType: ElementType.FILE,
       elementId: '',

packages/napcat-onebot/api/msg.ts

@@ -984,8 +984,20 @@ export class OneBotMsgApi {
     disableGetUrl: boolean = false,
     quick_reply: boolean = false
   ) {
-    if (msg.senderUin === '0' || msg.senderUin === '') return;
-    if (msg.peerUin === '0' || msg.peerUin === '') return;
+    if ((msg.senderUin === '0' || msg.senderUin === '')) {
+      if (msg.senderUid && msg.senderUid !== '' && msg.senderUid !== '0') {
+        msg.senderUin = await this.core.apis.UserApi.getUinByUidV2(msg.senderUid);
+      } else {
+        return undefined;
+      }
+    }
+    if (msg.peerUin === '0' || msg.peerUin === '') {
+      if (msg.peerUid && msg.peerUid !== '' && msg.peerUid !== '0') {
+        msg.peerUin = await this.core.apis.UserApi.getUinByUidV2(msg.peerUid);
+      } else {
+        return undefined;
+      }
+    }
 
     const resMsg = this.initializeMessage(msg);
 
@@ -1063,7 +1075,8 @@ export class OneBotMsgApi {
     resMsg.sub_type = 'group';
     const ret = await this.core.apis.MsgApi.getTempChatInfo(ChatType.KCHATTYPETEMPC2CFROMGROUP, msg.senderUid);
     if (ret.result === 0) {
-      const member = await this.core.apis.GroupApi.getGroupMember(msg.peerUin, msg.senderUin);
+      // 避免uin:'' uid非空，uid一般不空
+      const member = await this.core.apis.GroupApi.getGroupMember(msg.peerUin, await this.core.apis.UserApi.getUinByUidV2(msg.senderUid));
       resMsg.group_id = parseInt(ret.tmpChatInfo!.groupCode);
       resMsg.sender.nickname = member?.nick ?? member?.cardName ?? '临时会话';
       resMsg.temp_source = 0;

packages/napcat-onebot/config/config.ts

@@ -6,7 +6,7 @@ const HttpServerConfigSchema = Type.Object({
   port: Type.Number({ default: 3000 }),
   host: Type.String({ default: '127.0.0.1' }),
   enableCors: Type.Boolean({ default: true }),
-  enableWebsocket: Type.Boolean({ default: true }),
+  enableWebsocket: Type.Boolean({ default: false }),
   messagePostFormat: Type.String({ default: 'array' }),
   token: Type.String({ default: '' }),
   debug: Type.Boolean({ default: false }),
@@ -18,7 +18,7 @@ const HttpSseServerConfigSchema = Type.Object({
   port: Type.Number({ default: 3000 }),
   host: Type.String({ default: '127.0.0.1' }),
   enableCors: Type.Boolean({ default: true }),
-  enableWebsocket: Type.Boolean({ default: true }),
+  enableWebsocket: Type.Boolean({ default: false }),
   messagePostFormat: Type.String({ default: 'array' }),
   token: Type.String({ default: '' }),
   debug: Type.Boolean({ default: false }),

packages/napcat-onebot/index.ts

@@ -246,7 +246,7 @@ export class NapCatOneBot11Adapter {
     await this.handleConfigChange(prev.network.websocketClients, now.network.websocketClients, OB11WebSocketClientAdapter);
   }
 
-  private async handleConfigChange<CT extends NetworkAdapterConfig>(
+  private async handleConfigChange<CT extends NetworkAdapterConfig> (
     prevConfig: NetworkAdapterConfig[],
     nowConfig: NetworkAdapterConfig[],
     adapterClass: new (
@@ -305,6 +305,9 @@ export class NapCatOneBot11Adapter {
     };
 
     msgListener.onRecvMsg = async (msg) => {
+      if (!this.networkManager.hasActiveAdapters()) {
+        return;
+      }
       for (const m of msg) {
         if (this.bootTime > parseInt(m.msgTime)) {
           this.context.logger.logDebug(`消息时间${m.msgTime}早于启动时间${this.bootTime}，忽略上报`);
@@ -384,6 +387,7 @@ export class NapCatOneBot11Adapter {
       }
     };
     msgListener.onKickedOffLine = async (kick) => {
+      WebUiDataRuntime.setQQLoginStatus(false);
       const event = new BotOfflineEvent(this.core, kick.tipsTitle, kick.tipsDesc);
       this.networkManager
         .emitEvent(event)
@@ -517,15 +521,14 @@ export class NapCatOneBot11Adapter {
   }
 
   private async emitMsg (message: RawMessage) {
-    const network = await this.networkManager.getAllConfig();
     this.context.logger.logDebug('收到新消息 RawMessage', message);
     await Promise.allSettled([
-      this.handleMsg(message, network),
+      this.handleMsg(message),
       message.chatType === ChatType.KCHATTYPEGROUP ? this.handleGroupEvent(message) : this.handlePrivateMsgEvent(message),
     ]);
   }
 
-  private async handleMsg (message: RawMessage, network: Array<NetworkAdapterConfig>) {
+  private async handleMsg (message: RawMessage) {
     // 过滤无效消息
     if (message.msgType === NTMsgType.KMSGTYPENULL) {
       return;
@@ -535,10 +538,36 @@ export class NapCatOneBot11Adapter {
       if (ob11Msg) {
         const isSelfMsg = this.isSelfMessage(ob11Msg);
         this.context.logger.logDebug('转化为 OB11Message', ob11Msg);
-        const msgMap = this.createMsgMap(network, ob11Msg, isSelfMsg, message);
-        this.handleDebugNetwork(network, msgMap, message);
-        this.handleNotReportSelfNetwork(network, msgMap, isSelfMsg);
-        this.networkManager.emitEventByNames(msgMap);
+        if (isSelfMsg || message.chatType !== ChatType.KCHATTYPEGROUP) {
+          const targetId = parseInt(message.peerUin);
+          ob11Msg.stringMsg.target_id = targetId;
+          ob11Msg.arrayMsg.target_id = targetId;
+        }
+
+        const msgMap = new Map<string, OB11Message>();
+
+        for (const adapter of this.networkManager.adapters.values()) {
+          if (!adapter.isActive) continue;
+          const config = adapter.config;
+          if (isSelfMsg) {
+            if (!('reportSelfMessage' in config) || !config.reportSelfMessage) {
+              continue;
+            }
+          }
+          const msgData = config.messagePostFormat === 'string' ? ob11Msg.stringMsg : ob11Msg.arrayMsg;
+          if (config.debug) {
+            const clone = structuredClone(msgData);
+            clone.raw = message;
+            msgMap.set(adapter.name, clone);
+          } else {
+            msgMap.set(adapter.name, msgData);
+          }
+        }
+        if (msgMap.size > 0) {
+          this.networkManager.emitEventByNames(msgMap);
+        } else if (this.networkManager.hasActiveAdapters()) {
+          this.context.logger.logDebug('没有可用的网络适配器发送消息，消息内容:', message);
+        }
       }
     } catch (e) {
       this.context.logger.logError('constructMessage error: ', e);
@@ -553,48 +582,6 @@ export class NapCatOneBot11Adapter {
       ob11Msg.arrayMsg.user_id.toString() === this.core.selfInfo.uin;
   }
 
-  private createMsgMap (network: Array<NetworkAdapterConfig>, ob11Msg: {
-    stringMsg: OB11Message;
-    arrayMsg: OB11Message;
-  }, isSelfMsg: boolean, message: RawMessage): Map<string, OB11Message> {
-    const msgMap: Map<string, OB11Message> = new Map();
-    network.filter(e => e.enable).forEach(e => {
-      if (isSelfMsg || message.chatType !== ChatType.KCHATTYPEGROUP) {
-        ob11Msg.stringMsg.target_id = parseInt(message.peerUin);
-        ob11Msg.arrayMsg.target_id = parseInt(message.peerUin);
-      }
-      if ('messagePostFormat' in e && e.messagePostFormat === 'string') {
-        msgMap.set(e.name, structuredClone(ob11Msg.stringMsg));
-      } else {
-        msgMap.set(e.name, structuredClone(ob11Msg.arrayMsg));
-      }
-    });
-    return msgMap;
-  }
-
-  private handleDebugNetwork (network: Array<NetworkAdapterConfig>, msgMap: Map<string, OB11Message>, message: RawMessage) {
-    const debugNetwork = network.filter(e => e.enable && e.debug);
-    if (debugNetwork.length > 0) {
-      debugNetwork.forEach(adapter => {
-        const msg = msgMap.get(adapter.name);
-        if (msg) {
-          msg.raw = message;
-        }
-      });
-    } else if (msgMap.size === 0) {
-      this.context.logger.logDebug('没有可用的网络适配器发送消息，消息内容:', message);
-    }
-  }
-
-  private handleNotReportSelfNetwork (network: Array<NetworkAdapterConfig>, msgMap: Map<string, OB11Message>, isSelfMsg: boolean) {
-    if (isSelfMsg) {
-      const notReportSelfNetwork = network.filter(e => e.enable && (('reportSelfMessage' in e && !e.reportSelfMessage) || !('reportSelfMessage' in e)));
-      notReportSelfNetwork.forEach(adapter => {
-        msgMap.delete(adapter.name);
-      });
-    }
-  }
-
   private async handleGroupEvent (message: RawMessage) {
     try {
       // 群名片修改事件解析 任何都该判断

packages/napcat-onebot/network/adapter.ts

@@ -23,11 +23,15 @@ export abstract class IOB11NetworkAdapter<CT extends NetworkAdapterConfig> {
     this.logger = core.context.logger;
   }
 
-  abstract onEvent<T extends OB11EmitEventContent>(event: T): Promise<void>;
+  abstract onEvent<T extends OB11EmitEventContent> (event: T): Promise<void>;
 
   abstract open (): void | Promise<void>;
 
   abstract close (): void | Promise<void>;
 
   abstract reload (config: unknown): OB11NetworkReloadType | Promise<OB11NetworkReloadType>;
+
+  get isActive (): boolean {
+    return this.isEnable;
+  }
 }

packages/napcat-onebot/network/http-server-sse.ts

@@ -5,6 +5,10 @@ import { OB11HttpServerAdapter } from './http-server';
 export class OB11HttpSSEServerAdapter extends OB11HttpServerAdapter {
   private sseClients: Response[] = [];
 
+  override get isActive (): boolean {
+    return this.isEnable && (this.sseClients.length > 0 || super.isActive);
+  }
+
   override async handleRequest (req: Request, res: Response) {
     if (req.path === '/_events') {
       this.createSseSupport(req, res);
@@ -25,7 +29,8 @@ export class OB11HttpSSEServerAdapter extends OB11HttpServerAdapter {
     });
   }
 
-  override async onEvent<T extends OB11EmitEventContent>(event: T) {
+  override async onEvent<T extends OB11EmitEventContent> (event: T) {
+    super.onEvent(event);
     const promises: Promise<void>[] = [];
     this.sseClients.forEach((res) => {
       promises.push(new Promise<void>((resolve, reject) => {

packages/napcat-onebot/network/http-server.ts

@@ -1,6 +1,6 @@
 import { OB11EmitEventContent, OB11NetworkReloadType } from './index';
 import express, { Express, NextFunction, Request, Response } from 'express';
-import http from 'http';
+import http, { IncomingMessage } from 'http';
 import { OB11Response } from '@/napcat-onebot/action/OneBotAction';
 import cors from 'cors';
 import { HttpServerConfig } from '@/napcat-onebot/config/config';
@@ -8,13 +8,41 @@ import { IOB11NetworkAdapter } from '@/napcat-onebot/network/adapter';
 import json5 from 'json5';
 import { isFinished } from 'on-finished';
 import typeis from 'type-is';
+import { WebSocket, WebSocketServer, RawData } from 'ws';
+import { URL } from 'url';
+import { ActionName } from '@/napcat-onebot/action/router';
+import { OB11HeartbeatEvent } from '@/napcat-onebot/event/meta/OB11HeartbeatEvent';
+import { OB11LifeCycleEvent, LifeCycleSubType } from '@/napcat-onebot/event/meta/OB11LifeCycleEvent';
+import { Mutex } from 'async-mutex';
 
 export class OB11HttpServerAdapter extends IOB11NetworkAdapter<HttpServerConfig> {
   private app: Express | undefined;
   private server: http.Server | undefined;
+  private wsServer?: WebSocketServer;
+  private wsClients: WebSocket[] = [];
+  private wsClientsMutex = new Mutex();
+  private heartbeatIntervalId: NodeJS.Timeout | null = null;
+  private wsClientWithEvent: WebSocket[] = [];
 
-  override async onEvent<T extends OB11EmitEventContent> (_event: T) {
+  override get isActive (): boolean {
+    return this.isEnable && this.wsClientWithEvent.length > 0;
+  }
+
+  override async onEvent<T extends OB11EmitEventContent> (event: T) {
     // http server is passive, no need to emit event
+    this.wsClientsMutex.runExclusive(async () => {
+      const promises = this.wsClientWithEvent.map((wsClient) => {
+        return new Promise<void>((resolve, reject) => {
+          if (wsClient.readyState === WebSocket.OPEN) {
+            wsClient.send(JSON.stringify(event));
+            resolve();
+          } else {
+            reject(new Error('WebSocket is not open'));
+          }
+        });
+      });
+      await Promise.allSettled(promises);
+    });
   }
 
   open () {
@@ -36,11 +64,24 @@ export class OB11HttpServerAdapter extends IOB11NetworkAdapter<HttpServerConfig>
     this.isEnable = false;
     this.server?.close();
     this.app = undefined;
+    this.stopHeartbeat();
+    await this.wsClientsMutex.runExclusive(async () => {
+      this.wsClients.forEach((wsClient) => {
+        wsClient.close();
+      });
+      this.wsClients = [];
+      this.wsClientWithEvent = [];
+    });
+    this.wsServer?.close();
   }
 
   private initializeServer () {
     this.app = express();
     this.server = http.createServer(this.app);
+    if (this.config.enableWebsocket) {
+      this.wsServer = new WebSocketServer({ server: this.server });
+      this.createWSServer(this.wsServer);
+    }
 
     this.app.use(cors());
     this.app.use(express.urlencoded({ extended: true, limit: '5000mb' }));
@@ -93,6 +134,137 @@ export class OB11HttpServerAdapter extends IOB11NetworkAdapter<HttpServerConfig>
     }
   }
 
+  createWSServer (newServer: WebSocketServer) {
+    newServer.on('connection', async (wsClient, wsReq) => {
+      if (!this.isEnable) {
+        wsClient.close();
+        return;
+      }
+      if (!this.authorizeWS(this.config.token, wsClient, wsReq)) {
+        return;
+      }
+      const paramUrl = wsReq.url?.indexOf('?') !== -1 ? wsReq.url?.substring(0, wsReq.url?.indexOf('?')) : wsReq.url;
+      const isApiConnect = paramUrl === '/api' || paramUrl === '/api/';
+      if (!isApiConnect) {
+        this.connectEvent(this.core, wsClient);
+      }
+
+      wsClient.on('error', (err) => this.logger.log('[OneBot] [HTTP WebSocket] Client Error:', err.message));
+      wsClient.on('message', (message) => {
+        this.handleWSMessage(wsClient, message).then().catch(e => this.logger.logError(e));
+      });
+      wsClient.on('ping', () => {
+        wsClient.pong();
+      });
+      wsClient.on('pong', () => {
+        // this.logger.logDebug('[OneBot] [HTTP WebSocket] Pong received');
+      });
+      wsClient.once('close', () => {
+        this.wsClientsMutex.runExclusive(async () => {
+          const NormolIndex = this.wsClients.indexOf(wsClient);
+          if (NormolIndex !== -1) {
+            this.wsClients.splice(NormolIndex, 1);
+          }
+          const EventIndex = this.wsClientWithEvent.indexOf(wsClient);
+          if (EventIndex !== -1) {
+            this.wsClientWithEvent.splice(EventIndex, 1);
+          }
+          if (this.wsClientWithEvent.length === 0) {
+            this.stopHeartbeat();
+          }
+        });
+      });
+      await this.wsClientsMutex.runExclusive(async () => {
+        if (!isApiConnect) {
+          this.wsClientWithEvent.push(wsClient);
+        }
+        this.wsClients.push(wsClient);
+        if (this.wsClientWithEvent.length > 0) {
+          this.startHeartbeat();
+        }
+      });
+    }).on('error', (err) => this.logger.log('[OneBot] [HTTP WebSocket] Server Error:', err.message));
+  }
+
+  connectEvent (core: any, wsClient: WebSocket) {
+    try {
+      this.checkStateAndReply<unknown>(new OB11LifeCycleEvent(core, LifeCycleSubType.CONNECT), wsClient).catch(e => this.logger.logError('[OneBot] [HTTP WebSocket] 发送生命周期失败', e));
+    } catch (e) {
+      this.logger.logError('[OneBot] [HTTP WebSocket] 发送生命周期失败', e);
+    }
+  }
+
+  private startHeartbeat () {
+    if (this.heartbeatIntervalId) return;
+    this.heartbeatIntervalId = setInterval(() => {
+      this.wsClientsMutex.runExclusive(async () => {
+        this.wsClientWithEvent.forEach((wsClient) => {
+          if (wsClient.readyState === WebSocket.OPEN) {
+            wsClient.send(JSON.stringify(new OB11HeartbeatEvent(this.core, 30000, this.core.selfInfo.online ?? true, true)));
+          }
+        });
+      });
+    }, 30000);
+  }
+
+  private stopHeartbeat () {
+    if (this.heartbeatIntervalId) {
+      clearInterval(this.heartbeatIntervalId);
+      this.heartbeatIntervalId = null;
+    }
+  }
+
+  private authorizeWS (token: string | undefined, wsClient: WebSocket, wsReq: IncomingMessage) {
+    if (!token || token.length === 0) return true;
+    const url = new URL(wsReq?.url || '', `http://${wsReq.headers.host}`);
+    const QueryClientToken = url.searchParams.get('access_token');
+    const HeaderClientToken = wsReq.headers.authorization?.split('Bearer ').pop() || '';
+    const ClientToken = typeof (QueryClientToken) === 'string' && QueryClientToken !== '' ? QueryClientToken : HeaderClientToken;
+    if (ClientToken === token) {
+      return true;
+    }
+    wsClient.send(JSON.stringify(OB11Response.res(null, 'failed', 1403, 'token验证失败')));
+    wsClient.close();
+    return false;
+  }
+
+  private async checkStateAndReply<T> (data: T, wsClient: WebSocket) {
+    return await new Promise<void>((resolve, reject) => {
+      if (wsClient.readyState === WebSocket.OPEN) {
+        wsClient.send(JSON.stringify(data));
+        resolve();
+      } else {
+        reject(new Error('WebSocket is not open'));
+      }
+    });
+  }
+
+  private async handleWSMessage (wsClient: WebSocket, message: RawData) {
+    let receiveData: { action: typeof ActionName[keyof typeof ActionName], params?: any, echo?: any; } = { action: ActionName.Unknown, params: {} };
+    let echo;
+    try {
+      receiveData = json5.parse(message.toString());
+      echo = receiveData.echo;
+    } catch {
+      await this.checkStateAndReply<unknown>(OB11Response.error('json解析失败,请检查数据格式', 1400, echo), wsClient);
+      return;
+    }
+    receiveData.params = (receiveData?.params) ? receiveData.params : {};
+
+    const action = this.actions.get(receiveData.action as any);
+    if (!action) {
+      this.logger.logError('[OneBot] [HTTP WebSocket] 发生错误', '不支持的API ' + receiveData.action);
+      await this.checkStateAndReply<unknown>(OB11Response.error('不支持的API ' + receiveData.action, 1404, echo), wsClient);
+      return;
+    }
+    const retdata = await action.websocketHandle(receiveData.params, echo ?? '', this.name, this.config, {
+      send: async (data: object) => {
+        await this.checkStateAndReply<unknown>({ ...OB11Response.ok(data, echo ?? '', true) }, wsClient);
+      },
+    });
+    await this.checkStateAndReply<unknown>({ ...retdata }, wsClient);
+  }
+
   async httpApiRequest (req: Request, res: Response, request_sse: boolean = false) {
     let payload = req.body;
     if (req.method === 'get') {
@@ -152,6 +324,7 @@ export class OB11HttpServerAdapter extends IOB11NetworkAdapter<HttpServerConfig>
   async reload (newConfig: HttpServerConfig) {
     const wasEnabled = this.isEnable;
     const oldPort = this.config.port;
+    const oldEnableWebsocket = this.config.enableWebsocket;
     this.config = newConfig;
 
     if (newConfig.enable && !wasEnabled) {
@@ -162,7 +335,7 @@ export class OB11HttpServerAdapter extends IOB11NetworkAdapter<HttpServerConfig>
       return OB11NetworkReloadType.NetWorkClose;
     }
 
-    if (oldPort !== newConfig.port) {
+    if (oldPort !== newConfig.port || oldEnableWebsocket !== newConfig.enableWebsocket) {
       this.close();
       if (newConfig.enable) {
         this.open();

packages/napcat-onebot/network/index.ts

@@ -21,7 +21,7 @@ export class OB11NetworkManager {
 
   async emitEvent (event: OB11EmitEventContent) {
     return Promise.all(Array.from(this.adapters.values()).map(async adapter => {
-      if (adapter.isEnable) {
+      if (adapter.isActive) {
         return await adapter.onEvent(event);
       }
     }));
@@ -34,7 +34,7 @@ export class OB11NetworkManager {
   async emitEventByName (names: string[], event: OB11EmitEventContent) {
     return Promise.all(names.map(async name => {
       const adapter = this.adapters.get(name);
-      if (adapter && adapter.isEnable) {
+      if (adapter && adapter.isActive) {
         return await adapter.onEvent(event);
       }
     }));
@@ -43,29 +43,29 @@ export class OB11NetworkManager {
   async emitEventByNames (map: Map<string, OB11EmitEventContent>) {
     return Promise.all(Array.from(map.entries()).map(async ([name, event]) => {
       const adapter = this.adapters.get(name);
-      if (adapter && adapter.isEnable) {
+      if (adapter && adapter.isActive) {
         return await adapter.onEvent(event);
       }
     }));
   }
 
-  registerAdapter<CT extends NetworkAdapterConfig>(adapter: IOB11NetworkAdapter<CT>) {
+  registerAdapter<CT extends NetworkAdapterConfig> (adapter: IOB11NetworkAdapter<CT>) {
     this.adapters.set(adapter.name, adapter);
   }
 
-  async registerAdapterAndOpen<CT extends NetworkAdapterConfig>(adapter: IOB11NetworkAdapter<CT>) {
+  async registerAdapterAndOpen<CT extends NetworkAdapterConfig> (adapter: IOB11NetworkAdapter<CT>) {
     this.registerAdapter(adapter);
     await adapter.open();
   }
 
-  async closeSomeAdapters<CT extends NetworkAdapterConfig>(adaptersToClose: IOB11NetworkAdapter<CT>[]) {
+  async closeSomeAdapters<CT extends NetworkAdapterConfig> (adaptersToClose: IOB11NetworkAdapter<CT>[]) {
     for (const adapter of adaptersToClose) {
       this.adapters.delete(adapter.name);
       await adapter.close();
     }
   }
 
-  async closeSomeAdaterWhenOpen<CT extends NetworkAdapterConfig>(adaptersToClose: IOB11NetworkAdapter<CT>[]) {
+  async closeSomeAdaterWhenOpen<CT extends NetworkAdapterConfig> (adaptersToClose: IOB11NetworkAdapter<CT>[]) {
     for (const adapter of adaptersToClose) {
       this.adapters.delete(adapter.name);
       if (adapter.isEnable) {
@@ -88,17 +88,21 @@ export class OB11NetworkManager {
     this.adapters.clear();
   }
 
-  async readloadAdapter<T>(name: string, config: T) {
+  async readloadAdapter<T> (name: string, config: T) {
     const adapter = this.adapters.get(name);
     if (adapter) {
       await adapter.reload(config);
     }
   }
 
-  async readloadSomeAdapters<T>(configMap: Map<string, T>) {
+  async readloadSomeAdapters<T> (configMap: Map<string, T>) {
     await Promise.all(Array.from(configMap.entries()).map(([name, config]) => this.readloadAdapter(name, config)));
   }
 
+  hasActiveAdapters (): boolean {
+    return Array.from(this.adapters.values()).some(adapter => adapter.isActive);
+  }
+
   async getAllConfig () {
     return Array.from(this.adapters.values()).map(adapter => adapter.config);
   }

packages/napcat-onebot/network/plugin-manger.ts

@@ -33,6 +33,10 @@ export class OB11PluginMangerAdapter extends IOB11NetworkAdapter<PluginConfig> {
   private readonly pluginPath: string;
   private loadedPlugins: Map<string, LoadedPlugin> = new Map();
   declare config: PluginConfig;
+  override get isActive (): boolean {
+    return this.isEnable && this.loadedPlugins.size > 0;
+  }
+
   constructor (
     name: string, core: NapCatCore, obContext: NapCatOneBot11Adapter, actions: ActionMap
   ) {
@@ -251,7 +255,7 @@ export class OB11PluginMangerAdapter extends IOB11NetworkAdapter<PluginConfig> {
     this.logger.log(`[Plugin Adapter] Unloaded plugin: ${pluginName}`);
   }
 
-  async onEvent<T extends OB11EmitEventContent>(event: T) {
+  async onEvent<T extends OB11EmitEventContent> (event: T) {
     if (!this.isEnable) {
       return;
     }
@@ -359,7 +363,7 @@ export class OB11PluginMangerAdapter extends IOB11NetworkAdapter<PluginConfig> {
 
       // 重新加载插件
       const isDirectory = fs.statSync(plugin.pluginPath).isDirectory() &&
-                plugin.pluginPath !== this.pluginPath;
+        plugin.pluginPath !== this.pluginPath;
 
       if (isDirectory) {
         const dirname = path.basename(plugin.pluginPath);

packages/napcat-onebot/network/plugin.ts

@@ -33,6 +33,10 @@ export class OB11PluginAdapter extends IOB11NetworkAdapter<PluginConfig> {
   private readonly pluginPath: string;
   private loadedPlugins: Map<string, LoadedPlugin> = new Map();
   declare config: PluginConfig;
+  override get isActive (): boolean {
+    return this.isEnable && this.loadedPlugins.size > 0;
+  }
+
   constructor (
     name: string, core: NapCatCore, obContext: NapCatOneBot11Adapter, actions: ActionMap
   ) {

packages/napcat-onebot/network/websocket-client.ts

@@ -13,6 +13,10 @@ export class OB11WebSocketClientAdapter extends IOB11NetworkAdapter<WebsocketCli
   private connection: WebSocket | null = null;
   private heartbeatRef: NodeJS.Timeout | null = null;
 
+  override get isActive (): boolean {
+    return this.isEnable && !!this.connection && this.connection.readyState === WebSocket.OPEN;
+  }
+
   async onEvent<T extends OB11EmitEventContent> (event: T) {
     if (this.connection && this.connection.readyState === WebSocket.OPEN) {
       this.connection.send(JSON.stringify(event));

packages/napcat-onebot/network/websocket-server.ts

@@ -21,6 +21,10 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
   private heartbeatIntervalId: NodeJS.Timeout | null = null;
   wsClientWithEvent: WebSocket[] = [];
 
+  override get isActive (): boolean {
+    return this.isEnable && this.wsClientWithEvent.length > 0;
+  }
+
   constructor (
     name: string, config: WebsocketServerConfig, core: NapCatCore, obContext: NapCatOneBot11Adapter, actions: ActionMap
   ) {
@@ -70,6 +74,9 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
           if (EventIndex !== -1) {
             this.wsClientWithEvent.splice(EventIndex, 1);
           }
+          if (this.wsClientWithEvent.length === 0) {
+            this.stopHeartbeat();
+          }
         });
       });
       await this.wsClientsMutex.runExclusive(async () => {
@@ -77,6 +84,9 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
           this.wsClientWithEvent.push(wsClient);
         }
         this.wsClients.push(wsClient);
+        if (this.wsClientWithEvent.length > 0) {
+          this.startHeartbeat();
+        }
       });
     }).on('error', (err) => this.logger.log('[OneBot] [WebSocket Server] Server Error:', err.message));
   }
@@ -114,9 +124,6 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
     this.logger.log('[OneBot] [WebSocket Server] Server Started', typeof (addressInfo) === 'string' ? addressInfo : addressInfo?.address + ':' + addressInfo?.port);
 
     this.isEnable = true;
-    if (this.config.heartInterval > 0) {
-      this.registerHeartBeat();
-    }
   }
 
   async close () {
@@ -128,10 +135,7 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
         this.logger.log('[OneBot] [WebSocket Server] Server Closed');
       }
     });
-    if (this.heartbeatIntervalId) {
-      clearInterval(this.heartbeatIntervalId);
-      this.heartbeatIntervalId = null;
-    }
+    this.stopHeartbeat();
     await this.wsClientsMutex.runExclusive(async () => {
       this.wsClients.forEach((wsClient) => {
         wsClient.close();
@@ -141,7 +145,8 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
     });
   }
 
-  private registerHeartBeat () {
+  private startHeartbeat () {
+    if (this.heartbeatIntervalId || this.config.heartInterval <= 0) return;
     this.heartbeatIntervalId = setInterval(() => {
       this.wsClientsMutex.runExclusive(async () => {
         this.wsClientWithEvent.forEach((wsClient) => {
@@ -153,6 +158,13 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
     }, this.config.heartInterval);
   }
 
+  private stopHeartbeat () {
+    if (this.heartbeatIntervalId) {
+      clearInterval(this.heartbeatIntervalId);
+      this.heartbeatIntervalId = null;
+    }
+  }
+
   private authorize (token: string | undefined, wsClient: WebSocket, wsReq: IncomingMessage) {
     if (!token || token.length === 0) return true;// 客户端未设置密钥
     const url = new URL(wsReq?.url || '', `http://${wsReq.headers.host}`);
@@ -235,12 +247,9 @@ export class OB11WebSocketServerAdapter extends IOB11NetworkAdapter<WebsocketSer
     }
 
     if (oldHeartbeatInterval !== newConfig.heartInterval) {
-      if (this.heartbeatIntervalId) {
-        clearInterval(this.heartbeatIntervalId);
-        this.heartbeatIntervalId = null;
-      }
-      if (newConfig.heartInterval > 0 && this.isEnable) {
-        this.registerHeartBeat();
+      this.stopHeartbeat();
+      if (newConfig.heartInterval > 0 && this.isEnable && this.wsClientWithEvent.length > 0) {
+        this.startHeartbeat();
       }
       return OB11NetworkReloadType.NetWorkReload;
     }

packages/napcat-onebot/types/message.ts

@@ -31,6 +31,7 @@ export interface OB11Message {
   font: number;
   post_type?: EventType;
   raw?: RawMessage;
+  emoji_likes_list?: Array<{ emoji_id: string; emoji_type: string; likes_cnt: string; }>;// 仅get_msg生效
 }
 
 // 合并转发消息接口定义
@@ -46,7 +47,7 @@ export interface OB11Return<DataType> {
   message: string;
   echo?: unknown; // ws调用api才有此字段
   wording?: string;  // go-cqhttp字段，错误信息
-  stream?: 'stream-action' | 'normal-action' ; // 流式返回标记
+  stream?: 'stream-action' | 'normal-action'; // 流式返回标记
 }
 
 // 消息数据类型枚举
@@ -186,7 +187,7 @@ export interface OB11MessageNode {
     name?: string; // compatible with go-cqhttp
     content: OB11MessageMixType;
     source?: string;
-    news?: { text: string }[];
+    news?: { text: string; }[];
     summary?: string;
     prompt?: string;
     time?: string;
@@ -210,13 +211,13 @@ export interface OB11MessageIdMusic {
 // 自定义音乐消息接口定义
 export interface OB11MessageCustomMusic {
   type: OB11MessageDataType.music;
-  data: Omit<CustomMusicSignPostData, 'singer'> & { content?: string };
+  data: Omit<CustomMusicSignPostData, 'singer'> & { content?: string; };
 }
 
 // JSON消息接口定义
 export interface OB11MessageJson {
   type: OB11MessageDataType.json;
-  data: { config?: { token: string }, data: string | object };
+  data: { config?: { token: string; }, data: string | object; };
 }
 
 // 骰子消息接口定义
@@ -254,12 +255,12 @@ export interface OB11MessageForward {
 
 // 消息数据类型定义
 export type OB11MessageData =
-    OB11MessageText |
-    OB11MessageFace | OB11MessageMFace |
-    OB11MessageAt | OB11MessageReply |
-    OB11MessageImage | OB11MessageRecord | OB11MessageFile | OB11MessageVideo |
-    OB11MessageNode | OB11MessageIdMusic | OB11MessageCustomMusic | OB11MessageJson |
-    OB11MessageDice | OB11MessageRPS | OB11MessageMarkdown | OB11MessageForward | OB11MessageContext | OB11MessagePoke;
+  OB11MessageText |
+  OB11MessageFace | OB11MessageMFace |
+  OB11MessageAt | OB11MessageReply |
+  OB11MessageImage | OB11MessageRecord | OB11MessageFile | OB11MessageVideo |
+  OB11MessageNode | OB11MessageIdMusic | OB11MessageCustomMusic | OB11MessageJson |
+  OB11MessageDice | OB11MessageRPS | OB11MessageMarkdown | OB11MessageForward | OB11MessageContext | OB11MessagePoke;
 
 // 发送消息接口定义
 export interface OB11PostSendMsg {
@@ -270,7 +271,7 @@ export interface OB11PostSendMsg {
   messages?: OB11MessageMixType;
   auto_escape?: boolean | string;
   source?: string;
-  news?: { text: string }[];
+  news?: { text: string; }[];
   summary?: string;
   prompt?: string;
   time?: string;

packages/napcat-shell/base.ts

@@ -29,7 +29,6 @@ import { napCatVersion } from 'napcat-common/src/version';
 import { NodeIO3MiscListener } from 'napcat-core/listeners/NodeIO3MiscListener';
 import { sleep } from 'napcat-common/src/helper';
 import { FFmpegService } from '@/napcat-core/helper/ffmpeg/ffmpeg';
-import { connectToNamedPipe } from './pipe';
 import { NativePacketHandler } from 'napcat-core/packet/handler/client';
 import { logSubscription, LogWrapper } from '@/napcat-core/helper/log';
 import { proxiedListenerOf } from '@/napcat-core/helper/proxy-handler';
@@ -128,10 +127,13 @@ async function handleLogin (
 
   const loginListener = new NodeIKernelLoginListener();
   loginListener.onUserLoggedIn = (userid: string) => {
-    logger.logError(`当前账号(${userid})已登录,无法重复登录`);
+    const tips = `当前账号(${userid})已登录,无法重复登录`;
+    logger.logError(tips);
+    WebUiDataRuntime.setQQLoginError(tips);
   };
   loginListener.onQRCodeLoginSucceed = async (loginResult) => {
     context.isLogined = true;
+    WebUiDataRuntime.setQQLoginStatus(true);
     inner_resolve({
       uid: loginResult.uid,
       uin: loginResult.uin,
@@ -170,13 +172,16 @@ async function handleLogin (
       logger.logError('[Core] [Login] Login Error,ErrType: ', errType, ' ErrCode:', errCode);
       if (errType === 1 && errCode === 3) {
         // 二维码过期刷新
+        WebUiDataRuntime.setQQLoginError('二维码已过期，请刷新');
       }
       loginService.getQRCodePicture();
     }
   };
 
   loginListener.onLoginFailed = (...args) => {
-    logger.logError('[Core] [Login] Login Error , ErrInfo: ', JSON.stringify(args));
+    const errInfo = JSON.stringify(args);
+    logger.logError('[Core] [Login] Login Error , ErrInfo: ', errInfo);
+    WebUiDataRuntime.setQQLoginError(`登录失败: ${errInfo}`);
   };
 
   loginService.addKernelLoginListener(proxiedListenerOf(loginListener, logger));
@@ -184,17 +189,29 @@ async function handleLogin (
   return await selfInfo;
 }
 async function handleLoginInner (context: { isLogined: boolean; }, logger: LogWrapper, loginService: NodeIKernelLoginService, quickLoginUin: string | undefined, historyLoginList: LoginListItem[]) {
+  // 注册刷新二维码回调
+  WebUiDataRuntime.setRefreshQRCodeCallback(async () => {
+    loginService.getQRCodePicture();
+  });
+
   WebUiDataRuntime.setQuickLoginCall(async (uin: string) => {
     return await new Promise((resolve) => {
       if (uin) {
         logger.log('正在快速登录 ', uin);
         loginService.quickLoginWithUin(uin).then(res => {
           if (res.loginErrorInfo.errMsg) {
+            WebUiDataRuntime.setQQLoginError(res.loginErrorInfo.errMsg);
+            loginService.getQRCodePicture();
             resolve({ result: false, message: res.loginErrorInfo.errMsg });
+          } else {
+            WebUiDataRuntime.setQQLoginStatus(true);
+            WebUiDataRuntime.setQQLoginError('');
+            resolve({ result: true, message: '' });
           }
-          resolve({ result: true, message: '' });
         }).catch((e) => {
           logger.logError(e);
+          WebUiDataRuntime.setQQLoginError('快速登录发生错误');
+          loginService.getQRCodePicture();
           resolve({ result: false, message: '快速登录发生错误' });
         });
       } else {
@@ -209,6 +226,7 @@ async function handleLoginInner (context: { isLogined: boolean; }, logger: LogWr
         .then(result => {
           if (result.loginErrorInfo.errMsg) {
             logger.logError('快速登录错误：', result.loginErrorInfo.errMsg);
+            WebUiDataRuntime.setQQLoginError(result.loginErrorInfo.errMsg);
             if (!context.isLogined) loginService.getQRCodePicture();
           }
         })
@@ -324,9 +342,9 @@ export async function NCoreInitShell () {
   // 初始化 FFmpeg 服务
   await FFmpegService.init(pathWrapper.binaryPath, logger);
 
-  if (process.env['NAPCAT_DISABLE_PIPE'] !== '1') {
-    await connectToNamedPipe(logger).catch(e => logger.logError('命名管道连接失败', e));
-  }
+  // if (process.env['NAPCAT_DISABLE_PIPE'] !== '1') {
+  //   await connectToNamedPipe(logger).catch(e => logger.logError('命名管道连接失败', e));
+  // }
   const basicInfoWrapper = new QQBasicInfoWrapper({ logger });
   const wrapper = loadQQWrapper(basicInfoWrapper.getFullQQVersion());
   const nativePacketHandler = new NativePacketHandler({ logger }); // 初始化 NativePacketHandler 用于后续使用
@@ -418,7 +436,6 @@ export async function NCoreInitShell () {
     wrapper,
     session,
     logger,
-    loginService,
     selfInfo,
     basicInfoWrapper,
     pathWrapper,
@@ -434,7 +451,6 @@ export class NapCatShell {
     wrapper: WrapperNodeApi,
     session: NodeIQQNTWrapperSession,
     logger: LogWrapper,
-    loginService: NodeIKernelLoginService,
     selfInfo: SelfInfo,
     basicInfoWrapper: QQBasicInfoWrapper,
     pathWrapper: NapCatPathWrapper,
@@ -446,7 +462,6 @@ export class NapCatShell {
       wrapper,
       session,
       logger,
-      loginService,
       basicInfoWrapper,
       pathWrapper,
     };
@@ -455,6 +470,10 @@ export class NapCatShell {
 
   async InitNapCat () {
     await this.core.initCore();
+    // 监听下线通知并同步到 WebUI
+    this.core.event.on('KickedOffLine', (tips: string) => {
+      WebUiDataRuntime.setQQLoginError(tips);
+    });
     const oneBotAdapter = new NapCatOneBot11Adapter(this.core, this.context, this.context.pathWrapper);
     // 注册到 WebUiDataRuntime，供调试功能使用
     WebUiDataRuntime.setOneBotContext(oneBotAdapter);
@@ -462,4 +481,3 @@ export class NapCatShell {
       .catch(e => this.context.logger.logError('初始化OneBot失败', e));
   }
 }
-

packages/napcat-shell/napcat.ts

@@ -1,2 +1,319 @@
 import { NCoreInitShell } from './base';
-NCoreInitShell();
+import { NapCatPathWrapper } from '@/napcat-common/src/path';
+import { LogWrapper } from '@/napcat-core/helper/log';
+import { connectToNamedPipe } from './pipe';
+import { WebUiDataRuntime } from '@/napcat-webui-backend/src/helper/Data';
+import { createProcessManager, type IProcessManager, type IWorkerProcess } from './process-api';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// ES 模块中获取 __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 环境变量配置
+const ENV = {
+  isWorkerProcess: process.env['NAPCAT_WORKER_PROCESS'] === '1',
+  isMultiProcessDisabled: process.env['NAPCAT_DISABLE_MULTI_PROCESS'] === '1',
+  isPipeDisabled: process.env['NAPCAT_DISABLE_PIPE'] === '1',
+} as const;
+
+// 初始化日志
+const pathWrapper = new NapCatPathWrapper();
+const logger = new LogWrapper(pathWrapper.logsPath);
+
+// 进程管理器和当前 Worker 进程引用
+let processManager: IProcessManager | null = null;
+let currentWorker: IWorkerProcess | null = null;
+let isElectron = false;
+
+/**
+ * 获取进程类型名称（用于日志）
+ */
+function getProcessTypeName (): string {
+  return isElectron ? 'UtilityProcess' : 'Fork';
+}
+
+/**
+ * 获取 Worker 脚本路径
+ */
+function getWorkerScriptPath (): string {
+  return __filename.endsWith('.mjs')
+    ? path.join(__dirname, 'napcat.mjs')
+    : path.join(__dirname, 'napcat.js');
+}
+
+/**
+ * 检查进程是否存在
+ */
+function isProcessAlive (pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 强制终止进程
+ */
+function forceKillProcess (pid: number): void {
+  try {
+    process.kill(pid, 'SIGKILL');
+    logger.log(`[NapCat] [Process] 已强制终止进程 ${pid}`);
+  } catch (error) {
+    logger.logError(`[NapCat] [Process] 强制终止进程失败:`, error);
+  }
+}
+
+/**
+ * 重启 Worker 进程
+ */
+export async function restartWorker (): Promise<void> {
+  logger.log('[NapCat] [Process] 正在重启Worker进程...');
+
+  if (!currentWorker) {
+    logger.logWarn('[NapCat] [Process] 没有运行中的Worker进程');
+    await startWorker();
+    return;
+  }
+
+  const workerPid = currentWorker.pid;
+  logger.log(`[NapCat] [Process] 准备关闭Worker进程，PID: ${workerPid}`);
+
+  // 1. 通知旧进程准备重启（旧进程会自行退出）
+  currentWorker.postMessage({ type: 'restart-prepare' });
+
+  // 2. 等待进程退出（最多 5 秒，给更多时间让进程自行清理）
+  await new Promise<void>((resolve) => {
+    const timeout = setTimeout(() => {
+      logger.logWarn('[NapCat] [Process] Worker进程未在 5 秒内退出，尝试发送强制关闭信号');
+      currentWorker?.postMessage({ type: 'shutdown' });
+
+      // 再等待 2 秒
+      setTimeout(() => {
+        logger.logWarn('[NapCat] [Process] Worker进程仍未退出，尝试 kill');
+        currentWorker?.kill();
+        resolve();
+      }, 2000);
+    }, 5000);
+
+    currentWorker?.once('exit', () => {
+      clearTimeout(timeout);
+      logger.log('[NapCat] [Process] Worker进程已正常退出');
+      resolve();
+    });
+  });
+
+  // 3. 二次确认进程是否真的被终止（兜底检查）
+  if (workerPid) {
+    logger.log(`[NapCat] [Process] 检查进程 ${workerPid} 是否已终止...`);
+
+    if (isProcessAlive(workerPid)) {
+      logger.logWarn(`[NapCat] [Process] 进程 ${workerPid} 仍在运行，尝试强制杀掉（兜底）`);
+      forceKillProcess(workerPid);
+
+      // 等待 1 秒后再次检查
+      await new Promise(resolve => setTimeout(resolve, 1000));
+
+      if (isProcessAlive(workerPid)) {
+        logger.logError(`[NapCat] [Process] 进程 ${workerPid} 无法终止，可能需要手动处理`);
+      } else {
+        logger.log(`[NapCat] [Process] 进程 ${workerPid} 已被强制终止`);
+      }
+    } else {
+      logger.log(`[NapCat] [Process] 进程 ${workerPid} 已确认终止`);
+    }
+  }
+
+  // 4. 等待 3 秒后启动新进程
+  logger.log('[NapCat] [Process] Worker进程已关闭，等待 3 秒后启动新进程...');
+  await new Promise(resolve => setTimeout(resolve, 3000));
+
+  // 5. 启动新进程
+  await startWorker();
+  logger.log('[NapCat] [Process] Worker进程重启完成');
+}
+
+/**
+ * 启动 Worker 进程
+ */
+async function startWorker (): Promise<void> {
+  if (!processManager) {
+    throw new Error('进程管理器未初始化');
+  }
+
+  const workerScript = getWorkerScriptPath();
+  const processType = getProcessTypeName();
+
+  const child = processManager.createWorker(workerScript, [], {
+    env: {
+      ...process.env,
+      NAPCAT_WORKER_PROCESS: '1',
+    },
+    stdio: isElectron ? 'pipe' : ['inherit', 'pipe', 'pipe', 'ipc'],
+  });
+
+  currentWorker = child;
+
+  // 监听标准输出（直接转发）
+  if (child.stdout) {
+    child.stdout.on('data', (data: Buffer) => {
+      process.stdout.write(data);
+    });
+  }
+
+  // 监听标准错误（直接转发）
+  if (child.stderr) {
+    child.stderr.on('data', (data: Buffer) => {
+      process.stderr.write(data);
+    });
+  }
+
+  // 监听子进程消息
+  child.on('message', (msg: unknown) => {
+    logger.log(`[NapCat] [${processType}] 收到Worker消息:`, msg);
+
+    // 处理重启请求
+    if (typeof msg === 'object' && msg !== null && 'type' in msg && msg.type === 'restart') {
+      logger.log(`[NapCat] [${processType}] 收到重启请求，正在重启Worker进程...`);
+      restartWorker().catch(e => {
+        logger.logError(`[NapCat] [${processType}] 重启Worker进程失败:`, e);
+      });
+    }
+  });
+
+  // 监听子进程退出
+  child.on('exit', (code: unknown) => {
+    const exitCode = typeof code === 'number' ? code : 0;
+    if (exitCode !== 0) {
+      logger.logError(`[NapCat] [${processType}] Worker进程退出，退出码: ${exitCode}`);
+    } else {
+      logger.log(`[NapCat] [${processType}] Worker进程正常退出`);
+    }
+  });
+
+  child.on('spawn', () => {
+    logger.log(`[NapCat] [${processType}] Worker进程已生成`);
+  });
+}
+
+/**
+ * 启动 Master 进程
+ */
+async function startMasterProcess (): Promise<void> {
+  const processType = getProcessTypeName();
+  logger.log(`[NapCat] [${processType}] Master进程启动，PID: ${process.pid}`);
+
+  // 连接命名管道（可通过环境变量禁用）
+  if (!ENV.isPipeDisabled) {
+    await connectToNamedPipe(logger).catch(e =>
+      logger.logError('命名管道连接失败', e)
+    );
+  } else {
+    logger.log(`[NapCat] [${processType}] 命名管道已禁用 (NAPCAT_DISABLE_PIPE=1)`);
+  }
+
+  // 启动 Worker 进程
+  await startWorker();
+
+  // 优雅关闭处理
+  const shutdown = (signal: string) => {
+    logger.log(`[NapCat] [Process] 收到${signal}信号，正在关闭...`);
+
+    if (currentWorker) {
+      currentWorker.postMessage({ type: 'shutdown' });
+      setTimeout(() => {
+        currentWorker?.kill();
+        process.exit(0);
+      }, 1000);
+    } else {
+      process.exit(0);
+    }
+  };
+
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+
+/**
+ * 启动 Worker 进程（子进程入口）
+ */
+async function startWorkerProcess (): Promise<void> {
+  if (!processManager) {
+    throw new Error('进程管理器未初始化');
+  }
+
+  const processType = getProcessTypeName();
+  logger.log(`[NapCat] [${processType}] Worker进程启动，PID: ${process.pid}`);
+
+  // 监听来自父进程的消息
+  processManager.onParentMessage((msg: unknown) => {
+    if (typeof msg === 'object' && msg !== null && 'type' in msg) {
+      if (msg.type === 'restart-prepare') {
+        logger.log(`[NapCat] [${processType}] 收到重启准备信号，正在主动退出...`);
+        setTimeout(() => {
+          process.exit(0);
+        }, 100);
+      } else if (msg.type === 'shutdown') {
+        logger.log(`[NapCat] [${processType}] 收到关闭信号，正在退出...`);
+        process.exit(0);
+      }
+    }
+  });
+
+  // 注册重启进程函数到 WebUI
+  WebUiDataRuntime.setRestartProcessCall(async () => {
+    try {
+      const success = processManager!.sendToParent({ type: 'restart' });
+
+      if (success) {
+        return { result: true, message: '进程重启请求已发送' };
+      } else {
+        return { result: false, message: '无法与主进程通信' };
+      }
+    } catch (e) {
+      logger.logError('[NapCat] [Process] 发送重启请求失败:', e);
+      return {
+        result: false,
+        message: '发送重启请求失败: ' + (e as Error).message
+      };
+    }
+  });
+
+  // 启动 NapCat 核心
+  await NCoreInitShell();
+}
+
+/**
+ * 主入口
+ */
+async function main (): Promise<void> {
+  // 单进程模式：直接启动核心
+  if (ENV.isMultiProcessDisabled) {
+    logger.log('[NapCat] [SingleProcess] 多进程模式已禁用，直接启动核心');
+    await NCoreInitShell();
+    return;
+  }
+
+  // 多进程模式：初始化进程管理器
+  const result = await createProcessManager();
+  processManager = result.manager;
+  isElectron = result.isElectron;
+
+  logger.log(`[NapCat] [Process] 检测到 ${isElectron ? 'Electron' : 'Node.js'} 环境`);
+
+  // 根据进程类型启动
+  if (ENV.isWorkerProcess) {
+    await startWorkerProcess();
+  } else {
+    await startMasterProcess();
+  }
+}
+
+// 启动应用
+main().catch((e: Error) => {
+  logger.logError('[NapCat] [Process] 启动失败:', e);
+  process.exit(1);
+});

packages/napcat-shell/process-api.ts

@@ -0,0 +1,178 @@
+import type { Readable } from 'stream';
+import type { fork as forkType } from 'child_process';
+
+// 扩展 Process 类型以支持 parentPort
+declare global {
+  namespace NodeJS {
+    interface Process {
+      parentPort?: {
+        on (event: 'message', listener: (e: { data: unknown; }) => void): void;
+        postMessage (message: unknown): void;
+      };
+    }
+  }
+}
+
+/**
+ * 统一的进程接口
+ */
+export interface IWorkerProcess {
+  readonly pid: number | undefined;
+  readonly stdout: Readable | null;
+  readonly stderr: Readable | null;
+
+  postMessage (message: unknown): void;
+  kill (): boolean;
+  on (event: string, listener: (...args: unknown[]) => void): void;
+  once (event: string, listener: (...args: unknown[]) => void): void;
+}
+
+/**
+ * 进程创建选项
+ */
+export interface ProcessOptions {
+  env: NodeJS.ProcessEnv;
+  stdio: 'pipe' | 'ignore' | 'inherit' | Array<'pipe' | 'ignore' | 'inherit' | 'ipc'>;
+}
+
+/**
+ * 进程管理器接口
+ */
+export interface IProcessManager {
+  createWorker (modulePath: string, args: string[], options: ProcessOptions): IWorkerProcess;
+  onParentMessage (handler: (message: unknown) => void): void;
+  sendToParent (message: unknown): boolean;
+}
+
+/**
+ * Electron utilityProcess 包装器
+ */
+class ElectronProcessManager implements IProcessManager {
+  private utilityProcess: {
+    fork (modulePath: string, args: string[], options: unknown): unknown;
+  };
+
+  constructor (utilityProcess: { fork (modulePath: string, args: string[], options: unknown): unknown; }) {
+    this.utilityProcess = utilityProcess;
+  }
+
+  createWorker (modulePath: string, args: string[], options: ProcessOptions): IWorkerProcess {
+    const child: any = this.utilityProcess.fork(modulePath, args, options);
+
+    return {
+      pid: child.pid as number | undefined,
+      stdout: child.stdout as Readable | null,
+      stderr: child.stderr as Readable | null,
+
+      postMessage (message: unknown): void {
+        child.postMessage(message);
+      },
+
+      kill (): boolean {
+        return child.kill() as boolean;
+      },
+
+      on (event: string, listener: (...args: unknown[]) => void): void {
+        child.on(event, listener);
+      },
+
+      once (event: string, listener: (...args: unknown[]) => void): void {
+        child.once(event, listener);
+      },
+    };
+  }
+
+  onParentMessage (handler: (message: unknown) => void): void {
+    if (process.parentPort) {
+      process.parentPort.on('message', (e: { data: unknown; }) => {
+        handler(e.data);
+      });
+    }
+  }
+
+  sendToParent (message: unknown): boolean {
+    if (process.parentPort) {
+      process.parentPort.postMessage(message);
+      return true;
+    }
+    return false;
+  }
+}
+
+/**
+ * Node.js child_process 包装器
+ */
+class NodeProcessManager implements IProcessManager {
+  private forkFn: typeof forkType;
+
+  constructor (forkFn: typeof forkType) {
+    this.forkFn = forkFn;
+  }
+
+  createWorker (modulePath: string, args: string[], options: ProcessOptions): IWorkerProcess {
+    const child = this.forkFn(modulePath, args, options as any);
+
+    return {
+      pid: child.pid,
+      stdout: child.stdout,
+      stderr: child.stderr,
+
+      postMessage (message: unknown): void {
+        if (child.send) {
+          child.send(message as any);
+        }
+      },
+
+      kill (): boolean {
+        return child.kill();
+      },
+
+      on (event: string, listener: (...args: unknown[]) => void): void {
+        child.on(event, listener);
+      },
+
+      once (event: string, listener: (...args: unknown[]) => void): void {
+        child.once(event, listener);
+      },
+    };
+  }
+
+  onParentMessage (handler: (message: unknown) => void): void {
+    process.on('message', (message: unknown) => {
+      handler(message);
+    });
+  }
+
+  sendToParent (message: unknown): boolean {
+    if (process.send) {
+      process.send(message as any);
+      return true;
+    }
+    return false;
+  }
+}
+
+/**
+ * 检测运行环境并创建对应的进程管理器
+ */
+export async function createProcessManager (): Promise<{
+  manager: IProcessManager;
+  isElectron: boolean;
+}> {
+  const isElectron = typeof process.versions['electron'] !== 'undefined';
+
+  if (isElectron) {
+    // @ts-ignore - electron 运行时存在但类型声明可能缺失
+    const electron = await import('electron');
+    return {
+      manager: new ElectronProcessManager(electron.utilityProcess),
+      isElectron: true,
+    };
+  } else {
+    const { fork } = await import('child_process');
+    return {
+      manager: new NodeProcessManager(fork),
+      isElectron: false,
+    };
+  }
+}

packages/napcat-shell/vite.config.ts

@@ -9,9 +9,9 @@ import react from '@vitejs/plugin-react-swc';
 
 // 依赖排除
 const external = [
-  'silk-wasm',
   'ws',
   'express',
+  'electron'
 ];
 
 const nodeModules = [...builtinModules, builtinModules.map((m) => `node:${m}`)].flat();
@@ -56,7 +56,6 @@ const ShellBaseConfig = (source_map: boolean = false) =>
       lib: {
         entry: {
           napcat: path.resolve(__dirname, 'napcat.ts'),
-          'audio-worker': path.resolve(__dirname, '../napcat-common/src/audio-worker.ts'),
           'worker/conoutSocketWorker': path.resolve(__dirname, '../napcat-pty/worker/conoutSocketWorker.ts'),
         },
         formats: ['es'],

packages/napcat-vite/package.json

@@ -1,24 +1,24 @@
 {
-    "name": "napcat-vite",
-    "version": "0.0.1",
-    "private": true,
-    "type": "module",
-    "main": "index.ts",
-    "scripts": {
-        "build": "vite build"
+  "name": "napcat-vite",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "index.ts",
+  "scripts": {
+    "_build": "vite build"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.ts"
     },
-    "exports": {
-        ".": {
-            "import": "./index.ts"
-        },
-        "./*": {
-            "import": "./*"
-        }
-    },
-    "devDependencies": {
-        "@types/node": "^22.0.1"
-    },
-    "engines": {
-        "node": ">=18.0.0"
+    "./*": {
+      "import": "./*"
     }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
 }

packages/napcat-webui-backend/index.ts

@@ -182,16 +182,56 @@ export async function InitWebUi (logger: ILogWrapper, pathWrapper: NapCatPathWra
 
   // 如果是自定义色彩，构建一个css文件
   app.use('/files/theme.css', async (_req, res) => {
-    const colors = await WebUiConfig.GetTheme();
+    const theme = await WebUiConfig.GetTheme();
+    const fontMode = theme.fontMode || 'system';
 
-    let css = ':root, .light, [data-theme="light"] {';
-    for (const key in colors.light) {
-      css += `${key}: ${colors.light[key]};`;
+    let css = '';
+
+    // 生成字体 @font-face
+    if (fontMode === 'aacute') {
+      css += `
+@font-face {
+  font-family: 'Aa偷吃可爱长大的';
+  src: url('/webui/fonts/AaCute.woff') format('woff');
+  font-display: swap;
+}
+`;
+    } else if (fontMode === 'custom') {
+      css += `
+@font-face {
+  font-family: 'CustomFont';
+  src: url('/webui/fonts/CustomFont.woff') format('woff');
+  font-display: swap;
+}
+`;
+    }
+
+    // 生成颜色主题和字体变量
+    css += ':root, .light, [data-theme="light"] {';
+    for (const key in theme.light) {
+      css += `${key}: ${theme.light[key]};`;
+    }
+    // 添加字体变量
+    if (fontMode === 'aacute') {
+      css += "--font-family-base: 'Aa偷吃可爱长大的', var(--font-family-fallbacks) !important;";
+    } else if (fontMode === 'custom') {
+      css += "--font-family-base: 'CustomFont', var(--font-family-fallbacks) !important;";
+    } else {
+      css += '--font-family-base: var(--font-family-fallbacks) !important;';
     }
     css += '}';
+
     css += '.dark, [data-theme="dark"] {';
-    for (const key in colors.dark) {
-      css += `${key}: ${colors.dark[key]};`;
+    for (const key in theme.dark) {
+      css += `${key}: ${theme.dark[key]};`;
+    }
+    // 添加字体变量
+    if (fontMode === 'aacute') {
+      css += "--font-family-base: 'Aa偷吃可爱长大的', var(--font-family-fallbacks) !important;";
+    } else if (fontMode === 'custom') {
+      css += "--font-family-base: 'CustomFont', var(--font-family-fallbacks) !important;";
+    } else {
+      css += '--font-family-base: var(--font-family-fallbacks) !important;';
     }
     css += '}';
 

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

@@ -5,6 +5,7 @@ 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 { NapCatCoreWorkingEnv } from '@/napcat-webui-backend/src/types';
 
 export const GetNapCatVersion: RequestHandler = (_, res) => {
   const data = WebUiDataRuntime.GetNapCatVersion();
@@ -32,51 +33,62 @@ export interface VersionInfo {
   createdAt?: string;
   expiresAt?: string;
   size?: number;
+  workflowRunId?: number;
+  headSha?: string;
 }
 
 /**
  * 获取所有可用的版本（release + action artifacts）
- * 支持分页
+ * 支持分页，懒加载：根据 type 参数只获取需要的版本类型
  */
 export const getAllReleasesHandler: RequestHandler = async (req, res) => {
   try {
     const page = parseInt(req.query['page'] as string) || 1;
     const pageSize = parseInt(req.query['pageSize'] as string) || 20;
-    const includeActions = req.query['includeActions'] !== 'false';
     const typeFilter = req.query['type'] as string | undefined; // 'release' | 'action' | 'all'
     const searchQuery = (req.query['search'] as string || '').toLowerCase().trim();
 
-    let tags: string[] = [];
+    let versions: VersionInfo[] = [];
+    let actionVersions: VersionInfo[] = [];
     let usedMirror = '';
-    try {
-      const result = await getAllTags();
-      tags = result.tags;
-      usedMirror = result.mirror;
-    } catch {
-      // 如果获取 tags 失败，返回空列表而不是抛出错误
-      tags = [];
+
+    // 懒加载：只获取需要的版本类型
+    const needReleases = !typeFilter || typeFilter === 'all' || typeFilter === 'release';
+    const needActions = typeFilter === 'action' || typeFilter === 'all';
+
+    // 获取正式版本（仅当需要时）
+    if (needReleases) {
+      try {
+        const result = await getAllTags();
+        usedMirror = result.mirror;
+        
+        versions = result.tags.map(tag => {
+          const isPrerelease = /-(alpha|beta|rc|dev|pre|snapshot)/i.test(tag);
+          return {
+            tag,
+            type: isPrerelease ? 'prerelease' : 'release',
+          } as VersionInfo;
+        });
+
+        // 使用语义化版本排序（最新的在前）
+        versions.sort((a, b) => -compareSemVer(a.tag, b.tag));
+      } catch {
+        // 如果获取 tags 失败，返回空列表而不是抛出错误
+        versions = [];
+      }
     }
 
-    // 解析版本信息
-    const versions: VersionInfo[] = tags.map(tag => {
-      // 检查是否是预发布版本
-      const isPrerelease = /-(alpha|beta|rc|dev|pre|snapshot)/i.test(tag);
-      return {
-        tag,
-        type: isPrerelease ? 'prerelease' : 'release',
-      };
-    });
-
-    // 使用语义化版本排序（最新的在前）
-    versions.sort((a, b) => -compareSemVer(a.tag, b.tag));
-
-    // 获取 Action Artifacts（如果请求）
-    let actionVersions: VersionInfo[] = [];
-    if (includeActions) {
+    // 获取 Action Artifacts（仅当需要时）
+    if (needActions) {
       try {
         const artifacts = await getLatestActionArtifacts('NapNeko', 'NapCatQQ', 'build.yml', 'main');
+
+        // 根据当前工作环境自动过滤对应的 artifact 类型
+        const isFramework = WebUiDataRuntime.getWorkingEnv() === NapCatCoreWorkingEnv.Framework;
+        const targetArtifactName = isFramework ? 'NapCat.Framework' : 'NapCat.Shell';
+
         actionVersions = artifacts
-          .filter(a => a.name.includes('NapCat'))
+          .filter(a => a.name === targetArtifactName)
           .map(a => ({
             tag: `action-${a.id}`,
             type: 'action' as const,
@@ -85,24 +97,18 @@ export const getAllReleasesHandler: RequestHandler = async (req, res) => {
             createdAt: a.created_at,
             expiresAt: a.expires_at,
             size: a.size_in_bytes,
+            workflowRunId: a.workflow_run_id,
+            headSha: a.head_sha,
           }));
       } catch {
-        // 忽略 action artifacts 获取失败
+        // 获取失败时返回空列表
+        actionVersions = [];
       }
     }
 
     // 合并版本列表（action 在最前面）
     let allVersions = [...actionVersions, ...versions];
 
-    // 按类型过滤
-    if (typeFilter && typeFilter !== 'all') {
-      if (typeFilter === 'release') {
-        allVersions = allVersions.filter(v => v.type === 'release' || v.type === 'prerelease');
-      } else if (typeFilter === 'action') {
-        allVersions = allVersions.filter(v => v.type === 'action');
-      }
-    }
-
     // 搜索过滤
     if (searchQuery) {
       allVersions = allVersions.filter(v => {

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

@@ -0,0 +1,21 @@
+import type { Request, Response } from 'express';
+import { WebUiDataRuntime } from '../helper/Data';
+import { sendError, sendSuccess } from '../utils/response';
+
+/**
+ * 重启进程处理器
+ * POST /api/Process/Restart
+ */
+export async function RestartProcessHandler (_req: Request, res: Response) {
+  try {
+    const result = await WebUiDataRuntime.requestRestartProcess();
+
+    if (result.result) {
+      return sendSuccess(res, { message: result.message || '进程重启请求已发送' });
+    } else {
+      return sendError(res, result.message || '进程重启失败');
+    }
+  } catch (e) {
+    return sendError(res, '重启进程时发生错误: ' + (e as Error).message);
+  }
+}

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

@@ -1,9 +1,9 @@
 import { RequestHandler } from 'express';
 
 import { WebUiDataRuntime } from '@/napcat-webui-backend/src/helper/Data';
+import { WebUiConfig } from '@/napcat-webui-backend/index';
 import { isEmpty } from '@/napcat-webui-backend/src/utils/check';
 import { sendError, sendSuccess } from '@/napcat-webui-backend/src/utils/response';
-import { WebUiConfig } from '@/napcat-webui-backend/index';
 
 // 获取QQ登录二维码
 export const QQGetQRcodeHandler: RequestHandler = async (_, res) => {
@@ -27,9 +27,17 @@ export const QQGetQRcodeHandler: RequestHandler = async (_, res) => {
 
 // 获取QQ登录状态
 export const QQCheckLoginStatusHandler: RequestHandler = async (_, res) => {
+  // 从 OneBot 上下文获取实时的 selfInfo.online 状态
+  const oneBotContext = WebUiDataRuntime.getOneBotContext();
+  const selfInfo = oneBotContext?.core?.selfInfo;
+  const isOnline = selfInfo?.online;
+  const qqLoginStatus = WebUiDataRuntime.getQQLoginStatus();
+  // 必须同时满足：已登录且在线（online 必须明确为 true）
+  const isLogin = qqLoginStatus && isOnline === true;
   const data = {
-    isLogin: WebUiDataRuntime.getQQLoginStatus(),
+    isLogin,
     qrcodeurl: WebUiDataRuntime.getQQLoginQrcodeURL(),
+    loginError: WebUiDataRuntime.getQQLoginError(),
   };
   return sendSuccess(res, data);
 };
@@ -88,3 +96,15 @@ export const setAutoLoginAccountHandler: RequestHandler = async (req, res) => {
   await WebUiConfig.UpdateAutoLoginAccount(uin);
   return sendSuccess(res, null);
 };
+
+// 刷新QQ登录二维码
+export const QQRefreshQRcodeHandler: RequestHandler = async (_, res) => {
+  // 判断是否已经登录
+  if (WebUiDataRuntime.getQQLoginStatus()) {
+    // 已经登录
+    return sendError(res, 'QQ Is Logined');
+  }
+  // 刷新二维码
+  await WebUiDataRuntime.refreshQRCode();
+  return sendSuccess(res, null);
+};

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

@@ -134,23 +134,73 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
     const targetTag = targetVersion || 'latest';
     webUiLogger?.log(`[NapCat Update] Target version: ${targetTag}`);
 
-    // 使用 mirror 模块获取 release 信息（不依赖 API）
-    // 通过 assetNames 参数直接构建下载 URL，避免调用 GitHub API
-    const release = await getGitHubRelease('NapNeko', 'NapCatQQ', targetTag, {
-      assetNames: [ReleaseName, 'NapCat.Framework.zip', 'NapCat.Shell.zip'],
-      fetchChangelog: false, // 不需要 changelog，避免 API 调用
-    });
+    // 检查是否是 action 临时版本
+    const isActionVersion = targetTag.startsWith('action-');
+    let downloadUrl: string;
+    let actualVersion: string;
 
-    const shellZipAsset = release.assets.find(asset => asset.name === ReleaseName);
-    if (!shellZipAsset) {
-      throw new Error(`未找到${ReleaseName}文件`);
+    if (isActionVersion) {
+      // 处理 action 临时版本
+      const runId = parseInt(targetTag.replace('action-', ''));
+      if (isNaN(runId)) {
+        throw new Error(`Invalid action version format: ${targetTag}`);
+      }
+
+      webUiLogger?.log(`[NapCat Update] Downloading action artifact from run: ${runId}`);
+
+      // 根据当前工作环境确定 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,
+        });
+        webUiLogger?.log(`[NapCat Update] Using download URL: ${downloadUrl}`);
+      } catch (error) {
+        // 如果镜像都不可用，直接使用原始 URL
+        webUiLogger?.logWarn(`[NapCat Update] All nightly.link mirrors failed, using original URL`);
+        downloadUrl = baseUrl;
+      }
+    } else {
+      // 处理标准 release 版本
+      // 使用 mirror 模块获取 release 信息（不依赖 API）
+      // 通过 assetNames 参数直接构建下载 URL，避免调用 GitHub API
+      const release = await getGitHubRelease('NapNeko', 'NapCatQQ', targetTag, {
+        assetNames: [ReleaseName, 'NapCat.Framework.zip', 'NapCat.Shell.zip'],
+        fetchChangelog: false, // 不需要 changelog，避免 API 调用
+      });
+
+      const shellZipAsset = release.assets.find(asset => asset.name === ReleaseName);
+      if (!shellZipAsset) {
+        throw new Error(`未找到${ReleaseName}文件`);
+      }
+
+      actualVersion = release.tag_name;
+
+      // 使用 mirror 模块查找可用的下载 URL
+      // 启用内容验证，确保返回的是有效文件而非错误页面
+      downloadUrl = await findAvailableDownloadUrl(shellZipAsset.browser_download_url, {
+        validateContent: true,           // 验证 Content-Type 和状态码
+        minFileSize: 1024 * 1024,        // 最小 1MB，确保不是错误页面
+        timeout: 10000,                  // 10秒超时
+      });
     }
 
     // 检查是否需要强制更新（降级警告）
     const currentVersion = WebUiDataRuntime.GetNapCatVersion();
-    webUiLogger?.log(`[NapCat Update] Current version: ${currentVersion}, Target version: ${release.tag_name}`);
+    webUiLogger?.log(`[NapCat Update] Current version: ${currentVersion}, Target version: ${actualVersion}`);
 
-    if (!force && currentVersion) {
+    if (!force && currentVersion && !isActionVersion) {
       // 简单的版本比较（可选的降级保护）
       const parseVersion = (v: string): [number, number, number] => {
         const match = v.match(/^v?(\d+)\.(\d+)\.(\d+)/);
@@ -158,7 +208,7 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
         return [parseInt(match[1] || '0'), parseInt(match[2] || '0'), parseInt(match[3] || '0')];
       };
       const [currMajor, currMinor, currPatch] = parseVersion(currentVersion);
-      const [targetMajor, targetMinor, targetPatch] = parseVersion(release.tag_name);
+      const [targetMajor, targetMinor, targetPatch] = parseVersion(actualVersion);
 
       const isDowngrade =
         targetMajor < currMajor ||
@@ -166,12 +216,12 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
         (targetMajor === currMajor && targetMinor === currMinor && targetPatch < currPatch);
 
       if (isDowngrade) {
-        webUiLogger?.log(`[NapCat Update] Downgrade from ${currentVersion} to ${release.tag_name}, force=${force}`);
+        webUiLogger?.log(`[NapCat Update] Downgrade from ${currentVersion} to ${actualVersion}, force=${force}`);
         // 不阻止降级，只是记录日志
       }
     }
 
-    webUiLogger?.log(`[NapCat Update] Updating to version: ${release.tag_name}`);
+    webUiLogger?.log(`[NapCat Update] Updating to version: ${actualVersion}`);
 
     // 创建临时目录
     const tempDir = path.join(webUiPathWrapper.binaryPath, './temp');
@@ -179,14 +229,6 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
       fs.mkdirSync(tempDir, { recursive: true });
     }
 
-    // 使用 mirror 模块查找可用的下载 URL
-    // 启用内容验证，确保返回的是有效文件而非错误页面
-    const downloadUrl = await findAvailableDownloadUrl(shellZipAsset.browser_download_url, {
-      validateContent: true,           // 验证 Content-Type 和状态码
-      minFileSize: 1024 * 1024,        // 最小 1MB，确保不是错误页面
-      timeout: 10000,                  // 10秒超时
-    });
-
     webUiLogger?.log(`[NapCat Update] Using download URL: ${downloadUrl}`);
 
     // 下载zip
@@ -250,10 +292,10 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
       // 如果有替换失败的文件，创建更新配置文件
       if (failedFiles.length > 0) {
         const updateConfig: UpdateConfig = {
-          version: release.tag_name,
+          version: actualVersion,
           updateTime: new Date().toISOString(),
           files: failedFiles,
-          changelog: release.body || ''
+          changelog: ''
         };
 
         // 保存更新配置文件
@@ -269,7 +311,7 @@ export const UpdateNapCatHandler: RequestHandler = async (req, res) => {
       sendSuccess(res, {
         status: 'completed',
         message,
-        newVersion: release.tag_name,
+        newVersion: actualVersion,
         failedFilesCount: failedFiles.length
       });
 

packages/napcat-webui-backend/src/helper/Data.ts

@@ -14,6 +14,7 @@ const LoginRuntime: LoginRuntimeType = {
     uin: '',
     nick: '',
   },
+  QQLoginError: '',
   QQVersion: 'unknown',
   OneBotContext: null,
   onQQLoginStatusChange: async (status: boolean) => {
@@ -21,6 +22,9 @@ const LoginRuntime: LoginRuntimeType = {
   },
   onWebUiTokenChange: async (_token: string) => {
 
+  },
+  onRefreshQRCode: async () => {
+    // 默认空实现，由 shell 注册真实回调
   },
   NapCatHelper: {
     onOB11ConfigChanged: async () => {
@@ -29,6 +33,9 @@ const LoginRuntime: LoginRuntimeType = {
     onQuickLoginRequested: async () => {
       return { result: false, message: '' };
     },
+    onRestartProcessRequested: async () => {
+      return { result: false, message: '重启功能未初始化' };
+    },
     QQLoginList: [],
     NewQQLoginList: [],
   },
@@ -163,4 +170,33 @@ export const WebUiDataRuntime = {
   getOneBotContext (): any | null {
     return LoginRuntime.OneBotContext;
   },
+
+  setRestartProcessCall (func: () => Promise<{ result: boolean; message: string; }>): void {
+    LoginRuntime.NapCatHelper.onRestartProcessRequested = func;
+  },
+
+  requestRestartProcess: async function () {
+    return await LoginRuntime.NapCatHelper.onRestartProcessRequested();
+  },
+
+  setQQLoginError (error: string): void {
+    LoginRuntime.QQLoginError = error;
+  },
+
+  getQQLoginError (): string {
+    return LoginRuntime.QQLoginError;
+  },
+
+  setRefreshQRCodeCallback (func: () => Promise<void>): void {
+    LoginRuntime.onRefreshQRCode = func;
+  },
+
+  getRefreshQRCodeCallback (): () => Promise<void> {
+    return LoginRuntime.onRefreshQRCode;
+  },
+
+  refreshQRCode: async function () {
+    LoginRuntime.QQLoginError = '';
+    await LoginRuntime.onRefreshQRCode();
+  },
 };

packages/napcat-webui-backend/src/router/Process.ts

@@ -0,0 +1,9 @@
+import { Router } from 'express';
+import { RestartProcessHandler } from '../api/Process';
+
+const router = Router();
+
+// POST /api/Process/Restart - 重启进程
+router.post('/Restart', RestartProcessHandler);
+
+export { router as ProcessRouter };

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

@@ -9,6 +9,7 @@ import {
   getQQLoginInfoHandler,
   getAutoLoginAccountHandler,
   setAutoLoginAccountHandler,
+  QQRefreshQRcodeHandler,
 } from '@/napcat-webui-backend/src/api/QQLogin';
 
 const router = Router();
@@ -28,5 +29,7 @@ router.post('/GetQQLoginInfo', getQQLoginInfoHandler);
 router.post('/GetQuickLoginQQ', getAutoLoginAccountHandler);
 // router:设置自动登录QQ账号
 router.post('/SetQuickLoginQQ', setAutoLoginAccountHandler);
+// router:刷新QQ登录二维码
+router.post('/RefreshQRcode', QQRefreshQRcodeHandler);
 
 export { router as QQLoginRouter };

packages/napcat-webui-backend/src/router/index.ts

@@ -16,6 +16,7 @@ import { FileRouter } from './File';
 import { WebUIConfigRouter } from './WebUIConfig';
 import { UpdateNapCatRouter } from './UpdateNapCat';
 import DebugRouter from '@/napcat-webui-backend/src/api/Debug';
+import { ProcessRouter } from './Process';
 
 const router = Router();
 
@@ -44,5 +45,7 @@ router.use('/WebUIConfig', WebUIConfigRouter);
 router.use('/UpdateNapCat', UpdateNapCatRouter);
 // router:调试相关路由
 router.use('/Debug', DebugRouter);
+// router:进程管理相关路由
+router.use('/Process', ProcessRouter);
 
 export { router as ALLRouter };

packages/napcat-webui-backend/src/types/index.ts

@@ -43,14 +43,17 @@ export interface LoginRuntimeType {
   QQQRCodeURL: string;
   QQLoginUin: string;
   QQLoginInfo: SelfInfo;
+  QQLoginError: string;
   QQVersion: string;
   onQQLoginStatusChange: (status: boolean) => Promise<void>;
   onWebUiTokenChange: (token: string) => Promise<void>;
+  onRefreshQRCode: () => Promise<void>;
   WebUiConfigQuickFunction: () => Promise<void>;
   OneBotContext: any | null; // OneBot 上下文，用于调试功能
   NapCatHelper: {
     onQuickLoginRequested: (uin: string) => Promise<{ result: boolean; message: string; }>;
     onOB11ConfigChanged: (ob11: OneBotConfig) => Promise<void>;
+    onRestartProcessRequested: () => Promise<{ result: boolean; message: string; }>;
     QQLoginList: string[];
     NewQQLoginList: LoginListItem[];
   };

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

@@ -30,6 +30,7 @@ export interface CodeEditorRef {
 
 const CodeEditor = React.forwardRef<CodeEditorRef, CodeEditorProps>((props, ref) => {
   const { isDark } = useTheme();
+  const chromeless = !!props.options?.chromeless;
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const [val, setVal] = useState(props.value || props.defaultValue || '');
   const internalRef = React.useRef<ReactCodeMirrorRef>(null);
@@ -51,36 +52,66 @@ const CodeEditor = React.forwardRef<CodeEditorRef, CodeEditorProps>((props, ref)
     "&": {
       fontSize: "14px",
       height: "100% !important",
+      backgroundColor: 'transparent !important',
+    },
+    "&.cm-editor": {
+      backgroundColor: 'transparent !important',
     },
     ".cm-scroller": {
-      fontFamily: "'JetBrains Mono', 'Fira Code', Consolas, monospace",
+      fontFamily: "var(--font-family-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace)",
       lineHeight: "1.6",
       overflow: "auto !important",
       height: "100% !important",
+      backgroundColor: 'transparent !important',
     },
     ".cm-gutters": {
-      backgroundColor: "transparent",
+      backgroundColor: "transparent !important",
       borderRight: "none",
-      color: isDark ? "#ffffff50" : "#00000040",
+      color: isDark
+        ? 'hsl(var(--heroui-foreground-500) / 0.75)'
+        : 'hsl(var(--heroui-foreground-500) / 0.65)',
     },
     ".cm-gutterElement": {
       paddingLeft: "12px",
       paddingRight: "12px",
     },
     ".cm-activeLineGutter": {
-      backgroundColor: "transparent",
-      color: isDark ? "#fff" : "#000",
+      backgroundColor: 'transparent !important',
+      color: isDark
+        ? 'hsl(var(--heroui-foreground) / 0.9) !important'
+        : 'hsl(var(--heroui-foreground) / 0.8) !important',
     },
     ".cm-content": {
-      caretColor: isDark ? "#fff" : "#000",
+      color: 'hsl(var(--heroui-foreground) / 0.9)',
+      caretColor: 'hsl(var(--heroui-foreground) / 0.9)',
       paddingTop: "12px",
       paddingBottom: "12px",
+      backgroundColor: 'transparent !important',
     },
     ".cm-activeLine": {
-      backgroundColor: isDark ? "#ffffff10" : "#00000008",
+      backgroundColor: isDark
+        ? 'hsl(var(--heroui-foreground) / 0.08)'
+        : 'hsl(var(--heroui-foreground) / 0.06)',
     },
     ".cm-selectionMatch": {
-      backgroundColor: isDark ? "#ffffff20" : "#00000010",
+      backgroundColor: isDark
+        ? 'hsl(var(--heroui-foreground) / 0.16)'
+        : 'hsl(var(--heroui-foreground) / 0.12)',
+    },
+    // Syntax highlighting overrides for better readability
+    ".ͼo": {
+      // JSON property names - use a softer primary color
+      color: isDark
+        ? 'hsl(var(--heroui-primary) / 0.85)'
+        : 'hsl(var(--heroui-primary) / 0.75)',
+    },
+    ".ͼd": {
+      // Strings - softer green
+      color: isDark ? '#98c379cc' : '#50a14fcc',
+    },
+    ".ͼc": {
+      // Numbers - softer orange
+      color: isDark ? '#d19a66cc' : '#c18401cc',
     },
   });
 
@@ -95,17 +126,20 @@ const CodeEditor = React.forwardRef<CodeEditorRef, CodeEditorProps>((props, ref)
     <div
       style={{ fontSize: props.options?.fontSize || 14, height: props.height || '100%', display: 'flex', flexDirection: 'column' }}
       className={clsx(
-        'rounded-xl border overflow-hidden transition-colors',
-        isDark
-          ? 'border-white/10 bg-[#282c34]'
-          : 'border-default-200 bg-white'
+        chromeless
+          ? 'overflow-hidden transition-colors bg-transparent'
+          : 'rounded-xl border overflow-hidden transition-colors backdrop-blur-sm',
+        !chromeless && (isDark
+          ? 'border-white/10 bg-white/5 text-default-100'
+          : 'border-white/40 dark:border-white/10 bg-white/60 dark:bg-black/20 text-default-700')
       )}
     >
       <CodeMirror
         ref={internalRef}
         value={props.value ?? props.defaultValue}
         height="100%"
-        className="h-full w-full"
+        className="h-full w-full [&_.cm-editor]:!bg-transparent [&_.cm-scroller]:!bg-transparent"
+        style={{ backgroundColor: 'transparent' }}
         theme={isDark ? oneDark : 'light'}
         extensions={extensions}
         onChange={(value) => {

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

@@ -0,0 +1,228 @@
+import { Button } from '@heroui/button';
+import { Input } from '@heroui/input';
+import {
+  Modal,
+  ModalBody,
+  ModalContent,
+  ModalFooter,
+  ModalHeader,
+} from '@heroui/modal';
+import clsx from 'clsx';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { TbCornerDownLeft, TbSearch } from 'react-icons/tb';
+
+export type CommandPaletteCommand = {
+  id: string;
+  title: string;
+  subtitle?: string;
+  group?: string;
+};
+
+export type CommandPaletteExecuteMode = 'open' | 'send';
+
+export interface CommandPaletteProps {
+  isOpen: boolean;
+  onOpenChange: (open: boolean) => void;
+  commands: CommandPaletteCommand[];
+  onExecute: (commandId: string, mode: CommandPaletteExecuteMode) => void;
+}
+
+const isMobileByViewport = () => {
+  try {
+    return window.innerWidth < 768;
+  } catch {
+    return false;
+  }
+};
+
+export default function CommandPalette (props: CommandPaletteProps) {
+  const { isOpen, onOpenChange, commands, onExecute } = props;
+  const inputRef = useRef<HTMLInputElement | null>(null);
+
+  const [query, setQuery] = useState('');
+  const [activeIndex, setActiveIndex] = useState(0);
+  const [mobile, setMobile] = useState(false);
+
+  useEffect(() => {
+    const update = () => setMobile(isMobileByViewport());
+    update();
+    window.addEventListener('resize', update);
+    return () => window.removeEventListener('resize', update);
+  }, []);
+
+  useEffect(() => {
+    if (!isOpen) return;
+    setQuery('');
+    setActiveIndex(0);
+    // 等 Modal 动画挂载后再 focus
+    const t = window.setTimeout(() => inputRef.current?.focus(), 50);
+    return () => window.clearTimeout(t);
+  }, [isOpen]);
+
+  const filtered = useMemo(() => {
+    const q = query.trim().toLowerCase();
+    const list = !q
+      ? commands
+      : commands.filter((c) => {
+          const hay = `${c.id} ${c.title} ${c.subtitle ?? ''} ${c.group ?? ''}`.toLowerCase();
+          return hay.includes(q);
+        });
+
+    // 简单：优先 path 前缀命中
+    if (!q) return list;
+    const starts = list.filter((c) => c.id.toLowerCase().startsWith(q));
+    const rest = list.filter((c) => !c.id.toLowerCase().startsWith(q));
+    return [...starts, ...rest];
+  }, [commands, query]);
+
+  useEffect(() => {
+    if (activeIndex >= filtered.length) setActiveIndex(0);
+  }, [filtered.length, activeIndex]);
+
+  const active = filtered[activeIndex];
+
+  const exec = (mode: CommandPaletteExecuteMode) => {
+    if (!active) return;
+    onExecute(active.id, mode);
+    onOpenChange(false);
+  };
+
+  const onKeyDown = (e: React.KeyboardEvent) => {
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      setActiveIndex((i) => Math.min(i + 1, Math.max(0, filtered.length - 1)));
+      return;
+    }
+    if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      setActiveIndex((i) => Math.max(i - 1, 0));
+      return;
+    }
+    if (e.key === 'Enter') {
+      e.preventDefault();
+      // Shift+Enter 仅打开；Enter 打开并发送
+      exec(e.shiftKey ? 'open' : 'send');
+      return;
+    }
+    if (e.key === 'Escape') {
+      e.preventDefault();
+      onOpenChange(false);
+    }
+  };
+
+  return (
+    <Modal
+      isOpen={isOpen}
+      onOpenChange={onOpenChange}
+      size={mobile ? 'full' : '2xl'}
+      radius={mobile ? 'none' : 'lg'}
+      scrollBehavior='inside'
+      backdrop='blur'
+    >
+      <ModalContent>
+        {() => (
+          <>
+            <ModalHeader className={clsx(
+              'flex items-center gap-2',
+              mobile ? 'border-b border-default-200/50' : ''
+            )}>
+              <span className='text-sm font-semibold'>命令面板</span>
+              <span className='text-xs text-default-400 font-normal hidden md:inline'>Ctrl/Cmd + K</span>
+            </ModalHeader>
+            <ModalBody className={clsx('gap-3', mobile ? 'p-3' : 'p-4')}>
+              <Input
+                ref={inputRef as any}
+                autoFocus
+                value={query}
+                onValueChange={setQuery}
+                onKeyDown={onKeyDown}
+                placeholder='输入 /set_xxx 或 描述…  Enter：打开并发送，Shift+Enter：仅打开'
+                startContent={<TbSearch className='opacity-40' size={16} />}
+                radius='lg'
+                variant='flat'
+                classNames={{
+                  inputWrapper: 'bg-content2/50 border border-default-200/50 dark:border-default-100/20',
+                  input: 'text-sm',
+                }}
+              />
+
+              <div className={clsx(
+                'rounded-xl border border-default-200/50 dark:border-default-100/20 overflow-hidden',
+                mobile ? 'flex-1 min-h-0' : 'max-h-[420px]'
+              )}>
+                <div className={clsx(
+                  'divide-y divide-default-200/50 dark:divide-default-100/20 overflow-y-auto no-scrollbar',
+                  mobile ? 'h-full' : 'max-h-[420px]'
+                )}>
+                  {filtered.length === 0 && (
+                    <div className='p-6 text-sm text-default-400'>没有匹配的接口</div>
+                  )}
+                  {filtered.map((c, idx) => (
+                    <button
+                      key={c.id}
+                      type='button'
+                      className={clsx(
+                        'w-full text-left px-4 py-3 transition-colors flex items-center gap-3',
+                        idx === activeIndex
+                          ? 'bg-primary/10'
+                          : 'hover:bg-default-100/50 dark:hover:bg-default-50/10'
+                      )}
+                      onMouseEnter={() => setActiveIndex(idx)}
+                      onClick={() => {
+                        setActiveIndex(idx);
+                        exec('open');
+                      }}
+                    >
+                      <div className='min-w-0 flex-1'>
+                        <div className='flex items-center gap-2 min-w-0'>
+                          <span className='text-xs font-mono text-default-500 truncate'>{c.id}</span>
+                          {c.group && (
+                            <span className='text-[10px] px-2 py-0.5 rounded-full bg-default-100/60 dark:bg-default-50/20 text-default-500'>
+                              {c.group}
+                            </span>
+                          )}
+                        </div>
+                        <div className='text-sm text-default-700 dark:text-default-200 truncate'>{c.title}</div>
+                        {c.subtitle && (
+                          <div className='text-xs text-default-400 truncate'>{c.subtitle}</div>
+                        )}
+                      </div>
+                      <div className='flex items-center gap-2 flex-shrink-0'>
+                        <span className='hidden md:inline text-[10px] text-default-400'>Enter</span>
+                        <TbCornerDownLeft className='opacity-40' size={16} />
+                      </div>
+                    </button>
+                  ))}
+                </div>
+              </div>
+            </ModalBody>
+            {mobile && (
+              <ModalFooter className='border-t border-default-200/50'>
+                <Button radius='full' variant='flat' onPress={() => onOpenChange(false)}>
+                  取消
+                </Button>
+                <Button
+                  radius='full'
+                  variant='flat'
+                  color='primary'
+                  isDisabled={!active}
+                  onPress={() => exec('open')}
+                >
+                  打开
+                </Button>
+                <Button
+                  radius='full'
+                  color='primary'
+                  isDisabled={!active}
+                  onPress={() => exec('send')}
+                >
+                  打开并发送
+                </Button>
+              </ModalFooter>
+            )}
+          </>
+        )}
+      </ModalContent>
+    </Modal>
+  );
+}

packages/napcat-webui-frontend/src/components/file_manage/file_edit_modal.tsx

@@ -63,17 +63,17 @@ export default function FileEditModal ({
   };
 
   return (
-    <Modal radius='sm' size='full' isOpen={isOpen} onClose={onClose}>
-      <ModalContent>
-        <ModalHeader className='flex items-center gap-2 border-b border-default-200/50'>
+    <Modal radius='sm' size='full' isOpen={isOpen} onClose={onClose} scrollBehavior="inside">
+      <ModalContent className="flex flex-col h-full max-h-[100dvh]">
+        <ModalHeader className='flex items-center gap-2 border-b border-default-200/50 flex-shrink-0'>
           <span>编辑文件</span>
           <Code radius='sm' className='text-xs'>{file?.path}</Code>
           <div className="ml-auto text-xs text-default-400 font-normal px-2">
             按 <span className="px-1 py-0.5 rounded border border-default-300 bg-default-100">Ctrl/Cmd + S</span> 保存
           </div>
         </ModalHeader>
-        <ModalBody className='p-4 bg-content2/50'>
-          <div className='h-full' onKeyDown={(e) => {
+        <ModalBody className='p-4 bg-content2/50 flex-1 min-h-0 overflow-hidden'>
+          <div className='h-full w-full overflow-auto' onKeyDown={(e) => {
             if ((e.ctrlKey || e.metaKey) && e.key === 's') {
               e.preventDefault();
               onSave();
@@ -88,7 +88,7 @@ export default function FileEditModal ({
             />
           </div>
         </ModalBody>
-        <ModalFooter className="border-t border-default-200/50">
+        <ModalFooter className="border-t border-default-200/50 flex-shrink-0">
           <Button radius='sm' color='primary' variant='flat' onPress={onClose}>
             取消
           </Button>

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

@@ -52,7 +52,7 @@ const Modal: React.FC<ModalProps> = React.memo((props) => {
         onNativeClose();
       }}
       classNames={{
-        backdrop: 'z-[99]',
+        backdrop: 'z-[99] backdrop-blur-sm',
         wrapper: 'z-[99]',
       }}
       {...rest}

packages/napcat-webui-frontend/src/components/network_edit/http_server.tsx

@@ -2,9 +2,9 @@ import GenericForm, { random_token } from './generic_form';
 import type { Field } from './generic_form';
 
 export interface HTTPServerFormProps {
-  data?: OneBotConfig['network']['httpServers'][0]
-  onClose: () => void
-  onSubmit: (data: OneBotConfig['network']['httpServers'][0]) => Promise<void>
+  data?: OneBotConfig['network']['httpServers'][0];
+  onClose: () => void;
+  onSubmit: (data: OneBotConfig['network']['httpServers'][0]) => Promise<void>;
 }
 
 type HTTPServerFormType = OneBotConfig['network']['httpServers'];
@@ -20,7 +20,7 @@ const HTTPServerForm: React.FC<HTTPServerFormProps> = ({
     host: '127.0.0.1',
     port: 3000,
     enableCors: true,
-    enableWebsocket: true,
+    enableWebsocket: false,
     messagePostFormat: 'array',
     token: random_token(16),
     debug: false,

packages/napcat-webui-frontend/src/components/network_edit/http_sse.tsx

@@ -2,11 +2,11 @@ import GenericForm, { random_token } from './generic_form';
 import type { Field } from './generic_form';
 
 export interface HTTPServerSSEFormProps {
-  data?: OneBotConfig['network']['httpSseServers'][0]
-  onClose: () => void
+  data?: OneBotConfig['network']['httpSseServers'][0];
+  onClose: () => void;
   onSubmit: (
     data: OneBotConfig['network']['httpSseServers'][0]
-  ) => Promise<void>
+  ) => Promise<void>;
 }
 
 type HTTPServerSSEFormType = OneBotConfig['network']['httpSseServers'];
@@ -22,7 +22,7 @@ const HTTPServerSSEForm: React.FC<HTTPServerSSEFormProps> = ({
     host: '127.0.0.1',
     port: 3000,
     enableCors: true,
-    enableWebsocket: true,
+    enableWebsocket: false,
     messagePostFormat: 'array',
     token: random_token(16),
     debug: false,

packages/napcat-webui-frontend/src/components/network_edit/modal.tsx

@@ -2,6 +2,7 @@ import { Modal, ModalContent, ModalHeader } from '@heroui/modal';
 import toast from 'react-hot-toast';
 
 import useConfig from '@/hooks/use-config';
+import useDialog from '@/hooks/use-dialog';
 
 import HTTPClientForm from './http_client';
 import HTTPServerForm from './http_server';
@@ -31,23 +32,57 @@ const NetworkFormModal = <T extends keyof OneBotConfig['network']> (
 ) => {
   const { isOpen, onOpenChange, field, data } = props;
   const { createNetworkConfig, updateNetworkConfig } = useConfig();
+  const dialog = useDialog();
   const isCreate = !data;
 
   const onSubmit = async (data: OneBotConfig['network'][typeof field][0]) => {
-    try {
-      if (isCreate) {
-        await createNetworkConfig(field, data);
-      } else {
-        await updateNetworkConfig(field, data);
+    const saveData = async (dataToSave: OneBotConfig['network'][typeof field][0]) => {
+      try {
+        if (isCreate) {
+          await createNetworkConfig(field, dataToSave);
+        } else {
+          await updateNetworkConfig(field, dataToSave);
+        }
+        toast.success('保存配置成功');
+      } catch (error) {
+        const msg = (error as Error).message;
+
+        toast.error(`保存配置失败: ${msg}`);
+
+        throw error;
       }
-      toast.success('保存配置成功');
-    } catch (error) {
-      const msg = (error as Error).message;
+    };
 
-      toast.error(`保存配置失败: ${msg}`);
-
-      throw error;
+    if (['httpServers', 'httpSseServers', 'websocketServers'].includes(field)) {
+      const serverData = data as any;
+      if (!serverData.token) {
+        await new Promise<void>((resolve, reject) => {
+          dialog.confirm({
+            title: '安全警告',
+            content: (
+              <div>
+                <p>检测到未配置Token，这可能导致安全风险。确认要继续吗？</p>
+                <p className='text-sm text-gray-500 mt-2'>(未配置Token时，Host将被强制限制为 127.0.0.1)</p>
+              </div>
+            ),
+            onConfirm: async () => {
+              serverData.host = '127.0.0.1';
+              try {
+                await saveData(serverData);
+                resolve();
+              } catch (e) {
+                reject(e);
+              }
+            },
+            onCancel: () => {
+              reject(new Error('Cancelled'));
+            },
+          });
+        });
+        return;
+      }
     }
+    await saveData(data);
   };
 
   const renderFormComponent = (onClose: () => void) => {

packages/napcat-webui-frontend/src/components/onebot/api/debug.tsx

@@ -1,4 +1,5 @@
 import { Button } from '@heroui/button';
+
 import { Input } from '@heroui/input';
 import { Popover, PopoverContent, PopoverTrigger } from '@heroui/popover';
 import { Tooltip } from '@heroui/tooltip';
@@ -6,7 +7,7 @@ import { Tab, Tabs } from '@heroui/tabs';
 import { Chip } from '@heroui/chip';
 import { useLocalStorage } from '@uidotdev/usehooks';
 import clsx from 'clsx';
-import { useEffect, useState, useCallback } from 'react';
+import { forwardRef, useEffect, useImperativeHandle, useState, useCallback } from 'react';
 import toast from 'react-hot-toast';
 import { IoChevronDown, IoSend, IoSettingsSharp, IoCopy } from 'react-icons/io5';
 import { TbCode, TbMessageCode } from 'react-icons/tb';
@@ -30,14 +31,21 @@ export interface OneBotApiDebugProps {
   adapterName?: string;
 }
 
-const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
+export interface OneBotApiDebugRef {
+  setRequestBody: (value: string) => void;
+  sendWithBody: (value: string) => void;
+  focusRequestEditor: () => void;
+}
+
+const OneBotApiDebug = forwardRef<OneBotApiDebugRef, OneBotApiDebugProps>((props, ref) => {
   const { path, data, adapterName } = props;
   const currentURL = new URL(window.location.origin);
   currentURL.port = '3000';
   const defaultHttpUrl = currentURL.href;
+  const defaultToken = localStorage.getItem('token') || '';
   const [httpConfig, setHttpConfig] = useLocalStorage(key.httpDebugConfig, {
     url: defaultHttpUrl,
-    token: '',
+    token: defaultToken,
   });
 
   const [requestBody, setRequestBody] = useState('{}');
@@ -46,21 +54,23 @@ const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
   const [activeTab, setActiveTab] = useState<any>('request');
   const [responseExpanded, setResponseExpanded] = useState(true);
   const [responseStatus, setResponseStatus] = useState<{ code: number; text: string; } | null>(null);
-  const [responseHeight, setResponseHeight] = useLocalStorage('napcat_debug_response_height', 240); // 默认高度
+  // Height Resizing Logic
+  const [responseHeight, setResponseHeight] = useState(240);
+  const [storedHeight, setStoredHeight] = useLocalStorage('napcat_debug_response_height', 240);
 
   const parsedRequest = parse(data.request);
   const parsedResponse = parse(data.response);
   const [backgroundImage] = useLocalStorage<string>(key.backgroundImage, '');
   const hasBackground = !!backgroundImage;
 
-  const sendRequest = async () => {
+  const sendRequest = async (bodyOverride?: string) => {
     if (isFetching) return;
     setIsFetching(true);
     setResponseStatus(null);
     const r = toast.loading('正在发送请求...');
 
     try {
-      const parsedRequestBody = JSON.parse(requestBody);
+      const parsedRequestBody = JSON.parse(bodyOverride ?? requestBody);
 
       // 如果有 adapterName，走后端转发
       if (adapterName) {
@@ -127,93 +137,132 @@ const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
     }
   };
 
+  useImperativeHandle(ref, () => ({
+    setRequestBody: (value: string) => {
+      setActiveTab('request');
+      setRequestBody(value);
+    },
+    sendWithBody: (value: string) => {
+      setActiveTab('request');
+      setRequestBody(value);
+      // 直接用 override 发送，避免 setState 异步导致拿到旧值
+      void sendRequest(value);
+    },
+    focusRequestEditor: () => {
+      setActiveTab('request');
+    }
+  }));
+
   useEffect(() => {
     setRequestBody(generateDefaultJson(data.request));
     setResponseContent('');
     setResponseStatus(null);
   }, [path]);
 
-  // Height Resizing Logic
+  // Sync from storage on mount
+  useEffect(() => {
+    setResponseHeight(storedHeight);
+  }, []);
+
   const handleMouseDown = useCallback((e: React.MouseEvent) => {
     e.preventDefault();
     const startY = e.clientY;
     const startHeight = responseHeight;
+    let currentH = startHeight;
+    let frameId: number;
 
     const handleMouseMove = (mv: MouseEvent) => {
-      const delta = startY - mv.clientY;
-      // 向上拖动 -> 增加高度
-      setResponseHeight(Math.max(100, Math.min(window.innerHeight - 200, startHeight + delta)));
+      if (frameId) cancelAnimationFrame(frameId);
+      frameId = requestAnimationFrame(() => {
+        const delta = startY - mv.clientY;
+        currentH = Math.max(100, Math.min(window.innerHeight - 200, startHeight + delta));
+        setResponseHeight(currentH);
+      });
     };
 
     const handleMouseUp = () => {
       document.removeEventListener('mousemove', handleMouseMove);
       document.removeEventListener('mouseup', handleMouseUp);
+      if (frameId) cancelAnimationFrame(frameId);
+      setStoredHeight(currentH);
     };
 
     document.addEventListener('mousemove', handleMouseMove);
     document.addEventListener('mouseup', handleMouseUp);
-  }, [responseHeight, setResponseHeight]);
+  }, [responseHeight, setStoredHeight]);
 
   const handleTouchStart = useCallback((e: React.TouchEvent) => {
-    // 阻止默认滚动行为可能需要谨慎，这里尽量只阻止 handle 上的
-    // e.preventDefault(); 
     const touch = e.touches[0];
     const startY = touch.clientY;
     const startHeight = responseHeight;
+    let currentH = startHeight;
+    let frameId: number;
 
     const handleTouchMove = (mv: TouchEvent) => {
-      const mvTouch = mv.touches[0];
-      const delta = startY - mvTouch.clientY;
-      setResponseHeight(Math.max(100, Math.min(window.innerHeight - 200, startHeight + delta)));
+      if (frameId) cancelAnimationFrame(frameId);
+      frameId = requestAnimationFrame(() => {
+        const mvTouch = mv.touches[0];
+        const delta = startY - mvTouch.clientY;
+        currentH = Math.max(100, Math.min(window.innerHeight - 200, startHeight + delta));
+        setResponseHeight(currentH);
+      });
     };
 
     const handleTouchEnd = () => {
       document.removeEventListener('touchmove', handleTouchMove);
       document.removeEventListener('touchend', handleTouchEnd);
+      if (frameId) cancelAnimationFrame(frameId);
+      setStoredHeight(currentH);
     };
 
     document.addEventListener('touchmove', handleTouchMove);
     document.addEventListener('touchend', handleTouchEnd);
-  }, [responseHeight, setResponseHeight]);
+  }, [responseHeight, setStoredHeight]);
 
 
   return (
-    <section className='h-full flex flex-col overflow-hidden bg-transparent'>
-      {/* URL Bar */}
-      <div className='flex flex-wrap md:flex-nowrap items-center gap-2 p-2 md:p-4 pb-2 flex-shrink-0'>
-        <div className={clsx(
-          'flex-grow flex items-center gap-2 px-3 md:px-4 h-10 rounded-xl transition-all w-full md:w-auto',
-          hasBackground ? 'bg-white/5' : 'bg-black/5 dark:bg-white/5'
-        )}>
-          <Chip size="sm" variant="shadow" color="primary" className="font-bold text-[10px] h-5 min-w-[40px]">POST</Chip>
-          <span className={clsx(
-            'text-xs font-mono truncate select-all flex-1 opacity-50',
-            hasBackground ? 'text-white' : 'text-default-600'
-          )}>{path}</span>
+
+    <div className='flex flex-col h-full w-full relative overflow-hidden'>
+      {/* 1. Top Toolbar: URL & Actions */}
+      <div className={clsx(
+        'flex items-center gap-4 px-4 py-2 border-b flex-shrink-0 z-10',
+        hasBackground ? 'border-white/10 bg-white/5' : 'border-black/5 dark:border-white/10 bg-white/40 dark:bg-black/20'
+      )}>
+        {/* Method & Path */}
+        {/* Method & Path */}
+        {/* Method & Path */}
+        <div className="flex items-center gap-3 flex-1 min-w-0 pl-1">
+          <div className={clsx(
+            'text-sm font-mono truncate select-all px-2 py-1 rounded-md transition-colors',
+            hasBackground ? 'text-white/90 bg-black/10' : 'text-foreground dark:text-white/90 bg-default-100/50'
+          )}>
+            {path}
+          </div>
         </div>
 
-        <div className='flex items-center gap-2 flex-shrink-0 ml-auto'>
-          <Popover placement='bottom-end' backdrop='blur'>
+        {/* Actions */}
+        <div className='flex items-center gap-2'>
+          <Popover placement='bottom-end' backdrop='transparent'>
             <PopoverTrigger>
-              <Button size='sm' variant='light' radius='full' isIconOnly className='h-10 w-10 opacity-40 hover:opacity-100'>
+              <Button size='sm' variant='light' radius='sm' isIconOnly className='opacity-60 hover:opacity-100'>
                 <IoSettingsSharp className="text-lg" />
               </Button>
             </PopoverTrigger>
-            <PopoverContent className='w-[260px] p-3 rounded-xl border border-white/10 shadow-2xl bg-white/80 dark:bg-black/80 backdrop-blur-xl'>
+            <PopoverContent className='w-[260px] p-3 rounded-md border border-white/10 shadow-2xl bg-white/80 dark:bg-black/80 backdrop-blur-xl'>
               <div className='flex flex-col gap-2'>
                 <p className='text-[10px] font-bold opacity-30 uppercase tracking-widest'>Debug Setup</p>
-                <Input label='Base URL' value={httpConfig.url} onChange={(e) => setHttpConfig({ ...httpConfig, url: e.target.value })} size='sm' variant='flat' />
-                <Input label='Token' value={httpConfig.token} onChange={(e) => setHttpConfig({ ...httpConfig, token: e.target.value })} size='sm' variant='flat' />
+                <Input label='Base URL' labelPlacement="outside" placeholder="http://..." value={httpConfig.url} onChange={(e) => setHttpConfig({ ...httpConfig, url: e.target.value })} size='sm' variant='bordered' />
+                <Input label='Token' labelPlacement="outside" placeholder="access_token" value={httpConfig.token} onChange={(e) => setHttpConfig({ ...httpConfig, token: e.target.value })} size='sm' variant='bordered' />
               </div>
             </PopoverContent>
           </Popover>
 
           <Button
-            onPress={sendRequest}
+            onPress={() => sendRequest()}
             color='primary'
-            radius='full'
+            radius='sm'
             size='sm'
-            className='h-10 px-6 font-bold shadow-md shadow-primary/20 hover:scale-[1.02] active:scale-[0.98]'
+            className='font-bold shadow-sm px-4'
             isLoading={isFetching}
             startContent={!isFetching && <IoSend className="text-xs" />}
           >
@@ -222,85 +271,79 @@ const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
         </div>
       </div>
 
-      <div className='flex-1 flex flex-col min-h-0 bg-transparent'>
-        <div className='px-4 flex flex-wrap items-center justify-between flex-shrink-0 min-h-[36px] gap-2 py-1'>
-          <Tabs
-            size="sm"
-            variant="underlined"
-            selectedKey={activeTab}
-            onSelectionChange={setActiveTab}
-            classNames={{
-              cursor: 'bg-primary h-0.5',
-              tab: 'px-0 mr-5 h-8',
-              tabList: 'p-0 border-none',
-              tabContent: 'text-[11px] font-bold opacity-30 group-data-[selected=true]:opacity-80 transition-opacity'
-            }}
-          >
-            <Tab key="request" title="请求参数" />
-            <Tab key="docs" title="接口定义" />
-          </Tabs>
-          <div className='flex items-center gap-1 ml-auto'>
-            <ChatInputModal>
-              {(onOpen) => (
-                <Tooltip content="构造消息 (CQ码)" closeDelay={0}>
-                  <Button
-                    isIconOnly
-                    size='sm'
-                    variant='light'
-                    radius='full'
-                    className='h-7 w-7 text-primary/80 bg-primary/10 hover:bg-primary/20'
-                    onPress={onOpen}
-                  >
-                    <TbMessageCode size={16} />
-                  </Button>
-                </Tooltip>
-              )}
-            </ChatInputModal>
-
-            <Tooltip content="生成示例参数" closeDelay={0}>
-              <Button
-                isIconOnly
-                size='sm'
-                variant='light'
-                radius='full'
-                className='h-7 w-7 text-default-400 hover:text-primary hover:bg-default-100/50'
-                onPress={() => setRequestBody(generateDefaultJson(data.request))}
-              >
-                <TbCode size={16} />
-              </Button>
-            </Tooltip>
-          </div>
-        </div>
-
-        <div className='flex-1 min-h-0 relative px-3 pb-2 mt-1'>
+      {/* 2. Main Workspace (Request) - Flexible Height */}
+      <div className='flex-1 min-h-0 flex flex-col relative'>
+        <div className='flex-1 flex flex-col overflow-hidden relative'>
+          {/* Request Toolbar */}
           <div className={clsx(
-            'h-full transition-all',
-            activeTab !== 'request' && 'rounded-xl overflow-y-auto no-scrollbar',
-            hasBackground ? 'bg-transparent' : (activeTab !== 'request' && 'bg-white/10 dark:bg-black/10')
+            'px-4 flex items-center justify-between h-10 flex-shrink-0 border-b',
+            hasBackground ? 'border-white/10' : 'border-default-100 dark:border-white/10'
           )}>
+            <Tabs
+              aria-label="Request Options"
+              size="sm"
+              variant="underlined"
+              selectedKey={activeTab}
+              onSelectionChange={setActiveTab}
+              classNames={{
+                tabList: 'p-0 gap-6 bg-transparent',
+                cursor: 'w-full bg-foreground dark:bg-white h-[2px]',
+                tab: 'px-0 h-full',
+                tabContent: 'text-xs font-medium text-default-500 dark:text-white/50 group-data-[selected=true]:text-foreground dark:group-data-[selected=true]:text-white'
+              }}
+            >
+              <Tab key="request" title="请求体" />
+              <Tab key="docs" title="接口文档" />
+            </Tabs>
+
+            <div className='flex items-center gap-1 opacity-70'>
+              <ChatInputModal>
+                {(onOpen) => (
+                  <Tooltip content="构造 CQ 码" closeDelay={0}>
+                    <Button isIconOnly size='sm' variant='light' radius='sm' className='w-8 h-8' onPress={onOpen}>
+                      <TbMessageCode size={16} />
+                    </Button>
+                  </Tooltip>
+                )}
+              </ChatInputModal>
+              <Tooltip content="生成示例" closeDelay={0}>
+                <Button isIconOnly size='sm' variant='light' radius='sm' className='w-8 h-8' onPress={() => setRequestBody(generateDefaultJson(data.request))}>
+                  <TbCode size={16} />
+                </Button>
+              </Tooltip>
+            </div>
+          </div>
+
+          {/* Content Area */}
+          <div className='flex-1 relative overflow-hidden'>
             {activeTab === 'request' ? (
-              <CodeEditor
-                value={requestBody}
-                onChange={(value) => setRequestBody(value ?? '')}
-                language='json'
-                options={{
-                  minimap: { enabled: false },
-                  fontSize: 12,
-                  scrollBeyondLastLine: false,
-                  wordWrap: 'on',
-                  padding: { top: 12 },
-                  lineNumbersMinChars: 3
-                }}
-              />
+              <div className="absolute inset-0">
+                <CodeEditor
+                  value={requestBody}
+                  onChange={(value) => setRequestBody(value ?? '')}
+                  language='json'
+                  options={{
+                    minimap: { enabled: false },
+                    fontSize: 13,
+                    fontFamily: 'JetBrains Mono, monospace',
+                    scrollBeyondLastLine: false,
+                    wordWrap: 'on',
+                    padding: { top: 16, bottom: 16 },
+                    lineNumbersMinChars: 3,
+                    chromeless: true,
+                    backgroundColor: 'transparent'
+                  }}
+                />
+              </div>
             ) : (
-              <div className='p-6 space-y-10'>
+              <div className='p-6 space-y-8 overflow-y-auto h-full scrollbar-hide'>
                 <section>
-                  <h3 className='text-[10px] font-bold opacity-20 uppercase tracking-[0.2em] mb-4'>Request - 请求数据结构</h3>
+                  <h3 className='text-[10px] font-bold text-default-700 dark:text-default-50 uppercase tracking-widest mb-4'>Request Params</h3>
                   <DisplayStruct schema={parsedRequest} />
                 </section>
-                <div className='h-px bg-white/5 w-full' />
+                <div className='h-px bg-white/10 w-full' />
                 <section>
-                  <h3 className='text-[10px] font-bold opacity-20 uppercase tracking-[0.2em] mb-4'>Response - 返回数据结构</h3>
+                  <h3 className='text-[10px] font-bold text-default-700 dark:text-default-50 uppercase tracking-widest mb-4'>Response Data</h3>
                   <DisplayStruct schema={parsedResponse} />
                 </section>
               </div>
@@ -309,73 +352,79 @@ const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
         </div>
       </div>
 
-      {/* Response Area */}
-      <div className='flex-shrink-0 px-3 pb-3'>
+      {/* 3. Response Panel (Bottom) */}
+      <div
+        className='flex-shrink-0 flex flex-col overflow-hidden relative'
+        style={{ height: responseExpanded ? undefined : 'auto' }}
+      >
+        {/* Resize Handle / Header */}
         <div
           className={clsx(
-            'rounded-xl transition-all overflow-hidden border border-white/5 flex flex-col',
-            hasBackground ? 'bg-white/5' : 'bg-white/5 dark:bg-black/5'
+            'flex items-center justify-between px-4 py-1.5 cursor-pointer hover:bg-black/5 dark:hover:bg-white/5 transition-colors select-none group relative border-t',
+            hasBackground ? 'border-white/10' : 'border-default-100 dark:border-white/10'
           )}
+          onClick={() => setResponseExpanded(!responseExpanded)}
         >
-          {/* Header & Resize Handle */}
-          <div
-            className='flex items-center justify-between px-4 py-2 cursor-pointer hover:bg-white/5 transition-all select-none relative group'
-            onClick={() => setResponseExpanded(!responseExpanded)}
-          >
-            {/* Invisble Resize Area that becomes visible/active */}
-            {responseExpanded && (
-              <div
-                className="absolute -top-1 left-0 w-full h-3 cursor-ns-resize z-50 flex items-center justify-center opacity-0 hover:opacity-100 group-hover:opacity-100 transition-opacity"
-                onMouseDown={(e) => { e.stopPropagation(); handleMouseDown(e); }}
-                onTouchStart={(e) => { e.stopPropagation(); handleTouchStart(e); }}
-                onClick={(e) => e.stopPropagation()}
-              >
-                <div className="w-12 h-1 bg-white/20 rounded-full" />
-              </div>
-            )}
+          {/* Invisible Draggable Area */}
+          {responseExpanded && (
+            <div
+              className="absolute -top-1.5 left-0 w-full h-4 cursor-ns-resize z-20"
+              onMouseDown={(e) => { e.stopPropagation(); handleMouseDown(e); }}
+              onTouchStart={(e) => { e.stopPropagation(); handleTouchStart(e); }}
+              onClick={(e) => e.stopPropagation()}
+            />
+          )}
 
-            <div className='flex items-center gap-2'>
-              <IoChevronDown className={clsx('text-[10px] transition-transform duration-300 opacity-20', !responseExpanded && '-rotate-90')} />
-              <span className='text-[10px] font-semibold tracking-wide opacity-30 uppercase'>Response</span>
-            </div>
-            <div className='flex items-center gap-2'>
-              {responseStatus && (
-                <Chip size="sm" variant="flat" color={responseStatus.code >= 200 && responseStatus.code < 300 ? 'success' : 'danger'} className="h-4 text-[9px] font-mono px-1.5 opacity-50">
-                  {responseStatus.code}
-                </Chip>
-              )}
-              <Button size='sm' variant='light' isIconOnly radius='full' className='h-6 w-6 opacity-20 hover:opacity-80 transition-opacity' onClick={(e) => { e.stopPropagation(); navigator.clipboard.writeText(responseContent); toast.success('已复制'); }}>
-                <IoCopy size={10} />
-              </Button>
+          <div className='flex items-center gap-2'>
+            <div className={clsx('transition-transform duration-200', !responseExpanded && '-rotate-90')}>
+              <IoChevronDown size={14} className="opacity-50" />
             </div>
+            <span className={clsx(
+              'text-[10px] font-bold tracking-widest uppercase',
+              hasBackground ? 'text-white' : 'text-foreground dark:text-white'
+            )}>Response</span>
+            {responseStatus && (
+              <Chip size="sm" variant="dot" color={responseStatus.code >= 200 && responseStatus.code < 300 ? 'success' : 'danger'} className="h-5 text-[10px] font-mono border-none bg-transparent pl-0">
+                {responseStatus.code} {responseStatus.text}
+              </Chip>
+            )}
           </div>
 
-          {/* Response Content - Code Editor */}
-          {responseExpanded && (
-            <div style={{ height: responseHeight }} className="relative bg-transparent">
-              <PageLoading loading={isFetching} />
+          <Button size='sm' variant='light' isIconOnly radius='sm' className='h-6 w-6 opacity-40 hover:opacity-100' onClick={(e) => { e.stopPropagation(); navigator.clipboard.writeText(responseContent); toast.success('已复制'); }}>
+            <IoCopy size={12} />
+          </Button>
+        </div>
+
+        {/* Response Editor */}
+        {responseExpanded && (
+          <div style={{ height: responseHeight }} className="relative bg-transparent">
+            <PageLoading loading={isFetching} />
+            <div className="absolute inset-0">
               <CodeEditor
                 value={responseContent || '// Waiting for response...'}
                 language='json'
                 options={{
                   minimap: { enabled: false },
-                  fontSize: 11,
+                  fontSize: 12,
+                  fontFamily: 'JetBrains Mono, monospace',
                   lineNumbers: 'off',
                   scrollBeyondLastLine: false,
                   wordWrap: 'on',
                   readOnly: true,
                   folding: true,
-                  padding: { top: 8, bottom: 8 },
+                  padding: { top: 12, bottom: 12 },
                   renderLineHighlight: 'none',
-                  automaticLayout: true
+                  chromeless: true,
+                  backgroundColor: 'transparent'
                 }}
               />
             </div>
-          )}
-        </div>
+          </div>
+        )}
       </div>
-    </section>
+
+    </div>
   );
-};
+});
 
 export default OneBotApiDebug;

packages/napcat-webui-frontend/src/components/onebot/api/nav_list.tsx

@@ -143,21 +143,23 @@ const OneBotApiNavList: React.FC<OneBotApiNavListProps> = (props) => {
                               key={api.path}
                               onClick={() => onSelect(api.path)}
                               className={clsx(
-                                'flex flex-col gap-0.5 px-3 py-2 rounded-lg cursor-pointer transition-all border border-transparent select-none',
+                                'flex flex-col gap-0.5 px-3 py-2 rounded-lg cursor-pointer transition-all border select-none',
                                 isSelected
-                                  ? (hasBackground ? '' : 'bg-primary/20 border-primary/20 shadow-sm')
-                                  : 'hover:bg-white/5'
+                                  ? (hasBackground 
+                                      ? 'bg-white/10 border-white/20' 
+                                      : 'bg-primary/10 border-primary/20 shadow-sm')
+                                  : 'border-transparent hover:bg-white/10 dark:hover:bg-white/5'
                               )}
                             >
                               <span className={clsx(
                                 'text-[12px] font-medium transition-colors truncate',
-                                isSelected ? 'text-primary' : 'opacity-60'
+                                isSelected ? 'text-primary' : 'opacity-70'
                               )}>
                                 {api.description}
                               </span>
                               <span className={clsx(
                                 'text-[10px] font-mono truncate transition-all',
-                                isSelected ? 'text-primary/60' : 'opacity-20'
+                                isSelected ? 'text-primary/60' : 'opacity-30'
                               )}>
                                 {api.path}
                               </span>

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

@@ -1,22 +1,70 @@
+import { Button } from '@heroui/button';
 import { Spinner } from '@heroui/spinner';
 import { QRCodeSVG } from 'qrcode.react';
+import { IoAlertCircle, IoRefresh } from 'react-icons/io5';
 
 interface QrCodeLoginProps {
-  qrcode: string
+  qrcode: string;
+  loginError?: string;
+  onRefresh?: () => void;
 }
 
-const QrCodeLogin: React.FC<QrCodeLoginProps> = ({ qrcode }) => {
+const QrCodeLogin: React.FC<QrCodeLoginProps> = ({ qrcode, loginError, onRefresh }) => {
   return (
     <div className='flex flex-col items-center'>
-      <div className='bg-white p-2 rounded-md w-fit mx-auto relative overflow-hidden'>
-        {!qrcode && (
-          <div className='absolute left-2 top-2 right-2 bottom-2 bg-white bg-opacity-50 backdrop-blur flex items-center justify-center'>
-            <Spinner color='primary' />
+      {loginError
+        ? (
+          <div className='flex flex-col items-center py-4'>
+            <div className='w-full flex justify-center mb-6'>
+              <div className='p-4 bg-danger-50 rounded-full'>
+                <IoAlertCircle className='text-danger' size={64} />
+              </div>
+            </div>
+            <div className='text-center space-y-2 px-4'>
+              <div className='text-xl font-bold text-danger'>登录失败</div>
+              <div className='text-default-600 text-sm leading-relaxed max-w-[300px]'>
+                {loginError}
+              </div>
+            </div>
+            {onRefresh && (
+              <Button
+                className='mt-8 min-w-[160px]'
+                variant='solid'
+                color='primary'
+                size='lg'
+                startContent={<IoRefresh />}
+                onPress={onRefresh}
+              >
+                重新获取二维码
+              </Button>
+            )}
           </div>
+        )
+        : (
+          <>
+            <div className='bg-white p-2 rounded-md w-fit mx-auto relative overflow-hidden'>
+              {!qrcode && (
+                <div className='absolute left-0 top-0 right-0 bottom-0 bg-white dark:bg-zinc-900 bg-opacity-90 backdrop-blur-sm flex items-center justify-center z-10'>
+                  <Spinner color='primary' />
+                </div>
+              )}
+              <QRCodeSVG size={180} value={qrcode || ' '} />
+            </div>
+            <div className='mt-5 text-center text-default-500 text-sm'>请使用QQ或者TIM扫描上方二维码</div>
+            {onRefresh && qrcode && (
+              <Button
+                className='mt-4'
+                variant='flat'
+                color='primary'
+                size='sm'
+                startContent={<IoRefresh />}
+                onPress={onRefresh}
+              >
+                刷新二维码
+              </Button>
+            )}
+          </>
         )}
-        <QRCodeSVG size={180} value={qrcode} />
-      </div>
-      <div className='mt-5 text-center'>请使用QQ或者TIM扫描上方二维码</div>
     </div>
   );
 };

packages/napcat-webui-frontend/src/components/sidebar/index.tsx

@@ -70,7 +70,10 @@ const SideBar: React.FC<SideBarProps> = (props) => {
         <motion.div className='w-64 flex flex-col items-stretch h-full transition-transform duration-300 ease-in-out z-30 relative float-right p-4'>
           <div className='flex items-center justify-start gap-3 px-2 my-8 ml-2'>
             <div className="h-5 w-1 bg-primary rounded-full shadow-sm" />
-            <div className="text-xl font-bold text-default-900 dark:text-white tracking-wide select-none">
+            <div className={clsx(
+              "text-xl font-bold tracking-wide select-none",
+              hasBackground ? 'text-white' : 'text-default-900 dark:text-white'
+            )}>
               NapCat
             </div>
           </div>

packages/napcat-webui-frontend/src/components/sidebar/menus.tsx

@@ -54,7 +54,7 @@ const renderItems = (items: MenuItem[], children = false) => {
             isActive
               ? 'bg-primary/10 text-primary dark:bg-primary/20 dark:text-primary-400 shadow-none font-semibold translate-x-1'
               : 'hover:bg-default-100 hover:translate-x-1',
-            b64img && 'backdrop-blur-md text-white'
+            b64img && 'backdrop-blur-md text-white dark:text-white'
           )}
           color={isActive ? 'primary' : 'default'}
           endContent={

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

@@ -81,25 +81,25 @@ const UpdateDialogContent: React.FC<{
   return (
     <div className='space-y-6'>
       {/* 版本对比 */}
-      <div className="flex items-center justify-between px-6 py-8 bg-default-50 dark:bg-default-100/5 rounded-xl border border-default-100 dark:border-default-100/10">
-        <div className="flex flex-col items-center gap-2">
+      <div className="flex flex-col sm:flex-row items-center justify-between gap-4 px-6 py-8 bg-default-50 dark:bg-default-100/5 rounded-xl border border-default-100 dark:border-default-100/10">
+        <div className="flex flex-col items-center gap-2 min-w-0 w-full sm:w-auto">
           <span className="text-xs text-default-500 font-medium uppercase tracking-wider">当前版本</span>
-          <Chip size="lg" variant="flat" color="default" classNames={{ content: "font-mono font-bold text-lg" }}>
+          <Chip size="lg" variant="flat" color="default" classNames={{ content: "font-mono font-bold text-base sm:text-lg break-all whitespace-normal text-center h-auto py-1" }}>
             v{currentVersion}
           </Chip>
         </div>
 
-        <div className="flex flex-col items-center text-primary-500 px-4">
+        <div className="flex flex-col items-center text-primary-500 px-4 shrink-0">
           <div className="p-2 rounded-full bg-primary-50 dark:bg-primary-900/20">
-            <svg className="w-6 h-6 animate-pulse" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <svg className="w-6 h-6 animate-pulse rotate-90 sm:rotate-0" fill="none" viewBox="0 0 24 24" stroke="currentColor">
               <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M17 8l4 4m0 0l-4 4m4-4H3" />
             </svg>
           </div>
         </div>
 
-        <div className="flex flex-col items-center gap-2">
+        <div className="flex flex-col items-center gap-2 min-w-0 w-full sm:w-auto">
           <span className="text-xs text-primary-500 font-medium uppercase tracking-wider">最新版本</span>
-          <Chip size="lg" color="primary" variant="shadow" classNames={{ content: "font-mono font-bold text-lg" }}>
+          <Chip size="lg" color="primary" variant="shadow" classNames={{ content: "font-mono font-bold text-base sm:text-lg break-all whitespace-normal text-center h-auto py-1" }}>
             v{latestVersion}
           </Chip>
         </div>
@@ -267,6 +267,8 @@ interface VersionInfo {
   createdAt?: string;
   expiresAt?: string;
   size?: number;
+  workflowRunId?: number;
+  headSha?: string;
 }
 
 // 版本选择对话框内容
@@ -291,11 +293,11 @@ const VersionSelectDialogContent: React.FC<VersionSelectDialogProps> = ({
   const pageSize = 15;
 
   // 获取所有可用版本（带分页、过滤和搜索）
+  // 懒加载：根据 activeTab 只获取对应类型的版本
   const { data: releasesData, loading: releasesLoading, error: releasesError } = useRequest(
     () => WebUIManager.getAllReleases({
       page: currentPage,
       pageSize,
-      includeActions: true,
       type: activeTab,
       search: debouncedSearch
     }),
@@ -513,7 +515,7 @@ const VersionSelectDialogContent: React.FC<VersionSelectDialogProps> = ({
               setSelectedVersion(version || null);
             }}
             classNames={{
-              trigger: 'h-10',
+              trigger: 'h-auto min-h-10',
             }}
           >
             {filteredVersions.map((version) => {
@@ -524,19 +526,28 @@ const VersionSelectDialogContent: React.FC<VersionSelectDialogProps> = ({
                   key={version.tag}
                   textValue={version.tag}
                 >
-                  <div className='flex items-center gap-2'>
-                    <span>{version.tag}</span>
-                    {version.type === 'prerelease' && (
-                      <Chip size='sm' color='secondary' variant='flat'>预发布</Chip>
-                    )}
+                  <div className='flex flex-col gap-0.5'>
+                    <div className='flex items-center gap-2'>
+                      <span>{version.type === 'action' && version.artifactName ? version.artifactName : version.tag}</span>
+                      {version.type === 'prerelease' && (
+                        <Chip size='sm' color='secondary' variant='flat'>预发布</Chip>
+                      )}
+                      {version.type === 'action' && (
+                        <Chip size='sm' color='default' variant='flat'>临时</Chip>
+                      )}
+                      {isCurrent && (
+                        <Chip size='sm' color='success' variant='flat'>当前</Chip>
+                      )}
+                      {downgrade && !isCurrent && version.type !== 'action' && (
+                        <Chip size='sm' color='warning' variant='flat'>降级</Chip>
+                      )}
+                    </div>
                     {version.type === 'action' && (
-                      <Chip size='sm' color='default' variant='flat'>临时</Chip>
-                    )}
-                    {isCurrent && (
-                      <Chip size='sm' color='success' variant='flat'>当前</Chip>
-                    )}
-                    {downgrade && !isCurrent && version.type !== 'action' && (
-                      <Chip size='sm' color='warning' variant='flat'>降级</Chip>
+                      <div className='text-xs text-default-400'>
+                        {version.headSha && <span className='font-mono'>{version.headSha.slice(0, 7)}</span>}
+                        {version.createdAt && <span className='ml-2'>{new Date(version.createdAt).toLocaleString()}</span>}
+                        {version.size && <span className='ml-2'>{(version.size / 1024 / 1024).toFixed(1)} MB</span>}
+                      </div>
                     )}
                   </div>
                 </SelectItem>

packages/napcat-webui-frontend/src/const/themes/nc_pink.ts

@@ -183,7 +183,7 @@ const theme: ThemeConfig = {
     '--heroui-primary-800': '339.33 86.54% 20.39%',
     '--heroui-primary-900': '340 84.91% 10.39%',
     '--heroui-primary-foreground': '0 0% 100%',
-    '--heroui-primary': '339.2 90.36% 51.18%',
+    '--heroui-primary': '339.2 90.36% 60%',
     '--heroui-secondary-50': '270 61.54% 94.9%',
     '--heroui-secondary-100': '270 59.26% 89.41%',
     '--heroui-secondary-200': '270 59.26% 78.82%',

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

@@ -0,0 +1,14 @@
+import { serverRequest } from '@/utils/request';
+
+export default class ProcessManager {
+  /**
+   * 重启进程
+   */
+  public static async restartProcess () {
+    const data = await serverRequest.post<ServerResponse<{ message: string; }>>(
+      '/Process/Restart'
+    );
+
+    return data.data.data;
+  }
+}

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

@@ -1,3 +1,4 @@
+import { AxiosRequestConfig } from 'axios';
 import { serverRequest } from '@/utils/request';
 
 import { SelfInfo } from '@/types/user';
@@ -20,8 +21,8 @@ export default class QQManager {
   public static async checkQQLoginStatus () {
     const data = await serverRequest.post<
       ServerResponse<{
-        isLogin: string
-        qrcodeurl: string
+        isLogin: string;
+        qrcodeurl: string;
       }>
     >('/QQLogin/CheckLoginStatus');
 
@@ -30,16 +31,20 @@ export default class QQManager {
 
   public static async checkQQLoginStatusWithQrcode () {
     const data = await serverRequest.post<
-      ServerResponse<{ qrcodeurl: string; isLogin: string }>
+      ServerResponse<{ qrcodeurl: string; isLogin: string; loginError?: string; }>
     >('/QQLogin/CheckLoginStatus');
 
     return data.data.data;
   }
 
+  public static async refreshQRCode () {
+    await serverRequest.post<ServerResponse<null>>('/QQLogin/RefreshQRcode');
+  }
+
   public static async getQQLoginQrcode () {
     const data = await serverRequest.post<
       ServerResponse<{
-        qrcode: string
+        qrcode: string;
       }>
     >('/QQLogin/GetQQLoginQrcode');
 
@@ -67,9 +72,11 @@ export default class QQManager {
     });
   }
 
-  public static async getQQLoginInfo () {
+  public static async getQQLoginInfo (config?: AxiosRequestConfig) {
     const data = await serverRequest.post<ServerResponse<SelfInfo>>(
-      '/QQLogin/GetQQLoginInfo'
+      '/QQLogin/GetQQLoginInfo',
+      {},
+      config
     );
     return data.data.data;
   }

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

@@ -65,15 +65,15 @@ export default class WebUIManager {
 
   /**
    * 获取所有可用的版本列表（支持分页、过滤和搜索）
+   * 懒加载：根据 type 参数只获取对应类型的版本
    */
   public static async getAllReleases (options: {
     page?: number;
     pageSize?: number;
-    includeActions?: boolean;
     type?: 'release' | 'action' | 'all';
     search?: string;
   } = {}) {
-    const { page = 1, pageSize = 20, includeActions = true, type = 'all', search = '' } = options;
+    const { page = 1, pageSize = 20, type = 'release', search = '' } = options;
     const { data } = await serverRequest.get<ServerResponse<{
       versions: Array<{
         tag: string;
@@ -83,6 +83,8 @@ export default class WebUIManager {
         createdAt?: string;
         expiresAt?: string;
         size?: number;
+        workflowRunId?: number;
+        headSha?: string;
       }>;
       pagination: {
         page: number;
@@ -92,7 +94,7 @@ export default class WebUIManager {
       };
       mirror?: string;
     }>>('/base/getAllReleases', {
-      params: { page, pageSize, includeActions, type, search },
+      params: { page, pageSize, type, search },
     });
     return data.data;
   }

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

@@ -3,7 +3,7 @@ import { Button } from '@heroui/button';
 import { useLocalStorage } from '@uidotdev/usehooks';
 import clsx from 'clsx';
 import { AnimatePresence, motion } from 'motion/react';
-import { useEffect, useMemo, useRef } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import { ErrorBoundary } from 'react-error-boundary';
 import { MdMenu, MdMenuOpen } from 'react-icons/md';
 import { useLocation, useNavigate } from 'react-router-dom';
@@ -11,14 +11,17 @@ import { useLocation, useNavigate } from 'react-router-dom';
 import key from '@/const/key';
 
 import errorFallbackRender from '@/components/error_fallback';
-// import PageLoading from "@/components/Loading/PageLoading";
+import PageLoading from '@/components/page_loading';
 import SideBar from '@/components/sidebar';
 
 import useAuth from '@/hooks/auth';
+import useDialog from '@/hooks/use-dialog';
 
 import type { MenuItem } from '@/config/site';
 import { siteConfig } from '@/config/site';
 import QQManager from '@/controllers/qq_manager';
+import ProcessManager from '@/controllers/process_manager';
+import { waitForBackendReady } from '@/utils/process_utils';
 
 const menus: MenuItem[] = siteConfig.navItems;
 
@@ -48,7 +51,67 @@ const Layout: React.FC<{ children: React.ReactNode; }> = ({ children }) => {
   const [openSideBar, setOpenSideBar] = useLocalStorage(key.sideBarOpen, true);
   const [b64img] = useLocalStorage(key.backgroundImage, '');
   const navigate = useNavigate();
-  const { isAuth } = useAuth();
+  const { isAuth, revokeAuth } = useAuth();
+  const dialog = useDialog();
+  const isOnlineRef = useRef(true);
+  const [isRestarting, setIsRestarting] = useState(false);
+
+  // 定期检查 QQ 在线状态，掉线时弹窗提示
+  useEffect(() => {
+    if (!isAuth) return;
+    const checkOnlineStatus = async () => {
+      const currentPath = location.pathname;
+      if (currentPath === '/qq_login' || currentPath === '/web_login') return;
+      try {
+        const info = await QQManager.getQQLoginInfo();
+        if (info?.online === false && isOnlineRef.current === true) {
+          isOnlineRef.current = false;
+          dialog.confirm({
+            title: '账号已离线',
+            content: '您的 QQ 账号已下线，请重新登录。',
+            confirmText: '重新登陆',
+            cancelText: '退出账户',
+            onConfirm: async () => {
+              setIsRestarting(true);
+              try {
+                await ProcessManager.restartProcess();
+              } catch (_e) {
+                // 忽略错误，因为后端正在重启关闭连接
+              }
+
+              // 轮询探测后端是否恢复
+              await waitForBackendReady(
+                15000, // 15秒超时
+                () => {
+                  setIsRestarting(false);
+                  window.location.reload();
+                },
+                () => {
+                  setIsRestarting(false);
+                  dialog.alert({
+                    title: '启动超时',
+                    content: '后端在 15 秒内未响应，请检查 NapCat 运行日志或手动重启。',
+                  });
+                }
+              );
+            },
+            onCancel: () => {
+              revokeAuth();
+              navigate('/web_login');
+            },
+          });
+        } else if (info?.online === true) {
+          isOnlineRef.current = true;
+        }
+      } catch (_e) {
+        // 忽略请求错误
+      }
+    };
+    const timer = setInterval(checkOnlineStatus, 5000);
+    checkOnlineStatus();
+    return () => clearInterval(timer);
+  }, [isAuth, location.pathname]);
+
   const checkIsQQLogin = async () => {
     try {
       const result = await QQManager.checkQQLoginStatus();
@@ -86,6 +149,7 @@ const Layout: React.FC<{ children: React.ReactNode; }> = ({ children }) => {
         backgroundPosition: 'center',
       }}
     >
+      <PageLoading loading={isRestarting} />
       <SideBar
         items={menus}
         open={openSideBar}

packages/napcat-webui-frontend/src/pages/dashboard/config/login.tsx

@@ -1,6 +1,7 @@
 import { Input } from '@heroui/input';
+import { Button } from '@heroui/button';
 import { useRequest } from 'ahooks';
-import { useEffect } from 'react';
+import { useEffect, useState } from 'react';
 import { Controller, useForm } from 'react-hook-form';
 import toast from 'react-hot-toast';
 
@@ -8,8 +9,11 @@ import SaveButtons from '@/components/button/save_buttons';
 import PageLoading from '@/components/page_loading';
 
 import QQManager from '@/controllers/qq_manager';
+import ProcessManager from '@/controllers/process_manager';
+import { waitForBackendReady } from '@/utils/process_utils';
 
 const LoginConfigCard = () => {
+  const [isRestarting, setIsRestarting] = useState(false);
   const {
     data: quickLoginData,
     loading: quickLoginLoading,
@@ -53,6 +57,35 @@ const LoginConfigCard = () => {
     }
   };
 
+  const onRestartProcess = async () => {
+    setIsRestarting(true);
+    try {
+      const result = await ProcessManager.restartProcess();
+      toast.success(result.message || '进程重启请求已发送');
+
+      // 轮询探测后端是否恢复
+      const isReady = await waitForBackendReady(
+        30000, // 30秒超时
+        () => {
+          setIsRestarting(false);
+          toast.success('进程重启完成');
+        },
+        () => {
+          setIsRestarting(false);
+          toast.error('后端在 30 秒内未响应，请检查 NapCat 运行日志');
+        }
+      );
+
+      if (!isReady) {
+        setIsRestarting(false);
+      }
+    } catch (error) {
+      const msg = (error as Error).message;
+      toast.error(`进程重启失败: ${msg}`);
+      setIsRestarting(false);
+    }
+  };
+
   useEffect(() => {
     reset();
   }, [quickLoginData]);
@@ -82,6 +115,22 @@ const LoginConfigCard = () => {
         isSubmitting={isSubmitting || quickLoginLoading}
         refresh={onRefresh}
       />
+      <div className='flex-shrink-0 w-full mt-6 pt-6 border-t border-divider'>
+        <div className='mb-3 text-sm text-default-600'>进程管理</div>
+        <Button
+          color='warning'
+          variant='flat'
+          onPress={onRestartProcess}
+          isLoading={isRestarting}
+          isDisabled={isRestarting}
+          fullWidth
+        >
+          {isRestarting ? '正在重启进程...' : '重启进程'}
+        </Button>
+        <div className='mt-2 text-xs text-default-500'>
+          重启进程将关闭当前 Worker 进程，等待 3 秒后启动新进程
+        </div>
+      </div>
     </>
   );
 };

packages/napcat-webui-frontend/src/pages/dashboard/config/theme.tsx

@@ -163,9 +163,15 @@ const ThemeConfigCard = () => {
   const [dataLoaded, setDataLoaded] = useState(false);
   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);
 
-  // 使用 useRef 存储 style 标签引用
+  // 使用 useRef 存储 style 标签引用和状态
   const styleTagRef = useRef<HTMLStyleElement | null>(null);
   const originalDataRef = useRef<ThemeConfig | null>(null);
+  const hasUnsavedChangesRef = useRef<boolean>(false);
+
+  // 同步 hasUnsavedChanges 到 ref，供 cleanup 函数使用
+  useEffect(() => {
+    hasUnsavedChangesRef.current = hasUnsavedChanges;
+  }, [hasUnsavedChanges]);
 
   // 在组件挂载时创建 style 标签，并在卸载时清理
   // 同时在卸载时恢复字体到已保存的状态（避免"伪自动保存"问题）
@@ -174,8 +180,9 @@ const ThemeConfigCard = () => {
     document.head.appendChild(styleTag);
     styleTagRef.current = styleTag;
     return () => {
-      // 组件卸载时，恢复到已保存的字体设置
-      if (originalDataRef.current?.fontMode) {
+      // 组件卸载时，只有在有未保存更改时才恢复到已保存的字体设置
+      // 避免在刷新页面后字体被意外重置
+      if (hasUnsavedChangesRef.current && originalDataRef.current?.fontMode) {
         applyFont(originalDataRef.current.fontMode);
       }
       if (styleTagRef.current) {
@@ -261,15 +268,17 @@ const ThemeConfigCard = () => {
 
   // 找到已保存的主题名称
   const savedThemeName = useMemo(() => {
-    if (!originalDataRef.current) return null;
-    return themes.find(t => isThemeColorsEqual(t.theme, originalDataRef.current!))?.name || '自定义';
-  }, [dataLoaded, hasUnsavedChanges]);
+    const savedData = originalDataRef.current || data;
+    if (!savedData) return null;
+    return themes.find(t => isThemeColorsEqual(t.theme, savedData))?.name || '自定义';
+  }, [data, dataLoaded, hasUnsavedChanges]);
 
   // 已保存的字体模式显示名称
   const savedFontModeDisplayName = useMemo(() => {
-    const mode = originalDataRef.current?.fontMode || 'aacute';
+    const savedData = originalDataRef.current || data;
+    const mode = savedData?.fontMode || 'aacute';
     return fontModeNames[mode] || mode;
-  }, [dataLoaded, hasUnsavedChanges]);
+  }, [data, dataLoaded, hasUnsavedChanges]);
 
   if (loading) return <PageLoading loading />;
 

packages/napcat-webui-frontend/src/pages/dashboard/debug/http/index.tsx

@@ -1,31 +1,43 @@
 import { Button } from '@heroui/button';
 import { useLocalStorage } from '@uidotdev/usehooks';
 import clsx from 'clsx';
-import { useEffect, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import { IoClose } from 'react-icons/io5';
-import { TbSquareRoundedChevronLeftFilled } from 'react-icons/tb';
+import { TbSearch } from 'react-icons/tb';
 
 import key from '@/const/key';
 import oneBotHttpApi from '@/const/ob_api';
 import type { OneBotHttpApiPath } from '@/const/ob_api';
 
 import OneBotApiDebug from '@/components/onebot/api/debug';
-import OneBotApiNavList from '@/components/onebot/api/nav_list';
+import CommandPalette from '@/components/command_palette';
+import type { CommandPaletteCommand, CommandPaletteExecuteMode } from '@/components/command_palette';
+
+import { generateDefaultJson } from '@/utils/zod';
+import type { OneBotApiDebugRef } from '@/components/onebot/api/debug';
 
 export default function HttpDebug () {
-  const [activeApi, setActiveApi] = useState<OneBotHttpApiPath | null>('/set_qq_profile');
-  const [openApis, setOpenApis] = useState<OneBotHttpApiPath[]>(['/set_qq_profile']);
-  const [openSideBar, setOpenSideBar] = useState(true);
+  const [activeApi, setActiveApi] = useState<OneBotHttpApiPath | null>(null);
+  const [openApis, setOpenApis] = useState<OneBotHttpApiPath[]>([]);
   const [backgroundImage] = useLocalStorage<string>(key.backgroundImage, '');
   const hasBackground = !!backgroundImage;
 
   const [adapterName, setAdapterName] = useState<string>('');
+  const [paletteOpen, setPaletteOpen] = useState(false);
 
-  // Auto-collapse sidebar on mobile initial load
+  const debugRefs = useRef(new Map<string, OneBotApiDebugRef>());
+  const [pendingRun, setPendingRun] = useState<{ path: OneBotHttpApiPath; body: string; } | null>(null);
+
+  // Ctrl/Cmd + K 打开命令面板
   useEffect(() => {
-    if (window.innerWidth < 768) {
-      setOpenSideBar(false);
-    }
+    const handler = (e: KeyboardEvent) => {
+      if ((e.ctrlKey || e.metaKey) && e.key.toLowerCase() === 'k') {
+        e.preventDefault();
+        setPaletteOpen(true);
+      }
+    };
+    window.addEventListener('keydown', handler);
+    return () => window.removeEventListener('keydown', handler);
   }, []);
 
   // Initialize Debug Adapter
@@ -64,9 +76,48 @@ export default function HttpDebug () {
       setOpenApis([...openApis, api]);
     }
     setActiveApi(api);
-    if (window.innerWidth < 768) {
-      setOpenSideBar(false);
+  };
+
+  // 等对应 Debug 组件挂载后再触发发送
+  useEffect(() => {
+    if (!pendingRun) return;
+    if (activeApi !== pendingRun.path) return;
+    const ref = debugRefs.current.get(pendingRun.path);
+    if (!ref) return;
+    ref.sendWithBody(pendingRun.body);
+    setPendingRun(null);
+  }, [activeApi, pendingRun]);
+
+  const commands: CommandPaletteCommand[] = useMemo(() => {
+    return Object.keys(oneBotHttpApi).map((p) => {
+      const path = p as OneBotHttpApiPath;
+      const item = oneBotHttpApi[path];
+      // 简单分组：按描述里已有分类不可靠，这里只用 path 前缀推断
+      const group = path.startsWith('/get_') ? 'GET' : (path.startsWith('/set_') ? 'SET' : 'API');
+      return {
+        id: path,
+        title: item?.description || path,
+        subtitle: item?.request ? '回车发送 · Shift+Enter 仅打开' : undefined,
+        group,
+      };
+    });
+  }, []);
+
+  const executeCommand = (commandId: string, mode: CommandPaletteExecuteMode) => {
+    const api = commandId as OneBotHttpApiPath;
+    const item = oneBotHttpApi[api];
+    const body = item?.request ? generateDefaultJson(item.request) : '{}';
+
+    handleSelectApi(api);
+    // 确保请求参数可见
+    const ref = debugRefs.current.get(api);
+    if (ref) {
+      if (mode === 'send') ref.sendWithBody(body);
+      else ref.setRequestBody(body);
+      return;
     }
+    // 若还没挂载，延迟执行
+    if (mode === 'send') setPendingRun({ path: api, body });
   };
 
   const handleCloseTab = (e: React.MouseEvent, apiToRemove: OneBotHttpApiPath) => {
@@ -76,9 +127,6 @@ export default function HttpDebug () {
 
     if (activeApi === apiToRemove) {
       if (newOpenApis.length > 0) {
-        // Switch to the last opened tab or the previous one? 
-        // Usually the one to the right or left. Let's pick the last one for simplicity or neighbor.
-        // Finding index of removed api to pick neighbor is better UX, but last one is acceptable.
         setActiveApi(newOpenApis[newOpenApis.length - 1]);
       } else {
         setActiveApi(null);
@@ -89,50 +137,24 @@ export default function HttpDebug () {
   return (
     <>
       <title>HTTP调试 - NapCat WebUI</title>
-      <div className='h-[calc(100vh-3.5rem)] p-0 md:p-4'>
+      <div className='h-[calc(100vh-3.5rem)] pt-2 px-0 md:px-4'>
         <div className={clsx(
           'h-full flex flex-col overflow-hidden transition-all relative',
-          'rounded-none md:rounded-2xl',
-          hasBackground
-            ? 'bg-white/5 dark:bg-black/5 backdrop-blur-sm'
-            : 'bg-white/20 dark:bg-black/10 backdrop-blur-sm shadow-sm'
+          // 'rounded-none md:rounded-2xl border', // Removing the main border/radius
+          // hasBackground
+          //   ? 'bg-white/5 dark:bg-black/5 backdrop-blur-sm border-white/10'
+          //   : 'bg-white/40 dark:bg-black/20 backdrop-blur-md shadow-sm border-white/40 dark:border-white/10'
+          'bg-transparent'
         )}>
-          {/* Unifed Header */}
-          <div className='h-12 border-b border-white/10 flex items-center justify-between px-4 z-50 bg-white/5 flex-shrink-0'>
-            <div className='flex items-center gap-3'>
-              <Button
-                isIconOnly
-                size="sm"
-                variant="light"
-                className={clsx(
-                  "opacity-50 hover:opacity-100 transition-all",
-                  openSideBar && "text-primary opacity-100"
-                )}
-                onPress={() => setOpenSideBar(!openSideBar)}
-              >
-                <TbSquareRoundedChevronLeftFilled className={clsx("text-lg transform transition-transform", !openSideBar && "rotate-180")} />
-              </Button>
-              <h1 className={clsx(
-                'text-sm font-bold tracking-tight',
-                hasBackground ? 'text-white/80' : 'text-default-700 dark:text-gray-200'
-              )}>接口调试</h1>
-            </div>
-          </div>
-
-          <div className='flex-1 flex flex-row overflow-hidden relative'>
-            <OneBotApiNavList
-              data={oneBotHttpApi}
-              selectedApi={activeApi || '' as any}
-              onSelect={handleSelectApi}
-              openSideBar={openSideBar}
-              onToggle={setOpenSideBar}
-            />
-
-            <div
-              className='flex-1 h-full overflow-hidden flex flex-col relative'
-            >
-              {/* Tab Bar */}
-              <div className='flex items-center w-full overflow-x-auto no-scrollbar border-b border-white/5 bg-white/5 flex-shrink-0'>
+          <div className='flex-1 flex flex-col overflow-hidden relative'>
+            <div className={clsx(
+              'flex items-center w-full flex-shrink-0 pr-2 md:pl-4 py-1 relative z-20 rounded-md',
+              hasBackground
+                ? 'bg-white/5'
+                : 'bg-white/30 dark:bg-white/5'
+            )}>
+              {/* Tab List */}
+              <div className="flex-1 overflow-x-auto no-scrollbar flex items-center">
                 {openApis.map((api) => {
                   const isActive = api === activeApi;
                   const item = oneBotHttpApi[api];
@@ -141,21 +163,26 @@ export default function HttpDebug () {
                       key={api}
                       onClick={() => setActiveApi(api)}
                       className={clsx(
-                        'group flex items-center gap-2 px-4 h-9 cursor-pointer border-r border-white/5 select-none transition-all min-w-[120px] max-w-[200px]',
+                        'group flex items-center gap-2 px-3 h-8 my-1 mr-1 rounded-md cursor-pointer border select-none transition-all min-w-[120px] max-w-[260px]',
+                        hasBackground ? 'border-transparent hover:bg-white/10' : 'border-transparent hover:bg-white/10 dark:hover:bg-white/5',
                         isActive
-                          ? (hasBackground ? 'bg-white/10 text-white' : 'bg-white/40 dark:bg-white/5 text-primary font-medium')
-                          : 'opacity-50 hover:opacity-100 hover:bg-white/5'
+                          ? (hasBackground
+                            ? 'bg-white/15 text-white border-white/20'
+                            : 'bg-default-100 dark:bg-white/15 text-foreground dark:text-white font-medium shadow-sm border-default-200 dark:border-white/10')
+                          : (hasBackground ? 'text-white/70 hover:text-white' : 'text-default-600 dark:text-white/70 hover:text-default-900 dark:hover:text-white')
                       )}
                     >
                       <span className={clsx(
-                        'text-[10px] font-bold uppercase tracking-wider',
-                        isActive ? 'opacity-100' : 'opacity-50'
+                        'text-[10px] font-bold uppercase tracking-wider px-1.5 py-0.5 rounded-sm',
+                        isActive
+                          ? 'bg-success/20 text-success'
+                          : 'opacity-60 bg-default-200/50 dark:bg-white/10'
                       )}>POST</span>
                       <span className='text-xs truncate flex-1'>{item?.description || api}</span>
                       <div
                         className={clsx(
-                          'p-0.5 rounded-full hover:bg-black/10 dark:hover:bg-white/20 transition-opacity',
-                          isActive ? 'opacity-50 hover:opacity-100' : 'opacity-0 group-hover:opacity-50'
+                          'p-0.5 rounded-sm hover:bg-black/10 dark:hover:bg-white/20 transition-opacity',
+                          isActive ? 'opacity-40 hover:opacity-100' : 'opacity-0 group-hover:opacity-40'
                         )}
                         onClick={(e) => handleCloseTab(e, api)}
                       >
@@ -163,37 +190,67 @@ export default function HttpDebug () {
                       </div>
                     </div>
                   );
+
                 })}
               </div>
 
-              {/* Content Panels */}
-              <div className='flex-1 relative overflow-hidden'>
-                {activeApi === null && (
-                  <div className='h-full flex items-center justify-center text-default-400 text-sm opacity-50 select-none'>
-                    选择一个接口开始调试
-                  </div>
-                )}
-
-                {openApis.map((api) => (
-                  <div
-                    key={api}
-                    className={clsx(
-                      'h-full w-full absolute top-0 left-0 transition-opacity duration-200',
-                      api === activeApi ? 'opacity-100 z-10' : 'opacity-0 z-0 pointer-events-none'
-                    )}
-                  >
-                    <OneBotApiDebug
-                      path={api}
-                      data={oneBotHttpApi[api]}
-                      adapterName={adapterName}
-                    />
-                  </div>
-                ))}
+              {/* Actions */}
+              <div className='flex items-center gap-2 pl-2 border-l border-white/5 flex-shrink-0'>
+                <Button
+                  isIconOnly
+                  size='sm'
+                  radius='sm'
+                  variant='light'
+                  className='text-default-500 hover:text-primary w-10 h-10 min-w-10'
+                  onClick={() => setPaletteOpen(true)}
+                  onPress={() => setPaletteOpen(true)}
+                >
+                  <TbSearch size={18} />
+                </Button>
               </div>
             </div>
+
+            {/* Content Panels */}
+            <div className='flex-1 relative overflow-hidden'>
+              {activeApi === null && (
+                <div className='h-full flex items-center justify-center text-default-400 text-sm opacity-50 select-none'>
+                  使用命令面板选择接口（Ctrl/Cmd + K）
+                </div>
+              )}
+
+              {openApis.map((api) => (
+                <div
+                  key={api}
+                  className={clsx(
+                    'h-full w-full absolute top-0 left-0 transition-opacity duration-200',
+                    api === activeApi ? 'opacity-100 z-10' : 'opacity-0 z-0 pointer-events-none'
+                  )}
+                >
+                  <OneBotApiDebug
+                    ref={(node) => {
+                      if (!node) {
+                        debugRefs.current.delete(api);
+                        return;
+                      }
+                      debugRefs.current.set(api, node);
+                    }}
+                    path={api}
+                    data={oneBotHttpApi[api]}
+                    adapterName={adapterName}
+                  />
+                </div>
+              ))}
+            </div>
           </div>
         </div>
       </div>
+
+      <CommandPalette
+        isOpen={paletteOpen}
+        onOpenChange={setPaletteOpen}
+        commands={commands}
+        onExecute={executeCommand}
+      />
     </>
   );
 }

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

@@ -16,14 +16,39 @@ import type { QQItem } from '@/components/quick_login';
 import { ThemeSwitch } from '@/components/theme-switch';
 
 import QQManager from '@/controllers/qq_manager';
+import useDialog from '@/hooks/use-dialog';
 import PureLayout from '@/layouts/pure';
 import { motion } from 'motion/react';
 
+const parseLoginError = (errorStr: string) => {
+  if (errorStr.startsWith('登录失败: ')) {
+    const jsonPart = errorStr.substring('登录失败: '.length);
+
+    try {
+      const parsed = JSON.parse(jsonPart);
+
+      if (Array.isArray(parsed) && parsed[1]) {
+        const info = parsed[1];
+        const codeStr = info.serverErrorCode ? ` (错误码: ${info.serverErrorCode})` : '';
+
+        return `${info.message || errorStr}${codeStr}`;
+      }
+    } catch (e) {
+      // 忽略解析错误
+    }
+  }
+
+  return errorStr;
+};
+
 export default function QQLoginPage () {
   const navigate = useNavigate();
+  const dialog = useDialog();
   const [uinValue, setUinValue] = useState<string>('');
   const [isLoading, setIsLoading] = useState<boolean>(false);
   const [qrcode, setQrcode] = useState<string>('');
+  const [loginError, setLoginError] = useState<string>('');
+  const lastErrorRef = useRef<string>('');
   const [qqList, setQQList] = useState<(QQItem | LoginListItem)[]>([]);
   const [refresh, setRefresh] = useState<boolean>(false);
   const firstLoad = useRef<boolean>(true);
@@ -61,6 +86,20 @@ export default function QQLoginPage () {
         navigate('/', { replace: true });
       } else {
         setQrcode(data.qrcodeurl);
+        if (data.loginError && data.loginError !== lastErrorRef.current) {
+          lastErrorRef.current = data.loginError;
+          setLoginError(data.loginError);
+          const friendlyMsg = parseLoginError(data.loginError);
+
+          dialog.alert({
+            title: '登录失败',
+            content: friendlyMsg,
+            confirmText: '确定',
+          });
+        } else if (!data.loginError) {
+          lastErrorRef.current = '';
+          setLoginError('');
+        }
       }
     } catch (error) {
       const msg = (error as Error).message;
@@ -99,6 +138,18 @@ export default function QQLoginPage () {
     setUinValue(e.target.value);
   };
 
+  const onRefreshQRCode = async () => {
+    try {
+      lastErrorRef.current = '';
+      setLoginError('');
+      await QQManager.refreshQRCode();
+      toast.success('已发送刷新请求');
+    } catch (error) {
+      const msg = (error as Error).message;
+      toast.error(`刷新二维码失败: ${msg}`);
+    }
+  };
+
   useEffect(() => {
     const timer = setInterval(() => {
       onUpdateQrCode();
@@ -159,7 +210,11 @@ export default function QQLoginPage () {
                   />
                 </Tab>
                 <Tab key='qrcode' title='扫码登录'>
-                  <QrCodeLogin qrcode={qrcode} />
+                  <QrCodeLogin
+                    loginError={parseLoginError(loginError)}
+                    qrcode={qrcode}
+                    onRefresh={onRefreshQRCode}
+                  />
                 </Tab>
               </Tabs>
               <Button

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

@@ -0,0 +1,35 @@
+import QQManager from '@/controllers/qq_manager';
+
+/**
+ * 轮询等待后端进程恢复
+ * @param maxWaitTime 最大等待时间，单位毫秒
+ * @param onSuccess 成功回调
+ * @param onTimeout 超时回调
+ */
+export async function waitForBackendReady (
+  maxWaitTime: number = 15000,
+  onSuccess?: () => void,
+  onTimeout?: () => void
+): Promise<boolean> {
+  const startTime = Date.now();
+
+  return new Promise<boolean>((resolve) => {
+    const timer = setInterval(async () => {
+      try {
+        // 尝试请求后端，设置一个较短的请求超时避免挂起
+        await QQManager.getQQLoginInfo({ timeout: 500 });
+        // 如果能走到这一步说明请求成功了
+        clearInterval(timer);
+        onSuccess?.();
+        resolve(true);
+      } catch (_e) {
+        // 如果请求失败（后端没起来），检查是否超时
+        if (Date.now() - startTime > maxWaitTime) {
+          clearInterval(timer);
+          onTimeout?.();
+          resolve(false);
+        }
+      }
+    }, 500); // 每 500ms 探测一次
+  });
+}

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

@@ -3,24 +3,27 @@ import { request } from './request';
 const style = document.createElement('style');
 document.head.appendChild(style);
 
-// 字体样式标签
-const fontStyle = document.createElement('style');
-fontStyle.id = 'dynamic-font-style';
-document.head.appendChild(fontStyle);
+// 用于主题配置页面实时预览字体的临时样式标签
+const fontPreviewStyle = document.createElement('style');
+fontPreviewStyle.id = 'font-preview-style';
+document.head.appendChild(fontPreviewStyle);
 
 export function loadTheme () {
   request('/files/theme.css?_t=' + Date.now())
     .then((res) => res.data)
     .then((css) => {
       style.innerHTML = css;
+      // 清除预览样式，使用 theme.css 中的正式配置
+      fontPreviewStyle.innerHTML = '';
+      document.documentElement.style.removeProperty('--font-family-base');
     })
     .catch(() => {
       console.error('Failed to load theme.css');
     });
 }
 
-// 动态加载字体 CSS
-const loadFontCSS = (mode: string) => {
+// 动态加载字体 CSS（用于预览）
+const loadFontCSSForPreview = (mode: string) => {
   let css = '';
 
   if (mode === 'aacute') {
@@ -39,7 +42,7 @@ const loadFontCSS = (mode: string) => {
 }`;
   }
 
-  fontStyle.innerHTML = css;
+  fontPreviewStyle.innerHTML = css;
 };
 
 export const colorKeys = [
@@ -168,11 +171,12 @@ export const generateTheme = (theme: ThemeConfig, validField?: string) => {
   return css;
 };
 
+// 用于主题配置页面实时预览字体
 export const applyFont = (mode: string) => {
   const root = document.documentElement;
 
-  // 先加载字体 CSS
-  loadFontCSS(mode);
+  // 加载字体 CSS 用于预览
+  loadFontCSSForPreview(mode);
 
   if (mode === 'aacute') {
     root.style.setProperty('--font-family-base', "'Aa偷吃可爱长大的', var(--font-family-fallbacks)", 'important');
@@ -184,36 +188,13 @@ export const applyFont = (mode: string) => {
   }
 };
 
-const FONT_MODE_CACHE_KEY = 'webui-font-mode-cache';
-
+// 字体配置已通过 theme.css 加载，此函数仅用于兼容性保留
 export const initFont = () => {
-  // 先从缓存读取，立即应用
-  const cached = localStorage.getItem(FONT_MODE_CACHE_KEY);
-  if (cached) {
-    applyFont(cached);
-  } else {
-    // 默认使用系统字体
-    applyFont('system');
-  }
-
-  // 后台拉取最新配置并更新缓存
-  request('/api/base/Theme')
-    .then((res) => {
-      const data = res.data as { data: ThemeConfig; };
-      const fontMode = data?.data?.fontMode || 'system';
-      // 更新缓存
-      localStorage.setItem(FONT_MODE_CACHE_KEY, fontMode);
-      // 如果与当前不同，则应用新字体
-      if (fontMode !== cached) {
-        applyFont(fontMode);
-      }
-    })
-    .catch((e) => {
-      console.error('Failed to fetch font config', e);
-    });
+  // 字体现在由 theme.css 统一管理，无需单独初始化
 };
 
-// 保存时更新缓存
-export const updateFontCache = (fontMode: string) => {
-  localStorage.setItem(FONT_MODE_CACHE_KEY, fontMode);
+// 保存主题后调用 loadTheme 会使用 theme.css 中的正式配置
+// 此函数保留用于兼容性
+export const updateFontCache = (_fontMode: string) => {
+  // 不再需要缓存，字体配置已在 theme.css 中
 };

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

@@ -1,6 +1,6 @@
 import react from '@vitejs/plugin-react';
 import { defineConfig, loadEnv } from 'vite';
-import viteCompression from 'vite-plugin-compression';
+// import viteCompression from 'vite-plugin-compression';
 import { ViteImageOptimizer } from 'vite-plugin-image-optimizer';
 import tsconfigPaths from 'vite-tsconfig-paths';
 
@@ -13,7 +13,7 @@ export default defineConfig(({ mode }) => {
     plugins: [
       react(),
       tsconfigPaths(),
-      ViteImageOptimizer({})
+      ViteImageOptimizer({}),
     ],
     base: '/webui/',
     server: {

pnpm-lock.yaml

@@ -11,9 +11,6 @@ importers:
       express:
         specifier: ^5.0.0
         version: 5.1.0
-      silk-wasm:
-        specifier: ^3.6.1
-        version: 3.7.1
       ws:
         specifier: ^8.18.3
         version: 8.18.3
@@ -54,9 +51,6 @@ importers:
       file-type:
         specifier: ^21.0.0
         version: 21.1.0
-      silk-wasm:
-        specifier: ^3.6.1
-        version: 3.7.1
     devDependencies:
       '@types/node':
         specifier: ^22.0.1
@@ -5973,10 +5967,6 @@ packages:
     resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
     engines: {node: '>=14'}
 
-  silk-wasm@3.7.1:
-    resolution: {integrity: sha512-mXPwLRtZxrYV3TZx41jMAeKc80wvmyrcXIcs8HctFxK15Ahz2OJQENYhNgEPeCEOdI6Mbx1NxQsqxzwc3DKerw==}
-    engines: {node: '>=16.11.0'}
-
   simple-concat@1.0.1:
     resolution: {integrity: sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==}
 
@@ -13291,8 +13281,6 @@ snapshots:
 
   signal-exit@4.1.0: {}
 
-  silk-wasm@3.7.1: {}
-
   simple-concat@1.0.1: {}
 
   simple-get@4.0.1: