StarTrail v1.2.0

StarTrail 星迹 v1.2.0

本地运行的开源天文观测规划桌面软件（PySide6 + Skyfield）。本版本聚焦交互升级与渲染稳定性：双击天体改为应用内详情面板、观测设备星等过滤、小行星轨道数据修复，并修复了「实时星空完全不显示」的黑屏回归。

更新亮点

• 📖 双击打开内置详情面板：双击天体不再跳出浏览器，改为应用内 BodyDetailPanel，离线也有本地观测数据兜底（航空器实时 ADS-B；小行星 / 彗星轨道根数；通用维基摘要配图），绝不空白。
• 🔭 观测设备星等过滤：恒星、深空天体、小行星 / 彗星、人造卫星全部按所选设备的极限星等过滤可见性（肉眼 5.5 / 双筒 9.0 / 望远镜 12.0 / 大型·相机 99），与真实观感一致——选「肉眼」时小行星、卫星会自动隐藏。
• 🪐 小行星 / 彗星详情修复：双击小行星 / 彗星现展示完整本地轨道数据块（半长轴 / 偏心率 / 周期 / 近日远日点 / 倾角等），并规范维基标题命中率。
• 🛠 修复「实时星空完全不显示」黑屏回归：修复 GL 渲染器中一处 uniform 设置 helper 在部分环境下静默失效导致恒星不渲染的问题，星空恢复稳定显示。
• ✈️ 航空器详情增强：详情面板新增机型、注册号、ICAO24、升降率等实时字段。
• 📚 README 重写（445 行 / 10 章），版本号四处同步至 1.2.0；新增星图图例详解、设备星等过滤、图层开关章节。

下载与运行

1. 下载本页的 StarTrail_v1.2.0.zip。
2. 解压后双击 StarTrail.exe 即可运行（Windows 10 / 11，64 位，无需安装 Python）。
3. 首次启动会加载本地 de421.bsp 星历与 data/ 目录，基础星空无需联网即可查看。

若你的机器显卡驱动 / 远程桌面环境下 OpenGL 表现异常，可在「设置 → GL 渲染开关」中关闭 GL 渲染，改用稳定的 2D 渲染器。

校验

• StarTrail_v1.2.0.zip 解压后包含 StarTrail.exe 与 _internal/ 依赖目录。
• 完整更新日志见仓库 README「更新日志」章节。

StarTrail v1.1.0

StarTrail 星迹 v1.1.0

本地运行的开源天文观测规划桌面软件（PySide6 + Skyfield）。本版本聚焦于实时星空的渲染稳定性，并附带一份完整重写、含详细使用手册的 README。

更新亮点

• 🔧 实时星空渲染稳定性大修：修复 OpenGL 混合渲染器 GLHybridChart 因 QOpenGLShader 未导入导致的初始化崩溃，以及绘制阶段的 OverflowError 崩溃（此前表现为启动即崩 / 星空整片黑屏）。
• 🛡️ 新增运行时自动降级：OpenGL 初始化失败时，软件会无缝切换到稳定的 2D（StarChart）渲染器，绝不黑屏或崩溃。默认仍优先使用 GPU 加速星空。
• ✈️ 航空器与数据修复：修复航空器告警面板（未定义变量导致告警不显示）；修正 ADS-B 高度单位（米/英尺、m/s 与 fpm 的混淆）；修正最佳观测窗口计算（此前结束时间恒为 24 点）。
• 🧹 清理与瘦身：删除死代码 gl_star_chart.py；重新打包时移除约 322MB 未用 Qt 资源，最终体积约 402MB。
• 📚 文档：全量重写 README，包含界面导览、详细使用手册（实时星空 / 观星预报 / 天象日历 / 设置 / 侧边栏 / 渲染模式排错）、FAQ、从源码构建说明。

以上连同此前全库审计的 14 项修复（统一 HTTP 客户端与缓存、VPN 安全定位、侧边栏可拖拽、信息链接、降水预报等）一并随本版本发布。

下载与运行

1. 下载本页的 StarTrail_v1.1.0.zip。
2. 解压后双击 StarTrail.exe 即可运行（Windows 10 / 11，64 位，无需安装 Python）。
3. 首次启动会加载本地 de421.bsp 星历与 data/ 目录，基础星空无需联网即可查看。

若你的机器显卡驱动 / 远程桌面环境下 OpenGL 表现异常，可在「设置 → GL 渲染开关」中关闭 GL 渲染，改用稳定的 2D 渲染器。

校验

• StarTrail_v1.1.0.zip 解压后包含 StarTrail.exe 与 _internal/ 依赖目录。
• 完整更新日志见仓库 README「更新日志」章节。

StarTrail v1.0.2

星迹 StarTrail v1.0.2

本地天文预测软件。本版本聚焦 UI 重设计、交互修复与文档完善。

更新亮点

• 可拖拽调宽侧边栏：在右缘拖动即可调节宽度（180–450px，自动记忆）
• 修复拖拽不跟手：改用锚点宽度 + 累计位移，1:1 精确跟随鼠标
• 双击天体打开资料页：统一移除失效的 starfyi.com，改为维基百科 / Aladin / N2YO / Flightradar24 等稳定来源（含搜索兜底，永不死链）
• 观星适宜度评分去重：移除重复的右侧文字评分，仅保留居中仪表盘
• 修复降水预报不显示：修复缓存未赋值导致始终为 "--" 的问题
• 全代码库审计：14 处真实 bug 修复（QColor 崩溃、时区、配置容错、FOV 取景框等）
• 玻璃拟态主题 + 观星指数环表全新视觉
• README 全量重写：含详细使用手册

使用

解压 StarTrail_v1.0.2.zip，运行 dist/StarTrail/StarTrail.exe。

星迹 StarTrail v1.0.1

星迹 StarTrail v1.0.1

🐛 Bug 修复

• 修复 Skyfield 星历表在中国大陆无法下载 JPL 的问题（改为离线加载）
• 修复 Skyfield 模块作用域问题（wgs84/Star/EarthSatellite NameError）
• 修复 SkyView 启动崩溃（ac_label/sat_info hasattr 保护）
• 修复日历视图同步网络调用导致的 UI 冻结
• 修复月相算法（之前错误使用了经度而非相位角）
• 修复 Dubhe/Alkaid 天体坐标
• 修复 GL 渲染器近似本地恒星时计算

🚀 改进

• 全面异步化：天气、ADS-B、ISS TLE、观星指南、IP 定位、天文计算、DSO 筛选、日历卫星全部移至后台线程
• 新增大气折射校正
• BackgroundWorker 添加回调销毁保护（_safe_finished/_safe_error）
• StarChart/GLHybridChart 刷新完全异步

📦 构建优化

• 排除 torch/scipy/sklearn/transformers/pandas/matplotlib/PIL 等非必要包
• 构建时间从 ~10 分钟降至 ~2 分钟
• 安装包 398MB → 145MB（zip）

📖 文档

• 完整详细的中文 README，含界面导览、功能教学、操作说明

下载

下载 ZIP 后解压，双击 StarTrail.exe 即可运行。需要 Windows 10/11 64 位。