Repolode
提交项目
gunerguner

gunerguner/AdAstra

一款可离线使用的网页版实时星空应用，在浏览器中还原任意地点与时间的本地天空。

可替代:Stellarium

在 GitHub 查看
Star
138
Fork
13
未关闭 Issue
0
最近提交
7天前

这是什么？

Ad Astra 是一款运行在浏览器中的星空模拟应用。你可以从预设城市中选择观测地点，也可以直接输入经纬度，再设定一个时间点，应用便会绘制当地的天空，包括亮星、星座连线、太阳、月亮以及水星到海王星的各颗行星，并随地球自转和公转实时变化。

视角支持拖动与缩放，可一键跳转到东南西北方向或天顶。时间轴可以播放、暂停或拖动，覆盖约八小时范围，也可按小时、天、年、十年乃至世纪步进。银河、黄道、天赤道以及各类坐标网格都能单独开关，天空颜色会随日光、晨昏蒙影和夜色连续变化。正式构建版本包含 Service Worker，首次加载后即可离线打开。

该项目是面向科普的模拟工具，适合用来认识星座和昼夜变化，不适用于专业观测或导航。它是纯静态前端，没有运行时后端，基于 React、TypeScript、Three.js（WebGL2），并在 Web Worker 中运行 Astronomy Engine 计算天体位置。

核心功能

  • 01按所选地点和时间显示亮星、星座连线、太阳、月亮和行星。
  • 02支持选择预设城市，也可手动输入经纬度。
  • 03时间播放速率从实时到每秒 100 年可调。
  • 04银河、黄道、坐标网格等图层可单独开关。
  • 05天空颜色和星星可见度随太阳高度在晨昏各阶段连续变化。
  • 06通过 Service Worker 在首次加载后支持离线使用。

适用场景

  • 学习辨认星座及其随季节变化的位置。
  • 理解白天、夜晚与晨昏期间天空的变化规律。
  • 查看某地某个日期的天空大致状况。
  • 在课堂或科普活动中演示地球自转与公转如何影响我们所见的天空。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/gunerguner/AdAstra.git
  2. 2

    进入项目目录

    cd AdAstra
  3. 3

    安装依赖

    pnpm install --frozen-lockfile
  4. 4

    启动开发服务器并打开本地地址

    pnpm dev

使用前须知

  • 本应用是科普天空模拟，不适合专业观测、导航或科研计算。
  • 需要 Node.js 20.19+ 或 22.12+、pnpm 10，以及支持 WebGL2 的浏览器。
  • 元数据显示没有许可证，尽管 README 声明为 MIT 许可，但复用条款并不明确。

标签

#astronomy#webgl#threejs#react#typescript#pwa#simulation#education

常见问题

AdAstra 是什么？
一款可离线使用的网页版实时星空应用，在浏览器中还原任意地点与时间的本地天空。 Ad Astra 是一款运行在浏览器中的星空模拟应用。你可以从预设城市中选择观测地点，也可以直接输入经纬度，再设定一个时间点，应用便会绘制当地的天空，包括亮星、星座连线、太阳、月亮以及水星到海王星的各颗行星，并随地球自转和公转实时变化。
AdAstra 可以免费使用吗？用的什么许可证？
AdAstra 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。
AdAstra 还在维护吗？
活跃维护中。AdAstra 最近一次提交是在 2026年10月13日。
AdAstra 适合用来做什么？
学习辨认星座及其随季节变化的位置。 理解白天、夜晚与晨昏期间天空的变化规律。 查看某地某个日期的天空大致状况。 在课堂或科普活动中演示地球自转与公转如何影响我们所见的天空。
AdAstra 怎么安装和运行？
克隆仓库: git clone https://github.com/gunerguner/AdAstra.git 进入项目目录: cd AdAstra 安装依赖: pnpm install --frozen-lockfile 启动开发服务器并打开本地地址: pnpm dev
在哪里获取 AdAstra？
源代码和安装说明在 GitHub 上：https://github.com/gunerguner/AdAstra

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目