核心功能与用法
Yahoo Fantasy Baseball 是一个专为梦幻棒球（Fantasy Baseball）玩家设计的 CLI 工具，通过 Yahoo Fantasy Sports API 提供全面的联盟数据查询和智能阵容优化功能。用户可通过 roster、today、optimize 等命令查看当前阵容、每日比赛状态，并获取基于约束求解器的最优阵容建议。
核心命令覆盖四大场景：
- 数据查询：
standings、matchup、players、draft、transactions查看联盟排名、对战、球员池、选秀结果和交易记录 - 每日管理：
today/day按 MLB 赛程展示活跃/休息/伤病球员；lineup-check交叉校验确认 MLB lineup，标记被剔除或轮休球员 - 智能优化：
optimize运用线性规划求解最优打者和投手轮换，支持 preseason rank 混合算法（赛季前4周逐步降低 preseason 权重） - 输出格式：支持
text（人类可读）、json（结构化数据）、discord（代码块格式）三种输出
显著优点
1. 智能约束求解：不同于简单按分数排序，该工具使用位置感知约束求解器处理复杂位置连锁（如 UTIL→1B 的连锁调整），并尊重 Yahoo 的 roster 锁定规则
2. MLB 实时数据整合：直接对接 MLB Stats API 获取确认 lineup 和 probable starters，避免启动已确认轮休的球员
3. preseason rank 混合机制：赛季初期自动混合 Yahoo preseason 排名，防止因小样本过度反应（如明星球员 0-for-8 被错误 bench）
4. 详尽的伤病与状态追踪：区分 IL/IL10/IL15/IL60/DTD 多种状态，optimize 会建议 IL slot 调整但排除 DTD（Yahoo 限制）
潜在缺点与局限性
- 只读限制：无法直接修改阵容，所有建议需手动在 Yahoo 网站/App 执行
- API 速率限制：Yahoo Fantasy API 有调用频次限制，快速连续查询可能触发限流
- OAuth 依赖：需创建 Yahoo Developer App 并维护 token，token 过期需重新认证
- MLB 数据延迟：确认 lineup 通常在赛前 1-3 小时发布，过早运行
lineup-check可能无数据 - preseason rank 数据源：依赖 Yahoo 的 preseason overall rank（OR），若 Yahoo 排名更新滞后可能影响早期优化质量
适合人群
- 竞技型梦幻棒球玩家：需要每日 lineup 优化和伤病管理的 head-to-head 联赛玩家
- 数据驱动决策者：希望基于实时 MLB lineup 和统计模型（而非直觉）做阵容调整的用户
- 多联盟管理者：支持多 league/team 配置，适合同时参与多个联盟的深度玩家
常规风险
1. OAuth 凭证安全：Consumer Key/Secret 和 token 存储于本地 ~/.openclaw/credentials/yahoo-fantasy/，文件权限设为 0600 但仍存在本地泄露风险
2. lineup-check 误报/漏报：仅标记"已发布 lineup 且球员不在其中"的情况，赛前临时 scratch 可能错过窗口
3. preseason 权重主观性：混合算法固定为 Weeks 1-2 全权重、Weeks 3-6 线性递减，可能不完全匹配个人风险偏好
4. 依赖外部 API 稳定性：MLB Stats API 非官方 Yahoo 服务，存在变更或不可用风险