Add support for preloading Node Addons via env var

Introduces logic to preload a Node Addon in the worker process if the NAPCAT_PRELOAD_NODE_ADDON_PATH environment variable is set. Logs success or failure of the preload operation for better debugging and flexibility.
Revert "Add manual trigger to auto-release workflow"
2026-02-28 07:40:27 +00:00 · 2026-01-22 12:55:34 +08:00 · 2026-01-22 12:53:52 +08:00 · 2026-01-22 12:53:11 +08:00 · 2026-01-22 12:13:14 +08:00 · 2026-01-22 12:12:38 +08:00
4 changed files with 31 additions and 5 deletions
--- a/.github/workflows/auto-release.yml
+++ b/.github/workflows/auto-release.yml
@@ -80,4 +80,17 @@ jobs:
                -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}\"}}"
+      - 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/94704804/linuxqq_3.2.23-44343_x86_64.AppImage' # 写死 QQ 版本
+            QQ_VERSION_ARM64: 'https://dldir1v6.qq.com/qqfile/qq/QQNT/94704804/linuxqq_3.2.23-44343_arm64.AppImage' # 写死 QQ 版本
+        run: |
+            echo "Debug: Triggering Release NapCat AppImage with napcat_version=${NAPCAT_VERSION}, qq_url_amd64=${QQ_VERSION_X86_64}, qq_url_arm64=${QQ_VERSION_ARM64}"
+            curl -X POST \
+                -H "Accept: application/vnd.github+json" \
+                -H "Authorization: Bearer $GH_TOKEN" \
+                https://api.github.com/repos/NapNeko/NapCatLinuxNodeLoader/actions/workflows/docker-publish.yml/dispatches \
                -d "{\"ref\":\"main\",\"inputs\":{\"napcat_version\":\"${NAPCAT_VERSION}\",\"qq_url_amd64\":\"${QQ_VERSION_X86_64}\",\"qq_url_arm64\":\"${QQ_VERSION_ARM64}\"}}"
--- a/packages/napcat-onebot/types/message.ts
+++ b/packages/napcat-onebot/types/message.ts
@@ -103,7 +103,7 @@ export interface OB11MessageText {
 }

 // 联系人消息接口定义
