Update release workflow

Updates the release workflow to download and include NapCat.Shell.Windows.OneKey.zip in the release artifacts.

.env.framework

@@ -1,2 +0,0 @@
-VITE_BUILD_TYPE = Production
-VITE_BUILD_PLATFORM = Framework

.env.shell

@@ -1,2 +0,0 @@
-VITE_BUILD_TYPE = Production
-VITE_BUILD_PLATFORM = Shell

.env.shell-analysis

@@ -1,2 +0,0 @@
-VITE_BUILD_TYPE = DEBUG
-VITE_BUILD_PLATFORM = Shell

.env.universal

@@ -1,2 +0,0 @@
-VITE_BUILD_TYPE = Production
-VITE_BUILD_PLATFORM = Universal

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,6 +1,6 @@
 name: Bug 反馈
 description: 报告可能的 NapCat 异常行为
-title: '[BUG] '
+title: "[BUG] "
 labels: bug
 body:
   - type: markdown
@@ -10,6 +10,10 @@ body:
         在提交新的 Bug 反馈前，请确保您：
         * 已经搜索了现有的 issues，并且没有找到可以解决您问题的方法
         * 不与现有的某一 issue 重复
+        * **不接受因发送不当内容而导致的问题报告**
+          - 包括但不限于：多媒体发送失败、转发消息失败、消息被拦截等因 18+ 内容、违规内容或触发风控的问题
+          - 提交 issue 前，请确认您发送的多媒体内容、链接、文本等均为正常合规内容，不会触发平台风控机制
+          - 因违规内容导致的问题，一律不予受理
   - type: input
     id: system-version
     attributes:
@@ -30,7 +34,7 @@ body:
     id: napcat-version
     attributes:
       label: NapCat 版本
-      description: 可在 LiteLoaderQQNT 的设置页或是 QQNT 的设置页侧栏中找到
+      description: 可在 WebUI 的「系统信息」页中找到
       placeholder: 1.0.0
     validations:
       required: true

.github/ISSUE_TEMPLATE/feat_request.yml

@@ -0,0 +1,60 @@
+name: Feat 请求
+description: 提交新的 NapCat 功能或改进建议
+title: '[FEAT] '
+labels: enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        欢迎来到 NapCat 的 Issue Tracker！请填写以下表格来提交功能请求。
+        在提交新的功能请求前，请确保您：
+        * 已经搜索了现有的 issues，并且没有找到类似的建议
+        * 不与现有的某一 issue 重复
+  - type: input
+    id: system-version
+    attributes:
+      label: 系统版本
+      description: 运行 QQNT 的系统版本
+      placeholder: Windows 11 24H2
+    validations:
+      required: true
+  - type: input
+    id: qqnt-version
+    attributes:
+      label: QQNT 版本
+      description: 可在 QQNT 的「关于」的设置页中找到
+      placeholder: 9.9.16-29927
+    validations:
+      required: true
+  - type: input
+    id: napcat-version
+    attributes:
+      label: NapCat 版本
+      description: 可在 WebUI 的「系统信息」页中找到
+      placeholder: 1.0.0
+    validations:
+      required: true
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: 功能描述
+      description: 请详细描述你希望添加的功能或改进
+    validations:
+      required: true
+  - type: textarea
+    id: feature-reason
+    attributes:
+      label: 需求背景与理由
+      description: 请说明为什么需要这个功能，解决了什么问题
+    validations:
+      required: true
+  - type: textarea
+    id: feature-expected
+    attributes:
+      label: 期望的实现方式或效果
+      description: 请描述你期望的功能实现方式或最终效果
+  - type: textarea
+    id: other-info
+    attributes:
+      label: 其他补充信息
+      description: 你还想补充什么？

.github/prompt/default.md

