feat: 扩展天文计算能力

- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息
- 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算
- 新增木星伽利略卫星位置、现象与接触事件计算
- 新增恒星星表、星座判定、自行修正与观测辅助能力
- 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包
- 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算
- 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试
- 重构基础算法文件组织，补充大量公开 API 注释和语义回归测试
- 更新中文和英文 README，补充示例、精度说明、SVG 配图

eclipse/observation_helpers.go

@@ -0,0 +1,50 @@
+package eclipse
+
+import (
+	"time"
+
+	"b612.me/astro/basic"
+	"b612.me/astro/tools"
+)
+
+func moonSunLoDiff(date time.Time) float64 {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	sunLo := basic.HSunApparentLo(jde)
+	moonLo := basic.HMoonApparentLo(jde)
+	return tools.Limit360(moonLo - sunLo)
+}
+
+func solarAltitude(date time.Time, lon, lat float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	return basic.SunHeight(jde, lon, lat, float64(loc)/3600.0)
+}
+
+func solarCulminationTime(date time.Time, lon float64) time.Time {
+	jde := basic.Date2JDE(date.Add(time.Duration(-1*date.Hour())*time.Hour)) + 0.5
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	calcJde := basic.CulminationTime(jde, lon, timezone) - timezone/24.0
+	return basic.JDE2DateByZone(calcJde, date.Location(), false)
+}
+
+func lunarAzimuth(date time.Time, lon, lat float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	return basic.HMoonAzimuth(jde, lon, lat, float64(loc)/3600.0)
+}
+
+func lunarAltitude(date time.Time, lon, lat float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	return basic.HMoonHeight(jde, lon, lat, float64(loc)/3600.0)
+}
+
+func lunarCulminationTime(date time.Time, lon, lat float64) time.Time {
+	if date.Hour() > 12 {
+		date = date.Add(-12 * time.Hour)
+	}
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	return basic.JDE2DateByZone(basic.MoonCulminationTime(jde, lon, lat, float64(loc)/3600.0), date.Location(), true)
+}