feat: 引入可切换星历模型并扩展天象观测链路

- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算
- 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询
- 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出
- 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解
- 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤
- 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持
- 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理
- 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则

geojson/eclipse_limb_test.go

@@ -0,0 +1,49 @@
+package geojson_test
+
+// 开启月缘时偏食足迹与食甚等时线必须落在月缘修正后的 P1–P4 内，整条管线（足迹 → 中心带 → 编码）不得被校验拒收。
+
+import (
+	"testing"
+	"time"
+
+	"b612.me/astro/eclipse"
+	"b612.me/astro/geojson"
+	"b612.me/astro/moon/limb"
+)
+
+func TestMarshalSolarEclipseWithLunarLimb(t *testing.T) {
+	module := eclipse.NewWithInstance(nil).WithLunarLimb(limb.Default())
+	for _, date := range []time.Time{
+		time.Date(2028, 7, 22, 0, 0, 0, 0, time.UTC),
+		time.Date(2029, 6, 12, 0, 0, 0, 0, time.UTC),
+		time.Date(2032, 5, 9, 0, 0, 0, 0, time.UTC),
+		time.Date(2040, 11, 4, 0, 0, 0, 0, time.UTC),
+	} {
+		label := date.Format("2006-01-02")
+		partial, ok := module.SolarEclipsePartialFootprints(date, eclipse.SolarEclipsePartialFootprintOptions{})
+		if !ok || len(partial.Footprints) == 0 {
+			t.Fatalf("%s: footprints unavailable", label)
+		}
+		if !partial.Eclipse.LunarLimbApplied {
+			t.Fatalf("%s: limb not applied to the global contacts", label)
+		}
+		begin, end := partial.Eclipse.PartialBeginOnEarth, partial.Eclipse.PartialEndOnEarth
+		for index, footprint := range partial.Footprints {
+			if footprint.Time.Before(begin) || footprint.Time.After(end) {
+				t.Fatalf("%s: footprint %d at %v outside limb P1–P4 %v–%v", label, index, footprint.Time, begin, end)
+			}
+		}
+		for index, contour := range partial.GreatestTimeContours {
+			if contour.Time.Before(begin) || contour.Time.After(end) {
+				t.Errorf("%s: greatest-time contour %d at %v outside limb P1–P4", label, index, contour.Time)
+			}
+		}
+		var central *eclipse.SolarEclipsePath
+		if path, ok := module.SolarEclipseCentralPath(date, eclipse.SolarEclipsePathOptions{}); ok {
+			central = &path
+		}
+		if _, err := geojson.MarshalSolarEclipse(partial, central); err != nil {
+			t.Errorf("%s: %v", label, err)
+		}
+	}
+}