olympic-alert

Olympic Alert 是一款专为 2026 年米兰-科尔蒂纳冬奥会设计的本地赛事提醒工具，采用 Python 3 标准库开发，能够在比赛开始前 15 分钟向用户发送精准通知。该 Skill 通过命令行脚本实现核心功能，支持赛事日程的添加、删除和列表查询，默认配置已包含韩国代表队赛程，同时允许用户通过修改 events.json 自定义关注任意国家或赛事。

核心用法方面，用户可通过 HEARTBEAT 机制定时执行 check_olympic.py 脚本，系统会比对当前时间与赛事表，在赛前 15 分钟输出包含国旗标识、项目名称、参赛选手及直播链接的结构化提醒文本。除了自动检测，还支持手动管理赛事：使用 add 子命令添加新赛程（如半决赛、决赛），使用 remove 命令按名称模式删除已取消或关注的赛事，状态文件自动记录已发送通知防止重复提醒。

显著优点体现在其极简架构与隐私保护上。全程仅依赖 Python 标准库（json、datetime、pathlib 等），无需安装任何第三方 pip 包，避免了依赖冲突和供应链攻击风险。所有数据（包括赛事配置和通知记录）均存储在本地文件系统（~/.config/olympic-alert/），无网络传输环节，特别适合对数据隐私敏感的用户。代码透明度高，无混淆或动态加载逻辑，可通过直接阅读 Python 源码验证安全性。

潜在局限包括来源可信度与功能边界。开发者 garibong-labs 属于 T3 级社区组织，虽经安全审查无恶意代码，但长期维护能力和代码更新频率存疑。功能上仅限于单机本地运行，无法实现跨设备同步或云端备份，且赛事数据需手动更新（如根据预赛结果添加晋级场次），对非技术用户不够友好。此外，提醒功能依赖外部 HEARTBEAT 调度机制，若宿主机休眠或定时任务中断可能导致漏提醒。

适用人群主要为关注冬奥会的技术用户和隐私敏感型体育爱好者。默认配置的韩国国旗和选手信息对韩文用户群体体验更佳，但可通过简单编辑 JSON 适配其他语言环境。适合作为个人工作流的一部分集成到自动化系统（如 Home Assistant、Cron 任务），而非面向普通消费者的独立应用。

使用风险主要集中在环境依赖与状态管理。需要确保 Python 3.6+ 环境稳定可用，状态文件损坏可能导致重复通知或通知丢失，建议定期备份 events.json。作为 T3 来源的社区项目，建议在生产环境部署前进行代码审计，并关注 GitHub 仓库的安全更新。尽管当前版本无网络行为，但未来更新若引入在线赛事数据获取功能，需重新评估隐私策略。