核心功能
FargoRate 是一款专为台球竞技设计的开源 CLI 工具，集成全球权威评级系统 FargoRate，提供选手等级查询、赛事赔率计算、推荐赛制生成等核心能力。
主要用法
- 选手查询：通过
search/lookup按姓名或 ID 检索选手详细数据，包括等级分、置信度、地理位置 - 批量管理：
bulk命令支持多选手同时查询，group功能可保存常用选手组（如联赛阵容） - 赛事计算：
odds计算特定赛制下的胜负概率，races智能推荐公平的比赛局数设置 - 排名追踪：
top查看世界/美国男女选手排名 - 数据持久化：
--db启用 SQLite 本地数据库，自动追踪等级变化历史，--changes仅显示变动选手
显著优点
- 权威数据源：直接对接 FargoRate 官方 API，评级数据实时准确
- 智能赛制推荐：基于 Elo 变体算法自动计算公平 race-to 局数，解决业余赛事 handicapping 难题
- 本地隐私保护：联系信息字段（邮箱、电话、社交账号）仅存储于本地数据库，永不发送至 API
- 变更追踪自动化：适合联赛管理者监控选手等级波动，生成周期报告
局限与风险
- 功能边界：仅支持 FargoRate 体系，无法对接其他评级系统（如 APA、BCA）
- 数据完整性：依赖 FargoRate 官方数据库覆盖度，小众选手可能信息不全
- 网络依赖：除本地缓存查询外，核心功能需联网调用 API
- CLI 门槛：需命令行操作基础，无图形界面
适合人群
- 台球联赛/锦标赛组织者
- 需要公平 handicapping 的俱乐部管理者
- 追踪自身或对手等级变化的专业/半职业选手
- 开发台球相关应用的集成开发者
常规风险提示
- 本地数据库文件需妥善保管，避免选手个人信息泄露
--db模式下历史数据累积可能产生隐私合规责任- 赔率计算基于统计模型，实际比赛结果受临场状态影响较大，不宜用于博彩决策