安装

在 Cargo.toml 中加入 botrs 以及异步运行时：

[dependencies]
botrs = "0.13.0"
tokio = { version = "1", features = ["full"] }
async-trait = "0.1"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }

tokio 必须开启 features = ["full"]，因为框架会启动网关／心跳任务并依赖定时器与 I/O 驱动。async-trait 也是必需的，EventHandler 使用 #[async_trait::async_trait] 标注。

特性开关

crate 默认不启用任何特性。唯一可能用到的开关是 examples，它会引入 toml 与 tracing-subscriber，用于 examples/ 目录下的可执行示例。普通使用者不需要它。

botrs = { version = "0.13.0", features = ["examples"] }

安装自检

use botrs::{Token, Intents};

fn main() {
    let _ = Token::new("app_id", "secret");
    let _ = Intents::default();
    println!("botrs {}", botrs::VERSION);
}

若能编译通过即可继续：

• 快速开始 —— 一个最小可运行机器人。
• 配置 —— Token::from_env 与沙箱／正式环境切换。