用途：按安息日（Shabbat）、以色列节日（chagim）与希伯来日历约束安排会议、部署、事件、通知与定时任务。该工具只做日历与商务排程计算，不发布哈拉卡裁决，哈拉卡问题应咨询拉比。
主要能力：通过 HebCal API 获取安息日蜡烛点燃与哈夫达拉时间、全年以色列假日（含大节、小节、现代节日与小斋日）；将日期分类为 closed（安息日、Yom Tov、全国停业日）、reduced（仅上午，如节日前夕、斋日）、evening_closed（白天工作但晚间受限）或 open；提供以色列营业时间（周日至周四 08:00-18:00，周五 08:00-13:00，周六关闭）与安息日感知的 cron 判断。
必要用法：优先传 geonameid 而非原始坐标，让 Hebcal 应用该城市自己的点烛习俗；只有无 geonameid 的地点才用 lat/long 加 b=。蜡烛点燃偏移因城市而异：耶路撒冷 40 分钟，海法和 Zikhron Ya'akov 30 分钟，多数其他城市 18 分钟；该偏移同样决定节日前夕，不只是安息日前夕。日期检查不等于时间检查：安息日和 Yom Tov 在前一晚点烛时开始，所以周五是营业日但周五 19:00 已是安息日；在特定时刻触发的 cron、通知或部署必须额外检查实时窗口，否则每周都会在安息日运行却报告“营业日”。脚本 scripts/check_shabbat.py 可独立查询安息日时间、假日和营业日状态，并提供 --is-rest-period-now 实时检查；运行：python scripts/check_shabbat.py --help。无法访问 API 时可使用离线库：@hebcal/core（npm i @hebcal/core）、pyluach、hebcal-go；已弃用的 NPM hebcal 不要用于新项目。
适用场景：安排团队会议、选择安全部署窗口、规划发布活动、设置跳过安息日与假日的每日任务、安排推送通知时段。
限制：不构成哈拉卡裁决；chol ha-moed 按营业日处理但人手较少；Shushan Purim 仅适用于耶路撒冷及历史城墙城市，是全国工作日但耶路撒冷全市休息；以 2026 年以色列历为例，Rosh Hashana 第一天落在周六而非紧邻，关闭区间为周五晚点烛进入的周六与周日两天，Yom HaAtzmaut 在其他年份可能因与安息日冲突而提前或推迟，不要直接计算 5 Iyyar；希伯来历相对公历每年滑动 11 至 19 天，每年需重新核对。其他细节暂未提供。