KP_Hekili_Assistant

快跑兄弟的HEKILI全职业输出助手

KP全职业Hekili助手是一个为魔兽世界所有版本设计的技能辅助插件，它与Hekili技能推荐插件集成，为所有职业提供简化的技能触发机制。

PS：此插件可以随意分享，但请备注原作者，谢谢！

最新：V4.0.0（2026.5.11）

这个版本实现了一个很大的功能，更智能了，其中一个就是不再从ActionLists获取技能了，而是自动扫描技能书，跟随Hekili显示技能，并且对所有职业都能正常显示框体了！

- 主绑定键： R ，次绑定键： NUMPADPLUS （小键盘+号）

- 添加了 ScanSpellBook() 函数，自动遍历技能书获取主动技能

- 过滤被动技能，只保留最高等级技能。自动添加工程手套和自动攻击。

- 添加了 UpdateDisplayBySpellID() 函数，直接根据Hekili返回的spellID显示技能图标和冷却，而不是从ActionLists中查找索引

- 修改了 CalculateNextSpell 函数 - 移除了currentAPL.callback的调用，改为直接获取Hekili的actionID并使用UpdateDisplayBySpellID显示

- 创建了APL模块注册系统 ( RegisterAPL , LoadCurrentClassAPL )，注册了所有10个职业的30个天赋APL模块

- 目前可以直接使用双按键，随意设置

----------------------------------更新历史----------------------------------

V3.5更新说明：

更新了暗牧、猫德、鸟德、惩戒骑的通用逻辑，安装即用。

V3.6更新说明：

部分技能优化，工程加速手套适配。

V3.7更新说明：

潜在问题修复、容错性提升和体验优化。

主要体现在：

添加了指令，添加了最优技能推荐框体的技能名称显示，不仅摇一摇可以实现，也实现了框体的点击触发。

调整先前版本不管是否战斗都固定300秒执行内存清理的机制，改为仅在非战斗时执行垃圾回收，避免战斗中触发内存清理导致的轻微卡顿，对帧数 / 流畅度无明显影响，但更符合魔兽插件开发的最佳实践。

解决了上一版可能出现的 “莫名报错、框体消失、操作无提示” 等潜在问题。

V3.7.5更新说明：

实现了自动学习技能，第一次需要手动打一次木桩，让HEKILI显示的技能都能显示出来，插件会自动添加新技能并保存到技能列表中，无需手动添加。每个职业的技能列表独立保存，同一职业的不同角色共享同一个技能列表。动态添加的技能会自动保存到数据库，重新加载或重新登录后不会丢失。

（如果删除缓存，新添加的技能列表会丢失，如果想永久保存，需要游戏中输入/kphekili export命令，将显示的所有技能列表添加进KP_ActionList.lua文件的基础技能列表里）

V3.7.6更新说明：修复报错

V3.7.8 更新：改进逻辑，新的动态添加逻辑不再依赖于Hekili的推荐信息，而是：

1. 检查技能ID是否大于0

2. 通过 GetSpellInfo 获取技能名称，验证技能是否有效

3. 如果是有效的法术，就添加到技能列表中

4. 保存到数据库并重新创建技能层

V3.8.0更新说明：

插件现在使用了最新的"虚空之花"技术，实现了单按键输出逻辑。

通过以下机制实现跨安全区的信息传递：

1. 多框体系统 ：使用 DetectLyr、TriggerLyr、CoverLyr、DataLyr 等多个框体协同工作

2. 信息传递机制 ：利用 SecureCmdOptionParse 解析宏命令条件，通过控制 CoverLyr 的显示/隐藏来传递信息

3. 触发源 ：利用 SecureHoverDriverManager 的 OnHide 事件作为稳定的异步触发源

4. 安全执行 ：使用 SecureHandlerStateTemplate 和 SecureActionButtonTemplate 确保技能在安全环境中执行

最新版本通过鼠标左键单击色块实现锁定和解锁。右键单击绑定按键设置。

经过这些优化，KP_Hekili_Assistant 插件现在应该能够在新版本的魔兽世界中正常工作，为玩家提供流畅的技能推荐和施放体验。插件的交互体验更加直观，用户可以通过右键点击红点来移动或者设置绑定键，而不需要使用命令。同时，插件的稳定性和性能也得到了显著提升。

V3.8.2 (2026.4.12)

更新说明：

1. 调整显示框体层级 ：

  - 将DisplayFrame的FrameLevel从5改为100

  - 确保显示框体在最顶层，能够显示技能图标

  - 调整bndlyr的FrameLevel为1，确保在显示框体下方

2. 简化鼠标事件处理 ：

  - 移除了复杂的OnMouseDown和OnMouseUp脚本

  - 保留了基本的拖动功能和点击触发技能的功能

  - 确保鼠标事件处理不会干扰技能显示

3. 确保技能更新逻辑 ：

  - 确保UpdateDisplay函数能够正确更新技能显示

  - 确保CalculateNextSpell函数能够正确获取Hekili推荐的技能

  - 确保技能图标、冷却时间和技能名称能够正确显示

