用途：使用免费的 TVmaze 公共 API 监控喜爱的电视/流媒体剧集，构建个人追剧清单与每日播出提醒。无需 API 密钥，数据许可为 CC BY-SA，需署名 TVmaze 并链接回剧集/单集 URL。
主要能力：搜索剧集（/search/shows，需人工确认，避免同名误加）、查看剧集详情与单集列表、按国家或流媒体查询播出日程、维护收藏清单（添加/列出/移除）、输出今日与未来 N 天播出信息、以 check 命令作为定时任务入口（有播出才输出，无则静默）。
使用方式：附带仅依赖 Python 3 标准库的 CLI：python skills/tvmaze-series-tracker/scripts/tvmaze_tracker.py <command>。常用命令包括 search "Severance" --limit 5、show 44933、list、add 44933 --nick "Severance"、remove 44933、today、upcoming --days 14、check。可选环境变量：TVMAZE_STATE_DIR（状态目录，默认 ./.tvmaze-state）、TVMAZE_TZ_OFFSET（默认 -3，用于“今天”与本地时间）、TVMAZE_USER_AGENT。状态文件为 shows.json 与 alerts.json（用于去重）。
添加流程：先搜索，展示海报、年份、状态、平台、类型、简介与 TVmaze 链接，明确询问确认后才写入状态，禁止仅凭单次搜索结果自动添加。
适用场景：个人追剧清单、每日播出提醒、cron/systemd/GitHub Actions/launchd 等调度器集成。
限制：API 无鉴权，速率约每 IP 每 10 秒至少 20 次请求，429 需退避；边缘缓存约 60 分钟；同名剧集常见需确认；流媒体 airtime 可能为空，脚本回退用 airstamp 加时区偏移；未来季播出日期可能缺失，upcoming 为空属正常；默认单集列表不含特别篇；需设置描述性 User-Agent 并保留来源署名。