"""麦麦日历助手 — 命令行入口。
用法:
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())