4.调整代码结构 ：

 - 将回退逻辑正确地放置在了if not success的条件块中

 - 确保只有在绑定失败时才执行回退到默认绑定的逻辑

5.优化逻辑流程 ：

 - 绑定失败时：显示错误信息 → 回退到默认绑定 → 更新配置 → 保存配置 → 显示回退提示 → 返回false

 - 绑定成功时：更新VF_Core绑定 → 更新ManagerFrame属性 → 保存配置 → 显示成功提示 → 返回true

6.避免重复执行 ：

 - 移除了重复的保存配置和显示提示信息的代码

 - 确保每个逻辑分支只执行一次保存配置和显示提示信息的操作

7.修复VF_Button 注册方式和层级结构

 -修复为 VF_Button:RegisterForClicks("AnyDown","AnyUp")，确保能够接收按下和弹起的事件

 -恢复 VF_Button 层级设置 ，确保它能够显示在其他框体之上

8.移除可见性控制

 -移除 RegisterStateDriver(VF_Button, "visibility", "[@target,harm,exists,nodead] show;hide")

 -确保 VF_Button 始终显示，能够接收按键事件

V3.8.3 (2026.4.13)

更新说明：

1. 添加双绑定键支持 ：

  - 新增主绑定键（KEY1）和次绑定键（KEY2）支持

  - 默认主绑定键为R，次绑定键为MouseWheelDown（鼠标下滚轮）

  - 支持同时使用两个不同的按键触发技能

2. 优化绑定键设置界面 ：

  - 添加了美观的背景框体，使用游戏内置的对话框样式

  - 显示插件名称、作者信息

  - 提供两个输入框，分别用于设置主绑定键和次绑定键

  - 支持拖动输入框和整个界面

3. 扩展命令系统 ：

  - 添加了secondarykey子命令，用于设置次绑定键

  - 更新了/kphekili命令的帮助信息，显示主绑定键和次绑定键的状态

4. 改进用户体验 ：

  - 右键点击小红点弹出绑定键设置界面

  - 输入框支持拖动，方便用户调整位置

  - 界面美观，布局合理，操作直观

-----------------------------------------------------------------------------

##指令说明

插件的核心指令入口为 /kphekili，所有功能均通过该指令的子参数触发，输入指令后会在聊天框输出彩色提示反馈，操作简单直观。除reset指令外，其他指令修改的配置（绑定键、框体位置、锁定状态）都会自动保存，重启游戏后无需重新设置。所有指令执行后都会在聊天框输出彩色提示，方便确认操作是否成功。受魔兽安全框架约束，lock/key/reset 指令在战斗中无法执行，会给出明确提示；hekili/show/resetpos 指令战斗中可正常使用。

=== KP_Hekili_Assistant 指令帮助 ===

/kphekili lock - 锁定/解锁框体，也可以通过色点锁定解锁。

/kphekili key [按键] - 修改绑定键（如 /kphekili key F1，支持组合键 （CTRL-1 ALT-A SHIFT-F等），功能键（F1-F12），字母数字键（A-Z、0-9），鼠标键（MouseWheelUp MouseWheelDown Button3（鼠标中键））

/kphekili hekili - 开关Hekili跟随

/kphekili reset - 重置所有配置

/kphekili show - 显示/隐藏框体

/kphekili resetpos - 重置框体位置到默认，默认在屏幕中偏右下（CENTER, UIParent, CENTER, 235, -210）

当前绑定键：主绑定键R ，次绑定键 NUMPADPLUS （小键盘+号）

Hekili跟随：默认开启

核心功能

1. Hekili技能推荐集成 ：自动获取Hekili的最优技能推荐（前提是有HEKILI插件）

2. 自动学习技能 ：无需手动添加

5. 快速触发 ：通过自定义设置的按键快速施放当前推荐技能

6. 全职业支持 ：包含所有职业和专精

7. 版本适配：支持WLK,MOP,时光等所有HEKILI通用的版本。

8. 动态技能显示 ：根据当前职业、专精和Hekili推荐实时更新技能图标

9. 防卡顿优化 ：使用分帧处理技术避免界面卡顿全性当前应该触发的技能

使用流程

1. 插件加载后自动检测玩家职业

2. 根据职业创建对应的技能层

3. 实时从Hekili获取最优技能推荐

4. 非战斗状态点击图标左上色块自由移动框体位置

5. 玩家使用自定义按键触发当前Hekili显示的技能

技术亮点

- 安全框架应用 ：正确使用WoW的安全框架确保按键绑定的安全性

- 分帧处理 ：优化UI更新性能，避免卡顿

- 模块化设计 ：按功能模块组织代码，易于维护和扩展

- 自动化 ：无需手动添加技能，插件会自动学习

- 统一管理 ：同一职业的不同角色共享技能列表

快跑WA插件化的实践，欢迎进入网易DD快跑兄弟的交流频道294166反馈。