koishi-plugin-aaqqbot 0.1.0

package/lib/signing.d.ts

@@ -0,0 +1,16 @@
+export declare function sha256Hex(text: string): string;
+/** 五段用单个 `\n` 连接、末尾没有换行的待签名字符串。 */
+export declare function signingString(path: string, timestamp: string, nonce: string, bodyText: string): string;
+export declare function sign(secret: string, path: string, timestamp: string, nonce: string, bodyText: string): string;
+/** 32 个十六进制字符，符合 API 要求的 16–64 位 `[A-Za-z0-9_-]`。 */
+export declare function makeNonce(): string;
+/** 当前 Unix 时间，单位秒。 */
+export declare function unixSeconds(now?: number): string;
+export interface SignedHeaders {
+    'Content-Type': string;
+    'X-QQBot-Key': string;
+    'X-QQBot-Timestamp': string;
+    'X-QQBot-Nonce': string;
+    'X-QQBot-Signature': string;
+}
+export declare function signedHeaders(keyId: string, secret: string, path: string, bodyText: string, now?: number): SignedHeaders;

package/lib/signing.js

@@ -0,0 +1,39 @@
+"use strict";
+// 请求签名，算法见 aa-qqbot 仓库 API.md 第 2 节。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256Hex = sha256Hex;
+exports.signingString = signingString;
+exports.sign = sign;
+exports.makeNonce = makeNonce;
+exports.unixSeconds = unixSeconds;
+exports.signedHeaders = signedHeaders;
+const node_crypto_1 = require("node:crypto");
+function sha256Hex(text) {
+    return (0, node_crypto_1.createHash)('sha256').update(text, 'utf8').digest('hex');
+}
+/** 五段用单个 `\n` 连接、末尾没有换行的待签名字符串。 */
+function signingString(path, timestamp, nonce, bodyText) {
+    return ['POST', path, timestamp, nonce, sha256Hex(bodyText)].join('\n');
+}
+function sign(secret, path, timestamp, nonce, bodyText) {
+    return (0, node_crypto_1.createHmac)('sha256', secret).update(signingString(path, timestamp, nonce, bodyText), 'utf8').digest('hex');
+}
+/** 32 个十六进制字符，符合 API 要求的 16–64 位 `[A-Za-z0-9_-]`。 */
+function makeNonce() {
+    return (0, node_crypto_1.randomBytes)(16).toString('hex');
+}
+/** 当前 Unix 时间，单位秒。 */
+function unixSeconds(now = Date.now()) {
+    return Math.floor(now / 1000).toString();
+}
+function signedHeaders(keyId, secret, path, bodyText, now = Date.now()) {
+    const timestamp = unixSeconds(now);
+    const nonce = makeNonce();
+    return {
+        'Content-Type': 'application/json',
+        'X-QQBot-Key': keyId,
+        'X-QQBot-Timestamp': timestamp,
+        'X-QQBot-Nonce': nonce,
+        'X-QQBot-Signature': sign(secret, path, timestamp, nonce, bodyText),
+    };
+}

package/lib/store.d.ts

