在线体验： 仰观 — 中文星空罗盘

仰以观于天文 —— 《周易 · 系辞上》

仰观 是一个零依赖、单文件、可直接双击打开的交互式星图网页：给定任意时刻与任意地点，实时计算并展示太阳、月亮、八大行星与上千颗恒星在当地天空中的位置。

目录

1. 项目概述

仰观是一个纯前端、零依赖、单文件的星空观测工具。无需安装、无需联网，双击 index.html 即可使用。全部天文计算在浏览器内完成，所有星表数据内嵌于单一 HTML 文件中。

项目名字取自《周易 · 系辞上》的”仰以观于天文”，意在还原古人抬头望星的本真体验。

2. 核心功能

时间旅行

  • 任意日期时间的星空：在时间框里选择，或点「回到现在」
  • 动画播放：实时 / 每秒 1 分钟 / 每秒 1 小时 / 每秒 1 天 四档变速
  • 以「1天/秒」播放，可观察月亮约 27 天行完二十八宿、行星在恒星间游走

观测地点

  • 九个城市快捷按钮：北京 · 上海 · 广州 · 成都 · 乌鲁木齐 · 三亚 · 纽约 · 伦敦 · 悉尼
  • 下拉框另有拉萨、哈尔滨、西安，或手动输入经纬度、一键浏览器定位
  • 地点不同，同一时刻的星空完全不同——这正是地平坐标的意义

双视角

模式 说明
🌐 俯瞰天球 从天球外俯瞰的全方位星图：圆心是天顶，圆周是地平线（北在上 · 东在右），星星沿顺时针东升西落
🏔 地平仰望 模拟站在地面朝八方位之一抬头所见：地平线在底、天顶在顶，这才是「仰观」的本来姿势

自动演示

按键盘 D 或点击「自动演示」按钮，脚本会自动带观众走完六个场景：

  1. 此刻的星空（北京 · 俯瞰天球）
  2. 时间旅行：1天/秒 播放，看月亮穿行二十八宿、行星游走
  3. 悬停读诗：自动把鼠标滑向一颗有典故的亮星，浮现诗句
  4. 行星游走：1小时/秒 播放
  5. 换观测地点：伦敦 → 悉尼，同一时刻星空迥异
  6. 地平仰望：朝南、朝西仰望，东升西落

悬停即知

鼠标悬停任意星体，显示名称、视星等、高度角、方位角；有典故的星还会浮现诗句——比如悬停心宿二：

✦ 七月流火，九月授衣 ——《诗经 · 豳风 · 七月》

天象信息面板实时汇报：当地恒星时、太阳/月亮行至哪一宿、地平线上的行星清单。

3. 星空内容

  • 1191 颗恒星：55 颗中国命名亮星（天狼、织女、牛郎、北斗七星、心宿二”大火星”……）+ 耶鲁亮星星表（BSC5）4.7 等以内全部暗星，按色指数自动着色
  • 太阳 · 月亮 · 八大行星：开普勒轨道实时推算，月亮显示月相与照亮比例
  • 二十八宿分区：沿黄道带画出 28 宿分界与宿名，按四象配色（青龙绿 · 玄武蓝 · 白虎白 · 朱雀红）
  • 银河：沿真实银道坐标绘制，越靠银心越亮
  • 星座连线：北斗七星、猎户座、夏季大三角、仙后座、南十字
  • 诗词典故：13 颗名星戴金色光环，悬停即见诗句与出处

4. 诗词典故

星 诗句 出处
心宿二 七月流火，九月授衣 《诗经 · 豳风 · 七月》
参宿四 人生不相见，动如参与商 杜甫《赠卫八处士》
摇光（北斗七） 斗柄东指，天下皆春 《鹖冠子 · 环流》
天狼星 会挽雕弓射天狼 苏轼《江城子 · 密州出猎》
牛郎星 迢迢牵牛星，皎皎河汉女 《古诗十九首》
织女一 天阶夜色凉如水，卧看牵牛织女星 杜牧《秋夕》
王良四 王良策马，车骑满野 《史记 · 天官书》
箕宿三 维南有箕，不可以簸扬 《诗经 · 小雅 · 大东》
开阳（北斗六） 维北有斗，不可以挹酒浆 《诗经 · 小雅 · 大东》
昴宿六 嘒彼小星，维参与昴 《诗经 · 召南 · 小星》
毕宿五 月离于毕，俾滂沱矣 《诗经 · 小雅 · 渐渐之石》
北极星 譬如北辰，居其所而众星共之 《论语 · 为政》
斗宿四 南斗注生，北斗注死 《搜神记》

5. 使用建议

  • 认星：晚上对着一颗亮星问”这是谁”——把时间和地点对准此刻，悬停它
  • 看月行：播放调到「1天/秒」，看月亮每晚东移一站、穿行二十八宿
  • 看行星：播放「1小时/秒」，行星相对恒星缓缓移动，恒星整体旋转
  • 读诗：找到戴金环的星，悬停读诗——古人看的是同一片天

6. 技术实现

技术 说明
纯原生前端 零依赖、单 HTML 文件，无框架、无构建步骤
恒星计算 J2000.0 历元赤经赤纬 → 当地恒星时 → 地平坐标（高度/方位）
太阳系天体 Schlyter 开普勒轨道要素近似算法（精度约 1′～2′）
二十八宿 以各宿距星的 J2000 赤经划分天区
银河 J2000 标准银道→赤道旋转矩阵
暗星数据 耶鲁亮星星表（BSC5）节选，视星等 ≤ 4.7

7. 在线体验

👉 点击这里打开 仰观 — 中文星空罗盘

支持桌面端和移动端浏览器访问。全部功能离线可用，无任何外部依赖。

观乎天文，以察时变。