koishi-plugin-aaqqbot 0.1.0 → 0.1.1

package/lib/guard.d.ts

@@ -17,6 +17,8 @@ export interface GuardOptions {
     kickDelayMs?: number;
     /** 巡检时两个群之间的间隔。 */
     groupDelayMs?: number;
+    /** 一轮巡检跑满多久就停下，剩下的群接着巡检（测试用）。 */
+    patrolSoftBudgetMs?: number;
 }
 export interface ModeInfo {
     desired: Mode;
@@ -98,6 +100,7 @@ export declare class Guard {
     /** 包一层 try/catch：Koishi 里同步抛错会让整个进程退出（R20）。 */
     safely(what: string, task: () => unknown): void;
     start(): Promise<void>;
+    private startStep;
     private schedule;
     private patrolTick;
     private eventsTick;

package/lib/guard.js

@@ -18,7 +18,13 @@ const store_1 = require("./store");
 const texts_1 = require("./texts");
 const util_1 = require("./util");
 const MAX_CHECK = 3000;
-const PATROL_BUDGET_MS = 30 * 60_000;
+/** 一轮巡检跑满这么久，就在两个群之间停下，剩下的群马上接着巡检（不让排在后面的群一直轮不到）。 */
+const PATROL_SOFT_BUDGET_MS = 20 * 60_000;
+/** 一轮巡检的硬上限：超过就中止（防止卡死）。 */
+const PATROL_BUDGET_MS = 40 * 60_000;
+/** 名单比上一轮少了这么多，就怀疑名单不完整。 */
+const ROSTER_DROP_MIN = 5;
+const ROSTER_DROP_RATIO = 0.1;
 const FLAG_TTL_MS = 30 * 60_000;
 const APPROVED_TTL_MS = 10 * 60_000;
 const AUDIT_KEEP_MS = 180 * 86400_000;
@@ -177,28 +183,50 @@ class Guard {
         });
     }
     async start() {
-        this.paused = (await this.store.getKv('paused')) ?? false;
-        const saved = await this.store.getKv(this.groupsKey);
-        if (Array.isArray(saved) && saved.length) {
-            this.groups = saved;
-            this.groupsLoaded = true;
+        // 先读暂停状态：读不出来时按「暂停」处理（宁可不动，也不误动）
+        try {
+            this.paused = (await this.store.getKv('paused')) ?? false;
         }
-        if (!(0, util_1.parseClock)(this.config.remindTime))
-            this.logger.warn('提醒时间 %s 格式不对，应为 19:30 这样的格式', this.config.remindTime);
-        await this.checkHealth(true);
-        await this.refreshGroups();
-        if (this.paused)
-            this.notifier.push('⏸ 插件处于暂停状态：不会审批、提醒、改名片或移出任何人。发送 aaqq.resume 恢复。');
-        // 机器人已经在线（例如改配置后插件重启）时不会再收到上线事件，这里补处理一次积压的申请
-        const bot = this.pickBot();
-        if (bot && this.config.catchUpRequests)
-            await this.catchUpRequests(bot);
+        catch (error) {
+            this.paused = true;
+            this.logger.error('读取暂停状态失败，为安全起见先暂停：%s', error);
+            this.notifier.push('⚠ 启动时读取不到数据库里的暂停状态，为安全起见已暂停。检查 Koishi 的数据库插件后，发送 aaqq.resume 恢复。');
+        }
+        // 定时任务先安排好：后面任何一步出错，巡检、拉取变化、提醒都照常运行
         if (this.options.timers !== false) {
             this.schedule('patrol', 20_000, () => this.patrolTick());
             this.schedule('events', this.config.eventPollSeconds * 1000, () => this.eventsTick());
             this.schedule('groups', 3600_000, () => this.groupsTick());
             this.scheduleReminder();
         }
+        if (!(0, util_1.parseClock)(this.config.remindTime))
+            this.logger.warn('提醒时间 %s 格式不对，应为 19:30 这样的格式', this.config.remindTime);
+        await this.startStep('读取受管群列表', async () => {
+            const saved = await this.store.getKv(this.groupsKey);
+            if (Array.isArray(saved) && saved.length && !this.groupsLoaded) {
+                this.groups = saved;
+                this.groupsLoaded = true;
+            }
+        });
+        await this.startStep('健康检查', () => this.checkHealth(true));
+        await this.startStep('获取受管群列表', () => this.refreshGroups());
+        if (this.paused)
+            this.notifier.push('⏸ 插件处于暂停状态：不会审批、提醒、改名片或移出任何人。发送 aaqq.resume 恢复。');
+        // 机器人已经在线（例如改配置后插件重启）时不会再收到上线事件，这里补处理一次积压的申请
+        await this.startStep('补处理积压的入群申请', async () => {
+            const bot = this.pickBot();
+            if (bot && this.config.catchUpRequests)
+                await this.catchUpRequests(bot);
+        });
+    }
+    async startStep(what, step) {
+        try {
+            await step();
+        }
+        catch (error) {
+            if (!this.signal.aborted)
+                this.logger.warn('启动步骤「%s」出错（不影响定时任务）：%s', what, error);
+        }
     }
     schedule(name, delay, task) {
         this.timers.get(name)?.();
@@ -390,8 +418,15 @@ class Guard {
             const targets = this.groups.filter((g) => !only || only.includes(g.groupId));
             const sections = [];
             let ok = true;
+            const realStart = Date.now();
             for (const [index, g] of targets.entries()) {
                 (0, util_1.throwIfAborted)(round.signal);
+                if (index > 0 && Date.now() - realStart >= (this.options.patrolSoftBudgetMs ?? PATROL_SOFT_BUDGET_MS)) {
+                    const rest = targets.slice(index);
+                    this.requestPatrol(rest.map((x) => x.groupId));
+                    sections.push(`⏭ 这一轮时间到了，还有 ${rest.length} 个群马上接着巡检：${rest.map((x) => this.groupLabel(x.groupId)).join('、')}`);
+                    break;
+                }
                 if (index > 0)
                     await (0, util_1.sleep)(this.options.groupDelayMs ?? 5000, round.signal);
                 const section = await this.patrolGroup(bot, g, round.signal);
@@ -409,7 +444,7 @@ class Guard {
         }
         catch (error) {
             if (error instanceof util_1.AbortedError || round.signal.aborted) {
-                const why = this.paused ? '已暂停' : this.signal.aborted ? '插件已停用或配置已修改' : '超过 30 分钟时限';
+                const why = this.paused ? '已暂停' : this.signal.aborted ? '插件已停用或配置已修改' : '超过 40 分钟时限';
                 this.logger.info('巡检中止：%s', why);
                 if (!this.signal.aborted)
                     this.notifier.push(`⏹ 巡检已中止（${why}）。`);
@@ -463,9 +498,14 @@ class Guard {
             await this.store.setGroupState(g.groupId, { lastPatrolOk: false, lastPatrolNote: '机器人不在群里' });
             return { ok: false, text: `${head}\n❌ 机器人不在这个群里` };
         }
+        // 名单比上一轮明显变少：可能是 LLBot 刚启动、只返回了一部分人。
+        // 这一轮不当作完整名单交给 AA（否则 AA 会删掉不在名单里的老成员），也不据此取消任何人的跟踪。
+        const previous = state.lastRosterSize;
+        const drop = previous - members.length;
+        const suspicious = previous > 0 && drop > Math.max(ROSTER_DROP_MIN, Math.ceil(previous * ROSTER_DROP_RATIO));
         const qqs = members.map((m) => m.qq);
         const verdicts = new Map();
-        const fullRoster = qqs.length <= MAX_CHECK;
+        const fullRoster = qqs.length <= MAX_CHECK && !suspicious;
         for (const part of (0, util_1.chunk)(qqs, MAX_CHECK)) {
             const result = await this.aa.check(g.groupId, part, fullRoster, { signal, retryDelays: this.options.retryDelays });
             if (!result.ok) {
@@ -493,7 +533,7 @@ class Guard {
             held: info.held,
             bypass: this.bypassFor(state, now),
             kickApprovedBefore: state.lastConfirmAt?.getTime() ?? 0,
-            partial: false,
+            partial: suspicious,
             groupSize: members.length,
             members,
             verdicts,
@@ -510,6 +550,7 @@ class Guard {
             bypassUntil: null,
             lastNewDenies: plan.newDenies.length,
             lastKicksDue: plan.kicksDue,
+            lastRosterSize: members.length,
         };
         if (plan.tripped) {
             patch.holdSince = new Date(now);
@@ -520,8 +561,12 @@ class Guard {
         patch.lastPatrolNote = `成员 ${members.length}，不合格 ${plan.counts.deny}`;
         await this.store.setGroupState(g.groupId, patch);
         const lines = [head, ...this.describePlan(plan, applied, members, info)];
-        if (!fullRoster)
+        if (suspicious) {
+            lines.push(`⚠ 这次取到的名单比上一轮少了 ${drop} 人（${previous} → ${members.length}），可能不完整：本轮不作为完整名单交给 AA，也不取消任何人的跟踪。如果确实有很多人退群，下一轮会恢复正常`);
+        }
+        else if (!fullRoster) {
             lines.push(`⚠ 群人数超过 ${MAX_CHECK}，名单分批提交，AA 上「老成员免验证」对这个群不生效`);
+        }
         if (plan.tripped) {
             this.notifier.push(`⛔ 熔断：${label} ${plan.tripReason}。\n可能是 AA 配置被改错了。这个群已停止一切处置（不提醒、不改名片、不移出、不拒绝申请），直到管理员确认。\n请先核对 AA 上的设置和下面的名单，确认无误后发送：aaqq.confirm ${g.groupId}`);
         }
@@ -551,7 +596,7 @@ class Guard {
             held: false,
             bypass: null,
             kickApprovedBefore: 0,
-            partial: false,
+            partial: true, // 只撤掉还在群里的人的标记；名单万一不完整，也不会误删别人的记录
             groupSize: members.length,
             members,
             verdicts: new Map(),

package/lib/platform.d.ts

@@ -21,6 +21,10 @@ export declare class Platform {
         bot: Bot | null;
         problem: string | null;
     };
+    /**
+     * 取群成员名单，强制 LLBot 从 QQ 服务器刷新（no_cache）。
+     * adapter-onebot 的 getGroupMemberList 会丢掉 no_cache 参数（交接文档 03 #15），所以直接调用底层接口。
+     */
     listMembers(bot: Bot, groupId: string): Promise<Member[]>;
     /** 实时查询一个成员（不走缓存）。查不到或出错时返回 null。 */
     getMember(bot: Bot, groupId: string, qq: string): Promise<Member | null>;

package/lib/platform.js

@@ -42,8 +42,19 @@ class Platform {
             return { bot: null, problem: `机器人 ${bot.selfId} 与 LLBot 的连接已断开` };
         return { bot, problem: null };
     }
+    /**
+     * 取群成员名单，强制 LLBot 从 QQ 服务器刷新（no_cache）。
+     * adapter-onebot 的 getGroupMemberList 会丢掉 no_cache 参数（交接文档 03 #15），所以直接调用底层接口。
+     */
     async listMembers(bot, groupId) {
-        const list = await bot.internal.getGroupMemberList(groupId);
+        const id = Number(groupId);
+        const response = await bot.internal._request('get_group_member_list', {
+            group_id: Math.abs(id) < 4294967296 ? id : groupId,
+            no_cache: true,
+        });
+        if (!response || response.retcode !== 0)
+            throw new Error(`取群成员名单失败（retcode ${response?.retcode}）`);
+        const list = response.data;
         if (!Array.isArray(list))
             throw new Error('群成员列表格式不对');
         const members = [];

package/lib/store.d.ts

@@ -29,6 +29,8 @@ export interface GroupState {
     /** 最近一轮巡检的「新发现不合格」和「到期要移出」人数（确认时用作豁免上限）。 */
     lastNewDenies: number;
     lastKicksDue: number;
+    /** 上一轮巡检取到的群人数（用来发现「名单突然变少」）。 */
+    lastRosterSize: number;
     lastPatrolAt: Date | null;
     lastPatrolOk: boolean;
     lastPatrolNote: string;

package/lib/store.js

@@ -28,6 +28,7 @@ function extendModels(ctx) {
         bypassMaxKicks: 'unsigned',
         lastNewDenies: 'unsigned',
         lastKicksDue: 'unsigned',
+        lastRosterSize: 'unsigned',
         lastPatrolAt: { type: 'timestamp', nullable: true },
         lastPatrolOk: 'boolean',
         lastPatrolNote: 'text',
@@ -60,6 +61,7 @@ function defaultGroupState(groupId) {
         bypassMaxKicks: 0,
         lastNewDenies: 0,
         lastKicksDue: 0,
+        lastRosterSize: 0,
         lastPatrolAt: null,
         lastPatrolOk: false,
         lastPatrolNote: '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-aaqqbot",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "配合 AllianceAuth 插件 aa-qqbot，用 QQ 机器人管理联盟 QQ 群成员：审批入群、定时巡检、提醒与移出、同步群名片",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",