koishi-plugin-group-control 1.0.5 → 1.1.0-alpha.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-group-control",
   "description": "Koishi 插件，一个多功能的群聊自管理工具。支持被踢出自动拉黑、刷屏自动屏蔽、开关控制等功能。(仅支持 OneBot 适配器)",
-  "version": "1.0.5",
+  "version": "1.1.0-alpha.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -4,7 +4,7 @@
 
 Koishi 插件，多功能群聊自管理工具。仅支持 OneBot 适配器。
 
-> 使用 Qwen3-Coder & Gemini-3.1-Pro-Preview & Claude Sonnet/Opus 4.6 协助完成
+> 使用 AI Agent 协助完成
 
 ---
 
@@ -189,9 +189,9 @@ Koishi 插件，多功能群聊自管理工具。仅支持 OneBot 适配器。
 | `gc.approve <群号>` | 同意加入指定群 |
 | `gc.reject <群号>` | 拒绝加入指定群 |
 | `gc.pending` | 查看待处理的群聊邀请列表 |
-| `gc.fa <QQ号>` | 同意好友申请 |
-| `gc.fr <QQ号>` | 拒绝好友申请 |
-| `gc.fp` | 查看待处理的好友申请列表 |
+| `gc.friend-approve <QQ号>` | 同意好友申请（兼容别名：`gc.fa`） |
+| `gc.friend-reject <QQ号>` | 拒绝好友申请（兼容别名：`gc.fr`） |
+| `gc.friend-pending` | 查看待处理的好友申请列表（兼容别名：`gc.fp`） |
 
 ### 群聊管理
 

package/lib/config.d.ts

@@ -1,88 +0,0 @@
-import { Schema } from 'koishi';
-export interface GroupConfig {
-    welcomeMessage: string;
-    quitMessage: string;
-    quitCommandEnabled: boolean;
-    enableBlacklist: boolean;
-    blacklistMessage: string;
-    notifyAdminOnKick: boolean;
-    kickNotificationMessage: string;
-    smallGroupAutoQuit: boolean;
-    smallGroupThreshold: number;
-    smallGroupQuitMessage: string;
-    smallGroupNotifyAdmin: boolean;
-    smallGroupCheckDelay: number;
-    smallGroupExcludeOfficialBots: boolean;
-    smallGroupRealtimeMonitor: boolean;
-    smallGroupRecheckCooldown: number;
-    smallGroupQualifiedNotifyAdmin: boolean;
-    smallGroupQualifiedMessage: string;
-    notifyAdminOnMute: boolean;
-    muteNotificationMessage: string;
-    muteAutoQuit: boolean;
-    muteAutoQuitThreshold: number;
-    muteQuitNotificationMessage: string;
-}
-export interface AdminConfig {
-    adminQQs: string[];
-    notificationGroupId: string;
-}
-export interface GroupInviteConfig {
-    enabled: boolean;
-    inviteWaitMessage: string;
-    inviteRequestMessage: string;
-    autoApprove: boolean;
-    notifyAdminOnApprove: boolean;
-    inviteApproveMessage: string;
-    inviteApproveNotificationMessage: string;
-    showDetailedLog: boolean;
-    inviteExpireDays: number;
-}
-export interface FrequencyConfig {
-    enabled: boolean;
-    limit: number;
-    window: number;
-    warnDelay: number;
-    blockDur: number;
-    whitelist: string[];
-    privateEnabled: boolean;
-    privateLimit: number;
-    privateWindow: number;
-    privateWarnDelay: number;
-    privateBlockDur: number;
-    privateWhitelist: string[];
-    blockExpBase: number;
-    blockExpWindow: number;
-    blockNotifyCooldown: number;
-    warnMsg: string;
-    blockMsg: string;
-    blockedMsg: string;
-}
-export interface FriendConfig {
-    enabled: boolean;
-    autoApprove: boolean;
-    notifyAdminOnApprove: boolean;
-    requestExpireDays: number;
-    requestMessage: string;
-    approveNotificationMessage: string;
-}
-export interface BotSwitchConfig {
-    enabled: boolean;
-    defaultState: boolean;
-    disabledMessage: string;
-}
-export interface PermissionConfig {
-    mode: 'koishi' | 'builtin';
-    koishiAuthority: number;
-    protectedCommands: string[];
-}
-export interface Config {
-    admin: AdminConfig;
-    permission: PermissionConfig;
-    basic: GroupConfig;
-    invite: GroupInviteConfig;
-    friend: FriendConfig;
-    frequency: FrequencyConfig;
-    botSwitch: BotSwitchConfig;
-}
-export declare const Config: Schema<Config>;

package/lib/database.d.ts

