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

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

planet/spk/apparent_test.go

@@ -0,0 +1,45 @@
+package spk
+
+import (
+	"math"
+	"os"
+	"testing"
+
+	"b612.me/astro/internal/ephem"
+	"b612.me/astro/planet/internal/semianalytic"
+)
+
+// SPK 只给几何状态，实例应走通用矢量视位置链；与按 DE441 拟合的内置表相比只剩表的拟合误差。
+func TestSPKInstanceApparentMatchesSemianalytic(t *testing.T) {
+	path := de441Path()
+	if _, err := os.Stat(path); err != nil {
+		t.Skip("DE441 file not available; set ASTRO_DE441_BSP")
+	}
+	file, err := Open(path)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer file.Close()
+	inst := ephem.NewInstance(file)
+	worst := 0.0
+	for _, jd := range []float64{2451545.0, 2460409.25, 2470000.5} {
+		for _, b := range []ephem.Body{ephem.Sun, ephem.Moon, ephem.Mercury, ephem.Venus, ephem.Mars, ephem.Jupiter, ephem.Saturn, ephem.Uranus, ephem.Neptune} {
+			got, gd, _, err := inst.Apparent(b, jd)
+			if err != nil {
+				t.Fatalf("jd %.1f body %d: %v", jd, b, err)
+			}
+			want, wd, _, err := semianalytic.Ephemeris{}.Apparent(b, jd)
+			if err != nil {
+				t.Fatal(err)
+			}
+			c := got[0]*want[0] + got[1]*want[1] + got[2]*want[2]
+			arcsec := math.Acos(math.Min(1, c)) * 206264.806
+			worst = math.Max(worst, arcsec)
+			// 内置表的几何距离取自快速档，外行星可差数万千米。
+			if arcsec > 1.5 || math.Abs(gd-wd)/wd > 5e-5 {
+				t.Errorf("jd %.1f body %d: %.4f\" dist rel %.2e", jd, b, arcsec, (gd-wd)/wd)
+			}
+		}
+	}
+	t.Logf("worst %.4f\"", worst)
+}