Struct GroupActivation 

pub struct GroupActivation {
    pub group_id: String,
    pub enabled: bool,
    pub require_mention: bool,
    pub cooldown_seconds: Option<u64>,
    pub whitelist: Option<Vec<String>>,
}

群组激活配置

控制特定群组中的自动回复触发行为。

字段说明

• group_id: 群组的唯一标识符
• enabled: 是否在该群组启用自动回复（Requirement 5.5）
• require_mention: 是否要求 @提及才触发（Requirement 5.1, 5.2）
• cooldown_seconds: 群组特定的冷却时间覆盖（Requirement 5.3）
• whitelist: 群组特定的白名单覆盖（Requirement 5.4）

Fields

group_id: String

群组 ID

enabled: bool

是否启用自动回复 Validates: Requirement 5.5

require_mention: bool

是否要求 @提及 Validates: Requirements 5.1, 5.2

cooldown_seconds: Option<u64>

群组特定冷却时间（秒） Validates: Requirement 5.3

whitelist: Option<Vec<String>>

群组特定白名单 Validates: Requirement 5.4

Implementations

impl GroupActivation

pub fn new(group_id: impl Into<String>) -> Self

创建新的群组激活配置

默认启用自动回复，不要求 @提及。

参数

• group_id - 群组 ID

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::new("group-123");
assert!(activation.enabled);
assert!(!activation.require_mention);
assert!(activation.cooldown_seconds.is_none());
assert!(activation.whitelist.is_none());

pub fn disabled(group_id: impl Into<String>) -> Self

创建禁用的群组配置

Validates: Requirement 5.5

参数

• group_id - 群组 ID

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::disabled("group-123");
assert!(!activation.enabled);

pub fn with_enabled(self, enabled: bool) -> Self

设置是否启用自动回复

Validates: Requirement 5.5

参数

• enabled - 是否启用

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::new("group-123").with_enabled(false);
assert!(!activation.enabled);

pub fn with_require_mention(self, require_mention: bool) -> Self

设置是否要求 @提及

Validates: Requirements 5.1, 5.2

参数

• require_mention - 是否要求 @提及

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::new("group-123").with_require_mention(true);
assert!(activation.require_mention);

pub fn with_cooldown(self, seconds: u64) -> Self

设置群组特定冷却时间

Validates: Requirement 5.3

参数

• seconds - 冷却时间（秒）

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::new("group-123").with_cooldown(120);
assert_eq!(activation.cooldown_seconds, Some(120));

pub fn with_whitelist(self, users: Vec<String>) -> Self

设置群组特定白名单

Validates: Requirement 5.4

参数

• users - 白名单用户列表

示例

use aster::auto_reply::GroupActivation;

let activation = GroupActivation::new("group-123")
    .with_whitelist(vec!["user1".to_string(), "user2".to_string()]);
assert!(activation.whitelist.is_some());
assert_eq!(activation.whitelist.as_ref().unwrap().len(), 2);

pub fn should_trigger( &self, mentions_bot: bool, ) -> Result<(), GroupRejectionReason>

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

根据群组配置检查消息是否满足触发条件。

Validates: Requirements 5.1, 5.2, 5.5

参数

• mentions_bot - 消息是否 @提及了机器人

返回值

返回 Ok(()) 如果应该触发，否则返回 Err(GroupRejectionReason)。

示例

use aster::auto_reply::{GroupActivation, GroupRejectionReason};

// 禁用的群组
let disabled = GroupActivation::disabled("group-123");
assert_eq!(disabled.should_trigger(true), Err(GroupRejectionReason::GroupDisabled));

// 要求 @提及的群组
let require_mention = GroupActivation::new("group-456").with_require_mention(true);
assert_eq!(require_mention.should_trigger(false), Err(GroupRejectionReason::RequiresMention));
assert_eq!(require_mention.should_trigger(true), Ok(()));

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

检查用户是否在群组白名单中

Validates: Requirement 5.4

参数

• user_id - 用户 ID

返回值

• 如果没有设置群组白名单，返回 None（使用全局白名单）
• 如果设置了群组白名单且用户在其中，返回 Some(true)
• 如果设置了群组白名单但用户不在其中，返回 Some(false)

示例

use aster::auto_reply::GroupActivation;

// 没有群组白名单
let no_whitelist = GroupActivation::new("group-123");
assert_eq!(no_whitelist.is_user_whitelisted("any_user"), None);

// 有群组白名单
let with_whitelist = GroupActivation::new("group-456")
    .with_whitelist(vec!["user1".to_string()]);
assert_eq!(with_whitelist.is_user_whitelisted("user1"), Some(true));
assert_eq!(with_whitelist.is_user_whitelisted("user2"), Some(false));

pub fn effective_cooldown(&self, default_cooldown: u64) -> u64

获取有效的冷却时间

Validates: Requirement 5.3

参数

• default_cooldown - 默认冷却时间（秒）

返回值

返回群组特定冷却时间，如果未设置则返回默认值。

示例

use aster::auto_reply::GroupActivation;

// 没有群组冷却时间
let no_cooldown = GroupActivation::new("group-123");
assert_eq!(no_cooldown.effective_cooldown(60), 60);

// 有群组冷却时间
let with_cooldown = GroupActivation::new("group-456").with_cooldown(120);
assert_eq!(with_cooldown.effective_cooldown(60), 120);

pub fn group_id(&self) -> &str

获取群组 ID

pub fn is_enabled(&self) -> bool

检查群组是否启用

Validates: Requirement 5.5

pub fn requires_mention(&self) -> bool

检查是否要求 @提及

Validates: Requirement 5.1

pub fn has_custom_cooldown(&self) -> bool

检查是否有群组特定冷却时间

Validates: Requirement 5.3

pub fn has_custom_whitelist(&self) -> bool

检查是否有群组特定白名单

Validates: Requirement 5.4

Trait Implementations

impl Clone for GroupActivation

fn clone(&self) -> GroupActivation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GroupActivation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GroupActivation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for GroupActivation

fn eq(&self, other: &GroupActivation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for GroupActivation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GroupActivation