🛡️ 守望先锋 2 国服英雄数据 [✅PASS]
当前功能版本： v2.7.1
从暴雪国服官方英雄榜获取统计数据，并生成英雄排行榜或单英雄分段趋势图。
本功能查询的是英雄整体统计数据，不是某位玩家的个人战绩。
🚀 快速开始
查看默认排行榜
@bot ow数据
默认查询：
- 竞技模式；
- 所有分段；
- 所有职责；
- 按胜率排序。
查看指定条件排行榜
@bot ow数据 宗师 输出
查看单个英雄的分段趋势
@bot ow数据 源氏
@bot表示艾特需要使用的机器人。
⌨️ 命令格式
英雄排行榜
@bot ow数据 [模式] [分段] [职责] [排序]
各参数顺序不限，也不需要全部填写。插件会自动识别消息中的有效条件。
单英雄趋势
@bot ow数据 [英雄名]
用于查看指定英雄在不同竞技分段中的胜率、出场率、禁用率和 KDA。
🎮 可用查询条件
游戏模式
| 类型 | 可识别关键词 |
|---|---|
| 竞技模式 | 竞技、排位、天梯、上分 |
| 快速模式 | 快速、休闲、娱乐、匹配 |
不填写模式时，默认使用竞技模式。
分段
可查询：
青铜、白银、黄金、白金、铂金、钻石、大师、宗师、冠军
白金 和 铂金 会被视为同一分段。
不填写分段时，默认查询所有分段。
“冠军”分段是否有足够数据，取决于暴雪国服官方接口和当前样本量。
职责
| 职责 | 可识别关键词 |
|---|---|
| 重装 | 重装、坦克、T |
| 输出 | 输出、C |
| 支援 | 支援、辅助、奶 |
| 全部职责 | 所有、全部 |
排序方式
| 排序 | 说明 |
|---|---|
胜率 | 按胜率从高到低排序，默认方式 |
出场 | 按出场率或热度排序 |
禁用 | 按禁用率排序 |
KDA | 按 KDA 排序 |
📊 常用示例
| 命令 | 查询内容 |
|---|---|
@bot ow数据 | 所有分段、所有职责的竞技模式胜率榜 |
@bot ow数据 宗师 输出 | 宗师分段输出英雄排行 |
@bot ow数据 钻石 坦克 禁用 | 钻石分段重装英雄禁用率排行 |
@bot ow数据 快速 支援 | 快速模式支援英雄数据榜 |
@bot ow数据 休闲 KDA | 快速模式全部英雄 KDA 排行 |
@bot ow数据 冠军 | 冠军分段英雄胜率榜 |
@bot ow数据 源氏 | 查看源氏在各竞技分段的数据趋势 |
@bot ow数据 安娜 | 查看安娜在各竞技分段的数据趋势 |
@bot ow数据 斩仇 | 查看斩仇在各竞技分段的数据趋势 |
参数顺序不限，例如下面两条命令表达的条件相近：
@bot ow数据 钻石 坦克 禁用
@bot ow数据 禁用 钻石 重装
🖼️ 返回图片怎么看
排行榜图片通常包含：
- 年份、赛季编号和赛季名称；
- 游戏模式、分段、职责和排序方式；
- 英雄头像与中文名称；
- 胜率；
- 出场率；
- 竞技模式下的禁用率；
- KDA；
- 官方数据更新时间；
- 数据来源说明。
快速模式不显示禁用率。
查询单个英雄时，会生成该英雄在青铜至冠军等不同竞技分段中的数据趋势图。某个分段显示 -，通常表示官方接口没有返回该英雄在该分段的有效数据。
缺少某位新英雄的本地头像时，图片会使用文字占位，不会影响英雄数据查询。
📅 赛季与数据更新时间
插件会自动检查暴雪国服接口中最新的有效赛季，不再依赖手工修改赛季编号。
图片标题会显示类似：
守望先锋国服 2026 第3赛季·龙潭虎穴
并在图片底部显示类似：
数据更新：2026-07-24 · 来源：暴雪国服官方英雄榜
这里的“第 3 赛季”指当前编号体系下的赛季，并不一定与往年曾使用过的同名赛季编号相同。判断数据是否新鲜时，应以图片中的年份、赛季名称和数据更新时间为准。
当官方开放新赛季并提供有效数据后，插件会自动切换到新的赛季。若新赛季接口尚未准备好，则继续使用最近一个仍有有效数据的赛季。
⏱️ 数据缓存
插件会对相同查询缓存约 30 分钟，以减少对官方接口的重复请求。
因此，短时间内重复查询同一条件时，结果可能保持不变。缓存到期后，插件会重新请求官方数据。
赛季检测结果也会暂时缓存，避免每条命令都重复探测官方接口。
⚠️ 使用注意
- 数据来自暴雪国服官方英雄榜，仅适用于国服英雄统计。
- 查询结果会受到段位样本量影响，极少量样本可能产生异常高或异常低的数值。
- 部分英雄或分段可能暂时没有数据。
- “冠军”分段有时只包含少量英雄。
- 本功能不提供玩家个人战绩查询。
- 外部接口维护、超时或网络异常时，机器人会返回对应错误提示。
- 官方接口的数据结构或规则变化后，功能可能需要再次适配。
❓ 常见问题
为什么图片显示“第 3 赛季”，是不是很久以前的数据？
不一定。守望先锋可能在不同年份使用过相同的赛季编号。请同时查看图片中的年份、赛季名称和“数据更新”日期，不要只根据 S3 或“第 3 赛季”判断新旧。
为什么排行榜中的某个英雄数值很夸张？
可能是该分段样本量很少。插件只负责展示暴雪国服官方接口返回的数据，不会自行修正胜率、出场率或 KDA。
为什么某个英雄或分段显示 -？
表示官方接口没有返回该英雄在该分段的有效数据，常见原因是样本不足或暂时没有统计记录。
为什么查询结果和刚才一样？
相同条件会缓存约 30 分钟，短时间内重复查询可能直接使用缓存。
为什么没有英雄头像？
较新的英雄可能暂时没有本地头像资源。插件会显示文字占位，数据本身仍可正常查询。
为什么机器人提示接口维护或请求超时？
这是暴雪国服官方接口或服务器网络的临时状态，并不代表命令格式错误。稍后重新查询即可。
能查询自己的个人战绩吗？
不能。本功能查询英雄整体排行榜和不同分段的英雄统计，不查询玩家账号或个人战绩。
📎 项目来源
本功能改编自开源插件 astrbot_plugin_ow_hero_stats。
