World Cup Calendar

能力

使用 scripts/world_cup_calendar.py 读取内置赛程数据，并把比赛转换成飞书日程。

默认规则：

• 使用北京时间 Asia/Shanghai。
• 导入全部 104 场比赛，包含已经过去的比赛。
• 每场比赛默认 2 小时。
• 创建或使用名为 world-cup-calendar 的飞书日历。
• 日历权限为私密，日程 visibility=private。
• 日程忙闲状态为 free，不阻塞同事预约会议。
• 普通比赛不提醒。
• 关注球队默认 ARG，即阿根廷；关注球队比赛提前 1440 分钟提醒。

赛程数据在 references/fwc2026-schedule.json。来源为 FIFA 官方赛程 PDF，原始时间为 Eastern Time，脚本已换算为北京时间。FIFA 标注赛程可能调整，执行前如果用户要求最新信息，需要重新核对官方来源。

常用命令

先检查环境：

python3 scripts/world_cup_calendar.py doctor

如果没有安装飞书 CLI，可以让脚本尝试安装：

python3 scripts/world_cup_calendar.py doctor --install-cli

先预览赛程，不访问飞书：

python3 scripts/world_cup_calendar.py preview --focus-team ARG --limit 12

预览将写入飞书的日程内容，不真正创建：

python3 scripts/world_cup_calendar.py sync --focus-team ARG

确认无误后真正创建飞书日程：

python3 scripts/world_cup_calendar.py sync --focus-team ARG --execute

只同步关注球队比赛：

python3 scripts/world_cup_calendar.py sync --focus-team ARG --only-focus --execute

关注多个球队时用英文代码逗号分隔：

python3 scripts/world_cup_calendar.py sync --focus-team ARG,BRA,FRA --execute

删除日程

删除命令默认只预览，不真正删除。确认输出无误后，才加 --execute。

按比赛编号删除，例如删除阿根廷三场小组赛：

python3 scripts/world_cup_calendar.py delete --match-numbers 19,43,70
python3 scripts/world_cup_calendar.py delete --match-numbers 19,43,70 --execute

支持区间写法：

python3 scripts/world_cup_calendar.py delete --match-numbers 19-21

删除整套世界杯日程，也就是 104 场比赛：

python3 scripts/world_cup_calendar.py delete --all
python3 scripts/world_cup_calendar.py delete --all --execute

如果确定整个 world-cup-calendar 日历都不要了，可以删除日历本身：

python3 scripts/world_cup_calendar.py delete --delete-calendar
python3 scripts/world_cup_calendar.py delete --delete-calendar --execute

删除逻辑会先在目标日历中搜索“世界杯”，再匹配描述里的 FWC2026-xxx 比赛编号，只删除本 Skill 创建的世界杯日程。

飞书权限

执行 --execute 前，确认本机有 lark-cli，并使用用户身份授权日历权限。缺少权限时，脚本会输出 lark-cli 给出的中文提示或授权命令。

安装飞书 CLI：

npm install -g @larksuite/cli

如果用户没有 Node.js/npm，先安装 Node.js LTS：https://nodejs.org/

通常需要这些 scope：

• calendar:calendar:read
• calendar:calendar:create
• calendar:calendar.event:create
• calendar:calendar.event:delete
• calendar:calendar:delete（只有删除整个日历时需要）

授权示例：

lark-cli auth login --scope "calendar:calendar:create"
lark-cli auth login --scope "calendar:calendar.event:create"

隐私说明

本 Skill 同时处理两件不同的事：

• visibility=private：别人看不到日程详情。
• free_busy_status=free：这段时间不会显示为忙碌。

不要把 free_busy_status 改成 busy，除非用户明确希望世界杯比赛占用自己的工作忙闲时间。

淘汰赛占位

淘汰赛在官方赛程中会出现 1J、2H、W85、3 EFGIJ 等占位：

• 1J 表示 J 组第 1 名。
• 2H 表示 H 组第 2 名。
• W85 表示第 85 场胜者。
• 3 EFGIJ 表示 E/F/G/I/J 组第三名之一。

小组赛结束后，如果用户想把占位更新成真实球队，需要先核对 FIFA 官方结果，再更新 references/fwc2026-schedule.json 或重新生成数据。