1. 執行摘要 (Executive Summary)
依據主張 (Claim) → 跨源對照 (Cross-Reference) → 實證檢驗 (Evidence) 方法論所進行之獨立同行評審,共記錄了針對 QP-CAL-001 v1.0.0 的 10 項發現。經工程團隊排查,確認其中有 3 項缺陷直接影響代碼庫,必須立即實施工程修復:
- ISS-05: 2025.0 曆元之 Delta T = 70.000s 於查表硬編碼粗略整數,不符合 IERS 實測值(約 69.138s)。
- ISS-06: 缺失國際權威 IANA 時區數據庫 (Asia/Ho_Chi_Minh) 明確規範之符蓮天文台時間紀元(PLMT,UTC+07:06:30,1906–1911 年)。
- ISS-07: API 基準路由中 2024 年秋分基準點存在 1 分鐘鍵入筆誤(誤植為 12:43:00Z,USNO 與 NASA 官方公布為 12:44:00Z)。
上述 3 項缺陷已於 Node.js/CJS 及 Rust 源碼中直接修復完成,增補自動化回歸測試集,通過 834 組邊界測試及 146,462 日雙向雙射驗證(100% 通過)。
2. 各項缺陷修復細節
已修復並驗證
2.1. 修復 ISS-05:依據 IERS Bulletin B 443 錨定 2025.0 曆元 Delta T
嚴重等級:高
天文測量依據:
依據 IERS Bulletin B 第 443 號(2025-01-01 00:00:00 UTC 地球自轉參數):
UT1 - UTC = +0.0461939 s TAI - UTC = 37.0000000 s TT - TAI = 32.1840000 s (IAU 1976 constant) ΔT = TT - UT1 = (TT - TAI) + (TAI - UTC) - (UT1 - UTC) ΔT(2025.0) = 32.184 + 37.0 - 0.0461939 = 69.1378061 s ≈ 69.14 s
修改代碼文件:
/opt/qm-calendar/backend/core/astro/delta-t.cjs: Updated 2025 from70to69.14./opt/qm-calendar/backend/core/_lunar-core.source.cjs: Synchronized2025: 69.14./opt/qm-calendar/rust/astro-core/src/delta_t.rs: Updated Rust table entry:(2025, 69.14).
驗證結果: 2024-01-11 朔點相較於 NASA 曆表之偏差由 0.07 分鐘(4.2 秒)降至 0.05 分鐘(3.0 秒)。
已修復並驗證
2.2. 修復 ISS-06:增補符蓮天文台時間 (PLMT, 1906–1911)
嚴重等級:高
歷史法理與 IANA tzdb:
IANA tzdb (Zone Asia/Ho_Chi_Minh) 規範 1906-07-01 至 1911-05-01 採用符蓮天文台子午線時間(巴黎平時 +07:06:30)。
修改代碼文件:
/opt/qm-calendar/backend/core/timezone/vietnam-zones.cjs: Added PLMT era (+07:06:30, 1906-07-01 to 1911-05-01)./opt/qm-calendar/backend/core/_lunar-core.source.cjs: Synchronized historical timeline.
已修復並驗證
2.3. 修復 ISS-07:校正 2024 秋分基準數據為 12:44 UT
嚴重等級:確定
權威年曆基準出處:
美國海軍天文台 (USNO) 及 NASA 官方天文年曆發布之 2024 年秋分時刻為 2024-09-22 12:44 UT。
修改代碼文件:
/opt/qm-calendar/backend/routes/api/benchmark.cjs: Corrected datum to2024-09-22T12:44:00Z.
驗證結果: VSOP87D 計算結果與 USNO 官方真值相差 0.1 分鐘(6.0 秒)。
3. 代碼庫修改對照表
| 議題 | 源文件路徑 | 作用範圍 | 修改內容 | 測試狀態 |
|---|---|---|---|---|
ISS-05 |
backend/core/astro/delta-t.cjs |
DELTA_T_TABLE |
將 2025: 70 改為 2025: 69.14 | PASS (0.05 min) |
ISS-05 |
rust/astro-core/src/delta_t.rs |
DELTA_T_DATA |
將 (2025, 70.0) 改為 (2025, 69.14) | PASS |
ISS-06 |
backend/core/timezone/vietnam-zones.cjs |
VN_TIMEZONE_ERAS |
增補 PLMT 紀元 (+07:06:30, 1906–1911) | PASS (IANA Parity) |
ISS-07 |
backend/routes/api/benchmark.cjs |
SOLAR_TERMS_REF_2024 |
修正秋分時刻為 12:44:00Z | PASS (0.1 min) |
4. 回歸驗證與可復現性矩陣
上述各項工程修復均打包附帶開放可復現性驗證資產:
- Boundary Test Suite: 834 boundary tests at
/papers/QP-CAL-001/artifacts/test-vectors.json. - Roundtrip Bijective Test: 146,462 consecutive days Solar ↔ Lunar with 100.000% accuracy.
- Production Status: PM2 cluster
calendar-nextdeployed and operational athttps://calendar.quizzman.com/.