Add VSOP87A/ELPMPP02 fallback, CI and tests

Introduce built-in planetary series fallback (VSOP87A + ELPMPP02) and test/CI support. Adds elpmpp02 and vsop87a source data and headers, new CMake options LUNAR_ENABLE_SERIES_FALLBACK and LUNAR_BUILD_TESTS, and refactors CMake to produce a lunar_core static library used by executables and DLL. Adds GitHub Actions CI workflow and updates Release workflow to enable the fallback flag and include series data in packaged artifacts. README updated to document the fallback behavior, new build/test instructions and configuration options; tests/ subdirectory and ctest integration added.

Author: lzray-universe

.github/workflows/CI.yml

@@ -0,0 +1,55 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    name: ${{ matrix.name }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            name: linux-x64
+            cmake_args: ""
+
+          - os: ubuntu-24.04-arm
+            name: linux-arm64
+            cmake_args: ""
+
+          - os: windows-latest
+            name: windows-x64
+            cmake_args: "-A x64"
+
+          - os: windows-11-arm
+            name: windows-arm64
+            cmake_args: "-A ARM64"
+
+          - os: macos-15-intel
+            name: macos-x64
+            cmake_args: ""
+
+          - os: macos-latest
+            name: macos-arm64
+            cmake_args: ""
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure
+        run: >
+          cmake -S . -B build
+          -DCMAKE_BUILD_TYPE=Release
+          -DLUNAR_ENABLE_SERIES_FALLBACK=ON
+          -DLUNAR_BUILD_TESTS=ON
+          ${{ matrix.cmake_args }}
+
+      - name: Build
+        run: cmake --build build --config Release --parallel
+
+      - name: Test
+        run: ctest --test-dir build -C Release --output-on-failure

.github/workflows/Release.yml

@@ -54,7 +54,7 @@ jobs:
 
       - name: Configure (native)
         if: matrix.kind == 'native'
-        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release ${{ matrix.cmake_args }}
+        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DLUNAR_ENABLE_SERIES_FALLBACK=ON ${{ matrix.cmake_args }}
 
       - name: Build (native)
         if: matrix.kind == 'native'
@@ -85,6 +85,7 @@ jobs:
 
           cmake -S . -B build \
             -DCMAKE_BUILD_TYPE=Release \
+            -DLUNAR_ENABLE_SERIES_FALLBACK=ON \
             -DCMAKE_C_COMPILER="$PWD/zigcc" \
             -DCMAKE_CXX_COMPILER="$PWD/zigcxx" \
             -DCMAKE_C_FLAGS="-Wno-error=date-time -Wno-date-time" \
@@ -114,6 +115,8 @@ jobs:
           mkdir -p package
           cp README.md package/
           cp LICENSE package/
+          cp -R vsop87a package/
+          cp -R elpmpp02 package/
 
           if [ "${{ runner.os }}" = "Windows" ]; then
             cp build/Release/lunar.exe package/

CMakeLists.txt

@@ -2,10 +2,45 @@ cmake_minimum_required(VERSION 3.20)
 
 project(lunar LANGUAGES C CXX)
 
+include(CTest)
+
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_CXX_EXTENSIONS OFF)
 
+option(LUNAR_ENABLE_DIMENSION_TYPES "Enable compile-time tagged physical vectors" ON)
+option(LUNAR_ENABLE_SERIES_FALLBACK "Enable VSOP87A/ELPMPP02 fallback when BSP is unavailable" ON)
+option(LUNAR_BUILD_TESTS "Build GoogleTest-based test targets" ${BUILD_TESTING})
+
+set(LUNAR_SERIES_SOURCES
+    vsop87a/vsop87a.cpp
+    vsop87a/vsop87a_ear.cpp
+    vsop87a/vsop87a_emb.cpp
+    vsop87a/vsop87a_jup.cpp
+    vsop87a/vsop87a_mar.cpp
+    vsop87a/vsop87a_mer.cpp
+    vsop87a/vsop87a_nep.cpp
+    vsop87a/vsop87a_sat.cpp
+    vsop87a/vsop87a_ura.cpp
+    vsop87a/vsop87a_ven.cpp
+    elpmpp02/elpmpp02.cpp
+    elpmpp02/elpmpp02_data_main_distance.cpp
+    elpmpp02/elpmpp02_data_main_latitude.cpp
+    elpmpp02/elpmpp02_data_main_longitude.cpp
+    elpmpp02/elpmpp02_data_pert_distance_t0.cpp
+    elpmpp02/elpmpp02_data_pert_distance_t1.cpp
+    elpmpp02/elpmpp02_data_pert_distance_t2.cpp
+    elpmpp02/elpmpp02_data_pert_distance_t3.cpp
+    elpmpp02/elpmpp02_data_pert_latitude_t0.cpp
+    elpmpp02/elpmpp02_data_pert_latitude_t1.cpp
+    elpmpp02/elpmpp02_data_pert_latitude_t2.cpp
+    elpmpp02/elpmpp02_data_pert_latitude_t3.cpp
+    elpmpp02/elpmpp02_data_pert_longitude_t0.cpp
+    elpmpp02/elpmpp02_data_pert_longitude_t1.cpp
+    elpmpp02/elpmpp02_data_pert_longitude_t2.cpp
+    elpmpp02/elpmpp02_data_pert_longitude_t3.cpp
+)
+
 if(MSVC)
     set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
 endif()
