Add configurable automatic time sync

Add autoTimeSync (default: true) to the Napcat config and honor NAPCAT_DISABLE_TIME_SYNC=1 or autoTimeSync=false to disable automatic time synchronization. When enabled, time sync is attempted via getServerTime with errors logged; warning threshold for significant drift increased from 1s to 5s. Adds informational log when auto time sync is disabled.

Author: MliKiowa

packages/napcat-core/helper/config.ts

@@ -23,6 +23,7 @@ export const NapcatConfigSchema = Type.Object({
   packetBackend: Type.String({ default: 'auto' }),
   packetServer: Type.String({ default: '' }),
   o3HookMode: Type.Number({ default: 0 }),
+  autoTimeSync: Type.Boolean({ default: true }),
   bypass: Type.Optional(BypassOptionsSchema),
 });
 

packages/napcat-core/index.ts

@@ -176,15 +176,20 @@ export class NapCatCore {
       fs.mkdirSync(this.NapCatTempPath, { recursive: true });
     }
     // 通过 getServerTime 全局 hook Date.now() 矫正本地时间偏差
-    try {
-      const offsetMs = hookGlobalDateNow(() => this.context.session.getMSFService().getServerTime());
-      if (Math.abs(offsetMs) > 1000) {
-        this.context.logger.logWarn(`[ServerTime] 本地时间与服务器时间偏差 ${(offsetMs / 1000).toFixed(1)}s，已自动矫正`);
-      } else {
-        this.context.logger.log(`[ServerTime] 时间同步完成，偏差 ${offsetMs}ms`);
+    // 可通过环境变量 NAPCAT_DISABLE_TIME_SYNC=1 或配置 autoTimeSync: false 禁用
+    if (process.env['NAPCAT_DISABLE_TIME_SYNC'] === '1' || !this.configLoader.configData.autoTimeSync) {
+      this.context.logger.log('[ServerTime] 自动对时已禁用');
+    } else {
+      try {
+        const offsetMs = hookGlobalDateNow(() => this.context.session.getMSFService().getServerTime());
+        if (Math.abs(offsetMs) > 5000) {
+          this.context.logger.logWarn(`[ServerTime] 本地时间与服务器时间偏差 ${(offsetMs / 1000).toFixed(1)}s，已自动矫正`);
+        } else {
+          this.context.logger.log(`[ServerTime] 时间同步完成，偏差 ${offsetMs}ms`);
+        }
+      } catch (e) {
+        this.context.logger.logError('[ServerTime] 时间矫正失败', e);
       }
-    } catch (e) {
-      this.context.logger.logError('[ServerTime] 时间矫正失败', e);
     }
     // 遍历this.apis[i].initApi 如果存在该函数进行async 调用
     for (const apiKey in this.apis) {