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

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

basic/solar_eclipse_diagram.go

@@ -3,6 +3,8 @@ package basic
 import (
 	"math"
 	"sort"
+
+	"b612.me/astro/internal/geodata"
 )
 
 const (
@@ -20,6 +22,8 @@ type LocalSolarEclipseDiagramOptions struct {
 	StepDays float64
 	// SunRadiusModel 太阳半径口径，零值为标准档 / solar radius convention, standard when zero.
 	SunRadiusModel SolarEclipseSunRadiusModel
+	// LunarLimb 月缘剖面，nil 为圆月面；修正接触时刻、站心食分与遮蔽率，食甚时刻不变，月盘仍按圆面采样 / lunar limb profile for contacts, magnitude and obscuration.
+	LunarLimb LunarLimb
 }
 
 // LocalSolarEclipseDiagramFrame 表示一个时刻的站心日月视圆几何。
@@ -80,28 +84,28 @@ func LocalSolarEclipseDiagram(seedJDE, lon, lat, height float64, options LocalSo
 	return LocalSolarEclipseDiagramNASABulletinSplitK(seedJDE, lon, lat, height, options)
 }
 
-// LocalSolarEclipseDiagramIAUSingleK 计算站心日食视圆图几何数据，使用 IAU Single-K 模型。
-// LocalSolarEclipseDiagramIAUSingleK computes local solar eclipse disk diagram geometry with the IAU Single-K model.
-func LocalSolarEclipseDiagramIAUSingleK(seedJDE, lon, lat, height float64, options LocalSolarEclipseDiagramOptions) LocalSolarEclipseDiagramResult {
-	return localSolarEclipseDiagram(seedJDE, lon, lat, height, SolarEclipseModelIAUSingleK, options)
+// LocalSolarEclipseDiagramIAUSingleKWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func LocalSolarEclipseDiagramIAUSingleKWithInstance(seedJDE, lon, lat, height float64, options LocalSolarEclipseDiagramOptions, inst *Instance) LocalSolarEclipseDiagramResult {
+	return localSolarEclipseDiagram(seedJDE, lon, lat, height, SolarEclipseModelIAUSingleK, options, inst)
 }
 
-// LocalSolarEclipseDiagramNASABulletinSplitK 计算站心日食视圆图几何数据，使用 NASA bulletin Split-K 模型。
-// LocalSolarEclipseDiagramNASABulletinSplitK computes local solar eclipse disk diagram geometry with the NASA bulletin Split-K model.
-func LocalSolarEclipseDiagramNASABulletinSplitK(seedJDE, lon, lat, height float64, options LocalSolarEclipseDiagramOptions) LocalSolarEclipseDiagramResult {
-	return localSolarEclipseDiagram(seedJDE, lon, lat, height, SolarEclipseModelNASABulletinSplitK, options)
+// LocalSolarEclipseDiagramNASABulletinSplitKWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func LocalSolarEclipseDiagramNASABulletinSplitKWithInstance(seedJDE, lon, lat, height float64, options LocalSolarEclipseDiagramOptions, inst *Instance) LocalSolarEclipseDiagramResult {
+	return localSolarEclipseDiagram(seedJDE, lon, lat, height, SolarEclipseModelNASABulletinSplitK, options, inst)
 }
 
 func localSolarEclipseDiagram(
 	seedJDE, lonDeg, latDeg, heightMeters float64,
 	model SolarEclipseRadiusModel,
-	options LocalSolarEclipseDiagramOptions,
-) LocalSolarEclipseDiagramResult {
+	options LocalSolarEclipseDiagramOptions, instances ...*Instance) LocalSolarEclipseDiagramResult {
+	inst := instanceValue(instances)
+
 	options = normalizeLocalSolarEclipseDiagramOptions(options)
 	eclipse := localSolarEclipse(seedJDE, lonDeg, latDeg, heightMeters, SolarEclipseOptions{
 		RadiusModel:    model,
 		SunRadiusModel: options.SunRadiusModel,
-	})
+		LunarLimb:      options.LunarLimb,
+	}, inst)
 	result := LocalSolarEclipseDiagramResult{
 		Eclipse:  eclipse,
 		StepDays: options.StepDays,
@@ -118,7 +122,7 @@ func localSolarEclipseDiagram(
 	result.StepDays = stepDays
 	result.Frames = make([]LocalSolarEclipseDiagramFrame, 0, len(times))
 	for _, item := range times {
-		frame := localSolarEclipseDiagramFrameAt(item.jde, lonRad, latRad, heightKM, params)
+		frame := localSolarEclipseDiagramFrameAt(item.jde, lonRad, latRad, heightKM, params, inst)
 		frame.Label = localSolarEclipseDiagramPrimaryLabel(item.labels)
 		frame.Labels = append([]string(nil), item.labels...)
 		result.Frames = append(result.Frames, frame)
@@ -250,9 +254,10 @@ func localSolarEclipseDiagramLabelPriority(labels []string) int {
 
 func localSolarEclipseDiagramFrameAt(
 	jdTT, lonRad, latRad, heightKM float64,
-	params solarEclipseModelParameters,
-) LocalSolarEclipseDiagramFrame {
-	sunEquatorial, moonEquatorial := solarEclipseSunMoonEquatorial(jdTT)
+	params solarEclipseModelParameters, instances ...*Instance) LocalSolarEclipseDiagramFrame {
+	inst := instanceValue(instances)
+
+	sunEquatorial, moonEquatorial := solarEclipseSunMoonEquatorial(jdTT, inst)
 	sunXYZ := solarEclipseLLRToXYZ(sunEquatorial[0], sunEquatorial[1], sunEquatorial[2])
 	moonXYZ := solarEclipseLLRToXYZ(moonEquatorial[0], moonEquatorial[1], moonEquatorial[2])
 
@@ -278,14 +283,14 @@ func localSolarEclipseDiagramFrameAt(
 	)
 
 	sunRadiusRad := math.Asin(localSolarEclipseClampUnit(
-		solarEclipseEarthEquatorialRadiusKM * params.sunRadiusRatio / sunTopocentric[2],
+		geodata.EarthEquatorialRadiusKM * params.sunRadiusRatio / sunTopocentric[2],
 	))
 	moonRadiusRad := math.Asin(localSolarEclipseClampUnit(
 		solarEclipsePenumbralRadiusNumerator(params) / moonTopocentric[2],
 	))
 	if params.umbralK > params.penumbralK {
 		moonRadiusRad = math.Asin(localSolarEclipseClampUnit(
-			solarEclipseEarthEquatorialRadiusKM * params.umbralK * localSolarMoonRadiusScale / moonTopocentric[2],
+			geodata.EarthEquatorialRadiusKM * params.umbralK * localSolarMoonRadiusScale / moonTopocentric[2],
 		))
 	}