Appearance
变更日志
kbe3d-core（KBCore）
2026年7月18日
Bug Fix 错误修复
- 修复
getDropSampledPositions函数参数名称错误：将lastSecondPosition改为nextSecondPosition，并相应更新物理计算逻辑，改用「下一秒位置」计算初始速度，修正了速度方向取反的问题。
Optimize 改进优化
- 改进自由落体运动轨迹计算算法：正确处理掉落时刻的初始竖直速度分量（投影到本地
up轴，>0向上、<0向下）与落地时间（由h0 + vz0·t − ½gt² = 0解正根），支持更真实的抛物线物理模拟；vz0=0时自动退化为原自由落体公式。 - 优化代码格式：导入语句多行拆分、函数调用参数换行、注释位置调整、
ts-ignore注释位置统一、多处三元运算符与条件判断格式修正。 - 更新
getDropSampledPositions函数文档注释，明确参数含义与单位说明。 - 包版本由
3.0.5升级至3.0.6。
2026年7月17日
Features 新增
- 新增相机缩放因子设置与自由落体轨迹计算能力：
- 新增
setZoomFactor函数，支持自定义 Cesium 相机缩放因子，便于统一控制地图缩放手感； - 新增
isJulianDate类型判断函数，用于安全地识别时间类型； - 新增
getDropSampledPositions函数，可基于运动反方向计算自由落体运动轨迹，并支持考虑地形高度，使掉落物能贴合真实地表落点； - 优化坐标变换算法，改用矩阵运算替代原有手动计算，提升可读性与准确性；
- 新增
2026年7月15日
Features 新增
- 新增网格图元生成功能：新增
getGridsPrimitive函数，可根据起点与终点构成的矩形区域生成按色带着色的网格图元，支持自定义网格大小、最大网格数量、色带配置等参数，返回Cesium.GroundPrimitive实例用于批量渲染；同时引入GeometryInstance类型定义。
Optimize 改进优化
- 调整地图工具函数文件中的导入顺序，将
ChinaCRSValue类型导入语句从文件顶部注释之前移动到注释之后，使代码结构更加清晰合理。 - 包版本由
3.0.3升级至3.0.4。
2026年7月12日
Optimize 改进优化
- 调整工具类文件结构并更新版本：将
BaseClass、Popup、LatLngPoint、MouseTooltip、HighlightTileset等工具类从utils目录迁移至utils/class子目录；同步更新Earth.ts、BaseEffect.ts、index.ts、ColorPatternGridPrimitive.ts、TilesetLayer.ts、BaseLayer.ts中的相关导入路径；删除已迁移的独立工具类文件；package.json版本由3.0.2升级至3.0.3。
2026年7月9日
Bug Fix 错误修复
- 修复坐标解析兼容性问题：修复
LatLngArray、LatLngPoint、Popup等工具类中坐标解析的兼容性问题，支持更多类型的坐标输入格式；移除Earth类中hasTerraingetter 的多余换行；优化BaseMaterialConver中repeat属性处理的条件判断；修复地图相关工具函数中的代码格式和类型兼容问题；更新 A* 寻路算法实现中的代码结构和错误处理；调整play-local示例中的测试坐标点。
Optimize 改进优化
- 移除
package.json发布脚本中的调试参数-d，确保正常发布流程；包版本更新至3.0.2。
2026年4月22日
Bug Fix 错误修复
- 修复
LatLngPoint代码 bug。
2026年4月17日
Bug Fix 错误修复
- 类型修复：UMD 模式下全局变量命名改为
KBCore。
2026年3月22日
Features 新增
- KBSatellite 库发布（核心库同步版本与目录调整）。
2026年3月19日
Bug Fix 错误修复
- 修复若干细节问题。
2026年3月18日
Optimize 改进优化
- 目录结构调整，新增 satellite 库，核心库同步调整包结构。
kbe3d-satellite（KBSatellite）
2026年7月6日
Features 新增
- 升级版本
0.0.3→0.0.4；增强 TLE 格式处理与错误处理：增强handlerError错误处理函数，支持字符串类型的错误信息；新增formatTle1工具函数用于格式化 TLE 第一行数据，修复可能的格式错误；在 CPU 和 GPU 轨道传播器中集成 TLE 格式化功能；为 GPU 传播错误添加详细注释，说明 f64 精度需求与硬件限制问题；移除发布脚本中的调试参数-d。
2026年4月28日
Bug Fix 错误修复
- 修复若干细节问题。
2026年4月15日
Features 新增
detail添加瞬时根数，并统一单位。
2026年4月14日
Features 新增
OrbitPropagatorResult添加meanElements返回值。
2026年3月22日
Features 新增
- KBSatellite 库正式发布。
2026年3月21日
Features 新增
- 完成 GPU 批量实时计算方法与测试，下一步编写示例场景发布文档。
- 完成
sgp4BatchLoopWithGPU实现（待测试）。
Bug Fix 错误修复
- 修复若干细节问题。
2026年3月20日
Optimize 改进优化
- 性能优化中（轨道传播性能调优）。
- 类库导出优化。
Bug Fix 错误修复
- 修复
transformer转换 bug，添加轨道外推示例。 - 完成 SGP4 测试（GPU 比 CPU 慢，原因待查）。
2026年3月19日
Bug Fix 错误修复
- 修复若干细节问题。
2026年3月18日
Features 新增
- 完成 SGP4 轨道预报开发（待测试）。
Optimize 改进优化
- 目录结构调整，新增 satellite 库。