Skip to content

📚 参考:速查与排错

这一章是 QS 的速查区——不教你怎么搭技能,而是回答你上手后会反复翻的那些问题:命令怎么打、权限怎么配、玩家看到的某条提示是哪条逻辑、/qs cast 打回来的结果码是什么意思、自带示例技能在哪、性能怎么调、出问题往哪查。所有内容都以 QS 1.0.22 为准,命令树、结果码、被动种类与源码严格对齐。

平时用得最多的两张表是 命令与权限(11 个子命令 + 6 个权限节点)和 结果码 CastResult(14 个结果码)——遇到技能放不出来,先从这两页和 诊断与排错 的决策树入手;想吃透名词就翻 术语表;上线前过一遍 性能与被动限流 的检查清单。

本节内容

  • ⌨️ 命令与权限/qs 的 11 个子命令、6 个权限节点、Tab 补全与典型用法。
  • 💬 消息文案速查 — 每条玩家可见消息的原文,对照游戏里看到的文字定位逻辑。
  • 🔢 结果码 CastResult — 14 个释放结果码的含义、玩家文案与处理建议。
  • 📋 内置技能与示例 — 首启释放的 8 个带注释示例技能与 4 个对接样板。
  • 🚑 诊断与排错 — 按"现象 → 原因 → 处理"的排查决策树与 debug trace 用法。
  • 📈 性能与被动限流 — 高频被动限流、TICK 节流、持久化与上线检查清单。
  • FAQ 常见问题 — 各页易错点汇成的分主题问答。
  • 📖 术语表 — QS / 门控 / 桥 / 状态机等高频名词速查。
  • 📅 更新日志 — 按能力维度记录的版本演进。