@zhin.js/core 1.0.44 → 1.0.46

package/lib/built/message-filter.d.ts

@@ -0,0 +1,175 @@
+/**
+ * MessageFilterFeature — 消息过滤引擎
+ *
+ * 设计理念：
+ *   将过滤规则视为 Feature Item，与命令 (CommandFeature)、权限 (PermissionFeature) 同构，
+ *   遵循框架的 add/remove/extensions/toJSON 范式，支持插件级 CRUD 和生命周期自动回收。
+ *
+ * 核心特性：
+ *   - 基于优先级的规则引擎（first-match-wins，类似防火墙规则）
+ *   - 多维匹配：scope / adapter / bot / channel / sender
+ *   - 支持精确匹配、通配符 `*`、正则 `/pattern/`
+ *   - 通过 Dispatcher Guardrail 集成，在消息调度第一阶段拦截
+ *   - 插件通过 `addFilterRule()` 动态注册规则，卸载时自动清理
+ */
+import { Feature, FeatureJSON } from '../feature.js';
+import type { Message, MessageType } from '../message.js';
+/** 过滤动作 */
+export type FilterAction = 'allow' | 'deny';
+/** 匹配模式：精确字符串 / 正则表达式 */
+export type FilterPattern = string | RegExp;
+/** 消息作用域 */
+export type FilterScope = MessageType;
+/**
+ * 过滤规则
+ *
+ * 每条规则描述一组匹配条件和对应的动作。
+ * 所有条件之间为 AND 关系（必须全部满足），每个条件内部的多个值为 OR 关系（满足任一即可）。
+ * 未设置的条件视为匹配所有。
+ *
+ * @example
+ * // 拒绝特定群的消息
+ * { name: 'block-spam', action: 'deny', scopes: ['group'], channels: ['123456'] }
+ *
+ * // 放行 VIP 用户（高优先级）
+ * { name: 'allow-vip', action: 'allow', priority: 100, senders: ['admin001'] }
+ *
+ * // 正则匹配：拒绝所有 test- 开头的频道
+ * { name: 'block-test', action: 'deny', scopes: ['channel'], channels: [/^test-/] }
+ */
+export interface FilterRule {
+    /** 规则名称（唯一标识） */
+    name: string;
+    /** 规则描述 */
+    description?: string;
+    /** 过滤动作：allow 放行 / deny 拦截 */
+    action: FilterAction;
+    /** 优先级，数值越大越先匹配（默认 0） */
+    priority?: number;
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /** 匹配的消息作用域，未设置则匹配所有 */
+    scopes?: FilterScope[];
+    /** 匹配的适配器名称 */
+    adapters?: FilterPattern[];
+    /** 匹配的 Bot 名称 */
+    bots?: FilterPattern[];
+    /** 匹配的频道/群/会话 ID */
+    channels?: FilterPattern[];
+    /** 匹配的发送者 ID */
+    senders?: FilterPattern[];
+}
+/** 过滤检测结果 */
+export interface FilterResult {
+    /** 是否允许处理 */
+    allowed: boolean;
+    /** 匹配到的规则名称（null 表示无规则匹配，走默认策略） */
+    matchedRule: string | null;
+    /** 结果原因 */
+    reason: string;
+}
+/** 配置文件中的规则（pattern 均为 string，正则用 /pattern/ 表示） */
+export interface FilterRuleConfig {
+    name: string;
+    description?: string;
+    action: FilterAction;
+    priority?: number;
+    enabled?: boolean;
+    scopes?: FilterScope[];
+    adapters?: string[];
+    bots?: string[];
+    channels?: string[];
+    senders?: string[];
+}
+/**
+ * 消息过滤配置
+ *
+ * ```yaml
+ * message_filter:
+ *   default_policy: allow
+ *   rules:
+ *     - name: block-spam
+ *       action: deny
+ *       scopes: [group]
+ *       channels: ['123456']
+ *     - name: vip-pass
+ *       action: allow
+ *       priority: 100
+ *       senders: ['admin001']
+ * ```
+ */
+export interface MessageFilterConfig {
+    /** 默认策略：无规则匹配时的行为（默认 'allow'） */
+    default_policy?: FilterAction;
+    /** 规则列表 */
+    rules?: FilterRuleConfig[];
+}
+export interface MessageFilterContextExtensions {
+    /** 添加过滤规则，返回 dispose 函数 */
+    addFilterRule(rule: FilterRule): () => void;
+    /** 检测消息是否应被处理 */
+    testFilter(message: Message<any>): FilterResult;
+    /** 设置默认过滤策略 */
+    setDefaultFilterPolicy(policy: FilterAction): void;
+}
+declare module '../plugin.js' {
+    namespace Plugin {
+        interface Extensions extends MessageFilterContextExtensions {
+        }
+        interface Contexts {
+            'message-filter': MessageFilterFeature;
+        }
+    }
+}
+export declare namespace FilterRules {
+    /** 创建拒绝规则 */
+    function deny(name: string, conditions: Omit<FilterRule, 'name' | 'action'>): FilterRule;
+    /** 创建放行规则 */
+    function allow(name: string, conditions: Omit<FilterRule, 'name' | 'action'>): FilterRule;
+    /**
+     * 创建黑名单规则组
+     * @returns 一条 deny 规则
+     */
+    function blacklist(scope: FilterScope, ids: string[], name?: string): FilterRule;
+    /**
+     * 创建白名单规则组
+     * @returns [allow 规则, deny-catch-all 规则]
+     */
+    function whitelist(scope: FilterScope, ids: string[], name?: string): [FilterRule, FilterRule];
+}
+export declare class MessageFilterFeature extends Feature<FilterRule> {
+    #private;
+    readonly name: "message-filter";
+    readonly icon = "Filter";
+    readonly desc = "\u6D88\u606F\u8FC7\u6EE4";
+    /** 按规则名称索引 */
+    readonly byName: Map<string, FilterRule>;
+    constructor(config?: MessageFilterConfig);
+    /** 默认策略 */
+    get defaultPolicy(): FilterAction;
+    set defaultPolicy(policy: FilterAction);
+    /** 获取按优先级排序的启用规则列表（带缓存） */
+    get sortedRules(): FilterRule[];
+    /** 按名称查询规则 */
+    getRule(name: string): FilterRule | undefined;
+    /**
+     * 检测消息是否应该被处理
+     *
+     * 遍历按优先级排序的规则列表，返回第一个匹配的规则结果。
+     * 若无规则匹配，按默认策略决定。
+     */
+    test(message: Message<any>): FilterResult;
+    /** 添加规则，维护 byName 索引 */
+    add(rule: FilterRule, pluginName: string): () => void;
+    /** 移除规则，清理 byName 索引 */
+    remove(rule: FilterRule, pluginName?: string): boolean;
+    /** 序列化为 JSON（供 Web 控制台展示） */
+    toJSON(pluginName?: string): FeatureJSON;
+    /** 插件扩展方法 */
+    get extensions(): {
+        addFilterRule(rule: FilterRule): () => void;
+        testFilter(message: Message<any>): FilterResult;
+        setDefaultFilterPolicy(policy: FilterAction): void;
+    };
+}
+//# sourceMappingURL=message-filter.d.ts.map

