MLB Playoff Scheduler 是一个针对 Yahoo 梦幻棒球季后赛窗口的调度与对手质量评分工具。它解决的问题是：在梦幻季后赛三周（2026 年第 21、22、23 周，即 8 月 17 日至 9 月 6 日）里，哪些 MLB 球队比赛场次多、对手更弱，从而帮助判断某位球员在季后赛期间的持有价值。
用途 主要用于梦幻棒球的持有与交易决策支持。它生成三个信号：playoff_games 表示球队在三周窗口内的比赛总数（整数 0-21，理论上限约 21，但通常为 17-20）；playoff_matchup_quality 是 0-100 的对手质量分，50 为中性，高于 50 表示对手更弱、利于持有；holding_value 是 0-100 的综合分，按 0.6 × 场次得分 + 0.4 × 对手质量计算，用于判断持有还是交易。
主要能力
- 日期门槛检查：运行日期早于 2026-07-01 时，直接输出空值信号（三个字段均为 null）、confidence 为 0.0，并提示“信号不足——过早”。2. 定义三个季后赛周窗口（周一至周日）。3. 为每支 MLB 球队拉取三周赛程并统计每周场次，输出 30 行球队网格。4. 对每个对手进行评分：打者视角使用对手投手群的 wOBA allowed，投手视角使用对手打线对本投手惯用手的 wOBA。5. 计算 volume-weighted 的 playoff_matchup_quality。6. 计算 holding_value 并将球队分数映射到已入名单球员。7. 输出 signals/YYYY-MM-DD-playoff.md 信号文件并进行模式校验。
使用方式 流程共 9 步：检查日期门槛、定义三个周窗口、拉取各队赛程、统计每周场次、评分对手、计算对手质量分、计算 holding_value、映射到球员、输出并校验。赛程数据来源为 MLB.com 赛程页面与 FanGraphs 球队赛程页面，要求为每个数据点引用 URL。核心公式包括：playoff_games = 三周场次之和；打者 playoff_matchup_quality = 100 - (平均对手投手群 wOBA allowed - 0.300) × 1000（钳制在 0-100，联盟平均约 0.320 对应约 80 分）；投手使用对手打线对本投手惯用手的 wOBA；volume_score = (playoff_games / 21) × 100；holding_value = 0.6 × volume_score + 0.4 × playoff_matchup_quality。需要输入运行日期，可选输入名单列表以限定输出范围，否则输出全部 30 支球队。
适用场景 适用于梦幻棒球交易截止日前的持有/交易分析（例如判断某球员在季后赛三周是否值得保留），以及季后赛周的阵容安排（如 playoff_games 少于 14 的先发可考虑放板凳）。下游工具 mlb-trade-analyzer 使用 holding_value 评估交易双方，mlb-playoff-planner 使用 playoff_games 标记先发与板凳决策。
限制 7 月 1 日之前只能返回空信号，不做预计算，原因是交易、轮值与伤病等赛程波动会使季前预测不可靠。50 分始终代表中性对手强度。所有 URL 必须引用，缺少来源的信号 confidence 不高于 0.3。双赛日计 2 场，部分抓取源会合并需交叉核对。对手 wOBA 需按惯用手区分。使用截至运行日期的赛季实际 wOBA，不做预测。比赛上限约 21 场而非恰好 21 场，典型范围为 17-20。holding_value 不等于交易市场价值。7 月 1 日后需每周重新运行以反映赛程与阵容变化。