koishi-plugin-maichuni-scorehelper 0.0.16-test → 0.0.18-test

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

@@ -5,6 +5,9 @@ export interface Config {
     targetChannelId?: string;
     showRecovery: boolean;
     mainServiceName: string;
+    statusPageUrl: string;
+    heartbeatApiUrl: string;
+    debug?: boolean;
 }
 export declare const Config: Schema<Config>;
 declare module 'koishi' {
@@ -18,11 +21,10 @@ export declare class MaimaiStatus extends Service {
     private clientLogger;
     private timer;
     private groups;
-    private readonly PAGE_URL;
-    private readonly API_URL;
     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

@@ -7,12 +7,17 @@ exports.MaimaiStatus = exports.Config = exports.name = void 0;
 const koishi_1 = require("koishi");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
+const DEFAULT_STATUS_PAGE_URL = 'https://maimaistatusreverseproxy.muxyang.com/status/maimai';
+const DEFAULT_HEARTBEAT_API_URL = 'https://maimaistatusreverseproxy.muxyang.com/api/status-page/heartbeat/maimai';
 exports.name = 'maimai-status-monitor';
 exports.Config = koishi_1.Schema.object({
     interval: koishi_1.Schema.number().default(60000).description('轮询间隔 (毫秒)，建议不低于 30000'),
     targetChannelId: koishi_1.Schema.string().description('推送通知的目标群组/频道 ID (可选，留空则仅在控制台输出)'),
     showRecovery: koishi_1.Schema.boolean().default(true).description('是否在服务恢复时也发送通知'),
-    mainServiceName: koishi_1.Schema.string().default('舞萌DX服务').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，默认使用内置反代，可自定义'),
+    debug: koishi_1.Schema.boolean().default(false).description('开启后输出详细调试日志')
 });
 // 常量配置
 const FLAP_WINDOW = 10 * 60 * 1000; // 10分钟
@@ -27,12 +32,16 @@ class MaimaiStatus extends koishi_1.Service {
         // 内存中保存的分组状态映射： GroupName -> GroupData
         this.groups = new Map();
         // API 地址常量（已切换到反向代理域名以绕过 CC）
-        this.PAGE_URL = 'https://maimaistatusreverseproxy.muxyang.com/status/maimai';
-        this.API_URL = 'https://maimaistatusreverseproxy.muxyang.com/api/status-page/heartbeat/maimai';
         this.CACHE_FILE = path_1.default.join(__dirname, '../../monitor_cache.json');
         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;
+        // 使用 apply 规避编译器对可变参数展开的限制
+        this.clientLogger.debug.apply(this.clientLogger, args);
+    }
     async start() {
         this.clientLogger.info('Maimai status monitor started.');
         // 立即执行一次
@@ -192,7 +201,7 @@ class MaimaiStatus extends koishi_1.Service {
                 const page = await this.ctx.puppeteer.page();
                 try {
                     // 设置超时，防止卡死
-                    await page.goto(this.PAGE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 });
+                    await page.goto(this.config.statusPageUrl || DEFAULT_STATUS_PAGE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 });
                     // 等待可能的 JS 跳转 (CC Protect)
                     try {
                         await page.waitForNavigation({ waitUntil: 'networkidle0', timeout: 5000 });
@@ -200,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();
@@ -212,10 +223,11 @@ class MaimaiStatus extends koishi_1.Service {
         // 如果 Puppeteer 失败或未启用，回退到 HTTP (可能无法通过 CC 验证)
         if (!data) {
             try {
-                const html = await this.ctx.http.get(this.PAGE_URL, {
+                const html = await this.ctx.http.get(this.config.statusPageUrl || DEFAULT_STATUS_PAGE_URL, {
                     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]) {
@@ -229,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)) {
@@ -236,6 +249,7 @@ class MaimaiStatus extends koishi_1.Service {
                     }
                 }
             }
+            this.logDebug(`[monitor] monitorList length=${monitorList.length}`);
             return monitorList;
         }
         return [];
@@ -292,8 +306,50 @@ class MaimaiStatus extends koishi_1.Service {
      * 步骤3: 获取 API JSON 数据
      */
     async fetchHeartbeats() {
+        const url = this.config.heartbeatApiUrl || DEFAULT_HEARTBEAT_API_URL;
+        // 使用 Puppeteer 绕过可能的 JS 质询 / CC 防护
+        const fetchViaPuppeteer = async () => {
+            if (!this.ctx.puppeteer)
+                return null;
+            let page = null;
+            try {
+                page = await this.ctx.puppeteer.page();
+                if (page.setUserAgent) {
+                    await page.setUserAgent(this.UA);
+                }
+                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);
+                }
+                catch (err2) {
+                    this.clientLogger.warn(`Puppeteer heartbeat parse failed: ${err2.message}; body=${body.slice(0, 200)}`);
+                    return null;
+                }
+            }
+            catch (pe) {
+                this.clientLogger.warn(`Puppeteer heartbeat fetch failed: ${pe.message}`);
+                return null;
+            }
+            finally {
+                if (page) {
+                    try {
+                        await page.close();
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+        };
         try {
-            let data = await this.ctx.http.get(this.API_URL);
+            let data = await this.ctx.http.get(url, {
+                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 {
@@ -303,48 +359,24 @@ class MaimaiStatus extends koishi_1.Service {
                     const snippet = data.slice(0, 200);
                     this.clientLogger.warn(`Heartbeat JSON parse failed: ${err.message}; snippet=${snippet}`);
                     // 如果返回的是 CC HTML，尝试使用 Puppeteer 绕过
-                    if (this.ctx.puppeteer && snippet.includes('<!DOCTYPE')) {
-                        let page = null;
-                        try {
-                            page = await this.ctx.puppeteer.page();
-                            if (page.setUserAgent) {
-                                await page.setUserAgent(this.UA);
-                            }
-                            await page.goto(this.API_URL, { waitUntil: 'networkidle0', timeout: 15000 });
-                            const body = await page.evaluate(() => {
-                                const text = document.body?.innerText || document.body?.textContent || '';
-                                return text;
-                            });
-                            try {
-                                data = JSON.parse(body);
-                            }
-                            catch (err2) {
-                                this.clientLogger.warn(`Puppeteer heartbeat parse failed: ${err2.message}; body=${body.slice(0, 200)}`);
-                                return null;
-                            }
-                        }
-                        catch (pe) {
-                            this.clientLogger.warn(`Puppeteer heartbeat fetch failed: ${pe.message}`);
-                            return null;
-                        }
-                        finally {
-                            if (page) {
-                                try {
-                                    await page.close();
-                                }
-                                catch { /* ignore */ }
-                            }
-                        }
-                    }
-                    else {
-                        return null;
+                    if (snippet.includes('<!DOCTYPE')) {
+                        const viaPuppeteer = await fetchViaPuppeteer();
+                        if (viaPuppeteer)
+                            return viaPuppeteer;
                     }
+                    return null;
                 }
             }
             // 返回原始对象，包含 heartbeatList 和 uptimeList
+            this.logDebug('[heartbeat] parsed keys:', Array.isArray(data) ? `array length ${data.length}` : Object.keys(data || {}));
             return data || {};
         }
         catch (e) {
+            // HTTP 失败也尝试 Puppeteer（例如超时/质询）
+            this.clientLogger.warn(`HTTP heartbeat fetch failed, trying Puppeteer. reason=${e?.message || e}`);
+            const viaPuppeteer = await fetchViaPuppeteer();
+            if (viaPuppeteer)
+                return viaPuppeteer;
             this.clientLogger.error('Failed to fetch heartbeat JSON', e);
             return null;
         }
@@ -400,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;
@@ -427,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;
@@ -447,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) {
@@ -463,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;
+        }
     }
     /**
      * 状态变更处理接口
@@ -502,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) {
@@ -532,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 {
@@ -542,6 +576,10 @@ class MaimaiStatus extends koishi_1.Service {
                 this.clientLogger.error('Failed to send notification:', e);
             }
         }
+        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,7 +1,7 @@
 {
   "name": "koishi-plugin-maichuni-scorehelper",
-  "version": "0.0.16-test",
-  "description": "【未完成】用于舞萌中二节奏分数辅助。",
+  "version": "0.0.18-test",
+  "description": "【未完成】一些舞萌中二节奏功能",
   "keywords": [
     "koishi",
     "plugin",

package/src/services/maimai-status.ts

@@ -2,6 +2,9 @@ import { Context, Schema, Logger, Service } from 'koishi'
 import fs from 'fs/promises'
 import path from 'path'
 
+const DEFAULT_STATUS_PAGE_URL = 'https://maimaistatusreverseproxy.muxyang.com/status/maimai'
+const DEFAULT_HEARTBEAT_API_URL = 'https://maimaistatusreverseproxy.muxyang.com/api/status-page/heartbeat/maimai'
+
 export const name = 'maimai-status-monitor'
 
 export interface Config {
@@ -9,13 +12,19 @@ export interface Config {
   targetChannelId?: string
   showRecovery: boolean
   mainServiceName: string
+  statusPageUrl: string
+  heartbeatApiUrl: string
+  debug?: boolean
 }
 
 export const Config: Schema<Config> = Schema.object({
   interval: Schema.number().default(60000).description('轮询间隔 (毫秒)，建议不低于 30000'),
   targetChannelId: Schema.string().description('推送通知的目标群组/频道 ID (可选，留空则仅在控制台输出)'),
   showRecovery: Schema.boolean().default(true).description('是否在服务恢复时也发送通知'),
-  mainServiceName: Schema.string().default('舞萌DX服务').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，默认使用内置反代，可自定义'),
+  debug: Schema.boolean().default(false).description('开启后输出详细调试日志')
 })
 
 // 定义服务状态枚举
@@ -61,8 +70,6 @@ export class MaimaiStatus extends Service {
   private groups: Map<string, ServiceGroup> = new Map()
 
   // API 地址常量（已切换到反向代理域名以绕过 CC）
-  private readonly PAGE_URL = 'https://maimaistatusreverseproxy.muxyang.com/status/maimai'
-  private readonly API_URL = 'https://maimaistatusreverseproxy.muxyang.com/api/status-page/heartbeat/maimai'
   private readonly CACHE_FILE = path.join(__dirname, '../../monitor_cache.json')
   private readonly UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
 
@@ -71,6 +78,12 @@ export class MaimaiStatus extends Service {
     this.clientLogger = ctx.logger('maimai-status')
   }
 
+  private logDebug(...args: any[]) {
+    if (!this.config.debug) return
+    // 使用 apply 规避编译器对可变参数展开的限制
+    this.clientLogger.debug.apply(this.clientLogger, args as any)
+  }
+
   protected async start() {
     this.clientLogger.info('Maimai status monitor started.')
     // 立即执行一次
@@ -244,7 +257,7 @@ export class MaimaiStatus extends Service {
             const page = await this.ctx.puppeteer.page()
             try {
                 // 设置超时，防止卡死
-                await page.goto(this.PAGE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 })
+                await page.goto(this.config.statusPageUrl || DEFAULT_STATUS_PAGE_URL, { waitUntil: 'domcontentloaded', timeout: 15000 })
                 // 等待可能的 JS 跳转 (CC Protect)
                 try {
                     await page.waitForNavigation({ waitUntil: 'networkidle0', timeout: 5000 })
@@ -252,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()
             }
@@ -263,10 +278,11 @@ export class MaimaiStatus extends Service {
     // 如果 Puppeteer 失败或未启用，回退到 HTTP (可能无法通过 CC 验证)
     if (!data) {
         try {
-            const html = await this.ctx.http.get(this.PAGE_URL, { 
+            const html = await this.ctx.http.get(this.config.statusPageUrl || DEFAULT_STATUS_PAGE_URL, { 
                 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)
             
@@ -281,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)) {
@@ -288,6 +305,7 @@ export class MaimaiStatus extends Service {
                 }
             }
         }
+        this.logDebug(`[monitor] monitorList length=${monitorList.length}`)
         return monitorList
     }
     
@@ -350,8 +368,44 @@ export class MaimaiStatus extends Service {
    * 步骤3: 获取 API JSON 数据
    */
   private async fetchHeartbeats(): Promise<any> {
+    const url = this.config.heartbeatApiUrl || DEFAULT_HEARTBEAT_API_URL
+
+    // 使用 Puppeteer 绕过可能的 JS 质询 / CC 防护
+    const fetchViaPuppeteer = async (): Promise<any | null> => {
+      if (!this.ctx.puppeteer) return null
+      let page: any = null
+      try {
+        page = await this.ctx.puppeteer.page()
+        if (page.setUserAgent) {
+          await page.setUserAgent(this.UA)
+        }
+        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)
+        } catch (err2) {
+          this.clientLogger.warn(`Puppeteer heartbeat parse failed: ${(err2 as any).message}; body=${body.slice(0, 200)}`)
+          return null
+        }
+      } catch (pe) {
+        this.clientLogger.warn(`Puppeteer heartbeat fetch failed: ${(pe as any).message}`)
+        return null
+      } finally {
+        if (page) {
+          try { await page.close() } catch { /* ignore */ }
+        }
+      }
+    }
+
     try {
-      let data = await this.ctx.http.get(this.API_URL)
+      let data = await this.ctx.http.get(url, {
+        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') {
@@ -361,41 +415,23 @@ export class MaimaiStatus extends Service {
           const snippet = data.slice(0, 200)
           this.clientLogger.warn(`Heartbeat JSON parse failed: ${(err as any).message}; snippet=${snippet}`)
             // 如果返回的是 CC HTML，尝试使用 Puppeteer 绕过
-            if (this.ctx.puppeteer && snippet.includes('<!DOCTYPE')) {
-              let page: any = null
-              try {
-                page = await this.ctx.puppeteer.page()
-                if (page.setUserAgent) {
-                  await page.setUserAgent(this.UA)
-                }
-                await page.goto(this.API_URL, { waitUntil: 'networkidle0', timeout: 15000 })
-                const body = await page.evaluate(() => {
-                  const text = document.body?.innerText || document.body?.textContent || ''
-                  return text
-                })
-                try {
-                  data = JSON.parse(body)
-                } catch (err2) {
-                  this.clientLogger.warn(`Puppeteer heartbeat parse failed: ${(err2 as any).message}; body=${body.slice(0,200)}`)
-                  return null
-                }
-              } catch (pe) {
-                this.clientLogger.warn(`Puppeteer heartbeat fetch failed: ${(pe as any).message}`)
-                return null
-              } finally {
-                if (page) {
-                  try { await page.close() } catch { /* ignore */ }
-                }
-              }
-            } else {
-              return null
+            if (snippet.includes('<!DOCTYPE')) {
+              const viaPuppeteer = await fetchViaPuppeteer()
+              if (viaPuppeteer) return viaPuppeteer
             }
+            return null
         }
       }
       
       // 返回原始对象，包含 heartbeatList 和 uptimeList
+      this.logDebug('[heartbeat] parsed keys:', Array.isArray(data) ? `array length ${data.length}` : Object.keys(data || {}))
       return data || {}
     } catch (e) {
+      // HTTP 失败也尝试 Puppeteer（例如超时/质询）
+      this.clientLogger.warn(`HTTP heartbeat fetch failed, trying Puppeteer. reason=${(e as any)?.message || e}`)
+      const viaPuppeteer = await fetchViaPuppeteer()
+      if (viaPuppeteer) return viaPuppeteer
+
       this.clientLogger.error('Failed to fetch heartbeat JSON', e)
       return null
     }
@@ -458,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) {
@@ -465,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
@@ -491,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)
       
       // 更新最后状态
@@ -517,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}，暂不推送。`)
@@ -533,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
+    }
   }
 
   /**
@@ -574,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) {
@@ -607,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.')
@@ -614,6 +651,9 @@ export class MaimaiStatus extends Service {
         } catch (e) {
             this.clientLogger.error('Failed to send notification:', e)
         }
+    } 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 推送