package/lib/built/message-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-filter.d.ts","sourceRoot":"","sources":["../../src/built/message-filter.ts"],"names":[],"mappings":"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"}

package/lib/built/message-filter.js

@@ -0,0 +1,236 @@
+/**
+ * MessageFilterFeature — 消息过滤引擎
+ *
+ * 设计理念：
+ *   将过滤规则视为 Feature Item，与命令 (CommandFeature)、权限 (PermissionFeature) 同构，
+ *   遵循框架的 add/remove/extensions/toJSON 范式，支持插件级 CRUD 和生命周期自动回收。
+ *
+ * 核心特性：
+ *   - 基于优先级的规则引擎（first-match-wins，类似防火墙规则）
+ *   - 多维匹配：scope / adapter / bot / channel / sender
+ *   - 支持精确匹配、通配符 `*`、正则 `/pattern/`
+ *   - 通过 Dispatcher Guardrail 集成，在消息调度第一阶段拦截
+ *   - 插件通过 `addFilterRule()` 动态注册规则，卸载时自动清理
+ */
+import { Feature } from '../feature.js';
+import { getPlugin } from '../plugin.js';
+// ============================================================================
+// 规则工厂
+// ============================================================================
+export var FilterRules;
+(function (FilterRules) {
+    /** 创建拒绝规则 */
+    function deny(name, conditions) {
+        return { ...conditions, name, action: 'deny' };
+    }
+    FilterRules.deny = deny;
+    /** 创建放行规则 */
+    function allow(name, conditions) {
+        return { ...conditions, name, action: 'allow' };
+    }
+    FilterRules.allow = allow;
+    /**
+     * 创建黑名单规则组
+     * @returns 一条 deny 规则
+     */
+    function blacklist(scope, ids, name) {
+        return {
+            name: name ?? `${scope}-blacklist`,
+            action: 'deny',
+            scopes: [scope],
+            channels: ids,
+        };
+    }
+    FilterRules.blacklist = blacklist;
+    /**
+     * 创建白名单规则组
+     * @returns [allow 规则, deny-catch-all 规则]
+     */
+    function whitelist(scope, ids, name) {
+        const baseName = name ?? `${scope}-whitelist`;
+        return [
+            { name: baseName, action: 'allow', scopes: [scope], channels: ids, priority: 1 },
+            { name: `${baseName}-deny-rest`, action: 'deny', scopes: [scope], priority: -100 },
+        ];
+    }
+    FilterRules.whitelist = whitelist;
+})(FilterRules || (FilterRules = {}));
+// ============================================================================
+// Feature 实现
+// ============================================================================
+export class MessageFilterFeature extends Feature {
+    name = 'message-filter';
+    icon = 'Filter';
+    desc = '消息过滤';
+    /** 按规则名称索引 */
+    byName = new Map();
+    #defaultPolicy = 'allow';
+    #sortedCache = null;
+    constructor(config) {
+        super();
+        if (config)
+            this.#loadConfig(config);
+    }
+    // ---- 公共 API ----
+    /** 默认策略 */
+    get defaultPolicy() { return this.#defaultPolicy; }
+    set defaultPolicy(policy) { this.#defaultPolicy = policy; }
+    /** 获取按优先级排序的启用规则列表（带缓存） */
+    get sortedRules() {
+        if (!this.#sortedCache) {
+            this.#sortedCache = [...this.items]
+                .filter(r => r.enabled !== false)
+                .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        }
+        return this.#sortedCache;
+    }
+    /** 按名称查询规则 */
+    getRule(name) {
+        return this.byName.get(name);
+    }
+    /**
+     * 检测消息是否应该被处理
+     *
+     * 遍历按优先级排序的规则列表，返回第一个匹配的规则结果。
+     * 若无规则匹配，按默认策略决定。
+     */
+    test(message) {
+        for (const rule of this.sortedRules) {
+            if (this.#matchRule(rule, message)) {
+                return {
+                    allowed: rule.action === 'allow',
+                    matchedRule: rule.name,
+                    reason: `matched rule "${rule.name}" → ${rule.action}`,
+                };
+            }
+        }
+        return {
+            allowed: this.#defaultPolicy === 'allow',
+            matchedRule: null,
+            reason: `no rule matched → default policy: ${this.#defaultPolicy}`,
+        };
+    }
+    // ---- Feature 重写 ----
+    /** 添加规则，维护 byName 索引 */
+    add(rule, pluginName) {
+        this.byName.set(rule.name, rule);
+        this.#sortedCache = null;
+        return super.add(rule, pluginName);
+    }
+    /** 移除规则，清理 byName 索引 */
+    remove(rule, pluginName) {
+        this.byName.delete(rule.name);
+        this.#sortedCache = null;
+        return super.remove(rule, pluginName);
+    }
+    /** 序列化为 JSON（供 Web 控制台展示） */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(r => ({
+                name: r.name,
+                description: r.description,
+                action: r.action,
+                priority: r.priority ?? 0,
+                enabled: r.enabled !== false,
+                scopes: r.scopes,
+                adapters: r.adapters?.map(p => p instanceof RegExp ? p.source : p),
+                bots: r.bots?.map(p => p instanceof RegExp ? p.source : p),
+                channels: r.channels?.map(p => p instanceof RegExp ? p.source : p),
+                senders: r.senders?.map(p => p instanceof RegExp ? p.source : p),
+            })),
+        };
+    }
+    /** 插件扩展方法 */
+    get extensions() {
+        const feature = this;
+        return {
+            addFilterRule(rule) {
+                const plugin = getPlugin();
+                const dispose = feature.add(rule, plugin.name);
+                plugin.recordFeatureContribution(feature.name, rule.name);
+                plugin.onDispose(dispose);
+                return dispose;
+            },
+            testFilter(message) {
+                return feature.test(message);
+            },
+            setDefaultFilterPolicy(policy) {
+                feature.defaultPolicy = policy;
+            },
+        };
+    }
+    // ============================================================================
+    // 配置加载
+    // ============================================================================
+    #loadConfig(config) {
+        if (config.default_policy) {
+            this.#defaultPolicy = config.default_policy;
+        }
+        if (config.rules) {
+            for (const rc of config.rules) {
+                this.add(this.#parseRuleConfig(rc), '__config__');
+            }
+        }
+    }
+    // ============================================================================
+    // 规则匹配
+    // ============================================================================
+    /** 解析配置中的规则字符串为 FilterPattern */
+    #parseRuleConfig(rc) {
+        return {
+            name: rc.name,
+            description: rc.description,
+            action: rc.action,
+            priority: rc.priority,
+            enabled: rc.enabled,
+            scopes: rc.scopes,
+            adapters: rc.adapters?.map(p => this.#parsePattern(p)),
+            bots: rc.bots?.map(p => this.#parsePattern(p)),
+            channels: rc.channels?.map(p => this.#parsePattern(p)),
+            senders: rc.senders?.map(p => this.#parsePattern(p)),
+        };
+    }
+    /** 解析单个 pattern："/regex/flags" → RegExp，其余为精确字符串 */
+    #parsePattern(pattern) {
+        const match = pattern.match(/^\/(.+)\/([gimsuy]*)$/);
+        if (match) {
+            return new RegExp(match[1], match[2]);
+        }
+        return pattern;
+    }
+    /** 检查规则是否匹配消息（所有条件 AND，条件内 OR） */
+    #matchRule(rule, message) {
+        if (rule.scopes?.length && !rule.scopes.includes(message.$channel.type)) {
+            return false;
+        }
+        if (rule.adapters?.length && !this.#matchAny(rule.adapters, String(message.$adapter))) {
+            return false;
+        }
+        if (rule.bots?.length && !this.#matchAny(rule.bots, String(message.$bot))) {
+            return false;
+        }
+        if (rule.channels?.length && !this.#matchAny(rule.channels, message.$channel.id)) {
+            return false;
+        }
+        if (rule.senders?.length && !this.#matchAny(rule.senders, message.$sender.id)) {
+            return false;
+        }
+        return true;
+    }
+    /** 检查值是否与任一 pattern 匹配 */
+    #matchAny(patterns, value) {
+        return patterns.some(p => {
+            if (p instanceof RegExp)
+                return p.test(value);
+            if (p === '*')
+                return true;
+            return p === value;
+        });
+    }
+}
+//# sourceMappingURL=message-filter.js.map

