内置技能与示例
上一页：结果码 CastResult · 下一页：诊断排错
首次启动后，QS 会向 plugins/QinhSkills/skills/<分类>/ 释放一组带详细注释的示例技能。它们既是开箱即用的样板，也是最快的教程——照着改就能造出自己的技能。
📌 只在缺失时释放，不覆盖你的修改。删掉某个示例可再次释放；改过的不会被重写。
🎓 8 个示例技能
| 技能 | 文件 | 触发 | 分类 | 教学点 | 对应 MM 技能名 |
|---|---|---|---|---|---|
| fire_wave | combat/fire_wave.yml | 右键 | combat | 最基础模板——瞬发 AOE，先读它 | fire_wave |
| blade_slash | combat/blade_slash.yml | 左键 | combat | NEAREST 索敌 + MONSTERS 过滤 + 血祭 cost + GCD + conditions + ready_notify + 冲突组 | blade_slash |
| demo_slash | combat/demo_slash.yml | QI 物品动作 | combat | QI 物品触发入门（starter） | demo_slash |
| demo_slash_charged | combat/demo_slash_charged.yml | （channel） | combat | channel 吟唱读条 | demo_slash_charged |
| retaliate | combat/retaliate.yml | 被动 ON_ATTACK | combat | 被动反击技能 | retaliate |
| dash | movement/dash.yml | 按键 | movement | 充能 charges + ignore_gcd 不吃 GCD | dash |
| shield | utility/shield.yml | 按键 | utility | toggle 开关型施法 | shield |
| fire_combo_finisher | combo/fire_combo_finisher.yml | 连招 右→右→左 | combo | 连招（combo）终结技 | fire_combo_finisher |
💡 学习顺序建议：
fire_wave（看懂最小技能）→blade_slash（看门控全家桶）→ 按需挑dash/shield/demo_slash_charged/retaliate/fire_combo_finisher（各拆一个进阶玩法）。demo_slash用来接 QI 物品。
🩹 示例只发一条占位消息
每个示例技能默认只触发一条 [QinhSkills] 技能名 确认消息——因为真实表现交给 MythicMobs。想要火焰、位移、粒子等效果，就去 plugins/MythicMobs/skills/ 写一个同名 MM 技能（如 fire_wave），/mm reload 后即生效。QS 不会覆盖你已有的同名 MM 技能。
分类固定五类：
combat/movement/utility/combo/boss。技能定义放skills/<分类>/，对应 graph 放graphs/<分类>/。
🔌 对接示例（integrations/）
首次启动还会向 plugins/QinhSkills/integrations/ 释放 4 个对接样板，均带注释、可照抄：
| 文件 | 演示 |
|---|---|
qinhitems_action_example.yml | QinhItems 物品按键经原生 qinhskills:cast handler 放技能 |
neigeitems_skill_example.yml | NeigeItems 等用 /qs cast 命令桥放技能 |
mythic/QinhSkillsEcosystem.yml | MM 那侧的真实表现：接收 QS 变量 / 目标，伤害交属性插件 |
QinhClass_MMOCore.md | 可选的职业 / 进度层对接说明 |
一条铁律贯穿全部：QI / QS 都不内置属性与伤害——伤害数值由 AttributePlus 等属性插件在 MM 那侧结算。
🧪 关于内部测试件
skills/ 下另有少量 chain_*.yml、integrations/ 下有 *chain* / event_chain_validation.yml / config.integration-test.example.yml 等文件——这些是内部事件链 CI 回归套件，不通过命令暴露，服主无需关心，照常使用上面 8 个示例即可。
继续阅读
- 服主指南 → 技能定义全字段 — 每个示例用到的字段逐项解释
- 对接 → 对接总览 — 把示例接到物品 / NI / MM
- 诊断排错 — 示例放出来只有占位消息怎么办