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

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

eclipse/solar_shadow.go

@@ -121,16 +121,16 @@ type SolarEclipseShadowSolver struct {
 }
 
 // NewSolarEclipseShadowSolver 构造单时刻求解器 / builds a single-instant solver.
-func NewSolarEclipseShadowSolver(options SolarEclipseShadowSolverOptions) *SolarEclipseShadowSolver {
+func (module *Eclipse) NewSolarEclipseShadowSolver(options SolarEclipseShadowSolverOptions) *SolarEclipseShadowSolver {
 	return &SolarEclipseShadowSolver{
 		options: options,
-		inner: basic.NewSolarEclipseShadowSolver(basic.SolarEclipseShadowSolverOptions{
+		inner: basic.NewSolarEclipseShadowSolverWithInstance(basic.SolarEclipseShadowSolverOptions{
 			Model:           basic.SolarEclipseRadiusModel(options.Model),
 			DeltaTSeconds:   options.DeltaTSeconds,
 			BoundaryPoints:  options.BoundaryPoints,
 			Kind:            basic.SolarEclipseShadowKind(options.Kind),
 			TargetSpacingKM: options.TargetSpacingKM,
-		}),
+		}, module.inst),
 	}
 }
 
@@ -239,13 +239,13 @@ func solarEclipseStationStateFromBasic(
 }
 
 // SolarEclipseShadowAt 无状态便捷入口，可并发调用 / stateless convenience entry point.
-func SolarEclipseShadowAt(value time.Time) (SolarEclipseShadowInstant, bool) {
-	return NewSolarEclipseShadowSolver(SolarEclipseShadowSolverOptions{}).ShadowAt(value)
+func (module *Eclipse) SolarEclipseShadowAt(value time.Time) (SolarEclipseShadowInstant, bool) {
+	return module.NewSolarEclipseShadowSolver(SolarEclipseShadowSolverOptions{}).ShadowAt(value)
 }
 
 // SolarEclipseStationStateAt 无状态便捷入口，可并发调用 / stateless convenience entry point.
-func SolarEclipseStationStateAt(value time.Time, lon, lat, height float64) SolarEclipseStationState {
-	return NewSolarEclipseShadowSolver(SolarEclipseShadowSolverOptions{}).StationStateAt(value, lon, lat, height)
+func (module *Eclipse) SolarEclipseStationStateAt(value time.Time, lon, lat, height float64) SolarEclipseStationState {
+	return module.NewSolarEclipseShadowSolver(SolarEclipseShadowSolverOptions{}).StationStateAt(value, lon, lat, height)
 }
 
 func finiteEclipseValue(value float64) bool {
@@ -299,15 +299,15 @@ func (solver *SolarEclipseShadowSolver) StationStatesBetween(
 }
 
 // SolarEclipseShadowBetween 无状态批量入口，使用进程级 ΔT / stateless batch entry point.
-func SolarEclipseShadowBetween(
+func (module *Eclipse) SolarEclipseShadowBetween(
 	start, end time.Time, step time.Duration,
 ) []SolarEclipseShadowInstant {
-	return SolarEclipseShadowBetweenWithOptions(start, end, step, SolarEclipseShadowSolverOptions{})
+	return module.SolarEclipseShadowBetweenWithOptions(start, end, step, SolarEclipseShadowSolverOptions{})
 }
 
 // SolarEclipseShadowBetweenWithOptions 可显式指定 ΔT 与模型 / with explicit ΔT and model.
-func SolarEclipseShadowBetweenWithOptions(
+func (module *Eclipse) SolarEclipseShadowBetweenWithOptions(
 	start, end time.Time, step time.Duration, options SolarEclipseShadowSolverOptions,
 ) []SolarEclipseShadowInstant {
-	return NewSolarEclipseShadowSolver(options).ShadowBetween(start, end, step)
+	return module.NewSolarEclipseShadowSolver(options).ShadowBetween(start, end, step)
 }