@@ -43,27 +78,60 @@ set(LUNAR_CORE_SOURCES
     src/entry.cpp
 )
 
+if(LUNAR_ENABLE_SERIES_FALLBACK)
+    list(APPEND LUNAR_CORE_SOURCES
+        ${LUNAR_SERIES_SOURCES}
+    )
+endif()
+
+add_library(lunar_core STATIC
+    ${LUNAR_CORE_SOURCES}
+)
+
+set_target_properties(lunar_core PROPERTIES
+    POSITION_INDEPENDENT_CODE ON
+)
+
+target_include_directories(lunar_core PUBLIC
+    ${CMAKE_CURRENT_SOURCE_DIR}/include
+    ${CMAKE_CURRENT_SOURCE_DIR}
+)
+target_compile_definitions(lunar_core PUBLIC
+    LUNAR_ENABLE_DIMENSION_TYPES=$<BOOL:${LUNAR_ENABLE_DIMENSION_TYPES}>
+    LUNAR_ENABLE_SERIES_FALLBACK=$<BOOL:${LUNAR_ENABLE_SERIES_FALLBACK}>
+)
+if(MSVC)
+    target_compile_options(lunar_core PRIVATE /utf-8)
+endif()
+
 add_executable(lunar
     src/main.cpp
-    ${LUNAR_CORE_SOURCES}
 )
+target_link_libraries(lunar PRIVATE lunar_core)
+target_include_directories(lunar PRIVATE
+    ${CMAKE_CURRENT_SOURCE_DIR}/include
+    ${CMAKE_CURRENT_SOURCE_DIR}
+)
+if(MSVC)
+    target_compile_options(lunar PRIVATE /utf-8)
+endif()
 
 add_library(lunar_dll SHARED
     src/c_api.cpp
-    ${LUNAR_CORE_SOURCES}
 )
-
+target_link_libraries(lunar_dll PRIVATE lunar_core)
+target_include_directories(lunar_dll PRIVATE
+        ${CMAKE_CURRENT_SOURCE_DIR}/include
+        ${CMAKE_CURRENT_SOURCE_DIR}
+    )
+target_compile_definitions(lunar_dll PRIVATE LUNAR_BUILD_DLL)
 set_target_properties(lunar_dll PROPERTIES
     OUTPUT_NAME lunar
 )
-target_compile_definitions(lunar_dll PRIVATE LUNAR_BUILD_DLL)
-
-foreach(tgt lunar lunar_dll)
-    target_include_directories(${tgt} PRIVATE
-        ${CMAKE_CURRENT_SOURCE_DIR}/include
-    )
+if(MSVC)
+    target_compile_options(lunar_dll PRIVATE /utf-8)
+endif()
 
-    if(MSVC)
-        target_compile_options(${tgt} PRIVATE /utf-8)
-    endif()
-endforeach()
+if(LUNAR_BUILD_TESTS)
+    add_subdirectory(tests)
+endif()

README.md

@@ -1,6 +1,6 @@
 # CalcChineseCalendar（lunar）
 
-CalcChineseCalendar 是一个基于 JPL DE BSP 星历文件的历法与天文计算工具，提供：
+CalcChineseCalendar 是一个优先使用 JPL DE BSP 星历、在缺失 BSP 时可自动回退到仓库内置 VSOP87A + ELPMPP02 的历法与天文计算工具，提供：
 
 - 命令行工具 `lunar`
 - 动态库 `lunar_dll`（导出 C API）
@@ -22,7 +22,7 @@ CalcChineseCalendar 是一个基于 JPL DE BSP 星历文件的历法与天文计
 - 事件检索：`next`、`range`、`search`
 - 日月食：`eclipse`
 - 传统节日与黄历摘要：`festival`、`almanac`
-- 星历信息与自检：`info`、`selftest`
+- 星历信息：`info`
 - 配置管理与补全脚本：`config`、`completion`
 - 交互式模式（无参数启动）
 
@@ -32,7 +32,7 @@ CalcChineseCalendar 是一个基于 JPL DE BSP 星历文件的历法与天文计
 
 - CMake 3.20+
 - 支持 C++20 的编译器
-- 运行时需要 BSP 文件（`.bsp`）
+- 运行时优先使用 BSP 文件（`.bsp`）；若未找到可自动回退到内置 VSOP87A + ELPMPP02
 - `download get` 需要系统中存在 `curl` 或 `wget`
 
 ### 2.2 Windows（Visual Studio）
@@ -53,8 +53,28 @@ cmake --build build -j
 
 - 可执行程序：`lunar`
 - 动态库：`lunar_dll`（输出名为 `lunar`，对应平台扩展名）
