satellite-js 6.0.0 版本发布：全面升级的卫星轨道计算库

satellite-js 是一个用于卫星轨道计算的 JavaScript 库，它实现了 SGP4/SDP4 轨道模型算法，能够准确计算人造卫星的位置和速度。这个库广泛应用于卫星跟踪、航天任务规划、天文观测等领域。

重大更新内容

TypeScript 全面重构

6.0.0 版本最显著的变化是将整个库从 JavaScript 迁移到了 TypeScript。这意味着：

1. 类型定义不再需要手动维护，而是直接从源代码编译生成
2. 开发者可以获得更好的类型提示和代码补全
3. 减少了运行时类型错误的可能性

新增 JSON 格式轨道数据支持

新版本引入了 json2satrec 函数，专门用于解析 OMM(轨道参数消息)格式的轨道数据。OMM 是 NASA 定义的标准轨道数据格式，现在被 Celestrak 和 Space-Track 等主要卫星数据提供商广泛采用。

这个函数支持从以下来源获取的 JSON 格式数据：

• Celestrak 的"Current GP Element Sets"页面(选择JSON格式)
• Space-Track 的"Recent ELSETs"页面(需要手动修改URL格式)

函数返回值结构变更

这是一个破坏性变更，sgp4 和 propagate 函数的返回值结构从：

{
  position: EciVec3<Kilometer> | false
  velocity: EciVec3<KilometerPerSecond> | false
}

变更为：

null | {
  position: EciVec3<Kilometer>
  velocity: EciVec3<KilometerPerSecond>
  meanElements: MeanElements
}

现在如果传播计算失败，会直接返回 null 而不是部分字段为 false，这使得错误处理更加明确。

新增功能与改进

1. SatRecError 枚举：新增了包含所有可能错误代码的枚举，方便开发者处理卫星轨道计算中的各种错误情况。

2. 平均轨道元素：传播函数现在会返回 meanElements，包含传播时刻的轨道参数演化状态。这些数据是 SGP4 模型内部计算的自然副产品，不会影响性能。

3. 太阳位置计算：新增 sunPos 函数，可以计算特定日期太阳的位置，精度在1950-2050年间达到0.01角秒。这对于判断卫星是否在地球阴影中非常有用。

4. 多普勒因子修正：修复了 dopplerFactor 函数的计算逻辑，现在能正确反映卫星朝向或远离观察者运动时的多普勒效应。

5. 文档完善：大量 SatRec 对象的属性现在有了完整文档，方便开发者理解和使用。

技术细节解析

OMM 格式支持的意义

OMM(Orbit Mean-element Message)是NASA定义的标准化轨道数据格式，包含卫星轨道参数和元数据。json2satrec 函数的加入使得 satellite-js 能够直接处理从权威数据源获取的最新轨道数据，大大简化了数据获取和处理的流程。

类型系统改进带来的好处

TypeScript 重构不仅仅是语法上的变化，它带来了以下实质性改进：

1. 编译时类型检查可以捕获许多潜在错误
2. 自动生成的类型定义与实现保持同步
3. 开发者可以获得更丰富的IDE支持
4. 库的API使用更加明确和自文档化

平均轨道元素的应用

返回的平均轨道元素(meanElements)包含了传播时刻的轨道参数，这些数据对于以下场景非常有用：

1. 轨道演化分析
2. 长期轨道预测
3. 轨道参数可视化
4. 与其他轨道模型的对比

升级建议

对于现有项目升级到6.0.0版本，开发者需要注意：

1. 检查所有使用 sgp4 和 propagate 函数的地方，更新错误处理逻辑
2. 如果项目中使用自定义类型定义，可以移除它们，直接从库中导入
3. 考虑使用新的 json2satrec 函数简化轨道数据获取流程
4. 利用新的 sunPos 和 meanElements 功能增强应用能力

总结

satellite-js 6.0.0 版本是一次重大升级，通过TypeScript重构提高了代码质量和开发体验，新增的OMM格式支持简化了与主流数据源的集成，而各种新功能和改进则扩展了库的应用场景。这些变化使得 satellite-js 在现代卫星轨道计算领域保持了领先地位，为开发者提供了更强大、更易用的工具。