package/lib/built/message-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-filter.js","sourceRoot":"","sources":["../../src/built/message-filter.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -15,6 +15,7 @@ export * from './built/permission.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/database.js';
+export * from './built/message-filter.js';
 export * from './built/tool.js';
 export * from './built/ai-trigger.js';
 export * from './built/dispatcher.js';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAE3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,uBAAuB,CAAA;AAErC,cAAc,uBAAuB,CAAA;AAErC,cAAc,kBAAkB,CAAA;AAEhC,cAAc,2BAA2B,CAAA;AAEzC,cAAc,iCAAiC,CAAA;AAE/C,cAAc,eAAe,CAAA;AAE7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAE3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,2BAA2B,CAAA;AAEzC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,uBAAuB,CAAA;AAErC,cAAc,uBAAuB,CAAA;AAErC,cAAc,kBAAkB,CAAA;AAEhC,cAAc,2BAA2B,CAAA;AAEzC,cAAc,iCAAiC,CAAA;AAE/C,cAAc,eAAe,CAAA;AAE7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}

package/lib/index.js

@@ -18,6 +18,7 @@ export * from './built/permission.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/database.js';
+export * from './built/message-filter.js';
 // Tool Service (纯工具，无副作用)
 export * from './built/tool.js';
 // AI Trigger Service (纯工具，无副作用)

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,SAAS;AACT,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,oBAAoB;AACpB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,0BAA0B;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,gCAAgC;AAChC,cAAc,uBAAuB,CAAA;AACrC,4BAA4B;AAC5B,cAAc,uBAAuB,CAAA;AACrC,qBAAqB;AACrB,cAAc,kBAAkB,CAAA;AAChC,sBAAsB;AACtB,cAAc,2BAA2B,CAAA;AACzC,yDAAyD;AACzD,cAAc,iCAAiC,CAAA;AAC/C,kCAAkC;AAClC,cAAc,eAAe,CAAA;AAE7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA,CAAE,WAAW;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,SAAS;AACT,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,oBAAoB;AACpB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,2BAA2B,CAAA;AACzC,0BAA0B;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,gCAAgC;AAChC,cAAc,uBAAuB,CAAA;AACrC,4BAA4B;AAC5B,cAAc,uBAAuB,CAAA;AACrC,qBAAqB;AACrB,cAAc,kBAAkB,CAAA;AAChC,sBAAsB;AACtB,cAAc,2BAA2B,CAAA;AACzC,yDAAyD;AACzD,cAAc,iCAAiC,CAAA;AAC/C,kCAAkC;AAClC,cAAc,eAAe,CAAA;AAE7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA,CAAE,WAAW;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.0.44",
+  "version": "1.0.46",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",
@@ -37,11 +37,11 @@
     "segment-matcher": "^1.0.5",
     "smol-toml": "^1.6.0",
     "yaml": "^2.3.4",
