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

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

moon/occultation_star.go

@@ -6,20 +6,13 @@ import (
 	"b612.me/astro/basic"
 )
 
-// FindStarOccultations 搜索单颗点源恒星的月掩星。
-//
-// 输入坐标从历元传播并转换到当日视坐标系。此函数不会加载内嵌星表；需要星表搜索时，调用者必须显式加载并选择恒星。经度东为正、纬度北为正，单位为度；高度为平均海平面以上米数。
-// FindStarOccultations searches for lunar occultations of one point-source star.
-// The input coordinate is propagated from its epoch and converted to the apparent frame of date. This function never loads the embedded star catalog; callers that need catalog searches must load and select stars explicitly. Longitude is east-positive in degrees, latitude is north-positive in degrees, and height is the observer elevation above mean sea level in meters.
-func FindStarOccultations(start, end time.Time, star StarCoordinate, longitude, latitude, height float64,
+// FindStarOccultations 搜索单颗点源恒星的月掩星 / occultations of a point-source star at a fixed site.
+func (module *Moon) FindStarOccultations(start, end time.Time, star StarCoordinate, longitude, latitude, height float64,
 	options OccultationSearchOptions) ([]StarOccultationInfo, error) {
-	return basic.FindStarOccultations(start, end, star, longitude, latitude, height, options)
+	return basic.FindStarOccultationsWithInstance(start, end, star, longitude, latitude, height, module.occultationOptions(options), module.inst)
 }
 
-// FindBestStarOccultations 返回窗口内每次恒星月掩的全球海平面几何掩甚点。
-// 点选择不使用地平线或可见性评分；查询端点使用核心求解器的 10 ms 数值选择容差。
-// FindBestStarOccultations returns the global geometric greatest sea-level point for every stellar occultation whose greatest instant is in the window.
-// The point is selected without a horizon or visibility score. Query endpoints use the core solver's 10 ms numerical selection tolerance.
-func FindBestStarOccultations(start, end time.Time, star StarCoordinate, options OccultationSearchOptions) ([]StarOccultationInfo, error) {
-	return basic.FindBestStarOccultations(start, end, star, options)
+// FindBestStarOccultations 返回窗口内每次恒星月掩的全球海平面几何掩甚点 / global greatest points of stellar occultations in a window.
+func (module *Moon) FindBestStarOccultations(start, end time.Time, star StarCoordinate, options OccultationSearchOptions) ([]StarOccultationInfo, error) {
+	return basic.FindBestStarOccultationsWithInstance(start, end, star, module.occultationOptions(options), module.inst)
 }