koishi-plugin-maichuni-scorehelper 0.0.17-test → 0.0.19-test

package/dist/services/maimai-status.d.ts

@@ -7,6 +7,7 @@ export interface Config {
     mainServiceName: string;
     statusPageUrl: string;
     heartbeatApiUrl: string;
+    debug?: boolean;
 }
 export declare const Config: Schema<Config>;
 declare module 'koishi' {
@@ -23,6 +24,7 @@ export declare class MaimaiStatus extends Service {
     private readonly CACHE_FILE;
     private readonly UA;
     constructor(ctx: Context, config: Config);
+    private logDebug;
     protected start(): Promise<void>;
     protected stop(): Promise<void>;
     /**

package/dist/services/maimai-status.js

@@ -16,7 +16,8 @@ exports.Config = koishi_1.Schema.object({
     showRecovery: koishi_1.Schema.boolean().default(true).description('是否在服务恢复时也发送通知'),
     mainServiceName: koishi_1.Schema.string().default('舞萌DX服务').description('主服务名称（去除了后缀的），当该服务下线时，屏蔽其他服务的通知'),
     statusPageUrl: koishi_1.Schema.string().default(DEFAULT_STATUS_PAGE_URL).description('状态页 URL，默认使用内置反代，可自定义'),
-    heartbeatApiUrl: koishi_1.Schema.string().default(DEFAULT_HEARTBEAT_API_URL).description('心跳 API URL，默认使用内置反代，可自定义')
+    heartbeatApiUrl: koishi_1.Schema.string().default(DEFAULT_HEARTBEAT_API_URL).description('心跳 API URL，默认使用内置反代，可自定义'),
+    debug: koishi_1.Schema.boolean().default(false).description('开启后输出详细调试日志')
 });
 // 常量配置
 const FLAP_WINDOW = 10 * 60 * 1000; // 10分钟
@@ -35,6 +36,12 @@ class MaimaiStatus extends koishi_1.Service {
         this.UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
         this.clientLogger = ctx.logger('maimai-status');
     }
+    logDebug(...args) {
+        if (!this.config.debug)
+            return;
+        // 当 debug 开启时，使用 info 级别输出，确保默认日志等级也能看到
+        this.clientLogger.info.apply(this.clientLogger, ['[debug]', ...args]);
+    }
     async start() {
         this.clientLogger.info('Maimai status monitor started.');
         // 立即执行一次
@@ -202,6 +209,8 @@ class MaimaiStatus extends koishi_1.Service {
                     catch (_) { /* ignore timeout */ }
                     // 直接从页面上下文获取数据
                     data = await page.evaluate(() => window.preloadData);
+                    const bodySnippet = await page.evaluate(() => (document?.body?.innerText || '').slice(0, 50));
+                    this.logDebug(`[monitor] puppeteer body head: ${bodySnippet}`);
                 }
                 finally {
                     await page.close();
@@ -218,6 +227,7 @@ class MaimaiStatus extends koishi_1.Service {
                     responseType: 'text',
                     headers: { 'User-Agent': this.UA }
                 });