-    "@zhin.js/ai": "1.0.5",
-    "@zhin.js/database": "1.0.31",
-    "@zhin.js/kernel": "0.0.5",
-    "@zhin.js/logger": "0.1.28",
-    "@zhin.js/schema": "1.0.28"
+    "@zhin.js/kernel": "0.0.7",
+    "@zhin.js/database": "1.0.33",
+    "@zhin.js/ai": "1.0.7",
+    "@zhin.js/logger": "0.1.30",
+    "@zhin.js/schema": "1.0.30"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/adapter.ts

@@ -6,25 +6,12 @@ import { BeforeSendHandler, SendOptions, Tool, ToolContext, ToolScope } from "./
 import { segment } from "./utils.js";
 import { ZhinTool, isZhinTool, type ToolInput } from "./built/tool.js";
 import type { Skill, SkillFeature } from "./built/skill.js";
-import {
-  type IGroupManagement,
-  GROUP_METHOD_SPECS,
-  GROUP_MANAGEMENT_SKILL_DESCRIPTION,
-  GROUP_MANAGEMENT_SKILL_TAGS,
-  GROUP_MANAGEMENT_SKILL_KEYWORDS,
-  buildMethodArgs,
-} from "./built/common-adapter-tools.js";
 /**
- * Adapter类：适配器抽象，管理多平台Bot实例。
+ * Adapter 类：适配器抽象，管理多平台 Bot 实例。
  * 负责根据配置启动/关闭各平台机器人，统一异常处理。
  *
- * 适配器可以提供 AI 工具，供 AI 服务调用。
- *
- * 群管理能力：
- *   Adapter 基类声明了 IGroupManagement 中的可选方法规范，
- *   具体适配器（ICQQ/Discord/Telegram 等）选择性覆写。
- *   调用 registerGroupManagementSkill() 后，基类自动检测
- *   哪些方法已被实现，生成对应的 Tool 并注册为 "群聊管理" Skill。
+ * 适配器可提供 AI 工具并声明 Skill。群管等能力由各 IM 平台在子类中
+ * 自行实现方法并注册 Tool（如使用 createGroupManagementTools）+ declareSkill。
  */
 export abstract class Adapter<R extends Bot = Bot> extends EventEmitter<Adapter.Lifecycle> {
   /** 当前适配器下所有Bot实例，key为bot名称 */
@@ -101,8 +88,6 @@ export abstract class Adapter<R extends Bot = Bot> extends EventEmitter<Adapter.
       this.bots.set(bot.$id, bot);
     }
     this.logger.debug(`adapter ${this.name} started`);
