pogo-pvp — PvP（玩家对战玩家）跳跃游戏

PoGo-PvP — Pokémon GO PvP 培养查询 v1.1 数据源：PvPokeTW（pvpoketw.com）→ 翻译自 PvPoke，排行 JSON 拉取自 pvpoke/pvpoke GitHub raw，gamemaster 含宝可梦基础种族值与类型。

命令：/pvp 培养 <宝可梦> <联盟> [攻击/防御/生命] 参数：

• 宝可梦：玛力露丽 / 水兔子 / azumarill（支持中文/英文/别名）
• 联盟：1500 / 超级联盟 / master / 大师（自动识别简写）
• IV（可选）：1/15/10 / 0/15/15（攻击/防御/HP 各 0~15）

输出字段（无用户 IV）：

• 字段：来源，说明
• 宝可梦：speciesId → 中文映射，本地字典
• 联盟：参数解析，自动识别
• PvPokeTW排名：数组 index + 1，PvPoke 排行
• 评分：score，PvPoke 综合评分 0~100
• 属性：gamemaster，类型中文（如 [水][妖精]）
• 推荐招式：moveset，官方推荐配置（中文）
• 最佳 IV：IV 计算，4096 种组合中排名第 1
• 最佳 CP：IV 计算，对应最佳 IV 的 CP
• 最佳等级：IV 计算，对应最佳 IV 的等级（支持半级）
• 精英TM：暂无准确数据
• 招式池：fastMoves / chargedMoves，全部可用招式
• 对战分析：matchups / counters，前 5 条
• 数据来源：PvPokeTW
• 更新时间：UTC

输出字段（有用户 IV）：

• 新增对比块：

- 字段：说明 - 我的 IV：用户输入的 IV 组合 - 我的 CP：该 IV 在联盟限制下的 CP - 我的等级：该 IV 升级到的等级 - 我的 IV 排名：在前 50 内显示排名，否则「未进入前 50」 - 差别：最佳 IV - 用户 IV 的各维差值 - 最佳 IV：0/13/14

示例：

• 宝可梦：弃世猴
• 联盟：超级联盟
• PvPokeTW排名：#28
• 评分：90.1
• 属性：[格斗][幽灵]
• 推荐招式：踢倒 + 愤怒之拳 + 近身战
• 最佳 IV：0/13/14
• 最佳 CP：1500
• 最佳等级：17
• 精英TM：暂无准确数据
• 我的 IV：1/15/10
• 我的 CP：1455
• 我的等级：16.5
• 我的 IV 排名：未进入前50
• 差别：攻击 -1，防御 -2，生命 4
• 最佳 IV：0/13/14

规则：

• 不显示乘积
• 不计算乘积
• 不显示百分比接近度
• 不用乘积判断好坏
• IV / CP / 等级只能来自 PvPokeTW 真实数据
• 查不到就显示「暂无准确数据」
• 不允许模拟、不允许随机、不允许补编

数据管理：

• 拉取/刷新所有联盟缓存：python scripts/fetch_pvpoke.py --league 1500
• gamemaster 自动在查询时拉取，过期自动刷新
• 手动测试：node dist/index.js 弃世猴 1500

缓存策略：

• 缓存目录：cache/
• rankings TTL：7 天
• gamemaster TTL：7 天
• 过期自动回退网络拉取
• 无缓存也拉不到 → 提示

IV 计算原理：

• IV 排序来源于 PvPokeTW 数据，不保证所有联盟字段完整
• 对所有 4096 种 IV 组合：找到每个组合在 CP ≤ 联盟限制下的最高等级
• 内部排序参考原始数据字段
• 取前 50 名

数据字典：

• 详见 data/ 目录：pokemon_alias.json — 中文俗称/别名 → speciesId
• src/mapper.ts — speciesId / moveId → 中文名

限制：

• 所有数据来自 PvPoke/PvPokeTW 真实数据源
• IV/CP/等级均为真实可信计算结果
• 不输出乘积、不对比乘积、不显示接近度
• 不猜 XL 糖需求（gamemaster 不含 XL 关联字段）
• 不生成截图/OCR/组队

扩展计划（v1.2+）：

• elite_moves.json 白名单 → 精英TM 判断
• 中文名全覆盖（800+ speciesId）
• 属性相性 / 招式属性补充
• 支持 XL 糖提示（需 PoGo API 或用户输入等级）