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

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

basic/mercury.go

@@ -108,59 +108,34 @@ func MercuryMag(jde float64) float64 {
 	return FloatRound(mag, 2)
 }
 
-func MercuryHeight(localJD, lon, lat, timezone float64) float64 {
-	// 转换为世界时
-	utcJD := localJD - timezone/24.0
-	// 计算视恒星时
-	ra, dec := MercuryApparentRaDec(UTC2TT(utcJD))
-	st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
-	// 计算时角
-	hourAngle := Limit360(st - ra)
-	// 高度角、时角与天球座标三角转换公式
-	// sin(h)=sin(lat)*sin(dec)+cos(dec)*cos(lat)*cos(hourAngle)
-	sinHeight := Sin(lat)*Sin(dec) + Cos(dec)*Cos(lat)*Cos(hourAngle)
-	return ArcSin(sinHeight)
+// MercuryHeightWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercuryHeightWithInstance(localJD, lon, lat, timezone float64, inst *Instance) float64 {
+	return planetHeightN(1, localJD, lon, lat, timezone, -1, inst)
 }
 
-func MercuryAzimuth(localJD, lon, lat, timezone float64) float64 {
-	// 转换为世界时
-	utcJD := localJD - timezone/24.0
-	// 计算视恒星时
-	ra, dec := MercuryApparentRaDec(UTC2TT(utcJD))
-	st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
-	// 计算时角
-	hourAngle := Limit360(st - ra)
-	// 三角转换公式
-	tanAzimuth := Sin(hourAngle) / (Cos(hourAngle)*Sin(lat) - Tan(dec)*Cos(lat))
-	azimuth := ArcTan(tanAzimuth)
-	if azimuth < 0 {
-		if hourAngle/15 < 12 {
-			return azimuth + 360
-		}
-		return azimuth + 180
-	}
-	if hourAngle/15 < 12 {
-		return azimuth + 180
-	}
-	return azimuth
+// MercuryAzimuthWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercuryAzimuthWithInstance(localJD, lon, lat, timezone float64, inst *Instance) float64 {
+	return planetAzimuthN(1, localJD, lon, lat, timezone, -1, inst)
 }
 
-func MercuryHourAngle(jd, lon, timezone float64) float64 {
+// MercuryHourAngleWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercuryHourAngleWithInstance(jd, lon, timezone float64, inst *Instance) float64 {
 	siderealLongitude := Limit360(ApparentSiderealTime(UTC2UT1(jd-timezone/24))*15 + lon)
-	hourAngle := siderealLongitude - MercuryApparentRa(UTC2TT(jd-timezone/24.0))
+	hourAngle := siderealLongitude - MercuryApparentRaWithInstance(UTC2TT(jd-timezone/24.0), inst)
 	if hourAngle < 0 {
 		hourAngle += 360
 	}
 	return hourAngle
 }
 
-func MercuryCulminationTime(localJD, lon, timezone float64) float64 {
+// MercuryCulminationTimeWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercuryCulminationTimeWithInstance(localJD, lon, timezone float64, inst *Instance) float64 {
 	// localJD 是本地民用日锚点（当地 0 时），不是力学时。
 	//ra,dec 瞬时天球座标，非J2000等时间天球坐标
 	localJD = math.Floor(localJD) + 0.5
-	estimateJD := localJD + Limit360(360-MercuryHourAngle(localJD, lon, timezone))/15.0/24.0*0.99726851851851851851
+	estimateJD := localJD + Limit360(360-MercuryHourAngleWithInstance(localJD, lon, timezone, inst))/15.0/24.0*0.99726851851851851851
 	normalizedHourAngle := func(localJD, lon, timezone float64) float64 {
-		currentHourAngle := MercuryHourAngle(localJD, lon, timezone)
+		currentHourAngle := MercuryHourAngleWithInstance(localJD, lon, timezone, inst)
 		if currentHourAngle < 180 {
 			currentHourAngle += 360
 		}
@@ -178,14 +153,22 @@ func MercuryCulminationTime(localJD, lon, timezone float64) float64 {
 	return estimateJD
 }
 
-func MercuryRiseTime(jd, lon, lat, timezone, aeroCorrection, observerHeight float64) (float64, error) {
-	return mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, true)
+// MercuryRiseTimeWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercuryRiseTimeWithInstance(jd, lon, lat, timezone, aeroCorrection, observerHeight float64, inst *Instance) (float64, error) {
+	return mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, true, inst)
 }
 
-func MercurySetTime(jd, lon, lat, timezone, aeroCorrection, observerHeight float64) (float64, error) {
-	return mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, false)
+// MercurySetTimeWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
+func MercurySetTimeWithInstance(jd, lon, lat, timezone, aeroCorrection, observerHeight float64, inst *Instance) (float64, error) {
+	return mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, false, inst)
 }
 
-func mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight float64, isRise bool) (float64, error) {
-	return planetRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, isRise, MercuryCulminationTime, MercuryHeight, MercuryApparentDec)
+func mercuryRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight float64, isRise bool, instances ...*Instance) (float64, error) {
+	inst := instanceValue(instances)
+
+	return planetRiseDown(jd, lon, lat, timezone, aeroCorrection, observerHeight, isRise, func(localJD, lon, timezone float64) float64 {
+		return MercuryCulminationTimeWithInstance(localJD, lon, timezone, inst)
+	}, func(localJD, lon, lat, timezone float64) float64 {
+		return MercuryHeightWithInstance(localJD, lon, lat, timezone, inst)
+	}, func(jde float64) float64 { return MercuryApparentDecWithInstance(jde, inst) })
 }