-
v0.1.1 Stable
released this
2026-05-03 20:12:20 +08:00 | 0 commits to master since this release中文
Added
- 新增水星、金星地心凌日查询能力,提供
NextTransit/LastTransit/ClosestTransit,返回一触、二触、凌甚、三触、四触、持续时间、最小角距离和视半径等信
息。 basic层新增通用PlanetTransitResult,并提供水星/金星凌日搜索入口,供上层包复用。eclipse新增本地可见日全食、日环食、月全食专项搜索接口:LastLocalTotalSolarEclipse/NextLocalTotalSolarEclipse/ClosestLocalTotalSolarEclipseLastLocalAnnularSolarEclipse/NextLocalAnnularSolarEclipse/ClosestLocalAnnularSolarEclipseLastLocalTotalLunarEclipse/NextLocalTotalLunarEclipse/ClosestLocalTotalLunarEclipse- 新接口返回
(info, ok),可明确区分“找到事件”和“搜索范围内无结果”。
Changed
- 优化日食、月食搜索流程:增加食季跳步和黄纬预筛,减少非食季朔望月的无效精算。
- 沙罗周期匹配改用压缩锚点表快速匹配,并保留回退 walk 逻辑,提升查询效率且维持边界兼容。
- 本地中心食搜索现在要求中心阶段可见,避免只在偏食阶段可见时误报为本地可见日全食/日环食/月全食。
- README 中英文文档同步补充了中心食专项搜索接口、水星/金星凌日示例和能力清单。
English
Added
- Added geocentric Mercury and Venus transit queries via
NextTransit/LastTransit/ClosestTransit, returning first contact, second contact,
greatest transit, third contact, fourth contact, duration, minimum separation, and apparent semidiameters. - Added the shared
PlanetTransitResulttype inbasic, with Mercury/Venus transit search entry points for upper-layer packages. - Added dedicated local visible total solar eclipse, annular solar eclipse, and total lunar eclipse search APIs in
eclipse: LastLocalTotalSolarEclipse/NextLocalTotalSolarEclipse/ClosestLocalTotalSolarEclipseLastLocalAnnularSolarEclipse/NextLocalAnnularSolarEclipse/ClosestLocalAnnularSolarEclipseLastLocalTotalLunarEclipse/NextLocalTotalLunarEclipse/ClosestLocalTotalLunarEclipse- New search APIs return
(info, ok)to distinguish found events from no result within the search range.
Changed
- Optimized solar and lunar eclipse search with eclipse-season skipping and latitude prefiltering, reducing unnecessary full calculations outside eclipse
seasons. - Reworked Saros matching to use compressed anchor tables with a walk fallback, improving lookup efficiency while preserving edge-case compatibility.
- Local central-eclipse searches now require the central phase to be visible, avoiding false positives where only the partial phase is observable.
- Updated Chinese and English README files with central-eclipse search APIs, Mercury/Venus transit examples, and capability lists.
Downloads
- 新增水星、金星地心凌日查询能力,提供