@@ -0,0 +1,43 @@
+# {VERSION}
+[使用文档](https://napneko.github.io/)
+
+## Windows 一键包
+我们为提供了的轻量化一键部署方案
+相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考
+
+你可以下载 
+
+NapCat.Shell.Windows.OneKey.zip (无头)
+
+启动后可自动化部署一键包,教程参考使用文档安装部分
+
+## 警告
+**注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本**
+**默认WebUi密钥为随机密码 控制台查看**
+
+**[9.9.22-40990 X64 Win](https://dldir1v6.qq.com/qqfile/qq/QQNT/2c9d3f6c/QQ9.9.22.40990_x64.exe)**
+[LinuxX64 DEB 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_amd64.deb)
+[LinuxX64 RPM 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_x86_64.rpm)
+[LinuxArm64 DEB 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_arm64.deb)
+[LinuxArm64 RPM  40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_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

@@ -0,0 +1,111 @@
+# NapCat Release Note Generator
+
+你是 NapCat 项目的发布说明生成器。请根据提供的 commit 列表生成标准格式的发布说明。
+
+## 核心规则
+
+1. **版本号**：第一行必须是 `# {VERSION}`，使用用户提供的版本号，如果版本号是小写 v 开头（如 v4.10.2），必须转换为大写 V（如 V4.10.2）
+2. **语言**：全部使用简体中文
+3. **格式**：严格按照下方模板输出，不要添加额外的 markdown 格式
+
+## Commit 分析规则
+
+将 commit 分类为以下类型：
+- 🐛 **修复**：bug fix、修复、fix 相关
+- ✨ **新增**：新功能、feat、add 相关  
+- 🔧 **优化**：优化、重构、refactor、improve、perf 相关
+- 📦 **依赖**：deps、依赖更新（通常可以忽略或合并）
+- 🔨 **构建**：ci、build、workflow 相关（通常可以忽略）
+
+## 合并和筛选
+
+- **合并相似项**：同一功能的多个 commit 合并为一条
+- **忽略琐碎项**：合并冲突、格式化、typo 等可忽略
+- **控制数量**：最终保持 5-15 条更新要点
+- **保留 commit hash**：每条末尾附上短 hash，格式 `(a1b2c3d)`
+
+## 输出模板 - 必须严格遵守以下格式
+
+```
+# {VERSION}
+[使用文档](https://napneko.github.io/)
+
+## Windows 一键包
+我们为提供了的轻量化一键部署方案
+相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考
+
+你可以下载 
+
+NapCat.Shell.Windows.OneKey.zip (无头)
+
+启动后可自动化部署一键包,教程参考使用文档安装部分
+
+## 警告
+**注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本**
+**默认WebUi密钥为随机密码 控制台查看**
+
+**[9.9.22-40990 X64 Win](https://dldir1v6.qq.com/qqfile/qq/QQNT/2c9d3f6c/QQ9.9.22.40990_x64.exe)**
+[LinuxX64 DEB 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_amd64.deb)
+[LinuxX64 RPM 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_x86_64.rpm)
+[LinuxArm64 DEB 40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_arm64.deb)
+[LinuxArm64 RPM  40990 ](https://dldir1.qq.com/qqfile/qq/QQNT/ec800879/linuxqq_3.2.20-40990_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)
+2. 修复 yyy 崩溃 (b2c3d4e)
+
+### ✨ 新增
+1. 新增 xxx 功能 (c3d4e5f)
+2. 支持 yyy 特性 (d4e5f6g)
+
+### 🔧 优化
+1. 优化 xxx 性能 (e5f6g7h)
+2. 重构 yyy 模块 (f6g7h8i)
+
+---
+
+**完整更新日志**: [{PREV_VERSION}...{VERSION}](https://github.com/NapNeko/NapCatQQ/compare/{PREV_VERSION}...{VERSION})
+```
+
+**格式要求 - 务必严格遵守：**
+- "Windows 一键包"部分的文本必须完全一致，不要修改任何措辞
+- "警告"部分必须包含所有 QQ 版本下载链接，保持原有格式
+- "如果WinX64缺少运行库或者xxx.dll？"这一行必须保持原样
+- QQ 版本号和下载链接保持不变（40990 版本）
+- 只有"## 更新"部分下面的内容需要根据实际 commit 生成
+
+## 重要约束
+
+1. 如果某个分类没有内容，则完全省略该分类
+2. 不要编造不存在的更新
+3. 保持简洁，每条更新控制在一行内
+4. 使用用户友好的语言，避免过于技术化的描述
+5. 重大变更（Breaking Changes）需要在注意事项中加粗提示
+
+## 文件变化分析
+
+用户会提供文件变化统计和具体代码diff，帮助你理解变更内容：
+
+### 目录含义
+- `packages/napcat-core/` → 核心功能、消息处理、QQ接口
+- `packages/napcat-onebot/` → OneBot 协议实现、API、事件
+- `packages/napcat-webui-backend/` → WebUI 后端接口
+- `packages/napcat-webui-frontend/` → WebUI 前端界面
+- `packages/napcat-shell/` → Shell 启动器
+
+### 代码diff阅读指南
+- `+` 开头的行是新增代码
+- `-` 开头的行是删除代码
+- 关注函数名、类名的变化来理解功能变更
+- 关注 `fix`、`bug`、`error` 等关键词识别修复项
+- 关注 `add`、`new`、`feature` 等关键词识别新功能
+- 忽略纯重构（代码移动但功能不变）和格式化变更
+
+### 截断说明
+- 如果看到 `[... 已截断 ...]`，表示内容过长被截断
+- 根据已有信息推断完整变更意图即可

.github/scripts/lib/comment.ts

@@ -0,0 +1,231 @@
+/**
+ * 构建状态评论模板
+ */
+
+export const COMMENT_MARKER = '<!-- napcat-pr-build -->';
+
+export type BuildStatus = 'success' | 'failure' | 'cancelled' | 'pending' | 'unknown';
+
+export interface BuildTarget {
+  name: string;
+  status: BuildStatus;
+  error?: string;
+  downloadUrl?: string;  // Artifact 直接下载链接
+}
+
+// ============== 辅助函数 ==============
+
+function formatSha (sha: string): string {
+  return sha && sha.length >= 7 ? sha.substring(0, 7) : sha || 'unknown';
+}
+
+function escapeCodeBlock (text: string): string {
+  // 替换 ``` 为转义形式，避免破坏 Markdown 代码块
+  return text.replace(/```/g, '\\`\\`\\`');
+}
+
+function getTimeString (): string {
+  return new Date().toISOString().replace('T', ' ').substring(0, 19) + ' UTC';
+}
+
+// ============== 状态图标 ==============
+
+export function getStatusIcon (status: BuildStatus): string {
+  switch (status) {
+    case 'success':
+      return '✅ 成功';
+    case 'pending':
+      return '⏳ 构建中...';
+    case 'cancelled':
+      return '⚪ 已取消';
+    case 'failure':
+      return '❌ 失败';
+    default:
+      return '❓ 未知';
+  }
+}
+
+function getStatusEmoji (status: BuildStatus): string {
+  switch (status) {
+    case 'success': return '✅';
+    case 'pending': return '⏳';
+    case 'cancelled': return '⚪';
+    case 'failure': return '❌';
+    default: return '❓';
+  }
+}
+
+// ============== 构建中评论 ==============
+
+export function generateBuildingComment (prSha: string, targets: string[]): string {
+  const time = getTimeString();
+  const shortSha = formatSha(prSha);
+
+  const lines: string[] = [
+    COMMENT_MARKER,
+    '',
+    '<div align="center">',
+    '',
+    '# 🔨 NapCat 构建中',
+    '',
+    '![Building](https://img.shields.io/badge/状态-构建中-yellow?style=for-the-badge&logo=github-actions&logoColor=white)',
+    '',
+    '</div>',
+    '',
+    '---',
+    '',
+    '## 📦 构建目标',
+    '',
+    '| 包名 | 状态 | 说明 |',
+    '| :--- | :---: | :--- |',
+    ...targets.map(name => `| \`${name}\` | ⏳ | 正在构建... |`),
+    '',
+    '---',
+    '',
+    '## 📋 构建信息',
+    '',
+    `| 项目 | 值 |`,
+    `| :--- | :--- |`,
+    `| 📝 提交 | \`${shortSha}\` |`,
+    `| 🕐 开始时间 | ${time} |`,
+    '',
+    '---',
+    '',
+    '<div align="center">',
+    '',
+    '> ⏳ **构建进行中，请稍候...**',
+    '>',
+    '> 构建完成后将自动更新此评论',
+    '',
+    '</div>',
+  ];
+
+  return lines.join('\n');
+}
+
+// ============== 构建结果评论 ==============
+
+export function generateResultComment (
+  targets: BuildTarget[],
+  prSha: string,
+  runId: string,
+  repository: string,
+  version?: string
+): string {
+  const runUrl = `https://github.com/${repository}/actions/runs/${runId}`;
+  const shortSha = formatSha(prSha);
+  const time = getTimeString();
+
+  const allSuccess = targets.every(t => t.status === 'success');
+  const anyCancelled = targets.some(t => t.status === 'cancelled');
+  const anyFailure = targets.some(t => t.status === 'failure');
+
+  // 状态徽章
+  let statusBadge: string;
+  let headerTitle: string;
+  if (allSuccess) {
+    statusBadge = '![Success](https://img.shields.io/badge/状态-构建成功-success?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ✅ NapCat 构建成功';
+  } else if (anyCancelled && !anyFailure) {
+    statusBadge = '![Cancelled](https://img.shields.io/badge/状态-已取消-lightgrey?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ⚪ NapCat 构建已取消';
+  } else {
+    statusBadge = '![Failed](https://img.shields.io/badge/状态-构建失败-critical?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ❌ NapCat 构建失败';
+  }
+
+  const downloadLink = (target: BuildTarget) => {
+    if (target.status !== 'success') return '—';
+    if (target.downloadUrl) {
+      return `[📥 下载](${target.downloadUrl})`;
+    }
+    return `[📥 下载](${runUrl}#artifacts)`;
+  };
+
+  const lines: string[] = [
+    COMMENT_MARKER,
+    '',
+    '<div align="center">',
+    '',
+    headerTitle,
+    '',
+    statusBadge,
+    '',
+    '</div>',
+    '',
+    '---',
+    '',
+    '## 📦 构建产物',
+    '',
+    '| 包名 | 状态 | 下载 |',
+    '| :--- | :---: | :---: |',
+    ...targets.map(t => `| \`${t.name}\` | ${getStatusEmoji(t.status)} ${t.status === 'success' ? '成功' : t.status === 'failure' ? '失败' : t.status === 'cancelled' ? '已取消' : '未知'} | ${downloadLink(t)} |`),
+    '',
+    '---',
+    '',
+    '## 📋 构建信息',
+    '',
+    `| 项目 | 值 |`,
+    `| :--- | :--- |`,
+    ...(version ? [`| 🏷️ 版本号 | \`${version}\` |`] : []),
+    `| 📝 提交 | \`${shortSha}\` |`,
+    `| 🔗 构建日志 | [查看详情](${runUrl}) |`,
+    `| 🕐 完成时间 | ${time} |`,
+  ];
+
+  // 添加错误详情
+  const failedTargets = targets.filter(t => t.status === 'failure' && t.error);
+  if (failedTargets.length > 0) {
+    lines.push('', '---', '', '## ⚠️ 错误详情', '');
+    for (const target of failedTargets) {
+      lines.push(
+        `<details>`,
+        `<summary>🔴 <b>${target.name}</b> 构建错误</summary>`,
+        '',
+        '```',
+        escapeCodeBlock(target.error!),
+        '```',
+        '',
+        '</details>',
+        ''
+      );
+    }
+  }
+
+  // 添加底部提示
+  lines.push('---', '');
+  if (allSuccess) {
+    lines.push(
+      '<div align="center">',
+      '',
+      '> 🎉 **所有构建均已成功完成！**',
+      '>',
+      '> 点击上方下载链接获取构建产物进行测试',
+      '',
+      '</div>'
+    );
+  } else if (anyCancelled && !anyFailure) {
+    lines.push(
+      '<div align="center">',
+      '',
+      '> ⚪ **构建已被取消**',
+      '>',
+      '> 可能是由于新的提交触发了新的构建',
+      '',
+      '</div>'
+    );
+  } else {
+    lines.push(
+      '<div align="center">',
+      '',
+      '> ⚠️ **部分构建失败**',
+      '>',
+      '> 请查看上方错误详情或点击构建日志查看完整输出',
+      '',
+      '</div>'
+    );
+  }
+
+  return lines.join('\n');
+}
+

.github/scripts/lib/github.ts

@@ -0,0 +1,189 @@
+/**
+ * GitHub API 工具库
+ */
+
+import { appendFileSync } from 'node:fs';
+
+// ============== 类型定义 ==============
+
+export interface PullRequest {
+  number: number;
+  state: string;
+  head: {
+    sha: string;
+    ref: string;
+    repo: {
+      full_name: string;
+    };
+  };
+}
+
+export interface Repository {
+  owner: {
+    type: string;
+  };
+}
+
+export interface Artifact {
+  id: number;
+  name: string;
+  size_in_bytes: number;
+  archive_download_url: string;
+}
+
+// ============== GitHub API Client ==========================
+
+export class GitHubAPI {
+  private token: string;
+  private baseUrl = 'https://api.github.com';
+
+  constructor (token: string) {
+    this.token = token;
+  }
+
+  private async request<T> (endpoint: string, options: RequestInit = {}): Promise<T> {
+    const response = await fetch(`${this.baseUrl}${endpoint}`, {
+      ...options,
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        ...options.headers,
+      },
+    });
+
+    if (!response.ok) {
+      throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  async getPullRequest (owner: string, repo: string, pullNumber: number): Promise<PullRequest> {
+    return this.request<PullRequest>(`/repos/${owner}/${repo}/pulls/${pullNumber}`);
+  }
+
+  async getCollaboratorPermission (owner: string, repo: string, username: string): Promise<string> {
+    const data = await this.request<{ permission: string; }>(
+      `/repos/${owner}/${repo}/collaborators/${username}/permission`
+    );
+    return data.permission;
+  }
+
+  async getRepository (owner: string, repo: string): Promise<Repository> {
+    return this.request(`/repos/${owner}/${repo}`);
+  }
+
+  async checkOrgMembership (org: string, username: string): Promise<boolean> {
+    try {
+      await this.request(`/orgs/${org}/members/${username}`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async getRunArtifacts (owner: string, repo: string, runId: string): Promise<Artifact[]> {
+    const data = await this.request<{ artifacts: Artifact[]; }>(
+      `/repos/${owner}/${repo}/actions/runs/${runId}/artifacts`
+    );
+    return data.artifacts;
+  }
+
+  async createComment (owner: string, repo: string, issueNumber: number, body: string): Promise<void> {
+    await this.request(`/repos/${owner}/${repo}/issues/${issueNumber}/comments`, {
+      method: 'POST',
+      body: JSON.stringify({ body }),
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  async findComment (owner: string, repo: string, issueNumber: number, marker: string): Promise<number | null> {
+    let page = 1;
+    const perPage = 100;
+
+    while (page <= 10) { // 最多检查 1000 条评论
+      const comments = await this.request<Array<{ id: number, body: string; }>>(
+        `/repos/${owner}/${repo}/issues/${issueNumber}/comments?per_page=${perPage}&page=${page}`
+      );
+
+      if (comments.length === 0) {
+        return null;
+      }
+
+      const found = comments.find(c => c.body.includes(marker));
+      if (found) {
+        return found.id;
+      }
+
+      if (comments.length < perPage) {
+        return null;
+      }
+
+      page++;
+    }
+
+    return null;
+  }
+
+  async updateComment (owner: string, repo: string, commentId: number, body: string): Promise<void> {
+    await this.request(`/repos/${owner}/${repo}/issues/comments/${commentId}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ body }),
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }
+
+  async createOrUpdateComment (
+    owner: string,
+    repo: string,
+    issueNumber: number,
+    body: string,
+    marker: string
+  ): Promise<void> {
+    const existingId = await this.findComment(owner, repo, issueNumber, marker);
+    if (existingId) {
+      await this.updateComment(owner, repo, existingId, body);
+      console.log(`✓ Updated comment #${existingId}`);
+    } else {
+      await this.createComment(owner, repo, issueNumber, body);
+      console.log('✓ Created new comment');
+    }
+  }
+}
+
+// ============== Output 工具 ==============
+
+export function setOutput (name: string, value: string): void {
+  const outputFile = process.env.GITHUB_OUTPUT;
+  if (outputFile) {
+    appendFileSync(outputFile, `${name}=${value}\n`);
+  }
+  console.log(`  ${name}=${value}`);
+}
+
+export function setMultilineOutput (name: string, value: string): void {
+  const outputFile = process.env.GITHUB_OUTPUT;
+  if (outputFile) {
+    const delimiter = `EOF_${Date.now()}`;
+    appendFileSync(outputFile, `${name}<<${delimiter}\n${value}\n${delimiter}\n`);
+  }
+}
+
+// ============== 环境变量工具 ==============
+
+export function getEnv (name: string, required: true): string;
+export function getEnv (name: string, required?: false): string | undefined;
+export function getEnv (name: string, required = false): string | undefined {
+  const value = process.env[name];
+  if (required && !value) {
+    throw new Error(`Environment variable ${name} is required`);
+  }
+  return value;
+}
+
+export function getRepository (): { owner: string, repo: string; } {
+  const repository = getEnv('GITHUB_REPOSITORY', true);
+  const [owner, repo] = repository.split('/');
+  return { owner, repo };
+}

.github/scripts/pr-build-building.ts

@@ -0,0 +1,36 @@
+/**
+ * PR Build - 更新构建中状态评论
+ *
+ * 环境变量:
+ * - GITHUB_TOKEN: GitHub API Token
+ * - PR_NUMBER: PR 编号
+ * - PR_SHA: PR 提交 SHA
+ */
+
+import { GitHubAPI, getEnv, getRepository } from './lib/github.ts';
+import { generateBuildingComment, COMMENT_MARKER } from './lib/comment.ts';
+
+const BUILD_TARGETS = ['NapCat.Framework', 'NapCat.Shell'];
+
+async function main (): Promise<void> {
+  console.log('🔨 Updating building status comment\n');
+
+  const token = getEnv('GITHUB_TOKEN', true);
+  const prNumber = parseInt(getEnv('PR_NUMBER', true), 10);
+  const prSha = getEnv('PR_SHA', true);
+  const { owner, repo } = getRepository();
+
+  console.log(`PR: #${prNumber}`);
+  console.log(`SHA: ${prSha}`);
+  console.log(`Repo: ${owner}/${repo}\n`);
+
+  const github = new GitHubAPI(token);
+  const comment = generateBuildingComment(prSha, BUILD_TARGETS);
+
+  await github.createOrUpdateComment(owner, repo, prNumber, comment, COMMENT_MARKER);
+}
+
+main().catch((error) => {
+  console.error('❌ Error:', error);
+  process.exit(1);
+});

.github/scripts/pr-build-check.ts

@@ -0,0 +1,206 @@
+/**
+ * PR Build Check Script
+ * 检查 PR 构建触发条件和用户权限
+ *
+ * 环境变量:
+ * - GITHUB_TOKEN: GitHub API Token
+ * - GITHUB_EVENT_NAME: 事件名称
+ * - GITHUB_EVENT_PATH: 事件 payload 文件路径
+ * - GITHUB_REPOSITORY: 仓库名称 (owner/repo)
+ * - GITHUB_OUTPUT: 输出文件路径
+ */
+
+import { readFileSync } from 'node:fs';
+import { GitHubAPI, getEnv, getRepository, setOutput } from './lib/github.ts';
+import type { PullRequest } from './lib/github.ts';
+
+// ============== 类型定义 ==============
+
+interface GitHubPayload {
+  pull_request?: PullRequest;
+  issue?: {
+    number: number;
+    pull_request?: object;
+  };
+  comment?: {
+    body: string;
+    user: { login: string; };
+  };
+}
+
+interface CheckResult {
+  should_build: boolean;
+  pr_number?: number;
+  pr_sha?: string;
+  pr_head_repo?: string;
+  pr_head_ref?: string;
+}
+
+// ============== 权限检查 ==============
+
+async function checkUserPermission (
+  github: GitHubAPI,
+  owner: string,
+  repo: string,
+  username: string
+): Promise<boolean> {
+  // 方法1：检查仓库协作者权限
+  try {
+    const permission = await github.getCollaboratorPermission(owner, repo, username);
+    if (['admin', 'write', 'maintain'].includes(permission)) {
+      console.log(`✓ User ${username} has ${permission} permission`);
+      return true;
+    }
+    console.log(`✗ User ${username} has ${permission} permission (insufficient)`);
+  } catch (e) {
+    console.log(`✗ Failed to get collaborator permission: ${(e as Error).message}`);
+  }
+
+  // 方法2：检查组织成员身份
+  try {
+    const repoInfo = await github.getRepository(owner, repo);
+    if (repoInfo.owner.type === 'Organization') {
+      const isMember = await github.checkOrgMembership(owner, username);
+      if (isMember) {
+        console.log(`✓ User ${username} is organization member`);
+        return true;
+      }
+      console.log(`✗ User ${username} is not organization member`);
+    }
+  } catch (e) {
+    console.log(`✗ Failed to check org membership: ${(e as Error).message}`);
+  }
+
+  return false;
+}
+
+// ============== 事件处理 ==============
+
+function handlePullRequestTarget (payload: GitHubPayload): CheckResult {
+  const pr = payload.pull_request;
+
+  if (!pr) {
+    console.log('✗ No pull_request in payload');
+    return { should_build: false };
+  }
+
+  if (pr.state !== 'open') {
+    console.log(`✗ PR is not open (state: ${pr.state})`);
+    return { should_build: false };
+  }
+
+  console.log(`✓ PR #${pr.number} is open, triggering build`);
+  return {
+    should_build: true,
+    pr_number: pr.number,
+    pr_sha: pr.head.sha,
+    pr_head_repo: pr.head.repo.full_name,
+    pr_head_ref: pr.head.ref,
+  };
+}
+
+async function handleIssueComment (
+  payload: GitHubPayload,
+  github: GitHubAPI,
+  owner: string,
+  repo: string
+): Promise<CheckResult> {
+  const { issue, comment } = payload;
+
+  if (!issue || !comment) {
+    console.log('✗ No issue or comment in payload');
+    return { should_build: false };
+  }
+
+  // 检查是否是 PR 的评论
+  if (!issue.pull_request) {
+    console.log('✗ Comment is not on a PR');
+    return { should_build: false };
+  }
+
+  // 检查是否是 /build 命令
+  if (!comment.body.trim().startsWith('/build')) {
+    console.log('✗ Comment is not a /build command');
+    return { should_build: false };
+  }
+
+  console.log(`→ /build command from @${comment.user.login}`);
+
+  // 获取 PR 详情
+  const pr = await github.getPullRequest(owner, repo, issue.number);
+
+  // 检查 PR 状态
+  if (pr.state !== 'open') {
+    console.log(`✗ PR is not open (state: ${pr.state})`);
+    await github.createComment(owner, repo, issue.number, '⚠️ 此 PR 已关闭，无法触发构建。');
+    return { should_build: false };
+  }
+
+  // 检查用户权限
+  const username = comment.user.login;
+  const hasPermission = await checkUserPermission(github, owner, repo, username);
+
+  if (!hasPermission) {
+    console.log(`✗ User ${username} has no permission`);
+    await github.createComment(
+      owner,
+      repo,
+      issue.number,
+      `⚠️ @${username} 您没有权限使用 \`/build\` 命令，仅仓库协作者或组织成员可使用。`
+    );
+    return { should_build: false };
+  }
+
+  console.log(`✓ Build triggered by @${username}`);
+  return {
+    should_build: true,
+    pr_number: issue.number,
+    pr_sha: pr.head.sha,
+    pr_head_repo: pr.head.repo.full_name,
+    pr_head_ref: pr.head.ref,
+  };
+}
+
+// ============== 主函数 ==============
+
+async function main (): Promise<void> {
+  console.log('🔍 PR Build Check\n');
+
+  const token = getEnv('GITHUB_TOKEN', true);
+  const eventName = getEnv('GITHUB_EVENT_NAME', true);
+  const eventPath = getEnv('GITHUB_EVENT_PATH', true);
+  const { owner, repo } = getRepository();
+
+  console.log(`Event: ${eventName}`);
+  console.log(`Repository: ${owner}/${repo}\n`);
+
+  const payload = JSON.parse(readFileSync(eventPath, 'utf-8')) as GitHubPayload;
+  const github = new GitHubAPI(token);
+
+  let result: CheckResult;
+
+  switch (eventName) {
+    case 'pull_request_target':
+      result = handlePullRequestTarget(payload);
+      break;
+    case 'issue_comment':
+      result = await handleIssueComment(payload, github, owner, repo);
+      break;
+    default:
+      console.log(`✗ Unsupported event: ${eventName}`);
+      result = { should_build: false };
+  }
+
+  // 输出结果
+  console.log('\n=== Outputs ===');
+  setOutput('should_build', String(result.should_build));
+  setOutput('pr_number', String(result.pr_number ?? ''));
+  setOutput('pr_sha', result.pr_sha ?? '');
+  setOutput('pr_head_repo', result.pr_head_repo ?? '');
+  setOutput('pr_head_ref', result.pr_head_ref ?? '');
+}
+
+main().catch((error) => {
+  console.error('❌ Error:', error);
+  process.exit(1);
+});

.github/scripts/pr-build-result.ts

@@ -0,0 +1,90 @@
+/**
+ * PR Build - 更新构建结果评论
+ *
+ * 环境变量:
+ * - GITHUB_TOKEN: GitHub API Token
+ * - PR_NUMBER: PR 编号
+ * - PR_SHA: PR 提交 SHA
+ * - RUN_ID: GitHub Actions Run ID
+ * - NAPCAT_VERSION: 构建版本号
+ * - FRAMEWORK_STATUS: Framework 构建状态
+ * - FRAMEWORK_ERROR: Framework 构建错误信息
+ * - SHELL_STATUS: Shell 构建状态
+ * - SHELL_ERROR: Shell 构建错误信息
+ */
+
+import { GitHubAPI, getEnv, getRepository } from './lib/github.ts';
+import { generateResultComment, COMMENT_MARKER } from './lib/comment.ts';
+import type { BuildTarget, BuildStatus } from './lib/comment.ts';
+
+function parseStatus (value: string | undefined): BuildStatus {
+  if (value === 'success' || value === 'failure' || value === 'cancelled') {
+    return value;
+  }
+  return 'unknown';
+}
+
+async function main (): Promise<void> {
+  console.log('📝 Updating build result comment\n');
+
+  const token = getEnv('GITHUB_TOKEN', true);
+  const prNumber = parseInt(getEnv('PR_NUMBER', true), 10);
+  const prSha = getEnv('PR_SHA') || 'unknown';
+  const runId = getEnv('RUN_ID', true);
+  const version = getEnv('NAPCAT_VERSION') || '';
+  const { owner, repo } = getRepository();
+
+  const frameworkStatus = parseStatus(getEnv('FRAMEWORK_STATUS'));
+  const frameworkError = getEnv('FRAMEWORK_ERROR');
+  const shellStatus = parseStatus(getEnv('SHELL_STATUS'));
+  const shellError = getEnv('SHELL_ERROR');
+
+  console.log(`PR: #${prNumber}`);
+  console.log(`SHA: ${prSha}`);
+  console.log(`Version: ${version}`);
+  console.log(`Run: ${runId}`);
+  console.log(`Framework: ${frameworkStatus}${frameworkError ? ` (${frameworkError})` : ''}`);
+  console.log(`Shell: ${shellStatus}${shellError ? ` (${shellError})` : ''}\n`);
+
+  const github = new GitHubAPI(token);
+  const repository = `${owner}/${repo}`;
+
+  // 获取 artifacts 列表，生成直接下载链接
+  const artifactMap: Record<string, string> = {};
+  try {
+    const artifacts = await github.getRunArtifacts(owner, repo, runId);
+    console.log(`Found ${artifacts.length} artifacts`);
+    for (const artifact of artifacts) {
+      // 生成直接下载链接：https://github.com/{owner}/{repo}/actions/runs/{run_id}/artifacts/{artifact_id}
+      const downloadUrl = `https://github.com/${repository}/actions/runs/${runId}/artifacts/${artifact.id}`;
+      artifactMap[artifact.name] = downloadUrl;
+      console.log(`  - ${artifact.name}: ${downloadUrl}`);
+    }
+  } catch (e) {
+    console.log(`Warning: Failed to get artifacts: ${(e as Error).message}`);
+  }
+
+  const targets: BuildTarget[] = [
+    {
+      name: 'NapCat.Framework',
+      status: frameworkStatus,
+      error: frameworkError,
+      downloadUrl: artifactMap['NapCat.Framework'],
+    },
+    {
+      name: 'NapCat.Shell',
+      status: shellStatus,
+      error: shellError,
+      downloadUrl: artifactMap['NapCat.Shell'],
+    },
+  ];
+
+  const comment = generateResultComment(targets, prSha, runId, repository, version);
+
+  await github.createOrUpdateComment(owner, repo, prNumber, comment, COMMENT_MARKER);
+}
+
+main().catch((error) => {
+  console.error('❌ Error:', error);
+  process.exit(1);
+});

.github/scripts/pr-build-run.ts

@@ -0,0 +1,149 @@
+/**
+ * PR Build Runner
+ * 执行构建步骤
+ *
+ * 用法: node pr-build-run.ts <target>
+ * target: framework | shell
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, renameSync, unlinkSync } from 'node:fs';
+import { setOutput } from './lib/github.ts';
+
+type BuildTarget = 'framework' | 'shell';
+
+interface BuildStep {
+  name: string;
+  command: string;
+  errorMessage: string;
+}
+
+// ============== 构建步骤 ==============
+
+function getCommonSteps (): BuildStep[] {
+  return [
+    {
+      name: 'Install pnpm',
+      command: 'npm i -g pnpm',
+      errorMessage: 'Failed to install pnpm',
+    },
+    {
+      name: 'Install dependencies',
+      command: 'pnpm i',
+      errorMessage: 'Failed to install dependencies',
+    },
+    {
+      name: 'Type check',
+      command: 'pnpm run typecheck',
+      errorMessage: 'Type check failed',
+    },
+    {
+      name: 'Test',
+      command: 'pnpm test',
+      errorMessage: 'Tests failed',
+    },
+    {
+      name: 'Build WebUI',
+      command: 'pnpm --filter napcat-webui-frontend run build',
+      errorMessage: 'WebUI build failed',
+    },
+  ];
+}
+
+function getTargetSteps (target: BuildTarget): BuildStep[] {
+  if (target === 'framework') {
+    return [
+      {
+        name: 'Build Framework',
+        command: 'pnpm run build:framework',
+        errorMessage: 'Framework build failed',
+      },
+    ];
+  }
+  return [
+    {
+      name: 'Build Shell',
+      command: 'pnpm run build:shell',
+      errorMessage: 'Shell build failed',
+    },
+  ];
+}
+
+// ============== 执行器 ==============
+
+function runStep (step: BuildStep): boolean {
+  console.log(`\n::group::${step.name}`);
+  console.log(`> ${step.command}\n`);
+
+  try {
+    execSync(step.command, {
+      stdio: 'inherit',
+      shell: process.platform === 'win32' ? 'cmd.exe' : '/bin/bash',
+    });
+    console.log('::endgroup::');
+    console.log(`✓ ${step.name}`);
+    return true;
+  } catch (_error) {
+    console.log('::endgroup::');
+    console.log(`✗ ${step.name}`);
+    setOutput('error', step.errorMessage);
+    return false;
+  }
+}
+
+function postBuild (target: BuildTarget): void {
+  const srcDir = target === 'framework'
+    ? 'packages/napcat-framework/dist'
+    : 'packages/napcat-shell/dist';
+  const destDir = target === 'framework' ? 'framework-dist' : 'shell-dist';
+
+  console.log(`\n→ Moving ${srcDir} to ${destDir}`);
+
+  if (!existsSync(srcDir)) {
+    throw new Error(`Build output not found: ${srcDir}`);
+  }
+
+  renameSync(srcDir, destDir);
+
+  // Install production dependencies
+  console.log('→ Installing production dependencies');
+  execSync('npm install --omit=dev', {
+    cwd: destDir,
+    stdio: 'inherit',
+    shell: process.platform === 'win32' ? 'cmd.exe' : '/bin/bash',
+  });
+
+  // Remove package-lock.json
+  const lockFile = `${destDir}/package-lock.json`;
+  if (existsSync(lockFile)) {
+    unlinkSync(lockFile);
+  }
+
+  console.log(`✓ Build output ready at ${destDir}`);
+}
+
+// ============== 主函数 ==============
+
+function main (): void {
+  const target = process.argv[2] as BuildTarget;
+
+  if (!target || !['framework', 'shell'].includes(target)) {
+    console.error('Usage: node pr-build-run.ts <framework|shell>');
+    process.exit(1);
+  }
+
+  console.log(`🔨 Building NapCat.${target === 'framework' ? 'Framework' : 'Shell'}\n`);
+
+  const steps = [...getCommonSteps(), ...getTargetSteps(target)];
+
+  for (const step of steps) {
+    if (!runStep(step)) {
+      process.exit(1);
+    }
+  }
+
+  postBuild(target);
+  console.log('\n✅ Build completed successfully!');
+}
+
+main();

.github/workflows/auto-release.yml

@@ -0,0 +1,83 @@
+name: Auto Release Docker
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  shell-docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger NapCat-Docker docker-publish workflow
+        env:
+          GH_TOKEN: ${{ secrets.NAPCAT_BUILD }}
+        run: |
+          curl -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer $GH_TOKEN" \
+            https://api.github.com/repos/NapNeko/NapCat-Docker/actions/workflows/docker-publish.yml/dispatches \
+            -d '{"ref":"main"}'
+  framework-docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger NapCat-Framework-Docker docker-publish workflow
+        env:
+          GH_TOKEN: ${{ secrets.NAPCAT_BUILD }}
+        run: |
+          curl -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer $GH_TOKEN" \
+            https://api.github.com/repos/NapNeko/NapCat.Docker.Framework/actions/workflows/docker-image.yml/dispatches \
+            -d '{"ref":"main"}'
+  appimage-shell-docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Get Latest NapCat Version
+        id: get_version
+        run: |
+            # 获取当前仓库的最新 tag
+            latest_tag=$(git describe --tags $(git rev-list --tags --max-count=1))
+            # 输出调试信息
+            echo "Debug: Latest NapCat Version is ${latest_tag}"
+            echo "latest_tag=${latest_tag}" >> $GITHUB_ENV
+      - name: Trigger Release NapCat AppImage Workflow
+        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 版本
+        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 \
+                -H "Accept: application/vnd.github+json" \
+                -H "Authorization: Bearer $GH_TOKEN" \
+                https://api.github.com/repos/NapNeko/NapCatAppImageBuild/actions/workflows/release.yml/dispatches \
+                -d "{\"ref\":\"main\",\"inputs\":{\"napcat_version\":\"${NAPCAT_VERSION}\",\"qq_version_x86_64\":\"${QQ_VERSION_X86_64}\",\"qq_version_arm64\":\"${QQ_VERSION_ARM64}\"}}"
+  node-shell-docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Get Latest NapCat Version
+        id: get_version
+        run: |
+            # 获取当前仓库的最新 tag
+            latest_tag=$(git describe --tags $(git rev-list --tags --max-count=1))
+            # 输出调试信息
+            echo "Debug: Latest NapCat Version is ${latest_tag}"
+            echo "latest_tag=${latest_tag}" >> $GITHUB_ENV
+      - name: Trigger Release NapCat AppImage Workflow
+        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 版本
+        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 \
+                -H "Accept: application/vnd.github+json" \
+                -H "Authorization: Bearer $GH_TOKEN" \
+                https://api.github.com/repos/NapNeko/NapCatLinuxNodeLoader/actions/workflows/release.yml/dispatches \
+                -d "{\"ref\":\"main\",\"inputs\":{\"napcat_version\":\"${NAPCAT_VERSION}\",\"qq_url_amd64\":\"${QQ_VERSION_X86_64}\",\"qq_url_arm64\":\"${QQ_VERSION_ARM64}\"}}"

.github/workflows/build.yml

@@ -1,47 +1,94 @@
-name: "Build Action"
+name: Build NapCat Artifacts
 on:
-  push:
-  pull_request:
   workflow_dispatch:
+  push:
+    branches:
+      - main
 
 permissions: write-all
 
 jobs:
-  Build-LiteLoader:
+  Build-Framework:
     runs-on: ubuntu-latest
     steps:
       - name: Clone Main Repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 需要完整历史来获取 tags
       - name: Use Node.js 20.X
         uses: actions/setup-node@v4
         with:
           node-version: 20.x
-      - name: Build NapCat.Framework
+      - name: Generate Version
         run: |
-          npm i && cd napcat.webui && npm i && cd .. || exit 1
-          npm run build:framework && npm run depend || exit 1
-          rm package-lock.json
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${GITHUB_SHA::7}"
+          VERSION="${BASE_VERSION}-main.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+      - name: Build NapCat.Framework
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
+        run: |
+          npm i -g pnpm
+          pnpm i
+          pnpm run typecheck || exit 1
+          pnpm test || exit 1
+          pnpm --filter napcat-webui-frontend run build || exit 1
+          pnpm run build:framework
+          mv packages/napcat-framework/dist framework-dist
+          cd framework-dist
+          npm install --omit=dev
+          rm ./package-lock.json || exit 0
       - name: Upload Artifact
         uses: actions/upload-artifact@v4
         with:
           name: NapCat.Framework
-          path: dist
+          path: framework-dist
   Build-Shell:
     runs-on: ubuntu-latest
     steps:
       - name: Clone Main Repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 需要完整历史来获取 tags
       - name: Use Node.js 20.X
         uses: actions/setup-node@v4
         with:
           node-version: 20.x
-      - name: Build NapCat.Shell
+      - name: Generate Version
         run: |
-          npm i && cd napcat.webui && npm i && cd .. || exit 1
-          npm run build:shell && npm run depend || exit 1
-          rm package-lock.json
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${GITHUB_SHA::7}"
+          VERSION="${BASE_VERSION}-main.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+      - name: Build NapCat.Shell
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
+        run: |
+          npm i -g pnpm
+          pnpm i
+          pnpm run typecheck || exit 1
+          pnpm test || exit 1
+          pnpm --filter napcat-webui-frontend run build || exit 1
+          pnpm run build:shell
+          mv packages/napcat-shell/dist shell-dist
+          cd shell-dist
+          npm install --omit=dev
+          rm ./package-lock.json || exit 0
       - name: Upload Artifact
         uses: actions/upload-artifact@v4
         with:
           name: NapCat.Shell
-          path: dist
+          path: shell-dist

.github/workflows/pr-build.yml

@@ -0,0 +1,303 @@
+# =============================================================================
+# PR 构建工作流
+# =============================================================================
+# 功能：
+#   1. 在 PR 提交时自动构建 Framework 和 Shell 包
+#   2. 支持通过 /build 命令手动触发构建（仅协作者/组织成员）
+#   3. 在 PR 中发布构建状态评论，并持续更新（不会重复创建）
+#   4. 支持 Fork PR 的构建（使用 pull_request_target 获取写权限）
+#
+# 安全说明：
+#   - 使用 pull_request_target 事件，在 base 分支上下文运行
+#   - 构建脚本始终从 base 分支 checkout，避免恶意 PR 篡改脚本
+#   - PR 代码单独 checkout 到 workspace 目录
+# =============================================================================
+
+name: PR Build
+
+# =============================================================================
+# 触发条件
+# =============================================================================
+on:
+  # PR 事件：打开、同步（新推送）、重新打开时触发
+  # 注意：使用 pull_request_target 而非 pull_request，以便对 Fork PR 有写权限
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+  # Issue 评论事件：用于响应 /build 命令
+  issue_comment:
+    types: [created]
+
+# =============================================================================
+# 权限配置
+# =============================================================================
+permissions:
+  contents: read # 读取仓库内容
+  pull-requests: write # 写入 PR 评论
+  issues: write # 写入 Issue 评论（/build 命令响应）
+  actions: read # 读取 Actions 信息（获取构建日志链接）
+
+# =============================================================================
+# 并发控制
+# =============================================================================
+# 同一 PR 的多次构建会取消之前未完成的构建，避免资源浪费
+# 注意：只有在 should_build=true 时才会进入实际构建流程，
+#       issue_comment 事件如果不是 /build 命令，会在 check-build 阶段快速退出，
+#       不会取消正在进行的构建（因为 cancel-in-progress 只影响同 group 的后续任务）
+concurrency:
+  # 使用不同的 group 策略：
+  # - pull_request_target: 使用 PR 号
+  # - issue_comment: 只有确认是 /build 命令时才使用 PR 号，否则使用 run_id（不冲突）
+  group: pr-build-${{ github.event_name == 'pull_request_target' && github.event.pull_request.number || github.event_name == 'issue_comment' && github.event.issue.pull_request && contains(github.event.comment.body, '/build') && github.event.issue.number || github.run_id }}
+  cancel-in-progress: true
+
+# =============================================================================
+# 任务定义
+# =============================================================================
+jobs:
+  # ---------------------------------------------------------------------------
+  # Job 1: 检查构建条件
+  # ---------------------------------------------------------------------------
+  # 判断是否应该触发构建：
+  #   - pull_request_target 事件：总是触发
+  #   - issue_comment 事件：检查是否为 /build 命令，且用户有权限
+  # ---------------------------------------------------------------------------
+  check-build:
+    runs-on: ubuntu-latest
+    outputs:
+      should_build: ${{ steps.check.outputs.should_build }} # 是否应该构建
+      pr_number: ${{ steps.check.outputs.pr_number }} # PR 编号
+      pr_sha: ${{ steps.check.outputs.pr_sha }} # PR 最新提交 SHA
+      pr_head_repo: ${{ steps.check.outputs.pr_head_repo }} # PR 源仓库（用于 Fork）
+      pr_head_ref: ${{ steps.check.outputs.pr_head_ref }} # PR 源分支
+    steps:
+      # 仅 checkout 脚本目录，加快速度
+      - name: Checkout scripts
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .github/scripts
+          sparse-checkout-cone-mode: false
+
+      # 使用 Node.js 24 以支持原生 TypeScript 执行
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 执行检查脚本，判断是否触发构建
+      - name: Check trigger condition
+        id: check
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node --experimental-strip-types .github/scripts/pr-build-check.ts
+
+  # ---------------------------------------------------------------------------
+  # Job 2: 更新评论为"构建中"状态
+  # ---------------------------------------------------------------------------
+  # 在 PR 中创建或更新评论，显示构建正在进行中
+  # ---------------------------------------------------------------------------
+  update-comment-building:
+    needs: check-build
+    if: needs.check-build.outputs.should_build == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout scripts
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .github/scripts
+          sparse-checkout-cone-mode: false
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 更新 PR 评论，显示构建中状态
+      - name: Update building comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_NUMBER: ${{ needs.check-build.outputs.pr_number }}
+          PR_SHA: ${{ needs.check-build.outputs.pr_sha }}
+        run: node --experimental-strip-types .github/scripts/pr-build-building.ts
+
+  # ---------------------------------------------------------------------------
+  # Job 3: 构建 Framework 包
+  # ---------------------------------------------------------------------------
+  # 执行 napcat-framework 的构建流程
+  # ---------------------------------------------------------------------------
+  build-framework:
+    needs: [check-build, update-comment-building]
+    if: needs.check-build.outputs.should_build == 'true'
+    runs-on: ubuntu-latest
+    outputs:
+      status: ${{ steps.build.outcome }} # 构建结果：success/failure
+      error: ${{ steps.build.outputs.error }} # 错误信息（如有）
+      version: ${{ steps.version.outputs.version }} # 构建版本号
+    steps:
+      # 【安全】先从 base 分支 checkout 构建脚本
+      # 这样即使 PR 中修改了脚本，也不会被执行
+      - name: Checkout scripts from base
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .github/scripts
+          sparse-checkout-cone-mode: false
+          path: _scripts
+
+      # 将 PR 代码 checkout 到单独的 workspace 目录
+      - name: Checkout PR code
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ needs.check-build.outputs.pr_head_repo }}
+          ref: ${{ needs.check-build.outputs.pr_sha }}
+          path: workspace
+          fetch-depth: 0  # 需要完整历史来获取 tags
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 获取最新 release tag 并生成版本号
+      - name: Generate Version
+        id: version
+        working-directory: workspace
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${{ needs.check-build.outputs.pr_sha }}"
+          SHORT_SHA="${SHORT_SHA::7}"
+          VERSION="${BASE_VERSION}-pr.${{ needs.check-build.outputs.pr_number }}.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+
+      # 执行构建，使用 base 分支的脚本处理 workspace 中的代码
+      - name: Build
+        id: build
+        working-directory: workspace
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
+        run: node --experimental-strip-types ../_scripts/.github/scripts/pr-build-run.ts framework
+        continue-on-error: true # 允许失败，后续更新评论时处理
+
+      # 构建成功时上传产物
+      - name: Upload Artifact
+        if: steps.build.outcome == 'success'
+        uses: actions/upload-artifact@v4
+        with:
+          name: NapCat.Framework
+          path: workspace/framework-dist
+          retention-days: 7 # 保留 7 天
+
+  # ---------------------------------------------------------------------------
+  # Job 4: 构建 Shell 包
+  # ---------------------------------------------------------------------------
+  # 执行 napcat-shell 的构建流程（与 Framework 并行执行）
+  # ---------------------------------------------------------------------------
+  build-shell:
+    needs: [check-build, update-comment-building]
+    if: needs.check-build.outputs.should_build == 'true'
+    runs-on: ubuntu-latest
+    outputs:
+      status: ${{ steps.build.outcome }} # 构建结果：success/failure
+      error: ${{ steps.build.outputs.error }} # 错误信息（如有）
+      version: ${{ steps.version.outputs.version }} # 构建版本号
+    steps:
+      # 【安全】先从 base 分支 checkout 构建脚本
+      - name: Checkout scripts from base
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .github/scripts
+          sparse-checkout-cone-mode: false
+          path: _scripts
+
+      # 将 PR 代码 checkout 到单独的 workspace 目录
+      - name: Checkout PR code
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ needs.check-build.outputs.pr_head_repo }}
+          ref: ${{ needs.check-build.outputs.pr_sha }}
+          path: workspace
+          fetch-depth: 0  # 需要完整历史来获取 tags
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 获取最新 release tag 并生成版本号
+      - name: Generate Version
+        id: version
+        working-directory: workspace
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${{ needs.check-build.outputs.pr_sha }}"
+          SHORT_SHA="${SHORT_SHA::7}"
+          VERSION="${BASE_VERSION}-pr.${{ needs.check-build.outputs.pr_number }}.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+
+      # 执行构建
+      - name: Build
+        id: build
+        working-directory: workspace
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
+        run: node --experimental-strip-types ../_scripts/.github/scripts/pr-build-run.ts shell
+        continue-on-error: true
+
+      # 构建成功时上传产物
+      - name: Upload Artifact
+        if: steps.build.outcome == 'success'
+        uses: actions/upload-artifact@v4
+        with:
+          name: NapCat.Shell
+          path: workspace/shell-dist
+          retention-days: 7 # 保留 7 天
+
+  # ---------------------------------------------------------------------------
+  # Job 5: 更新评论为构建结果
+  # ---------------------------------------------------------------------------
+  # 汇总所有构建结果，更新 PR 评论显示最终状态
+  # 使用 always() 确保即使构建失败/取消也会执行
+  # ---------------------------------------------------------------------------
+  update-comment-result:
+    needs: [check-build, update-comment-building, build-framework, build-shell]
+    if: always() && needs.check-build.outputs.should_build == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout scripts
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .github/scripts
+          sparse-checkout-cone-mode: false
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 更新评论，显示构建结果和下载链接
+      - name: Update result comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_NUMBER: ${{ needs.check-build.outputs.pr_number }}
+          PR_SHA: ${{ needs.check-build.outputs.pr_sha }}
+          RUN_ID: ${{ github.run_id }}
+          # 构建版本号
+          NAPCAT_VERSION: ${{ needs.build-framework.outputs.version || needs.build-shell.outputs.version || '' }}
+          # 获取构建状态，如果 job 被跳过则标记为 cancelled
+          FRAMEWORK_STATUS: ${{ needs.build-framework.outputs.status || 'cancelled' }}
+          FRAMEWORK_ERROR: ${{ needs.build-framework.outputs.error }}
+          SHELL_STATUS: ${{ needs.build-shell.outputs.status || 'cancelled' }}
+          SHELL_ERROR: ${{ needs.build-shell.outputs.error }}
+        run: node --experimental-strip-types .github/scripts/pr-build-result.ts

.github/workflows/release.yml

@@ -1,164 +1,442 @@
-name: "Build Release"
+name: Release NapCat
 
 on:
+  workflow_dispatch:
   push:
     tags:
-      - "v*"
+      - 'v*'
 
 permissions: write-all
 
+env:
+  OPENROUTER_API_URL: https://91vip.futureppo.top/v1/chat/completions
+  OPENROUTER_MODEL: "Antigravity/gemini-3-flash-preview"
+  RELEASE_NAME: "NapCat"
+
 jobs:
-  check-version:
+  # 验证版本号格式
+  validate-version:
+    runs-on: ubuntu-latest
+    outputs:
+      valid: ${{ steps.check.outputs.valid }}
+      version: ${{ steps.check.outputs.version }}
+    steps:
+      - name: Validate semantic version
+        id: check
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          echo "Checking tag: $TAG"
+          
+          # 语义化版本正则表达式
+          # 支持: v1.0.0, v1.0.0-beta, v1.0.0-rc.1, v1.0.0-alpha.1+build.123
+          SEMVER_REGEX="^v(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9]*[a-zA-Z-][0-9a-zA-Z-]*)(\.(0|[1-9][0-9]*|[0-9]*[a-zA-Z-][0-9a-zA-Z-]*))*))?$"
+          
+          if [[ "$TAG" =~ $SEMVER_REGEX ]]; then
+            echo "✅ Valid semantic version: $TAG"
+            echo "valid=true" >> $GITHUB_OUTPUT
+            echo "version=$TAG" >> $GITHUB_OUTPUT
+          else
+            echo "❌ Invalid version format: $TAG"
+            echo "Expected format: vX.Y.Z or vX.Y.Z-prerelease"
+            echo "Examples: v1.0.0, v1.2.3-beta, v2.0.0-rc.1"
+            echo "valid=false" >> $GITHUB_OUTPUT
+            exit 1
+          fi
+
+  Build-Framework:
+    needs: validate-version
+    if: needs.validate-version.outputs.valid == 'true'
     runs-on: ubuntu-latest
     steps:
-      - name: Clone Repository
+      - name: Clone Main Repository
         uses: actions/checkout@v4
-        with:
-          ref: main
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract version from tag
-        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
-
       - name: Use Node.js 20.X
         uses: actions/setup-node@v4
         with:
           node-version: 20.x
+      - name: Build NapCat.Framework
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          npm i -g pnpm
+          pnpm i
+          pnpm --filter napcat-webui-frontend run build || exit 1
+          pnpm run build:framework
+          mv packages/napcat-framework/dist framework-dist
+          cd framework-dist
+          npm install --omit=dev
+          rm ./package-lock.json || exit 0
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: NapCat.Framework
+          path: framework-dist
 
-      - name: Check Version
-        run: | 
-              ls
-              node ./script/checkVersion.cjs
-              sh ./checkVersion.sh
-  Build-LiteLoader:
-    needs: [check-version]
-    runs-on: ubuntu-latest
-    steps:
-    - name: Clone Main Repository
-      uses: actions/checkout@v4
-      with:
-          repository: 'NapNeko/NapCatQQ'
-          submodules: true
-          ref: main
-          token: ${{ secrets.NAPCAT_BUILD }}
-    - name: Use Node.js 20.X
-      uses: actions/setup-node@v4
-      with:
-          node-version: 20.x
-
-    - name: Build NuCat Framework
-      run: |
-          npm i
-          cd napcat.webui
-          npm i
-          cd ..
-          npm run build:framework
-          cd dist
-          npm i --omit=dev
-          cd ..
-    - name: Upload Artifact
-      uses: actions/upload-artifact@v4
-      with:
-        name: NapCat.Framework
-        path: dist
   Build-Shell:
+    needs: validate-version
+    if: needs.validate-version.outputs.valid == 'true'
     runs-on: ubuntu-latest
-    needs: [check-version]
     steps:
-        - name: Clone Main Repository
-          uses: actions/checkout@v4
-          with:
-                repository: 'NapNeko/NapCatQQ'
-                submodules: true
-                ref: main
-                token: ${{ secrets.NAPCAT_BUILD }}
+      - name: Clone Main Repository
+        uses: actions/checkout@v4
+      - name: Use Node.js 20.X
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+      - name: Build NapCat.Shell
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          npm i -g pnpm
+          pnpm i
+          pnpm --filter napcat-webui-frontend run build || exit 1
+          pnpm run build:shell
+          mv packages/napcat-shell/dist shell-dist
+          cd shell-dist
+          npm install --omit=dev
+          rm ./package-lock.json || exit 0
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: NapCat.Shell
+          path: shell-dist
+  Download-QNX64:
+    needs: Build-Shell
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
 
-        - name: Use Node.js 20.X
-          uses: actions/setup-node@v4
-          with:
-              node-version: 20.x
-          
-        - name: Build NuCat Shell
-          run: |
-                npm i 
-                cd napcat.webui
-                npm i
-                cd ..
-                npm run build:shell
-                cd dist
-                npm i --omit=dev
-                cd ..
+      - name: Download Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: ./artifacts
 
-        - name: Upload Artifact
-          uses: actions/upload-artifact@v4
-          with:
-              name: NapCat.Shell
-              path: dist
+      - name: Setup tools
+        run: |
+          sudo apt update
+          sudo apt install -y aria2 unzip zip p7zip-full curl jq
+
+      - name: Download QQ x64, Node.js and Assemble NapCat.Shell.Windows.Node.zip
+        run: |
+          set -euo pipefail
+          TMPDIR=$(mktemp -d)
+          cd "$TMPDIR"
+
+          # -----------------------------
+          # 1) 下载 QQ x64
+          # -----------------------------
+          # JS_URL="https://cdn-go.cn/qq-web/im.qq.com_new/latest/rainbow/windowsConfig.js"
+          # JS_URL="https://slave.docadan488.workers.dev/proxy?url=https://cdn-go.cn/qq-web/im.qq.com_new/latest/rainbow/windowsConfig.js"
+          # NT_URL=$(curl -fsSL "$JS_URL" | grep -oP '"ntDownloadX64Url"\s*:\s*"\K[^"]+')
+          NT_URL="https://dldir1v6.qq.com/qqfile/qq/QQNT/eb263b35/QQ9.9.23.42086_x64.exe"
+          QQ_ZIP="$(basename "$NT_URL")"
+          aria2c -x16 -s16 -k1M -o "$QQ_ZIP" "$NT_URL"
+
+          QQ_EXTRACT="$TMPDIR/qq_extracted"
+          mkdir -p "$QQ_EXTRACT"
+          7z x -y -o"$QQ_EXTRACT" "$QQ_ZIP" >/dev/null
+
+          # -----------------------------
+          # 2) 下载 Node.js Windows x64 zip 22.11.0
+          # -----------------------------
+          NODE_VER="22.11.0"
+          NODE_URL="https://nodejs.org/dist/v$NODE_VER/node-v$NODE_VER-win-x64.zip"
+          NODE_ZIP="node-v$NODE_VER-win-x64.zip"
+          aria2c -x1 -s1 -k1M -o "$NODE_ZIP" "$NODE_URL"
+
+          NODE_EXTRACT="$TMPDIR/node_extracted"
+          mkdir -p "$NODE_EXTRACT"
+          unzip -q "$NODE_ZIP" -d "$NODE_EXTRACT"
+
+          # -----------------------------
+          # 3) 创建输出目录
+          # -----------------------------
+          OUT_DIR="$GITHUB_WORKSPACE/NapCat.Shell.Windows.Node"
+          mkdir -p "$OUT_DIR/NapCat.Shell.Windows.Node"
+
+          # -----------------------------
+          # 4) 解压 NapCat.Shell.zip 到 napcat
+          # -----------------------------
+          cp -a "$GITHUB_WORKSPACE/artifacts/NapCat.Shell/." "$OUT_DIR/napcat/"
+
+          # -----------------------------
+          # 5) 拷贝 QQ 文件到 NapCat.Shell.Windows.Node
+          # -----------------------------
+          QQ_TARGETS=("avif_convert.dll" "broadcast_ipc.dll" "config.json" "libglib-2.0-0.dll" "libgobject-2.0-0.dll" "libvips-42.dll" "ncnn.dll" "opencv.dll" "package.json" "QBar.dll" "wrapper.node")
+          for name in "${QQ_TARGETS[@]}"; do
+            find "$QQ_EXTRACT" -iname "$name" -exec cp -a {} "$OUT_DIR" \; || true
+          done
+
+          # -----------------------------
+          # 6) 拷贝仓库文件 napcat.bat 和 index.js
+          # -----------------------------
+          cp -a "$GITHUB_WORKSPACE/packages/napcat-develop/napcat.bat" "$OUT_DIR/" || true
+          cp -a "$GITHUB_WORKSPACE/packages/napcat-develop/index.js" "$OUT_DIR/" || true
+          cp -a "$GITHUB_WORKSPACE/packages/napcat-develop/QQNT.dll" "$OUT_DIR/" || true
+          # -----------------------------
+          # 7) 拷贝 Node.exe 到 NapCat.Shell.Windows.Node
+          # -----------------------------
+          cp -a "$NODE_EXTRACT/node-v$NODE_VER-win-x64/node.exe" "$OUT_DIR/" || true
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: NapCat.Shell.Windows.Node
+          path: NapCat.Shell.Windows.Node
 
   release-napcat:
-    needs: [Build-LiteLoader,Build-Shell]
+    needs: [Build-Framework, Build-Shell, Download-QNX64]
     runs-on: ubuntu-latest
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+            fetch-depth: 0
 
-    - name: Clone Main Repository
-      uses: actions/checkout@v4
-      with:
-            repository: 'NapNeko/NapCatQQ'
-            submodules: true
-            ref: main
-            token: ${{ secrets.NAPCAT_BUILD }}
+      - name: Download Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: ./artifacts
 
-    - name: Download All Artifact
-      uses: actions/download-artifact@v4
-      
-    - name: Compress subdirectories
-      run: |
-        cd ./NapCat.Shell/
-        zip -q -r NapCat.Shell.zip *
-        cd ..
-        cd ./NapCat.Framework/
-        zip -q -r NapCat.Framework.zip *
-        cd ..
-        rm ./NapCat.Shell.zip -rf
-        rm ./NapCat.Framework.zip -rf
-        mv ./NapCat.Shell/NapCat.Shell.zip ./
-        mv ./NapCat.Framework/NapCat.Framework.zip ./
-
-        mkdir ./NapCat.Framework.Windows.Once
-        unzip -q ./external/LiteLoaderWrapper.zip -d ./NapCat.Framework.Windows.Once
-        cd ./NapCat.Framework.Windows.Once
-        ls 
-        mkdir -p ./LL/plugins/NapCatQQ
-        unzip -q ../NapCat.Framework.zip -d ./LL/plugins/NapCatQQ
-        zip -q -r NapCat.Framework.Windows.Once.zip *
-        cd ..
-        mv ./NapCat.Framework.Windows.Once/NapCat.Framework.Windows.Once.zip ./
-    - name: Extract version from tag
-      run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
-      
-    - name: Clone Changes Log
-      run: curl -o CHANGELOG.md https://fastly.jsdelivr.net/gh/NapNeko/NapCatQQ@main/docs/changelogs/CHANGELOG.v${{ env.VERSION }}.md
-        
-    - name: Create Release Draft and Upload Artifacts
-      uses: softprops/action-gh-release@v1
-      with:
-        name: NapCat V${{ env.VERSION }}
-        token: ${{ secrets.GITHUB_TOKEN }}
-        body_path: CHANGELOG.md
-        files: |
-          NapCat.Framework.zip
-          NapCat.Shell.zip
-          NapCat.Framework.Windows.Once.zip
-        draft: true
-
-  build-docker:
-    needs: release-napcat
-    runs-on: ubuntu-latest
-    steps:
-      - name: Dispatch Docker Build
+      - name: Download NapCat.Shell.Windows.OneKey.zip
         run: |
-          curl -X POST \
-          -H "Authorization: Bearer ${{ secrets.NAPCAT_BUILD }}" \
-          -H "Accept: application/vnd.github.v3+json" \
-          https://api.github.com/repos/NapNeko/NapCat-Docker/actions/workflows/docker-publish.yml/dispatches \
-          -d '{"ref": "main"}'
+            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
+            [ -d NapCat.Framework ] && (cd NapCat.Framework && zip -qr ../../NapCat.Framework.zip .)
+            [ -d NapCat.Shell ] && (cd NapCat.Shell && zip -qr ../../NapCat.Shell.zip .)
+            [ -d NapCat.Shell.Windows.Node ] && (cd NapCat.Shell.Windows.Node && zip -qr ../../NapCat.Shell.Windows.Node.zip .)
+            cd ..
+
+      - name: Generate release note via OpenRouter
+        env:
+          OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
+          OPENROUTER_API_URL: ${{ env.OPENROUTER_API_URL }}
+          OPENROUTER_MODEL: ${{ env.OPENROUTER_MODEL }}
+          GITHUB_OWNER: "NapNeko"   # 替换成你的 repo owner
+          GITHUB_REPO: "NapCatQQ"   # 替换成你的 repo 名
+        run: |
+          set -euo pipefail
+
+          # 当前 tag
+          CURRENT_TAG="${GITHUB_REF#refs/tags/}"
+          echo "Current tag: $CURRENT_TAG"
+
+          # 从 GitHub API 获取 tag 列表
+          TAGS_JSON=$(curl -s "https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/tags?per_page=100")
+          TAGS=( $(echo "$TAGS_JSON" | jq -r '.[].name' | sort -V) )
+
+          # 找到上一个 tag
+          PREV_TAG=""
+          for i in "${!TAGS[@]}"; do
+            if [ "${TAGS[$i]}" = "$CURRENT_TAG" ]; then
+              if [ $i -gt 0 ]; then
+                PREV_TAG="${TAGS[$((i-1))]}"
+              fi
+              break
+            fi
+          done
+
+          if [ -z "$PREV_TAG" ]; then
+            echo "⚠️ Could not find previous tag for $CURRENT_TAG, using first commit"
+            PREV_TAG=$(git rev-list --max-parents=0 HEAD | head -1)
+          fi
+
+          echo "Previous tag: $PREV_TAG"
+
+          # 强制拉取上一个 tag 和当前 tag
+          git fetch origin "refs/tags/$PREV_TAG:refs/tags/$PREV_TAG" --force || true
+          git fetch origin "refs/tags/$CURRENT_TAG:refs/tags/$CURRENT_TAG" --force || true
+
+          # 获取 commit，使用更清晰的格式
+          # 格式: <type>: <subject> (<hash>)
+          COMMITS=$(git log --pretty=format:'- %s (%h)' "$PREV_TAG".."$CURRENT_TAG" 2>/dev/null || git log --pretty=format:'- %s (%h)' -20)
+
+          echo "Commit list from $PREV_TAG to $CURRENT_TAG:"
+          echo "$COMMITS"
+
+          # 获取文件变化统计
+          echo "Getting file change statistics..."
+          FILE_STATS=$(git diff --stat "$PREV_TAG".."$CURRENT_TAG" 2>/dev/null || echo "")
+          
+          # 获取总体统计（最后一行）
+          SUMMARY_LINE=$(echo "$FILE_STATS" | tail -1)
+          echo "Summary: $SUMMARY_LINE"
+          
+          # 获取每个文件的变化（去掉最后一行汇总）
+          # 截断过长的输出（最多50个文件，每行最多80字符）
+          FILE_CHANGES=$(echo "$FILE_STATS" | head -n -1 | head -50 | cut -c1-80)
+          
+          # 如果文件变化太多，进一步精简：只保留主要目录的变化
+          FILE_COUNT=$(echo "$FILE_STATS" | head -n -1 | wc -l)
+          if [ "$FILE_COUNT" -gt 50 ]; then
+            echo "Too many files ($FILE_COUNT), grouping by directory..."
+            # 按目录分组统计
+            DIR_STATS=$(git diff --stat "$PREV_TAG".."$CURRENT_TAG" 2>/dev/null | head -n -1 | \
+              sed 's/|.*//g' | \
+              awk -F'/' '{if(NF>1) print $1"/"$2; else print $1}' | \
+              sort | uniq -c | sort -rn | head -20)
+            FILE_CHANGES="[按目录分组统计 - 共 $FILE_COUNT 个文件变更]
+          $DIR_STATS"
+          fi
+          
+          echo "File changes:"
+          echo "$FILE_CHANGES"
+
+          # 获取具体代码变化（关键文件的diff）
+          echo "Getting code diff for key files..."
+          
+          # 定义关键目录（优先展示这些目录的变化）
+          KEY_DIRS="packages/napcat-core packages/napcat-onebot packages/napcat-webui-backend"
+          
+          # 获取变更的关键文件列表（排除测试、配置等）
+          # 使用 || true 防止 grep 无匹配时返回非零退出码
+          KEY_FILES=$(git diff --name-only "$PREV_TAG".."$CURRENT_TAG" 2>/dev/null | \
+            grep -E "^packages/napcat-(core|onebot|webui-backend|shell)/" || true | \
+            grep -E "\.(ts|js)$" || true | \
+            grep -v -E "(test|spec|\.d\.ts|config)" || true | \
+            head -15) || true
+          
+          CODE_DIFF=""
+          DIFF_CHAR_LIMIT=6000  # 总diff字符限制
+          CURRENT_CHARS=0
+          
+          if [ -n "$KEY_FILES" ]; then
+            for file in $KEY_FILES; do
+              if [ "$CURRENT_CHARS" -ge "$DIFF_CHAR_LIMIT" ]; then
+                CODE_DIFF="$CODE_DIFF
+          [... 更多文件变化已截断 ...]"
+                break
+              fi
+              
+              # 获取单个文件的diff，限制每个文件最多50行
+              FILE_DIFF=$(git diff "$PREV_TAG".."$CURRENT_TAG" -- "$file" 2>/dev/null | head -50) || true
+              FILE_DIFF_LEN=${#FILE_DIFF}
+              
+              # 如果单个文件diff超过1500字符，截断
+              if [ "$FILE_DIFF_LEN" -gt 1500 ]; then
+                FILE_DIFF=$(echo "$FILE_DIFF" | head -c 1500)
+                FILE_DIFF="$FILE_DIFF
+          [... 文件 $file 变化已截断 ...]"
+              fi
+              
+              if [ -n "$FILE_DIFF" ]; then
+                CODE_DIFF="$CODE_DIFF
+          
+          ### $file
+          \`\`\`diff
+          $FILE_DIFF
+          \`\`\`"
+                CURRENT_CHARS=$((CURRENT_CHARS + FILE_DIFF_LEN))
+              fi
+            done
+          fi
+          
+          # 如果没有关键文件变化，获取前5个变更文件的diff
+          if [ -z "$CODE_DIFF" ]; then
+            echo "No key files changed, getting top changed files..."
+            TOP_FILES=$(git diff --name-only "$PREV_TAG".."$CURRENT_TAG" 2>/dev/null | \
+              grep -E "\.(ts|js|yml|md)$" | head -5) || true
+            
+            if [ -n "$TOP_FILES" ]; then
+              for file in $TOP_FILES; do
+                FILE_DIFF=$(git diff "$PREV_TAG".."$CURRENT_TAG" -- "$file" 2>/dev/null | head -30) || true
+                if [ -n "$FILE_DIFF" ] && [ ${#FILE_DIFF} -lt 1000 ]; then
+                  CODE_DIFF="$CODE_DIFF
+          
+          ### $file
+          \`\`\`diff
+          $FILE_DIFF
+          \`\`\`"
+                fi
+              done
+            fi
+          fi
+          
+          # 如果仍然没有代码变化，添加说明
+          if [ -z "$CODE_DIFF" ]; then
+            CODE_DIFF="[本次更新主要涉及配置文件和文档变更，无核心代码变化]"
+          fi
+          
+          echo "Code diff preview:"
+          echo "$CODE_DIFF" | head -50
+
+          # 读取 prompt
+          PROMPT_FILE=".github/prompt/release_note_prompt.txt"
+          SYSTEM_PROMPT=$(<"$PROMPT_FILE")
+
+          # 构建用户内容，传递更多上下文（包含文件变化和代码diff）
+          USER_CONTENT="当前版本: $CURRENT_TAG
+          上一版本: $PREV_TAG
+          
+          ## 提交列表
+          $COMMITS
+          
+          ## 文件变化统计
+          $SUMMARY_LINE
+          
+          ## 变更文件列表
+          $FILE_CHANGES
+          
+          ## 关键代码变化
+          $CODE_DIFF"
+
+          # 构建请求 JSON，增加 max_tokens 以获取更完整的输出
+          BODY=$(jq -n \
+            --arg system "$SYSTEM_PROMPT" \
+            --arg user "$USER_CONTENT" \
+            --arg model "$OPENROUTER_MODEL" \
+            '{model: $model, messages:[{role:"system", content:$system},{role:"user", content:$user}], temperature:0.2, max_tokens:1500}')
+
+          echo "=== OpenRouter request body ==="
+          echo "$BODY" | jq .
+
+          # 调用 OpenRouter
+          if RESPONSE=$(curl -s -X POST "$OPENROUTER_API_URL" \
+            -H "Authorization: Bearer $OPENAI_KEY" \
+            -H "Content-Type: application/json" \
+            -d "$BODY"); then
+            echo "=== raw response ==="
+            echo "$RESPONSE"  
+            echo "=== OpenRouter raw response ==="
+            if echo "$RESPONSE" | jq . >/dev/null 2>&1; then
+              echo "$RESPONSE" | jq .
+            else
+              echo "jq failed to parse response"
+            fi
+
+            # 提取生成内容
+            RELEASE_BODY=$(echo "$RESPONSE" | jq -r '.choices[0].message.content // .choices[0].text // ""' 2>/dev/null || echo "")
+
+            if [ -z "$RELEASE_BODY" ]; then
+              echo "❌ OpenRouter failed to generate release note, using default.md"
+              # 替换默认模板中的版本占位符
+              sed "s/{VERSION}/$CURRENT_TAG/g" .github/prompt/default.md > CHANGELOG.md
+            else
+              # 后处理：确保版本号正确，并添加比较链接
+              echo -e "$RELEASE_BODY" > CHANGELOG.md
+              # 替换可能的占位符
+              sed -i "s/{VERSION}/$CURRENT_TAG/g" CHANGELOG.md
+              sed -i "s/{PREV_VERSION}/$PREV_TAG/g" CHANGELOG.md
+            fi
+          else
+            echo "❌ Curl failed, using default.md"
+            sed "s/{VERSION}/$CURRENT_TAG/g" .github/prompt/default.md > CHANGELOG.md
+          fi
+          echo "=== generated release note ==="
+          cat CHANGELOG.md
+
+      - name: Create Release Draft and Upload Artifacts
+        uses: softprops/action-gh-release@v1
+        with:
+          name: NapCat ${{ github.ref_name }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          body_path: CHANGELOG.md
+          files: |
+            NapCat.Shell.Windows.Node.zip
+            NapCat.Framework.zip
+            NapCat.Shell.zip
+            NapCat.Shell.Windows.OneKey.zip
+          draft: true

.gitignore

@@ -16,4 +16,4 @@ checkVersion.sh
 bun.lockb
 tests/run/
 guild1.db-wal
-guild1.db-shm
+guild1.db-shm

.vscode/launch.json

@@ -2,114 +2,11 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "type": "node",
+            "type": "node-terminal",
             "request": "launch",
-            "name": "dev:shell",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "dev:shell"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "build:shell",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "build:shell"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "build:universal",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "build:universal"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "build:framework",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "build:framework"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "build:webui",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "build:webui"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:universal",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "dev:universal"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:framework",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "dev:framework"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:webui",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "dev:webui"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "lint",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "lint"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "depend",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "depend"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:depend",
-            "runtimeExecutable": "npm",
-            "runtimeArgs": [
-                "run",
-                "dev:depend"
-            ]
+            "name": "调试程序",
+            "command": "pnpm run dev:shell",
+            "cwd": "${workspaceFolder}"
         }
     ]
 }

.vscode/settings.json

@@ -1,37 +1,37 @@
 {
-    "explorer.fileNesting.enabled": true,
-    "explorer.fileNesting.expand": false,
-    "explorer.fileNesting.patterns": {
-        ".env.universal": ".env.*",
-        "vite.config.ts": "vite*.ts",
-        "README.md": "CODE_OF_CONDUCT.md, RELEASES.md, CONTRIBUTING.md, CHANGELOG.md, SECURITY.md",
-        "tsconfig.json": "tsconfig.*.json, env.d.ts",
-        "package.json": "package-lock.json, eslint*, .prettier*, .editorconfig, manifest.json, logo.png, .gitignore, LICENSE"
-    },
-    "css.customData": [
-        ".vscode/tailwindcss.json"
-    ],
-    "editor.detectIndentation": false,
-    "editor.tabSize": 2,
-    "editor.formatOnSave": true,
-    "editor.formatOnType": false,
-    "editor.formatOnPaste": true,
-    "editor.formatOnSaveMode": "file",
-    "editor.codeActionsOnSave": {
-        "source.fixAll.eslint": "always"
-    },
-    "files.autoSave": "onFocusChange",
-    "javascript.preferences.quoteStyle": "single",
-    "typescript.preferences.quoteStyle": "single",
-    "javascript.format.semicolons": "insert",
-    "typescript.format.semicolons": "insert",
-    "javascript.format.insertSpaceBeforeFunctionParenthesis": true,
-    "typescript.format.insertSpaceBeforeFunctionParenthesis": true,
-    "typescript.format.insertSpaceAfterConstructor": true,
-    "javascript.format.insertSpaceAfterConstructor": true,
-    "typescript.preferences.importModuleSpecifier": "non-relative",
-    "typescript.preferences.importModuleSpecifierEnding": "minimal",
-    "javascript.preferences.importModuleSpecifier": "non-relative",
-    "javascript.preferences.importModuleSpecifierEnding": "minimal",
-    "typescript.disableAutomaticTypeAcquisition": true,
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.expand": false,
+  "explorer.fileNesting.patterns": {
+    ".env.universal": ".env.*",
+    "vite.config.ts": "vite*.ts",
+    "README.md": "CODE_OF_CONDUCT.md, RELEASES.md, CONTRIBUTING.md, CHANGELOG.md, SECURITY.md",
+    "tsconfig.json": "tsconfig.*.json, env.d.ts",
+    "package.json": "package-lock.json, eslint*, .prettier*, .editorconfig, manifest.json, logo.png, .gitignore, LICENSE"
+  },
+  "css.customData": [
+    ".vscode/tailwindcss.json"
+  ],
+  "editor.detectIndentation": false,
+  "editor.tabSize": 2,
+  "editor.formatOnSave": true,
+  "editor.formatOnType": false,
+  "editor.formatOnPaste": true,
+  "editor.formatOnSaveMode": "file",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "always"
+  },
+  "files.autoSave": "onFocusChange",
+  "javascript.preferences.quoteStyle": "single",
+  "typescript.preferences.quoteStyle": "single",
+  "javascript.format.semicolons": "insert",
+  "typescript.format.semicolons": "insert",
+  "javascript.format.insertSpaceBeforeFunctionParenthesis": true,
+  "typescript.format.insertSpaceBeforeFunctionParenthesis": true,
+  "typescript.format.insertSpaceAfterConstructor": true,
+  "javascript.format.insertSpaceAfterConstructor": true,
+  "typescript.preferences.importModuleSpecifier": "non-relative",
+  "typescript.preferences.importModuleSpecifierEnding": "minimal",
+  "javascript.preferences.importModuleSpecifier": "non-relative",
+  "javascript.preferences.importModuleSpecifierEnding": "minimal",
+  "typescript.disableAutomaticTypeAcquisition": true
 }

README.md

@@ -43,7 +43,7 @@ _Modern protocol-side framework implemented based on NTQQ._
 
 **首次使用**请务必查看如下文档看使用教程
 
-> 项目非盈利，对接问题/基础问题/下层框架问题 请自行搜索解决，本项目社区不提供此类解答。
+> 项目非盈利，涉及 对接问题/基础问题/下层框架问题 请自行搜索解决，本项目社区不提供此类解答。
 
 ## Link
 

launcher/quickLoginExample.bat

@@ -1,4 +0,0 @@
-@echo off
-REM ./launcher.bat 123456
-REM ./launcher-win10.bat 123456
-REM 带有REM的为注释 删掉你需要的系统的那行REM这三个单词 修改QQ本脚本启动即可

napcat.webui/.env

@@ -1 +0,0 @@
-VITE_DEBUG_BACKEND_URL="http://127.0.0.1:6099"

napcat.webui/eslint.config.mjs

@@ -1,2 +0,0 @@
-import eslintConfig from '../eslint.config.mjs';
-export default eslintConfig;

napcat.webui/src/components/audio_player.tsx

@@ -1,425 +0,0 @@
-import { Button } from '@heroui/button';
-import { Card, CardBody, CardHeader } from '@heroui/card';
-import { Image } from '@heroui/image';
-import { Popover, PopoverContent, PopoverTrigger } from '@heroui/popover';
-import { Slider } from '@heroui/slider';
-import { Tooltip } from '@heroui/tooltip';
-import { useLocalStorage } from '@uidotdev/usehooks';
-import clsx from 'clsx';
-import { useEffect, useRef, useState } from 'react';
-import {
-  BiSolidSkipNextCircle,
-  BiSolidSkipPreviousCircle,
-} from 'react-icons/bi';
-import {
-  FaPause,
-  FaPlay,
-  FaRegHandPointRight,
-  FaRepeat,
-  FaShuffle,
-} from 'react-icons/fa6';
-import { TbRepeatOnce } from 'react-icons/tb';
-import { useMediaQuery } from 'react-responsive';
-
-import { PlayMode } from '@/const/enum';
-import key from '@/const/key';
-
-import { VolumeHighIcon, VolumeLowIcon } from './icons';
-
-export interface AudioPlayerProps
-  extends React.AudioHTMLAttributes<HTMLAudioElement> {
-  src: string
-  title?: string
-  artist?: string
-  cover?: string
-  pressNext?: () => void
-  pressPrevious?: () => void
-  onPlayEnd?: () => void
-  onChangeMode?: (mode: PlayMode) => void
-  mode?: PlayMode
-}
-
-export default function AudioPlayer (props: AudioPlayerProps) {
-  const {
-    src,
-    pressNext,
-    pressPrevious,
-    cover = 'https://nextui.org/images/album-cover.png',
-    title = '未知',
-    artist = '未知',
-    onTimeUpdate,
-    onLoadedData,
-    onPlay,
-    onPause,
-    onPlayEnd,
-    onChangeMode,
-    autoPlay,
-    mode = PlayMode.Loop,
-    ...rest
-  } = props;
-
-  const [currentTime, setCurrentTime] = useState(0);
-  const [duration, setDuration] = useState(0);
-  const [isPlaying, setIsPlaying] = useState(false);
-  const [volume, setVolume] = useState(100);
-  const [isCollapsed, setIsCollapsed] = useLocalStorage(
-    key.isCollapsedMusicPlayer,
-    false
-  );
-  const audioRef = useRef<HTMLAudioElement>(null);
-  const cardRef = useRef<HTMLDivElement>(null);
-  const startY = useRef(0);
-  const startX = useRef(0);
-  const [translateY, setTranslateY] = useState(0);
-  const [translateX, setTranslateX] = useState(0);
-  const isSmallScreen = useMediaQuery({ maxWidth: 767 });
-  const isMediumUp = useMediaQuery({ minWidth: 768 });
-  const shouldAdd = useRef(false);
-  const currentProgress = (currentTime / duration) * 100;
-  const [storageAutoPlay, setStorageAutoPlay] = useLocalStorage(
-    key.autoPlay,
-    true
-  );
-
-  const handleTimeUpdate = (event: React.SyntheticEvent<HTMLAudioElement>) => {
-    const audio = event.target as HTMLAudioElement;
-    setCurrentTime(audio.currentTime);
-    onTimeUpdate?.(event);
-  };
-
-  const handleLoadedData = (event: React.SyntheticEvent<HTMLAudioElement>) => {
-    const audio = event.target as HTMLAudioElement;
-    setDuration(audio.duration);
-    onLoadedData?.(event);
-  };
-
-  const handlePlay = (e: React.SyntheticEvent<HTMLAudioElement>) => {
-    setIsPlaying(true);
-    setStorageAutoPlay(true);
-    onPlay?.(e);
-  };
-
-  const handlePause = (e: React.SyntheticEvent<HTMLAudioElement>) => {
-    setIsPlaying(false);
-    onPause?.(e);
-  };
-
-  const changeMode = () => {
-    const modes = [PlayMode.Loop, PlayMode.Random, PlayMode.Single];
-    const currentIndex = modes.findIndex((_mode) => _mode === mode);
-    const nextIndex = currentIndex + 1;
-    const nextMode = modes[nextIndex] || modes[0];
-    onChangeMode?.(nextMode);
-  };
-
-  const volumeChange = (value: number) => {
-    setVolume(value);
-  };
-
-  useEffect(() => {
-    const audio = audioRef.current;
-    if (audio) {
-      audio.volume = volume / 100;
-    }
-  }, [volume]);
-
-  const handleTouchStart = (e: React.TouchEvent) => {
-    startY.current = e.touches[0].clientY;
-    startX.current = e.touches[0].clientX;
-  };
-
-  const handleTouchMove = (e: React.TouchEvent) => {
-    const deltaY = e.touches[0].clientY - startY.current;
-    const deltaX = e.touches[0].clientX - startX.current;
-    const container = cardRef.current;
-    const header = cardRef.current?.querySelector('[data-header]');
-    const headerHeight = header?.clientHeight || 20;
-    const addHeight = (container?.clientHeight || headerHeight) - headerHeight;
-    const _shouldAdd = isCollapsed && deltaY < 0;
-    if (isSmallScreen) {
-      shouldAdd.current = _shouldAdd;
-      setTranslateY(_shouldAdd ? deltaY + addHeight : deltaY);
-    } else {
-      setTranslateX(deltaX);
-    }
-  };
-
-  const handleTouchEnd = () => {
-    if (isSmallScreen) {
-      const container = cardRef.current;
-      const header = cardRef.current?.querySelector('[data-header]');
-      const headerHeight = header?.clientHeight || 20;
-      const addHeight = (container?.clientHeight || headerHeight) - headerHeight;
-      const _translateY = translateY - (shouldAdd.current ? addHeight : 0);
-      if (_translateY > 100) {
-        setIsCollapsed(true);
-      } else if (_translateY < -100) {
-        setIsCollapsed(false);
-      }
-      setTranslateY(0);
-    } else {
-      if (translateX > 100) {
-        setIsCollapsed(true);
-      } else if (translateX < -100) {
-        setIsCollapsed(false);
-      }
-      setTranslateX(0);
-    }
-  };
-
-  const dragTranslate = isSmallScreen
-    ? translateY
-      ? `translateY(${translateY}px)`
-      : ''
-    : translateX
-      ? `translateX(${translateX}px)`
-      : '';
-  const collapsedTranslate = isCollapsed
-    ? isSmallScreen
-      ? 'translateY(90%)'
-      : 'translateX(96%)'
-    : '';
-
-  const translateStyle = dragTranslate || collapsedTranslate;
-
-  if (!src) return null;
-
-  return (
-    <div
-      className={clsx(
-        'fixed right-0 bottom-0 z-[52] w-full md:w-96',
-        !translateX && !translateY && 'transition-transform',
-        isCollapsed && 'md:hover:!translate-x-80'
-      )}
-      style={{
-        transform: translateStyle,
-      }}
-    >
-      <audio
-        src={src}
-        onLoadedData={handleLoadedData}
-        onTimeUpdate={handleTimeUpdate}
-        onPlay={handlePlay}
-        onPause={handlePause}
-        onEnded={onPlayEnd}
-        autoPlay={autoPlay ?? storageAutoPlay}
-        {...rest}
-        controls={false}
-        hidden
-        ref={audioRef}
-      />
-
-      <Card
-        ref={cardRef}
-        className={clsx(
-          'border-none bg-background/60 dark:bg-default-300/50 w-full max-w-full transform transition-transform backdrop-blur-md duration-300 overflow-visible',
-          isSmallScreen ? 'rounded-t-3xl' : 'md:rounded-l-xl'
-        )}
-        classNames={{
-          body: 'p-0',
-        }}
-        shadow='sm'
-        radius='none'
-      >
-        {isMediumUp && (
-          <Button
-            isIconOnly
-            className={clsx(
-              'absolute data-[hover]:bg-foreground/10 text-lg z-50',
-              isCollapsed
-                ? 'top-0 left-0 w-full h-full rounded-xl bg-opacity-0 hover:bg-opacity-30'
-                : 'top-3 -left-8 rounded-l-full bg-opacity-50 backdrop-blur-md'
-            )}
-            variant='solid'
-            color='primary'
-            size='sm'
-            onPress={() => setIsCollapsed(!isCollapsed)}
-          >
-            <FaRegHandPointRight />
-          </Button>
-        )}
-        {isSmallScreen && (
-          <CardHeader
-            data-header
-            className='flex-row justify-center pt-4'
-            onTouchStart={handleTouchStart}
-            onTouchMove={handleTouchMove}
-            onTouchEnd={handleTouchEnd}
-            onClick={() => setIsCollapsed(!isCollapsed)}
-          >
-            <div className='w-24 h-2 rounded-full bg-content2-foreground shadow-sm' />
-          </CardHeader>
-        )}
-        <CardBody>
-          <div className='grid grid-cols-6 md:grid-cols-12 gap-6 md:gap-4 items-center justify-center overflow-hidden p-6 md:p-2 m-0'>
-            <div className='relative col-span-6 md:col-span-4 flex justify-center'>
-              <Image
-                alt='Album cover'
-                className='object-cover'
-                classNames={{
-                  wrapper: 'w-36 aspect-square md:w-24 flex',
-                  img: 'block w-full h-full',
-                }}
-                shadow='md'
-                src={cover}
-                width='100%'
-              />
-            </div>
-
-            <div className='flex flex-col col-span-6 md:col-span-8'>
-              <div className='flex flex-col gap-0'>
-                <h1 className='font-medium truncate'>{title}</h1>
-                <p className='text-xs text-foreground/80 truncate'>{artist}</p>
-              </div>
-
-              <div className='flex flex-col'>
-                <Slider
-                  aria-label='Music progress'
-                  classNames={{
-                    track: 'bg-default-500/30 border-none',
-                    thumb: 'w-2 h-2 after:w-1.5 after:h-1.5',
-                    filler: 'rounded-full',
-                  }}
-                  color='foreground'
-                  value={currentProgress || 0}
-                  defaultValue={0}
-                  size='sm'
-                  onChange={(value) => {
-                    value = Array.isArray(value) ? value[0] : value;
-                    const audio = audioRef.current;
-                    if (audio) {
-                      audio.currentTime = (value / 100) * duration;
-                    }
-                  }}
-                />
-                <div className='flex justify-between h-3'>
-                  <p className='text-xs'>
-                    {Math.floor(currentTime / 60)}:
-                    {Math.floor(currentTime % 60)
-                      .toString()
-                      .padStart(2, '0')}
-                  </p>
-                  <p className='text-xs text-foreground/50'>
-                    {Math.floor(duration / 60)}:
-                    {Math.floor(duration % 60)
-                      .toString()
-                      .padStart(2, '0')}
-                  </p>
-                </div>
-              </div>
-
-              <div className='flex w-full items-center justify-center'>
-                <Tooltip
-                  content={
-                    mode === PlayMode.Loop
-                      ? '列表循环'
-                      : mode === PlayMode.Random
-                        ? '随机播放'
-                        : '单曲循环'
-                  }
-                >
-                  <Button
-                    isIconOnly
-                    className='data-[hover]:bg-foreground/10 text-lg md:text-medium'
-                    radius='full'
-                    variant='light'
-                    size='md'
-                    onPress={changeMode}
-                  >
-                    {mode === PlayMode.Loop && (
-                      <FaRepeat className='text-foreground/80' />
-                    )}
-                    {mode === PlayMode.Random && (
-                      <FaShuffle className='text-foreground/80' />
-                    )}
-                    {mode === PlayMode.Single && (
-                      <TbRepeatOnce className='text-foreground/80 text-xl' />
-                    )}
-                  </Button>
-                </Tooltip>
-                <Tooltip content='上一首'>
-                  <Button
-                    isIconOnly
-                    className='data-[hover]:bg-foreground/10 text-2xl md:text-xl'
-                    radius='full'
-                    variant='light'
-                    size='md'
-                    onPress={pressPrevious}
-                  >
-                    <BiSolidSkipPreviousCircle />
-                  </Button>
-                </Tooltip>
-                <Tooltip content={isPlaying ? '暂停' : '播放'}>
-                  <Button
-                    isIconOnly
-                    className='data-[hover]:bg-foreground/10 text-3xl md:text-3xl'
-                    radius='full'
-                    variant='light'
-                    size='lg'
-                    onPress={() => {
-                      if (isPlaying) {
-                        audioRef.current?.pause();
-                        setStorageAutoPlay(false);
-                      } else {
-                        audioRef.current?.play();
-                      }
-                    }}
-                  >
-                    {isPlaying ? <FaPause /> : <FaPlay className='ml-1' />}
-                  </Button>
-                </Tooltip>
-                <Tooltip content='下一首'>
-                  <Button
-                    isIconOnly
-                    className='data-[hover]:bg-foreground/10 text-2xl md:text-xl'
-                    radius='full'
-                    variant='light'
-                    size='md'
-                    onPress={pressNext}
-                  >
-                    <BiSolidSkipNextCircle />
-                  </Button>
-                </Tooltip>
-                <Popover
-                  placement='top'
-                  classNames={{
-                    content: 'bg-opacity-30 backdrop-blur-md',
-                  }}
-                >
-                  <PopoverTrigger>
-                    <Button
-                      isIconOnly
-                      className='data-[hover]:bg-foreground/10 text-xl md:text-xl'
-                      radius='full'
-                      variant='light'
-                      size='md'
-                    >
-                      <VolumeHighIcon />
-                    </Button>
-                  </PopoverTrigger>
-                  <PopoverContent>
-                    <Slider
-                      orientation='vertical'
-                      showTooltip
-                      aria-label='Volume'
-                      className='h-40'
-                      color='primary'
-                      defaultValue={volume}
-                      onChange={(value) => {
-                        value = Array.isArray(value) ? value[0] : value;
-                        volumeChange(value);
-                      }}
-                      startContent={<VolumeHighIcon className='text-2xl' />}
-                      size='sm'
-                      endContent={<VolumeLowIcon className='text-2xl' />}
-                    />
-                  </PopoverContent>
-                </Popover>
-              </div>
-            </div>
-          </div>
-        </CardBody>
-      </Card>
-    </div>
-  );
-}

napcat.webui/src/components/code_editor.tsx

@@ -1,55 +0,0 @@
-import Editor, { OnMount, loader } from '@monaco-editor/react';
-
-import React from 'react';
-
-import { useTheme } from '@/hooks/use-theme';
-
-import monaco from '@/monaco';
-
-loader.config({
-  monaco,
-  paths: {
-    vs: '/webui/monaco-editor/min/vs',
-  },
-});
-
-loader.config({
-  'vs/nls': {
-    availableLanguages: { '*': 'zh-cn' },
-  },
-});
-
-export interface CodeEditorProps extends React.ComponentProps<typeof Editor> {
-  test?: string
-}
-
-export type CodeEditorRef = monaco.editor.IStandaloneCodeEditor;
-
-const CodeEditor = React.forwardRef<CodeEditorRef, CodeEditorProps>(
-  (props, ref) => {
-    const { isDark } = useTheme();
-
-    const handleEditorDidMount: OnMount = (editor, monaco) => {
-      if (ref) {
-        if (typeof ref === 'function') {
-          ref(editor);
-        } else {
-          (ref as React.RefObject<CodeEditorRef>).current = editor;
-        }
-      }
-      if (props.onMount) {
-        props.onMount(editor, monaco);
-      }
-    };
-
-    return (
-      <Editor
-        {...props}
-        onMount={handleEditorDidMount}
-        theme={isDark ? 'vs-dark' : 'light'}
-      />
-    );
-  }
-);
-
-export default CodeEditor;

napcat.webui/src/components/display_card/common_card.tsx

@@ -1,137 +0,0 @@
-import { Button, ButtonGroup } from '@heroui/button';
-import { Switch } from '@heroui/switch';
-import { useState } from 'react';
-import { CgDebug } from 'react-icons/cg';
-import { FiEdit3 } from 'react-icons/fi';
-import { MdDeleteForever } from 'react-icons/md';
-
-import DisplayCardContainer from './container';
-
-type NetworkType = OneBotConfig['network'];
-
-export type NetworkDisplayCardFields<T extends keyof NetworkType> = Array<{
-  label: string
-  value: NetworkType[T][0][keyof NetworkType[T][0]]
-  render?: (
-    value: NetworkType[T][0][keyof NetworkType[T][0]]
-  ) => React.ReactNode
-}>;
-
-export interface NetworkDisplayCardProps<T extends keyof NetworkType> {
-  data: NetworkType[T][0]
-  showType?: boolean
-  typeLabel: string
-  fields: NetworkDisplayCardFields<T>
-  onEdit: () => void
-  onEnable: () => Promise<void>
-  onDelete: () => Promise<void>
-  onEnableDebug: () => Promise<void>
-}
-
-const NetworkDisplayCard = <T extends keyof NetworkType>({
-  data,
-  showType,
-  typeLabel,
-  fields,
-  onEdit,
-  onEnable,
-  onDelete,
-  onEnableDebug,
-}: NetworkDisplayCardProps<T>) => {
-  const { name, enable, debug } = data;
-  const [editing, setEditing] = useState(false);
-
-  const handleEnable = () => {
-    setEditing(true);
-    onEnable().finally(() => setEditing(false));
-  };
-
-  const handleDelete = () => {
-    setEditing(true);
-    onDelete().finally(() => setEditing(false));
-  };
-
-  const handleEnableDebug = () => {
-    setEditing(true);
-    onEnableDebug().finally(() => setEditing(false));
-  };
-
-  return (
-    <DisplayCardContainer
-      action={
-        <ButtonGroup
-          fullWidth
-          isDisabled={editing}
-          radius='sm'
-          size='sm'
-          variant='flat'
-        >
-          <Button
-            color='warning'
-            startContent={<FiEdit3 size={16} />}
-            onPress={onEdit}
-          >
-            编辑
-          </Button>
-
-          <Button
-            color={debug ? 'secondary' : 'success'}
-            variant='flat'
-            startContent={
-              <CgDebug
-                style={{
-                  width: '16px',
-                  height: '16px',
-                  minWidth: '16px',
-                  minHeight: '16px',
-                }}
-              />
-            }
-            onPress={handleEnableDebug}
-          >
-            {debug ? '关闭调试' : '开启调试'}
-          </Button>
-          <Button
-            className='bg-danger/20 text-danger hover:bg-danger/30 transition-colors'
-            variant='flat'
-            startContent={<MdDeleteForever size={16} />}
-            onPress={handleDelete}
-          >
-            删除
-          </Button>
-        </ButtonGroup>
-      }
-      enableSwitch={
-        <Switch
-          isDisabled={editing}
-          isSelected={enable}
-          onChange={handleEnable}
-        />
-      }
-      tag={showType && typeLabel}
-      title={name}
-    >
-      <div className='grid grid-cols-2 gap-1'>
-        {fields.map((field, index) => (
-          <div
-            key={index}
-            className={`flex items-center gap-2 ${
-              field.label === 'URL' ? 'col-span-2' : ''
-            }`}
-          >
-            <span className='text-default-400'>{field.label}</span>
-            {field.render
-              ? (
-                field.render(field.value)
-              )
-              : (
-                <span>{field.value}</span>
-              )}
-          </div>
-        ))}
-      </div>
-    </DisplayCardContainer>
-  );
-};
-
-export default NetworkDisplayCard;

napcat.webui/src/components/display_card/container.tsx

@@ -1,57 +0,0 @@
-import { Card, CardBody, CardFooter, CardHeader } from '@heroui/card';
-import clsx from 'clsx';
-
-import { title } from '../primitives';
-
-export interface ContainerProps {
-  title: string
-  tag?: React.ReactNode
-  action: React.ReactNode
-  enableSwitch: React.ReactNode
-  children: React.ReactNode
-}
-
-export interface DisplayCardProps {
-  showType?: boolean
-  onEdit: () => void
-  onEnable: () => Promise<void>
-  onDelete: () => Promise<void>
-  onEnableDebug: () => Promise<void>
-}
-
-const DisplayCardContainer: React.FC<ContainerProps> = ({
-  title: _title,
-  action,
-  tag,
-  enableSwitch,
-  children,
-}) => {
-  return (
-    <Card className='bg-opacity-50 backdrop-blur-sm'>
-      <CardHeader className='pb-0 flex items-center'>
-        {tag && (
-          <div className='text-center text-default-400 mb-1 absolute top-0 left-1/2 -translate-x-1/2 text-sm pointer-events-none bg-warning-100 dark:bg-warning-50 px-2 rounded-b'>
-            {tag}
-          </div>
-        )}
-        <h2
-          className={clsx(
-            title({
-              color: 'foreground',
-              size: 'xs',
-              shadow: true,
-            }),
-            'truncate'
-          )}
-        >
-          {_title}
-        </h2>
-        <div className='ml-auto'>{enableSwitch}</div>
-      </CardHeader>
-      <CardBody className='text-sm'>{children}</CardBody>
-      <CardFooter>{action}</CardFooter>
-    </Card>
-  );
-};
-
-export default DisplayCardContainer;

napcat.webui/src/components/display_network_item.tsx

@@ -1,58 +0,0 @@
-import { Card, CardBody } from '@heroui/card';
-import clsx from 'clsx';
-
-import { title } from '@/components/primitives';
-
-export interface NetworkItemDisplayProps {
-  count: number
-  label: string
-  size?: 'sm' | 'md'
-}
-
-const NetworkItemDisplay: React.FC<NetworkItemDisplayProps> = ({
-  count,
-  label,
-  size = 'md',
-}) => {
-  return (
-    <Card
-      className={clsx(
-        'bg-opacity-60 shadow-sm md:rounded-3xl',
-        size === 'md'
-          ? 'col-span-8 md:col-span-2 bg-primary-50 shadow-primary-100'
-          : 'col-span-2 md:col-span-1 bg-warning-100 shadow-warning-200'
-      )}
-      shadow='sm'
-    >
-      <CardBody className='items-center md:gap-1 p-1 md:p-2'>
-        <div
-          className={clsx(
-            'flex-1',
-            size === 'md' ? 'text-2xl md:text-3xl' : 'text-xl md:text-2xl',
-            title({
-              color: size === 'md' ? 'pink' : 'yellow',
-              size,
-            })
-          )}
-        >
-          {count}
-        </div>
-        <div
-          className={clsx(
-            'whitespace-nowrap text-nowrap flex-shrink-0',
-            size === 'md' ? 'text-sm md:text-base' : 'text-xs md:text-sm',
-            title({
-              color: size === 'md' ? 'pink' : 'yellow',
-              shadow: true,
-              size: 'xxs',
-            })
-          )}
-        >
-          {label}
-        </div>
-      </CardBody>
-    </Card>
-  );
-};
-
-export default NetworkItemDisplay;

napcat.webui/src/components/hitokoto.tsx

@@ -1,78 +0,0 @@
-import { Button } from '@heroui/button';
-import { Tooltip } from '@heroui/tooltip';
-import { useRequest } from 'ahooks';
-import toast from 'react-hot-toast';
-import { IoCopy, IoRefresh } from 'react-icons/io5';
-
-import { request } from '@/utils/request';
-
-import PageLoading from './page_loading';
-
-export default function Hitokoto () {
-  const {
-    data: dataOri,
-    error,
-    loading,
-    run,
-  } = useRequest(() => request.get<IHitokoto>('https://hitokoto.152710.xyz/'), {
-    pollingInterval: 10000,
-    throttleWait: 1000,
-  });
-  const data = dataOri?.data;
-  const onCopy = () => {
-    try {
-      const text = `${data?.hitokoto} —— ${data?.from} ${data?.from_who}`;
-      navigator.clipboard.writeText(text);
-      toast.success('复制成功');
-    } catch (_error) {
-      toast.error('复制失败, 请手动复制');
-    }
-  };
-  return (
-    <div>
-      <div className='relative'>
-        {loading && <PageLoading />}
-        {error
-          ? (
-            <div className='text-primary-400'>一言加载失败：{error.message}</div>
-          )
-          : (
-            <>
-              <div>{data?.hitokoto}</div>
-              <div className='text-right'>
-                —— <span className='text-default-400'>{data?.from}</span>{' '}
-                {data?.from_who}
-              </div>
-            </>
-          )}
-      </div>
-      <div className='flex gap-2'>
-        <Tooltip content='刷新' placement='top'>
-          <Button
-            onPress={run}
-            size='sm'
-            isLoading={loading}
-            isIconOnly
-            radius='full'
-            color='primary'
-            variant='flat'
-          >
-            <IoRefresh />
-          </Button>
-        </Tooltip>
-        <Tooltip content='复制' placement='top'>
-          <Button
-            onPress={onCopy}
-            size='sm'
-            isIconOnly
-            radius='full'
-            color='success'
-            variant='flat'
-          >
-            <IoCopy />
-          </Button>
-        </Tooltip>
-      </div>
-    </div>
-  );
-}

napcat.webui/src/components/onebot/api/debug.tsx

@@ -1,239 +0,0 @@
-import { Button } from '@heroui/button';
-import { Card, CardBody, CardHeader } from '@heroui/card';
-import { Input } from '@heroui/input';
-import { Snippet } from '@heroui/snippet';
-import { useLocalStorage } from '@uidotdev/usehooks';
-import { motion } from 'motion/react';
-import { useEffect, useRef, useState } from 'react';
-import toast from 'react-hot-toast';
-import { IoLink, IoSend } from 'react-icons/io5';
-import { PiCatDuotone } from 'react-icons/pi';
-
-import key from '@/const/key';
-import { OneBotHttpApiContent, OneBotHttpApiPath } from '@/const/ob_api';
-
-import ChatInputModal from '@/components/chat_input/modal';
-import CodeEditor from '@/components/code_editor';
-import PageLoading from '@/components/page_loading';
-
-import { request } from '@/utils/request';
-import { parseAxiosResponse } from '@/utils/url';
-import { generateDefaultJson, parse } from '@/utils/zod';
-
-import DisplayStruct from './display_struct';
-
-export interface OneBotApiDebugProps {
-  path: OneBotHttpApiPath;
-  data: OneBotHttpApiContent;
-}
-
-const OneBotApiDebug: React.FC<OneBotApiDebugProps> = (props) => {
-  const { path, data } = props;
-  const currentURL = new URL(window.location.origin);
-  currentURL.port = '3000';
-  const defaultHttpUrl = currentURL.href;
-  const [httpConfig, setHttpConfig] = useLocalStorage(key.httpDebugConfig, {
-    url: defaultHttpUrl,
-    token: '',
-  });
-  const [requestBody, setRequestBody] = useState('{}');
-  const [responseContent, setResponseContent] = useState('');
-  const [isCodeEditorOpen, setIsCodeEditorOpen] = useState(false);
-  const [isResponseOpen, setIsResponseOpen] = useState(false);
-  const [isFetching, setIsFetching] = useState(false);
-  const responseRef = useRef<HTMLDivElement>(null);
-  const parsedRequest = parse(data.request);
-  const parsedResponse = parse(data.response);
-
-  const sendRequest = async () => {
-    if (isFetching) return;
-    setIsFetching(true);
-    const r = toast.loading('正在发送请求...');
-    try {
-      const parsedRequestBody = JSON.parse(requestBody);
-      const requestURL = new URL(httpConfig.url);
-      requestURL.pathname = path;
-      request
-        .post(requestURL.href, parsedRequestBody, {
-          headers: {
-            Authorization: `Bearer ${httpConfig.token}`,
-          },
-          responseType: 'text',
-        })
-        .then((res) => {
-          setResponseContent(parseAxiosResponse(res));
-          toast.success('请求发送完成，请查看响应');
-        })
-        .catch((err) => {
-          toast.error('请求发送失败：' + err.message);
-          setResponseContent(parseAxiosResponse(err.response));
-        })
-        .finally(() => {
-          setIsFetching(false);
-          setIsResponseOpen(true);
-          responseRef.current?.scrollIntoView({
-            behavior: 'smooth',
-            block: 'start',
-          });
-          toast.dismiss(r);
-        });
-    } catch (_error) {
-      toast.error('请求体 JSON 格式错误');
-      setIsFetching(false);
-      toast.dismiss(r);
-    }
-  };
-
-  useEffect(() => {
-    setRequestBody(generateDefaultJson(data.request));
-    setResponseContent('');
-  }, [path]);
-
-  return (
-    <section className='p-4 pt-14 rounded-lg shadow-md'>
-      <h1 className='text-2xl font-bold mb-4 flex items-center gap-1 text-primary-400'>
-        <PiCatDuotone />
-        {data.description}
-      </h1>
-      <h1 className='text-lg font-bold mb-4'>
-        <Snippet
-          className='bg-default-50 bg-opacity-50 backdrop-blur-md'
-          symbol={<IoLink size={18} className='inline-block mr-1' />}
-          tooltipProps={{
-            content: '点击复制地址',
-          }}
-        >
-          {path}
-        </Snippet>
-      </h1>
-      <div className='flex gap-2 items-center'>
-        <Input
-          label='HTTP URL'
-          placeholder='输入 HTTP URL'
-          value={httpConfig.url}
-          onChange={(e) =>
-            setHttpConfig({ ...httpConfig, url: e.target.value })}
-        />
-        <Input
-          label='Token'
-          placeholder='输入 Token'
-          value={httpConfig.token}
-          onChange={(e) =>
-            setHttpConfig({ ...httpConfig, token: e.target.value })}
-        />
-        <Button
-          onPress={sendRequest}
-          color='primary'
-          size='lg'
-          radius='full'
-          isIconOnly
-          isDisabled={isFetching}
-        >
-          <IoSend />
-        </Button>
-      </div>
-      <Card
-        shadow='sm'
-        className='my-4 bg-opacity-50 backdrop-blur-md overflow-visible'
-      >
-        <CardHeader className='font-bold text-lg gap-1 pb-0'>
-          <span className='mr-2'>请求体</span>
-          <Button
-            color='warning'
-            variant='flat'
-            onPress={() => setIsCodeEditorOpen(!isCodeEditorOpen)}
-            size='sm'
-            radius='full'
-          >
-            {isCodeEditorOpen ? '收起' : '展开'}
-          </Button>
-        </CardHeader>
-        <CardBody>
-          <motion.div
-            ref={responseRef}
-            initial={{ opacity: 0, height: 0 }}
-            animate={{
-              opacity: isCodeEditorOpen ? 1 : 0,
-              height: isCodeEditorOpen ? 'auto' : 0,
-            }}
-          >
-            <CodeEditor
-              value={requestBody}
-              onChange={(value) => setRequestBody(value ?? '')}
-              language='json'
-              height='400px'
-            />
-
-            <div className='flex justify-end gap-1'>
-              <ChatInputModal />
-              <Button
-                color='primary'
-                variant='flat'
-                onPress={() =>
-                  setRequestBody(generateDefaultJson(data.request))}
-              >
-                填充示例请求体
-              </Button>
-            </div>
-          </motion.div>
-        </CardBody>
-      </Card>
-      <Card
-        shadow='sm'
-        className='my-4 relative bg-opacity-50 backdrop-blur-md'
-      >
-        <PageLoading loading={isFetching} />
-        <CardHeader className='font-bold text-lg gap-1 pb-0'>
-          <span className='mr-2'>响应</span>
-          <Button
-            color='warning'
-            variant='flat'
-            onPress={() => setIsResponseOpen(!isResponseOpen)}
-            size='sm'
-            radius='full'
-          >
-            {isResponseOpen ? '收起' : '展开'}
-          </Button>
-          <Button
-            color='success'
-            variant='flat'
-            onPress={() => {
-              navigator.clipboard.writeText(responseContent);
-              toast.success('响应内容已复制到剪贴板');
-            }}
-            size='sm'
-            radius='full'
-          >
-            复制
-          </Button>
-        </CardHeader>
-        <CardBody>
-          <motion.div
-            className='overflow-y-auto text-sm'
-            initial={{ opacity: 0, height: 0 }}
-            animate={{
-              opacity: isResponseOpen ? 1 : 0,
-              height: isResponseOpen ? 300 : 0,
-            }}
-          >
-            <pre>
-              <code>
-                {responseContent || (
-                  <div className='text-gray-400'>暂无响应</div>
-                )}
-              </code>
-            </pre>
-          </motion.div>
-        </CardBody>
-      </Card>
-      <div className='p-2 md:p-4 border border-default-50 dark:border-default-200 rounded-lg backdrop-blur-sm'>
-        <h2 className='text-xl font-semibold mb-2'>请求体结构</h2>
-        <DisplayStruct schema={parsedRequest} />
-        <h2 className='text-xl font-semibold mt-4 mb-2'>响应体结构</h2>
-        <DisplayStruct schema={parsedResponse} />
-      </div>
-    </section>
-  );
-};
-
-export default OneBotApiDebug;

napcat.webui/src/components/onebot/api/nav_list.tsx

@@ -1,86 +0,0 @@
-import { Card, CardBody } from '@heroui/card';
-import { Input } from '@heroui/input';
-import clsx from 'clsx';
-import { motion } from 'motion/react';
-import { useState } from 'react';
-
-import type { OneBotHttpApi, OneBotHttpApiPath } from '@/const/ob_api';
-
-export interface OneBotApiNavListProps {
-  data: OneBotHttpApi
-  selectedApi: OneBotHttpApiPath
-  onSelect: (apiName: OneBotHttpApiPath) => void
-  openSideBar: boolean
-}
-
-const OneBotApiNavList: React.FC<OneBotApiNavListProps> = (props) => {
-  const { data, selectedApi, onSelect, openSideBar } = props;
-  const [searchValue, setSearchValue] = useState('');
-  return (
-    <motion.div
-      className={clsx(
-        'h-[calc(100vh-3.5rem)] left-0 !overflow-hidden md:w-auto z-20 top-[3.3rem] md:top-[3rem] absolute md:sticky md:float-start',
-        openSideBar && 'bg-background bg-opacity-20 backdrop-blur-md'
-      )}
-      initial={{ width: 0 }}
-      transition={{
-        type: openSideBar ? 'spring' : 'tween',
-        stiffness: 150,
-        damping: 15,
-      }}
-      animate={{ width: openSideBar ? '16rem' : '0rem' }}
-      style={{ overflowY: openSideBar ? 'auto' : 'hidden' }}
-    >
-      <div className='w-64 h-full overflow-y-auto px-2 pt-2 pb-10 md:pb-0'>
-        <Input
-          className='sticky top-0 z-10 text-primary-600'
-          classNames={{
-            inputWrapper:
-              'bg-opacity-30 bg-primary-50 backdrop-blur-sm border border-primary-300 mb-2',
-            input: 'bg-transparent !text-primary-400 !placeholder-primary-400',
-          }}
-          radius='full'
-          placeholder='搜索 API'
-          value={searchValue}
-          onChange={(e) => setSearchValue(e.target.value)}
-          isClearable
-          onClear={() => setSearchValue('')}
-        />
-        {Object.entries(data).map(([apiName, api]) => (
-          <Card
-            key={apiName}
-            shadow='none'
-            className={clsx(
-              'w-full border border-primary-100 rounded-lg mb-1 bg-opacity-30 backdrop-blur-sm text-primary-400',
-              {
-                hidden: !(
-                  apiName.includes(searchValue) ||
-                  api.description?.includes(searchValue)
-                ),
-              },
-              {
-                '!bg-opacity-40 border border-primary-400 bg-primary-50 text-primary-600':
-                  apiName === selectedApi,
-              }
-            )}
-            isPressable
-            onPress={() => onSelect(apiName as OneBotHttpApiPath)}
-          >
-            <CardBody>
-              <h2 className='font-bold'>{api.description}</h2>
-              <div
-                className={clsx('text-sm text-primary-200', {
-                  '!text-primary-400': apiName === selectedApi,
-                })}
-              >
-                {apiName}
-              </div>
-            </CardBody>
-          </Card>
-        ))}
-      </div>
-    </motion.div>
-  );
-};
-
-export default OneBotApiNavList;

napcat.webui/src/components/page_background.tsx

@@ -1,24 +0,0 @@
-import { Image } from '@heroui/image';
-
-import bkg_color from '@/assets/images/bkg-color.png';
-
-const PageBackground = () => {
-  return (
-    <>
-      <div className='fixed w-full h-full -z-[0] flex justify-end opacity-80'>
-        <Image
-          className='overflow-hidden object-contain -top-42 h-[160%] -right-[30%] -rotate-45 pointer-events-none select-none -z-10 relative'
-          src={bkg_color}
-        />
-      </div>
-      <div className='fixed w-full h-full overflow-hidden -z-[0] hue-rotate-90 flex justify-start opacity-80'>
-        <Image
-          className='relative -top-92 h-[180%] object-contain pointer-events-none rotate-90 select-none -z-10 top-44'
-          src={bkg_color}
-        />
-      </div>
-    </>
-  );
-};
-
-export default PageBackground;

napcat.webui/src/components/qq_info_card.tsx

@@ -1,63 +0,0 @@
-import { Card, CardBody } from '@heroui/card';
-import { Image } from '@heroui/image';
-import clsx from 'clsx';
-import { BsTencentQq } from 'react-icons/bs';
-
-import { SelfInfo } from '@/types/user';
-
-import PageLoading from './page_loading';
-
-export interface QQInfoCardProps {
-  data?: SelfInfo
-  error?: Error
-  loading?: boolean
-}
-
-const QQInfoCard: React.FC<QQInfoCardProps> = ({ data, error, loading }) => {
-  return (
-    <Card
-      className='relative bg-primary-100 bg-opacity-60 overflow-hidden flex-shrink-0 shadow-md shadow-primary-300 dark:shadow-primary-50'
-      shadow='none'
-      radius='lg'
-    >
-      <PageLoading loading={loading} />
-      {error
-        ? (
-          <CardBody className='items-center gap-1 justify-center'>
-            <div className='flex-1 text-content1-foreground'>Error</div>
-            <div className='whitespace-nowrap text-nowrap flex-shrink-0'>
-              {error.message}
-            </div>
-          </CardBody>
-        )
-        : (
-          <CardBody className='flex-row items-center gap-2 overflow-hidden relative'>
-            <div className='absolute right-0 bottom-0 text-5xl text-primary-400'>
-              <BsTencentQq />
-            </div>
-            <div className='relative flex-shrink-0 z-10'>
-              <Image
-                src={
-                data?.avatarUrl ??
-                `https://q1.qlogo.cn/g?b=qq&nk=${data?.uin}&s=1`
-              }
-                className='shadow-md rounded-full w-12 aspect-square'
-              />
-              <div
-                className={clsx(
-                  'w-4 h-4 rounded-full absolute right-0.5 bottom-0 border-2 border-primary-100 z-10',
-                  data?.online ? 'bg-green-500' : 'bg-gray-500'
-                )}
-              />
-            </div>
-            <div className='flex-col justify-center'>
-              <div className='text-lg truncate'>{data?.nick}</div>
-              <div className='text-primary-500 text-sm'>{data?.uin}</div>
-            </div>
-          </CardBody>
-        )}
-    </Card>
-  );
-};
-
-export default QQInfoCard;

napcat.webui/src/components/sidebar/index.tsx

@@ -1,93 +0,0 @@
-import { Button } from '@heroui/button';
-import { Image } from '@heroui/image';
-import clsx from 'clsx';
-import { motion } from 'motion/react';
-import React from 'react';
-import { IoMdLogOut } from 'react-icons/io';
-import { MdDarkMode, MdLightMode } from 'react-icons/md';
-
-import useAuth from '@/hooks/auth';
-import useDialog from '@/hooks/use-dialog';
-import { useTheme } from '@/hooks/use-theme';
-
-import logo from '@/assets/images/logo.png';
-import type { MenuItem } from '@/config/site';
-
-import Menus from './menus';
-
-interface SideBarProps {
-  open: boolean
-  items: MenuItem[]
-}
-
-const SideBar: React.FC<SideBarProps> = (props) => {
-  const { open, items } = props;
-  const { toggleTheme, isDark } = useTheme();
-  const { revokeAuth } = useAuth();
-  const dialog = useDialog();
-  const onRevokeAuth = () => {
-    dialog.confirm({
-      title: '退出登录',
-      content: '确定要退出登录吗？',
-      onConfirm: revokeAuth,
-    });
-  };
-  return (
-    <motion.div
-      className={clsx(
-        'overflow-hidden fixed top-0 left-0 h-full z-50 bg-background md:bg-transparent md:static shadow-md md:shadow-none rounded-r-md md:rounded-none'
-      )}
-      initial={{ width: 0 }}
-      animate={{ width: open ? '16rem' : 0 }}
-      transition={{
-        type: open ? 'spring' : 'tween',
-        stiffness: 150,
-        damping: open ? 15 : 10,
-      }}
-      style={{ overflow: 'hidden' }}
-    >
-      <motion.div className='w-64 flex flex-col items-stretch h-full transition-transform duration-300 ease-in-out z-30 relative float-right'>
-        <div className='flex justify-center items-center my-2 gap-2'>
-          <Image radius='none' height={40} src={logo} className='mb-2' />
-          <div
-            className={clsx(
-              'flex items-center font-bold',
-              '!text-2xl shiny-text'
-            )}
-          >
-            NapCat
-          </div>
-        </div>
-        <div className='overflow-y-auto flex flex-col flex-1 px-4'>
-          <Menus items={items} />
-          <div className='mt-auto mb-10 md:mb-0'>
-            <Button
-              className='w-full'
-              color='primary'
-              radius='full'
-              variant='light'
-              onPress={toggleTheme}
-              startContent={
-                !isDark ? <MdLightMode size={16} /> : <MdDarkMode size={16} />
-              }
-            >
-              切换主题
-            </Button>
-            <Button
-              className='w-full mb-2'
-              color='primary'
-              radius='full'
-              variant='light'
-              onPress={onRevokeAuth}
-              startContent={<IoMdLogOut size={16} />}
-            >
-              退出登录
-            </Button>
-          </div>
-        </div>
-      </motion.div>
-    </motion.div>
-  );
-};
-
-export default SideBar;

napcat.webui/src/components/system_info.tsx

@@ -1,282 +0,0 @@
-import { Button } from '@heroui/button';
-import { Card, CardBody, CardHeader } from '@heroui/card';
-import { Chip } from '@heroui/chip';
-import { Spinner } from '@heroui/spinner';
-import { Tooltip } from '@heroui/tooltip';
-import { useRequest } from 'ahooks';
-import { useEffect } from 'react';
-import { BsStars } from 'react-icons/bs';
-import { FaCircleInfo, FaInfo, FaQq } from 'react-icons/fa6';
-import { IoLogoChrome, IoLogoOctocat } from 'react-icons/io';
-import { RiMacFill } from 'react-icons/ri';
-
-import useDialog from '@/hooks/use-dialog';
-
-import { request } from '@/utils/request';
-import { compareVersion } from '@/utils/version';
-
-import WebUIManager from '@/controllers/webui_manager';
-import { GithubRelease } from '@/types/github';
-
-import TailwindMarkdown from './tailwind_markdown';
-
-export interface SystemInfoItemProps {
-  title: string
-  icon?: React.ReactNode
-  value?: React.ReactNode
-  endContent?: React.ReactNode
-}
-
-const SystemInfoItem: React.FC<SystemInfoItemProps> = ({
-  title,
-  value = '--',
-  icon,
-  endContent,
-}) => {
-  return (
-    <div className='flex text-sm gap-1 p-2 items-center shadow-sm shadow-primary-100 dark:shadow-primary-100 rounded text-primary-400'>
-      {icon}
-      <div className='w-24'>{title}</div>
-      <div className='text-primary-200'>{value}</div>
-      <div className='ml-auto'>{endContent}</div>
-    </div>
-  );
-};
-
-export interface NewVersionTipProps {
-  currentVersion?: string
-}
-
-const NewVersionTip = (props: NewVersionTipProps) => {
-  const { currentVersion } = props;
-  const dialog = useDialog();
-  const { data: releaseData, error } = useRequest(() =>
-    request.get<GithubRelease[]>(
-      'https://api.github.com/repos/NapNeko/NapCatQQ/releases'
-    )
-  );
-
-  if (error) {
-    return (
-      <Tooltip content='检查新版本失败'>
-        <Button
-          isIconOnly
-          radius='full'
-          color='primary'
-          variant='shadow'
-          className='!w-5 !h-5 !min-w-0 text-small shadow-md'
-          onPress={() => {
-            dialog.alert({
-              title: '检查新版本失败',
-              content: error.message,
-            });
-          }}
-        >
-          <FaInfo />
-        </Button>
-      </Tooltip>
-    );
-  }
-
-  const latestVersion = releaseData?.data?.[0]?.tag_name;
-
-  if (!latestVersion || !currentVersion) {
-    return null;
-  }
-
-  if (compareVersion(latestVersion, currentVersion) <= 0) {
-    return null;
-  }
-
-  const middleVersions: GithubRelease[] = [];
-
-  for (let i = 0; i < releaseData.data.length; i++) {
-    const versionInfo = releaseData.data[i];
-    if (compareVersion(versionInfo.tag_name, currentVersion) > 0) {
-      middleVersions.push(versionInfo);
-    } else {
-      break;
-    }
-  }
-
-  const AISummaryComponent = () => {
-    const {
-      data: aiSummaryData,
-      loading: aiSummaryLoading,
-      error: aiSummaryError,
-      run: runAiSummary,
-    } = useRequest(
-      (version) =>
-        request.get<ServerResponse<string | null>>(
-          `https://release.nc.152710.xyz/?version=${version}`,
-          {
-            timeout: 30000,
-          }
-        ),
-      {
-        manual: true,
-      }
-    );
-
-    useEffect(() => {
-      runAiSummary(currentVersion);
-    }, [currentVersion, runAiSummary]);
-
-    if (aiSummaryLoading) {
-      return (
-        <div className='flex justify-center py-1'>
-          <Spinner size='sm' />
-        </div>
-      );
-    }
-    if (aiSummaryError) {
-      return <div className='text-center text-primary-500'>AI 摘要获取失败</div>;
-    }
-    return <span className='text-default-700'>{aiSummaryData?.data.data}</span>;
-  };
-
-  return (
-    <Tooltip content='有新版本可用'>
-      <Button
-        isIconOnly
-        radius='full'
-        color='primary'
-        variant='shadow'
-        className='!w-5 !h-5 !min-w-0 text-small shadow-md'
-        onPress={() => {
-          dialog.confirm({
-            title: '有新版本可用',
-            content: (
-              <div className='space-y-2'>
-                <div className='text-sm space-x-2'>
-                  <span>当前版本</span>
-                  <Chip color='primary' variant='flat'>
-                    v{currentVersion}
-                  </Chip>
-                </div>
-                <div className='text-sm space-x-2'>
-                  <span>最新版本</span>
-                  <Chip color='primary'>{latestVersion}</Chip>
-                </div>
-                <div className='p-2 rounded-md bg-content2 text-sm'>
-                  <div className='text-primary-400 font-bold flex items-center gap-1 mb-1'>
-                    <BsStars />
-                    <span>AI总结</span>
-                  </div>
-                  <AISummaryComponent />
-                </div>
-                <div className='text-sm space-y-2 !mt-4'>
-                  {middleVersions.map((versionInfo) => (
-                    <div
-                      key={versionInfo.tag_name}
-                      className='p-4 bg-content1 rounded-md shadow-small'
-                    >
-                      <TailwindMarkdown content={versionInfo.body} />
-                    </div>
-                  ))}
-                </div>
-              </div>
-            ),
-            scrollBehavior: 'inside',
-            size: '3xl',
-            confirmText: '前往下载',
-            onConfirm () {
-              window.open(
-                'https://github.com/NapNeko/NapCatQQ/releases',
-                '_blank',
-                'noopener'
-              );
-            },
-          });
-        }}
-      >
-        <FaInfo />
-      </Button>
-    </Tooltip>
-  );
-};
-
-const NapCatVersion = () => {
-  const {
-    data: packageData,
-    loading: packageLoading,
-    error: packageError,
-  } = useRequest(WebUIManager.getPackageInfo);
-
-  const currentVersion = packageData?.version;
-
-  return (
-    <SystemInfoItem
-      title='NapCat 版本'
-      icon={<IoLogoOctocat className='text-xl' />}
-      value={
-        packageError
-          ? (
-          `错误：${packageError.message}`
-          )
-          : packageLoading
-            ? (
-              <Spinner size='sm' />
-            )
-            : (
-              currentVersion
-            )
-      }
-      endContent={<NewVersionTip currentVersion={currentVersion} />}
-    />
-  );
-};
-
-export interface SystemInfoProps {
-  archInfo?: string
-}
-const SystemInfo: React.FC<SystemInfoProps> = (props) => {
-  const { archInfo } = props;
-  const {
-    data: qqVersionData,
-    loading: qqVersionLoading,
-    error: qqVersionError,
-  } = useRequest(WebUIManager.getQQVersion);
-  return (
-    <Card className='bg-opacity-60 shadow-sm shadow-primary-100 dark:shadow-primary-100 overflow-visible flex-1'>
-      <CardHeader className='pb-0 items-center gap-1 text-primary-500 font-extrabold'>
-        <FaCircleInfo className='text-lg' />
-        <span>系统信息</span>
-      </CardHeader>
-      <CardBody className='flex-1'>
-        <div className='flex flex-col justify-between h-full'>
-          <NapCatVersion />
-          <SystemInfoItem
-            title='QQ 版本'
-            icon={<FaQq className='text-lg' />}
-            value={
-              qqVersionError
-                ? (
-                `错误：${qqVersionError.message}`
-                )
-                : qqVersionLoading
-                  ? (
-                    <Spinner size='sm' />
-                  )
-                  : (
-                    qqVersionData
-                  )
-            }
-          />
-          <SystemInfoItem
-            title='WebUI 版本'
-            icon={<IoLogoChrome className='text-xl' />}
-            value='Next'
-          />
-          <SystemInfoItem
-            title='系统版本'
-            icon={<RiMacFill className='text-xl' />}
-            value={archInfo}
-          />
-        </div>
-      </CardBody>
-    </Card>
-  );
-};
-
-export default SystemInfo;

napcat.webui/src/components/usage_pie.tsx

@@ -1,143 +0,0 @@
-import * as echarts from 'echarts';
-import React, { useEffect, useRef } from 'react';
-
-import { useTheme } from '@/hooks/use-theme';
-
-interface UsagePieProps {
-  systemUsage: number
-  processUsage: number
-  title?: string
-}
-
-const defaultOption: echarts.EChartsOption = {
-  tooltip: {
-    trigger: 'item',
-    formatter: '<center>{b}<br/><b>{d}%</b></center>',
-    borderRadius: 10,
-    extraCssText: 'backdrop-filter: blur(10px);',
-  },
-  series: [
-    {
-      name: '系统占用',
-      type: 'pie',
-      radius: ['70%', '90%'],
-      avoidLabelOverlap: false,
-      label: {
-        show: true,
-        position: 'center',
-        formatter: '系统占用',
-        fontSize: 14,
-      },
-      itemStyle: {
-        borderWidth: 1,
-        borderRadius: 10,
-      },
-      labelLine: {
-        show: false,
-      },
-      data: [
-        {
-          value: 100,
-          name: '系统总量',
-        },
-      ],
-    },
-  ],
-};
-
-const UsagePie: React.FC<UsagePieProps> = ({
-  systemUsage,
-  processUsage,
-  title,
-}) => {
-  const chartRef = useRef<HTMLDivElement>(null);
-  const chartInstance = useRef<echarts.ECharts | null>(null);
-  const { theme } = useTheme();
-
-  useEffect(() => {
-    if (chartRef.current) {
-      chartInstance.current = echarts.init(chartRef.current);
-      const option = defaultOption;
-      chartInstance.current.setOption(option);
-      const observer = new ResizeObserver(() => {
-        chartInstance.current?.resize();
-      });
-      observer.observe(chartRef.current);
-      return () => {
-        chartInstance.current?.dispose();
-        observer.disconnect();
-      };
-    }
-  }, []);
-
-  useEffect(() => {
-    if (chartInstance.current) {
-      chartInstance.current.setOption({
-        series: [
-          {
-            label: {
-              formatter: title,
-            },
-          },
-        ],
-      });
-    }
-  }, [title]);
-
-  useEffect(() => {
-    if (chartInstance.current) {
-      chartInstance.current.setOption({
-        darkMode: theme === 'dark',
-        tooltip: {
-          backgroundColor:
-            theme === 'dark'
-              ? 'rgba(0, 0, 0, 0.8)'
-              : 'rgba(255, 255, 255, 0.8)',
-          textStyle: {
-            color: theme === 'dark' ? '#fff' : '#333',
-          },
-        },
-        color:
-          theme === 'dark'
-            ? ['#D33FF0', '#EF8664', '#E25180']
-            : ['#D33FF0', '#EA7D9B', '#FFC107'],
-        series: [
-          {
-            itemStyle: {
-              borderColor: theme === 'dark' ? '#333' : '#F0A9A7',
-            },
-          },
-        ],
-      });
-    }
-  }, [theme]);
-
-  useEffect(() => {
-    if (chartInstance.current) {
-      chartInstance.current.setOption({
-        series: [
-          {
-            data: [
-              {
-                value: processUsage,
-                name: 'QQ占用',
-              },
-              {
-                value: systemUsage - processUsage,
-                name: '其他进程占用',
-              },
-              {
-                value: 100 - systemUsage,
-                name: '剩余系统总量',
-              },
-            ],
-          },
-        ],
-      });
-    }
-  }, [systemUsage, processUsage]);
-
-  return <div ref={chartRef} className='w-36 h-36 flex-shrink-0' />;
-};
-
-export default UsagePie;

napcat.webui/src/config/site.tsx

@@ -1,112 +0,0 @@
-import {
-  BugIcon2,
-  FileIcon,
-  InfoIcon,
-  LogIcon,
-  RouteIcon,
-  SettingsIcon,
-  SignalTowerIcon,
-  TerminalIcon,
-} from '@/components/icons';
-
-export type SiteConfig = typeof siteConfig;
-export interface MenuItem {
-  label: string
-  icon?: React.ReactNode
-  autoOpen?: boolean
-  href?: string
-  items?: MenuItem[]
-  customIcon?: string
-}
-
-export const siteConfig = {
-  name: 'NapCat WebUI',
-  description: 'NapCat WebUI.',
-  navItems: [
-    {
-      label: '基础信息',
-      icon: (
-        <div className='w-5 h-5'>
-          <RouteIcon />
-        </div>
-      ),
-      href: '/',
-    },
-    {
-      label: '网络配置',
-      icon: (
-        <div className='w-5 h-5'>
-          <SignalTowerIcon />
-        </div>
-      ),
-      href: '/network',
-    },
-    {
-      label: '其他配置',
-      icon: (
-        <div className='w-5 h-5'>
-          <SettingsIcon />
-        </div>
-      ),
-      href: '/config',
-    },
-    {
-      label: '猫猫日志',
-      icon: (
-        <div className='w-5 h-5'>
-          <LogIcon />
-        </div>
-      ),
-      href: '/logs',
-    },
-    {
-      label: '接口调试',
-      icon: (
-        <div className='w-5 h-5'>
-          <BugIcon2 />
-        </div>
-      ),
-      items: [
-        {
-          label: 'HTTP',
-          href: '/debug/http',
-        },
-        {
-          label: 'Websocket',
-          href: '/debug/ws',
-        },
-      ],
-    },
-    {
-      label: '文件管理',
-      icon: (
-        <div className='w-5 h-5'>
-          <FileIcon />
-        </div>
-      ),
-      href: '/file_manager',
-    },
-    {
-      label: '系统终端',
-      icon: (
-        <div className='w-5 h-5'>
-          <TerminalIcon />
-        </div>
-      ),
-      href: '/terminal',
-    },
-    {
-      label: '关于我们',
-      icon: (
-        <div className='w-5 h-5'>
-          <InfoIcon />
-        </div>
-      ),
-      href: '/about',
-    },
-  ] as MenuItem[],
-  links: {
-    github: 'https://github.com/NapNeko/NapCatQQ',
-    docs: 'https://napcat.napneko.icu/',
-  },
-};

napcat.webui/src/contexts/songs.tsx

@@ -1,91 +0,0 @@
-// Songs Context
-import { useLocalStorage } from '@uidotdev/usehooks';
-import { createContext, useEffect, useState } from 'react';
-
-import { PlayMode } from '@/const/enum';
-import key from '@/const/key';
-
-import AudioPlayer from '@/components/audio_player';
-
-import { get163MusicListSongs, getNextMusic } from '@/utils/music';
-
-import type { FinalMusic } from '@/types/music';
-
-export interface MusicContextProps {
-  setListId: (id: string) => void
-  listId: string
-  onNext: () => void
-  onPrevious: () => void
-}
-
-export interface MusicProviderProps {
-  children: React.ReactNode
-}
-
-export const AudioContext = createContext<MusicContextProps>({
-  setListId: () => {},
-  listId: '5438670983',
-  onNext: () => {},
-  onPrevious: () => {},
-});
-
-const AudioProvider: React.FC<MusicProviderProps> = ({ children }) => {
-  const [listId, setListId] = useLocalStorage(key.musicID, '5438670983');
-  const [musicList, setMusicList] = useState<FinalMusic[]>([]);
-  const [musicId, setMusicId] = useState<number>(0);
-  const [playMode, setPlayMode] = useState<PlayMode>(PlayMode.Loop);
-  const music = musicList.find((music) => music.id === musicId);
-  const [token] = useLocalStorage(key.token, '');
-  const onNext = () => {
-    const nextID = getNextMusic(musicList, musicId, playMode);
-    setMusicId(nextID);
-  };
-  const onPrevious = () => {
-    const index = musicList.findIndex((music) => music.id === musicId);
-    if (index === 0) {
-      setMusicId(musicList[musicList.length - 1].id);
-    } else {
-      setMusicId(musicList[index - 1].id);
-    }
-  };
-  const onPlayEnd = () => {
-    const nextID = getNextMusic(musicList, musicId, playMode);
-    setMusicId(nextID);
-  };
-  const changeMode = (mode: PlayMode) => {
-    setPlayMode(mode);
-  };
-  const fetchMusicList = async (id: string) => {
-    const res = await get163MusicListSongs(id);
-    setMusicList(res);
-    setMusicId(res[0].id);
-  };
-  useEffect(() => {
-    if (listId && token) fetchMusicList(listId);
-  }, [listId, token]);
-  return (
-    <AudioContext.Provider
-      value={{
-        setListId,
-        listId,
-        onNext,
-        onPrevious,
-      }}
-    >
-      <AudioPlayer
-        title={music?.title}
-        src={music?.url || ''}
-        artist={music?.artist}
-        cover={music?.cover}
-        mode={playMode}
-        pressNext={onNext}
-        pressPrevious={onPrevious}
-        onPlayEnd={onPlayEnd}
-        onChangeMode={changeMode}
-      />
-      {children}
-    </AudioContext.Provider>
-  );
-};
-
-export default AudioProvider;

napcat.webui/src/hooks/use-music.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-
-import { AudioContext } from '@/contexts/songs';
-
-const useMusic = () => {
-  const music = React.useContext(AudioContext);
-
-  return music;
-};
-
-export default useMusic;

napcat.webui/src/monaco.ts

@@ -1,33 +0,0 @@
-import * as monaco from 'monaco-editor';
-import editorWorker from 'monaco-editor/esm/vs/editor/editor.worker?worker';
-import cssWorker from 'monaco-editor/esm/vs/language/css/css.worker?worker';
-import htmlWorker from 'monaco-editor/esm/vs/language/html/html.worker?worker';
-import jsonWorker from 'monaco-editor/esm/vs/language/json/json.worker?worker';
-import tsWorker from 'monaco-editor/esm/vs/language/typescript/ts.worker?worker';
-
-self.MonacoEnvironment = {
-  getWorker (_: unknown, label: string) {
-    if (label === 'json') {
-      // eslint-disable-next-line new-cap
-      return new jsonWorker();
-    }
-    if (label === 'css' || label === 'scss' || label === 'less') {
-      // eslint-disable-next-line new-cap
-      return new cssWorker();
-    }
-    if (label === 'html' || label === 'handlebars' || label === 'razor') {
-      // eslint-disable-next-line new-cap
-      return new htmlWorker();
-    }
-    if (label === 'typescript' || label === 'javascript') {
-      // eslint-disable-next-line new-cap
-      return new tsWorker();
-    }
-    // eslint-disable-next-line new-cap
-    return new editorWorker();
-  },
-};
-
-monaco.languages.typescript.typescriptDefaults.setEagerModelSync(true);
-
-export default monaco;

napcat.webui/src/pages/dashboard/about.tsx

@@ -1,204 +0,0 @@
-import { Card, CardBody } from '@heroui/card';
-import { Image } from '@heroui/image';
-import { Link } from '@heroui/link';
-import { Skeleton } from '@heroui/skeleton';
-import { Spinner } from '@heroui/spinner';
-import { useRequest } from 'ahooks';
-import { useMemo } from 'react';
-import { BsTelegram, BsTencentQq } from 'react-icons/bs';
-import { IoDocument } from 'react-icons/io5';
-
-import HoverTiltedCard from '@/components/hover_titled_card';
-import NapCatRepoInfo from '@/components/napcat_repo_info';
-import RotatingText from '@/components/rotating_text';
-
-import { usePreloadImages } from '@/hooks/use-preload-images';
-import { useTheme } from '@/hooks/use-theme';
-
-import logo from '@/assets/images/logo.png';
-import WebUIManager from '@/controllers/webui_manager';
-
-function VersionInfo () {
-  const { data, loading, error } = useRequest(WebUIManager.getPackageInfo);
-  return (
-    <div className='flex items-center gap-2 text-2xl font-bold'>
-      <div className='flex items-center gap-2'>
-        <div className='text-primary-500 drop-shadow-md'>NapCat</div>
-        {error
-          ? (
-            error.message
-          )
-          : loading
-            ? (
-              <Spinner size='sm' />
-            )
-            : (
-              <RotatingText
-                texts={['WebUI', data?.version ?? '']}
-                mainClassName='overflow-hidden flex items-center bg-primary-500 px-2 rounded-lg text-default-50 shadow-md'
-                staggerFrom='last'
-                initial={{ y: '100%' }}
-                animate={{ y: 0 }}
-                exit={{ y: '-120%' }}
-                staggerDuration={0.025}
-                splitLevelClassName='overflow-hidden'
-                transition={{ type: 'spring', damping: 30, stiffness: 400 }}
-                rotationInterval={2000}
-              />
-            )}
-      </div>
-    </div>
-  );
-}
-
-export default function AboutPage () {
-  const { isDark } = useTheme();
-
-  const imageUrls = useMemo(
-    () => [
-      'https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?repo_id=777721566&limit=30&image_size=auto&color_scheme=light',
-      'https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?repo_id=777721566&limit=30&image_size=auto&color_scheme=dark',
-      'https://next.ossinsight.io/widgets/official/compose-activity-trends/thumbnail.png?repo_id=41986369&image_size=auto&color_scheme=light',
-      'https://next.ossinsight.io/widgets/official/compose-activity-trends/thumbnail.png?repo_id=41986369&image_size=auto&color_scheme=dark',
-    ],
-    []
-  );
-
-  const { loadedUrls, isLoading } = usePreloadImages(imageUrls);
-
-  const getImageUrl = useMemo(
-    () => (baseUrl: string) => {
-      const theme = isDark ? 'dark' : 'light';
-      const fullUrl = baseUrl.replace(
-        /color_scheme=(?:light|dark)/,
-        `color_scheme=${theme}`
-      );
-      return isLoading ? null : loadedUrls[fullUrl] ? fullUrl : null;
-    },
-    [isDark, isLoading, loadedUrls]
-  );
-
-  const renderImage = useMemo(
-    () => (baseUrl: string, alt: string) => {
-      const imageUrl = getImageUrl(baseUrl);
-
-      if (!imageUrl) {
-        return <Skeleton className='h-16 rounded-lg' />;
-      }
-
-      return (
-        <Image
-          className='flex-1 pointer-events-none select-none rounded-none'
-          src={imageUrl}
-          alt={alt}
-        />
-      );
-    },
-    [getImageUrl]
-  );
-
-  return (
-    <>
-      <title>关于 NapCat WebUI</title>
-      <section className='max-w-7xl py-8 md:py-10 px-5 mx-auto space-y-10'>
-        <div className='w-full flex flex-col md:flex-row gap-4'>
-          <div className='flex flex-col md:flex-row items-center'>
-            <HoverTiltedCard imageSrc={logo} overlayContent='' />
-          </div>
-          <div className='flex-1 flex flex-col gap-2 py-2'>
-            <VersionInfo />
-            <div className='space-y-1'>
-              <p className='font-bold text-primary-400'>NapCat 是什么?</p>
-              <p className='text-default-800'>
-                基于TypeScript构建的Bot框架,通过相应的启动器或者框架,主动调用QQ
-                Node模块提供给客户端的接口,实现Bot的功能.
-              </p>
-              <p className='font-bold text-primary-400'>魔法版介绍</p>
-              <p className='text-default-800'>
-                猫猫框架通过魔法的手段获得了 QQ 的发送消息、接收消息等接口。
-                为了方便使用，猫猫框架将通过一种名为 OneBot 的约定将你的 HTTP /
-                WebSocket 请求按照规范读取，
-                再去调用猫猫框架所获得的QQ发送接口之类的接口。
-              </p>
-            </div>
-          </div>
-        </div>
-        <div className='flex flex-row gap-2 flex-wrap justify-around'>
-          <Card
-            as={Link}
-            shadow='sm'
-            isPressable
-            isExternal
-            href='https://qm.qq.com/q/F9cgs1N3Mc'
-          >
-            <CardBody className='flex-row items-center gap-2'>
-              <span className='p-2 rounded-small bg-primary-50 text-primary-500'>
-                <BsTencentQq size={16} />
-              </span>
-              <span>官方社群1</span>
-            </CardBody>
-          </Card>
-
-          <Card
-            as={Link}
-            shadow='sm'
-            isPressable
-            isExternal
-            href='https://qm.qq.com/q/hSt0u9PVn'
-          >
-            <CardBody className='flex-row items-center gap-2'>
-              <span className='p-2 rounded-small bg-primary-50 text-primary-500'>
-                <BsTencentQq size={16} />
-              </span>
-              <span>官方社群2</span>
-            </CardBody>
-          </Card>
-
-          <Card
-            as={Link}
-            shadow='sm'
-            isPressable
-            isExternal
-            href='https://t.me/napcatqq'
-          >
-            <CardBody className='flex-row items-center gap-2'>
-              <span className='p-2 rounded-small bg-primary-50 text-primary-500'>
-                <BsTelegram size={16} />
-              </span>
-              <span>Telegram</span>
-            </CardBody>
-          </Card>
-
-          <Card
-            as={Link}
-            shadow='sm'
-            isPressable
-            isExternal
-            href='https://napcat.napneko.icu/'
-          >
-            <CardBody className='flex-row items-center gap-2'>
-              <span className='p-2 rounded-small bg-primary-50 text-primary-500'>
-                <IoDocument size={16} />
-              </span>
-              <span>使用文档</span>
-            </CardBody>
-          </Card>
-        </div>
-        <div className='flex flex-col md:flex-row md:items-start gap-4'>
-          <div className='w-full flex flex-col gap-4'>
-            {renderImage(
-              'https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?repo_id=777721566&limit=30&image_size=auto&color_scheme=light',
-              'Contributors'
-            )}
-            {renderImage(
-              'https://next.ossinsight.io/widgets/official/compose-activity-trends/thumbnail.png?repo_id=41986369&image_size=auto&color_scheme=light',
-              'Activity Trends'
-            )}
-          </div>
-
-          <NapCatRepoInfo />
-        </div>
-      </section>
-    </>
-  );
-}

napcat.webui/src/pages/dashboard/config/index.tsx

@@ -1,100 +0,0 @@
-import { Card, CardBody } from '@heroui/card';
-import { Tab, Tabs } from '@heroui/tabs';
-import clsx from 'clsx';
-import { useMediaQuery } from 'react-responsive';
-import { useNavigate, useSearchParams } from 'react-router-dom';
-
-import ChangePasswordCard from './change_password';
-import LoginConfigCard from './login';
-import OneBotConfigCard from './onebot';
-import ServerConfigCard from './server';
-import ThemeConfigCard from './theme';
-import WebUIConfigCard from './webui';
-
-export interface ConfigPageProps {
-  children?: React.ReactNode
-  size?: 'sm' | 'md' | 'lg'
-}
-
-const ConfingPageItem: React.FC<ConfigPageProps> = ({
-  children,
-  size = 'md',
-}) => {
-  return (
-    <Card className='bg-opacity-50 backdrop-blur-sm'>
-      <CardBody className='items-center py-5'>
-        <div
-          className={clsx('max-w-full flex flex-col gap-2', {
-            'w-72': size === 'sm',
-            'w-96': size === 'md',
-            'w-[32rem]': size === 'lg',
-          })}
-        >
-          {children}
-        </div>
-      </CardBody>
-    </Card>
-  );
-};
-
-export default function ConfigPage () {
-  const isMediumUp = useMediaQuery({ minWidth: 768 });
-  const navigate = useNavigate();
-  const search = useSearchParams({
-    tab: 'onebot',
-  })[0];
-  const tab = search.get('tab') ?? 'onebot';
-
-  return (
-    <section className='w-[1000px] max-w-full md:mx-auto gap-4 py-8 px-2 md:py-10'>
-      <Tabs
-        aria-label='config tab'
-        fullWidth
-        className='w-full'
-        isVertical={isMediumUp}
-        selectedKey={tab}
-        onSelectionChange={(key) => {
-          navigate(`/config?tab=${key}`);
-        }}
-        classNames={{
-          tabList: 'sticky flex top-14 bg-opacity-50 backdrop-blur-sm',
-          panel: 'w-full relative',
-          base: 'md:!w-auto flex-grow-0 flex-shrink-0 mr-0',
-          cursor: 'bg-opacity-60 backdrop-blur-sm',
-        }}
-      >
-        <Tab title='OneBot配置' key='onebot'>
-          <ConfingPageItem>
-            <OneBotConfigCard />
-          </ConfingPageItem>
-        </Tab>
-        <Tab title='服务器配置' key='server'>
-          <ConfingPageItem>
-            <ServerConfigCard />
-          </ConfingPageItem>
-        </Tab>
-        <Tab title='WebUI配置' key='webui'>
-          <ConfingPageItem>
-            <WebUIConfigCard />
-          </ConfingPageItem>
-        </Tab>
-        <Tab title='登录配置' key='login'>
-          <ConfingPageItem>
-            <LoginConfigCard />
-          </ConfingPageItem>
-        </Tab>
-        <Tab title='修改密码' key='token'>
-          <ConfingPageItem>
-            <ChangePasswordCard />
-          </ConfingPageItem>
-        </Tab>
-
-        <Tab title='主题配置' key='theme'>
-          <ConfingPageItem size='lg'>
-            <ThemeConfigCard />
-          </ConfingPageItem>
-        </Tab>
-      </Tabs>
-    </section>
-  );
-}

napcat.webui/src/pages/dashboard/config/theme.tsx

@@ -1,282 +0,0 @@
-import { Accordion, AccordionItem } from '@heroui/accordion';
-import { Card, CardBody, CardHeader } from '@heroui/card';
-import { useRequest } from 'ahooks';
-import clsx from 'clsx';
-import { useEffect, useRef } from 'react';
-import { Controller, useForm, useWatch } from 'react-hook-form';
-import toast from 'react-hot-toast';
-import { FaUserAstronaut } from 'react-icons/fa';
-import { FaPaintbrush } from 'react-icons/fa6';
-import { IoIosColorPalette } from 'react-icons/io';
-import { MdDarkMode, MdLightMode } from 'react-icons/md';
-
-import themes from '@/const/themes';
-
-import ColorPicker from '@/components/ColorPicker';
-import SaveButtons from '@/components/button/save_buttons';
-import PageLoading from '@/components/page_loading';
-
-import { colorKeys, generateTheme, loadTheme } from '@/utils/theme';
-
-import WebUIManager from '@/controllers/webui_manager';
-
-export type PreviewThemeCardProps = {
-  theme: ThemeInfo;
-  onPreview: () => void;
-};
-
-const values = [
-  '',
-  '-50',
-  '-100',
-  '-200',
-  '-300',
-  '-400',
-  '-500',
-  '-600',
-  '-700',
-  '-800',
-  '-900',
-];
-const colors = [
-  'primary',
-  'secondary',
-  'success',
-  'danger',
-  'warning',
-  'default',
-];
-
-function PreviewThemeCard ({ theme, onPreview }: PreviewThemeCardProps) {
-  const style = document.createElement('style');
-  style.innerHTML = generateTheme(theme.theme, theme.name);
-  const cardRef = useRef<HTMLDivElement>(null);
-  useEffect(() => {
-    document.head.appendChild(style);
-    return () => {
-      document.head.removeChild(style);
-    };
-  }, []);
-  return (
-    <Card
-      ref={cardRef}
-      shadow='sm'
-      radius='sm'
-      isPressable
-      onPress={onPreview}
-      className={clsx('text-primary bg-primary-50', theme.name)}
-    >
-      <CardHeader className='pb-0 flex flex-col items-start gap-1'>
-        <div className='px-1 rounded-md bg-primary text-primary-foreground'>
-          {theme.name}
-        </div>
-        <div className='text-xs flex items-center gap-1 text-primary-300'>
-          <FaUserAstronaut />
-          {theme.author ?? '未知'}
-        </div>
-        <div className='text-xs text-primary-200'>{theme.description}</div>
-      </CardHeader>
-      <CardBody>
-        <div className='flex flex-col gap-1'>
-          {colors.map((color) => (
-            <div className='flex gap-1 items-center flex-wrap' key={color}>
-              <div className='text-xs w-4 text-right'>
-                {color[0].toUpperCase()}
-              </div>
-              {values.map((value) => (
-                <div
-                  key={value}
-                  className={clsx(
-                    'w-2 h-2 rounded-full shadow-small',
-                    `bg-${color}${value}`
-                  )}
-                />
-              ))}
-            </div>
-          ))}
-        </div>
-      </CardBody>
-    </Card>
-  );
-}
-
-const ThemeConfigCard = () => {
-  const { data, loading, error, refreshAsync } = useRequest(
-    WebUIManager.getThemeConfig
-  );
-  const {
-    control,
-    handleSubmit: handleOnebotSubmit,
-    formState: { isSubmitting },
-    setValue: setOnebotValue,
-  } = useForm<{
-    theme: ThemeConfig;
-  }>({
-    defaultValues: {
-      theme: {
-        dark: {},
-        light: {},
-      },
-    },
-  });
-
-  // 使用 useRef 存储 style 标签引用
-  const styleTagRef = useRef<HTMLStyleElement | null>(null);
-
-  // 在组件挂载时创建 style 标签，并在卸载时清理
-  useEffect(() => {
-    const styleTag = document.createElement('style');
-    document.head.appendChild(styleTag);
-    styleTagRef.current = styleTag;
-    return () => {
-      if (styleTagRef.current) {
-        document.head.removeChild(styleTagRef.current);
-      }
-    };
-  }, []);
-
-  const theme = useWatch({ control, name: 'theme' });
-
-  const reset = () => {
-    if (data) setOnebotValue('theme', data);
-  };
-
-  const onSubmit = handleOnebotSubmit(async (data) => {
-    try {
-      await WebUIManager.setThemeConfig(data.theme);
-      toast.success('保存成功');
-      loadTheme();
-    } catch (error) {
-      const msg = (error as Error).message;
-      toast.error(`保存失败: ${msg}`);
-    }
-  });
-
-  const onRefresh = async () => {
-    try {
-      await refreshAsync();
-      toast.success('刷新成功');
-    } catch (error) {
-      const msg = (error as Error).message;
-      toast.error(`刷新失败: ${msg}`);
-    }
-  };
-
-  useEffect(() => {
-    reset();
-  }, [data]);
-
-  useEffect(() => {
-    if (theme && styleTagRef.current) {
-      const css = generateTheme(theme);
-      styleTagRef.current.innerHTML = css;
-    }
-  }, [theme]);
-
-  if (loading) return <PageLoading loading />;
-
-  if (error) {
-    return (
-      <div className='py-24 text-danger-500 text-center'>{error.message}</div>
-    );
-  }
-
-  return (
-    <>
-      <title>主题配置 - NapCat WebUI</title>
-
-      <SaveButtons
-        onSubmit={onSubmit}
-        reset={reset}
-        isSubmitting={isSubmitting}
-        refresh={onRefresh}
-        className='items-end w-full p-4'
-      />
-      <div className='px-4 text-sm text-default-600'>实时预览，记得保存！</div>
-      <Accordion variant='splitted' defaultExpandedKeys={['select']}>
-        <AccordionItem
-          key='select'
-          aria-label='Pick Color'
-          title='选择主题'
-          subtitle='可以切换夜间/白昼模式查看对应颜色'
-          className='shadow-small'
-          startContent={<IoIosColorPalette />}
-        >
-          <div className='flex flex-wrap gap-2'>
-            {themes.map((theme) => (
-              <PreviewThemeCard
-                key={theme.name}
-                theme={theme}
-                onPreview={() => {
-                  setOnebotValue('theme', theme.theme);
-                }}
-              />
-            ))}
-          </div>
-        </AccordionItem>
-
-        <AccordionItem
-          key='pick'
-          aria-label='Pick Color'
-          title='自定义配色'
-          className='shadow-small'
-          startContent={<FaPaintbrush />}
-        >
-          <div className='space-y-2'>
-            {(['dark', 'light'] as const).map((mode) => (
-              <div
-                key={mode}
-                className={clsx(
-                  'p-2 rounded-md',
-                  mode === 'dark' ? 'text-white' : 'text-black',
-                  mode === 'dark'
-                    ? 'bg-content1-foreground dark:bg-content1'
-                    : 'bg-content1 dark:bg-content1-foreground'
-                )}
-              >
-                <h3 className='text-center p-2 rounded-md bg-content2 mb-2 text-default-800 flex items-center justify-center'>
-                  {mode === 'dark'
-                    ? (
-                      <MdDarkMode size={24} />
-                    )
-                    : (
-                      <MdLightMode size={24} />
-                    )}
-                  {mode === 'dark' ? '夜间模式主题' : '白昼模式主题'}
-                </h3>
-                {colorKeys.map((key) => (
-                  <div
-                    key={key}
-                    className='grid grid-cols-2 items-center mb-2 gap-2'
-                  >
-                    <label className='text-right'>{key}</label>
-                    <Controller
-                      control={control}
-                      name={`theme.${mode}.${key}`}
-                      render={({ field: { value, onChange } }) => {
-                        const hslArray = value?.split(' ') ?? [0, 0, 0];
-                        const color = `hsl(${hslArray[0]}, ${hslArray[1]}, ${hslArray[2]})`;
-                        return (
-                          <ColorPicker
-                            color={color}
-                            onChange={(result) => {
-                              onChange(
-                                `${result.hsl.h} ${result.hsl.s * 100}% ${result.hsl.l * 100}%`
-                              );
-                            }}
-                          />
-                        );
-                      }}
-                    />
-                  </div>
-                ))}
-              </div>
-            ))}
-          </div>
-        </AccordionItem>
-      </Accordion>
-    </>
-  );
-};
-
-export default ThemeConfigCard;

napcat.webui/src/pages/dashboard/config/webui.tsx

@@ -1,137 +0,0 @@
-import { Input } from '@heroui/input';
-import { useLocalStorage } from '@uidotdev/usehooks';
-import { useEffect } from 'react';
-import { Controller, useForm } from 'react-hook-form';
-import toast from 'react-hot-toast';
-
-import key from '@/const/key';
-
-import SaveButtons from '@/components/button/save_buttons';
-import FileInput from '@/components/input/file_input';
-import ImageInput from '@/components/input/image_input';
-
-import useMusic from '@/hooks/use-music';
-
-import { siteConfig } from '@/config/site';
-import FileManager from '@/controllers/file_manager';
-
-const WebUIConfigCard = () => {
-  const {
-    control,
-    handleSubmit: handleWebuiSubmit,
-    formState: { isSubmitting },
-    setValue: setWebuiValue,
-  } = useForm<IConfig['webui']>({
-    defaultValues: {
-      background: '',
-      musicListID: '',
-      customIcons: {},
-    },
-  });
-
-  const [b64img, setB64img] = useLocalStorage(key.backgroundImage, '');
-  const [customIcons, setCustomIcons] = useLocalStorage<Record<string, string>>(
-    key.customIcons,
-    {}
-  );
-  const { setListId, listId } = useMusic();
-
-  const reset = () => {
-    setWebuiValue('musicListID', listId);
-    setWebuiValue('customIcons', customIcons);
-    setWebuiValue('background', b64img);
-  };
-
-  const onSubmit = handleWebuiSubmit((data) => {
-    try {
-      setListId(data.musicListID);
-      setCustomIcons(data.customIcons);
-      setB64img(data.background);
-      toast.success('保存成功');
-    } catch (error) {
-      const msg = (error as Error).message;
-      toast.error(`保存失败: ${msg}`);
-    }
-  });
-
-  useEffect(() => {
-    reset();
-  }, [listId, customIcons, b64img]);
-
-  return (
-    <>
-      <title>WebUI配置 - NapCat WebUI</title>
-      <div className='flex flex-col gap-2'>
-        <div className='flex-shrink-0 w-full'>WebUI字体</div>
-        <div className='text-sm text-default-400'>
-          此项不需要手动保存，上传成功后需清空网页缓存并刷新
-          <FileInput
-            label='中文字体'
-            onChange={async (file) => {
-              try {
-                await FileManager.uploadWebUIFont(file);
-                toast.success('上传成功');
-                setTimeout(() => {
-                  window.location.reload();
-                }, 1000);
-              } catch (error) {
-                toast.error('上传失败: ' + (error as Error).message);
-              }
-            }}
-            onDelete={async () => {
-              try {
-                await FileManager.deleteWebUIFont();
-                toast.success('删除成功');
-                setTimeout(() => {
-                  window.location.reload();
-                }, 1000);
-              } catch (error) {
-                toast.error('删除失败: ' + (error as Error).message);
-              }
-            }}
-          />
-        </div>
-      </div>
-      <div className='flex flex-col gap-2'>
-        <div className='flex-shrink-0 w-full'>WebUI音乐播放器</div>
-        <Controller
-          control={control}
-          name='musicListID'
-          render={({ field }) => (
-            <Input
-              {...field}
-              label='网易云音乐歌单ID（网页内音乐播放器）'
-              placeholder='请输入歌单ID'
-            />
-          )}
-        />
-      </div>
-      <div className='flex flex-col gap-2'>
-        <div className='flex-shrink-0 w-full'>背景图</div>
-        <Controller
-          control={control}
-          name='background'
-          render={({ field }) => <ImageInput {...field} />}
-        />
-      </div>
-      <div className='flex flex-col gap-2'>
-        <div>自定义图标</div>
-        {siteConfig.navItems.map((item) => (
-          <Controller
-            key={item.label}
-            control={control}
-            name={`customIcons.${item.label}`}
-            render={({ field }) => <ImageInput {...field} label={item.label} />}
-          />
-        ))}
-      </div>
-      <SaveButtons
-        onSubmit={onSubmit}
-        reset={reset}
-        isSubmitting={isSubmitting}
-      />
-    </>
-  );
-};
-
-export default WebUIConfigCard;

napcat.webui/src/pages/dashboard/debug/http/index.tsx

@@ -1,63 +0,0 @@
-import { Button } from '@heroui/button';
-import clsx from 'clsx';
-import { motion } from 'motion/react';
-import { useEffect, useRef, useState } from 'react';
-import { TbSquareRoundedChevronLeftFilled } from 'react-icons/tb';
-
-import oneBotHttpApi from '@/const/ob_api';
-import type { OneBotHttpApi } from '@/const/ob_api';
-
-import OneBotApiDebug from '@/components/onebot/api/debug';
-import OneBotApiNavList from '@/components/onebot/api/nav_list';
-
-export default function HttpDebug () {
-  const [selectedApi, setSelectedApi] =
-    useState<keyof OneBotHttpApi>('/set_qq_profile');
-  const data = oneBotHttpApi[selectedApi];
-  const contentRef = useRef<HTMLDivElement>(null);
-  const [openSideBar, setOpenSideBar] = useState(true);
-
-  useEffect(() => {
-    contentRef?.current?.scrollTo?.({
-      top: 0,
-      behavior: 'smooth',
-    });
-  }, [selectedApi]);
-
-  return (
-    <>
-      <title>HTTP调试 - NapCat WebUI</title>
-      <OneBotApiNavList
-        data={oneBotHttpApi}
-        selectedApi={selectedApi}
-        onSelect={setSelectedApi}
-        openSideBar={openSideBar}
-      />
-      <div ref={contentRef} className='flex-1 h-full overflow-x-hidden'>
-        <motion.div
-          className='absolute top-16 z-30 md:!ml-4'
-          animate={{ marginLeft: openSideBar ? '16rem' : '1rem' }}
-          transition={{ type: 'spring', stiffness: 150, damping: 15 }}
-        >
-          <Button
-            isIconOnly
-            color='primary'
-            radius='md'
-            variant='shadow'
-            size='sm'
-            onPress={() => setOpenSideBar(!openSideBar)}
-          >
-            <TbSquareRoundedChevronLeftFilled
-              size={24}
-              className={clsx(
-                'transition-transform',
-                openSideBar ? '' : 'transform rotate-180'
-              )}
-            />
-          </Button>
-        </motion.div>
-        <OneBotApiDebug path={selectedApi} data={data} />
-      </div>
-    </>
-  );
-}

napcat.webui/src/pages/dashboard/debug/websocket/index.tsx

@@ -1,95 +0,0 @@
-import { Button } from '@heroui/button';
-import { Card, CardBody } from '@heroui/card';
-import { Input } from '@heroui/input';
-import { useLocalStorage } from '@uidotdev/usehooks';
-import { useCallback, useState } from 'react';
-import toast from 'react-hot-toast';
-
-import key from '@/const/key';
-
-import OneBotMessageList from '@/components/onebot/message_list';
-import OneBotSendModal from '@/components/onebot/send_modal';
-import WSStatus from '@/components/onebot/ws_status';
-
-import { useWebSocketDebug } from '@/hooks/use-websocket-debug';
-
-export default function WSDebug () {
-  const url = new URL(window.location.origin);
-  url.port = '3001';
-  url.protocol = 'ws:';
-  const defaultWsUrl = url.href;
-  const [socketConfig, setSocketConfig] = useLocalStorage(key.wsDebugConfig, {
-    url: defaultWsUrl,
-    token: '',
-  });
-  const [inputUrl, setInputUrl] = useState(socketConfig.url);
-  const [inputToken, setInputToken] = useState(socketConfig.token);
-
-  const { sendMessage, readyState, FilterMessagesType, filteredMessages } =
-    useWebSocketDebug(socketConfig.url, socketConfig.token);
-
-  const handleConnect = useCallback(() => {
-    if (!inputUrl.startsWith('ws://') && !inputUrl.startsWith('wss://')) {
-      toast.error('WebSocket URL 不合法');
-      return;
-    }
-    setSocketConfig({
-      url: inputUrl,
-      token: inputToken,
-    });
-  }, [inputUrl, inputToken]);
-
-  return (
-    <>
-      <title>Websocket调试 - NapCat WebUI</title>
-      <div className='h-[calc(100vh-4rem)] overflow-hidden flex flex-col'>
-        <Card className='mx-2 mt-2 flex-shrink-0 bg-opacity-50 backdrop-blur-sm'>
-          <CardBody className='gap-2'>
-            <div className='grid gap-2 items-center md:grid-cols-5'>
-              <Input
-                className='col-span-2'
-                label='WebSocket URL'
-                type='text'
-                value={inputUrl}
-                onChange={(e) => setInputUrl(e.target.value)}
-                placeholder='输入 WebSocket URL'
-              />
-              <Input
-                className='col-span-2'
-                label='Token'
-                type='text'
-                value={inputToken}
-                onChange={(e) => setInputToken(e.target.value)}
-                placeholder='输入 Token'
-              />
-              <div className='flex-shrink-0 flex gap-2 col-span-2 md:col-span-1'>
-                <Button
-                  color='primary'
-                  onPress={handleConnect}
-                  size='lg'
-                  radius='full'
-                  className='w-full md:w-auto'
-                >
-                  连接
-                </Button>
-              </div>
-            </div>
-            <div className='p-2 border border-default-100 bg-content1 bg-opacity-50 rounded-md dark:bg-[rgb(30,30,30)]'>
-              <div className='grid gap-2 md:grid-cols-5 items-center md:w-fit'>
-                <WSStatus state={readyState} />
-                <div className='md:w-64 max-w-full col-span-2'>
-                  {FilterMessagesType}
-                </div>
-                <OneBotSendModal sendMessage={sendMessage} />
-              </div>
-            </div>
-          </CardBody>
-        </Card>
-
-        <div className='flex-1 overflow-hidden'>
-          <OneBotMessageList messages={filteredMessages} />
-        </div>
-      </div>
-    </>
-  );
-}

napcat.webui/src/styles/fonts.css

@@ -1,13 +0,0 @@
-@font-face {
-  font-family: 'Aa偷吃可爱长大的';
-  src: url('/fonts/AaCute.woff') format('woff');
-}
-@font-face {
-  font-family: 'JetBrains Mono';
-  src: url('/fonts/JetBrainsMono.ttf') format('truetype');
-}
-@font-face {
-  font-family: 'JetBrains Mono';
-  src: url('/fonts/JetBrainsMono-Italic.ttf') format('truetype');
-  font-style: italic;
-}

napcat.webui/src/styles/globals.css

@@ -1,102 +0,0 @@
-@import url('./fonts.css');
-@import url('./text.css');
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-body {
-  font-family:
-    'Aa偷吃可爱长大的',
-    PingFang SC,
-    Helvetica Neue,
-    Microsoft YaHei,
-    sans-serif !important;
-    -webkit-font-smoothing: antialiased;
-    -moz-osx-font-smoothing: grayscale;
-    text-rendering: optimizeLegibility;
-    font-smooth: always;
-}
-
-@layer components {
-  .hide-scrollbar::-webkit-scrollbar {
-    width: 0 !important;
-    height: 0 !important;
-  }
-  .hide-scrollbar::-webkit-scrollbar-thumb {
-    width: 0 !important;
-    height: 0 !important;
-    background-color: transparent !important;
-  }
-  .hide-scrollbar::-webkit-scrollbar-track {
-    width: 0 !important;
-    height: 0 !important;
-    background-color: transparent !important;
-  }
-}
-
-::-webkit-scrollbar {
-  width: 8px;
-  height: 8px;
-}
-
-::-webkit-scrollbar-track {
-  background-color: transparent;
-  -webkit-border-radius: 2em;
-  -moz-border-radius: 2em;
-  border-radius: 2em;
-}
-
-::-webkit-scrollbar-thumb {
-  background-color: rgb(147, 147, 153, 0.5);
-  -webkit-border-radius: 2em;
-  -moz-border-radius: 2em;
-  border-radius: 2em;
-}
-
-.monaco-editor {
-  outline: none !important;
-  border-radius: 5px !important;
-  overflow: hidden !important;
-}
-
-.monaco-editor,
-.monaco-editor-background {
-  background-color: transparent !important;
-}
-
-.monaco-editor .margin {
-  background-color: transparent !important;
-}
-
-.minimap canvas:nth-child(2) {
-  opacity: 0.5;
-}
-
-.monaco-editor .scroll-decoration {
-  --vscode-scrollbar-shadow: rgba(0, 0, 0, 0.2);
-}
-
-.monaco-editor .decorationsOverviewRuler {
-  opacity: 0.5;
-}
-
-.monaco-editor .view-overlays .current-line-exact {
-  border-color: rgba(0, 0, 0, 0.2) !important;
-  border-radius: 5px !important;
-}
-
-.context-view.monaco-menu-container * {
-  font-family:
-    PingFang SC,
-    'Aa偷吃可爱长大的',
-    Helvetica Neue,
-    Microsoft YaHei,
-    sans-serif !important;
-}
-
-.ql-hidden {
-  @apply hidden;
-}
-.ql-editor img {
-  @apply inline-block;
-}

napcat.webui/src/types/server.d.ts

@@ -1,191 +0,0 @@
-interface ServerResponse<T> {
-  code: number
-  data: T
-  message: string
-}
-
-interface AuthResponse {
-  Credential: string
-}
-
-interface LoginListItem {
-  uin: string
-  uid: string
-  nickName: string
-  faceUrl: string
-  facePath: string
-  loginType: 1 // 1是二维码登录？
-  isQuickLogin: boolean // 是否可以快速登录
-  isAutoLogin: boolean // 是否可以自动登录
-}
-
-interface PackageInfo {
-  name: string
-  version: string
-  private: boolean
-  type: string
-  scripts: Record<string, string>
-  dependencies: Record<string, string>
-  devDependencies: Record<string, string>
-}
-
-interface SystemStatus {
-  cpu: {
-    core: number
-    model: string
-    speed: string
-    usage: {
-      system: string
-      qq: string
-    }
-  }
-  memory: {
-    total: string
-    usage: {
-      system: string
-      qq: string
-    }
-  }
-  arch: string
-}
-
-interface ThemeConfigItem {
-  '--heroui-background': string
-  '--heroui-foreground-50': string
-  '--heroui-foreground-100': string
-  '--heroui-foreground-200': string
-  '--heroui-foreground-300': string
-  '--heroui-foreground-400': string
-  '--heroui-foreground-500': string
-  '--heroui-foreground-600': string
-  '--heroui-foreground-700': string
-  '--heroui-foreground-800': string
-  '--heroui-foreground-900': string
-  '--heroui-foreground': string
-  '--heroui-focus': string
-  '--heroui-overlay': string
-  '--heroui-divider': string
-  '--heroui-divider-opacity': string
-  '--heroui-content1': string
-  '--heroui-content1-foreground': string
-  '--heroui-content2': string
-  '--heroui-content2-foreground': string
-  '--heroui-content3': string
-  '--heroui-content3-foreground': string
-  '--heroui-content4': string
-  '--heroui-content4-foreground': string
-  '--heroui-default-50': string
-  '--heroui-default-100': string
-  '--heroui-default-200': string
-  '--heroui-default-300': string
-  '--heroui-default-400': string
-  '--heroui-default-500': string
-  '--heroui-default-600': string
-  '--heroui-default-700': string
-  '--heroui-default-800': string
-  '--heroui-default-900': string
-  '--heroui-default-foreground': string
-  '--heroui-default': string
-  // 新增 danger
-  '--heroui-danger-50': string
-  '--heroui-danger-100': string
-  '--heroui-danger-200': string
-  '--heroui-danger-300': string
-  '--heroui-danger-400': string
-  '--heroui-danger-500': string
-  '--heroui-danger-600': string
-  '--heroui-danger-700': string
-  '--heroui-danger-800': string
-  '--heroui-danger-900': string
-  '--heroui-danger-foreground': string
-  '--heroui-danger': string
-  // 新增 primary
-  '--heroui-primary-50': string
-  '--heroui-primary-100': string
-  '--heroui-primary-200': string
-  '--heroui-primary-300': string
-  '--heroui-primary-400': string
-  '--heroui-primary-500': string
-  '--heroui-primary-600': string
-  '--heroui-primary-700': string
-  '--heroui-primary-800': string
-  '--heroui-primary-900': string
-  '--heroui-primary-foreground': string
-  '--heroui-primary': string
-  // 新增 secondary
-  '--heroui-secondary-50': string
-  '--heroui-secondary-100': string
-  '--heroui-secondary-200': string
-  '--heroui-secondary-300': string
-  '--heroui-secondary-400': string
-  '--heroui-secondary-500': string
-  '--heroui-secondary-600': string
-  '--heroui-secondary-700': string
-  '--heroui-secondary-800': string
-  '--heroui-secondary-900': string
-  '--heroui-secondary-foreground': string
-  '--heroui-secondary': string
-  // 新增 success
-  '--heroui-success-50': string
-  '--heroui-success-100': string
-  '--heroui-success-200': string
-  '--heroui-success-300': string
-  '--heroui-success-400': string
-  '--heroui-success-500': string
-  '--heroui-success-600': string
-  '--heroui-success-700': string
-  '--heroui-success-800': string
-  '--heroui-success-900': string
-  '--heroui-success-foreground': string
-  '--heroui-success': string
-  // 新增 warning
-  '--heroui-warning-50': string
-  '--heroui-warning-100': string
-  '--heroui-warning-200': string
-  '--heroui-warning-300': string
-  '--heroui-warning-400': string
-  '--heroui-warning-500': string
-  '--heroui-warning-600': string
-  '--heroui-warning-700': string
-  '--heroui-warning-800': string
-  '--heroui-warning-900': string
-  '--heroui-warning-foreground': string
-  '--heroui-warning': string
-  // 其它配置
-  '--heroui-code-background': string
-  '--heroui-strong': string
-  '--heroui-code-mdx': string
-  '--heroui-divider-weight': string
-  '--heroui-disabled-opacity': string
-  '--heroui-font-size-tiny': string
-  '--heroui-font-size-small': string
-  '--heroui-font-size-medium': string
-  '--heroui-font-size-large': string
-  '--heroui-line-height-tiny': string
-  '--heroui-line-height-small': string
-  '--heroui-line-height-medium': string
-  '--heroui-line-height-large': string
-  '--heroui-radius-small': string
-  '--heroui-radius-medium': string
-  '--heroui-radius-large': string
-  '--heroui-border-width-small': string
-  '--heroui-border-width-medium': string
-  '--heroui-border-width-large': string
-  '--heroui-box-shadow-small': string
-  '--heroui-box-shadow-medium': string
-  '--heroui-box-shadow-large': string
-  '--heroui-hover-opacity': string
-}
-
-interface ThemeConfig {
-  dark: ThemeConfigItem
-  light: ThemeConfigItem
-}
-
-interface WebUIConfig {
-  host: string
-  port: number
-  loginRate: number
-  disableWebUI: boolean
-  disableNonLANAccess: boolean
-}

napcat.webui/src/utils/music.ts

@@ -1,122 +0,0 @@
-import { PlayMode } from '@/const/enum';
-
-import WebUIManager from '@/controllers/webui_manager';
-import type {
-  FinalMusic,
-  Music163ListResponse,
-  Music163URLResponse,
-} from '@/types/music';
-
-/**
- * 获取网易云音乐歌单
- * @param id 歌单id
- * @returns 歌单信息
- */
-export const get163MusicList = async (id: string) => {
-  const res = await WebUIManager.proxy<Music163ListResponse>(
-    'https://wavesgame.top/playlist/track/all?id=' + id
-  );
-  // const res = await request.get<Music163ListResponse>(
-  //   `https://wavesgame.top/playlist/track/all?id=${id}`
-  // )
-  if (res?.data?.code !== 200) {
-    throw new Error('获取歌曲列表失败');
-  }
-  return res.data;
-};
-
-/**
- * 获取歌曲地址
- * @param ids 歌曲id
- * @returns 歌曲地址
- */
-export const getSongsURL = async (ids: number[]) => {
-  const _ids = ids.reduce((prev, cur, index) => {
-    const groupIndex = Math.floor(index / 10);
-    if (!prev[groupIndex]) {
-      prev[groupIndex] = [];
-    }
-    prev[groupIndex].push(cur);
-    return prev;
-  }, [] as number[][]);
-  const res = await Promise.all(
-    _ids.map(async (id) => {
-      const res = await WebUIManager.proxy<Music163URLResponse>(
-        `https://wavesgame.top/song/url?id=${id.join(',')}`
-      );
-      if (res?.data?.code !== 200) {
-        throw new Error('获取歌曲地址失败');
-      }
-      return res.data.data;
-    })
-  );
-  const result = res.reduce((prev, cur) => {
-    return prev.concat(...cur);
-  }, []);
-  return result;
-};
-
-/**
- * 获取网易云音乐歌单歌曲
- * @param id 歌单id
- * @returns 歌曲信息
- */
-export const get163MusicListSongs = async (id: string) => {
-  const listRes = await get163MusicList(id);
-  const songs = listRes.songs.map((song) => song.id);
-  const songsRes = await getSongsURL(songs);
-  const finalMusic: FinalMusic[] = [];
-  for (let i = 0; i < listRes.songs.length; i++) {
-    const song = listRes.songs[i];
-    const music = songsRes.find((s) => s.id === song.id);
-    const songURL = music?.url;
-    if (songURL) {
-      finalMusic.push({
-        id: song.id,
-        url: songURL.replace(/http:\/\//, '//').replace(/https:\/\//, '//'),
-        title: song.name,
-        artist: song.ar.map((p) => p.name).join('/'),
-        cover: song.al.picUrl,
-      });
-    }
-  }
-  return finalMusic;
-};
-
-/**
- * 获取随机音乐
- * @param ids 歌曲id
- * @param currentId 当前音乐id
- * @returns 随机音乐id
- */
-export const getRandomMusic = (ids: number[], currentId: number): number => {
-  const randomIndex = Math.floor(Math.random() * ids.length);
-  const randomId = ids[randomIndex];
-  if (randomId === currentId) {
-    return getRandomMusic(ids, currentId);
-  }
-  return randomId;
-};
-
-/**
- * 获取下一首音乐id
- * @param ids 歌曲id
- * @param currentId 当前音乐ID
- * @param mode 播放模式
- */
-export const getNextMusic = (
-  musics: FinalMusic[],
-  currentId: number,
-  mode: PlayMode
-): number => {
-  const ids = musics.map((music) => music.id);
-  if (mode === PlayMode.Loop) {
-    const currentIndex = ids.findIndex((id) => id === currentId);
-    const nextIndex = currentIndex + 1;
-    return ids[nextIndex] || ids[0];
-  }
-  if (mode === PlayMode.Random) {
-    return getRandomMusic(ids, currentId);
-  }
-  return currentId;
-};

napcat.webui/src/utils/version.ts

@@ -1,36 +0,0 @@
-/**
- * 版本号转为数字
- * @param version 版本号
- * @returns 版本号数字
- */
-export const versionToNumber = (version: string): number => {
-  const finalVersionString = version.replace(/^v/, '');
-
-  const versionArray = finalVersionString.split('.');
-  const versionNumber =
-    parseInt(versionArray[2]) +
-    parseInt(versionArray[1]) * 100 +
-    parseInt(versionArray[0]) * 10000;
-
-  return versionNumber;
-};
-
-/**
- * 比较版本号
- * @param version1 版本号1
- * @param version2 版本号2
- * @returns 比较结果
- * 0: 相等
- * 1: version1 > version2
- * -1: version1 < version2
- */
-export const compareVersion = (version1: string, version2: string): number => {
-  const versionNumber1 = versionToNumber(version1);
-  const versionNumber2 = versionToNumber(version2);
-
-  if (versionNumber1 === versionNumber2) {
-    return 0;
-  }
-
-  return versionNumber1 > versionNumber2 ? 1 : -1;
-};

napcat.webui/vite.config.ts

@@ -1,58 +0,0 @@
-import react from '@vitejs/plugin-react'
-import path from 'node:path'
-import { defineConfig, loadEnv, normalizePath } from 'vite'
-import { viteStaticCopy } from 'vite-plugin-static-copy'
-import tsconfigPaths from 'vite-tsconfig-paths'
-
-const monacoEditorPath = normalizePath(
-  path.resolve(__dirname, 'node_modules/monaco-editor/min/vs')
-)
-
-// https://vitejs.dev/config/
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd())
-  const backendDebugUrl = env.VITE_DEBUG_BACKEND_URL
-  console.log('backendDebugUrl', backendDebugUrl)
-  return {
-    plugins: [
-      react(),
-      tsconfigPaths(),
-      viteStaticCopy({
-        targets: [
-          {
-            src: monacoEditorPath,
-            dest: 'monaco-editor/min'
-          }
-        ]
-      })
-    ],
-    base: '/webui/',
-    server: {
-      proxy: {
-        '/api/ws/terminal': {
-          target: backendDebugUrl,
-          ws: true,
-          changeOrigin: true
-        },
-        '/api': backendDebugUrl,
-        '/files': backendDebugUrl
-      }
-    },
-    build: {
-      assetsInlineLimit: 0,
-      rollupOptions: {
-        output: {
-          manualChunks: {
-            'monaco-editor': ['monaco-editor'],
-            'react-dom': ['react-dom'],
-            'react-router-dom': ['react-router-dom'],
-            'react-hook-form': ['react-hook-form'],
-            'react-icons': ['react-icons'],
-            'react-hot-toast': ['react-hot-toast'],
-            qface: ['qface']
-          }
-        }
-      }
-    }
-  }
-})

package.json

@@ -2,73 +2,29 @@
   "name": "napcat",
   "private": true,
   "type": "module",
-  "version": "4.9.40",
+  "version": "0.0.1",
   "scripts": {
-    "build:universal": "npm run build:webui && npm run dev:universal || exit 1",
-    "build:framework": "npm run build:webui && npm run dev:framework || exit 1",
-    "build:shell": "npm run build:webui && npm run dev:shell || exit 1",
-    "build:webui": "cd napcat.webui && npm run build",
-    "dev:universal": "vite build --mode universal",
-    "dev:framework": "vite build --mode framework",
-    "dev:shell": "vite build --mode shell",
-    "dev:shell-analysis": "vite build --mode shell-analysis",
-    "dev:webui": "cd napcat.webui && npm run dev",
-    "tsc": "npm run tsc:webui && npm run tsc:core",
-    "tsc:core": "tsc --noEmit",
-    "tsc:webui": "cd napcat.webui && tsc --noEmit",
-    "lint": "npm run lint:core && npm run lint:webui",
-    "lint:fix": "npm run lint:fix:core && npm run lint:fix:webui",
-    "lint:core": "eslint src/**/*",
-    "lint:fix:core": "eslint --fix src/**/*",
-    "lint:webui": "cd napcat.webui && eslint src/**/*",
-    "lint:fix:webui": "cd napcat.webui && eslint --fix src/**/*",
-    "depend": "cd dist && npm install --omit=dev",
-    "dev:depend": "npm i && cd napcat.webui && npm i",
-    "test:winshell": "pwsh ./tests/nodeTest.ps1"
+    "build:shell": "pnpm --filter napcat-shell run build || exit 1",
+    "build:shell:dev": "pnpm --filter napcat-shell run build:dev || exit 1",
+    "build:framework": "pnpm --filter napcat-framework run build || exit 1",
+    "build:webui": "pnpm --filter napcat-webui-frontend run build || exit 1",
+    "dev:shell": "pnpm --filter napcat-develop run dev || exit 1",
+    "typecheck": "pnpm -r --if-present run typecheck",
+    "test": "pnpm --filter napcat-test run test",
+    "test:ui": "pnpm --filter napcat-test run test:ui",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   },
   "devDependencies": {
-    "@babel/core": "^7.28.0",
-    "@babel/generator": "^7.28.0",
-    "@babel/parser": "^7.28.0",
-    "@babel/preset-typescript": "^7.24.7",
-    "@babel/traverse": "^7.28.0",
-    "@babel/types": "^7.28.2",
-    "@homebridge/node-pty-prebuilt-multiarch": "^0.12.0-beta.5",
-    "@log4js-node/log4js-api": "^1.0.2",
-    "@napneko/nap-proto-core": "^0.0.4",
-    "@rollup/plugin-node-resolve": "^16.0.0",
-    "@rollup/plugin-typescript": "^12.1.4",
-    "@sinclair/typebox": "^0.34.38",
-    "@types/cors": "^2.8.17",
-    "@types/express": "^5.0.0",
-    "@types/multer": "^1.4.12",
-    "@types/node": "^22.0.1",
-    "@types/on-finished": "^2.3.4",
-    "@types/qrcode-terminal": "^0.12.2",
-    "@types/react-color": "^3.0.13",
-    "@types/type-is": "^1.6.7",
-    "@types/ws": "^8.5.12",
-    "ajv": "^8.13.0",
-    "async-mutex": "^0.5.0",
-    "commander": "^13.0.0",
-    "compressing": "^1.10.1",
-    "cors": "^2.8.5",
-    "esbuild": "0.25.8",
-    "eslint": "^9.14.0",
-    "express-rate-limit": "^7.5.0",
-    "fast-xml-parser": "^4.3.6",
-    "file-type": "^21.0.0",
-    "fs-extra": "^11.3.2",
-    "json5": "^2.2.3",
-    "multer": "^2.0.1",
-    "napcat.protobuf": "^1.1.4",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@vitejs/plugin-react-swc": "^4.2.2",
+    "@vitest/ui": "^4.0.9",
+    "eslint": "^9.39.1",
     "neostandard": "^0.12.2",
-    "typescript": "^5.3.3",
-    "typescript-eslint": "^8.35.1",
-    "vite": "^7.1.1",
-    "vite-plugin-cp": "^6.0.0",
-    "vite-tsconfig-paths": "^5.1.0",
-    "winston": "^3.17.0"
+    "typescript": "^5.3.0",
+    "vite": "^6.4.1",
+    "vite-plugin-cp": "^6.0.3",
+    "vitest": "^4.0.9"
   },
   "dependencies": {
     "express": "^5.0.0",

packages/napcat-common/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "napcat-common",
+    "version": "0.0.1",
+    "private": true,
+    "type": "module",
+    "main": "src/index.ts",
+    "scripts": {
+        "typecheck": "tsc --noEmit --skipLibCheck -p tsconfig.json"
+    },
+    "exports": {
+        ".": {
+            "import": "./src/index.ts"
+        },
+        "./src/*": {
+            "import": "./src/*"
+        }
+    },
+    "dependencies": {
+        "ajv": "^8.13.0",
+        "file-type": "^21.0.0",
+        "silk-wasm": "^3.6.1"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.1"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}

packages/napcat-common/src/env.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="vite/client" />
+
+declare global {
+  interface ImportMetaEnv {
+    readonly VITE_NAPCAT_VERSION: string;
+  }
+}
+
+export {};

packages/napcat-common/src/file-uuid.ts

@@ -1,4 +1,4 @@
-import { Peer } from '@/core';
+import { Peer } from './types';
 import { randomUUID } from 'crypto';
 
 class TimeBasedCache<K, V> {

packages/napcat-common/src/file.ts

@@ -2,7 +2,7 @@ import fs from 'fs';
 import { stat } from 'fs/promises';
 import crypto, { randomUUID } from 'crypto';
 import path from 'node:path';
-import { solveProblem } from '@/common/helper';
+import { solveProblem } from '@/napcat-common/src/helper';
 
 export interface HttpDownloadOptions {
   url: string;

packages/napcat-common/src/helper.ts

@@ -1,8 +1,12 @@
 import path from 'node:path';
 import fs from 'fs';
 import os from 'node:os';
-import { QQLevel } from '@/core';
-import { QQVersionConfigType } from './types';
+import { QQVersionConfigType, QQLevel } from './types';
+import { compareSemVer } from './version';
+import { getAllGitHubTags as getAllTagsFromMirror } from './mirror';
+
+// 导出 compareSemVer 供其他模块使用
+export { compareSemVer } from './version';
 
 export async function solveProblem<T extends (...arg: any[]) => any> (func: T, ...args: Parameters<T>): Promise<ReturnType<T> | undefined> {
   return new Promise<ReturnType<T> | undefined>((resolve) => {
@@ -212,3 +216,25 @@ export function parseAppidFromMajor (nodeMajor: string): string | undefined {
 
   return undefined;
 }
+
+// ============== GitHub Tags 获取 ==============
+// 使用 mirror 模块统一管理镜像
+
+export async function getAllTags (): Promise<{ tags: string[], mirror: string; }> {
+  return getAllTagsFromMirror('NapNeko', 'NapCatQQ');
+}
+
+
+export async function getLatestTag (): Promise<string> {
+  const { tags } = await getAllTags();
+
+  // 使用 SemVer 规范排序
+  tags.sort((a, b) => compareSemVer(a, b));
+
+  const latest = tags.at(-1);
+  if (!latest) {
+    throw new Error('No tags found');
+  }
+  // 去掉开头的 v
+  return latest.replace(/^v/, '');
+}

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

@@ -0,0 +1,24 @@
+export enum LogLevel {
+  DEBUG = 'debug',
+  INFO = 'info',
+  WARN = 'warn',
+  ERROR = 'error',
+  FATAL = 'fatal',
+}
+export interface ILogWrapper {
+  fileLogEnabled: boolean;
+  consoleLogEnabled: boolean;
+  cleanOldLogs (logDir: string): void;
+  setFileAndConsoleLogLevel (fileLogLevel: LogLevel, consoleLogLevel: LogLevel): void;
+  setLogSelfInfo (selfInfo: { nick: string; uid: string; }): void;
+  setFileLogEnabled (isEnabled: boolean): void;
+  setConsoleLogEnabled (isEnabled: boolean): void;
+  formatMsg (msg: any[]): string;
+  _log (level: LogLevel, ...args: any[]): void;
+  log (...args: any[]): void;
+  logDebug (...args: any[]): void;
+  logError (...args: any[]): void;
+  logWarn (...args: any[]): void;
+  logFatal (...args: any[]): void;
+  logMessage (msg: unknown, selfInfo: unknown): void;
+}

packages/napcat-common/src/message-unique.ts

@@ -1,6 +1,5 @@
-import { Peer } from '@/core';
 import crypto from 'crypto';
-
+import { Peer } from './types';
 export class LimitedHashTable<K, V> {
   private readonly keyToValue: Map<K, V> = new Map();
   private readonly valueToKey: Map<V, K> = new Map();

packages/napcat-common/src/mirror.ts

@@ -0,0 +1,913 @@
+/**
+ * GitHub 镜像配置模块
+ * 提供统一的镜像源管理，支持复杂网络环境
+ * 
+ * 镜像源测试时间: 2026-01-03
+ * 测试通过: 55/61 完全可用
+ */
+
+import https from 'https';
+import http from 'http';
+import { RequestUtil } from './request';
+import { PromiseTimer } from './helper';
+
+// ============== 镜像源列表 ==============
+
+/**
+ * GitHub 文件加速镜像
+ * 用于加速 release assets 下载
+ * 按延迟排序，优先使用快速镜像
+ * 
+ * 测试时间: 2026-01-03
+ * 镜像支持 301/302 重定向
+ * 懒加载测速：首次使用时自动测速，缓存 30 分钟
+ */
+export const GITHUB_FILE_MIRRORS = [
+  // 延迟 < 800ms 的最快镜像
+  'https://github.chenc.dev/',      // 666ms
+  'https://ghproxy.cfd/',           // 719ms - 支持重定向
+  'https://github.tbedu.top/',      // 760ms
+  'https://ghps.cc/',               // 768ms
+  'https://gh.llkk.cc/',            // 774ms
+  'https://ghproxy.cc/',            // 777ms
+  'https://gh.monlor.com/',         // 779ms
+  'https://cdn.akaere.online/',     // 784ms
+  // 延迟 800-1000ms 的快速镜像
+  'https://gh.idayer.com/',         // 869ms
+  'https://gh-proxy.net/',          // 885ms
+  'https://ghpxy.hwinzniej.top/',   // 890ms
+  'https://github-proxy.memory-echoes.cn/', // 896ms
+  'https://git.yylx.win/',          // 917ms
+  'https://gitproxy.mrhjx.cn/',     // 950ms
+  'https://jiashu.1win.eu.org/',    // 954ms
+  'https://ghproxy.cn/',            // 981ms
+  // 延迟 1000-1500ms 的中速镜像
+  'https://gh.fhjhy.top/',          // 1014ms
+  'https://gp.zkitefly.eu.org/',    // 1015ms
+  'https://gh-proxy.com/',          // 1022ms
+  'https://hub.gitmirror.com/',     // 1027ms
+  'https://ghfile.geekertao.top/',  // 1029ms
+  'https://j.1lin.dpdns.org/',      // 1037ms
+  'https://ghproxy.imciel.com/',    // 1047ms
+  'https://github-proxy.teach-english.tech/', // 1047ms
+  'https://gh.927223.xyz/',         // 1071ms
+  'https://github.ednovas.xyz/',    // 1099ms
+  'https://ghf.xn--eqrr82bzpe.top/',// 1122ms
+  'https://gh.dpik.top/',           // 1131ms
+  'https://gh.jasonzeng.dev/',      // 1139ms
+  'https://gh.xxooo.cf/',           // 1157ms
+  'https://gh.bugdey.us.kg/',       // 1228ms
+  'https://ghm.078465.xyz/',        // 1289ms
+  'https://j.1win.ggff.net/',       // 1329ms
+  'https://tvv.tw/',                // 1393ms
+  'https://gh.chjina.com/',         // 1446ms
+  'https://gitproxy.127731.xyz/',   // 1458ms
+  // 延迟 1500-2500ms 的较慢镜像
+  'https://gh.inkchills.cn/',       // 1617ms
+  'https://ghproxy.cxkpro.top/',    // 1651ms
+  'https://gh.sixyin.com/',         // 1686ms
+  'https://github.geekery.cn/',     // 1734ms
+  'https://git.669966.xyz/',        // 1824ms
+  'https://gh.5050net.cn/',         // 1858ms
+  'https://gh.felicity.ac.cn/',     // 1903ms
+  'https://gh.ddlc.top/',           // 2056ms
+  'https://cf.ghproxy.cc/',         // 2058ms
+  'https://gitproxy.click/',        // 2068ms
+  'https://github.dpik.top/',       // 2313ms
+  'https://gh.zwnes.xyz/',          // 2434ms
+  'https://ghp.keleyaa.com/',       // 2440ms
+  'https://gh.wsmdn.dpdns.org/',    // 2744ms
+  // 延迟 > 2500ms 的慢速镜像（作为备用）
+  'https://ghproxy.monkeyray.net/', // 3023ms
+  'https://fastgit.cc/',            // 3369ms
+  'https://cdn.gh-proxy.com/',      // 3394ms
+  'https://gh.catmak.name/',        // 4119ms
+  'https://gh.noki.icu/',           // 5990ms
+  '', // 原始 URL（无镜像）
+];
+
+/**
+ * GitHub API 镜像
+ * 用于访问 GitHub API（作为备选方案）
+ * 注：优先使用非 API 方法，减少对 API 的依赖
+ * 
+ * 经测试，大部分代理镜像不支持 API 转发
+ * 建议使用 getLatestReleaseTag 等方法避免 API 调用
+ */
+export const GITHUB_API_MIRRORS = [
+  'https://api.github.com',
+  // 目前没有可用的公共 API 代理镜像
+];
+
+/**
+ * GitHub Raw 镜像
+ * 用于访问 raw.githubusercontent.com
+ * 注：大多数通用代理也支持 raw 文件加速
+ */
+export const GITHUB_RAW_MIRRORS = [
+  'https://raw.githubusercontent.com',
+  // 测试确认支持 raw 文件的镜像
+  'https://github.chenc.dev/https://raw.githubusercontent.com',
+  'https://ghproxy.cfd/https://raw.githubusercontent.com',
+  'https://gh.llkk.cc/https://raw.githubusercontent.com',
+  'https://ghproxy.cc/https://raw.githubusercontent.com',
+  'https://gh-proxy.net/https://raw.githubusercontent.com',
+];
+
+// ============== 镜像配置接口 ==============
+
+export interface MirrorConfig {
+  /** 文件下载镜像（用于 release assets） */
+  fileMirrors: string[];
+  /** API 镜像 */
+  apiMirrors: string[];
+  /** Raw 文件镜像 */
+  rawMirrors: string[];
+  /** 超时时间（毫秒） */
+  timeout: number;
+  /** 是否启用镜像 */
+  enabled: boolean;
+  /** 自定义镜像（优先使用） */
+  customMirror?: string;
+}
+
+// ============== 默认配置 ==============
+
+const defaultConfig: MirrorConfig = {
+  fileMirrors: GITHUB_FILE_MIRRORS,
+  apiMirrors: GITHUB_API_MIRRORS,
+  rawMirrors: GITHUB_RAW_MIRRORS,
+  timeout: 10000, // 10秒超时，平衡速度和可靠性
+  enabled: true,
+  customMirror: undefined,
+};
+
+let currentConfig: MirrorConfig = { ...defaultConfig };
+
+// ============== 懒加载镜像测速缓存 ==============
+
+interface MirrorTestResult {
+  mirror: string;
+  latency: number;
+  success: boolean;
+}
+
+// 缓存的快速镜像列表（按延迟排序）
+let cachedFastMirrors: string[] | null = null;
+// 测速是否正在进行
+let mirrorTestingPromise: Promise<string[]> | null = null;
+// 缓存过期时间（30分钟）
+const MIRROR_CACHE_TTL = 30 * 60 * 1000;
+let cacheTimestamp: number = 0;
+
+/**
+ * 测试单个镜像的延迟（使用 HEAD 请求测试实际文件）
+ * 测试一个小型的实际 release 文件，确保镜像支持文件下载
+ */
+async function testMirrorLatency (mirror: string, timeout: number = 5000): Promise<MirrorTestResult> {
+  // 使用一个实际存在的小文件来测试（README 或小型 release asset）
+  // 用 HEAD 请求，不下载实际内容
+  const testUrl = 'https://github.com/NapNeko/NapCatQQ/releases/latest';
+  const url = buildMirrorUrl(testUrl, mirror);
+  const start = Date.now();
+
+  return new Promise<MirrorTestResult>((resolve) => {
+    try {
+      const urlObj = new URL(url);
+      const isHttps = urlObj.protocol === 'https:';
+      const client = isHttps ? https : http;
+
+      const req = client.request({
+        hostname: urlObj.hostname,
+        port: urlObj.port || (isHttps ? 443 : 80),
+        path: urlObj.pathname + urlObj.search,
+        method: 'HEAD',
+        timeout,
+        headers: {
+          'User-Agent': 'NapCat-Mirror-Test',
+        },
+      }, (res) => {
+        const statusCode = res.statusCode || 0;
+        // 2xx 或 3xx 都算成功（3xx 说明镜像工作正常，会重定向）
+        const isValid = statusCode >= 200 && statusCode < 400;
+        resolve({
+          mirror,
+          latency: Date.now() - start,
+          success: isValid,
+        });
+      });
+
+      req.on('error', () => {
+        resolve({
+          mirror,
+          latency: Infinity,
+          success: false,
+        });
+      });
+
+      req.on('timeout', () => {
+        req.destroy();
+        resolve({
+          mirror,
+          latency: Infinity,
+          success: false,
+        });
+      });
+
+      req.end();
+    } catch {
+      resolve({
+        mirror,
+        latency: Infinity,
+        success: false,
+      });
+    }
+  });
+}
+
+/**
+ * 懒加载获取快速镜像列表
+ * 第一次调用时会进行测速，后续使用缓存
+ */
+export async function getFastMirrors (forceRefresh: boolean = false): Promise<string[]> {
+  // 检查缓存是否有效
+  const now = Date.now();
+  if (!forceRefresh && cachedFastMirrors && (now - cacheTimestamp) < MIRROR_CACHE_TTL) {
+    return cachedFastMirrors;
+  }
+
+  // 如果已经在测速中，等待结果
+  if (mirrorTestingPromise) {
+    return mirrorTestingPromise;
+  }
+
+  // 开始测速
+  mirrorTestingPromise = performMirrorTest();
+
+  try {
+    const result = await mirrorTestingPromise;
+    cachedFastMirrors = result;
+    cacheTimestamp = now;
+    return result;
+  } finally {
+    mirrorTestingPromise = null;
+  }
+}
+
+/**
+ * 执行镜像测速
+ * 并行测试所有镜像，返回按延迟排序的可用镜像列表
+ */
+async function performMirrorTest (): Promise<string[]> {
+  // 开始镜像测速
+
+  const timeout = 8000; // 测速超时 8 秒
+
+  // 并行测试所有镜像
+  const mirrors = currentConfig.fileMirrors.filter(m => m);
+  const results = await Promise.all(
+    mirrors.map(m => testMirrorLatency(m, timeout))
+  );
+
+  // 过滤成功的镜像并按延迟排序
+  const successfulMirrors = results
+    .filter(r => r.success)
+    .sort((a, b) => a.latency - b.latency)
+    .map(r => r.mirror);
+
+
+
+  // 至少返回原始 URL
+  if (successfulMirrors.length === 0) {
+    return [''];
+  }
+
+  return successfulMirrors;
+}
+
+/**
+ * 清除镜像缓存，强制下次重新测速
+ */
+export function clearMirrorCache (): void {
+  cachedFastMirrors = null;
+  cacheTimestamp = 0;
+
+}
+
+/**
+ * 获取缓存状态
+ */
+export function getMirrorCacheStatus (): { cached: boolean; count: number; age: number; } {
+  return {
+    cached: cachedFastMirrors !== null,
+    count: cachedFastMirrors?.length ?? 0,
+    age: cachedFastMirrors ? Date.now() - cacheTimestamp : 0,
+  };
+}
+
+// ============== 配置管理 ==============
+
+/**
+ * 获取当前镜像配置
+ */
+export function getMirrorConfig (): MirrorConfig {
+  return { ...currentConfig };
+}
+
+/**
+ * 更新镜像配置
+ */
+export function setMirrorConfig (config: Partial<MirrorConfig>): void {
+  currentConfig = { ...currentConfig, ...config };
+}
+
+/**
+ * 重置为默认配置
+ */
+export function resetMirrorConfig (): void {
+  currentConfig = { ...defaultConfig };
+}
+
+/**
+ * 设置自定义镜像（优先级最高）
+ */
+export function setCustomMirror (mirror: string): void {
+  currentConfig.customMirror = mirror;
+}
+
+// ============== URL 工具函数 ==============
+
+/**
+ * 构建镜像 URL
+ * @param originalUrl 原始 URL
+ * @param mirror 镜像前缀
+ */
+export function buildMirrorUrl (originalUrl: string, mirror: string): string {
+  if (!mirror) return originalUrl;
+  // 如果镜像已经包含完整域名，直接拼接
+  if (mirror.endsWith('/')) {
+    return mirror + originalUrl;
+  }
+  return mirror + '/' + originalUrl;
+}
+
+/**
+ * 测试 URL 是否可用（HTTP GET）
+ * @param url 要测试的 URL
+ * @param timeout 超时时间
+ */
+export async function testUrl (url: string, timeout: number = 5000): Promise<boolean> {
+  try {
+    await PromiseTimer(RequestUtil.HttpGetText(url), timeout);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 测试 URL 是否可用（HTTP HEAD，更快）
+ * 验证：状态码、Content-Type、Content-Length
+ */
+export async function testUrlHead (url: string, timeout: number = 5000): Promise<boolean> {
+  return new Promise<boolean>((resolve) => {
+    const urlObj = new URL(url);
+    const isHttps = urlObj.protocol === 'https:';
+    const client = isHttps ? https : http;
+
+    const req = client.request({
+      hostname: urlObj.hostname,
+      port: urlObj.port || (isHttps ? 443 : 80),
+      path: urlObj.pathname + urlObj.search,
+      method: 'HEAD',
+      timeout,
+      headers: {
+        'User-Agent': 'NapCat-Mirror-Test',
+      },
+    }, (res) => {
+      const statusCode = res.statusCode || 0;
+      const contentType = (res.headers['content-type'] as string) || '';
+      const contentLength = parseInt((res.headers['content-length'] as string) || '0', 10);
+
+      // 验证条件：
+      // 1. 状态码 2xx 或 3xx
+      // 2. Content-Type 不应该是 text/html（表示错误页面）
+      // 3. 对于 .zip 文件，Content-Length 应该 > 1MB（避免获取到错误页面）
+      const isValidStatus = statusCode >= 200 && statusCode < 400;
+      const isNotHtmlError = !contentType.includes('text/html');
+      const isValidSize = url.endsWith('.zip') ? contentLength > 1024 * 1024 : true;
+
+      resolve(isValidStatus && isNotHtmlError && isValidSize);
+    });
+
+    req.on('error', () => resolve(false));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(false);
+    });
+    req.end();
+  });
+}
+
+/**
+ * 详细验证 URL 响应
+ * 返回验证结果和详细信息
+ */
+export interface UrlValidationResult {
+  valid: boolean;
+  statusCode?: number;
+  contentType?: string;
+  contentLength?: number;
+  error?: string;
+}
+
+export async function validateUrl (url: string, timeout: number = 5000): Promise<UrlValidationResult> {
+  return new Promise<UrlValidationResult>((resolve) => {
+    const urlObj = new URL(url);
+    const isHttps = urlObj.protocol === 'https:';
+    const client = isHttps ? https : http;
+
+    const req = client.request({
+      hostname: urlObj.hostname,
+      port: urlObj.port || (isHttps ? 443 : 80),
+      path: urlObj.pathname + urlObj.search,
+      method: 'HEAD',
+      timeout,
+      headers: {
+        'User-Agent': 'NapCat-Mirror-Test',
+      },
+    }, (res) => {
+      const statusCode = res.statusCode || 0;
+      const contentType = (res.headers['content-type'] as string) || '';
+      const contentLength = parseInt((res.headers['content-length'] as string) || '0', 10);
+
+      // 验证条件
+      const isValidStatus = statusCode >= 200 && statusCode < 400;
+      const isNotHtmlError = !contentType.includes('text/html');
+      const isValidSize = url.endsWith('.zip') ? contentLength > 1024 * 1024 : true;
+
+      if (!isValidStatus) {
+        resolve({
+          valid: false,
+          statusCode,
+          contentType,
+          contentLength,
+          error: `HTTP ${statusCode}`,
+        });
+      } else if (!isNotHtmlError) {
+        resolve({
+          valid: false,
+          statusCode,
+          contentType,
+          contentLength,
+          error: '返回了 HTML 页面而非文件',
+        });
+      } else if (!isValidSize) {
+        resolve({
+          valid: false,
+          statusCode,
+          contentType,
+          contentLength,
+          error: `文件过小 (${contentLength} bytes)，可能是错误页面`,
+        });
+      } else {
+        resolve({
+          valid: true,
+          statusCode,
+          contentType,
+          contentLength,
+        });
+      }
+    });
+
+    req.on('error', (e: Error) => resolve({
+      valid: false,
+      error: e.message,
+    }));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve({
+        valid: false,
+        error: 'Timeout',
+      });
+    });
+    req.end();
+  });
+}
+
+// ============== 查找可用 URL ==============
+
+/**
+ * 查找可用的下载 URL
+ * 使用懒加载的快速镜像列表
+ * @param originalUrl 原始 GitHub URL
+ * @param options 选项
+ */
+export async function findAvailableDownloadUrl (
+  originalUrl: string,
+  options: {
+    mirrors?: string[];
+    timeout?: number;
+    customMirror?: string;
+    testMethod?: 'head' | 'get';
+    /** 是否使用详细验证（验证 Content-Type 和 Content-Length） */
+    validateContent?: boolean;
+    /** 期望的最小文件大小（字节），用于验证 */
+    minFileSize?: number;
+    /** 是否使用懒加载的快速镜像列表 */
+    useFastMirrors?: boolean;
+  } = {}
+): Promise<string> {
+  const {
+    timeout = currentConfig.timeout,
+    customMirror = currentConfig.customMirror,
+    testMethod = 'head',
+    validateContent = true, // 默认启用内容验证
+    minFileSize,
+    useFastMirrors = true, // 默认使用快速镜像列表
+  } = options;
+
+  // 获取镜像列表
+  let mirrors = options.mirrors;
+  if (!mirrors) {
+    if (useFastMirrors) {
+      // 使用懒加载的快速镜像列表
+      mirrors = await getFastMirrors();
+    } else {
+      mirrors = currentConfig.fileMirrors;
+    }
+  }
+
+  // 使用增强验证或简单测试
+  const testWithValidation = async (url: string): Promise<boolean> => {
+    if (validateContent) {
+      const result = await validateUrl(url, timeout);
+      // 额外检查文件大小
+      if (result.valid && minFileSize && result.contentLength && result.contentLength < minFileSize) {
+        return false;
+      }
+      return result.valid;
+    }
+    return testMethod === 'head' ? testUrlHead(url, timeout) : testUrl(url, timeout);
+  };
+
+  // 1. 如果设置了自定义镜像，优先使用
+  if (customMirror) {
+    const customUrl = buildMirrorUrl(originalUrl, customMirror);
+    if (await testWithValidation(customUrl)) {
+      return customUrl;
+    }
+  }
+
+  // 2. 先测试原始 URL
+  if (await testWithValidation(originalUrl)) {
+    return originalUrl;
+  }
+
+  // 3. 测试镜像源（已按延迟排序）
+  let testedCount = 0;
+  for (const mirror of mirrors) {
+    if (!mirror) continue; // 跳过空字符串
+    const mirrorUrl = buildMirrorUrl(originalUrl, mirror);
+    testedCount++;
+    if (await testWithValidation(mirrorUrl)) {
+      return mirrorUrl;
+    }
+  }
+
+  throw new Error(`所有下载源都不可用（已测试 ${testedCount} 个镜像），请检查网络连接或配置自定义镜像`);
+}
+
+// ============== 版本和 Release 相关（减少 API 依赖） ==============
+
+/**
+ * 语义化版本正则（简化版，用于排序）
+ */
+const SEMVER_REGEX = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-.]+))?(?:\+([0-9A-Za-z-.]+))?$/;
+
+/**
+ * 解析语义化版本号
+ */
+function parseSemVerSimple (version: string): { major: number; minor: number; patch: number; prerelease: string; } | null {
+  const match = version.match(SEMVER_REGEX);
+  if (!match) return null;
+  return {
+    major: parseInt(match[1] ?? '0', 10),
+    minor: parseInt(match[2] ?? '0', 10),
+    patch: parseInt(match[3] ?? '0', 10),
+    prerelease: match[4] || '',
+  };
+}
+
+/**
+ * 比较两个版本号
+ */
+function compareSemVerSimple (a: string, b: string): number {
+  const pa = parseSemVerSimple(a);
+  const pb = parseSemVerSimple(b);
+  if (!pa && !pb) return 0;
+  if (!pa) return -1;
+  if (!pb) return 1;
+
+  if (pa.major !== pb.major) return pa.major - pb.major;
+  if (pa.minor !== pb.minor) return pa.minor - pb.minor;
+  if (pa.patch !== pb.patch) return pa.patch - pb.patch;
+
+  // 预发布版本排在正式版本前面
+  if (pa.prerelease && !pb.prerelease) return -1;
+  if (!pa.prerelease && pb.prerelease) return 1;
+
+  return pa.prerelease.localeCompare(pb.prerelease);
+}
+
+/**
+ * 从 tags 列表中获取最新的 release tag
+ * 不依赖 GitHub API
+ */
+export async function getLatestReleaseTag (owner: string, repo: string): Promise<string> {
+  const result = await getAllGitHubTags(owner, repo);
+
+  // 过滤出符合 semver 的 tags
+  const releaseTags = result.tags.filter(tag => SEMVER_REGEX.test(tag));
+
+  if (releaseTags.length === 0) {
+    throw new Error('未找到有效的 release tag');
+  }
+
+  // 按版本号排序，取最新的
+  releaseTags.sort(compareSemVerSimple);
+  const latest = releaseTags[releaseTags.length - 1];
+
+  if (!latest) {
+    throw new Error('未找到有效的 release tag');
+  }
+
+  return latest;
+}
+
+/**
+ * 直接构建 GitHub release 下载 URL
+ * 不需要调用 API，直接基于 tag 和 asset 名称构建
+ */
+export function buildReleaseDownloadUrl (
+  owner: string,
+  repo: string,
+  tag: string,
+  assetName: string
+): string {
+  return `https://github.com/${owner}/${repo}/releases/download/${tag}/${assetName}`;
+}
+
+/**
+ * 获取 GitHub release 信息（优先使用非 API 方法）
+ * 
+ * 策略：
+ * 1. 先通过 git refs 获取 tags
+ * 2. 直接构建下载 URL，不依赖 API
+ * 3. 仅当需要 changelog 时才使用 API
+ */
+export async function getGitHubRelease (
+  owner: string,
+  repo: string,
+  tag: string = 'latest',
+  options: {
+    /** 需要获取的 asset 名称列表 */
+    assetNames?: string[];
+    /** 是否需要获取 changelog（需要调用 API） */
+    fetchChangelog?: boolean;
+  } = {}
+): Promise<{
+  tag_name: string;
+  assets: Array<{
+    name: string;
+    browser_download_url: string;
+  }>;
+  body?: string;
+}> {
+  const { assetNames = [], fetchChangelog = false } = options;
+
+  // 1. 获取实际的 tag 名称
+  let actualTag: string;
+  if (tag === 'latest') {
+    actualTag = await getLatestReleaseTag(owner, repo);
+  } else {
+    actualTag = tag;
+  }
+
+  // 2. 构建 assets 列表（不需要 API）
+  const assets = assetNames.map(name => ({
+    name,
+    browser_download_url: buildReleaseDownloadUrl(owner, repo, actualTag, name),
+  }));
+
+  // 3. 如果不需要 changelog 且有 assetNames，直接返回
+  if (!fetchChangelog && assetNames.length > 0) {
+    return {
+      tag_name: actualTag,
+      assets,
+      body: undefined,
+    };
+  }
+
+  // 4. 需要更多信息时，尝试调用 API（作为备选）
+  const endpoint = `https://api.github.com/repos/${owner}/${repo}/releases/tags/${actualTag}`;
+
+  for (const apiBase of currentConfig.apiMirrors) {
+    try {
+      const url = endpoint.replace('https://api.github.com', apiBase);
+      const response = await PromiseTimer(
+        RequestUtil.HttpGetJson<any>(url, 'GET', undefined, {
+          'User-Agent': 'NapCat',
+          'Accept': 'application/vnd.github.v3+json',
+        }),
+        currentConfig.timeout
+      );
+      return response;
+    } catch {
+      continue;
+    }
+  }
+
+  // 5. API 全部失败，但如果有 assetNames，仍然返回构建的 URL
+  if (assetNames.length > 0) {
+    return {
+      tag_name: actualTag,
+      assets,
+      body: undefined,
+    };
+  }
+
+  throw new Error('无法获取 release 信息，所有 API 源都不可用');
+}
+
+// ============== Tags 缓存 ==============
+
+interface TagsCache {
+  tags: string[];
+  mirror: string;
+  timestamp: number;
+}
+
+// 缓存 tags 结果（5 分钟有效）
+const TAGS_CACHE_TTL = 5 * 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}`;
+
+  // 检查缓存
+  const cached = tagsCache.get(cacheKey);
+  if (cached && (Date.now() - cached.timestamp) < TAGS_CACHE_TTL) {
+    return { tags: cached.tags, mirror: cached.mirror };
+  }
+
+  const baseUrl = `https://github.com/${owner}/${repo}.git/info/refs?service=git-upload-pack`;
+
+  // 解析 tags 的辅助函数
+  const parseTags = (raw: string): string[] => {
+    return raw
+      .split('\n')
+      .map((line: string) => {
+        const match = line.match(/refs\/tags\/(.+)$/);
+        return match ? match[1] : undefined;
+      })
+      .filter((tag): tag is string => tag !== undefined && !tag.endsWith('^{}'));
+  };
+
+  // 尝试从 URL 获取 tags
+  const fetchFromUrl = async (url: string): Promise<string[] | null> => {
+    try {
+      const raw = await PromiseTimer(
+        RequestUtil.HttpGetText(url),
+        currentConfig.timeout
+      );
+
+      // 检查返回内容是否有效（不是 HTML 错误页面）
+      if (raw.includes('<!DOCTYPE') || raw.includes('<html')) {
+        return null;
+      }
+
+      const tags = parseTags(raw);
+      if (tags.length > 0) {
+        return tags;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  };
+
+  // 获取快速镜像列表（懒加载，首次调用会测速，已按延迟排序）
+  let fastMirrors: string[] = [];
+  try {
+    fastMirrors = await getFastMirrors();
+  } catch (e) {
+    // 忽略错误，继续使用空列表
+  }
+
+  // 构建 URL 列表（快速镜像 + 原始 URL）
+  const mirrorUrls = fastMirrors.filter(m => m).map(m => ({ url: buildMirrorUrl(baseUrl, m), mirror: m }));
+  mirrorUrls.push({ url: baseUrl, mirror: 'github.com' }); // 添加原始 URL
+
+  // 按顺序尝试每个镜像（已按延迟排序），成功即返回
+  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 };
+    }
+  }
+
+  // 如果快速镜像都失败，回退到原始镜像列表
+  const allMirrors = currentConfig.fileMirrors.filter(m => 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 };
+    }
+  }
+
+  throw new Error('无法获取 tags，所有源都不可用');
+}
+
+// ============== Action Artifacts 支持 ==============
+
+export interface ActionArtifact {
+  id: number;
+  name: string;
+  size_in_bytes: number;
+  created_at: string;
+  expires_at: string;
+  archive_download_url: string;
+  workflow_run_id?: number;
+  head_sha?: string;
+}
+
+/**
+ * 获取 GitHub Action 最新运行的 artifacts
+ * 用于下载 nightly/dev 版本
+ */
+export async function getLatestActionArtifacts (
+  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}`;
+
+  try {
+    const runsResponse = await 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',
+    });
+
+    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 RequestUtil.HttpGetJson<{
+          artifacts: ActionArtifact[];
+        }>(artifactsEndpoint, 'GET', undefined, {
+          'User-Agent': 'NapCat',
+          'Accept': 'application/vnd.github.v3+json',
+        });
+
+        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;
+  } catch {
+    return [];
+  }
+}

packages/napcat-common/src/request.ts

@@ -3,11 +3,11 @@ import http from 'node:http';
 
 export class RequestUtil {
   // 适用于获取服务器下发cookies时获取，仅GET
-  static async HttpsGetCookies (url: string): Promise<{ [key: string]: string }> {
+  static async HttpsGetCookies (url: string): Promise<{ [key: string]: string; }> {
     const client = url.startsWith('https') ? https : http;
     return new Promise((resolve, reject) => {
       const req = client.get(url, (res) => {
-        const cookies: { [key: string]: string } = {};
+        const cookies: { [key: string]: string; } = {};
 
         res.on('data', () => { }); // Necessary to consume the stream
         res.on('end', () => {
@@ -27,7 +27,7 @@ export class RequestUtil {
     });
   }
 
-  private static async handleRedirect (res: http.IncomingMessage, url: string, cookies: { [key: string]: string }): Promise<{ [key: string]: string }> {
+  private static async handleRedirect (res: http.IncomingMessage, url: string, cookies: { [key: string]: string; }): Promise<{ [key: string]: string; }> {
     if (res.statusCode === 301 || res.statusCode === 302) {
       if (res.headers.location) {
         const redirectUrl = new URL(res.headers.location, url);
@@ -39,7 +39,7 @@ export class RequestUtil {
     return cookies;
   }
 
-  private static extractCookies (setCookieHeaders: string[], cookies: { [key: string]: string }) {
+  private static extractCookies (setCookieHeaders: string[], cookies: { [key: string]: string; }) {
     setCookieHeaders.forEach((cookie) => {
       const parts = cookie.split(';')[0]?.split('=');
       if (parts) {
@@ -53,9 +53,10 @@ export class RequestUtil {
   }
 
   // 请求和回复都是JSON data传原始内容 自动编码json
-  static async HttpGetJson<T>(url: string, method: string = 'GET', data?: any, headers: {
-    [key: string]: string
-  } = {}, isJsonRet: boolean = true, isArgJson: boolean = true): Promise<T> {
+  // 支持 301/302 重定向（最多 5 次）
+  static async HttpGetJson<T> (url: string, method: string = 'GET', data?: any, headers: {
+    [key: string]: string;
+  } = {}, isJsonRet: boolean = true, isArgJson: boolean = true, maxRedirects: number = 5): Promise<T> {
     const option = new URL(url);
     const protocol = url.startsWith('https://') ? https : http;
     const options = {
@@ -71,6 +72,20 @@ export class RequestUtil {
     //     },
     return new Promise((resolve, reject) => {
       const req = protocol.request(options, (res: http.IncomingMessage) => {
+        // 处理重定向
+        if ((res.statusCode === 301 || res.statusCode === 302 || res.statusCode === 307 || res.statusCode === 308) && res.headers.location) {
+          if (maxRedirects <= 0) {
+            reject(new Error('Too many redirects'));
+            return;
+          }
+          const redirectUrl = new URL(res.headers.location, url).href;
+          // 递归跟随重定向
+          this.HttpGetJson<T>(redirectUrl, method, data, headers, isJsonRet, isArgJson, maxRedirects - 1)
+            .then(resolve)
+            .catch(reject);
+          return;
+        }
+
         let responseBody = '';
         res.on('data', (chunk: string | Buffer) => {
           responseBody += chunk.toString();
@@ -109,7 +124,7 @@ export class RequestUtil {
   }
 
   // 请求返回都是原始内容
-  static async HttpGetText (url: string, method: string = 'GET', data?: any, headers: { [key: string]: string } = {}) {
+  static async HttpGetText (url: string, method: string = 'GET', data?: any, headers: { [key: string]: string; } = {}) {
     return this.HttpGetJson<string>(url, method, data, headers, false, false);
   }
 }

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

@@ -0,0 +1,24 @@
+export interface SystemStatus {
+  cpu: {
+    model: string,
+    speed: string;
+    usage: {
+      system: string;
+      qq: string;
+    },
+    core: number;
+  },
+  memory: {
+    total: string;
+    usage: {
+      system: string;
+      qq: string;
+    };
+  },
+  arch: string;
+}
+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-common/src/store.ts

@@ -19,4 +19,4 @@ class Store {
 
 const store = new Store();
 
-export default store;
+export default store;

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

@@ -0,0 +1,6 @@
+export type LogListener = (msg: string) => void;
+export interface ISubscription {
+  subscribe (listener: LogListener): void;
+  unsubscribe (listener: LogListener): void;
+  notify (msg: string): void;
+}

packages/napcat-common/src/types.ts

@@ -15,3 +15,14 @@ export type QQVersionConfigType = {
 export type QQAppidTableType = {
   [key: string]: { appid: string, qua: string };
 };
+export interface Peer {
+  chatType: number; // 聊天类型
+  peerUid: string;    // 对等方的唯一标识符
+  guildId?: string;   // 可选的频道ID
+}
+export interface QQLevel {
+  crownNum: number;
+  sunNum: number;
+  moonNum: number;
+  starNum: number;
+}

packages/napcat-common/src/version.ts

@@ -0,0 +1,118 @@
+// @ts-ignore
+export const napCatVersion = (typeof import.meta?.env !== 'undefined' && import.meta.env.VITE_NAPCAT_VERSION) || '1.0.0-dev';
+
+/**
+ * SemVer 2.0 正则表达式
+ * 格式: 主版本号.次版本号.修订号[-先行版本号][+版本编译信息]
+ * 参考: https://semver.org/lang/zh-CN/
+ */
+const SEMVER_REGEX = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+
+export interface SemVerInfo {
+  valid: boolean;
+  normalized: string;
+  major: number;
+  minor: number;
+  patch: number;
+  prerelease: string | null;
+  buildmetadata: string | null;
+}
+
+/**
+ * 解析并验证版本号是否符合 SemVer 2.0 规范
+ * @param version - 版本字符串 (支持 v 前缀)
+ * @returns SemVer 解析结果
+ */
+export function parseSemVer (version: string | undefined | null): SemVerInfo {
+  if (!version || typeof version !== 'string') {
+    return { valid: false, normalized: '1.0.0-dev', major: 1, minor: 0, patch: 0, prerelease: 'dev', buildmetadata: null };
+  }
+
+  const match = version.trim().match(SEMVER_REGEX);
+  if (match) {
+    const major = parseInt(match[1]!, 10);
+    const minor = parseInt(match[2]!, 10);
+    const patch = parseInt(match[3]!, 10);
+    const prerelease = match[4] || null;
+    const buildmetadata = match[5] || null;
+
+    // 构建标准化版本号（不带 v 前缀）
+    let normalized = `${major}.${minor}.${patch}`;
+    if (prerelease) normalized += `-${prerelease}`;
+    if (buildmetadata) normalized += `+${buildmetadata}`;
+
+    return { valid: true, normalized, major, minor, patch, prerelease, buildmetadata };
+  }
+  return { valid: false, normalized: '1.0.0-dev', major: 1, minor: 0, patch: 0, prerelease: 'dev', buildmetadata: null };
+}
+
+/**
+ * 验证版本号是否符合 SemVer 2.0 规范
+ * @param version - 版本字符串
+ * @returns 是否有效
+ */
+export function isValidSemVer (version: string | undefined | null): boolean {
+  return parseSemVer(version).valid;
+}
+
+/**
+ * 比较两个 SemVer 版本号
+ * @param v1 - 版本号1
+ * @param v2 - 版本号2
+ * @returns -1 (v1 < v2), 0 (v1 == v2), 1 (v1 > v2)
+ */
+export function compareSemVer (v1: string, v2: string): -1 | 0 | 1 {
+  const a = parseSemVer(v1);
+  const b = parseSemVer(v2);
+
+  if (!a.valid || !b.valid) {
+    return 0;
+  }
+
+  // 比较主版本号
+  if (a.major !== b.major) return a.major > b.major ? 1 : -1;
+  // 比较次版本号
+  if (a.minor !== b.minor) return a.minor > b.minor ? 1 : -1;
+  // 比较修订号
+  if (a.patch !== b.patch) return a.patch > b.patch ? 1 : -1;
+
+  // 有先行版本号的版本优先级较低
+  if (a.prerelease && !b.prerelease) return -1;
+  if (!a.prerelease && b.prerelease) return 1;
+
+  // 两者都有先行版本号时，按字典序比较
+  if (a.prerelease && b.prerelease) {
+    const aParts = a.prerelease.split('.');
+    const bParts = b.prerelease.split('.');
+    const len = Math.max(aParts.length, bParts.length);
+
+    for (let i = 0; i < len; i++) {
+      const aPart = aParts[i];
+      const bPart = bParts[i];
+
+      if (aPart === undefined) return -1;
+      if (bPart === undefined) return 1;
+
+      const aNum = /^\d+$/.test(aPart) ? parseInt(aPart, 10) : NaN;
+      const bNum = /^\d+$/.test(bPart) ? parseInt(bPart, 10) : NaN;
+
+      // 数字 vs 数字
+      if (!isNaN(aNum) && !isNaN(bNum)) {
+        if (aNum !== bNum) return aNum > bNum ? 1 : -1;
+        continue;
+      }
+      // 数字优先级低于字符串
+      if (!isNaN(aNum)) return -1;
+      if (!isNaN(bNum)) return 1;
+      // 字符串 vs 字符串
+      if (aPart !== bPart) return aPart > bPart ? 1 : -1;
+    }
+  }
+
+  return 0;
+}
+
+/**
+ * 获取解析后的当前版本信息
+ */
+export const napCatVersionInfo = parseSemVer(napCatVersion);

packages/napcat-common/tsconfig.json

@@ -1,36 +1,21 @@
 {
   "compilerOptions": {
     "target": "ES2021",
-    "useDefineForClassFields": true,
     "module": "ESNext",
-    "lib": [
-      "ES2021",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "skipLibCheck": true,
     "moduleResolution": "Node",
-    "experimentalDecorators": true,
-    "allowImportingTsExtensions": false,
-    "allowSyntheticDefaultImports": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "preserve",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
+    "lib": [
+      "ES2021"
+    ],
+    "typeRoots": [
+      "./node_modules/@types"
+    ],
+    "esModuleInterop": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "noEmit": false,
     "sourceMap": true,
-    "paths": {
-      "@/*": [
-        "./src/*"
-      ],
-      "@webapi/*": [
-        "./src/webui/src/*"
-      ]
-    },
-    "noImplicitAny": true,
+    "strict": true,
+    "noImplicitAny": false,
     "strictFunctionTypes": true,
     "strictBindCallApply": true,
     "alwaysStrict": true,
@@ -38,23 +23,31 @@
     "noImplicitReturns": true,
     "noPropertyAccessFromIndexSignature": true,
     "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": false, // 精准可选
+    "exactOptionalPropertyTypes": false,
     "forceConsistentCasingInFileNames": true,
     "useUnknownInCatchVariables": true,
     "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "useDefineForClassFields": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": [
+        "../*"
+      ]
+    },
+    "skipLibCheck": true,
     "skipDefaultLibCheck": true
   },
   "include": [
-    "!@homebridge/node-pty-prebuilt-multiarch/src/eventEmitter2.ts",
-    "!@homebridge/node-pty-prebuilt-multiarch/src/terminal.ts",
-    "!@napneko/nap-proto-core/NapProto.ts",
-    "src/**/*.ts",
+    "src/**/*.ts"
   ],
   "exclude": [
     "node_modules",
-    "node_modules/**/*",
-    "node_modules/@homebridge/node-pty-prebuilt-multiarch/src/eventEmitter2.ts",
-    "node_modules/@homebridge/node-pty-prebuilt-multiarch/src/terminal.ts",
-    "node_modules/@napneko/nap-proto-core/NapProto.ts"
+    "dist"
   ]
 }

packages/napcat-core/adapters/NodeIDependsAdapter.ts

@@ -1,11 +1,11 @@
-import { MsfChangeReasonType, MsfStatusType } from '@/core/types/adapter';
+import { MsfChangeReasonType, MsfStatusType } from '@/napcat-core/types/adapter';
 
 export class NodeIDependsAdapter {
   onMSFStatusChange (_statusType: MsfStatusType, _changeReasonType: MsfChangeReasonType) {
 
   }
 
-  onMSFSsoError (_args: unknown) {
+  onMSFSsoError (_code: number, _desc: string) {
 
   }
 
@@ -24,4 +24,4 @@ export class NodeIDependsAdapter {
 
   //   console.log('[NodeIDependsAdapter] onSendMsfReply', _seq, _cmd, _uk1, _uk2, Buffer.from(_rsp.pbBuffer).toString('hex'));
   // }
-}
+}

packages/napcat-core/apis/collection.ts

@@ -1,4 +1,4 @@
-import { InstanceContext, NapCatCore } from '@/core';
+import { InstanceContext, NapCatCore } from '@/napcat-core/index';
 
 export class NTQQCollectionApi {
   context: InstanceContext;

packages/napcat-core/apis/file.ts

@@ -5,30 +5,18 @@ import {
   IMAGE_HTTP_HOST_NT,
   Peer,
   PicElement,
-  PicSubType,
   RawMessage,
-  SendFileElement,
-  SendPicElement,
-  SendPttElement,
-  SendVideoElement,
-} from '@/core/types';
+} from '@/napcat-core/types';
 import path from 'path';
 import fs from 'fs';
 import fsPromises from 'fs/promises';
-import { InstanceContext, NapCatCore, SearchResultItem } from '@/core';
+import { InstanceContext, NapCatCore, SearchResultItem } from '@/napcat-core/index';
 import { fileTypeFromFile } from 'file-type';
-import { RkeyManager } from '@/core/helper/rkey';
-import { calculateFileMD5 } from '@/common/file';
-import pathLib from 'node:path';
-import { defaultVideoThumbB64 } from '@/common/video';
-import { encodeSilk } from '@/common/audio';
-import { SendMessageContext } from '@/onebot/api';
-import { getFileTypeForSendType } from '../helper/msg';
-import { FFmpegService } from '@/common/ffmpeg';
+import { RkeyManager } from '@/napcat-core/helper/rkey';
+import { calculateFileMD5 } from 'napcat-common/src/file';
 import { rkeyDataType } from '../types/file';
-import { NapProtoMsg } from '@napneko/nap-proto-core';
+import { NapProtoMsg } from 'napcat-protobuf';
 import { FileId } from '../packet/transformer/proto/misc/fileid';
-import { imageSizeFallBack } from '@/image-size';
 
 export class NTQQFileApi {
   context: InstanceContext;
@@ -150,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}` : '';
@@ -158,188 +146,38 @@ 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,
     };
   }
 
-  async createValidSendFileElement (context: SendMessageContext, filePath: string, fileName: string = '', folderId: string = ''): Promise<SendFileElement> {
-    const {
-      fileName: _fileName,
-      path,
-      fileSize,
-    } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.FILE);
-    if (fileSize === 0) {
-      throw new Error('文件异常，大小为0');
-    }
-    context.deleteAfterSentFiles.push(path);
-    return {
-      elementType: ElementType.FILE,
-      elementId: '',
-      fileElement: {
-        fileName: fileName || _fileName,
-        folderId,
-        filePath: path,
-        fileSize: fileSize.toString(),
-      },
-    };
-  }
-
-  async createValidSendPicElement (context: SendMessageContext, picPath: string, summary: string = '', subType: PicSubType = 0): Promise<SendPicElement> {
-    const { md5, fileName, path, fileSize } = await this.core.apis.FileApi.uploadFile(picPath, ElementType.PIC, subType);
-    if (fileSize === 0) {
-      throw new Error('文件异常，大小为0');
-    }
-    const imageSize = await imageSizeFallBack(picPath);
-    context.deleteAfterSentFiles.push(path);
-    return {
-      elementType: ElementType.PIC,
-      elementId: '',
-      picElement: {
-        md5HexStr: md5,
-        fileSize: fileSize.toString(),
-        picWidth: imageSize.width,
-        picHeight: imageSize.height,
-        fileName,
-        sourcePath: path,
-        original: true,
-        picType: await getFileTypeForSendType(picPath),
-        picSubType: subType,
-        fileUuid: '',
-        fileSubId: '',
-        thumbFileSize: 0,
-        summary,
-      } as PicElement,
-    };
-  }
-
-  async createValidSendVideoElement (context: SendMessageContext, filePath: string, fileName: string = '', _diyThumbPath: string = ''): Promise<SendVideoElement> {
-    let videoInfo = {
-      width: 1920,
-      height: 1080,
-      time: 15,
-      format: 'mp4',
-      size: 0,
-      filePath,
-    };
-    let fileExt = 'mp4';
-    try {
-      const tempExt = (await fileTypeFromFile(filePath))?.ext;
-      if (tempExt) fileExt = tempExt;
-    } catch (e) {
-      this.context.logger.logError('获取文件类型失败', e);
-    }
-    const newFilePath = `${filePath}.${fileExt}`;
-    fs.copyFileSync(filePath, newFilePath);
-    context.deleteAfterSentFiles.push(newFilePath);
-    filePath = newFilePath;
-
-    const { fileName: _fileName, path, fileSize, md5 } = await this.core.apis.FileApi.uploadFile(filePath, ElementType.VIDEO);
-    context.deleteAfterSentFiles.push(path);
-    if (fileSize === 0) {
-      throw new Error('文件异常，大小为0');
-    }
-    const thumbDir = path.replace(`${pathLib.sep}Ori${pathLib.sep}`, `${pathLib.sep}Thumb${pathLib.sep}`);
-    fs.mkdirSync(pathLib.dirname(thumbDir), { recursive: true });
-    const thumbPath = pathLib.join(pathLib.dirname(thumbDir), `${md5}_0.png`);
-    try {
-      videoInfo = await FFmpegService.getVideoInfo(filePath, thumbPath);
-      if (!fs.existsSync(thumbPath)) {
-        this.context.logger.logError('获取视频缩略图失败', new Error('缩略图不存在'));
-        throw new Error('获取视频缩略图失败');
-      }
-    } catch (e) {
-      this.context.logger.logError('获取视频信息失败', e);
-      fs.writeFileSync(thumbPath, Buffer.from(defaultVideoThumbB64, 'base64'));
-    }
-    if (_diyThumbPath) {
-      try {
-        await this.copyFile(_diyThumbPath, thumbPath);
-      } catch (e) {
-        this.context.logger.logError('复制自定义缩略图失败', e);
-      }
-    }
-    context.deleteAfterSentFiles.push(thumbPath);
-    const thumbSize = (await fsPromises.stat(thumbPath)).size;
-    const thumbMd5 = await calculateFileMD5(thumbPath);
-    context.deleteAfterSentFiles.push(thumbPath);
-
-    const uploadName = (fileName || _fileName).toLocaleLowerCase().endsWith(`.${fileExt.toLocaleLowerCase()}`) ? (fileName || _fileName) : `${fileName || _fileName}.${fileExt}`;
-    return {
-      elementType: ElementType.VIDEO,
-      elementId: '',
-      videoElement: {
-        fileName: uploadName,
-        filePath: path,
-        videoMd5: md5,
-        thumbMd5,
-        fileTime: videoInfo.time,
-        thumbPath: new Map([[0, thumbPath]]),
-        thumbSize,
-        thumbWidth: videoInfo.width,
-        thumbHeight: videoInfo.height,
-        fileSize: fileSize.toString(),
-      },
-    };
-  }
-
-  async createValidSendPttElement (_context: SendMessageContext, pttPath: string): Promise<SendPttElement> {
-    const { converted, path: silkPath, duration } = await encodeSilk(pttPath, this.core.NapCatTempPath, this.core.context.logger);
-    if (!silkPath) {
-      throw new Error('语音转换失败, 请检查语音文件是否正常');
-    }
-    const { md5, fileName, path, fileSize } = await this.core.apis.FileApi.uploadFile(silkPath, ElementType.PTT);
-    if (fileSize === 0) {
-      throw new Error('文件异常，大小为0');
-    }
-    if (converted) {
-      fsPromises.unlink(silkPath).then().catch((e) => this.context.logger.logError('删除临时文件失败', e));
-    }
-    return {
-      elementType: ElementType.PTT,
-      elementId: '',
-      pttElement: {
-        fileName,
-        filePath: path,
-        md5HexStr: md5,
-        fileSize: fileSize.toString(),
-        duration: duration ?? 1,
-        formatType: 1,
-        voiceType: 1,
-        voiceChangeType: 0,
-        canConvert2Text: true,
-        waveAmplitudes: [
-          0, 18, 9, 23, 16, 17, 16, 15, 44, 17, 24, 20, 14, 15, 17,
-        ],
-        fileSubId: '',
-        playState: 1,
-        autoConvertText: 0,
-        storeID: 0,
-        otherBusinessInfo: {
-          aiVoiceType: 0,
-        },
-      },
-    };
-  }
-
   async downloadFileForModelId (peer: Peer, modelId: string, unknown: string, timeout = 1000 * 60 * 2) {
     const [, fileTransNotifyInfo] = await this.core.eventWrapper.callNormalEventV2(
       'NodeIKernelRichMediaService/downloadFileForModelId',

packages/napcat-core/apis/friend.ts

@@ -1,6 +1,6 @@
-import { FriendRequest, FriendV2 } from '@/core/types';
-import { BuddyListReqType, InstanceContext, NapCatCore } from '@/core';
-import { LimitedHashTable } from '@/common/message-unique';
+import { FriendRequest, FriendV2 } from '@/napcat-core/types';
+import { BuddyListReqType, InstanceContext, NapCatCore } from '@/napcat-core/index';
+import { LimitedHashTable } from 'napcat-common/src/message-unique';
 
 export class NTQQFriendApi {
   context: InstanceContext;

packages/napcat-core/apis/group.ts

@@ -12,12 +12,12 @@ import {
   ShutUpGroupMember,
   Peer,
   ChatType,
-} from '@/core';
-import { isNumeric, solveAsyncProblem } from '@/common/helper';
-import { LimitedHashTable } from '@/common/message-unique';
-import { NTEventWrapper } from '@/common/event';
-import { CancelableTask, TaskExecutor } from '@/common/cancel-task';
+} from '@/napcat-core/index';
+import { isNumeric, solveAsyncProblem } from 'napcat-common/src/helper';
+import { LimitedHashTable } from 'napcat-common/src/message-unique';
+import { CancelableTask, TaskExecutor } from 'napcat-common/src/cancel-task';
 import { createGroupDetailInfoV2Param, createGroupExtFilter, createGroupExtInfo } from '../data';
+import { NTEventWrapper } from '../helper/event';
 
 export class NTQQGroupApi {
   context: InstanceContext;
@@ -395,7 +395,7 @@ export class NTQQGroupApi {
         'NodeIKernelGroupListener/onMemberInfoChange',
         [groupCode, [uid], forced],
         (ret) => ret.result === 0,
-        (params, _, members) => params === GroupCode && members.size > 0 && members.has(uid),
+        (params: string, _: any, members: Map<string, GroupMember>) => params === GroupCode && members.size > 0 && members.has(uid),
         1,
         forced ? 2500 : 250
       );

packages/napcat-core/apis/msg.ts

@@ -1,6 +1,6 @@
-import { ChatType, GetFileListParam, Peer, RawMessage, SendMessageElement, SendStatusType } from '@/core/types';
-import { GroupFileInfoUpdateItem, InstanceContext, NapCatCore, NodeIKernelMsgService } from '@/core';
-import { GeneralCallResult } from '@/core/services/common';
+import { ChatType, GetFileListParam, Peer, RawMessage, SendMessageElement, SendStatusType } from '@/napcat-core/types';
+import { GroupFileInfoUpdateItem, InstanceContext, NapCatCore, NodeIKernelMsgService } from '@/napcat-core/index';
+import { GeneralCallResult } from '@/napcat-core/services/common';
 
 export class NTQQMsgApi {
   context: InstanceContext;

packages/napcat-core/apis/packet.ts

@@ -1,9 +1,9 @@
 import * as os from 'os';
-import offset from '@/core/external/napi2native.json';
-import { InstanceContext, NapCatCore } from '@/core';
-import { LogWrapper } from '@/common/log';
-import { PacketClientSession } from '@/core/packet/clientSession';
-import { napCatVersion } from '@/common/version';
+import offset from '@/napcat-core/external/napi2native.json';
+import { InstanceContext, NapCatCore } from '@/napcat-core/index';
+import { PacketClientSession } from '@/napcat-core/packet/clientSession';
+import { napCatVersion } from 'napcat-common/src/version';
+import { LogWrapper } from '../helper/log';
 
 interface OffsetType {
   [key: string]: {

packages/napcat-core/apis/system.ts

@@ -1,4 +1,4 @@
-import { InstanceContext, NapCatCore } from '@/core';
+import { InstanceContext, NapCatCore } from '@/napcat-core/index';
 
 export class NTQQSystemApi {
   context: InstanceContext;

packages/napcat-core/apis/user.ts

@@ -1,8 +1,8 @@
-import { ModifyProfileParams, User, UserDetailSource } from '@/core/types';
-import { RequestUtil } from '@/common/request';
+import { ModifyProfileParams, User, UserDetailSource } from '@/napcat-core/types';
+import { RequestUtil } from 'napcat-common/src/request';
 import { InstanceContext, NapCatCore, ProfileBizType } from '..';
-import { solveAsyncProblem } from '@/common/helper';
-import { Fallback, FallbackUtil } from '@/common/fall-back';
+import { solveAsyncProblem } from 'napcat-common/src/helper';
+import { Fallback, FallbackUtil } from 'napcat-common/src/fall-back';
 
 export class NTQQUserApi {
   context: InstanceContext;

packages/napcat-core/apis/webapi.ts

@@ -1,4 +1,4 @@
-import { RequestUtil } from '@/common/request';
+import { RequestUtil } from 'napcat-common/src/request';
 import {
   GroupEssenceMsgRet,
   InstanceContext,
@@ -6,7 +6,7 @@ import {
   WebApiGroupMemberRet,
   WebApiGroupNoticeRet,
   WebHonorType, NapCatCore,
-} from '@/core';
+} from '@/napcat-core/index';
 
 import { createReadStream, readFileSync, statSync } from 'node:fs';
 import { createHash } from 'node:crypto';