+                this.logDebug(`[monitor] http body head: ${String(html).slice(0, 50)}`);
                 const regex = /window\.preloadData\s*=\s*(\{.*?\});/s;
                 const match = html.match(regex);
                 if (match && match[1]) {
@@ -231,6 +241,7 @@ class MaimaiStatus extends koishi_1.Service {
         }
         if (data) {
             const monitorList = [];
+            this.logDebug('[monitor] parsed preloadData keys:', Object.keys(data || {}));
             if (data.config && Array.isArray(data.publicGroupList)) {
                 for (const group of data.publicGroupList) {
                     if (Array.isArray(group.monitorList)) {
@@ -238,6 +249,7 @@ class MaimaiStatus extends koishi_1.Service {
                     }
                 }
             }
+            this.logDebug(`[monitor] monitorList length=${monitorList.length}`);
             return monitorList;
         }
         return [];
@@ -308,6 +320,7 @@ class MaimaiStatus extends koishi_1.Service {
                 await page.goto(url, { waitUntil: 'networkidle0', timeout: 20000 });
                 // 直接读取正文文本（可能被 JS 动态生成）
                 const body = await page.evaluate(() => document.body?.innerText || document.body?.textContent || '');
+                this.logDebug(`[heartbeat] puppeteer body head: ${body.slice(0, 50)}`);
                 if (!body)
                     return null;
                 try {
@@ -336,6 +349,7 @@ class MaimaiStatus extends koishi_1.Service {
                 headers: { 'User-Agent': this.UA },
                 timeout: 15000
             });
+            this.logDebug(`[heartbeat] http body head: ${typeof data === 'string' ? data.slice(0, 50) : '[object]'}`);
             // 如果不是对象，尝试解析 JSON (因为 Object.keys 打印出了索引，说明是字符串)
             if (typeof data === 'string') {
                 try {
@@ -354,6 +368,7 @@ class MaimaiStatus extends koishi_1.Service {
                 }
             }
             // 返回原始对象，包含 heartbeatList 和 uptimeList
+            this.logDebug('[heartbeat] parsed keys:', Array.isArray(data) ? `array length ${data.length}` : Object.keys(data || {}));
             return data || {};
         }
         catch (e) {
@@ -417,21 +432,12 @@ class MaimaiStatus extends koishi_1.Service {
         const isMainServiceOffline = mainServiceCurrentStatus === 'OFFLINE';
         for (const { group, currentStatus } of updates) {
             const { groupName, lastStatus, isMuted, muteUntil } = group;
+            this.logDebug(`[state] ${groupName}: last=${lastStatus} current=${currentStatus}`);
             // 检查静音过期
             if (isMuted && now > muteUntil) {
                 group.isMuted = false;
                 this.clientLogger.info(`[${groupName}] 静音结束，恢复监控通知。`);
             }
-            // 0. 初始化或状态无变更的处理
-            if (lastStatus === 'UNKNOWN') {
-                // 首次初始化，静默更新
-                group.lastStatus = currentStatus;
-                group.consecutiveFailures = 0;
-                continue;
-            }
-            if (currentStatus === lastStatus) {
-                continue;
-            }
             // 如果处于静音状态，只更新状态，不进行通知推送判定
             if (group.isMuted) {
                 group.lastStatus = currentStatus;
@@ -444,9 +450,11 @@ class MaimaiStatus extends koishi_1.Service {
                 // 静默更新状态，重置连续失败计数以防恢复瞬间误报
                 group.consecutiveFailures = 0;
                 group.lastStatus = currentStatus;
+                this.clientLogger.debug(`[${groupName}] 跳过通知：主服务离线，当前状态 ${currentStatus}`);
                 continue;
             }
-            // 正常的报警逻辑 (含 3 次确认)
+            // 正常的报警逻辑 (含 3 次确认)。
+            // 注意：即便状态未变化，也需要累计 consecutiveFailures，以便长时间离线也能触发阈值。
             await this.processNotificationLogic(group, currentStatus);
             // 更新最后状态
             group.lastStatus = currentStatus;
@@ -464,12 +472,14 @@ class MaimaiStatus extends koishi_1.Service {
         const groupName = group.groupName || 'Unknown Service'; // Fallback
         const isAbnormal = currentStatus === 'OFFLINE' || currentStatus === 'PARTIAL_OFFLINE';
         const wasAbnormal = group.lastStatus === 'OFFLINE' || group.lastStatus === 'PARTIAL_OFFLINE';
+        const isInit = group.lastStatus === 'UNKNOWN';
         if (isAbnormal) {
-            // 异常计数 +1
+            // 异常计数 +1（初次发现也要记一次）
             group.consecutiveFailures++;
             // 只有达到阈值（第3次）时才报警，且之前没有报过（或者这是一个新的连续序列）
             // 注意：如果已经是第 4, 5 次，保持当前状态不变，不再重复报
             if (group.consecutiveFailures === FAILURE_THRESHOLD) {
+                this.logDebug(`[notify] threshold reached for ${groupName}: last=${group.lastStatus} current=${currentStatus}`);
                 await this.handleStatusChange(groupName, group.lastStatus, currentStatus);
             }
             else if (group.consecutiveFailures < FAILURE_THRESHOLD) {
@@ -480,11 +490,16 @@ class MaimaiStatus extends koishi_1.Service {
             // 当前是 ONLINE
             if (wasAbnormal && group.consecutiveFailures >= FAILURE_THRESHOLD) {
                 // 之前是异常，且已经报警过了（超过阈值），现在恢复 -> 发送恢复通知
+                this.logDebug(`[notify] recovery for ${groupName}: last=${group.lastStatus} -> ONLINE`);
                 await this.handleStatusChange(groupName, group.lastStatus, currentStatus);
             }
             // 重置计数
             group.consecutiveFailures = 0;
         }
+        // 首次初始化状态也要记录，防止后续一直停留在 UNKNOWN 导致不推送
+        if (isInit && group.lastStatus === 'UNKNOWN') {
+            group.lastStatus = currentStatus;
+        }
     }
     /**
      * 状态变更处理接口
@@ -519,6 +534,7 @@ class MaimaiStatus extends koishi_1.Service {
             }
         }
         if (shouldNotify) {
+            this.logDebug(`[notify] will push: ${name} ${from} -> ${to}`);
             // 防抖检测：仅在真正决定推送时记录
             const group = this.groups.get(name);
             if (group) {
@@ -549,6 +565,7 @@ class MaimaiStatus extends koishi_1.Service {
                 // 获取 bot 实例发送 (需要确保 context 中有 bot)
                 const bot = this.ctx.bots[0];
                 if (bot) {
+                    this.logDebug(`[push] send to ${this.config.targetChannelId} level=${level} msgHead=${message.slice(0, 50)}`);
                     await bot.sendMessage(this.config.targetChannelId, message);
                 }
                 else {
@@ -561,6 +578,7 @@ class MaimaiStatus extends koishi_1.Service {
         }
         else {
             this.clientLogger.debug('Notification skipped: targetChannelId not configured.');
+            this.logDebug(`[push] skipped push, no target. level=${level} msgHead=${message.slice(0, 50)}`);
         }
         // 示例：您也可以在这里添加 HTTP webhook 推送
         // await this.ctx.http.post('YOUR_WEBHOOK_URL', { content: message })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-maichuni-scorehelper",
-  "version": "0.0.17-test",
+  "version": "0.0.19-test",
   "description": "【未完成】一些舞萌中二节奏功能",
   "keywords": [
     "koishi",

package/src/services/maimai-status.ts

@@ -14,6 +14,7 @@ export interface Config {
   mainServiceName: string
   statusPageUrl: string
   heartbeatApiUrl: string
+  debug?: boolean
 }
 
 export const Config: Schema<Config> = Schema.object({
@@ -22,7 +23,8 @@ export const Config: Schema<Config> = Schema.object({
   showRecovery: Schema.boolean().default(true).description('是否在服务恢复时也发送通知'),
   mainServiceName: Schema.string().default('舞萌DX服务').description('主服务名称（去除了后缀的），当该服务下线时，屏蔽其他服务的通知'),
   statusPageUrl: Schema.string().default(DEFAULT_STATUS_PAGE_URL).description('状态页 URL，默认使用内置反代，可自定义'),
-  heartbeatApiUrl: Schema.string().default(DEFAULT_HEARTBEAT_API_URL).description('心跳 API URL，默认使用内置反代，可自定义')
+  heartbeatApiUrl: Schema.string().default(DEFAULT_HEARTBEAT_API_URL).description('心跳 API URL，默认使用内置反代，可自定义'),
+  debug: Schema.boolean().default(false).description('开启后输出详细调试日志')
 })
 
 // 定义服务状态枚举
@@ -76,6 +78,12 @@ export class MaimaiStatus extends Service {
     this.clientLogger = ctx.logger('maimai-status')
   }
 
+  private logDebug(...args: any[]) {
+    if (!this.config.debug) return
+    // 当 debug 开启时，使用 info 级别输出，确保默认日志等级也能看到
+    this.clientLogger.info.apply(this.clientLogger, ['[debug]', ...args] as any)
+  }
+
   protected async start() {
     this.clientLogger.info('Maimai status monitor started.')
     // 立即执行一次
@@ -257,6 +265,8 @@ export class MaimaiStatus extends Service {
                 
                 // 直接从页面上下文获取数据
                 data = await page.evaluate(() => (window as any).preloadData)
+                const bodySnippet = await page.evaluate(() => (document?.body?.innerText || '').slice(0, 50))
+                this.logDebug(`[monitor] puppeteer body head: ${bodySnippet}`)
             } finally {
                 await page.close()
             }
@@ -272,6 +282,7 @@ export class MaimaiStatus extends Service {
                 responseType: 'text',
                 headers: { 'User-Agent': this.UA }
             })
+            this.logDebug(`[monitor] http body head: ${String(html).slice(0, 50)}`)
             const regex = /window\.preloadData\s*=\s*(\{.*?\});/s
             const match = html.match(regex)
             
@@ -286,6 +297,7 @@ export class MaimaiStatus extends Service {
 
     if (data) {
         const monitorList: MonitorItem[] = []
+        this.logDebug('[monitor] parsed preloadData keys:', Object.keys(data || {}))
         if (data.config && Array.isArray(data.publicGroupList)) {
             for (const group of data.publicGroupList) {
                 if (Array.isArray(group.monitorList)) {
@@ -293,6 +305,7 @@ export class MaimaiStatus extends Service {
                 }
             }
         }
+        this.logDebug(`[monitor] monitorList length=${monitorList.length}`)
         return monitorList
     }
     
@@ -369,6 +382,7 @@ export class MaimaiStatus extends Service {
         await page.goto(url, { waitUntil: 'networkidle0', timeout: 20000 })
         // 直接读取正文文本（可能被 JS 动态生成）
         const body = await page.evaluate(() => document.body?.innerText || document.body?.textContent || '')
+        this.logDebug(`[heartbeat] puppeteer body head: ${body.slice(0, 50)}`)
         if (!body) return null
         try {
           return JSON.parse(body)
@@ -391,6 +405,7 @@ export class MaimaiStatus extends Service {
         headers: { 'User-Agent': this.UA },
         timeout: 15000
       })
+      this.logDebug(`[heartbeat] http body head: ${typeof data === 'string' ? data.slice(0, 50) : '[object]'}`)
       
       // 如果不是对象，尝试解析 JSON (因为 Object.keys 打印出了索引，说明是字符串)
       if (typeof data === 'string') {
@@ -409,6 +424,7 @@ export class MaimaiStatus extends Service {
       }
       
       // 返回原始对象，包含 heartbeatList 和 uptimeList
+      this.logDebug('[heartbeat] parsed keys:', Array.isArray(data) ? `array length ${data.length}` : Object.keys(data || {}))
       return data || {}
     } catch (e) {
       // HTTP 失败也尝试 Puppeteer（例如超时/质询）
@@ -478,6 +494,7 @@ export class MaimaiStatus extends Service {
 
     for (const { group, currentStatus } of updates) {
       const { groupName, lastStatus, isMuted, muteUntil } = group
+      this.logDebug(`[state] ${groupName}: last=${lastStatus} current=${currentStatus}`)
 
       // 检查静音过期
       if (isMuted && now > muteUntil) {
@@ -485,18 +502,6 @@ export class MaimaiStatus extends Service {
         this.clientLogger.info(`[${groupName}] 静音结束，恢复监控通知。`)
       }
 
-      // 0. 初始化或状态无变更的处理
-      if (lastStatus === 'UNKNOWN') {
-        // 首次初始化，静默更新
-        group.lastStatus = currentStatus
-        group.consecutiveFailures = 0
-        continue
-      }
-
-      if (currentStatus === lastStatus) {
-        continue
-      }
-
       // 如果处于静音状态，只更新状态，不进行通知推送判定
       if (group.isMuted) {
         group.lastStatus = currentStatus
@@ -511,10 +516,12 @@ export class MaimaiStatus extends Service {
         // 静默更新状态，重置连续失败计数以防恢复瞬间误报
         group.consecutiveFailures = 0
         group.lastStatus = currentStatus
+        this.clientLogger.debug(`[${groupName}] 跳过通知：主服务离线，当前状态 ${currentStatus}`)
         continue
       }
 
-      // 正常的报警逻辑 (含 3 次确认)
+      // 正常的报警逻辑 (含 3 次确认)。
+      // 注意：即便状态未变化，也需要累计 consecutiveFailures，以便长时间离线也能触发阈值。
       await this.processNotificationLogic(group, currentStatus)
       
       // 更新最后状态
@@ -537,14 +544,16 @@ export class MaimaiStatus extends Service {
     
     const isAbnormal = currentStatus === 'OFFLINE' || currentStatus === 'PARTIAL_OFFLINE'
     const wasAbnormal = group.lastStatus === 'OFFLINE' || group.lastStatus === 'PARTIAL_OFFLINE'
+    const isInit = group.lastStatus === 'UNKNOWN'
 
     if (isAbnormal) {
-      // 异常计数 +1
+      // 异常计数 +1（初次发现也要记一次）
       group.consecutiveFailures++
       
       // 只有达到阈值（第3次）时才报警，且之前没有报过（或者这是一个新的连续序列）
       // 注意：如果已经是第 4, 5 次，保持当前状态不变，不再重复报
       if (group.consecutiveFailures === FAILURE_THRESHOLD) {
+        this.logDebug(`[notify] threshold reached for ${groupName}: last=${group.lastStatus} current=${currentStatus}`)
         await this.handleStatusChange(groupName, group.lastStatus, currentStatus)
       } else if (group.consecutiveFailures < FAILURE_THRESHOLD) {
         this.clientLogger.debug(`[${groupName}] 异常计数 ${group.consecutiveFailures}/${FAILURE_THRESHOLD}，暂不推送。`)
@@ -553,11 +562,17 @@ export class MaimaiStatus extends Service {
       // 当前是 ONLINE
       if (wasAbnormal && group.consecutiveFailures >= FAILURE_THRESHOLD) {
         // 之前是异常，且已经报警过了（超过阈值），现在恢复 -> 发送恢复通知
+        this.logDebug(`[notify] recovery for ${groupName}: last=${group.lastStatus} -> ONLINE`)
         await this.handleStatusChange(groupName, group.lastStatus, currentStatus)
       }
       // 重置计数
       group.consecutiveFailures = 0
     }
+
+    // 首次初始化状态也要记录，防止后续一直停留在 UNKNOWN 导致不推送
+    if (isInit && group.lastStatus === 'UNKNOWN') {
+      group.lastStatus = currentStatus
+    }
   }
 
   /**
@@ -594,6 +609,7 @@ export class MaimaiStatus extends Service {
     }
 
     if (shouldNotify) {
+      this.logDebug(`[notify] will push: ${name} ${from} -> ${to}`)
       // 防抖检测：仅在真正决定推送时记录
       const group = this.groups.get(name)
       if (group) {
@@ -627,6 +643,7 @@ export class MaimaiStatus extends Service {
             // 获取 bot 实例发送 (需要确保 context 中有 bot)
             const bot = this.ctx.bots[0]
             if (bot) {
+          this.logDebug(`[push] send to ${this.config.targetChannelId} level=${level} msgHead=${message.slice(0,50)}`)
                 await bot.sendMessage(this.config.targetChannelId, message)
             } else {
                 this.clientLogger.warn('No bot available to send notification.')
@@ -636,6 +653,7 @@ export class MaimaiStatus extends Service {
         }
     } else {
       this.clientLogger.debug('Notification skipped: targetChannelId not configured.')
+      this.logDebug(`[push] skipped push, no target. level=${level} msgHead=${message.slice(0,50)}`)
     }
 
     // 示例：您也可以在这里添加 HTTP webhook 推送