Struct EnabledSet 

pub struct EnabledSet { /* private fields */ }

命令启用状态表。廉价共享（内部锁），运行期可改。

Implementations

impl EnabledSet

pub fn new() -> EnabledSet

pub fn set(&self, key: impl Into<SwitchKey>, peer: Option<Peer>, enabled: bool)

设置某命令的启用状态：peer=None 为全局覆盖，Some(p) 为按会话覆盖。 在释放写锁后触发 on_change 回调。

同时接受纯字符串键与类型化的 SwitchKey（#[command]/#[event] 宏产出的 <FN>_KEY 常量），故触发器键无需手敲字符串。

Examples found in repository

examples/plugin_switches.rs (line 48)

async fn disable(reply: Reply, es: State<EnabledSet>, peer: EventPeer, args: ArgText) -> HandlerResult {
    let key = args.0.trim();
    if key.is_empty() {
        reply.text("用法：/disable <key>").await?;
        return Ok(());
    }
    // `State<EnabledSet>` deref 到 `EnabledSet`,所以 `es.set(..)` 直接调通。
    es.set(key, Some(peer.0), false);
    // 引用触发命令,让确认消息挂在它下面。
    reply.reply(format!("已在本会话禁用：{key}")).await?;
    Ok(())
}

#[command("/enable", id = "enable", can_disable = false)]
async fn enable(reply: Reply, es: State<EnabledSet>, peer: EventPeer, args: ArgText) -> HandlerResult {
    let key = args.0.trim();
    if key.is_empty() {
        reply.text("用法：/enable <key>").await?;
        return Ok(());
    }
    es.set(key, Some(peer.0), true);
    reply.reply(format!("已在本会话启用：{key}")).await?;
    Ok(())
}

pub fn reset(&self, key: impl Into<SwitchKey>, peer: Option<Peer>)

清除某命令的覆盖，回到 default_enable：peer=None 清全局，Some 清该会话。

pub fn is_enabled_keyed( &self, plugin_key: &str, trigger_key: &str, plugin_default: bool, plugin_can_disable: bool, trigger_default: bool, trigger_can_disable: bool, peer: Option<Peer>, ) -> bool

分层的触发器判定：

1. 触发器 can_disable=false → 恒开（豁免，无视总开关）；
2. 插件总开关 OFF（且插件 can_disable）→ 关（一刀压平）；
3. 否则看触发器自身的开关。

pub fn is_enabled( &self, name: &str, default_enable: bool, peer: Option<Peer>, ) -> bool

单键查询（无插件层适用处用它）。

pub fn on_change<F>(&self, f: F)

where F: Fn(&str, Option<Peer>, bool) + Send + Sync + 'static,

注册一个在每次 set 调用后（锁释放后）触发的回调。只能注册一个，再次调用替换前一个。 reset 不触发回调（它是本地回退，不是需持久化的变更）。

pub fn snapshot(&self) -> EnabledOverrides

把当前所有覆盖快照成一个可序列化结构。

pub fn restore(&self, ov: EnabledOverrides)

从先前快照的结构恢复覆盖（替换当前状态）。

Trait Implementations

impl Default for EnabledSet

fn default() -> EnabledSet

Returns the “default value” for a type.