╔══════════════════════════════════════════════════════╗
║         BNS 取色宏 v3 — 使用说明书                    ║
║         剑灵怀旧服/巅峰服 智能卡刀宏                   ║
╚══════════════════════════════════════════════════════╝

【快速上手】

  1. 双击 BNS取色宏v3.exe 启动 GUI
  2. 点击左侧列表中的 「剑士」 或其他职业
  3. 对每个技能槽位，点击右边的 「取色」 按钮
  4. 红色十字准星出现 → 移到游戏技能图标上左键点击
  5. X/Y/RGB 自动填入槽位，逐个取完 12 个
  6. 点 「💾 保存方案」
  7. 点 「▶ 启动 AHK 引擎」
  8. 进入游戏，宏自动运行！


【热键说明】

  F6         暂停 / 恢复宏
  F7         停止宏


【界面说明】

  「方案」页:
    左侧 = 职业方案列表（点击切换）
    右侧 = 编辑区：
      方案名称
      动作延迟 = 每次按键后的等待时间
      空闲间隔 = 无匹配规则时的扫描间隔
      槽位数 = 技能栏有多少个图标（默认12）
      每个槽位: 序号 | 名称 | X | Y | 色块 | [取色] | 阈值 | 按键

  「循环」页 (左边规则列表 + 右边规则编辑):
    每个规则 = 条件 + 动作序列


╔══════════════════════════════════════════════════════╗
║           规则条件详解（核心概念）                     ║
╚══════════════════════════════════════════════════════╝

引擎怎么判断技能是否冷却好？
  取色时会存储该技能图标亮时的 RGB 颜色。
  引擎每毫秒读屏对比：
    屏幕颜色 ≈ 存储颜色 → ✅ 冷却好了（亮了）
    屏幕颜色 ≠ 存储颜色 → ❌ 冷却中（灰暗的）


三种条件:

  ⬛ require_all（要求全部匹配）
    写法: 0,1,2          ← 逗号分隔槽位序号
    含义: 这些槽位【全部】冷却好 → 才触发
    举例: 需要夺命剑(0)+火龙连斩(1)都亮了才打爆发

  ⬛ require_any（要求任一匹配）
    写法: 3,4
    含义: 这些槽位【任意一个】冷却好 → 触发
    举例: 槽位3或4哪个亮了用哪个

  ⬛ forbid（禁止匹配）
    写法: 2
    含义: 这些槽位【任意一个】冷却好 → 本条规则不触发
    举例: 有大招亮了(槽位2)，先别打小技能，留给大招

  优先级 = 规则在列表中的排列顺序，排在上面的先判断


实战示例 — 剑士三规则:

  规则1: 爆发连招（排最上面，最高优先级）
    require_all: 0,1     ← 夺命剑+火龙连斩都亮了
    forbid: 2            ← 但一闪亮着就别打（留给下面规则）
    actions:
      #0 按键 1
      #1 按键 2
      #2 等待 200ms
      #3 按键 r

  规则2: 一闪
    require_all: 2       ← 一闪亮了
    actions:
      #0 按键 3

  规则3: 默认填充（排最后，兜底）
    条件留空
    actions:
      #0 按键 r          ← 什么都没亮就按普攻


更多示例:

  刺客-隐身背刺:
    require_all: 8        ← 隐身技能(槽位8)亮了
    forbid: 0             ← 如果刺心(槽位0)亮了别触发（优先级更高）
    actions:
      #0 按键 4
      #1 等待 100ms
      #2 按键 1

  拳师-反击:
    require_any: 3,9      ← 铁山靠(3)或扫堂腿(9)任意一个亮了
    actions:
      #0 按键 q


【注意事项】

  · 取色时要在技能图标【最亮时】取色（冷却好了的时候）
  · 阈值默认 25，颜色不准时可加大（25→35）
  · 按键映射需与游戏内快捷键一致
  · 规则按列表顺序从上到下匹配，上面的优先
  · 没有规则匹配时不按键，等待下一个扫描周期


╔══════════════════════════════════════════════════════╗
║  剑士 · 拳师 · 力士 · 气功 · 刺客 · 召唤             ║
║  灵剑 · 咒术 · 魔枪                                  ║
╚══════════════════════════════════════════════════════╝
