术语表
QS 文档里反复出现的名词，一行一个，点链接看详解。
🧩 生态插件
| 术语 | 含义 |
|---|---|
| QS | QinhSkills，本插件，技能运行时引擎（管"能不能放"） |
| QI | QinhItems，物品系统（管"按下"，原生 qinhskills:cast handler） |
| QCL | QinhCoreLib，核心库，QS 硬依赖 |
| QC | QinhClass，职业 / 进度层（将来接管法力 / 等级 / 属性资源池） |
| MM | MythicMobs，技能表现执行后端（粒子 / 伤害动作 / 位移） |
| AP | AttributePlus，属性插件，负责伤害数值结算 |
⚙️ 运行时与管线
| 术语 | 含义 |
|---|---|
| 运行时 / runtime | QS 的单一技能管线；1.0.22 起只有这一条（无 v1/v2 之分） |
| 管线 | 输入归一 → 状态机 → 图解析 → 执行计划 → 门控 → 执行 → 后处理 |
| payload | 一次触发归一后的载荷（技能 id / 触发源 / 目标等） |
| profile / 档案 | PlayerSkillProfile，玩家的解锁 / 等级 / 冷却 / 槽位数据 |
详见 核心概念。
🔁 状态机
| 术语 | 含义 |
|---|---|
| SkillState | 状态机状态枚举 |
| IDLE | 空闲（可起手） |
| CASTING | 施放中 |
| COMBO_WINDOW | 连招窗口（起手成功后进入，续段节点靠它区分起手 / 续段） |
| RECOVERY | 收招恢复 |
| LOCKED | 被锁定 / 沉默 |
| INTERRUPTED | 被打断 |
🗺️ graph 与连招
| 术语 | 含义 |
|---|---|
| graph | 技能的节点图（graphs/<分类>/*.graph.yml），决定触发走哪个节点 |
| node | graph 节点，含 skill_id/mythic_skill/require_state/triggers |
| entry | graph 入口节点；触发未命中任何节点时回退到它 |
| require_state | 节点要求的状态机状态 |
| combo / 连招 | combos 段：窗口内按出 inputs 序列触发终结技 |
| finalize_skill | 连招终结技，必须是本 graph 的一个 node id |
| 连招窗口 / window_ms | 整套序列的时间窗口，超时回 IDLE 断连 |
详见 graph 与连招。
🚦 门控（Gate）与结果
| 术语 | 含义 |
|---|---|
| gate / 门控 | 释放前的逐项校验：解锁 / 冷却 / 资源 / 冲突 / 条件 / 目标 / 沉默 |
| CastResult | 释放最终结果码（14 个），见 结果码 |
| 冷却 / cooldown | 二元冷却，落盘防重登刷 |
| 冷却组 / cooldown_group | 同组技能共享冷却 |
| 充能 / charges | >1 时替代二元冷却，逐层恢复（内存态） |
| GCD | 全局冷却，放技能后全角色技能短暂封禁；ignore_gcd 豁免 |
| 冲突组 / conflict_groups | 施放后同组技能短期互斥 |
| conditions | 声明式释放条件（等级 / 血量 / 目标…），未知键恒真 |
| resource / cost / 血祭 | resource.mana 占位资源；cost.health/hunger 生命饥饿消耗（血祭） |
| silence / 沉默 | /qs silence 或 API 封锁，期间放不出任何技能 |
详见 冷却充能GCD与冲突。
🎯 目标与触发
| 术语 | 含义 |
|---|---|
| target mode | 目标模式：SELF/LOOK/NEAREST/FARTHEST/LOWEST_HP/HIGHEST_HP/RANDOM |
| filter | 索敌过滤：ANY/LIVING/MONSTERS/PLAYERS/NOT_PLAYERS |
| TriggerType | 触发类型：RIGHT_CLICK/LEFT_CLICK/PASSIVE/COMMAND/API 等 |
| active_triggers | 主动触发源：KEY_SLOT/QI_ACTION/COMMAND/API |
| passive_triggers | 被动触发（11 种）：ON_DAMAGED/ON_ATTACK/ON_KILL/ON_LOW_HEALTH/ON_SNEAK/ON_JUMP/ON_SPRINT/ON_BLOCK_BREAK/ON_RESPAWN/ON_FALL/TICK |
🎬 施法模式
| 术语 | 含义 |
|---|---|
| cast_mode | 施法模式：instant 瞬发 / toggle 开关 / channel 吟唱 |
| 吟唱 / channel | 读条施法，带 bossbar/actionbar/none 进度、位移与受伤打断 |
| toggle | 开关型技能，反复切换 on/off（<skill.var.toggle_state>） |
详见 施法模式与吟唱。
🌉 桥与接口
| 术语 | 含义 |
|---|---|
| 桥 / bridge | QS → MM 的执行桥（SkillRuntimeBridge） |
| 三种桥模式 | AUTO / API_MODE / YAML_STUB；AUTO fallback 仅缺失技能 |
handler / qinhskills:cast | QI 物品调用 QS 的原生动作 handler |
| 命令桥 | 非 QI 物品经 /qs cast 放技能 |
| stub / 占位技能 | MM 缺同名技能时的占位执行（只发一条消息） |
| QISkillUseEvent | 技能释放事件，含 castResult 字段（开发者监听） |
📊 其他
| 术语 | 含义 |
|---|---|
variables / <skill.var.x> | 透传给 MM 的技能变量 |
| levels | 分等级参数覆盖（冷却 / 消耗 / params） |
| ready_notify | 冷却就绪提示（actionbar + 音效，仅二元冷却） |