-
-    this._autoDetectGroupManagement();
   }
   /**
    * 停止适配器，断开并移除所有Bot实例
@@ -322,69 +307,6 @@ export abstract class Adapter<R extends Bot = Bot> extends EventEmitter<Adapter.
     });
   }
 
-  // ==========================================================================
-  // 群管理自动检测 — start() 结束时自动执行
-  // ==========================================================================
-
-  /**
-   * 遍历 GROUP_METHOD_SPECS，检测子类是否覆写了对应方法。
-   * 对每个已实现的方法生成 Tool 并注册，最后聚合为 "群聊管理" Skill。
-   */
-  private _autoDetectGroupManagement(): void {
-    const self = this as unknown as IGroupManagement;
-    const prefix = this.name as string;
-    const generatedTools: Tool[] = [];
-
-    for (const spec of GROUP_METHOD_SPECS) {
-      const fn = self[spec.method];
-      if (typeof fn !== 'function') continue;
-
-      const boundFn: (...args: any[]) => Promise<any> = fn.bind(self);
-
-      const properties: Record<string, any> = {
-        bot_id: { type: 'string', description: 'Bot ID', contextKey: 'botId' },
-        scene_id: { type: 'string', description: '群/服务器 ID', contextKey: 'sceneId' },
-      };
-      const required: string[] = ['bot_id', 'scene_id'];
-
-      for (const [name, schema] of Object.entries(spec.extraParams)) {
-        properties[name] = schema;
-      }
-      if (spec.extraRequired) {
-        required.push(...spec.extraRequired);
-      }
-
-      const tool: Tool = {
-        name: `${prefix}_${spec.toolSuffix}`,
-        description: `${spec.description} (${prefix})`,
-        parameters: { type: 'object' as const, properties, required },
-        execute: async (args: Record<string, any>) => {
-          const { bot_id, scene_id, ...rest } = args;
-          return boundFn(...buildMethodArgs(spec.method, bot_id, scene_id, rest));
-        },
-        tags: ['group', 'management', prefix],
-        keywords: spec.keywords,
-        permissionLevel: spec.permissionLevel,
-        scopes: ['group', 'channel'] as ToolScope[],
-        preExecutable: spec.preExecutable,
-      };
-
-      this.addTool(tool);
-      generatedTools.push(tool);
-    }
-
-    if (generatedTools.length === 0) return;
-
-    this.declareSkill({
-      description: GROUP_MANAGEMENT_SKILL_DESCRIPTION,
-      keywords: GROUP_MANAGEMENT_SKILL_KEYWORDS,
-      tags: GROUP_MANAGEMENT_SKILL_TAGS,
-    });
-
-    this.logger.debug(
-      `自动检测到 ${generatedTools.length} 个群管理方法 → 已注册 Skill`,
-    );
-  }
 }
 export interface Adapters {}
 export namespace Adapter {

package/src/ai/providers/base.ts

@@ -49,7 +49,8 @@ export abstract class BaseProvider implements AIProvider {
     };
 
     if (this.config.apiKey) {
-      headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+      const scheme = this.config.authScheme !== undefined ? this.config.authScheme : 'Bearer ';
+      headers['Authorization'] = scheme + this.config.apiKey;
     }
 
     const controller = new AbortController();
@@ -91,7 +92,8 @@ export abstract class BaseProvider implements AIProvider {
     };
 
     if (this.config.apiKey) {
-      headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+      const scheme = this.config.authScheme !== undefined ? this.config.authScheme : 'Bearer ';
+      headers['Authorization'] = scheme + this.config.apiKey;
     }
 
     const controller = new AbortController();

package/src/ai/types.ts

@@ -140,6 +140,10 @@ export interface ProviderCapabilities {
 /** Provider 配置 */
 export interface ProviderConfig {
   apiKey?: string;
+  /**
+   * Authorization 头前缀。默认 `'Bearer '`；设为 `''` 时仅用 apiKey 作为值（部分 API 要求 `Authorization: <key>`）。
+   */
+  authScheme?: string;
   baseUrl?: string;
   defaultModel?: string;
   models?: string[];