玩家查询助手

WhoSearch 玩家查询助手

WhoSearch 是一款专为《魔兽世界》玩家打造的查询辅助插件，旨在提升社交查找与批量联络效率。插件以简洁高效的界面集成于游戏自带的社会关系面板（快捷键 O），玩家无需切换窗口即可完成多条件玩家查询与批量悄悄话发送。

插件适合用于按区域、种族、职业、等级等条件查找在线玩家，并对搜索结果进行勾选、过滤、黑名单管理和批量悄悄话发送。

主要功能

多条件玩家查询

• 阵营适配：根据当前角色阵营显示对应的区域与种族选项。
• 区域筛选：支持从内置区域列表选择，也可以直接输入区域名称。
• 种族筛选：支持按当前阵营可用种族筛选。
• 职业筛选：支持按职业查询玩家。
• 等级范围：支持设置最低等级和最高等级；如果最低等级大于最高等级，插件会自动交换范围。
• 无条件查询：区域、种族、职业留空时，将按等级范围查询所有符合条件的玩家。

查询结果管理

• 结果列表：查询结果以勾选列表展示，显示玩家等级、姓名和职业。
• 自动排除自己：查询结果不会显示当前角色自己。
• 去重合并：多次查询返回的玩家会合并到当前结果中，避免重复显示。
• 全选：一键选中当前显示的全部玩家。
• 反选：反转当前显示玩家的选中状态。
• 清空：清除本次查询结果。
• 过滤提示：底部显示本次被过滤的人数，包括已发送、黑名单、职业、关键词和地区过滤。

批量悄悄话

• 独立开关：需要在设置中启用悄悄话后才会发送。
• 自定义模板：支持编辑批量发送的消息内容。
• 模板变量：

| 变量 | 说明 | 示例 |

| {name} | 目标玩家名 | 张三 |

| {level} | 目标玩家等级 | 80 |

| {player} | 当前角色名 | 我的角色 |

| {zone} | 当前查询区域 | 奥格瑞玛 |

默认模板：

你好 {name}，我是 {player}，有事找你

• 发送间隔：可设置每条悄悄话之间的等待时间，单位为秒。
• 最大发送数：限制单次最多发送的玩家数量。
• 防重复发送：默认不重复发送；开启“是否重复发送”后可再次向同一玩家发送。
• 发送状态：发送过程中按钮会显示“正在发送中....”，完成后提示实际发送人数。

发送记录

• 自动记录：每次成功发送后记录目标玩家和发送时间。
• 今日标记：当天已经发送过的玩家会在结果列表中显示“今日已密语”。
• 最近记录：主面板右侧显示最近 200 条发送记录。
• 查看全部：可打开全部发送记录窗口，按日期分组查看。
• 右键删除：右键点击单条发送记录可删除该记录。
• 清空记录：可一键清空全部发送记录。
• 搜索过滤：开启“搜索时过滤已发送玩家”后，已发送玩家会从结果列表中隐藏。

黑名单管理

• 加入黑名单：在结果列表勾选玩家后，点击“加入黑名单”即可批量添加。
• 自动过滤：开启“搜索时过滤黑名单玩家”后，黑名单玩家会从结果列表中隐藏。
• 查看黑名单：在设置面板的“黑名单管理”区域查看全部黑名单记录。
• 右键移除：右键点击黑名单记录可删除该玩家。
• 清空黑名单：一键删除全部黑名单记录。
• 导入/导出：支持将黑名单导出为文本，也可以粘贴导出的文本导入到当前角色。

高级过滤

• 已发送过滤：隐藏已经发送过悄悄话的玩家。
• 黑名单过滤：隐藏黑名单玩家。
• 职业过滤：可多选要过滤掉的职业，例如过滤术士、法师等。
• 地区过滤：可输入多个地区名称进行过滤，使用中文或英文逗号分隔。
• 关键词过滤：可按玩家名关键词过滤，支持中文逗号和英文逗号分隔。

数据与窗口

• 角色独立数据：搜索历史、发送记录、黑名单、过滤设置等按角色保存。
• 旧数据迁移：插件会尝试迁移旧版 WhoSearchDB 数据到新的账号全局角色数据结构。
• 窗口位置保存：插件面板支持拖拽移动，并会保存当前位置。
• 子窗口联动：关闭社交查询面板时，设置窗口、导入导出窗口等会自动隐藏。

使用方法

打开插件

打开社交窗口(快捷键O 键)并切换到“查询”标签页，WhoSearch 面板会显示在查询面板右侧。

也可以使用聊天命令快速打开：

/ws

/whosearch

/who

基础搜索

1. 在“区域”中选择或输入目标区域，也可以保留“不限区域”。
2. 在“种族”中选择或输入目标种族，也可以保留“不限种族”。
3. 在“职业”中选择或输入目标职业，也可以保留“不限职业”。
4. 在“等级”中填写最低等级和最高等级。
5. 点击“搜索”。
6. 查询结果会显示在“当前结果”列表中。

管理结果

• 勾选单个玩家：点击玩家名前的复选框。
• 全选当前结果：点击“全选”。
• 反转选择：点击“反选”。
• 清除结果：点击“清空”。
• 加入黑名单：勾选一个或多个玩家后点击“加入黑名单”。

配置悄悄话

1. 点击主面板右上角“设置”。
2. 勾选“启用悄悄话”。
3. 按需勾选“是否重复发送”。
4. 修改“消息模板”。
5. 设置“发送间隔(秒)”和“最大发送数”。
6. 按需开启过滤选项。
7. 点击“关闭”保存并返回主面板。

批量发送

1. 在查询结果中勾选要联系的玩家。
2. 点击“发送悄悄话”。
3. 插件会按设置的间隔依次发送。
4. 发送完成后，右侧发送记录会自动刷新。

管理发送记录

• 主面板右侧显示最近 200 条记录。
• 点击“查看全部”可按日期查看所有记录。
• 右键点击任意记录可删除该条。
• 点击“清空发送记录”可清除全部记录。

管理黑名单

1. 点击“设置”打开设置面板。
2. 在“黑名单管理”区域查看已加入黑名单的玩家。
3. 右键点击玩家记录可移除。
4. 点击“清空黑名单”可清空全部黑名单。
5. 点击“导出”可复制黑名单文本。
6. 点击“导入”可粘贴黑名单文本并导入。

注意事项

• WhoSearch 使用游戏内置查询接口，查询结果数量与刷新频率受游戏客户端限制。
• 批量悄悄话可能受到游戏反垃圾机制影响，建议设置合理的发送间隔和最大发送数。
• 插件默认会过滤已发送玩家和黑名单玩家；如果结果数量不符合预期，请检查设置面板中的过滤选项。
• 地区过滤、关键词过滤支持中文逗号“，”和英文逗号“,”分隔。
• 插件数据按角色保存，同一账号下不同角色的记录和黑名单互不混用。