Struct AutoReplyManager 

pub struct AutoReplyManager { /* private fields */ }

自动回复管理器

核心管理器，集成所有组件处理自动回复逻辑。

字段说明

• registry: 触发器注册表，管理所有已注册的触发器
• whitelist: 白名单管理器，控制哪些用户可以触发自动回复
• cooldown: 冷却追踪器，防止用户频繁触发
• keyword_matcher: 关键词匹配器，用于关键词触发类型
• group_activations: 群组激活配置，控制群组中的触发行为
• config_path: 配置文件路径

Implementations

impl AutoReplyManager

pub async fn new(config_path: PathBuf) -> Result<Self>

创建新的管理器

参数

• config_path - 配置文件路径

返回值

返回初始化的 AutoReplyManager 实例。

pub fn should_reply(&mut self, message: &IncomingMessage) -> TriggerResult

检查消息是否应该触发自动回复

这是核心方法，按以下顺序检查：

1. 白名单检查（Requirement 6.6）
2. 群组激活检查（如果是群组消息）
3. 冷却时间检查（Requirement 6.7）
4. 触发器匹配（Requirements 6.1, 6.2, 6.3）

参数

• message - 入站消息

返回值

• TriggerResult::Triggered - 触发成功，包含触发器和上下文
• TriggerResult::Rejected - 触发被拒绝，包含拒绝原因
• TriggerResult::NoMatch - 无匹配触发器

示例

let result = manager.should_reply(&message);
match result {
    TriggerResult::Triggered { trigger, context } => {
        // 处理触发
    }
    TriggerResult::Rejected { reason } => {
        // 处理拒绝
    }
    TriggerResult::NoMatch => {
        // 无匹配
    }
}

pub fn register_trigger(&mut self, trigger: AutoReplyTrigger)

注册触发器

参数

• trigger - 要注册的触发器

pub fn unregister_trigger( &mut self, trigger_id: &str, ) -> Option<AutoReplyTrigger>

注销触发器

参数

• trigger_id - 要注销的触发器 ID

返回值

如果触发器存在并被移除，返回 Some(trigger)；否则返回 None。

pub fn set_group_activation(&mut self, activation: GroupActivation)

设置群组激活配置

参数

• activation - 群组激活配置

pub fn get_group_activation(&self, group_id: &str) -> Option<&GroupActivation>

获取群组激活配置

参数

• group_id - 群组 ID

返回值

如果存在配置，返回 Some(&GroupActivation)；否则返回 None。

pub fn remove_group_activation( &mut self, group_id: &str, ) -> Option<GroupActivation>

移除群组激活配置

参数

• group_id - 群组 ID

返回值

如果存在配置并被移除，返回 Some(GroupActivation)；否则返回 None。

pub fn add_to_whitelist(&mut self, user_id: String)

添加用户到白名单

参数

• user_id - 用户 ID

pub fn remove_from_whitelist(&mut self, user_id: &str) -> bool

从白名单移除用户

参数

• user_id - 用户 ID

返回值

如果用户存在并被移除，返回 true；否则返回 false。

pub fn is_user_whitelisted(&self, user_id: &str) -> bool

检查用户是否在白名单中

参数

• user_id - 用户 ID

返回值

如果用户在白名单中或白名单为空，返回 true；否则返回 false。

pub fn set_default_cooldown(&mut self, duration: Duration)

设置默认冷却时间

参数

• duration - 冷却时间

pub fn set_type_cooldown( &mut self, trigger_type: TriggerType, duration: Duration, )

设置特定触发类型的冷却时间

参数

• trigger_type - 触发类型
• duration - 冷却时间

pub fn reset_user_cooldown(&mut self, user_id: &str)

重置用户冷却

参数

• user_id - 用户 ID

pub fn config_path(&self) -> &PathBuf

获取配置文件路径

pub async fn save_config(&self) -> Result<()>

保存配置

将当前配置保存到配置文件。

pub async fn reload_config(&mut self) -> Result<()>

重新加载配置

从配置文件重新加载配置。

pub fn get_stats(&self) -> AutoReplyStats

获取统计信息

返回自动回复管理器的各项统计数据。

返回值

返回 AutoReplyStats 结构体，包含：

• total_triggers: 已注册的触发器总数
• enabled_triggers: 已启用的触发器数量
• whitelist_size: 白名单中的用户数量
• group_activations: 群组激活配置数量

示例

let stats = manager.get_stats();
println!("Total triggers: {}", stats.total_triggers);
println!("Enabled triggers: {}", stats.enabled_triggers);
println!("Whitelist size: {}", stats.whitelist_size);
println!("Group activations: {}", stats.group_activations);