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

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

internal/ephem/apparent_generic.go

@@ -0,0 +1,88 @@
+package ephem
+
+import "math"
+
+const (
+	genericCKMPerDay = 299792.458 * 86400
+	genericAUKM      = 149597870.7
+	// 太阳史瓦西半径 2GM☉/c²，AU。
+	genericSunSchwarzschildAU = 1.97412574336e-8
+)
+
+// genericApparent 用 Engine.State 求地心视方向：迭代光行时、太阳引力偏折、相对论光行差，均在 ICRF 中进行。
+// 引擎不能给出相对太阳系质心的地球、太阳或目标状态时返回 ErrUnsupportedApparent。
+func genericApparent(engine Engine, target Body, jdTT float64) (dir [3]float64, distKM, tauDays float64, err error) {
+	earth, earthVel, err := engine.State(Earth, SSB, jdTT)
+	if err != nil {
+		return dir, 0, 0, ErrUnsupportedApparent
+	}
+	now, _, err := engine.State(target, SSB, jdTT)
+	if err != nil {
+		return dir, 0, 0, ErrUnsupportedApparent
+	}
+	g := genericSub(now, earth)
+	distKM = genericLen(g)
+	if !(distKM > 0) || math.IsInf(distKM, 0) {
+		return dir, 0, 0, ErrUnsupportedApparent
+	}
+	tauDays = distKM / genericCKMPerDay
+	var retarded [3]float64
+	for k := 0; k < 3; k++ {
+		if retarded, _, err = engine.State(target, SSB, jdTT-tauDays); err != nil {
+			return dir, 0, 0, ErrUnsupportedApparent
+		}
+		g = genericSub(retarded, earth)
+		tauDays = genericLen(g) / genericCKMPerDay
+	}
+	q := genericScale(g, 1/genericLen(g))
+	if target != Sun && target != Moon && target != Earth {
+		sunThen, _, sunErr := engine.State(Sun, SSB, jdTT-tauDays)
+		sunNow, _, sunNowErr := engine.State(Sun, SSB, jdTT)
+		if sunErr == nil && sunNowErr == nil {
+			q = genericDeflect(q, genericSub(retarded, sunThen), genericSub(earth, sunNow))
+		}
+	}
+	return genericAberrate(q, earthVel), distKM, tauDays, nil
+}
+
+// genericDeflect 太阳引力偏折；p 目标方向，t 目标日心位置，e 地球日心位置。
+func genericDeflect(p, t, e [3]float64) [3]float64 {
+	el, tl := genericLen(e), genericLen(t)
+	if el <= 0 || tl <= 0 {
+		return p
+	}
+	eu, qu := genericScale(e, 1/el), genericScale(t, 1/tl)
+	qpe := genericDot(qu, eu) + 1
+	if qpe < 1e-9 {
+		return p
+	}
+	w := genericSunSchwarzschildAU / (el / genericAUKM) / qpe
+	pe, pq := genericDot(p, eu), genericDot(p, qu)
+	for i := range p {
+		p[i] += w * (eu[i]*pq - qu[i]*pe)
+	}
+	return genericScale(p, 1/genericLen(p))
+}
+
+// genericAberrate 相对论光行差；v 观测者相对质心速度 km/日。
+func genericAberrate(p, v [3]float64) [3]float64 {
+	b := genericScale(v, 1/genericCKMPerDay)
+	bm := 1 / math.Sqrt(1-genericDot(b, b))
+	pdv := genericDot(p, b)
+	w1 := 1 + pdv/(1+1/bm)
+	w2 := 1 / (1 + pdv)
+	var r [3]float64
+	for i := range p {
+		r[i] = (p[i]/bm + w1*b[i]) * w2
+	}
+	return genericScale(r, 1/genericLen(r))
+}
+
+func genericDot(a, b [3]float64) float64 { return a[0]*b[0] + a[1]*b[1] + a[2]*b[2] }
+func genericLen(a [3]float64) float64    { return math.Sqrt(genericDot(a, a)) }
+func genericSub(a, b [3]float64) [3]float64 {
+	return [3]float64{a[0] - b[0], a[1] - b[1], a[2] - b[2]}
+}
+func genericScale(a [3]float64, k float64) [3]float64 {
+	return [3]float64{a[0] * k, a[1] * k, a[2] * k}
+}