核心用法
wow 是一款面向《魔兽世界》玩家的命令行数据查询工具，通过调用 Raider.io API 获取角色的大秘境（Mythic+）评分、最佳通关记录、团队副本进度及装备等级。基础功能无需认证，即装即用；高级功能可选接入 Blizzard API（角色详细信息、成就）与 Warcraft Logs API（战斗日志、伤害百分位）。
典型工作流：
wow lookup <角色名>-<服务器>— 完整角色档案（M+分数、最佳通关、团本进度、装等）wow search <角色名>-<服务器>— 单行快速摘要wow affixes— 本周大秘境词缀wow top-runs— 赛季顶尖通关记录
进阶功能（需OAuth2）：
wow armory— 调用Blizzard API获取详细装备、属性、角色渲染图wow parses— 调用Warcraft Logs API获取团本战斗解析与百分位排名
显著优点
1. 开箱即用：Raider.io 数据源免费、稳定、无速率限制，满足90%查询需求
2. 多区域支持：US/EU/KR/TW 四大区域，自动处理服务器名称格式（空格转连字符、去除撇号）
3. 灵活输出：--raw 标志配合 jq 支持程序化数据提取，方便脚本集成
4. 渐进式认证：核心功能零配置，高级功能按需申请 API 密钥
潜在局限
- 数据源依赖：Raider.io 覆盖范围以欧美为主，国服角色数据可能不完整或缺失
- 功能边界：不提供实时游戏内数据，仅展示已收录的公开记录
- 认证门槛：Blizzard/Warcraft Logs 的 OAuth2 配置对非技术用户有一定复杂度
- 无历史对比：不支持跨赛季分数趋势分析（需自行抓取
--raw数据二次处理）
适合人群
- 大秘境/团本玩家快速自查或查队友历史表现
- 公会招募官批量筛选申请者
- 数据爱好者构建个人 WoW 数据看板
- 内容创作者获取实时榜单素材
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API 密钥泄露 | Blizzard/WCL 密钥存储于本地环境变量或明文配置文件 | 使用 `~/.config/wow/config.env` 并设置600权限，避免提交至版本控制 |
| 速率限制 | Blizzard API 有调用上限，WCL 严格限流 | 生产环境添加指数退避重试逻辑 |
| 数据隐私 | 查询结果可能暴露玩家游戏习惯与在线时段 | 仅用于公开数据查询，不存储敏感信息 |
| 第三方依赖 | Raider.io 服务中断将直接影响核心功能 | 关注[官方状态页](https://raider.io)，关键场景启用 `--raw` 本地缓存 |