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

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

basic/event_baseline_golden_test.go

@@ -0,0 +1,85 @@
+// 事件回归基线按星历模型分文件：旧模型用 testdata/<name>.json，新模型用 testdata/semianalytic/<name>.json。
+// ASTRO_UPDATE_GOLDEN=1 且当前为新模型时，以旧基线的输入时刻重算并重写新模型基线；旧模型基线从不改写。
+package basic
+
+import (
+	"encoding/json"
+	"math"
+	"os"
+	"path/filepath"
+	"sort"
+	"testing"
+
+	"b612.me/astro/internal/ephem"
+	"b612.me/astro/internal/ephemtest"
+)
+
+type eventBaselineSample struct {
+	InputUTC string            `json:"input_utc"`
+	TTJDBits uint64            `json:"tt_jd_bits"`
+	Events   map[string]uint64 `json:"events"`
+}
+
+type eventBaselineFile struct {
+	Samples []eventBaselineSample `json:"samples"`
+}
+
+type namedEventFunc struct {
+	name string
+	fn   func(float64) float64
+}
+
+func readEventBaseline(t *testing.T, path string) eventBaselineFile {
+	t.Helper()
+	data, err := os.ReadFile(path)
+	if err != nil {
+		t.Fatal(err)
+	}
+	var b eventBaselineFile
+	if err := json.Unmarshal(data, &b); err != nil {
+		t.Fatal(err)
+	}
+	if len(b.Samples) == 0 {
+		t.Fatalf("empty event baseline %s", path)
+	}
+	return b
+}
+
+// eventBaselineData 当前模型的基线原始字节；需要时先重写新模型基线。
+func eventBaselineData(t *testing.T, legacyPath string, cases []namedEventFunc) []byte {
+	t.Helper()
+	path := ephemtest.Golden(legacyPath)
+	if ephemtest.Update() && ephem.Active() == ephem.Semianalytic {
+		src := readEventBaseline(t, legacyPath)
+		out := eventBaselineFile{Samples: make([]eventBaselineSample, len(src.Samples))}
+		for i, s := range src.Samples {
+			jd := math.Float64frombits(s.TTJDBits)
+			ev := make(map[string]uint64, len(cases))
+			for _, c := range cases {
+				ev[c.name] = math.Float64bits(c.fn(jd))
+			}
+			out.Samples[i] = eventBaselineSample{InputUTC: s.InputUTC, TTJDBits: s.TTJDBits, Events: ev}
+		}
+		data, err := json.MarshalIndent(out, "", "  ")
+		if err != nil {
+			t.Fatal(err)
+		}
+		if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+			t.Fatal(err)
+		}
+		if err := os.WriteFile(path, append(data, '\n'), 0o644); err != nil {
+			t.Fatal(err)
+		}
+		names := make([]string, 0, len(cases))
+		for _, c := range cases {
+			names = append(names, c.name)
+		}
+		sort.Strings(names)
+		t.Logf("rewrote %s: %d samples × %d events", path, len(out.Samples), len(names))
+	}
+	data, err := os.ReadFile(path)
+	if err != nil {
+		t.Fatalf("%v (regenerate with ASTRO_UPDATE_GOLDEN=1 go test)", err)
+	}
+	return data
+}