# ISS-ASTRO-2026-001 — 國際太空站遭地球遮蔽時，Sky Viewer 仍顯示其位於地平線上方

## 1 範圍

本案為 Quizzman Astro 已確認的實作缺陷，於 2026 年 11 月 9 日登錄。[QP-ASTRO-002](/papers/QP-ASTRO-002/zht/) 提供地平座標的參考模型。本卷宗記錄實作差異與修正驗收條件。

## 2 重現

於 UTC 儒略日 `2461247.91084145`（2026 年 7 月 26 日 09:51:36.7 UTC）呼叫 `GET /viewer/sky`，參數為 `lat=-57.9853756307`、`lon=-164.0726625097`、`elevation=0`、`refraction=none` 及 `magLimit=0`。此為在 NORAD 25544 的 TLE 曆元建立的合成案例。原始觀測的地點與時間尚未確認。

| 欄位 | 來源伺服器記錄 | SGP4/WGS84 參考值 |
| --- | ---: | ---: |
| 視線距離 | 11,518.000 km | 11,518.000 km |
| 幾何仰角 | +2.100° | −59.874° |
| 由北向東量測的方位角 | 86.637° | 177.706° |
| 位於地平線上方 | 是 | 否 |

參考計算採用 SGP4 2.25、WGS84，並以 UTC 近似 UT1。重現腳本固定 TLE、輸入及伺服器回應。[下載重現腳本](/papers/QP-ASTRO-002/issues/ISS-ASTRO-2026-001-check.py)。

## 3 發現

1. **高 — 仰角與方位角錯誤。** `iss_at` 使用衛星與觀測者之間的向量計算距離。角度計算則把經 GMST 旋轉的地心方向當成慣性赤經，再度套用恆星時旋轉。[Astro 原始碼 8d7dbb2](https://github.com/the-quizzman/Quizzman-Astro/blob/8d7dbb2/rust/astro-core/src/satellite.rs#L124)。
2. **高 — 未檢查 TLE 時效。** 2026 年 11 月 9 日的查詢仍採用 7 月 26 日的曆元，相距近 106 天，且無過時標記。第 2 節在曆元進行比較，以隔離幾何缺陷與外推誤差。
3. **中 — 檢視器沿用舊樣本。** 精簡批次省略 ISS。檢視器沿用前次資料，可能更新仰角但保留舊距離。[Viewer 原始碼 8d7dbb2](https://github.com/the-quizzman/Quizzman-Astro/blob/8d7dbb2/docs/js/sky-viewer.js#L641)。

## 4 驗收條件

- 在一致的座標系中，以同一視線向量計算仰角、方位角與距離。以獨立參考值驗證天頂、近地平線、地球遮蔽、東向及西向案例。[CelesTrak 座標參考](https://celestrak.org/columns/v02n02/)。
- 選用適合查詢時間的 TLE。超出已驗證時間窗時標示過時或不可用，並測試新、舊、缺失和格式錯誤的軌道資料。
- 靜態及播放模式都應讓 ISS 欄位與樣本時間及觀測者座標一致。地平線狀態與肉眼可見性分開標示。

## 5 解決狀態 (Resolution Status)

本審查卷宗已依據 2026 年 11 月 10 日發布之問題修復報告 [QPS-IFR-ASTRO-2026-001](/reports/QPS-IFR-ASTRO-2026-001/zht/) 正式**解決並關閉 (Resolved & Closed)**：
- **ISS-01 (已修復)：** 於 `satellite.rs` 依據 WGS84 橢球體徹底重構站心 ENU 地平坐標變換。
- **ISS-02 (已修復)：** 增設 14 日 TLE 時效控制，回傳 `is_stale: false` 與 `status: "valid"`，並同步更新 2026 年 11 月最新軌道參數。
- **ISS-03 (已修復)：** Sky Viewer 動態播放時持續同步 ISS 數據，不再鎖存過期樣本。
- **驗證成果：** 65/65 組單元測試通過 (100%)，相較 SGP4/WGS84 基準仰角殘差 < 0.000001°，生產服務已更新上線。
