性能与限流
QS 本身很轻，但高频被动和调试输出用不好会拖性能。本页是上线前的检查清单。
⚡ 高频被动必须限流
ON_DAMAGED / ON_JUMP / ON_BLOCK_BREAK / ON_SNEAK / TICK 这类被动每秒可能触发多次。务必给它们配 cooldown_ms（被动条目级）或技能 cooldown，否则会连发刷爆服务器与聊天框。
yaml
passive_triggers:
- type: ON_BLOCK_BREAK
id: miner_buff
cooldown_ms: 500 # 必配，否则每挖一格就放一次| 触发 | 风险 | 建议 |
|---|---|---|
ON_DAMAGED | 连续受击连发 | cooldown_ms 限流 |
ON_JUMP / ON_SNEAK | 玩家狂按 | cooldown_ms 限流 |
ON_BLOCK_BREAK | 连挖刷爆 | cooldown_ms 限流 |
TICK | 每个间隔都跑 | 见下方 tick 配置 |
ON_LOW_HEALTH | 低 | 边沿触发，跨阈值才放，天然不刷 |
⏲️ TICK 被动节流
TICK 被动的周期由 config 控制：
| 配置 | 默认 | 说明 |
|---|---|---|
passive.tick_interval_ticks | 20（=1 秒） | TICK 被动的检查间隔 |
服务器里没有任何 TICK 被动时，对应轮询任务会空转、不产生开销——可放心保留默认。
🖥️ Actionbar 刷新
| 配置 | 默认 | 说明 |
|---|---|---|
actionbar.refresh_ticks | 10 | actionbar 刷新间隔 |
actionbar.hide_when_empty_slot | — | 空槽位时不刷 actionbar，避免刷空屏 |
调大 refresh_ticks 可降开销，但数字会更新得慢一点；权衡即可。
💾 持久化与内存态
| 状态 | 存储 | 重登行为 |
|---|---|---|
| 二元冷却 | 落盘 | 保留——防止重登刷新冷却 |
| 充能 charges | 内存态 | relog 重置 |
| toggle 开关 | 内存态 | relog 重置 |
充能 / toggle 是内存态，玩家重新登录会回到初始；冷却落盘是有意为之，避免"重登清 CD"的刷子行为。
🌉 桥与启动
- Mythic 桥的
sync延迟执行，避免启动时所有插件抢加载导致卡顿； AUTO模式的 fallback 仅对缺失技能生效，已有的同名 MM 技能永不被覆盖、也不额外开销。
🐞 调试开销
debug: true会逐阶段打 trace，高频触发下刷屏严重——仅排错用，生产关闭。- 排查完一个技能记得把它的
debug关掉，别整服开。
详见 诊断排错 §7。
✅ 上线前检查清单
- [ ] 所有高频被动都配了
cooldown_ms或技能cooldown - [ ] 没有遗留
debug: true - [ ]
tick_interval_ticks/actionbar.refresh_ticks是合理值 - [ ] 玩家无法靠重登刷冷却（冷却落盘，默认就对）
继续阅读
- 诊断排错 — debug trace 用法
- 服主指南 → 被动技能 — 11 种被动与限流细节
- FAQ — 常见问题