KP_API 浏览器

======================= KP_API 浏览器 插件介绍

版本：1.0 作者：快跑兄弟 适用：魔兽世界全版本客户端（正式服、各版本怀旧服、时光服等）

一、插件是做什么的

这个插件会扫描你当前客户端真正提供的全部原生接口，并在 游戏内提供一个浏览窗口。写插件、查接口、研究界面框架时， 不用切出游戏翻网页，在游戏里直接搜索、复制即可。

扫描内容分三类：

1. 全局原生函数 例如 UnitHealth、GetSpellInfo、SendChatMessage 等， 自动排除其他插件自己写的函数，只保留客户端引擎接口。
2. C_ 命名空间接口 例如 C_Timer、C_Map、C_CVar 等现代风格接口表。
3. 控件方法 Frame、Button、EditBox、Texture、FontString 等 二十多种界面控件各自能调用的全部方法。

因为是直接在运行中的客户端里枚举，所以扫描结果和你的 客户端完全一致，包括私服或特殊客户端自带的私有接口， 不会出现网上查来但本客户端不存在的情况。

二、主要功能

1. 自动扫描

   进入游戏后自动完成一次扫描，结果保存在插件存档中， 本次游戏期间随时可用，无需小退。换客户端或客户端 更新后，可手动重新扫描刷新清单。

2. 游戏内浏览窗口

   输入斜杠命令/KPAPI打开，窗口内包含：

   分类：在全局函数、C_ 命名空间、控件方法之间切换 来源：选定具体某个命名空间或控件类型 搜索：输入关键词即时筛选，不区分大小写 列表：虚拟滚动，接口数量再多也不卡顿 复制：点击任意接口名，弹出复制框，可直接复制

3. 底部信息栏

   显示客户端版本号和构建号（自动识别，换端自动更新） 显示接口总数和当前筛选结果数量 标注点击复制提示

4. 鼠标提示框架信息

   设置里勾选开启后，把鼠标停在游戏内任意框架上，会显示该框架的以下信息：

   框架名称（匿名框架会单独标注） 控件类型 可见状态（可见、父级被隐藏、已隐藏、鼠标是否禁用） 尺寸和缩放 所在层级和层内序号 子框架数量和区域数量 已挂载的脚本（如 Click、Event、Update、Enter 等） 贴图路径（悬停贴图时） 文字内容和字号（悬停文字时） 该类型可用的方法数量和部分方法预览 悬停可交互的 WeakAuras 框架时显示光环名称

   点击提示框可直接打开浏览器并定位到该类型的完整 方法列表。提示位置会根据鼠标所在屏幕区域自动选边， 不遮挡被悬停的图标和系统自带提示。

5. 游戏设置界面集成

   按 ESC 打开选项，在插件列表里可以找到 KP_API 浏览器， 里面可以直接打开浏览窗口、重新扫描接口、开关鼠标提示功能。 勾选框状态和实际功能始终保持一致。

6. 多语言

   界面语言自动跟随客户端，简体中文、繁体中文显示中文， 其他语言显示英文。接口名本身是代码标识符，不翻译。

7. 多版本兼容

   随附多个版本的描述文件，自动适配正式服、熊猫人、 大灾变、巫妖王、经典旧世、燃烧的远征等客户端， 时光服归入巫妖王版本支持。界面代码对新旧两套设置 系统、新旧提示框模板等差异都做了运行时适配。

8. 扫描结果可喂给 AI 辅助写插件

   扫描得到的是你这个客户端真实存在的完整接口清单， 把它提供给 AI（例如对话式编程助手）后，AI 写出的 插件代码就能严格按照本客户端的接口来，不会再凭 通用资料写出本客户端不存在或参数不同的函数， 尤其适合魔改客户端、私服、时光服这种官方文档 对不上的环境。

   使用方法：

   第一步 小退到人物选择界面或完全退出游戏， 让扫描结果写入存档文件 第二步 打开游戏目录下的 WTF\Account\你的账号\SavedVariables KP_ApiDumper.lua 第三步 把这个文件的内容发给 AI，并说明这是该 客户端的全量原生 API 清单，让 AI 基于它 编写或修改插件

   文件里还带有客户端版本号和构建号，AI 可以一并 确认接口来源。日常临时查接口则不需要小退， 直接在游戏内窗口搜索复制即可。

三、斜杠命令一览

/KPAPI 打开 API 浏览窗口 /apidump 立即重新扫描全部接口 /kphover 开关鼠标悬停框架提示

斜杠命令不区分大小写。

四、使用建议

1. 第一次安装需完全退出游戏再登录，让插件加载。
2. 进游戏等几秒钟扫描完成后即可使用。
3. 平时想查接口，输 /KPAPI，按关键词搜索。
4. 研究某个界面按钮或框架是什么、有什么方法时， 输 /kphover 开启悬停提示，鼠标移上去查看。
5. 客户端大更新后，在设置面板点重新扫描接口即可。

五、数据保存

扫描结果和功能开关保存在角色账号的插件存档中：

KP_ApiDumper 扫描到的接口数据 KP_ApiDumperCfg 功能开关设置

关闭鼠标提示功能时，插件不做任何持续监控，不产生 额外性能开销。

扫描结果在小退或退出游戏时写入 KP_ApiDumperDB.lua， 该文件可以直接发给 AI，用于让 AI 按本客户端的真实 接口编写插件，具体方法见上文第二部分第 8 条。

============================================================