feat: 扩展天文计算能力

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

sundial/doc.go

@@ -0,0 +1,22 @@
+// Package sundial provides apparent-solar-time helpers and planar-sundial
+// geometry utilities.
+//
+// 当前提供两层能力：
+//   - 真太阳时换算
+//   - 平太阳时换算
+//   - 太阳时角
+//   - 平太阳时 / 区时对应的时角与时间线采样
+//   - 平面日晷通用几何（影尖坐标、日晷中心、极轴晷针）
+//   - 平面日晷受光时角区间
+//   - 赤纬曲线的分段采样
+//   - 赤道 / 水平 / 垂直日晷特例
+//   - 水平日晷时线角
+//
+// 对地方平太阳时时间线采样时，传入的 date 应处于目标地点的地方平太阳时区；
+// 对区时时间线采样时，date 负责提供民用日期与时区，原有钟面时间会被目标钟面读数替换。
+//
+// The package covers apparent solar time, mean solar time, hour-angle
+// conversions for mean or zone time, general planar sundial geometry,
+// illuminated hour-angle intervals, declination-curve sampling, and a few
+// common special cases such as equatorial, horizontal, and vertical dials.
+package sundial