feat: 完善时标与天象几何计算并扩展输出接口

- 新增时标、ΔT 模型、质心时间与 UT1 支持
- 改进日月食、月掩、行星事件及路径边界计算
- 完善恒星三维自行与动态距离传播
- 扩展 SVG、GeoJSON、KML 输出与底层距离换算工具
- 整理中英文手册、示例资源及回归测试

lite/sun/sun.go

@@ -1,6 +1,7 @@
 package sun
 
 import (
+	"b612.me/astro/internal/civiltime"
 	"errors"
 	"math"
 	"time"
@@ -16,68 +17,68 @@ var (
 
 // TrueLo 轻量真黄经 / lightweight true ecliptic longitude.
 func TrueLo(date time.Time) float64 {
-	return lite.SunTrueLo(basic.Date2JDE(date.UTC()))
+	return lite.SunTrueLo(basic.Date2JD(date.UTC()))
 }
 
 // ApparentLo 轻量视黄经 / lightweight apparent ecliptic longitude.
 func ApparentLo(date time.Time) float64 {
-	return lite.SunApparentLo(basic.Date2JDE(date.UTC()))
+	return lite.SunApparentLo(basic.Date2JD(date.UTC()))
 }
 
 // Distance 轻量日地距离 / lightweight Sun-Earth distance in AU.
 func Distance(date time.Time) float64 {
-	return lite.SunDistanceAU(basic.Date2JDE(date.UTC()))
+	return lite.SunDistanceAU(basic.Date2JD(date.UTC()))
 }
 
 // TrueRa 轻量真赤经 / lightweight true right ascension.
 func TrueRa(date time.Time) float64 {
-	ra, _ := lite.SunTrueRaDec(basic.Date2JDE(date.UTC()))
+	ra, _ := lite.SunTrueRaDec(basic.Date2JD(date.UTC()))
 	return ra
 }
 
 // TrueDec 轻量真赤纬 / lightweight true declination.
 func TrueDec(date time.Time) float64 {
-	_, dec := lite.SunTrueRaDec(basic.Date2JDE(date.UTC()))
+	_, dec := lite.SunTrueRaDec(basic.Date2JD(date.UTC()))
 	return dec
 }
 
 // TrueRaDec 轻量真赤经、真赤纬 / lightweight true right ascension and declination.
 func TrueRaDec(date time.Time) (float64, float64) {
-	return lite.SunTrueRaDec(basic.Date2JDE(date.UTC()))
+	return lite.SunTrueRaDec(basic.Date2JD(date.UTC()))
 }
 
 // ApparentRa 轻量视赤经 / lightweight apparent right ascension.
 func ApparentRa(date time.Time) float64 {
-	ra, _ := lite.SunApparentRaDec(basic.Date2JDE(date.UTC()))
+	ra, _ := lite.SunApparentRaDec(basic.Date2JD(date.UTC()))
 	return ra
 }
 
 // ApparentDec 轻量视赤纬 / lightweight apparent declination.
 func ApparentDec(date time.Time) float64 {
-	_, dec := lite.SunApparentRaDec(basic.Date2JDE(date.UTC()))
+	_, dec := lite.SunApparentRaDec(basic.Date2JD(date.UTC()))
 	return dec
 }
 
 // ApparentRaDec 轻量视赤经、视赤纬 / lightweight apparent right ascension and declination.
 func ApparentRaDec(date time.Time) (float64, float64) {
-	return lite.SunApparentRaDec(basic.Date2JDE(date.UTC()))
+	return lite.SunApparentRaDec(basic.Date2JD(date.UTC()))
 }
 
 // HourAngle 轻量时角 / lightweight hour angle.
 func HourAngle(date time.Time, lon, lat float64) float64 {
-	_, _, hourAngle := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JDE(date.UTC()), lon, lat)
+	_, _, hourAngle := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JD(date.UTC()), lon, lat)
 	return hourAngle
 }
 
 // Azimuth 轻量方位角 / lightweight azimuth.
 func Azimuth(date time.Time, lon, lat float64) float64 {
-	_, azimuth, _ := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JDE(date.UTC()), lon, lat)
+	_, azimuth, _ := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JD(date.UTC()), lon, lat)
 	return azimuth
 }
 
 // Altitude 轻量高度角 / lightweight altitude.
 func Altitude(date time.Time, lon, lat float64) float64 {
-	altitude, _, _ := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JDE(date.UTC()), lon, lat)
+	altitude, _, _ := lite.HorizontalCoordinates(ApparentRa(date), ApparentDec(date), basic.Date2JD(date.UTC()), lon, lat)
 	return altitude
 }
 
@@ -88,30 +89,40 @@ func Zenith(date time.Time, lon, lat float64) float64 {
 
 // RiseTime 轻量日出时刻 / lightweight sunrise time.
 func RiseTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
+	if result, err, handled := civiltime.Event(date, basic.ErrNotOnThisDate, func(d time.Time) (time.Time, error) {
+		return RiseTime(d, lon, lat, height, aero)
+	}); handled {
+		return result, err
+	}
 	return riseSetTime(date, lon, lat, height, aero, true)
 }
 
 // SetTime 轻量日落时刻 / lightweight sunset time.
 func SetTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
+	if result, err, handled := civiltime.Event(date, basic.ErrNotOnThisDate, func(d time.Time) (time.Time, error) {
+		return SetTime(d, lon, lat, height, aero)
+	}); handled {
+		return result, err
+	}
 	return riseSetTime(date, lon, lat, height, aero, false)
 }
 
 func riseSetTime(date time.Time, lon, lat, height float64, aero, isRise bool) (time.Time, error) {
 	localMidnight := time.Date(date.Year(), date.Month(), date.Day(), 0, 0, 0, 0, date.Location())
-	localJD := basic.Date2JDE(localMidnight)
+	localJD := basic.Date2JD(localMidnight)
 	_, offset := localMidnight.Zone()
 	timezone := float64(offset) / 3600.0
 
 	horizonDip := basic.HeightDegreeByLat(height, lat)
 
 	altitudeFn := func(localJD float64) float64 {
-		utJD := localJD - timezone/24.0
-		ra, dec := lite.SunApparentRaDec(utJD)
-		altitude, _, _ := lite.HorizontalCoordinates(ra, dec, utJD, lon, lat)
+		utcJD := localJD - timezone/24.0
+		ra, dec := lite.SunApparentRaDec(utcJD)
+		altitude, _, _ := lite.HorizontalCoordinates(ra, dec, utcJD, lon, lat)
 		residual := altitude + horizonDip
 		if aero {
 			residual += basic.RefractionFromTrueAltitude(altitude, 1010, 10)
-			residual += liteSunSemidiameterDegrees(lite.SunDistanceAU(utJD))
+			residual += liteSunSemidiameterDegrees(lite.SunDistanceAU(utcJD))
 		}
 		return residual
 	}
@@ -127,7 +138,7 @@ func riseSetTime(date time.Time, lon, lat, height float64, aero, isRise bool) (t
 			return time.Time{}, err
 		}
 	}
-	return basic.JDE2DateByZone(eventJD, date.Location(), true), nil
+	return basic.JD2DateByZone(eventJD-timezone/24, date.Location(), false), nil
 }
 
 func liteSunSemidiameterDegrees(distanceAU float64) float64 {