SYSU anything Apple

请使用已发布的 macOS Apple 入口（entrypoint），而非重新推导 EventKit 流程。优先使用已安装的 sysu-anything-apple 二进制可执行文件。若该文件缺失，请通过 npm i -g sysu-anything 安装已编译的软件包。若用户正在本地仓库中积极开发，则检出的 workspace 构建版本也可接受。

本能力仅支持 macOS 12+（Monterey 及更高版本）。已发布的 Apple 原生桥接器（native bridge）同时支持 Apple Silicon 与 Intel 架构。在非 macOS 系统、或 macOS 11 及更低版本上，请继续使用 sysu-anything-cli；此时仅 Apple 日历（Apple Calendar）与 Apple 提醒事项（Apple Reminders）功能不可用。

sysu-anything-apple

第一步

1. 确认运行时路径：
   • 首选路径：sysu-anything-apple
   • 如缺失，请安装：npm i -g sysu-anything
   • 本地开发时的备用方案（在仓库内）：npm run build
   • 支持的宿主系统：仅 macOS 12+
   • 不支持的宿主系统降级方案：使用不带 Apple 同步功能的 sysu-anything
   • 若用户此前安装了旧版 npm 运行时，请提示其先升级 sysu-anything，再重试 Apple 同步
2. 在构造命令前，建议优先查阅针对性帮助：
   • sysu-anything-apple --help
   • sysu-anything-apple --help
   • sysu-anything-apple --help
3. 始终首先验证 Mac 端桥接器状态：
   • sysu-anything-apple apple doctor
4. 在执行实际操作前，检查 SYSU 端登录状态：
   • qg：无需登录检查
   • ykt homework list/detail --reminders：运行 sysu-anything ykt status
   • today / jwxt timetable / jwxt leave apply：运行 sysu-anything jwxt status
   • career teachin detail/jobfair detail --calendar --reminders：无需 SYSU 登录检查
   • career teachin signup/jobfair signup --confirm --calendar --reminders：若该命令仍需生成 career-session.json，请先运行 sysu-anything auth workwechat
   • gym book：运行 sysu-anything gym profile
   • libic reserve：运行 sysu-anything libic whoami
   • usc classroom submit --confirm --calendar --reminders：运行 sysu-anything usc whoami --json
   • explore seminar reserve：运行 sysu-anything explore whoami
   • xgxt workstudy apply --calendar：运行 sysu-anything xgxt current-user
5. 若上述检查失败，请先恢复登录状态，再次运行检查，然后执行 Apple 同步命令。

Apple 入口复用相同的运行时状态目录：

~/.sysu-anything/

路由说明

• 如需命令映射表或使用示例，请查阅 references/overview.md。
• 关于 Apple 特有的 career teachin / jobfair 导入与报名同步行为，请查阅 references/career.md。
• 关于 Apple 特有的 libic 预约同步行为，请查阅 references/libic.md。
• 当其他代理（agent）或脚本需要结构化输出时，建议优先使用 --json 参数。

闭环同步场景（Closed Loops）

• today --calendar
• jwxt timetable --calendar [--calendar-scope week|term]
• qg link --calendar --reminders
• career teachin detail --calendar --reminders
• career teachin signup --confirm --calendar --reminders
• career jobfair detail --calendar --reminders
• career jobfair signup --confirm --calendar --reminders
• ykt homework list --reminders
• ykt homework detail --reminders
• gym book --confirm --calendar --reminders
• libic reserve --confirm --calendar --reminders
• usc classroom submit --confirm --calendar --reminders
• usc classroom sync --calendar --reminders
• explore seminar reserve --confirm --calendar --reminders
• jwxt leave apply --confirm --calendar-block --reminders
• xgxt workstudy apply --confirm --calendar [--calendar-start-date ] [--calendar-weeks ]

安全性说明

• qg link --calendar --reminders 会在 Apple 应用中创建一条计划行程（planned trip），但这**不代表车票已确认**。
• career teachin/jobfair detail --calendar --reminders 仅为本地导入，**不会修改远程报名状态**。
• career teachin/jobfair signup 若未指定 --confirm，将保持预览模式（preview mode），并跳过 Apple 同步；若用户仅需本地日历 / 提醒事项导入，请改用对应的 detail 命令。
• gym book、libic reserve、usc classroom submit、explore seminar reserve、jwxt leave apply 与 xgxt workstudy apply 均仅在指定 --confirm 时执行真实写入操作。
• usc classroom submit --calendar --reminders 仅在 BPM 接口 /site/app/start 返回成功（OK）后，才向 Apple 写入条目。初始 app_id=197 的申请通常尚无具体教室分配；Apple 备注中应注明“教室待后续分配”。
• usc classroom sync --calendar --reminders 仅从已存在的 BPM 会话中回填（backfill）本地 Apple 条目，**不会调用 /site/app/start 接口**。
• ykt homework list/detail --reminders 默认仅导入未来截止的任务；若用户明确要求也导入逾期任务，请添加 --include-past 参数。
• xgxt workstudy apply --calendar 将提交的勤工助学时间模板写入 Apple 日历；由于 xgxt 负载（payload）仅包含工作日 + 时间信息，Apple 层默认扩展为 1 周，除非显式指定 --calendar-weeks。
• 在新 Mac 上首次同步、或 macOS 权限发生变更后，请务必先运行 apple doctor。