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

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

geojson/solar_eclipse_marshal_benchmark_test.go

@@ -0,0 +1,82 @@
+package geojson_test
+
+import (
+	"strconv"
+	"strings"
+	"testing"
+	"time"
+
+	"b612.me/astro/eclipse"
+	"b612.me/astro/geojson"
+)
+
+// 本文件钉住导出路径成本：掠食带的限线派生与打包足迹都在这条路径上。
+func marshalBenchmarkDate(b *testing.B, text string) time.Time {
+	b.Helper()
+	if strings.HasPrefix(text, "-") {
+		parts := strings.Split(strings.TrimPrefix(text, "-"), "-")
+		if len(parts) != 3 {
+			b.Fatalf("invalid astronomical date %q", text)
+		}
+		year, err := strconv.Atoi(parts[0])
+		if err != nil {
+			b.Fatal(err)
+		}
+		month, err := strconv.Atoi(parts[1])
+		if err != nil {
+			b.Fatal(err)
+		}
+		day, err := strconv.Atoi(parts[2])
+		if err != nil {
+			b.Fatal(err)
+		}
+		return time.Date(-year, time.Month(month), day, 12, 0, 0, 0, time.UTC)
+	}
+	date, err := time.Parse("2006-01-02", text)
+	if err != nil {
+		b.Fatal(err)
+	}
+	return date
+}
+
+func benchmarkSolarEclipseMarshal(b *testing.B, text string) {
+	date := marshalBenchmarkDate(b, text)
+	info, ok := eclipse.SolarEclipseOnDate(date)
+	if !ok || !info.HasCentral {
+		b.Fatalf("expected a central solar eclipse on %s", text)
+	}
+	partialOptions, pathOptions := grazingBandOptions(info, "overview")
+	partial, ok := eclipse.SolarEclipsePartialFootprints(date, partialOptions)
+	if !ok {
+		b.Fatal("missing partial footprints")
+	}
+	central, ok := eclipse.SolarEclipseCentralPath(date, pathOptions)
+	if !ok {
+		b.Fatal("missing central path")
+	}
+	data, err := geojson.MarshalSolarEclipse(partial, &central)
+	if err != nil || len(data) == 0 {
+		b.Fatalf("MarshalSolarEclipse() bytes=%d err=%v", len(data), err)
+	}
+	b.ReportAllocs()
+	b.SetBytes(int64(len(data)))
+	b.ResetTimer()
+	for index := 0; index < b.N; index++ {
+		value, err := geojson.MarshalSolarEclipse(partial, &central)
+		if err != nil || len(value) == 0 {
+			b.Fatalf("MarshalSolarEclipse() bytes=%d err=%v", len(value), err)
+		}
+	}
+}
+
+func BenchmarkSolarEclipseMarshalGrazing(b *testing.B) {
+	for _, text := range []string{"2003-05-31", "1874-10-10", "2061-10-13"} {
+		b.Run(text, func(b *testing.B) {
+			benchmarkSolarEclipseMarshal(b, text)
+		})
+	}
+}
+
+func BenchmarkSolarEclipseMarshalOrdinary(b *testing.B) {
+	benchmarkSolarEclipseMarshal(b, "2024-04-08")
+}