feat: 增强日月食搜索、沙罗周期与内行星凌日

- 使用压缩表加速查找日月食沙罗周期信息 - 优化日月食搜索跳步，减少非食季朔望月扫描 - 新增本地日全食、日环食、月全食搜索接口，返回 ok 区分未找到结果 - 新增水星、金星地心凌日查询及测试
2026-05-03 19:00:08 +08:00
parent 3ffdbe0034
commit bec7b8a0d8
20 changed files with 1987 additions and 408 deletions
@@ -0,0 +1,73 @@
+package eclipse
+
+import (
+	"testing"
+	"time"
+
+	"b612.me/astro/basic"
+)
+
+func TestEclipseSearchStepDoesNotSkipPotentialCandidates(t *testing.T) {
+	testCases := []struct {
+		name             string
+		phaseType        int
+		synodicMonthDays float64
+		potential        func(float64) bool
+	}{
+		{
+			name:             "solar",
+			phaseType:        0,
+			synodicMonthDays: solarEclipseSynodicMonthDays,
+			potential:        isPotentialSolarEclipse,
+		},
+		{
+			name:             "lunar",
+			phaseType:        1,
+			synodicMonthDays: lunarEclipseSynodicMonthDays,
+			potential:        isPotentialLunarEclipse,
+		},
+	}
+
+	for _, tc := range testCases {
+		t.Run(tc.name, func(t *testing.T) {
+			candidates := eclipseSearchTestCandidates(1600, 800, tc.phaseType, tc.synodicMonthDays)
+
+			for index, candidateTT := range candidates {
+				for _, direction := range []int{-1, 1} {
+					step := eclipseSearchStep(candidateTT, direction, tc.synodicMonthDays)
+					for offset := 1; offset < step; offset++ {
+						skippedIndex := index + direction*offset
+						if skippedIndex < 0 || skippedIndex >= len(candidates) {
+							continue
+						}
+						if tc.potential(candidates[skippedIndex]) {
+							t.Fatalf(
+								"%s skip crosses potential candidate: index=%d direction=%d step=%d offset=%d jd=%.8f",
+								tc.name,
+								index,
+								direction,
+								step,
+								offset,
+								candidates[skippedIndex],
+							)
+						}
+					}
+				}
+			}
+		})
+	}
+}
+
+func eclipseSearchTestCandidates(startYear, years, phaseType int, synodicMonthDays float64) []float64 {
+	startTT := basic.Date2JDE(time.Date(startYear, 1, 1, 0, 0, 0, 0, time.UTC))
+	endTT := basic.Date2JDE(time.Date(startYear+years, 1, 1, 0, 0, 0, 0, time.UTC))
+	candidateTT := basic.CalcMoonSHByJDE(startTT, phaseType)
+	candidates := make([]float64, 0, years*13)
+	for candidateTT < endTT {
+		if candidateTT >= startTT {
+			candidates = append(candidates, candidateTT)
+		}
+		candidateTT = basic.CalcMoonSHByJDE(candidateTT+synodicMonthDays, phaseType)
+	}
+	return candidates
+}