+- 测试程序：`lunar_tests`（启用 `LUNAR_BUILD_TESTS` 时）
 
-## 3. 运行前准备：BSP 星历
+### 2.5 可选构建开关
+
+- `-DLUNAR_ENABLE_SERIES_FALLBACK=ON|OFF`
+  - `ON`（默认）：未找到 BSP 时自动切换到内置 VSOP87A + ELPMPP02
+  - `OFF`：保持旧行为，必须提供可用 BSP
+- `-DLUNAR_BUILD_TESTS=ON|OFF`
+  - `ON`（默认）：构建 gtest/ctest 测试目标
+  - `OFF`：不构建测试目标
+
+### 2.6 运行测试
+
+```bash
+cmake -S . -B build
+cmake --build build --config Release
+ctest --test-dir build -C Release --output-on-failure
+```
+
+若关闭 `LUNAR_ENABLE_SERIES_FALLBACK`，可通过环境变量 `LUNAR_TEST_BSP` 指定测试所用 BSP。
+
+## 3. 运行前准备：BSP 星历（可选但优先）
 
 ### 3.1 下载列表
 
@@ -104,7 +124,7 @@ lunar <command> [args...]
 
 ### 4.3 全局 BSP 覆盖参数
 
-所有需要星历的命令都支持：
+所有需要星历的命令都支持显式指定：
 
 - `--bsp <path>`
 - `--bsp=<path>`
@@ -129,7 +149,7 @@ lunar <bsp> <years> [months options...]
 
 ### 5.1 哪些命令需要 BSP
 
-- `months calendar year event at convert day monthview next range search eclipse festival almanac info selftest`
+- `months calendar year event at convert day monthview next range search eclipse festival almanac info`
 
 不需要 BSP 的命令：
 
@@ -149,7 +169,8 @@ lunar <bsp> <years> [months options...]
 - 若命令可推断时间区间，优先选择“完整覆盖该区间”的 BSP。
 - 若无完整覆盖，选择与区间重叠最多的 BSP。
 - 若无法推断区间，使用候选列表第一个。
-- 若没有可用候选，抛出错误并提示使用 `--bsp` 或 `lunar config set def_bsp`。
+- 若没有可用候选且 `LUNAR_ENABLE_SERIES_FALLBACK=ON`，自动切换到内置 VSOP87A + ELPMPP02。
+- 若没有可用候选且 `LUNAR_ENABLE_SERIES_FALLBACK=OFF`，抛出错误并提示使用 `--bsp` 或 `lunar config set def_bsp`。
 
 ## 6. 配置文件 `lun_cfg.txt`
 
@@ -449,26 +470,14 @@ lunar info <bsp> [--format json|txt] [--out ...] [--pretty 0|1] [--quiet]
 - 默认格式固定为 `txt`（不读取 `def_fmt`）。
 - 输出包含文件存在性、大小、SPK 覆盖区间等信息。
 
-### 9.17 selftest
-
-```bash
-lunar selftest <bsp> [--format json|txt] [--out ...] [--pretty 0|1] [--quiet]
-```
-
-说明：
-
-- 默认格式固定为 `txt`。
-- 当前内置测试用例包括 `at_illum`、`conv_rt`、`y25_cnt`。
-- 通过返回码 `0`，失败返回 `1`。
-
-### 9.18 config
+### 9.17 config
 
 ```bash
 lunar config show [--format json|txt] [--out ...] [--pretty 0|1] [--quiet]
 lunar config set <key> <value>
 ```
 
-### 9.19 completion
+### 9.18 completion
 
 ```bash
 lunar completion bash|zsh|fish|powershell
@@ -499,14 +508,13 @@ lunar completion bash|zsh|fish|powershell
 - `6` next
 - `7` festival
 - `8` info
-- `9` selftest
-- `10` monthview
-- `11` range
-- `12` search
-- `13` eclipse
-- `14` almanac
-- `15` config
-- `16` completion
+- `9` monthview
+- `10` range
+- `11` search
+- `12` eclipse
+- `13` almanac
+- `14` config
+- `15` completion
 - `d` 切换/下载 BSP
 - `h` 帮助
 - `q` 退出

elpmpp02/README.md

@@ -0,0 +1,22 @@
+# ELPMPP02
+
+保留内容：
+
+- `elpmpp02.hpp`
+- `elpmpp02.cpp`
+- `elpmpp02_data_*.cpp`
+- `elpmpp02_data_decl.hpp`
+
+调用：
+
+```cpp
+elpmpp02::StateVector state;
+elpmpp02::Evaluate(elpmpp02::CorrectionSet::DE405,jd_tdb,state);
+```
+
+参数：
+
+- `correction`：`LLR`、`DE405`、`DE406`
+- `jd_tdb`：TDB/TT 风格儒略日输入
+- `state.position_km`：输出位置，单位 km
+- `state.velocity_km_per_day`：输出速度，单位 km/day