Game Light Tracker

自动将 Hue 灯光与实时体育赛事比分同步。当领先方发生变化时，灯光颜色将随之切换为当前领先队伍的代表色。

快速开始

基础用法：

追踪 [队伍 A] 与 [队伍 B] 的比赛，并在 [队伍 A] 领先时将我的 [灯名称] 设为 [颜色1]，在 [队伍 B] 领先时设为 [颜色2]

示例：

• “追踪 Rams 与 Seahawks 的比赛，在 Rams 领先时将我的背光灯设为蓝色，Seahawks 领先时设为绿色”（NFL）
• “监控 Lakers 与 Celtics 的比赛，Lakers 用紫色，Celtics 用绿色”（NBA）
• “观看 Rangers 与 Devils 的比赛 — Rangers 用蓝色，Devils 用红色”（NHL）
• “追踪 Yankees 与 Red Sox 的比赛，将我客厅灯设为 Yankees 的蓝色、Red Sox 的红色”（MLB）

工作原理

1. 每 20 秒通过 ESPN API 获取实时比分
2. 检测领先方变化
3. 通过 Home Assistant 更改指定 Hue 灯的颜色
4. 内置自动重启守护进程（keeper），防止因超时导致崩溃
5. 可选：为平局状态添加第三种颜色

配置要求

• 已配置 Hue 灯光的 Home Assistant 实例
• Home Assistant API token（存储于 .homeassistant-config.json 文件中）
• Home Assistant 中对应灯的 entity ID

脚本说明

game-tracker.ps1

主监控脚本，用于追踪特定比赛并更新灯光状态。

用法：

.game-tracker.ps1 -Sport "nfl" -Team1 "LAR" -Team2 "SEA" -Light "light.backlight" -Color1 "0,0,255" -Color2 "0,100,0" [-TiedColor "255,0,0"]

参数说明：

• -Sport：支持 "nfl"、"nba"、"nhl" 或 "mlb"
• -Team1：第一支队伍的缩写
• -Team2：第二支队伍的缩写
• -Light：Home Assistant 中灯的 entity ID
• -Color1：Team1 对应的 RGB 颜色（逗号分隔，例如 "0,0,255" 表示蓝色）
• -Color2：Team2 对应的 RGB 颜色（逗号分隔，例如 "0,100,0" 表示深绿色）
• -TiedColor：（可选）平局时使用的 RGB 颜色

keeper.ps1

自动重启守护脚本，防止运行 30 分钟后因超时而崩溃。

用法：

.keeper.ps1 -TrackerScript "game-tracker.ps1" -RestartInterval 25

参数说明：

• -TrackerScript：game-tracker.ps1 脚本的路径
• -RestartInterval：重启间隔（单位：分钟，默认为 25）

常用队伍缩写

NFL：

• Rams：LAR，Seahawks：SEA，Chiefs：KC，Bills：BUF，Patriots：NE
• Cowboys：DAL，Eagles：PHI，49ers：SF，Packers：GB，Bears：CHI
• [完整列表：https://www.espn.com/nfl/teams]

NBA：

• Lakers：LAL，Celtics：BOS，Warriors：GS，Knicks：NY，Bulls：CHI
• Heat：MIA，Nets：BKN，76ers：PHI，Bucks：MIL，Mavericks：DAL
• Nuggets：DEN，Suns：PHX，Clippers：LAC，Raptors：TOR
• [完整列表：https://www.espn.com/nba/teams]

NHL：

• Rangers：NYR，Devils：NJ，Bruins：BOS，Maple Leafs：TOR，Canadiens：MTL
• Penguins：PIT，Capitals：WSH，Flyers：PHI，Lightning：TB，Panthers：FLA
• Red Wings：DET，Blackhawks：CHI，Avalanche：COL，Golden Knights：VGK
• [完整列表：https://www.espn.com/nhl/teams]

MLB：

• Yankees：NYY，Red Sox：BOS，Dodgers：LAD，Giants：SF，Mets：NYM
• Cubs：CHC，Cardinals：STL，Astros：HOU，Braves：ATL，Phillies：PHI
• [完整列表：https://www.espn.com/mlb/teams]

常用 RGB 颜色值

• 蓝色（Blue）：0,0,255
• 红色（Red）：255,0,0
• 绿色（Green）：0,255,0
• 深绿色（Dark Green）：0,100,0
• 橙色（Orange）：255,165,0
• 紫色（Purple）：128,0,128
• 黄色（Yellow）：255,255,0
• 白色（White）：255,255,255

工作流程

当用户请求开启比赛追踪时：

1. 识别运动项目及参赛队伍：

   • 提取运动类型（NFL/NBA/NHL/MLB）
   • 从用户输入中获取队伍缩写，或根据队伍全名查表补全

2. 获取灯光与颜色偏好设置：

   • 询问灯的 entity ID（或从 Home Assistant 配置中读取）
   • 获取各队对应的期望 RGB 颜色值
   • （可选）询问是否需为平局状态指定颜色

3. 加载 Home Assistant 配置：

   $config = Get-Content ".homeassistant-config.json" | ConvertFrom-Json
   $token = $config.token
   $url = $config.url
   

4. 启动比赛追踪器：

   .scriptsgame-tracker.ps1 -Sport "nfl" -Team1 "LAR" -Team2 "SEA" -Light "light.backlight" -Color1 "0,0,255" -Color2 "0,100,0" -TiedColor "255,0,0"
   

5. 启动 keeper 实现自动重启：

   Start-Process powershell -ArgumentList "-File keeper.ps1 -TrackerScript 'game-tracker.ps1'" -WindowStyle Hidden
   

6. 向用户确认启动成功：

   • 告知用户监控已激活
   • 如可获取，显示当前比分
   • 说明颜色映射规则
   • 告知如何停止该服务

停止追踪器

如需停止监控，请执行：

Get-Process powershell | Where-Object { $_.CommandLine -like "*game-tracker.ps1*" -or $_.CommandLine -like "*keeper.ps1*" } | Stop-Process -Force

故障排查

灯光未响应变化：

• 确认 Home Assistant token 有效
• 检查灯的 entity ID 是否正确
• 确保 Home Assistant 在配置的 URL 地址下可正常访问

脚本崩溃：

• keeper 应能自动重启脚本
• 检查 ESPN API 是否可正常访问
• 确认队伍缩写是否准确无误

队伍颜色错误：

• 再次核对 RGB 值（必须为 0–255 范围内、逗号分隔）
• 确保颜色已正确分配给对应队伍