@@ -0,0 +1,81 @@
+import type { Context } from 'koishi';
+import type { Mode } from './config';
+/** 被发现不合格、正在宽限期里的成员。 */
+export interface TrackedMember {
+    groupId: string;
+    qq: string;
+    reason: string;
+    firstDeniedAt: Date;
+    /** enforce 模式下的移出截止时间；remind 模式下为 null（只提醒不踢）。 */
+    graceUntil: Date | null;
+    marked: boolean;
+    lastRemindedAt: Date | null;
+}
+export interface GroupState {
+    groupId: string;
+    /** 管理员确认过的最高模式；升级到 remind / enforce 必须经过确认。 */
+    confirmedMode: string;
+    confirmedAt: Date | null;
+    confirmedBy: string;
+    /** 熔断开始的时间；不为 null 表示这个群处于熔断状态。 */
+    holdSince: Date | null;
+    holdNote: string;
+    /** 管理员最近一次 aaqq.confirm 的时间。截止时间早于它的移出视为已确认。 */
+    lastConfirmAt: Date | null;
+    /** 确认后的豁免：在这个时间之前的下一轮巡检，人数不超过下面两个数就不熔断。 */
+    bypassUntil: Date | null;
+    bypassMaxNew: number;
+    bypassMaxKicks: number;
+    /** 最近一轮巡检的「新发现不合格」和「到期要移出」人数（确认时用作豁免上限）。 */
+    lastNewDenies: number;
+    lastKicksDue: number;
+    lastPatrolAt: Date | null;
+    lastPatrolOk: boolean;
+    lastPatrolNote: string;
+}
+interface KvRow {
+    key: string;
+    value: string;
+}
+export interface AuditRow {
+    id: number;
+    at: Date;
+    action: string;
+    groupId: string;
+    qq: string;
+    detail: string;
+    actor: string;
+}
+declare module 'koishi' {
+    interface Tables {
+        aaqqbot_member: TrackedMember;
+        aaqqbot_group: GroupState;
+        aaqqbot_kv: KvRow;
+        aaqqbot_audit: AuditRow;
+    }
+}
+export declare function extendModels(ctx: Context): void;
+export declare function defaultGroupState(groupId: string): GroupState;
+export declare class Store {
+    private ctx;
+    private now;
+    constructor(ctx: Context, now?: () => number);
+    private get db();
+    tracked(groupId: string): Promise<Map<string, TrackedMember>>;
+    saveTracked(rows: TrackedMember[]): Promise<void>;
+    /** 只更新还存在的记录（不会把刚被删除的人重新写回来）。 */
+    markReminded(groupId: string, rows: Array<Pick<TrackedMember, 'qq' | 'graceUntil' | 'lastRemindedAt'>>): Promise<void>;
+    removeTracked(groupId: string, qqs: string[]): Promise<void>;
+    /** 群从 AA 上移除：宽限记录和确认状态都清掉，以后重新加回来要重新确认。 */
+    forgetGroup(groupId: string): Promise<void>;
+    groupState(groupId: string): Promise<GroupState>;
+    setGroupState(groupId: string, patch: Partial<GroupState>): Promise<void>;
+    getKv<T>(key: string): Promise<T | undefined>;
+    setKv(key: string, value: unknown): Promise<void>;
+    audit(action: string, groupId: string, qq: string, detail: string, actor?: string): Promise<void>;
+    countAudit(action: string, groupId: string, since: Date): Promise<number>;
+    recentAudit(limit: number): Promise<AuditRow[]>;
+    pruneAudit(before: Date): Promise<void>;
+}
+export declare function isMode(value: string): value is Mode;
+export {};

package/lib/store.js