-export interface OB11MessageContext {
+export interface OB11MessageContact {
  type: OB11MessageDataType.contact;
  data: {
    type: 'qq' | 'group';
@@ -260,7 +260,7 @@ export type OB11MessageData =
  OB11MessageAt | OB11MessageReply |
  OB11MessageImage | OB11MessageRecord | OB11MessageFile | OB11MessageVideo |
  OB11MessageNode | OB11MessageIdMusic | OB11MessageCustomMusic | OB11MessageJson |
-  OB11MessageDice | OB11MessageRPS | OB11MessageMarkdown | OB11MessageForward | OB11MessageContext | OB11MessagePoke;
+  OB11MessageDice | OB11MessageRPS | OB11MessageMarkdown | OB11MessageForward | OB11MessageContact | OB11MessagePoke;

 // 发送消息接口定义
 export interface OB11PostSendMsg {
--- a/packages/napcat-shell/base.ts
+++ b/packages/napcat-shell/base.ts
@@ -35,6 +35,7 @@ import { proxiedListenerOf } from '@/napcat-core/helper/proxy-handler';
 import { QQBasicInfoWrapper } from '@/napcat-core/helper/qq-basic-info';
 import { statusHelperSubscription } from '@/napcat-core/helper/status';
 import { applyPendingUpdates } from '@/napcat-webui-backend/src/api/UpdateNapCat';
+import { connectToNamedPipe } from './pipe';
 // NapCat Shell App ES 入口文件
 async function handleUncaughtExceptions (logger: LogWrapper) {
  process.on('uncaughtException', (err) => {
@@ -342,9 +343,9 @@ export async function NCoreInitShell () {
  // 初始化 FFmpeg 服务
  await FFmpegService.init(pathWrapper.binaryPath, logger);

-  // if (process.env['NAPCAT_DISABLE_PIPE'] !== '1') {
-  //   await connectToNamedPipe(logger).catch(e => logger.logError('命名管道连接失败', e));
-  // }
+  if (process.env['NAPCAT_DISABLE_PIPE'] !== '1' && process.env['NAPCAT_DISABLE_MULTI_PROCESS'] !== '1') {
+    await connectToNamedPipe(logger).catch(e => logger.logError('命名管道连接失败', e));
+  }
  const basicInfoWrapper = new QQBasicInfoWrapper({ logger });
  const wrapper = loadQQWrapper(basicInfoWrapper.getFullQQVersion());
  const nativePacketHandler = new NativePacketHandler({ logger }); // 初始化 NativePacketHandler 用于后续使用
--- a/packages/napcat-shell/napcat.ts
+++ b/packages/napcat-shell/napcat.ts
@@ -281,6 +281,18 @@ async function startWorkerProcess (): Promise<void> {
    throw new Error('进程管理器未初始化');
  }

+  // 预加载 Node Addon（如果设置了环境变量）
+  const preloadAddonPath = process.env['NAPCAT_PRELOAD_NODE_ADDON_PATH'];
+  if (preloadAddonPath) {
+    try {
+      const os = await import('os');
+      process.dlopen({ exports: {} }, preloadAddonPath, os.constants.dlopen.RTLD_NOW | os.constants.dlopen.RTLD_GLOBAL);
+      logger.log(`[NapCat] [Worker] 已预加载 Node Addon: ${preloadAddonPath}`);
+    } catch (error) {
+      logger.logError(`[NapCat] [Worker] 预加载 Node Addon 失败: ${preloadAddonPath}`, error);
+    }
+  }
+
  // 监听来自父进程的消息
  processManager.onParentMessage((msg: unknown) => {
    if (typeof msg === 'object' && msg !== null && 'type' in msg) {
Author	SHA1	Message	Date
手瓜一十雪	1b4d604e32	Add support for preloading Node Addons via env var Introduces logic to preload a Node Addon in the worker process if the NAPCAT_PRELOAD_NODE_ADDON_PATH environment variable is set. Logs success or failure of the preload operation for better debugging and flexibility.	2026-01-22 12:55:34 +08:00
手瓜一十雪	81a0c07922	Revert "Add manual trigger to auto-release workflow" This reverts commit `d25bd65b2d`.	2026-01-22 12:53:52 +08:00
手瓜一十雪	a8cb6b5865	Revert "Add support for CJS environment loader in main entry" This reverts commit `711a060dd9`.	2026-01-22 12:53:11 +08:00
手瓜一十雪	d25bd65b2d	Add manual trigger to auto-release workflow Enables the auto-release workflow to be triggered manually using workflow_dispatch, in addition to running on published releases.	2026-01-22 12:13:14 +08:00
手瓜一十雪	e510a75f0c	Add workflow to trigger NapCat AppImage release Introduces a new GitHub Actions step to trigger the Release NapCat AppImage workflow. This step uses hardcoded QQ AppImage URLs for both x86_64 and arm64 architectures and passes the latest NapCat version as input.	2026-01-22 12:12:38 +08:00
吴天一	e3c6048a7f	Rename OB11MessageContext to OB11MessageContact (#1540 )	2026-01-22 12:06:59 +08:00
手瓜一十雪	789c72d4cf	Trigger docker-publish workflow in auto-release Added a POST request to dispatch the docker-publish workflow alongside the release workflow in the auto-release GitHub Actions workflow. This ensures both workflows are triggered with the same input parameters. Fix indentation for curl command in workflow Corrected the indentation of a curl command in the auto-release GitHub Actions workflow to ensure proper execution of the job steps.	2026-01-22 12:05:40 +08:00
手瓜一十雪	711a060dd9	Add support for CJS environment loader in main entry Checks for the NAPCAT_NODE_CJS_ENV_LOADER_PATH environment variable and loads the specified CommonJS environment loader if present. Logs success or failure and exits on error. This allows for custom environment setup before continuing with the main process.	2026-01-22 11:58:13 +08:00
手瓜一十雪	6268923f01	Fix import path for connectToNamedPipe in base.ts Some checks failed Build NapCat Artifacts / Build-Framework (push) Has been cancelled Details Build NapCat Artifacts / Build-Shell (push) Has been cancelled Details Updated the import statement for connectToNamedPipe to use a relative path instead of an alias. This resolves issues with module resolution in the napcat-shell package.	2026-01-18 14:50:34 +08:00
手瓜一十雪	f6b9017429	Enable named pipe connection with multi-process check Restores the named pipe connection in NCoreInitShell, now gated by both NAPCAT_DISABLE_PIPE and NAPCAT_DISABLE_MULTI_PROCESS environment variables. This ensures the pipe is only connected when multi-process is enabled.	2026-01-18 14:42:00 +08:00