feat: 完善日月食与月掩几何链路并扩展历法接口

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算，支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径，补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出，支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推，补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存，降低重复计算开销并提升边界稳定

planet/planet.go

@@ -5,16 +5,25 @@ import (
 	"math"
 )
 
-// WherePlanet returns the full VSOP result for the selected body and coordinate.
+// WherePlanet 天体 xt 在儒略日 jd 的 VSOP 结果 / VSOP result for body xt at Julian day jd.
+//
+// xt 取 -1 或 0..7：0 为地球，1..7 依次为水星、金星、火星、木星、土星、天王星、海王星；-1 表示地球，zn 取 0 时给日心黄经。
+// zn 取 0 黄经、1 黄纬、2 日心距（AU）；xt 或 zn 越界返回 NaN 而不 panic。
+// xt is -1 or 0..7 (0 Earth, 1..7 Mercury through Neptune; -1 selects Earth, giving its heliocentric longitude for zn 0).
+// zn is 0 longitude, 1 latitude, 2 heliocentric distance in AU; an out-of-range xt or zn yields NaN instead of panicking.
 func WherePlanet(xt, zn int, jd float64) float64 {
 	return WherePlanetN(xt, zn, jd, -1)
 }
 
-// WherePlanetN returns the VSOP result for the selected body and coordinate.
-// When n < 0, all terms are used. Otherwise n follows the original eph0.js
-// truncation semantics: keep roughly n principal terms from the 0th order
-// series and scale higher-order series proportionally.
+// WherePlanetN 同 WherePlanet 的截断版 / truncated form of WherePlanet.
+//
+// n < 0 时使用全部项；否则保留约 n 个主项并按比例缩短高阶项。取值域与越界行为同 WherePlanet。
+// When n < 0 all terms are used; otherwise roughly n principal terms are kept and higher orders scaled proportionally. Domain and out-of-range behavior match WherePlanet.
 func WherePlanetN(xt, zn int, jd float64, n int) float64 {
+	if xt < -1 || xt > 7 || zn < 0 || zn > 2 {
+		return math.NaN()
+	}
+
 	sata := 0
 	if xt == -1 {
 		xt = 0