@@ -1,105 +0,0 @@
-import { Context } from 'koishi';
-export interface BlacklistedGuild {
-    platform: string;
-    guildId: string;
-    timestamp: number;
-    reason: string;
-}
-export interface CommandFrequencyRecord {
-    platform: string;
-    guildId: string;
-    commandCount: number;
-    lastCommandTime: number;
-    warningSent: boolean;
-    blockExpiryTime: number;
-    firstWarningTime: number;
-    blockCount: number;
-    lastBlockNotifyTime: number;
-}
-export interface GroupBotStatus {
-    platform: string;
-    guildId: string;
-    botEnabled: boolean;
-}
-export interface SmallGroupWhitelist {
-    platform: string;
-    guildId: string;
-}
-export interface ApprovedGuild {
-    platform: string;
-    guildId: string;
-    timestamp: number;
-}
-export interface SelfLeftGuild {
-    platform: string;
-    guildId: string;
-    timestamp: number;
-}
-export interface PendingInvite {
-    platform: string;
-    groupId: string;
-    userId: string;
-    userName: string;
-    groupName: string;
-    time: number;
-    flag: string;
-}
-export interface PendingFriendRequest {
-    platform: string;
-    userId: string;
-    nickname: string;
-    comment: string;
-    flag: string;
-    time: number;
-}
-declare module 'koishi' {
-    interface Tables {
-        blacklisted_guild: BlacklistedGuild;
-        command_frequency_record: CommandFrequencyRecord;
-        group_bot_status: GroupBotStatus;
-        small_group_whitelist: SmallGroupWhitelist;
-        self_left_guild: SelfLeftGuild;
-        approved_guild: ApprovedGuild;
-        pending_invite: PendingInvite;
-        pending_friend_request: PendingFriendRequest;
-    }
-}
-export declare const name = "group-control-database";
-export declare function apply(ctx: Context): void;
-export declare const BLACKLIST_PLATFORM = "onebot";
-export declare function getBlacklistedGuild(ctx: Context, guildId: string): Promise<BlacklistedGuild[]>;
-export declare function removeBlacklistedGuild(ctx: Context, guildId: string): Promise<import("minato").Driver.WriteResult>;
-export declare function createBlacklistedGuild(ctx: Context, guildId: string, reason: string): Promise<import("minato").Driver.WriteResult>;
-export declare function getAllBlacklistedGuilds(ctx: Context): Promise<BlacklistedGuild[]>;
-export declare function clearBlacklistedGuilds(ctx: Context): Promise<import("minato").Driver.WriteResult>;
-/** 统一写入被踢黑名单行，保证 platform = BLACKLIST_PLATFORM */
-export declare function blacklistKicked(ctx: Context, guildId: string): Promise<import("minato").Driver.WriteResult>;
-/** 在主动退群前写入标记，让 guild-removed 能区分「自己退的」和「被踢的」*/
-export declare function markSelfLeft(ctx: Context, guildId: string): Promise<void>;
-/** 消费标记（单次读取后删除），返回是否在 maxAgeSec 内。用于 guild-removed 判断是自己退的 */
-export declare function consumeSelfLeft(ctx: Context, guildId: string, maxAgeSec?: number): Promise<boolean>;
-/** 清理标记（退群失败时回滚，或 unban 时清理）*/
-export declare function clearSelfLeft(ctx: Context, guildId: string): Promise<void>;
-/** 定期清理过期的主动退群标记（超过 maxAgeSec 秒未消费的）*/
-export declare function clearExpiredSelfLeft(ctx: Context, maxAgeSec?: number): Promise<void>;
-export declare function getCommandFrequencyRecord(ctx: Context, platform: string, guildId: string): Promise<CommandFrequencyRecord>;
-export declare function updateCommandFrequencyRecord(ctx: Context, platform: string, guildId: string, data: Partial<CommandFrequencyRecord>): Promise<void>;
-export declare function getGroupBotStatus(ctx: Context, platform: string, guildId: string): Promise<GroupBotStatus | null>;
-export declare function setGroupBotStatus(ctx: Context, platform: string, guildId: string, botEnabled: boolean): Promise<void>;
-export declare function isInSmallGroupWhitelist(ctx: Context, guildId: string): Promise<boolean>;
-export declare function addToSmallGroupWhitelist(ctx: Context, guildId: string): Promise<void>;
-export declare function removeFromSmallGroupWhitelist(ctx: Context, guildId: string): Promise<void>;
-export declare function getAllSmallGroupWhitelist(ctx: Context): Promise<SmallGroupWhitelist[]>;
-export declare function markApprovedGuild(ctx: Context, guildId: string): Promise<void>;
-export declare function isApprovedGuild(ctx: Context, guildId: string): Promise<boolean>;
-export declare function clearApprovedGuild(ctx: Context, guildId: string): Promise<void>;
-export declare function getPendingInvite(ctx: Context, groupId: string): Promise<PendingInvite>;
-export declare function addPendingInvite(ctx: Context, inviteUser: Omit<PendingInvite, 'platform'>): Promise<void>;
-export declare function removePendingInvite(ctx: Context, groupId: string): Promise<void>;
-export declare function getAllPendingInvites(ctx: Context): Promise<PendingInvite[]>;
-export declare function clearExpiredPendingInvites(ctx: Context, expireTimeMs: number): Promise<void>;
-export declare function getPendingFriendRequest(ctx: Context, platform: string, userId: string): Promise<PendingFriendRequest>;
-export declare function addPendingFriendRequest(ctx: Context, platform: string, data: Omit<PendingFriendRequest, 'platform'>): Promise<void>;
-export declare function removePendingFriendRequest(ctx: Context, platform: string, userId: string): Promise<void>;
-export declare function getAllPendingFriendRequests(ctx: Context, platform: string): Promise<PendingFriendRequest[]>;
-export declare function clearExpiredPendingFriendRequests(ctx: Context, platform: string, expireTimeMs: number): Promise<void>;

package/lib/index.d.ts

@@ -1,6 +0,0 @@
-import { Context } from 'koishi';
-import { Config } from './config';
-export * from './config';
-export declare const name = "group-control";
-export declare const inject: string[];
-export declare function apply(ctx: Context, config: Config): void;