核心功能
fargorate 是一款面向台球运动的专业数据查询工具，基于全球公认的FargoRate官方评级系统，为台球爱好者、联赛组织者和赛事裁判提供全面的球员数据服务。核心功能涵盖：
- 球员查询：通过姓名或FargoRate ID快速检索球员信息，支持单条查询与批量查询
- 比赛分析：计算两位选手的对战胜率（odds），并根据评分差异推荐公平的比赛局数（race-to）
- 排名追踪：查看全球或美国地区男女选手TOP10排行榜
- 本地数据管理：可选启用SQLite数据库，持久化存储球员数据，追踪评分与稳健度（robustness）的历史变化
显著优势
1. 权威数据源：直接对接FargoRate官方数据库，评分数据实时、准确
2. 赛事实用性：odds与races命令为 handicap 赛制提供数学依据，提升比赛公平性
3. 本地化隐私保护：联系信息（邮箱、电话、社交账号）仅存储于本地数据库，不上传至任何API
4. 变化追踪：--changes 标志可高效筛选出评分变动的球员，适合联赛管理员定期监控选手状态
5. 分组管理：支持创建命名球员组（如"monday-league"），简化重复查询流程
局限性与注意事项
- 依赖外部CLI：需安装fargo二进制工具，存在额外的安装与维护成本
- 数据覆盖范围：仅限于FargoRate体系内的球员，未注册选手无法查询
- 本地数据库风险：虽然联系字段本地存储，但数据库文件本身无加密，需注意文件系统安全
- API依赖：核心功能依赖FargoRate官方API的可用性与稳定性
适合人群
- 台球联赛/锦标赛组织者（需要 handicap 计算与选手监控）
- 职业或业余台球选手（追踪自身及对手评分变化）
- 赛事博彩分析者（基于官方数据计算赔率）
- 台球数据分析爱好者
常规风险
- 数据准确性：评分延迟或API同步问题可能导致查询结果非实时
- 隐私合规：本地存储的联系信息需使用者自行确保符合 GDPR 等数据保护法规
- 工具链维护：CLI工具的版本兼容性、安装脚本的来源可信度需定期审查