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	排名第 1 的 IV 组合

示例

宝可梦：弃世猴
联盟：超级联盟
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
python scripts/fetch_pvpoke.py --league 2500
python scripts/fetch_pvpoke.py --league master

# gamemaster 自动在查询时拉取，过期自动刷新

# 手动测试
node dist/index.js 弃世猴 1500
node dist/index.js 弃世猴 1500 1/15/10
node dist/index.js --test

缓存策略

缓存目录：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 或用户输入等级）

Pogo Pvp

安装技能