三垣二十八星宿 古代中国天官 · 三维星图

中国传统天官将北天恒星划分为三垣与二十八宿：二十八宿按方位归于东、北、西、南四象——青龙、玄武、白虎、朱雀，三垣（紫微垣、太微垣、天市垣）环拱于北天。下图以四象分色、星官连线，呈现这 631 颗可定坐标恒星的相对分布。

二十八宿是沿黄道/赤道附近分布的恒星分区，每宿含一个主星官及若干附属星官。下表列出各宿所属四象。

本三维星空图是独立插件（three-star-map-plugin.js），自动加载 three.js，暴露全局 ChineseStarMap。只需两个脚本 + 一个容器，即可嵌入任意页面。悬停显示星名、点击星官、点击图例开关四象等交互已内置。

<!-- 1. 星表数据 -->
<script src="star_data.js"></script>
<!-- 2. 三维星图插件（自动加载 three.js，无需宿主引入） -->
<script src="three-star-map-plugin.js"></script>

<!-- 3. 任意容器 -->
<div id="sky" style="width:100%;height:600px"></div>

<!-- 4. 初始化 -->
<script>
  const map = ChineseStarMap.create('#sky', {
    data: window.STAR_DATA,   // 省略则读取全局 STAR_DATA
    showLabels: true,         // 星宿名标签（默认开）
    backgroundColor: '#05070d'
  });
  map.setLines(true);          // 开关连线
  map.setFilter('青龙', true); // 开关某四象
  map.setLabels(true);        // 开关星宿名标签
  map.resetCamera();
</script>