核心功能
FargoRate 是全球最权威的台球选手等级分系统，本工具通过官方 CLI 接口提供完整的数据查询与分析能力：
选手查询：支持通过姓名或 FargoRate ID 搜索选手信息，包括等级分、临时等级分、稳健度系数及地理位置。
批量管理：bulk 命令可同时查询多名选手，--db 模式下支持创建命名分组（如 monday-league），方便联赛批量管理。
胜率计算：odds 命令基于 Elo 改进算法，输入双方等级分与 race-to 局数，输出精确胜率预测。
让局推荐：races 命令根据等级分差自动推荐公平 race-to 长度，支持单打、双打、团体三种模式，可固定总局数反向推导。
排名追踪：top 命令实时获取全球/美国男女 top 10 榜单。
变更监控：--changes 标志配合本地 SQLite 数据库，自动检测选手等级分、稳健度变化，输出 diff 格式结果，适合联赛管理员定期巡检。
显著优点
- 数据权威性：直接对接 FargoRate 官方 API，全球赛事通用标准
- 本地持久化：SQLite 数据库保存历史记录，支持跨会话变更追踪
- 分组管理：命名组功能大幅降低联赛批量查询成本
- 离线联系信息：数据库存储 email/手机号等字段（API 不返回，可手动维护），
--changes输出时自动关联 - JSON 输出：
--json支持机器可读，易于集成到 Discord/ Telegram Bot
潜在局限
- 依赖外部 CLI：需单独安装
fargo二进制，非纯 Python/JavaScript 方案 - API 限制：未提及速率限制，高频查询可能触发风控
- 联系人字段隔离：email/telegram 等字段仅本地存储，无法与 FargoRate 账户体系同步
- 性别二元分类：
--gender M|F未涵盖非二元选项
适合人群
- 台球联赛组织者（需批量监控选手等级变化）
- 赛事裁判/ handicap 管理员（需计算公平让局）
- 职业/半职业选手（追踪自身排名与对手数据）
- 博彩/数据分析爱好者（胜率建模数据来源）
常规风险
- 数据隐私：本地数据库存储选手联系信息，需自行保障文件权限安全
- 版本漂移：CLI 与 skill 版本需保持兼容，升级时需同步验证
- API 可用性：FargoRate 服务中断将导致全功能失效