"""麦麦日历助手 — 命令行入口。 用法: python src/cli.py query # 查询当月麦当劳活动 python src/cli.py query --date 2026-11-01 # 查询指定日期附近的活动 python src/cli.py query --filter 联名,新品 # 按关键词订阅过滤 python src/cli.py sync # 同步到 macOS 日历(智能提醒) python src/cli.py sync --filter 优惠券 --remind-days 2 python src/cli.py export -o events.ics # 导出 .ics(任何平台可用) python src/cli.py schedule # 生成 macOS 定时同步任务(launchd) Token 通过环境变量 MCD_MCP_TOKEN 注入。 """ import argparse import os import sys from pathlib import Path # 允许 python src/cli.py 直接运行 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) from calendar_sync import DEFAULT_CALENDAR_NAME, export_ics, sync # noqa: E402 from event_builder import dedupe, filter_events, parse_campaign_markdown # noqa: E402 from mcd_client import MCPClientError, McDonaldMCPClient # noqa: E402 PLIST_LABEL = "cn.holdcloud.mcd-calendar-buddy" def _client() -> McDonaldMCPClient: try: return McDonaldMCPClient() except MCPClientError as exc: print(f"错误: {exc}", file=sys.stderr) sys.exit(1) def _fetch_events(date: str | None, keywords: str | None = None): client = _client() markdown = client.fetch_campaign_calendar(date) return filter_events(dedupe(parse_campaign_markdown(markdown)), keywords) def cmd_query(args) -> int: events = _fetch_events(args.date, args.filter) if not events: print("未查询到活动(若使用了 --filter,可尝试放宽关键词)。") return 0 print(f"共查询到 {len(events)} 条活动:\n") for e in events: kind = "全天" if e.all_day else e.start.strftime("%H:%M") print(f" [{e.start:%Y-%m-%d} {kind}] {e.title}") if e.description: first_line = e.description.splitlines()[0][:60] print(f" {first_line}…") return 0 def cmd_sync(args) -> int: events = _fetch_events(args.date, args.filter) if not events: print("未查询到活动,无需同步。") return 0 try: result = sync( events, calendar_name=args.calendar, remind_days_before=args.remind_days, ) except RuntimeError as exc: print(f"同步失败: {exc}", file=sys.stderr) return 2 print(f"✅ 新增 {result['synced']} 条,跳过已同步 {result['skipped']} 条") if result["fallback_ics"]: print(f"当前平台不支持直接写入 macOS 日历,已导出: {result['fallback_ics']}") print("双击该 .ics 文件即可导入日历应用。") else: print(f"事件已写入日历「{args.calendar}」") print("提醒策略:开售类活动提前 1 天 + 提前 1 小时;全天活动提前 1 天上午 9 点。") return 0 def cmd_export(args) -> int: events = _fetch_events(args.date, args.filter) if not events: print("未查询到活动,未生成文件。") return 0 path = export_ics(events, args.output, remind_days_before=args.remind_days) print(f"✅ 已导出 {len(events)} 条活动到 {path}") print("双击该文件即可导入 macOS 日历 / iOS 日历 / Google 日历。") return 0 def cmd_schedule(args) -> int: """生成 macOS launchd 定时任务:每天固定时间自动同步活动到日历。""" python_path = sys.executable cli_path = Path(__file__).resolve() plist_dir = Path.home() / "Library" / "LaunchAgents" plist_path = plist_dir / f"{PLIST_LABEL}.plist" plist_dir.mkdir(parents=True, exist_ok=True) plist = f""" Label {PLIST_LABEL} ProgramArguments {python_path} {cli_path} sync StartCalendarInterval Hour {args.hour} Minute {args.minute} StandardOutPath {Path.home() / ".mcd-calendar-buddy" / "launchd.log"} StandardErrorPath {Path.home() / ".mcd-calendar-buddy" / "launchd.err"} """ plist_path.write_text(plist, encoding="utf-8") print(f"✅ 已生成定时任务配置: {plist_path}") print("执行以下命令启用(每天自动同步):") print(f" launchctl load {plist_path}") print("如需取消:") print(f" launchctl unload {plist_path} && rm {plist_path}") print(f"\n注意:launchd 环境变量不含 MCD_MCP_TOKEN 时任务会失败,") print(f"可在 plist 的 ProgramArguments 前追加环境变量,或使用 launchctl setenv MCD_MCP_TOKEN ") return 0 def build_parser() -> argparse.ArgumentParser: parser = argparse.ArgumentParser( prog="mcd-calendar-buddy", description="麦麦日历助手:把麦当劳 MCP 营销活动日历同步到 macOS 日历", ) sub = parser.add_subparsers(dest="command", required=True) def add_common(p): p.add_argument("--date", help="查询基准日期 yyyy-MM-dd(默认当月全部活动)") p.add_argument("--filter", help="关键词订阅过滤,逗号分隔(如:联名,新品,优惠券)") p_query = sub.add_parser("query", help="查询麦当劳活动") add_common(p_query) p_query.set_defaults(func=cmd_query) p_sync = sub.add_parser("sync", help="同步活动到 macOS 日历") add_common(p_sync) p_sync.add_argument("--remind-days", type=int, default=1, help="提前提醒天数(默认 1)") p_sync.add_argument("--calendar", default=DEFAULT_CALENDAR_NAME, help="目标日历名称") p_sync.set_defaults(func=cmd_sync) p_export = sub.add_parser("export", help="导出 .ics 文件") add_common(p_export) p_export.add_argument("-o", "--output", default="mcd-events.ics", help="输出路径") p_export.add_argument("--remind-days", type=int, default=1, help="提前提醒天数(默认 1)") p_export.set_defaults(func=cmd_export) p_schedule = sub.add_parser("schedule", help="生成 macOS launchd 定时同步任务") p_schedule.add_argument("--hour", type=int, default=9, help="每天执行时间-小时(默认 9)") p_schedule.add_argument("--minute", type=int, default=30, help="每天执行时间-分钟(默认 30)") p_schedule.set_defaults(func=cmd_schedule) return parser def main() -> int: args = build_parser().parse_args() return args.func(args) if __name__ == "__main__": sys.exit(main())