-
v0.2.0 Stable
b612 released this
2026-08-06 12:41:42 +08:00 | 0 commits to master since this release中文
主要变更
- 新增恒星/月掩完整能力：支持固定地点接触、全球掩带、几何掩甚点、局地与全球 SVG，以及星表坐标转换。
- 新增日食、月食和月掩的全球投影图与 GeoJSON 输出，支持时间标记、等经纬/极区投影和无行政边界底图。
- 扩展日食中心线与偏食足迹，补齐 P1-P4、U1-U4 接触信息和可选中心影采样。
- 修正站心时角、月出月落和太阳升落口径，改为按动态标准折射与实时太阳/月球视半径计算上缘过地平线。
- 收紧行星合冲、留、大距与驻留事件搜索的收敛和边界控制，增加非有限输入保护，提升极端时刻与古代样本稳定性。
English
Highlights
- Added full stellar and planetary lunar-occultation support: fixed-site contacts, global footprints, geometric greatest points, local/global SVGs, and catalog-coordinate conversion.
- Added global projection maps and GeoJSON exports for solar eclipses, lunar eclipses, and lunar occultations, with time markers plus equirectangular and polar projections.
- Expanded solar-eclipse central-path and partial-footprint outputs with P1-P4 / U1-U4 contact data and optional central-shadow sampling.
- Corrected topocentric hour-angle handling and Sun/Moon rise-set semantics by using dynamic standard refraction and instantaneous semidiameters for upper-limb crossings.
- Hardened conjunction, station, elongation, and related event searches with bounded convergence and non-finite input guards.
Downloads
-
v0.1.5-rc2 Pre-Release
2026-06-11 09:34:57 +08:00 | 1 commits to master since this releasecalendar: 补齐前104古历纪年解析与回归测试
- 为先秦与秦汉古历结果填充周、鲁、秦、西汉早期纪年信息
- 支持默认与显式古历下的年号日期解析
Downloads
-
v0.1.5-rc1 Pre-Release
2026-06-09 19:37:52 +08:00 | 2 commits to master since this release• feat(calendar): 扩展先秦至秦汉古历支持
- 新增显式古历 API，支持先秦古历与秦汉颛顼历选择
- 将默认公农历转换范围扩展至 -721..3000
- 支持后九月解析、负年份干支日和古历法相符节气
- 补充秦汉、先秦、交接边界和节气回归测试
- 同步 README 古历与节气 API 说明
Downloads
-
v0.1.4 Stable
2026-05-30 21:59:40 +08:00 | 3 commits to master since this release中文
主要变更
- 修复 moon.TrueRa / moon.TrueDec / moon.TrueRaDec 的月球地心真赤经、真赤纬口径，使其与公开 API 注释语义一致。
- 新增月球地心视赤经、视赤纬接口：moon.GeocentricApparentRa、moon.GeocentricApparentDec、moon.GeocentricApparentRaDec。
- 新增行星合月（赤经合）查询接口，支持水星、金星、火星、木星、土星、天王星、海王星：
moon.LastConjunctionWithPlanet、moon.NextConjunctionWithPlanet、moon.ClosestConjunctionWithPlanet。 - 修复合月、合日、冲日、留、大距、方照等天象事件 API 在事件边界附近可能重复返回同一事件的问题。
- 优化行星合月搜索在跨世纪、分支跳变和邻近事件场景下的稳定性。
- 统一公开 API 的中英双语注释结构，补齐 calendar、coord、formula、orbit、moon、sun、sundial、star 及各行星包的英文说明。
测试与基线
- 增加月球地心视赤经、视赤纬外部基线测试。
- 增加行星合月外部基线与跨世纪回归测试。
- 增加公开事件 API 的边界单调性测试，覆盖合月、内行星合日/大距/留、外行星合日/冲日/留/方照等场景。
English
Highlights
- Fixed the semantics of moon.TrueRa, moon.TrueDec, and moon.TrueRaDec so they now match the documented geocentric true right ascension and declination contract.
- Added Moon apparent geocentric equatorial APIs: moon.GeocentricApparentRa, moon.GeocentricApparentDec, and moon.GeocentricApparentRaDec.
- Added Moon-planet conjunction APIs for Mercury, Venus, Mars, Jupiter, Saturn, Uranus, and Neptune:
moon.LastConjunctionWithPlanet, moon.NextConjunctionWithPlanet, and moon.ClosestConjunctionWithPlanet. - Fixed event-boundary behavior for conjunctions, oppositions, stations, greatest elongations, quadratures, and Moon-planet conjunctions so Next APIs advance correctly near exact event times.
- Improved Moon-planet conjunction search stability across long time ranges, branch jumps, and near-event queries.
- Standardized bilingual public API comments across calendar, coord, formula, orbit, moon, sun, sundial, star, and planet packages.
Tests and Baselines
- Added external baseline tests for Moon apparent geocentric right ascension and declination.
- Added external Moon-planet conjunction baselines and cross-century regression coverage.
- Added public event-boundary monotonicity tests covering Moon-planet conjunctions, inner-planet conjunctions/elongations/stations, and outer-planet conjunctions/oppositions/stations/quadratures.
Downloads
-
v0.1.4-rc.2 Pre-Release
2026-05-23 23:10:06 +08:00 | 4 commits to master since this releasefix: 修复天象事件 API 在事件边界附近的重复返回问题
- 修正合月、合日、留等Last/Next/Closest接口在精确命中和事件后秒级查询时仍返回当前事件的问题，避免应用侧枚举卡死
- 收紧事件边界判定，并补强水星、金星、火星近事件路径的稳定化，保证公开API的单调前进语义
- 补充公开wrapper、跨世纪样本和外部基线回归，覆盖合月邻近事件与边界场景
Downloads
-
v1.0.4-rc.1 Pre-Release
2026-05-23 19:04:27 +08:00 | 5 commits to master since this releasefeat(moon): 新增行星合月查询并修正月球地心赤经赤纬接口
- 修正月球地心真/视赤经赤纬接口口径
- 新增月球与七大行星合月时刻查询
Downloads
-
v0.1.3 Stable
2026-05-22 12:34:41 +08:00 | 6 commits to master since this release中文
- 修复七大行星事件计算中的边界与漏检问题，重点覆盖合日、冲日、留、东西方照、内行星大距等场景。
- 统一公开 API 在“精确事件时刻”的 Last/Next 语义，修复 UT/TT 比较口径不一致导致的边界跳轮问题。
- 内行星事件基线改为以 JPL Horizons 为准，NAOJ 作为辅助覆盖参考；外行星留点保留 JPL 参考数据，当前测试仍按既有口径约束。
- 重构行星视位置公共计算路径，补充光行时与视黄经/黄纬修正，并新增校验。
English
- Fixed boundary and missed-cycle issues in planetary event calculations, covering conjunctions, oppositions, stations, quadratures, and inner-planet greatest elongations.
- Normalized public Last/Next API behavior at exact event boundaries, fixing UT/TT comparison mismatches that could skip the current event cycle.
- Switched inner-planet event baselines to JPL Horizons as the authority, with NAOJ used as auxiliary coverage hints; outer-planet station JPL rows are retained as reference data while current tests keep the
existing station semantics. - Refactored the shared apparent-position path, including light-time and apparent ecliptic corrections, and added a small seven-planet Horizons apparent-coordinate fixture.
Downloads
-
v0.1.2 Stable
2026-05-17 21:24:16 +08:00 | 7 commits to master since this release中文
Fixed
- 修复 TinyGo 编译到 wasm 时可能在
planet包初始化阶段报interp: unsupported fcmp的问题。 - 将
planetViews从包级初始化改为sync.Once懒加载，避免 TinyGo 在编译期解释大型float64星历表切片索引。 planet内部视图构建改为返回error，再由兼容层统一panic，避免懒加载初始化失败后留下未初始化缓存。- 补充无效行星数据切片边界测试。
English
Fixed
- Fixed a TinyGo wasm build failure that could report
interp: unsupported fcmpduringplanetpackage initialization. - Changed
planetViewsfrom package-level eager initialization tosync.Oncelazy initialization, avoiding TinyGo compile-time interpretation of largefloat64ephemeris table slicing. - Changed internal planet-view construction to return
error, with the compatibility layer still panicking on corrupted built-in data, avoiding an uninitialized cache after lazy initialization failure. - Added a test for invalid planet-data slice boundaries.
Downloads
- 修复 TinyGo 编译到 wasm 时可能在
-
v0.1.1 Stable
2026-05-03 20:12:20 +08:00 | 8 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
- 新增水星、金星地心凌日查询能力，提供