配置
Bngeuit 启动时在运行目录自动生成 config.yml。
完整配置
yaml
# 必填：从 QQ 开放平台获取
appId: "你的BotAppID"
appSecret: "你的BotAppSecret"
# 可选：事件订阅意图，默认订阅群+C2C+互动
# intent: 33554432
# 可选：是否使用沙箱环境（默认 false）
# sandbox: false配置项说明
| 字段 | 必填 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
appId | ✅ | string | — | QQ 机器人 BotAppID |
appSecret | ✅ | string | — | QQ 机器人 BotAppSecret |
intent | ❌ | int | 33554432 | 事件意图位掩码 |
sandbox | ❌ | boolean | false | 是否使用沙箱环境 API |
Intents 意图
意图使用位掩码控制订阅哪些事件类型：
| 事件范围 | 位值 | 说明 |
|---|---|---|
| 群+C2C 事件 | 1 << 25 (33554432) | 群消息、私聊、成员变动等 |
| 互动事件 | 1 << 26 (67108864) | 按钮点击等 |
| 默认值 | (1<<25) | (1<<26) = 100663296 | 推荐，覆盖全部常用事件 |
默认值已足够
大多数场景使用默认值即可。仅需精确控制事件订阅时才手动指定。
沙箱环境
沙箱环境使用独立的 API 地址 https://sandbox.api.sgroup.qq.com/，用于开发测试：
yaml
sandbox: true正式上线时设为 false 或不填。