@@ -0,0 +1,140 @@
+"use strict";
+// 插件自己的数据表（表名都带 aaqqbot_ 前缀）。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = void 0;
+exports.extendModels = extendModels;
+exports.defaultGroupState = defaultGroupState;
+exports.isMode = isMode;
+function extendModels(ctx) {
+    ctx.model.extend('aaqqbot_member', {
+        groupId: { type: 'string', length: 32 },
+        qq: { type: 'string', length: 32 },
+        reason: { type: 'string', length: 64 },
+        firstDeniedAt: 'timestamp',
+        graceUntil: { type: 'timestamp', nullable: true },
+        marked: 'boolean',
+        lastRemindedAt: { type: 'timestamp', nullable: true },
+    }, { primary: ['groupId', 'qq'] });
+    ctx.model.extend('aaqqbot_group', {
+        groupId: { type: 'string', length: 32 },
+        confirmedMode: { type: 'string', length: 16 },
+        confirmedAt: { type: 'timestamp', nullable: true },
+        confirmedBy: { type: 'string', length: 64 },
+        holdSince: { type: 'timestamp', nullable: true },
+        holdNote: 'text',
+        lastConfirmAt: { type: 'timestamp', nullable: true },
+        bypassUntil: { type: 'timestamp', nullable: true },
+        bypassMaxNew: 'unsigned',
+        bypassMaxKicks: 'unsigned',
+        lastNewDenies: 'unsigned',
+        lastKicksDue: 'unsigned',
+        lastPatrolAt: { type: 'timestamp', nullable: true },
+        lastPatrolOk: 'boolean',
+        lastPatrolNote: 'text',
+    }, { primary: 'groupId' });
+    ctx.model.extend('aaqqbot_kv', {
+        key: { type: 'string', length: 64 },
+        value: 'text',
+    }, { primary: 'key' });
+    ctx.model.extend('aaqqbot_audit', {
+        id: 'unsigned',
+        at: 'timestamp',
+        action: { type: 'string', length: 32 },
+        groupId: { type: 'string', length: 32 },
+        qq: { type: 'string', length: 32 },
+        detail: 'text',
+        actor: { type: 'string', length: 64 },
+    }, { primary: 'id', autoInc: true });
+}
+function defaultGroupState(groupId) {
+    return {
+        groupId,
+        confirmedMode: 'report',
+        confirmedAt: null,
+        confirmedBy: '',
+        holdSince: null,
+        holdNote: '',
+        lastConfirmAt: null,
+        bypassUntil: null,
+        bypassMaxNew: 0,
+        bypassMaxKicks: 0,
+        lastNewDenies: 0,
+        lastKicksDue: 0,
+        lastPatrolAt: null,
+        lastPatrolOk: false,
+        lastPatrolNote: '',
+    };
+}
+class Store {
+    ctx;
+    now;
+    constructor(ctx, now = Date.now) {
+        this.ctx = ctx;
+        this.now = now;
+    }
+    get db() {
+        return this.ctx.database;
+    }
+    async tracked(groupId) {
+        const rows = await this.db.get('aaqqbot_member', { groupId });
+        return new Map(rows.map((row) => [row.qq, row]));
+    }
+    async saveTracked(rows) {
+        if (rows.length)
+            await this.db.upsert('aaqqbot_member', rows);
+    }
+    /** 只更新还存在的记录（不会把刚被删除的人重新写回来）。 */
+    async markReminded(groupId, rows) {
+        for (const row of rows) {
+            await this.db.set('aaqqbot_member', { groupId, qq: row.qq }, { graceUntil: row.graceUntil, lastRemindedAt: row.lastRemindedAt });
+        }
+    }
+    async removeTracked(groupId, qqs) {
+        if (qqs.length)
+            await this.db.remove('aaqqbot_member', { groupId, qq: qqs });
+    }
+    /** 群从 AA 上移除：宽限记录和确认状态都清掉，以后重新加回来要重新确认。 */
+    async forgetGroup(groupId) {
+        await this.db.remove('aaqqbot_member', { groupId });
+        await this.db.remove('aaqqbot_group', { groupId });
+    }
+    async groupState(groupId) {
+        const [row] = await this.db.get('aaqqbot_group', { groupId });
+        return row ?? defaultGroupState(groupId);
+    }
+    async setGroupState(groupId, patch) {
+        const current = await this.groupState(groupId);
+        await this.db.upsert('aaqqbot_group', [{ ...current, ...patch, groupId }]);
+    }
+    async getKv(key) {
+        const [row] = await this.db.get('aaqqbot_kv', { key });
+        if (!row)
+            return undefined;
+        try {
+            return JSON.parse(row.value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async setKv(key, value) {
+        await this.db.upsert('aaqqbot_kv', [{ key, value: JSON.stringify(value) }]);
+    }
+    async audit(action, groupId, qq, detail, actor = 'bot') {
+        await this.db.create('aaqqbot_audit', { at: new Date(this.now()), action, groupId, qq, detail, actor });
+    }
+    async countAudit(action, groupId, since) {
+        const rows = await this.db.get('aaqqbot_audit', { action, groupId, at: { $gte: since } }, ['id']);
+        return rows.length;
+    }
+    async recentAudit(limit) {
+        return this.db.select('aaqqbot_audit').orderBy('id', 'desc').limit(limit).execute();
+    }
+    async pruneAudit(before) {
+        await this.db.remove('aaqqbot_audit', { at: { $lt: before } });
+    }
+}
+exports.Store = Store;
+function isMode(value) {
+    return value === 'off' || value === 'report' || value === 'remind' || value === 'enforce';
+}

package/lib/texts.d.ts

@@ -0,0 +1,4 @@
+export declare function reasonShort(reason: string): string;
+export declare function rejectHint(outcome: string | undefined, reason: string): string;
+export declare const MODE_TEXT: Record<string, string>;
+export declare function errorHint(error: string | undefined, status: number | undefined, location?: string | null): string;

package/lib/texts.js

@@ -0,0 +1,90 @@
+"use strict";
+// 给人看的中文说明：判定原因、验证码结果、AA 接口错误。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODE_TEXT = void 0;
+exports.reasonShort = reasonShort;
+exports.rejectHint = rejectHint;
+exports.errorHint = errorHint;
+/** 群里 @ 提醒、运维报告里用的简短原因。 */
+const REASON_SHORT = {
+    OK: '合格',
+    NOT_BOUND: '没有在 AA 绑定 QQ',
+    PENDING_VERIFY: '已在 AA 提交但还没验证',
+    USER_INACTIVE: 'AA 账号已停用',
+    NO_MAIN: 'AA 账号没有主角色',
+    NO_ACCESS: 'AA 账号没有成员资格',
+    GROUP_ROLE_MISSING: '不在本群要求的 AA 组里',
+    CONFLICT: '同一个 QQ 被两个 AA 账号认领',
+    GROUP_MISCONFIGURED: 'AA 上这个群的设置不完整',
+    BAD_QQ: 'QQ 号格式不对',
+};
+function reasonShort(reason) {
+    return REASON_SHORT[reason] ?? `不满足条件（${reason}）`;
+}
+/** 拒绝入群申请时给申请人看的说明（按验证码结果优先，其次按判定原因）。 */
+const OUTCOME_HINT = {
+    code_invalid: '验证码不对，请核对 AA 上显示的验证码后重新申请',
+    code_expired: '验证码已过期，请在 AA 上重新生成验证码后重新申请',
+    code_used: '验证码已经用过，请在 AA 上重新生成验证码后重新申请',
+    qq_mismatch: '这个验证码不是给这个 QQ 的，请确认 AA 上填写的 QQ 号正确，重新生成验证码后再申请',
+};
+const REASON_HINT = {
+    NOT_BOUND: '请先登录联盟 AA 绑定 QQ，再把验证码填进入群申请的验证信息',
+    PENDING_VERIFY: '请把 AA 上显示的验证码填进入群申请的验证信息',
+    USER_INACTIVE: '你的 AA 账号已停用，请联系管理员',
+    NO_MAIN: '请先在 AA 设置主角色',
+    NO_ACCESS: '你的 AA 账号暂时没有成员资格，请联系管理员',
+    GROUP_ROLE_MISSING: '你不在本群要求的 AA 组里，请联系管理员',
+};
+function rejectHint(outcome, reason) {
+    if (outcome && OUTCOME_HINT[outcome])
+        return OUTCOME_HINT[outcome];
+    return REASON_HINT[reason] ?? '你暂时不满足入群条件，请联系管理员';
+}
+exports.MODE_TEXT = {
+    off: 'off（不管）',
+    report: 'report（只报告）',
+    remind: 'remind（提醒，不踢）',
+    enforce: 'enforce（提醒并移出）',
+};
+/** AA 错误码 → 怎么修（给运维看）。见 API.md 第 6 节。 */
+const ERROR_HINT = {
+    bad_request: '请求内容不对，多半是插件的问题，请把日志发给插件维护者',
+    missing_headers: '签名请求头缺失或格式不对；检查插件配置里的「密钥编号」，不能有空格或中文',
+    unknown_key: '密钥编号在 AA 上不存在；插件配置里的「密钥编号」要和 AA 的 QQBOT_API_KEYS 一致',
+    stale_timestamp: '机器人电脑和 AA 服务器的时间相差太大；请打开机器人电脑的「自动设置时间」',
+    bad_signature: '签名不对；检查插件配置里的密钥是否与 AA 上的完全一致（不能多空格）',
+    replayed_nonce: '随机数重复（一般是网络重试造成的），会自动恢复',
+    unknown_group: '这个群在 AA 上不存在或已停用，插件会重新获取群列表',
+    method_not_allowed: '请求方法不对，请把日志发给插件维护者',
+    too_large: '一次发送的内容太多',
+    rate_limited: '请求太频繁，已被 AA 限速，稍后自动继续',
+    internal_error: 'AA 内部出错，稍后自动重试；多次出现请联系 IT 查看 AA 日志',
+    misconfigured: 'AA 没有配置机器人密钥；请联系 IT 在 local.py 配置 QQBOT_API_KEYS',
+};
+function errorHint(error, status, location) {
+    if (error && ERROR_HINT[error])
+        return ERROR_HINT[error];
+    if (status === 302 || status === 303 || status === 307) {
+        if (location && /login/i.test(location)) {
+            return 'AA 把请求转到了登录页：AA 的 local.py 缺少 APPS_WITH_PUBLIC_VIEWS += ["qqbot"]，请联系 IT 追加后重启 AA';
+        }
+        return `AA 返回了重定向（HTTP ${status}）：检查插件配置里的 AA 网址（用 https://，末尾不要多写路径）`;
+    }
+    if (status === 301 || status === 308) {
+        return `AA 返回了永久重定向（HTTP ${status}）：AA 网址请用 https://`;
+    }
+    if (status === 404)
+        return 'AA 上找不到机器人接口（HTTP 404）：检查 AA 网址，或让 IT 确认 aa-qqbot 插件已安装';
+    if (status === 403)
+        return 'AA 前面的网关或防火墙拦截了请求（HTTP 403），请让 IT 放行';
+    if (status === 413)
+        return 'AA 前面的 nginx 拒绝了请求（HTTP 413），请让 IT 把 client_max_body_size 调大到至少 1 MB';
+    if (status === 502 || status === 504)
+        return `AA 正在重启或过载（HTTP ${status}），稍后自动重试`;
+    if (status && status >= 500)
+        return `AA 服务器出错（HTTP ${status}），稍后自动重试`;
+    if (status)
+        return `AA 返回了意外的结果（HTTP ${status}）`;
+    return '无法连接 AA';
+}

package/lib/util.d.ts

@@ -0,0 +1,34 @@
+/** 全角数字、字母转半角，去掉首尾空白。 */
+export declare function toHalfWidth(value: string): string;
+/**
+ * 把 QQ 号或群号统一成 5–11 位的 ASCII 数字字符串；不合法时返回 null。
+ * 接受数字（配置文件里没加引号）、全角数字和首尾空白。
+ */
+export declare function normalizeId(value: unknown): string | null;
+/** 规范化一组号码，丢掉不合法的，去重。 */
+export declare function normalizeIdList(values: readonly unknown[] | undefined): string[];
+/** 把号码打码成 `12****78`，用于日志。 */
+export declare function maskId(id: string): string;
+/** 按 UTF-8 字节数截断，不会切断多字节字符（包括 emoji）。 */
+export declare function truncateUtf8(text: string, maxBytes: number): string;
+/** 解析 `HH:mm`，不合法时返回 null。 */
+export declare function parseClock(text: string): {
+    hour: number;
+    minute: number;
+} | null;
+/** 从 `now` 起下一次到达本地时间 `hour:minute` 的时刻（毫秒时间戳）。 */
+export declare function nextClockTime(now: number, hour: number, minute: number): number;
+/** `9月27日 19:30` 这样的本地时间。 */
+export declare function formatDeadline(time: number): string;
+/** `09-25 14:00` 这样的本地时间。 */
+export declare function formatShortTime(time: number): string;
+/** 按占位符 `{name}` 填充模板；没有提供的占位符原样保留。 */
+export declare function fillTemplate(template: string, values: Record<string, string>): string;
+export declare class AbortedError extends Error {
+    constructor();
+}
+/** 等待 `ms` 毫秒；`signal` 中止时立即以 AbortedError 结束。 */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export declare function throwIfAborted(signal?: AbortSignal): void;
+export declare function chunk<T>(items: readonly T[], size: number): T[][];
+export declare function errorText(error: unknown): string;

package/lib/util.js

@@ -0,0 +1,140 @@
+"use strict";
+// 与业务无关的小工具：号码规范化、名片截断、时间计算、可中断的等待。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbortedError = void 0;
+exports.toHalfWidth = toHalfWidth;
+exports.normalizeId = normalizeId;
+exports.normalizeIdList = normalizeIdList;
+exports.maskId = maskId;
+exports.truncateUtf8 = truncateUtf8;
+exports.parseClock = parseClock;
+exports.nextClockTime = nextClockTime;
+exports.formatDeadline = formatDeadline;
+exports.formatShortTime = formatShortTime;
+exports.fillTemplate = fillTemplate;
+exports.sleep = sleep;
+exports.throwIfAborted = throwIfAborted;
+exports.chunk = chunk;
+exports.errorText = errorText;
+/** 全角数字、字母转半角，去掉首尾空白。 */
+function toHalfWidth(value) {
+    return value.replace(/[！-～]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 0xFEE0)).trim();
+}
+const QQ_PATTERN = /^[1-9]\d{4,10}$/;
+/**
+ * 把 QQ 号或群号统一成 5–11 位的 ASCII 数字字符串；不合法时返回 null。
+ * 接受数字（配置文件里没加引号）、全角数字和首尾空白。
+ */
+function normalizeId(value) {
+    if (typeof value === 'number') {
+        if (!Number.isSafeInteger(value))
+            return null;
+        value = String(value);
+    }
+    if (typeof value !== 'string')
+        return null;
+    const text = toHalfWidth(value);
+    return QQ_PATTERN.test(text) ? text : null;
+}
+/** 规范化一组号码，丢掉不合法的，去重。 */
+function normalizeIdList(values) {
+    const result = new Set();
+    for (const value of values ?? []) {
+        const id = normalizeId(value);
+        if (id)
+            result.add(id);
+    }
+    return [...result];
+}
+/** 把号码打码成 `12****78`，用于日志。 */
+function maskId(id) {
+    if (id.length <= 4)
+        return '****';
+    return `${id.slice(0, 2)}****${id.slice(-2)}`;
+}
+/** 按 UTF-8 字节数截断，不会切断多字节字符（包括 emoji）。 */
+function truncateUtf8(text, maxBytes) {
+    let bytes = 0;
+    let result = '';
+    for (const char of text) {
+        const size = Buffer.byteLength(char, 'utf8');
+        if (bytes + size > maxBytes)
+            break;
+        bytes += size;
+        result += char;
+    }
+    return result;
+}
+/** 解析 `HH:mm`，不合法时返回 null。 */
+function parseClock(text) {
+    const match = /^\s*(\d{1,2}):(\d{2})\s*$/.exec(toHalfWidth(text));
+    if (!match)
+        return null;
+    const hour = +match[1];
+    const minute = +match[2];
+    if (hour > 23 || minute > 59)
+        return null;
+    return { hour, minute };
+}
+/** 从 `now` 起下一次到达本地时间 `hour:minute` 的时刻（毫秒时间戳）。 */
+function nextClockTime(now, hour, minute) {
+    const date = new Date(now);
+    date.setHours(hour, minute, 0, 0);
+    if (date.getTime() <= now)
+        date.setDate(date.getDate() + 1);
+    return date.getTime();
+}
+/** `9月27日 19:30` 这样的本地时间。 */
+function formatDeadline(time) {
+    const date = new Date(time);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getMonth() + 1}月${date.getDate()}日 ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+/** `09-25 14:00` 这样的本地时间。 */
+function formatShortTime(time) {
+    const date = new Date(time);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+/** 按占位符 `{name}` 填充模板；没有提供的占位符原样保留。 */
+function fillTemplate(template, values) {
+    return template.replace(/\{(\w+)\}/g, (whole, key) => (key in values ? values[key] : whole));
+}
+class AbortedError extends Error {
+    constructor() {
+        super('aborted');
+        this.name = 'AbortedError';
+    }
+}
+exports.AbortedError = AbortedError;
+/** 等待 `ms` 毫秒；`signal` 中止时立即以 AbortedError 结束。 */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new AbortedError());
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new AbortedError());
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new AbortedError();
+}
+function chunk(items, size) {
+    const result = [];
+    for (let i = 0; i < items.length; i += size)
+        result.push(items.slice(i, i + size));
+    return result;
+}
+function errorText(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "koishi-plugin-aaqqbot",
+  "version": "0.1.0",
+  "description": "配合 AllianceAuth 插件 aa-qqbot，用 QQ 机器人管理联盟 QQ 群成员：审批入群、定时巡检、提醒与移出、同步群名片",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yilifaer/Koishi-AAqqbot-plugin.git"
+  },
+  "homepage": "https://github.com/yilifaer/Koishi-AAqqbot-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/yilifaer/Koishi-AAqqbot-plugin/issues"
+  },
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "qq",
+    "onebot",
+    "allianceauth",
+    "eve-online"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "peerDependencies": {
+    "koishi": "^4.18.0"
+  },
+  "koishi": {
+    "description": {
+      "zh": "配合 AllianceAuth 插件 aa-qqbot 管理联盟 QQ 群：审批入群、巡检、提醒、移出、同步群名片",
+      "en": "Guard QQ groups with AllianceAuth (aa-qqbot): join approval, patrol, reminders, removal and card sync"
+    },
+    "service": {
+      "required": [
+        "database",
+        "http"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@koishijs/plugin-database-memory": "^3.7.0",
+    "@koishijs/plugin-http": "^0.6.3",
+    "@types/node": "^22.20.4",
+    "koishi": "^4.18.11",
+    "koishi-plugin-adapter-onebot": "^6.9.4",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  }
+}