feat: 完善日月食与月掩几何链路并扩展历法接口

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算，支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径，补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出，支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推，补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存，降低重复计算开销并提升边界稳定

basic/event_boundary.go

@@ -5,14 +5,28 @@ import "math"
 const (
 	exactEventTolerance     = 2.0 / 86400.0
 	exactQueryTTToleranceUT = 0.1 / 86400.0
+	// stationQueryToleranceUT 站（留）事件的「同刻」容差 / same-instant tolerance for station events.
+	//
+	// 站的求解本身有数值不确定度（火星 ~0.2 s、金星 ~2 s、外行星改精修步长后 <0.05 s）。
+	// 若与普通事件一样取 0.1 s，查询落在站前几十毫秒时会被判成「站仍在未来」，
+	// 于是跳到上一个会合周期。取 0.5 s 可覆盖除金星外的全部不确定度。
+	// 上限约束：必须明显小于 1 s，否则会破坏
+	// TestInnerPlanetNextEventAdvancesPastReturnedEvent 的「查询=事件+1 秒必须前进」语义。
+	stationQueryToleranceUT = 0.5 / 86400.0
 )
 
 func sameEventJD(a, b float64) bool {
 	return math.Abs(a-b) <= exactEventTolerance
 }
 
-func sameEventUTQueryTT(eventUT, queryTT float64) bool {
-	return math.Abs(eventUTQueryTTDelta(eventUT, queryTT)) <= exactQueryTTToleranceUT
+// stationUTQueryBeforeOrEqual / stationUTQueryAfterOrEqual 站事件专用侧向判定，
+// 容差比普通事件宽（见 stationQueryToleranceUT）。
+func stationUTQueryBeforeOrEqual(eventUT, queryTT float64) bool {
+	return eventUTQueryTTDelta(eventUT, queryTT) <= stationQueryToleranceUT
+}
+
+func stationUTQueryAfterOrEqual(eventUT, queryTT float64) bool {
+	return eventUTQueryTTDelta(eventUT, queryTT) >= -stationQueryToleranceUT
 }
 
 func closestEventUTToQueryTT(queryTT, best float64, candidates ...float64) float64 {
@@ -30,50 +44,34 @@ func closestEventUTToQueryTT(queryTT, best float64, candidates ...float64) float
 type phaseEventSearchFunc func(jde, degree float64, next uint8) float64
 type simpleEventSearchFunc func(jde float64) float64
 
+// inclusive* 的唯一作用是把「查询几乎正好落在事件上」判成包含：
+// 反向搜索给出的邻接事件落在同刻容差内时优先返回它，否则返回本方向的事件（可能是 NaN）。
 func inclusiveLastPhaseEvent(jde, degree float64, fn phaseEventSearchFunc) float64 {
 	last := fn(jde, degree, 0)
-	next := fn(jde, degree, 1)
-	if eventUTQueryBeforeOrEqual(next, jde) && eventUTQueryAfterOrEqual(next, jde) {
+	if next := fn(jde, degree, 1); eventUTQueryBeforeOrEqual(next, jde) && eventUTQueryAfterOrEqual(next, jde) {
 		return next
 	}
-	if eventUTQueryBeforeOrEqual(last, jde) {
-		return last
-	}
 	return last
 }
 
 func inclusiveNextPhaseEvent(jde, degree float64, fn phaseEventSearchFunc) float64 {
-	last := fn(jde, degree, 0)
-	if eventUTQueryBeforeOrEqual(last, jde) && eventUTQueryAfterOrEqual(last, jde) {
+	if last := fn(jde, degree, 0); eventUTQueryBeforeOrEqual(last, jde) && eventUTQueryAfterOrEqual(last, jde) {
 		return last
 	}
-	next := fn(jde, degree, 1)
-	if eventUTQueryAfterOrEqual(next, jde) {
-		return next
-	}
-	return next
+	return fn(jde, degree, 1)
 }
 
 func inclusiveLastSimpleEvent(jde float64, lastFn, nextFn simpleEventSearchFunc) float64 {
 	last := lastFn(jde)
-	next := nextFn(jde)
-	if eventUTQueryBeforeOrEqual(next, jde) && eventUTQueryAfterOrEqual(next, jde) {
+	if next := nextFn(jde); eventUTQueryBeforeOrEqual(next, jde) && eventUTQueryAfterOrEqual(next, jde) {
 		return next
 	}
-	if eventUTQueryBeforeOrEqual(last, jde) {
-		return last
-	}
 	return last
 }
 
 func inclusiveNextSimpleEvent(jde float64, lastFn, nextFn simpleEventSearchFunc) float64 {
-	last := lastFn(jde)
-	if eventUTQueryBeforeOrEqual(last, jde) && eventUTQueryAfterOrEqual(last, jde) {
+	if last := lastFn(jde); eventUTQueryBeforeOrEqual(last, jde) && eventUTQueryAfterOrEqual(last, jde) {
 		return last
 	}
-	next := nextFn(jde)
-	if eventUTQueryAfterOrEqual(next, jde) {
-		return next
-	}
-	return next
+	return nextFn(jde)
 }