📦 服主指南

本节是 QinhSkills 技能编写指南——教你用 YAML 把一个技能从无到有配满。每个技能由两份文件组成：skills/ 下的技能定义（技能"是什么"：触发键、冷却、目标、消耗、等级）和 graphs/ 下的 graph 执行图（技能"怎么走"：按键路由、连招、绑定哪个 MythicMobs 技能）。理解这套 skills/ 与 graphs/ 的拆分，是配技能的第一步。

不需要任何编程基础，照着自带示例改即可。建议的阅读顺序：先看文件结构搞清目录与命名 → 再翻全字段参考逐字段把技能配满 → 想做多段技就读 graph 与连招、触发器、被动技能 → 进阶门控看目标索敌、冷却充能 GCD、施法模式与吟唱 → 代价与逻辑看消耗条件变量、脚本 → 最后用 config.yml 调全局默认值。

每页都自成一体，配技能时哪不会就直接翻到对应小节即可。

本节内容

• 🗂️ 技能文件结构 — 一个技能 = 两份 YAML，目录分类、命名规则、reload 生效循环
• 📝 技能定义全字段 — 技能定义文件的逐字段参考手册，含别名优先级与实战范例
• 🔀 graph 图与连招 — graph 执行图、入口节点、触发键路由与多段连招编排
• 🎯 触发器 — 主触发键类型与触发源（物品 / 按键槽 / 命令 / API）
• 🛡️ 被动技能 — 11 种被动触发（受伤 / 攻击 / 击杀 / 低血 / 周期…）与限流
• 🔭 目标与索敌 — 索敌模式、范围、过滤、视线锁定与 @Target 传参
• ⏱️ 冷却/充能/GCD/冲突 — 二元冷却 vs 充能、冷却组、全局冷却与互斥组
• 🪄 施法模式与吟唱 — 瞬发 / 开关 / 吟唱读条与打断机制
• 💧 消耗/条件/变量 — 资源 / 血祭消耗、声明式释放条件与 MM 变量透传
• 📜 脚本（pre_js / post_js） — 施放前拦截与施放后副作用的 JS 脚本出口
• ⚙️ config.yml 全配置 — 全局默认值与开关的完整配置说明