chore: delete project specification documents, GitHub prompts, and templates.

.github/copilot-instructions.md

@@ -1,182 +0,0 @@
-# GitHub Copilot 指南（專案層級）
-
-> **⚠️ 抽象化指南** — 本檔案及 `.github` 資料夾中的所有 prompt 相關文件應保持**完全抽象化**，移除所有原專案特定的技術細節與領域知識。
-> 
-> 撰寫或修改本文件時：
-> - ✅ 使用通用術語（如「資料欄位」、「輸入項目」、「資料點」）
-> - ✅ 用「資料來源查詢失敗」、「外部服務超時」而非具體服務名稱
-> - ✅ 用「輸入格式」、「資料格式」而非具體檔案或編碼格式
-> - ❌ 不要提及任何特定領域（如地震、金融、醫療等）的詞彙
-> - ❌ 不要參考原專案的具體資料檔案名、業務邏輯或專業術語
->
-> **目標**：使本指南可直接應用於其他資料處理專案，無需修改具體內容。
-
-本文件為單人專案的 Copilot 開發指南。撰寫或修改程式碼時，務必遵循 `spec/spec.md` 的規格與不變條件。
-
-## 關鍵文件
-
-### Spec 檔案結構（模塊化）
-
-為了保持可讀性與管理 token 預算，規格已拆分為多個專業化文件：
-
-- **`spec/00-overview.md`** — 專案概覽、核心目標、模組清單、不變條件速查表（**對話時優先傳讀此文件**）
-- **`spec/01-data-contract.md`** — 資料結構、模型 I/O Shape、檔案格式、冷啟動流程（資料契約相關時查閱）
-- **`spec/02-processing-rules.md`** — 批次策略、輸入項目上限、資料處理參數、資源限制（實作邏輯時查閱）
-- **`spec/03-error-handling.md`** — 錯誤處理策略、日誌原則、常見場景、UI 訊息設計（除錯或新增錯誤處理時查閱）
-- **`spec/04-extensions.md`** — 擴充空間、新資料來源、向後相容策略（功能擴展時查閱）
-
-其他重要檔案：
-- **`spec/plan.md`**（短期）：本次迭代的範圍、目標、驗收標準。臨時討論檔，每個 sprint 更新後可拋棄。
-- **`changelog.md`**：記錄完成的變更摘要（高層描述，非逐行對應）。用於交付追蹤。
-
-## 核心守則（3 點）
-
-### 1. **規格優先** — 合約 + 不變條件
-- 新增或變更功能時，先檢查相應的規格文件（通常 `00-overview.md` 或 `01-data-contract.md`）中的不變條件與限制。
-- 若需變更 CSV 結構、模型契約、或 API 形狀，**必須先更新 spec**（`01-data-contract.md` 或 `04-extensions.md`），並說明相容性影響。
-- 當 Copilot 指南與 spec 有衝突時，以 spec 為準。
-
-### 2. **失敗不中斷** — 降級 + 日誌
-- 單點錯誤（缺失欄位、資料來源查詢失敗、檔案遺失等）**不應中止全流程**。
-- 改用預設值、跳過該點、或降級處理，並記錄 WARNING/ERROR log（使用 loguru）。
-- 參考 `spec/03-error-handling.md` 的具體策略與常見場景。
-
-### 3. **資料清晰** — I/O 契約
-- 模型輸入/輸出形狀、CSV 必備欄位、檔案格式必須與 spec 保持一致。
-- 若要改動資料結構（如新增 CSV 欄位），先同步更新 `01-data-contract.md`，並在 `04-extensions.md` 記錄相容性計畫。
-
-## 程式碼實踐
-
-- 在涉及 spec 約定的邏輯處加入註解，簡述與 spec 的對齊（如 "spec #2：輸入項目上限" 或 "參考 02-processing-rules.md"），無需編號標籤。
-- 優先保持向後相容；新增資料來源或輸入項時參考 `spec/04-extensions.md`。
-- 避免將關鍵邏輯（如批次策略、資源查詢）分散於多處；若需重構，提供明確的入口函式或工廠（參考 `04-extensions.md` 工廠模式）。
-
-## LLM 執行防護（預防常見陷阱）
-
-### 避免無限驗證迴圈
-- **問題**：執行完檔案操作後，開始重複執行 `ls`, `wc -l`, `find`, `file` 等驗證命令
-- **預防**：
-  - 每個主要任務完成後**立即停止**，不進行驗證
-  - 若需驗證，由用戶在後續對話中明確要求
-  - 單個工具呼叫的驗證可以（如 `get_errors` 檢查編譯），但連環的驗證命令應停止
-
-### 避免生成不必要的報告
-- **問題**：執行 `/project.init` 等明確指定「不產生報告」的命令後，卻自動生成總結 markdown
-- **預防**：
-  - 明確檢查指令的「限制」與「不做」清單
-  - 若指令說「完成後直接返回」，就真的直接返回
-  - 報告只有在用戶**明確要求**時才生成
-
-### 避免過度消耗 token
-- **問題**：為了「確保完美」而執行多個驗證步驟，造成 token 浪費
-- **預防**：
-  - 優先相信檔案操作工具成功（除非有明確錯誤訊息）
-  - 避免為了「心安」而重複讀取剛建立的檔案
-  - 單輪對話內集中驗證，而非分散於多個工具呼叫
-
-## 提交前檢查
-
-commit 前確認以下兩點：
-
-1. 是否符合 spec 的輸入/輸出 shape 與不變條件（查閱 `01-data-contract.md` 或 `02-processing-rules.md`）？
-2. 若變更了 CSV 結構或模型契約，spec 已同步更新（`01-data-contract.md` + `04-extensions.md`）？
-
-## 迭代與任務追蹤
-
-- 每次���始新迭代時，在 `spec/plan.md` 討論本次目標、範圍、驗收標準。
-- 根據 plan.md 的內容，可在 `spec/task.md` 維護任務拆解（子任務應小而可驗收）。
-- 迭代完成後，更新 `changelog.md` 記錄變更摘要。
-- 完成後標記 `plan.md` 和 `task.md` 為 `[ARCHIVED]`（保留作為歷史參考），下次迭代時重新生成新版本。
-- **長期的規格變更和決策應同步回對應的 spec 模塊文件**（`00-overview.md` / `01-data-contract.md` / `02-processing-rules.md` / `03-error-handling.md` / `04-extensions.md`），形成累積的設計參考。
-
-## 對話時的 Spec 查詢策略
-
-**遇到不同類型的問題時，優先查閱對應的 spec 檔案**：
-
-| 問題類型 | 查閱檔案 |
-|--------|--------|
-| 「這個欄位是必須的嗎？」「模型輸入是什麼形狀？」 | `01-data-contract.md` |
-| 「怎麼處理缺失的資料？」「最多幾個輸入項？」 | `02-processing-rules.md` |
-| 「資料來源查詢失敗怎麼辦？」「應該記哪種日誌？」 | `03-error-handling.md` |
-| 「怎麼新增新資料來源？」「能不能擴展資料欄位？」 | `04-extensions.md` |
-| 「核心不變條件有哪些？」 | `00-overview.md` |
-
-**每次對話前，LLM 應根據用戶需求讀取相應的 spec 模塊**（而非整個 spec.md），節省 token 預算。
-
-## Copilot Slash Commands（審核檢查點）
-
-本專案提供以下指令協助「規格審核」與「迭代開發」的清晰分工：
-
-### `/project.init`（一次性初始化 — 僅用於既有專案無規格文件時）
-- **目的**：為既有專案（Brownfield）從無規格的狀態，快速生成模塊化規格檔案（`spec/00-overview.md` 至 `spec/04-extensions.md`）與迭代計畫模板（`spec/plan.md`）。
-- **限制**：此命令為一次性初始化，**應該只產生必要的規格與計畫文件，不產生總結報告或分析文檔**。初始化完成後無需進一步的報告文件。
-- **執行檢查清單**（防止重複驗證與報告生成）：
-  - ❌ **不做**：生成總結報告、比較表、驗證文檔
-  - ❌ **不做**：執行 `ls`, `wc -l`, `file`, `find` 等驗證命令
-  - ❌ **不做**：使用 `show_content` / `open_file` 顯示生成結果
-  - ❌ **不做**：重複讀取已建立的檔案確認內容
-  - ✅ **只做**：
-    1. 掃描現有程式碼結構
-    2. 建立 5 份規格 + 2 份計畫檔案
-    3. 更新 `changelog.md`
-    4. 直接結束，不進行任何驗證
-- **流程**：
-  1. LLM 掃描現有程式碼結構，分析核心模組與資料流。
-  2. 根據代碼分析，逐一填充 5 份模塊化規格文件（`spec/00-*` 至 `spec/04-*`）與計畫模板。
-  3. 完成後**直接返回**（無總結、無驗證、無報告）；如需驗證規格內容，用戶可在後續對話中執行 `/project.spec` 或 `/project.plan`。
-
-### `/project.spec`（需求改變時用）
-- **目的**：調整 spec 的大方向、契約或不變條件。與現有程式碼做比較，列出後續工作清單。
-- **流程**：
-  1. 討論新增或調整的規格項（需求、契約、不變條件）。
-  2. 根據需求類型，讀取相應的 spec 模塊（`01-*` / `02-*` / `03-*` / `04-*`）。
-  3. LLM 掃描現有程式碼，列出符合、缺漏、或違反的地方。
-  4. 產出「需要做的工作清單」。
-  5. **直接更新 `spec/spec.md`** → 等待使用者確認 → 確認後同步至 `README.md` 和 `spec/plan.md`。
-
-### `/project.plan`（迭代規劃時用）
-- **目的**：生成本次 sprint 的計畫，讓使用者在 MD 上討論和調整。
-- **流程**：
-  1. 產生 `spec/plan.md`（包含迭代目標、高層任務列表、風險評估等）
-  2. **暫停等待使用者確認**（用戶可直接在 MD 上編輯）
-  3. 確認後，提示執行 `/project.task` 進行詳細任務拆解
-
-### `/project.task`（任務拆解時用）
-- **目的**：根據確認的 `spec/plan.md`，拆解為具體的任務步驟與程式碼變更點。
-- **流程**：
-  1. 根據 `spec/plan.md` 的高層任務列表，生成詳細任務拆解（T-001、T-002 等）
-  2. 展示每個任務的具體變更點（檔案、行號、修改內容）
-  3. **暫停等待使用者確認**（用戶可調整任務順序或內容）
-  4. 確認後，提示執行 `/project.apply` 應用程式碼變更
-
-### `/project.apply`（程式碼應用時用）
-- **目的**：直接應用經過確認的程式碼變更。
-- **流程**：
-  1. 根據 `spec/task.md` 的確認任務清單，直接應用所有程式碼修改
-  2. 執行語法/編譯檢查
-  3. 更新 `spec/task.md` 標記已完成的任務（[x]）
-  4. **暫停並提示使用者**：「程式碼已應用，請進行手動測試」
-
-### `/project.report`（交付與清理時用）
-- **目的**：記錄變更並歸檔臨時計畫檔案。
-- **流程**：
-  1. 根據使用者已完成的測試結果，自動更新 `changelog.md`
-  2. 標記 `spec/plan.md` 和 `spec/task.md` 為已歸檔（在檔案開頭加入 `[ARCHIVED]` 標記）
-  3. 生成交付報告（品質狀態、需求對齐等）
-  4. 提示用戶本次迭代已完成，可開始新迭代
-
-### 標準工作流
-
-**當需求改變時：**
-1. 執行 `/project.spec` 討論規格調整
-2. 直接在 `spec/spec.md` 上編輯 → 確認後同步至 `README.md` 和 `spec/plan.md`
-
-**執行迭代時：**
-3. 執行 `/project.plan` 生成計畫 → 在 `spec/plan.md` 上編輯 → 確認後執行 `/project.task`
-4. 執行 `/project.task` 拆解任務 → 在 `spec/task.md` 上編輯 → 確認後執行 `/project.apply`
-5. 執行 `/project.apply` 直接應用程式碼 → 手動測試 → 測試完成後執行 `/project.report`
-6. 執行 `/project.report` 記錄變更 + 標記 plan 和 task 為 `[ARCHIVED]` → 迭代完成
-
-**下次需求改變時：** 回到步驟 1。
-**下次迭代開始時：** 執行步驟 3（會在同位置重新生成新的 plan.md 和 task.md）。
-

.github/prompts/project.apply.prompt.md

@@ -1,45 +0,0 @@
-# /project.apply — 應用程式碼變更
-
-目的
-- 根據使用者在 `/project.task` 中確認的任務，直接應用具體的程式碼變更。
-- 更新 `spec/task.md` 標記已完成的任務。
-- 等待使用者手動測試，測試完成後執行 `/project.report`。
-
-輸入
-- 使用者確認的任務拆解清單（來自 `/project.task`）
-
-流程
-
-### 自動執行
-
-1. **直接應用程式碼變更**
-   - 根據 `spec/task.md` 的任務清單，應用所有程式碼修改
-   - 使用 `replace_string_in_file` 或 `insert_edit_into_file` 執行變更
-   - 執行相關檢查（語法檢查、編譯檢查等，若適用）
-
-2. **更新 `spec/task.md`**
-   - 為已完成的任務標記勾選 `[x]`
-   - 保留任務描述和驗收標準
-
-### 暫停點：等待使用者手動測試
-
-1. **提示使用者**：「程式碼已應用，請進行手動測試」
-2. **等待使用者回饋**：
-   - 測試是否通過驗收標準
-   - 是否需要調整或修復
-   - 測試完成後執行 `/project.report`
-
-### 後續步驟（由使用者執行）
-
-使用者手動測試完成後：
-- 執行 `/project.report` 記錄本次迭代的變更摘要
-- `/project.report` 會自動更新 `changelog.md` 並清理 `spec/plan.md` 和 `spec/task.md`
-
-## 守則
-
-- **直接執行**：不需要展示階段或再次確認
-- **精準定位**：所有變更需精確指向檔案、函式、行號
-- **驗證變更**：應用後須檢查語法/編譯正確性
-- **等待測試**：暫停並等待使用者手動測試結果
-- **後續交付**：由 `/project.report` 負責記錄和清理
-

.github/prompts/project.init.prompt.md

@@ -1,44 +0,0 @@
-# /project.init — 初始化規格（Project Init）
-
-## 目的
-- 快速產生或盤點 `spec/spec.md`，作為契約與不變條件的單一來源。
-- 判斷 greenfield（無程式）還是 brownfield（有程式），輸出精簡的規格建議。
-
-## 輸入
-使用者提供：
-- 專案摘要（用途、主要流程、使用者）
-- I/O 與外部依賴（已知則填，未知可空）
-- 現有文件/README（若有）
-- 程式碼結構（若提供 → brownfield）
-
-## 判定邏輯
-- **Greenfield**：無程式碼，LLM 產生初版骨架
-- **Brownfield**：有程式碼，LLM 盤點代碼、提出建議
-
-## 輸出
-
-### Greenfield 模式
-以 `.github/spec-template.md` 為範本，產出：
-1. 簡潔骨架：7 個章節（見 template）各列 1–2 行
-2. 填入已知資訊，未知處留 TODO
-3. 「後續補齊清單」：需要調查或決策的項目
-
-### Brownfield 模式
-掃描既有程式，產出簡潔建議：
-1. **系統概觀**：架構 & 核心組件（3–5 句）
-2. **I/O 契約**：輸入/輸出形狀、必填欄位、格式
-3. **不變條件 & 邊界**：核心規則、失敗時降級方式
-4. **外部依賴**：主要服務/檔案、失敗降級
-5. **缺漏清單**：規格缺失或不清楚的項
-6. **驗證位置**：程式入口、設定檔位置（供查證）
-
-## 完成後
-- 提示使用者確認內容
-- 建議根據建議手動建立或更新 `spec/spec.md`
-- 提示下一步：在 spec 確認後執行 `/project.plan` 進入迭代規劃
-
-## 守則
-- **不修改檔案**：僅提供建議文字（不實際寫 spec）
-- **簡潔優先**：決策層級，不列完整資料結構或假資料
-- **領域知識集中**：數值、規則盡量導向 spec，避免散落
-- **實務優先**：只記錄「必須知道的」

.github/prompts/project.plan.prompt.md

@@ -1,50 +0,0 @@
-# /project.plan — 規劃階段
-
-目的
-- 產生 `spec/plan.md`：定義本次 sprint 的範圍、目標與驗收標準，讓使用者能在討論階段進行修改。
-- 必須對齊 `spec/spec.md`（全生命週期規格）的不變條件與契約；所有領域常數與限制以 spec 為準。
-
-角色區分
-- **`spec/spec.md`**：軟體生命週期的全局規格（長期約束、核心模型、I/O shape、不變條件）
-- **`spec/plan.md`**：本 sprint 的執行計畫（範圍、目標、子任務、驗收標準）；必須受 spec.md 約束
-
-輸入（由提問者提供）
-- 需求描述或問題背景。
-- 目標與範圍（如未提供，請以合理假設補齊，並明示）。
-
-請輸出
-- 產生 `spec/plan.md` 檔案，內容包含：
-  - **簡短前置**：需求重述與關鍵假設（若有）。
-  - **迭代目標**：本次 sprint 要解決什麼問題或新增什麼功能。
-  - **範圍**：涉及的模組、檔案、外部依賴。
-  - **驗收標準**：本次迭代完成的定義（Definition of Done）。
-  - **高層任務列表**：要做的主要工作項（不需詳細拆解，詳細拆解由 `/project.task` 負責）。
-  - **Invariants 對齊**：逐條列出是否受影響（Done/Not Impacted/At Risk），並指向 `spec/spec.md` 的相關條目。
-  - **風險與回滾**：主要風險、緩解、回滾方式（最小可逆）。
-  - **冒煙測試**：2–4 個步驟，含預期輸出要點。
-
-## ⏸️ 暫停點（重要）
-
-**完成 `spec/plan.md` 生成後，立即停止，等待使用者確認。**
-
-### 第一階段：討論與確認計畫（直接在 spec/plan.md 上編輯）
-
-1. **直接生成/更新 `spec/plan.md`**
-   - 你可以直接在 MD 上進行編輯和調整
-   - 修改目標、範圍、任務優先序等
-   - 如果改錯了可以直接 discard
-
-2. **完成編輯後**：
-   - 回覆「確認」或「核准」
-
-### 第二階段：任務拆解（用戶確認後）
-
-待你確認後：
-1. **提示你執行 `/project.task`** 來進行詳細的任務拆解與驗收標準
-
-## 守則
-
-- **必須遵守暫停點**：產生 `spec/plan.md` 後，等待使用者確認，不進行任何進一步的操作。
-- **允許多輪編輯**：用戶可在 `spec/plan.md` 上任意修改、調整，直到滿意為止。
-- **可安全 discard**：用戶可隨時放棄編輯，discard 檔案變更，無副作用。
-- plan.md 的所有決策必須遵守 spec.md 的全局約束；不可違反或繞過 spec 中定義的不變條件。

.github/prompts/project.report.prompt.md

@@ -1,49 +0,0 @@
-# /project.report — 交付與清理
-
-目的
-- 記錄本次迭代的變更摘要到 `changelog.md`
-- 清理臨時計畫檔案（`spec/plan.md` 和 `spec/task.md`）
-- 生成交付報告
-
-輸入
-- 使用者已完成手動測試（來自 `/project.apply` 後的測試階段）
-
-自動執行
-
-### 1. 更新 `changelog.md`
-
-- 在 `[Unreleased]` 或最新版本下，根據 `spec/task.md` 生成變更摘要
-- 格式：
-  ```markdown
-  ### Added/Changed/Fixed
-  - **功能名稱或模組**（日期）
-    - 具體變更描述（2-3 條要點）
-    - 相關檔案簡稱
-  ```
-
-### 2. 歸檔臨時檔案
-
-- 標記 `spec/plan.md` 為已歸檔（在檔案開頭加入 `[ARCHIVED]` 標記 + 簡要說明）
-- 標記 `spec/task.md` 為已歸檔（在檔案開頭加入 `[ARCHIVED]` 標記 + 執行摘要）
-- 下次迭代時會在同位置重新生成新版本
-- **原因**：保留檔案作為參考記錄，方便後續追蹤迭代歷史；相比刪除對 LLM 限制更少
-
-### 3. 生成交付報告
-
-輸出內容：
-- **變更摘要**：對照 `spec/task.md` 的已完成任務
-- **品質狀態**：
-  - Build/Lint 狀態
-  - 語法/編譯檢查結果
-  - I/O 契約驗證
-- **Requirements 對齐**：對照 `spec/spec.md` 的不變條件
-- **UX 變更檢查**：若有 UI/功能變更，提示需更新 `README.md` 的相關章節
-- **建議的 changelog 條目**：提供文本供參考（已自動寫入）
-
-## 守則
-
-- **自動執行更新**：自動更新 `changelog.md` 並歸檔 plan 和 task 檔案（標記 `[ARCHIVED]`）
-- **保留 spec.md**：不刪除任何規格檔案（`spec/00-*.md` 至 `spec/04-*.md` 和臨時計畫）
-- **明確提示**：清楚告知已歸檔哪些檔案及其位置
-- **參考記錄**：保留歸檔檔案供後續迭代追蹤歷史，無需真正刪除
-- **交付完成**：提示本次迭代已交付，可開始新的迭代週期

.github/prompts/project.spec.prompt.md

@@ -1,98 +0,0 @@
-# /project.spec — 規格審核與更新
-
-目的
-- 調整 `spec/spec.md` 的大方向：新增、修改或移除規格項（需求、契約、不變條件、限制）。
-- 與現有程式碼做差異比較，檢查哪些地方符合、缺漏、或違反規格。
-- 產出「需要做的工作清單」，作為 `/project.plan` 的輸入。
-
-應用場景
-- 需求改變、使用者故事新增
-- 發現程式碼與規格不對齊
-- 業務邊界或資料模型調整
-- 性能、相容性或安全性要求變更
-
-角色區分
-- **`spec/spec.md`**：軟體生命週期全局規格（長期、累積性維護）
-- **`spec/plan.md`**：本 sprint 的執行計畫（臨時、可拋棄）
-- **現有程式碼**：當前實作狀態（檢查對齊度）
-
-輸入（由提問者提供）
-- 規格調整的內容描述（新增、修改或移除什麼規格項）
-- 背景與動機
-- 相關的邊界情況或假設（若有）
-
-請輸出
-
-### 第一部分：規格建議
-- 新增或修改的規格項清單，包含：
-  - 項目名稱與章節位置（對應 `spec/spec.md` 現有章節）
-  - 具體描述（契約、限制、不變條件）
-  - 影響範圍（涉及哪些模組/功能）
-  - 相容性說明（是否破壞現有行為）
-
-### 第二部分：程式碼比較分析
-- 掃描 spec 內所提到的關鍵檔案，針對調整項分析：
-  - ✅ **符合規格**：現有程式已正確實作的部分
-  - ❌ **缺漏**：規格定義但程式未實作的部分
-  - ⚠️ **違反**：程式行為與規格不一致的部分
-  - ❓ **不確定**：需要手動驗證的部分
-- 列出具體的程式碼位置（檔案名、函式名、行號範圍）
-
-### 第三部分：工作清單
-- 「需要做的工作項」：根據差異分析產出，包含：
-  - 優先序（High/Medium/Low）
-  - 工作描述與預期結果
-  - 受影響的檔案
-  - 估計工作量（Small/Medium/Large）
-  - 與 spec 各章節的對應關係
-- 格式化為可直接貼入 `spec/plan.md` Checklist 的形式
-
-### 第四部分：驗收與風險
-- 現有不變條件檢查清單（有無違反的？）
-- 主要風險與回滾建議
-- 冒煙測試建議（2–3 個步驟驗證調整是否生效）
-
-## ⏸️ 暫停點與雙向確認流程（重要）
-
-**完成四部分分析後，立即停止，等待使用者評審與確認。**
-
-### 第一階段：評審與確認規格變更（直接在 spec/spec.md 上編輯）
-
-1. **直接更新 `spec/spec.md`**：
-   - 應用四部分內容的建議
-   - 新增/修改/移除規格項
-   - 用戶可直接在 MD 檔案上進行二次調整
-   
-2. **用戶進行討論與調整**（在 MD 檔案上）：
-   - 直接編輯 `spec/spec.md`
-   - 調整、新增或移除規格項
-   - 修改相關描述或限制
-   - 如果改錯了可以直接 discard（無副作用）
-   
-3. **完成編輯後**：
-   - 用戶回覆「確認」或「核准」
-   
-4. **確認後繼續第二階段**
-
-### 第二階段：相關文件同步（用戶確認後）
-
-待用戶確認後，按順序執行：
-1. **更新 `README.md`**：將規格調整中的**高層次設計理念、使用者情境、架構思想**同步至 README（確保即使 spec 後續重建，這些核心思想仍得到保留）；細節實作內容暫不更新，待任務完成後補充
-2. 根據「工作清單」建立 `spec/plan.md`（定義本次 sprint 範圍）
-
-### 第三階段：後續開發（可選）
-
-- 執行 `/project.plan` 進行任務拆解與驗收標準
-- 開始迭代開發
-
-## 守則
-
-- **必須遵守暫停點**：更新 `spec/spec.md` 後，等待使用者確認，不主動修改 `README.md` 或建立 `spec/plan.md`。
-- **允許多輪編輯**：用戶可在 `spec/spec.md` 上任意修改、調整，直到滿意為止。
-- **可安全 discard**：用戶可隨時放棄編輯，discard 檔案變更，無副作用。
-- 規格建議基於使用者輸入與現有 `spec/spec.md`；直接在 `spec/spec.md` 上實作，等待確認後再同步其他檔案。
-- 程式碼分析需精準定位（檔案、函式、行號），便於快速定位與修改。
-- 工作清單應與現有的 `spec/spec.md` 章節結構對應，避免遺漏或重複。
-- 若發現規格與程式碼有深層衝突，需明確標註為「需要討論」的項目。
-- 優先保持向後相容；若必須破壞相容性，需在規格變更中明確說明與遷移策略。
-

.github/prompts/project.task.prompt.md

@@ -1,51 +0,0 @@
-# /project.task — 任務拆解
-
-目的
-- 根據使用者確認的 `spec/plan.md`，進行詳細的任務拆解與驗收標準。
-- 生成具體的任務步驟清單與程式碼變更點，為後續程式碼應用做準備。
-
-輸入
-- 使用者已確認的 `spec/plan.md`
-
-請輸出
-- 根據 `spec/plan.md` 的高層任務列表，生成詳細任務拆解：
-  - **編號 Task 清單**（T-001、T-002 等）
-    ```
-    ### T-001: <任務名稱>
-    - **描述**：詳細說明這個任務要做什麼
-    - **受影響檔案**：列出所有會被修改的檔案（相對路徑）
-    - **具體變更點**：
-      - 文件1.py (L100-150): 新增函式 xxx()
-      - 文件2.md: 更新章節 YYY
-    - **驗收標準**：如何檢驗這個任務完成
-    - **風險等級**：低/中/高
-    ```
-
-- **關鍵變更點摘要**（不貼整段程式碼）：
-  - 每個變更位置、修改前後行為
-  - 相關欄位/限制（若有）
-  
-- **品質門檻**：
-  - 是否影響公共契約
-  - 錯誤處理與日誌覆蓋情況
-
-## ⏸️ 暫停點
-
-**完成任務拆解後，等待使用者確認。**
-
-- 用戶可在本階段：
-  - 確認任務拆解是否合理
-  - 調整任務優先序或內容
-  - 修改 `spec/task.md` 後回覆「確認」
-
-### 確認後的下一步
-
-待用戶確認後：
-1. **提示執行 `/project.apply`** 來應用程式碼變更
-
-## 守則
-
-- 不直接修改程式碼檔案，只展示變更方案。
-- 編號（T-001 等）僅用於清單，不會寫入 spec 檔案。
-- 若涉及公共契約變更，必須標註需先確認 `spec/spec.md`。
-- 提供精確的檔案位置與行號，便於後續應用。

.github/spec-template.md

@@ -1,48 +0,0 @@
-# 規格（Spec）模板 — 單人專案簡化版
-
-> **用途**：作為專案的契約與不變條件單一來源（Single Source of Truth）。  
-> **原則**：簡潔、可執行、易維護。只記錄「必須知道的」，不列完整執行結果或逐行詳解。
-
-## 1. 概述（Overview）
-**三句話說清楚**：
-- 問題 & 目標：一句話
-- 非目標：避免什麼
-- 主要輸入/輸出：資料流向
-
-## 2. 核心流程
-- 主要入口：CLI/Web/腳本/API
-- 3–5 步簡述
-- 關鍵外部依賴：服務/檔案/第三方庫名稱
-
-## 3. I/O 契約
-- **輸入**：資料形狀、必填欄位、預設值
-- **輸出**：預期格式、主要欄位
-- **相容性**：破壞性變更如何識別
-
-## 4. 不變條件 & 邊界
-- **核心規則**：不可破壞的假設（採樣率、處理單位上限、並行限制等）
-- **邊界行為**：缺漏/格式錯誤 → 降級策略（跳過/預設值/日誌警告）
-- **資源限制**：記憶體/時間/配額（語義級，具體值在設定檔）
-
-## 5. 外部依賴 & 降級
-- **主要依賴**：用途、介面、失敗時的替代行為
-- **日誌原則**：各失敗點應記 WARNING/ERROR（描述現象+替代方案）
-- **重試/快取**：簡述策略（無則不列）
-
-## 6. 擴充與相容（可選）
-- 新增資料源/模組的預留方式
-- 版本遷移計畫（若有破壞性變更）
-
-## 7. 驗收清單
-- ✅ Happy path：完整流程
-- ✅ 邊界情境：最常見的 1–2 個失敗案例
-
----
-
-## 使用建議
-
-1. **初期**：填 1–4 節，建立基本契約
-2. **開發中**：發現新邊界時更新第 4–5 節
-3. **功能擴展**：先更新本文，再寫程式
-4. **記住**：不需列完整的執行結果、逐行說明或假資料，只記「決策」與「規則」
-

.github/task-template.md

@@ -1,62 +0,0 @@
-# Task: <標題>
-
-- Task ID: T-<YYYYMMDD>-<shortname>
-- Date: <YYYY-MM-DD>
-- Status: Planning | In Progress | Done
-
-## 背景與目標
-- **背景**：為何需要？與 `spec/spec.md` 的哪一段相關？
-- **目標**：交付物與驗收標準（一句或要點形式）。
-- **不在範圍**：明確避免 scope creep。
-
-## 任務拆解（可勾選）
-- [ ] 子任務 1：<描述>（變更檔案：`...`）
-  - 驗收：<可驗證的條件>
-- [ ] 子任務 2：<描述>（變更檔案：`...`）
-  - 驗收：<可驗證的條件>
-- [ ] 子任務 3：<描述>（變更檔案：`...`）
-  - 驗收：<可驗證的條件>
-
-> 每個子任務盡量控制在 1 小時內可完成。
-
-## 不變條件與約束檢查
-- [ ] 是否影響 `spec/spec.md` 中的 I/O shape、欄位、或不變條件？
-- [ ] 如是，已更新 spec 並標註破壞性變更？
-- [ ] 邊界情境（資料缺漏、外部依賴失敗等）是否正確降級並記錄 log？
-
-> 填寫相關 spec 章節編號或行號（如 spec #3, #6）。
-
-## 手動驗收（冒煙測試）
-- **步驟**：
-  1. <步驟 1>
-  2. <步驟 2>
-  3. <步驟 3>
-- **預期結果**：<清楚描述>
-- **失敗情境測試**（若適用）：<一個邊界案例的驗證步驟>
-
-## 完成檢查
-- [ ] 程式碼符合 `spec/spec.md` 約束
-- [ ] 手動驗收通過
-- [ ] 關鍵邊界情況有 log（INFO/WARNING/ERROR）
-- [ ] 若改動 CSV 或模型契約，spec 已同步
-
-## 進度紀錄
-- <YYYY-MM-DD HH:MM>：<進度更新或決策>
-
----
-
-附錄 A：Commit 信息模板
-
-```
-feat(task T-<YYYYMMDD>-<shortname>): <簡述>
-
-- <子任務/變更點 1>
-- <子任務/變更點 2>
-
-Refs: T-<YYYYMMDD>-<shortname>
-```
-
-附錄 B：分支/PR 命名
-- 分支：`feature/T-<YYYYMMDD>-<shortname>`
-- PR 標題：`T-<YYYYMMDD>-<shortname>: <簡述>`
-

spec/00-overview.md

@@ -1,123 +0,0 @@
-# 專案概覽 (00-Overview)
-
-## 核心目標
-**互動式教育性地震模型展示系統**。在 Hugging Face Space 上展示基於 Transformer 的地震震度預測模型，使觀眾通過直觀的操作流程理解「波形 → 模型推論 → 震度預測」的完整過程。
-系統採用 GUI（Gradio）呈現互動式工作流：事件選擇 → 時間窗口選擇 → 測站選擇 → 波形預覽 → 批次推論 → 地圖可視化，並提供預測結果與實際觀測的對照。
-
-### 🎯 設計理念
-- **優先互動性**：所有操作應立即視覺化反饋（波形圖、地圖、統計訊息）
-- **重視教育性**：透過清晰的介面與注解，讓非專業人士理解模型邏輯
-- **功能簡潔化**：無需追求完整覆蓋或極限性能；易於操作與理解為首
-- **預裝化設計**：所有資料（模型權重、Vs30、波形、測站表）均預裝於空間，無需外部下載
-
-## 系統架構
-
-```
-使用者介面 (Gradio GUI)
-    ↓
- 資料載入層 （讀 MSEED 檔案、載入測站表、初始化模型與 Vs30）
-    ↓
- 測站選擇 （距離排序，最近 25 站；不足時降級）
-    ↓
- 波形預處理 （去趨、低通濾波 @ 10 Hz、補零至 3000 samples）
-    ↓
- 批次推論 （CNN → Position Embedding + Transformer → MLP → MDN）
-    ↓
- 後處理與地圖可視化 （PGA → 震度等級 → Folium 地圖）
-    ↓
- 對照結果 （預測 vs 實際觀測）
-```
-
-## 核心模組清單
-
-| 模組 | 職責 | 關鍵檔案 |
-|-----|------|---------|
-| **模型層** | CNN + Position Embedding + Transformer + MLP + MDN | `app.py` (class definitions + `get_full_model()`) |
-| **資料層** | 讀 MSEED、測站表、Vs30 資料庫 | `app.py` (initialization + `load_waveform()`) |
-| **測站選擇** | 距離排序、去重複、狀態警告 | `app.py` (`select_nearest_stations()`) |
-| **波形提取** | 分量驗證、補零、訊號處理 | `app.py` (`extract_waveforms_from_stream()` + `signal_processing()`) |
-| **推論引擎** | 批次處理、Tensor 操作 | `app.py` (`predict_intensity()`) |
-| **地圖可視化** | 互動式 Folium 地圖、實際圖對照 | `app.py` (`create_intensity_map()` + `load_observed_intensity_image()`) |
-| **UI 工作流** | Gradio 事件綁定 | `app.py` (Gradio Blocks definition) |
-
-## 核心不變條件 ⚠️ (必讀)
-
-### 一、波形輸入
-- **取樣率固定 100 Hz**
-- **時間窗長度固定 30 秒**（3000 samples）
-- **分量順序固定：Z, N, E**（模型期望此順序）
-- **補零策略**：時間窗不足 30 秒時，尾段補 0 至 3000 samples
-- **缺分量降級**：N 或 E 缺失時以 Z 替代，記錄統計數量
-
-### 二、測站限制
-- **輸入測站**：最多 1000+ 個（從 `site_info.csv` 讀取）；每個測站可能有多個分量（Z/N/E）
-- **被選測站**：模型固定接收 25 站；實際可用數 ≥ 1 時允許推論（< 25 時 Padding 至 25）
-- **去重複**：僅保留站名，去除重複分量
-
-### 三、目標測站
-- **目標點總數**：從 `eew_target.csv` 讀取；無上限（但分批推論，每批 25 點）
-- **批次大小**：每批最多 25 點；最後一批可少於 25 點
-
-### 四、外部資源（預裝優先）
-- **模型**：`ttsam_trained_model_11.pt` **預裝於 Space 本地**；無需下載
-- **Vs30 資料**：`Vs30ofTaiwan.nc` **預裝於 Space 本地**；無需從 Hugging Face 下載；初始化失敗時用預設 600 m/s
-- **MSEED 檔案**：`waveform/YYYYMMDD.mseed` **預裝於 Space**；若遺失則應用啟動時提示
-- **測站表**：`station/site_info.csv`, `station/eew_target.csv` **預裝於 Space**；缺少必要欄位則提示
-- **實際震度圖**：`intensity_map/YYYYMMDD.png` **預裝於 Space**（可選）；不存在時以空白占位
-
-### 五、訊號處理
-- **去趨勢**：detrend(type="constant")
-- **低通濾波**：10 Hz 4-order Butterworth
-- **正規化**：進入 CNN 前進行軸向正規化（模型內部）
-
-### 六、推論 → 震度轉換
-- **模型輸出**：MDN 的加權高斯分布 (weight, sigma, mu)
-- **PGA 計算**：μ_PGA = Σ(weight × μ)
-- **PGA → 震度**：分段對數尺度查表（0–7 級，共 10 級別）
-- **地圖顯示**：Folium CircleMarker + 顏色漸層（白 → 紫）
-
-## 設計原則
-
-### 1. 預裝優先（Preset-First Design）
-- 所有關鍵資料（模型、Vs30、波形、測站表）均預裝於 HF Space，無需在應用啟動時下載
-- 應用啟動應立即進入互動介面（無長時間初始化等待）
-- 若預裝資料缺失（如某個事件的 MSEED），應於使用者操作時給予清晰提示，無需中止啟動
-
-### 2. 降級不中斷（Graceful Degradation for Demo）
-- 單點資料缺失（缺分量、實際震度圖缺失）→ 使用預設值或占位，記錄 INFO/WARNING log
-- 非關鍵外部資源失敗（如 Vs30 查詢失敗）→ 使用預設值 600 m/s，記錄 WARNING log
-- 測站數不足（< 25 站）→ 允許推論並在 UI 明示警告
-- **關鍵資源失敗中止**（僅限：模型權重無法載入、測站表必填欄位缺失）
-
-### 3. 教育性設計
-- 介面應包含清晰的步驟說明與狀態反饋
-- 波形、測站分布、地圖等視覺元件應帶有簡潔注解，解釋「為什麼這樣做」
-- 統計資訊應顯示推論過程的關鍵數據（如選中測站數、缺分量數）
-
-### 2. 規格優先
-- 所有 I/O 形狀、必填欄位、檔案格式 → 參考本 spec（特別是 `01-data-contract.md`）
-- 若要改動，先更新 spec，再改程式
-
-### 3. 日誌清晰
-- 使用 `loguru` 記錄：
-  - **INFO**：主流程進度（載入、選擇、推論）
-  - **WARNING**：降級決策（Vs30 失敗、缺分量、不足 25 站）
-  - **ERROR**：可恢復的單點失敗（測站查詢失敗、檔案讀取失敗）
-  - **不記錄 DEBUG**（除非調試）
-- 所有 try-except 後立即 log.warning() / log.error()
-
-## 快速參考表
-
-| 項目 | 規格值 | 來源 | 備註 |
-|-----|------|-----|------|
-| 取樣率 | 100 Hz | 模型輸入 | 固定 |
-| 時間窗 | 30 秒 = 3000 samples | 模型輸入 | 不足時尾段補 0 |
-| 輸入測站上限 | 25 站 | 模型輸入 | Padding 至 25 |
-| 目標批次大小 | 25 點/批 | 記憶體最適化 | 可調 |
-| Vs30 預設值 | 600 m/s | 降級策略 | 預裝失敗時 |
-| PGA 級別數 | 10 級 (0–7) | `calculate_intensity()` | 對數尺度 |
-| 低通濾波 | 10 Hz, 4 order Butterworth | 訊號處理 | 固定 |
-| 地圖高度 | 800 px | UI 設計 | 固定 |
-| 實際震度圖路徑 | `intensity_map/YYYYMMDD.png` | 預裝檔案 | 可選 |
-| 部署環境 | Hugging Face Space | 目標 | 預裝優先，無外部下載 |
-

spec/01-data-contract.md

@@ -1,322 +0,0 @@
-# 資料契約 (01-Data-Contract)
-
-## 概述
-本檔案定義系統所有輸入/輸出資料結構、必填欄位、檔案格式與冷啟動流程。
-
-**關鍵設計原則**：
-- 所有外部資源（模型、Vs30、波形、測站表）**預裝於 HF Space**，無需運行時下載
-- 資料層失敗時應立即提示（於 UI 或日誌），而非沉默降級
-- 必填欄位缺失應中止啟動；非關鍵資料缺失應使用預設值
-
-### 1.1 MSEED 波形檔案 (`waveform/YYYYMMDD.mseed`)
-
-**用途**：儲存地震波形時間序列數據
-
-**結構**（ObsPy Stream 格式）：
-```
-每個 Trace 包含：
-  stats.station: 測站代碼 (e.g., "ALS")
-  stats.channel: 分量代碼 (e.g., "EHZ", "EHN", "EHE", "HHZ", "HHN", "HHE")
-  stats.sampling_rate: 100 Hz (預期值)
-  data: ndarray, shape (N,), dtype float64
-```
-
-**必需分量**：
-- Z（豎向）：必須存在；其他分量缺失時用 Z 替代
-- N（南北）：可選；缺失時以 Z 替代
-- E（東西）：可選；缺失時以 Z 替代
-
-**取樣率驗證**：
-- 預期 100 Hz
-- 若不同，模型輸入會失配（不自動重取樣）
-
-### 1.2 輸入測站表 (`station/site_info.csv`)
-
-**用途**：1000+ 個地震測站的元資料；模型從中選擇距震央最近的 25 站
-
-**必填欄位**：
-```
-Station,Latitude,Longitude,Elevation
-```
-
-**欄位型態與說明**：
-| 欄位 | 型態 | 範圍 | 說明 |
-|-----|-----|------|------|
-| Station | 字串 | N/A | 測站代碼 (e.g., "ALS") |
-| Latitude | 浮點 | (5, 30) | 緯度 (度) |
-| Longitude | 浮點 | (110, 123) | 經度 (度) |
-| Elevation | 浮點 | 0+ | 海拔高度 (公尺) |
-
-**去重複規則**：
-- 每個 Station 可能在 MSEED 中出現多次（不同分量/時間段）
-- 讀取時保留唯一站名（使用 `drop_duplicates(subset=['Station'])`)
-
-**驗證邏輯**：
-```
-if any(field not in site_info.columns for field in required_fields):
-    log.error(f"site_info.csv 缺少必要欄位: {missing_fields}")
-    raise ValueError(...)
-```
-
-### 1.3 目標測站表 (`station/eew_target.csv`)
-
-**用途**：推論目標點集合；每行代表一個預測位置
-
-**必填欄位**：
-```
-network,county,station,station_zh,longitude,latitude,elevation
-```
-
-**欄位型態與說明**：
-| 欄位 | 型態 | 範圍 | 說明 |
-|-----|-----|------|------|
-| network | 字串 | N/A | 測網代碼 (e.g., "CWB_SMT", "TSMIP") |
-| county | 字串 | N/A | 行政區名稱 |
-| station | 字串 | N/A | 測站代碼 (e.g., "TAP") |
-| station_zh | 字串 | N/A | 測站中文名稱 |
-| longitude | 浮點 | (110, 123) | 經度 (度) |
-| latitude | 浮點 | (5, 30) | 緯度 (度) |
-| elevation | 浮點 | 0+ | 海拔高度 (公尺) |
-
-**驗證邏輯**：
-```
-if any(field not in target_df.columns for field in required_fields):
-    log.error(f"eew_target.csv 缺少必要欄位: {missing_fields}")
-    raise ValueError(...)
-```
-
-### 1.4 Vs30 資料庫 (Hugging Face `SeisBlue/TaiwanVs30`)
-
-**用途**：空間網格 Vs30 參數（地表剪切波速度 30 公尺深度平均值）
-
-**檔案格式**：NetCDF4 (`Vs30ofTaiwan.nc`)
-
-**資料結構**（xarray Dataset）：
-```
-lat: 緯度網格 (e.g., 5–30°)
-lon: 經度網格 (e.g., 110–123°)
-vs30: 對應的 Vs30 值 (m/s)
-```
-
-**查詢方式**：
-- 使用 scipy.spatial.cKDTree 進行最近鄰查詢
-- 輸入：(lat, lon) → 輸出：Vs30 (m/s)
-
-**預設值降級**：
-- 下載失敗 → 使用 600 m/s
-- 查詢失敗（超時、點出界）→ 使用 600 m/s
-- **記錄 WARNING log**
-
-### 1.5 模型權重 (Hugging Face `SeisBlue/TTSAM`)
-
-**用途**：預訓練的 PyTorch 模型參數
-
-**檔案**：`ttsam_trained_model_11.pt`
-
-**載入方式**：
-```python
-model_dict = torch.load(model_path, weights_only=True, map_location=device)
-model.load_state_dict(model_dict)
-```
-
-**失敗策略**：**中止流程**（無預設值可用）
-
-### 1.6 實際震度圖 (本地可選) (`intensity_map/YYYYMMDD.png`)
-
-**用途**：與預測結果對照的實際觀測震度圖
-
-**檔案命名**：
-- 格式：`intensity_map/YYYYMMDD.png`
-- YYYYMMDD 與 MSEED 檔名對應 (e.g., `20240403.mseed` ↔ `20240403.png`)
-
-**缺失策略**：
-- 不存在時顯示空白占位（UI 提示 "實際觀測震度圖缺失"）
-- **不中止流程**
-
-**支援格式**：`.png`, `.jpg`, `.jpeg`, `.gif`
-
-## 二、內部資料結構（關鍵中間表示）
-
-### 2.1 選定測站列表 (Python dict)
-
-```python
-selected_stations = [
-    {
-        "station": "ALS",
-        "distance": 0.05,  # 度
-        "latitude": 23.5083,
-        "longitude": 120.8134,
-        "elevation": 2413.0
-    },
-    ...  # 最多 25 項
-]
-```
-
-### 2.2 波形矩陣 (NumPy ndarray)
-
-**單個測站波形**（供測試）：
-```python
-waveform_3c = np.zeros((3000, 3), dtype=np.float64)
-# [:, 0] = Z 分量
-# [:, 1] = N 分量
-# [:, 2] = E 分量
-```
-
-**批次波形（模型輸入）**：
-```python
-waveform_padded = np.zeros((25, 3000, 3), dtype=np.float64)
-# shape: (n_stations, n_samples, n_components)
-# 不足 25 站時，多餘行全 0
-```
-
-### 2.3 測站元資訊矩陣 (NumPy ndarray)
-
-```python
-station_info_padded = np.zeros((25, 4), dtype=np.float64)
-# [:, 0] = 緯度
-# [:, 1] = 經度
-# [:, 2] = 海拔 (公尺)
-# [:, 3] = Vs30 (m/s)
-# 不足 25 站時，多餘行全 0
-```
-
-### 2.4 目標測站元資訊矩陣 (NumPy ndarray)
-
-```python
-target_padded = np.zeros((25, 4), dtype=np.float64)
-# [:, 0] = 緯度
-# [:, 1] = 經度
-# [:, 2] = 海拔 (公尺)
-# [:, 3] = Vs30 (m/s)
-# 不足 25 點時，多餘行全 0
-```
-
-## 三、模型輸入/輸出形狀 (I/O Shape)
-
-### 3.1 模型輸入 (Batch)
-
-```python
-tensor_data = {
-    "waveform": torch.tensor(waveform_padded).unsqueeze(0).double(),
-    # shape: (batch_size=1, n_stations=25, n_samples=3000, n_components=3)
-    # dtype: torch.float64
-    
-    "station": torch.tensor(station_info_padded).unsqueeze(0).double(),
-    # shape: (batch_size=1, n_stations=25, 4)
-    # 欄位：[緯度, 經度, 海拔, Vs30]
-    # dtype: torch.float64
-    
-    "target": torch.tensor(target_padded).unsqueeze(0).double(),
-    # shape: (batch_size=1, n_targets=25, 4)
-    # 欄位：[緯度, 經度, 海拔, Vs30]
-    # dtype: torch.float64
-}
-```
-
-### 3.2 模型輸出
-
-```python
-weight, sigma, mu = model(tensor_data)
-# weight: shape (batch_size=1, n_targets=25, n_gaussians=5)
-# sigma: shape (batch_size=1, n_targets=25, n_gaussians=5)
-# mu: shape (batch_size=1, n_targets=25, n_gaussians=5)
-# dtype: torch.float32 (在 GPU/CPU 上計算後)
-```
-
-**PGA 計算**：
-```python
-pga = torch.sum(weight * mu, dim=2)  # (batch_size, n_targets)
-# 結果：加權高斯分布的平均值（每個目標點 1 個 PGA 值）
-```
-
-## 四、輸出資料結構
-
-### 4.1 PGA 列表 (Python list)
-
-```python
-pga_list = [0.1234, 0.5678, ...]  # 長度 = 目標點數量
-```
-
-### 4.2 目標點名稱列表 (Python list)
-
-```python
-target_names = ["TAP", "A024", ...]  # 長度 = 目標點數量
-```
-
-### 4.3 互動式地圖 HTML (Folium)
-
-```python
-intensity_map = folium.Map(...)
-map_html = intensity_map._repr_html_()
-# 輸出：HTML 字串，可內嵌 Gradio HTML component
-```
-
-### 4.4 統計訊息 (字串)
-
-```python
-stats = """✅ 預測完成！
-開始時間: 0.0 秒
-時間長度: 30.0 秒 (0.0 - 30.0)
-震央位置: (121.5700, 23.8800)
-使用測站數: 25 / 25
-預測目標點數: 50
-預測最大震度: 6-
-"""
-```
-
-## 五、冷啟動流程 (Bootstrap)
-
-### 啟動順序
-1. **檢查必要環境變數** (GPU/CPU 設定)
-2. **初始化 Vs30 資料**
-   - 嘗試從 Hugging Face 下載
-   - 若失敗，記錄 WARNING，使用預設 600 m/s
-3. **初始化模型**
-   - 從 Hugging Face 下載 `ttsam_trained_model_11.pt`
-   - 建構 FullModel 網路架構
-   - 載入權重、移至 GPU/CPU
-4. **載入輸入測站表** (`station/site_info.csv`)
-   - 驗證必填欄位
-   - 去重複 (Station)
-   - 若失敗，記錄 ERROR、中止啟動
-5. **載入目標測站表** (`station/eew_target.csv`)
-   - 驗證必填欄位
-   - 轉換為 dict 列表
-   - 若失敗，記錄 ERROR、中止啟動
-6. **列舉 EARTHQUAKE_EVENTS**
-   - 從 `EARTHQUAKE_EVENTS` 字典掃描本地 `.mseed` 檔案
-
-### 啟動失敗條件
-
-| 資源 | 失敗行為 | 恢復策略 |
-|-----|--------|--------|
-| 模型權重 | ERROR | 中止啟動 |
-| 輸入測站表 | ERROR | 中止啟動 |
-| 目標測站表 | ERROR | 中止啟動 |
-| Vs30 資料 | WARNING | 使用預設 600 m/s |
-| MSEED 檔案 | WARNING | 該事件不可用 |
-| 實際震度圖 | (無) | 推論時顯示空白占位 |
-
-## 六、欄位對應關係 (Cross-Reference)
-
-```
-site_info.csv (輸入測站表)
-  ↓ (去重複、按距離排序、選擇最近 25 站)
-selected_stations = [
-    {"station": Station, "latitude": Latitude, "longitude": Longitude, 
-     "elevation": Elevation, "distance": calc_distance(...)}
-]
-  ↓ (提取波形、查詢 Vs30)
-station_info_padded = [[Latitude, Longitude, Elevation, Vs30], ...]
-  ↓ (傳入模型)
-model["station"]  # shape (1, 25, 4)
-
-eew_target.csv (目標測站表)
-  ↓ (批次分割)
-batch_targets = [{"station": station, "latitude": latitude, ...}]
-  ↓ (查詢 Vs30)
-target_padded = [[latitude, longitude, elevation, Vs30], ...]
-  ↓ (傳入模型)
-model["target"]  # shape (1, 25, 4)
-```
-

spec/02-processing-rules.md

@@ -1,289 +0,0 @@
-# 處理規則與資源限制 (02-Processing-Rules)
-
-## 概述
-本檔案定義批次策略、輸入項限制、資料處理參數與資源上限。
-
-**設計原則**：
-- 所有輸入資料（波形、測站表）均預裝於 HF Space
-- 批次策略專為互動式 Demo 設計，無需極限優化
-- 容錯優先於性能：單點失敗時降級而非中止整個流程
-
-### 1.1 選測站批次 (固定)
-
-**流程**：
-1. 載入 MSEED 全波形（所有測站）
-2. 遍歷波形中的所有 Trace，建立 (station_code, distance) 映射
-3. 按距離排序，選擇前 **25 站**
-4. 不足 25 站：允許繼續推論，記錄 WARNING
-5. Padding 至 25 站（多餘行用 0 填充）
-
-**限制**：
-- **固定選擇數**：25 站
-- **去重複**：每個 station_code 只計算一次（多分量時取第一個）
-
-### 1.2 目標批次 (可配置)
-
-**流程**：
-1. 讀 `eew_target.csv`，得到 N 個目標點
-2. 分割成 `batch_size` 為單位的批次
-3. 每批 ≤ 25 個目標點
-4. 最後一批可少於 25 個
-
-**計算邏輯**：
-```python
-batch_size = 25
-num_batches = (total_targets + batch_size - 1) // batch_size
-for batch_idx in range(num_batches):
-    start_idx = batch_idx * batch_size
-    end_idx = min((batch_idx + 1) * batch_size, total_targets)
-    batch_targets = target_dict[start_idx:end_idx]
-    # Padding 至 25 個
-    target_padded = np.zeros((batch_size, 4))
-    for i in range(len(batch_targets)):
-        target_padded[i] = [lat, lon, elev, vs30]
-```
-
-**限制**：
-- **批次大小**：25 點 / 批（根據記憶體限制，可調整）
-- **目標點總數**：無上限理論上限，但每次推論前須分批
-
-## 二、輸入項限制
-
-### 2.1 時間參數
-
-| 參數 | 最小值 | 最大值 | 預設值 | 單位 | 說明 |
-|-----|-------|-------|-------|------|------|
-| start_time | 0 | 300 | 0 | 秒 | 波形開始時間 |
-| duration | 0 | 30 | 30 | 秒 | 時間窗長度 |
-
-**驗證邏輯**：
-```python
-if start_time < 0 or duration <= 0:
-    raise ValueError("start_time >= 0 and duration > 0")
-if start_time + duration > total_duration:
-    log.warning(f"時間窗超出波形長度，截斷至 {total_duration} 秒")
-```
-
-**補零策略**（spec #2）：
-- 若 duration < 30 秒，尾段以 0 補齊至 30 秒（3000 samples @ 100 Hz）
-- 若 duration > 30 秒，截取前 30 秒（只用前 3000 samples）
-
-**記錄方式**：
-```python
-if needs_padding:
-    logger.info(f"時間長度 {duration} 秒 < 30 秒，將以 0 遮罩補齊至 30 秒")
-```
-
-### 2.2 空間參數
-
-| 參數 | 最小值 | 最大值 | 單位 | 說明 |
-|-----|-------|-------|------|------|
-| epicenter_lat | 5 | 30 | 度 | 震央緯度 |
-| epicenter_lon | 110 | 123 | 度 | 震央經度 |
-
-**驗證邏輯**：
-```python
-if not (5 <= epicenter_lat <= 30 and 110 <= epicenter_lon <= 123):
-    log.warning(f"震央位置 ({epicenter_lat}, {epicenter_lon}) 超出預期範圍")
-```
-
-### 2.3 Vs30 預設值
-
-| 參數 | 預設值 | 單位 | 說明 |
-|-----|-------|------|------|
-| user_vs30 | 600 | m/s | 當 Vs30 資料查詢失敗時使用 |
-
-## 三、資料處理參數
-
-### 3.1 訊號處理 (spec #2)
-
-```python
-def signal_processing(waveform):
-    # 步驟 1：去趨勢
-    data = detrend(waveform, type="constant")
-    
-    # 步驟 2：低通濾波
-    data = lowpass(data, freq=10, df=100, corners=4)
-    # freq=10 Hz，fs=100 Hz，Nyquist=50 Hz → 10/50 = 0.2 (正規化頻率)
-    # 4-order Butterworth IIR 濾波器
-    
-    return data
-```
-
-**參數說明**：
-| 參數 | 值 | 說明 |
-|-----|-----|------|
-| detrend type | "constant" | 移除平均值 |
-| 濾波頻率 | 10 Hz | 低通截頻 |
-| 採樣率 | 100 Hz | 固定值 |
-| 濾波器階數 | 4 | Butterworth 4th order |
-
-### 3.2 波形補零與對齊 (spec #2)
-
-```python
-target_length = 3000  # 30 秒 @ 100 Hz
-waveform_3c = np.zeros((target_length, 3))
-
-# 填入實際資料（處理長度不足或過長的情況）
-z_len = min(len(z_data), target_length)
-n_len = min(len(n_data), target_length)
-e_len = min(len(e_data), target_length)
-
-waveform_3c[:z_len, 0] = z_data[:z_len]
-waveform_3c[:n_len, 1] = n_data[:n_len]
-waveform_3c[:e_len, 2] = e_data[:e_len]
-# 多餘位置保持 0
-```
-
-### 3.3 分量對應 (spec #2)
-
-| 通道代碼 | 對應分量 | 分量序號 |
-|--------|--------|--------|
-| Z / 1 | 豎向 | 0 |
-| N | 南北 | 1 |
-| E / 2 | 東西 | 2 |
-
-**缺分量替代規則**：
-```python
-# Z 分量（必須存在）
-if len(z_trace) == 0:
-    logger.warning(f"測站 {station_code} 缺少 Z 分量，跳過此測站")
-    continue
-
-# N 分量（缺失時以 Z 代替）
-if len(n_trace) > 0:
-    n_data = n_trace[0].data
-else:
-    n_data = z_data.copy()
-    missing_components_count += 1
-    logger.debug(f"測站 {station_code} 缺少 N 分量，以 Z 分量代替")
-
-# E 分量（缺失時以 Z 代替）
-if len(e_trace) > 0:
-    e_data = e_trace[0].data
-else:
-    e_data = z_data.copy()
-    missing_components_count += 1
-    logger.debug(f"測站 {station_code} 缺少 E 分量，以 Z 分量代替")
-```
-
-## 四、測站選擇規則
-
-### 4.1 距離計算
-
-```python
-def calculate_distance(lat1, lon1, lat2, lon2):
-    """簡化的平面距離 (度單位)"""
-    return np.sqrt((lat1 - lat2)**2 + (lon1 - lon2)**2)
-```
-
-**注意**：此為平面距離近似，不考慮地球曲率。用於快速排序，不是測地距離。
-
-### 4.2 選擇邏輯
-
-```python
-# 1. 遍歷 MSEED 中所有 Trace，建立站點映射（去重複）
-station_distances = {}
-for tr in st:
-    station_code = tr.stats.station
-    if station_code in station_distances:
-        continue  # 已處理，跳過其他分量
-    
-    # 從 site_info 查詢位置
-    station_data = site_info[site_info["Station"] == station_code]
-    if len(station_data) == 0:
-        continue
-    
-    lat, lon, elev = station_data.iloc[0][["Latitude", "Longitude", "Elevation"]]
-    distance = calculate_distance(epicenter_lat, epicenter_lon, lat, lon)
-    station_distances[station_code] = {..., "distance": distance}
-
-# 2. 排序、選擇前 25 個
-station_list = list(station_distances.values())
-station_list.sort(key=lambda x: x["distance"])
-selected_stations = station_list[:25]
-
-# 3. 記錄統計
-if len(selected_stations) < 25:
-    logger.warning(f"僅找到 {len(selected_stations)} 個可用測站（目標 25 個）")
-```
-
-## 五、Vs30 查詢規則 (spec #2)
-
-### 5.1 查詢流程
-
-```python
-def get_vs30(lat, lon, user_vs30=600):
-    if tree is None or vs30_table is None:
-        # 資料庫未初始化
-        logger.info(f"使用使用者輸入的 Vs30 值 ({user_vs30} m/s) for ({lat}, {lon})")
-        return float(user_vs30)
-    
-    try:
-        distance, i = tree.query([float(lat), float(lon)])
-        vs30 = vs30_table.iloc[i]["Vs30"]
-        logger.info(f"從資料庫查詢到 Vs30 值 ({vs30} m/s) for ({lat}, {lon})")
-        return float(vs30)
-    except Exception as e:
-        logger.warning(f"Vs30 查詢失敗 ({lat}, {lon}): {e}，使用預設值 {user_vs30} m/s")
-        return float(user_vs30)
-```
-
-### 5.2 降級策略
-
-| 情況 | 行為 | 日誌等級 |
-|-----|------|--------|
-| Vs30 資料庫未初始化 | 使用預設 600 m/s | INFO |
-| 查詢點超出資料邊界 | 使用預設 600 m/s | WARNING |
-| 查詢超時 | 使用預設 600 m/s | WARNING |
-| 格式錯誤（NaN/Inf） | 使用預設 600 m/s | WARNING |
-
-## 六、推論資源上限
-
-| 資源 | 上限 | 說明 |
-|-----|------|------|
-| 批次大小 | 25 目標點 | VRAM 限制 (GPU) 或記憶體 (CPU) |
-| 選測站數 | 25 站 | 模型固定輸入 |
-| 時間窗 | 30 秒 = 3000 samples | 模型固定輸入 |
-| 目標點總數 | 無限 (分批推論) | 時間複雜度 O(N / 25) |
-
-## 七、日誌記錄規則
-
-### 7.1 日誌等級配置
-
-```python
-from loguru import logger
-
-# INFO：主流程進度
-logger.info("載入波形資料...")
-logger.info("選擇測站完成，共 N 個")
-logger.info("預測完成")
-
-# WARNING：降級決策（不中止）
-logger.warning("Vs30 資料查詢失敗，使用預設值")
-logger.warning("缺少 N 或 E 分量，以 Z 代替")
-logger.warning(f"僅找到 {N} 個測站（目標 25 個）")
-
-# ERROR：單點失敗（可恢復）
-logger.error("測站資訊查詢失敗，跳過該站")
-logger.error(f"無法提取波形資料: {exception}")
-
-# 不記錄 DEBUG（除非特殊調試）
-```
-
-### 7.2 關鍵節點記錄
-
-| 節點 | 記錄訊息 | 等級 | 條件 |
-|-----|--------|------|------|
-| 啟動 Vs30 庫 | "Vs30 資料載入成功" | INFO | 成功 |
-| 啟動 Vs30 庫 | "Vs30 資料載入失敗: ..." | WARNING | 失敗 |
-| 選擇測站 | "從 X 個測站中選擇了 Y 個" | INFO | 成功 |
-| 選擇測站 | "僅找到 Y 個測站（目標 25 個）" | WARNING | Y < 25 |
-| 提取波形 | "成功提取 N 個測站波形" | INFO | 成功 |
-| 提取波形 | "其中 M 個測站缺少分量（已代替）" | INFO | M > 0 |
-| 查詢 Vs30 | "從資料庫查詢到 Vs30 值" | INFO | 成功 |
-| 查詢 Vs30 | "Vs30 查詢失敗，使用預設值" | WARNING | 失敗 |
-| 推論 | "開始分批預測 N 個目標" | INFO | 開始 |
-| 推論 | "預測第 X/Y 批" | INFO | 每批 |
-| 推論 | "完成所有 N 個測站的預測" | INFO | 完成 |
-

spec/03-error-handling.md

@@ -1,416 +0,0 @@
-# 錯誤處理策略 (03-Error-Handling)
-
-## 概述
-本檔案定義系統故障場景、降級策略、日誌原則與使用者訊息設計。
-
-**核心原則**：
-- **預裝優先**：所有關鍵資源預裝於 Space，無需運行時下載
-- **降級不中斷**：非關鍵資料缺失時使用預設值或占位，記錄日誌；僅關鍵資源失敗時中止啟動
-- **清晰提示**：使用者操作時若遇資料缺失，應給予清晰提示而非無聲失敗
-
-## 一、故障場景表
-
-### 場景 A：應用啟動階段
-
-#### A1. Vs30 資料初始化失敗
-
-**觸發條件**（預裝檔案損毀或格式錯誤）：
-- `Vs30ofTaiwan.nc` 損毀
-- xarray 格式錯誤
-
-**行為**：
-- **不中止啟動**
-- 設定全局 `tree = None`, `vs30_table = None`
-- 所有後續 Vs30 查詢使用預設值 600 m/s
-
-**日誌**：
-```
-logger.warning(f"Vs30 資料載入失敗: {e}")
-logger.warning("將使用預設 Vs30 值 (600 m/s)")
-```
-
-**使用者影響**：
-- 應用正常啟動，無明顯提示
-- 查詢日誌時會看到 "使用預設值" 訊息
-
----
-
-#### A2. 模型權重載入失敗
-
-**觸發條件**（預裝檔案損毀或權重結構不符）：
-- `ttsam_trained_model_11.pt` 損毀
-- 權重與模型架構不匹配
-
-**行為**：
-- **中止啟動**（無模型無法演示）
-- 丟擲例外，Gradio 應用無法啟動
-
-**日誌**：
-```
-logger.error(f"模型載入失敗: {e}")
-```
-
-**使用者影響**：
-- 應用無法啟動，UI 顯示 500 error
-- 須檢查模型檔案並重新部署
-
----
-
-#### A3. 測站表 (CSV) 載入失敗
-
-**觸發條件**：
-- CSV 檔案損毀或格式錯誤
-- 必填欄位缺失
-
-**行為**：
-- **中止啟動**（無測站無法進行推論）
-- 丟擲例外
-
-**日誌**：
-```
-logger.error(f"{site_info_file} 載入失敗: {e}")
-# 或
-logger.error(f"{site_info_file} 缺少必要欄位: {missing_fields}")
-```
-
-**使用者影響**：
-- 應用無法啟動
-
----
-
-### 場景 B：波形資料操作階段
-
-#### B1. MSEED 檔案遺失或損毀
-
-**觸發條件**（預裝檔案遺失或損毀）：
-- `waveform/YYYYMMDD.mseed` 不存在
-- 檔案格式錯誤、無法解析
-
-**行為**：
-- **不中止啟動**；啟動後在使用者操作時提示
-- 使用者點「載入波形」時，`load_waveform()` 丟擲例外
-- `load_and_display_waveform()` 捕獲例外，返回清晰的錯誤訊息
-
-**日誌**：
-```
-logger.error(f"波形載入失敗: {e}")
-```
-
-**使用者介面**：
-```
-info_output 顯示：
-"❌ 錯誤：找不到波形檔案 waveform/20240403.mseed"
-（不阻止使用者嘗試其他事件）
-```
-
----
-
-#### B2. 波形時間長度超出範圍
-
-**觸發條件**：
-- 選擇的時間窗 (start_time + duration) 超出波形實際長度
-
-**行為**：
-- 記錄 WARNING
-- 截取可用的部分，或以 0 補齊至 3000 samples
-
-**日誌**：
-```
-logger.warning(f"時間窗 ({start_time:.1f}–{end_time:.1f}s) 超出波形長度，將以 0 補齊")
-```
-
-**使用者影響**：
-- 推論繼續，UI 會在摘要中提示補齊情況
-
----
-
-### 場景 C：測站選擇與波形提取
-
-#### C1. 找不到滿足條件的測站
-
-**觸發條件**：
-- site_info 中所有測站在 MSEED 中都無對應
-- MSEED 檔案為空或僅有部分測站
-
-**行為**：
-- 若找到 ≥ 1 個測站：繼續推論，padding 至 25 站，UI 明示警告
-- 若 0 個測站：返回錯誤提示，不中止應用（使用者可選其他事件）
-
-**日誌**：
-```
-if len(selected_stations) == 0:
-    logger.error("未找到任何可用測站")
-elif len(selected_stations) < 25:
-    logger.warning(f"僅找到 {len(selected_stations)}/25 個測站，將補零至 25")
-```
-
-**使用者介面**：
-```
-info_output 顯示：
-- 若 0 站：「❌ 錯誤：找不到有效的測站資料」
-- 若 < 25 站：「⚠️ 僅選中 8 個測站 (目標 25 個)」
-```
-
----
-
-#### C2. 可用測站 < 25 個
-
-**觸發條件**：
-- MSEED 中可對應的測站少於 25 個
-
-**行為**：
-- **不中止**，允許繼續推論
-- Padding 至 25 個（多餘行用 0 填充）
-- 記錄 WARNING，UI 明示
-
-**日誌**：
-```
-logger.warning(f"僅找到 {actual_count} 個可用測站（目標 25 個），將以 0 補齊")
-```
-
-**使用者介面**：
-```
-info_output 顯示：「⚠️ 僅選中 15 個測站 (目標 25 個)」
-stats_output 顯示：「使用測站數: 15 / 25」
-```
-
----
-
-#### C3. 缺少波形分量
-
-**觸發條件**：
-- N 分量缺失（無 "N" 或 "1" 通道）
-- E 分量缺失（無 "E" 或 "2" 通道）
-- Z 分量缺失（該測站完全不可用）
-
-**行為**：
-- **N/E 缺失**：以 Z 分量代替，統計計數，繼續使用
-- **Z 缺失**：跳過該測站（不可恢復）
-
-**日誌**：
-```
-# N/E 缺失時（可恢復）
-logger.debug(f"測站 {station_code} 缺少 N 分量，以 Z 分量代替")
-
-# 最後統計
-logger.info(f"缺少 N/E 分量的測站: {missing_components_count} 個（已以 Z 代替）")
-
-# Z 缺失時（不可恢復）
-logger.warning(f"測站 {station_code} 缺少 Z 分量，跳過")
-```
-
-**使用者介面**：
-```
-stats_output 顯示（若有缺分量）：
-「⚠️ 缺少 N/E 分量測站數: 3 (已以 Z 分量代替)」
-```
-
----
-
-### 場景 D：Vs30 查詢與場址參數
-
-#### D1. Vs30 查詢失敗
-
-**觸發條件**：
-- Vs30 資料庫未初始化（A1 發生）
-- (lat, lon) 超出資料邊界
-- 查詢超時
-
-**行為**：
-- **不中止**，使用預設值 600 m/s
-- 記錄 WARNING / INFO
-
-**日誌**：
-```
-logger.info(f"Vs30 資料庫未初始化，使用預設值 (600 m/s)")
-# 或
-logger.warning(f"Vs30 查詢失敗 ({lat}, {lon}): {e}，使用預設值 600 m/s")
-```
-
-**使用者影響**：
-- 無直接提示；推論繼續進行
-
----
-
-#### D2. 空間座標超出範圍
-
-**觸發條件**：
-- epicenter_lat < 5 或 > 30
-- epicenter_lon < 110 或 > 123
-
-**行為**：
-- **記錄 WARNING**，允許繼續（可能只是邊界點）
-- Vs30 查詢時可能回傳預設值
-
-**日誌**：
-```
-logger.warning(f"震央位置 ({epicenter_lat}, {epicenter_lon}) 超出預期範圍")
-```
-
-**使用者影響**：
-- 推論繼續，但結果準確性可能降低
-
----
-
-### 場景 E：推論與後處理
-
-#### E1. 推論過程失敗（OOM、計算錯誤）
-
-**觸發條件**：
-- GPU 記憶體不足
-- Tensor 形狀不匹配
-- 數值錯誤（NaN、溢位）
-
-**行為**：
-- **中止該批次的推論**
-- `predict_intensity()` 捕獲例外，返回錯誤訊息
-
-**日誌**：
-```
-logger.error(f"預測過程發生錯誤: {e}")
-import traceback
-traceback.print_exc()
-```
-
-**使用者介面**：
-```
-predicted_intensity_map: None
-stats_output 顯示：
-"錯誤: [RuntimeError] CUDA out of memory"
-```
-
----
-
-#### E2. 實際震度圖缺失
-
-**觸發條件**：
-- `intensity_map/YYYYMMDD.png` 不存在
-
-**行為**：
-- **不中止**，顯示空白占位
-- 記錄 WARNING
-
-**日誌**：
-```
-logger.warning(f"找不到實際震度圖: {event_date}（將顯示空白占位）")
-```
-
-**使用者介面**：
-```
-observed_intensity_image 顯示空白（高度 800px）
-無文字提示（由 UI component 負責）
-```
-
----
-
-#### E3. 預測值異常 (NaN、Inf、超出合理範圍)
-
-**觸發條件**：
-- PGA 值為 NaN 或 Inf
-- PGA 值異常大（> 10 m/s²）或異常小（< 0）
-
-**行為**：
-- **記錄 WARNING** 或 **ERROR**，繼續使用該值
-- 地圖顯示時可能出現異常顏色或缺失標記
-
-**日誌**：
-```
-logger.warning(f"預測 PGA 值異常: {pga}（目標點 {target_name}）")
-```
-
-**使用者影響**：
-- 異常點在地圖上可能顯示為白色（無效值）或其他視覺異常
-
----
-
-## 二、UI 訊息設計
-
-### 2.1 成功訊息
-
-**`info_output` (波形載入後)**：
-```
-✅ 已載入波形資料
-開始時間: 0.0 秒
-時間長度: 30.0 秒 (0.0 - 30.0)
-震央位置: (121.5700, 23.8800)
-選擇了 25 個最近的測站
-請確認波形範圍後，點擊「執行預測」按鈕
-```
-
-**`stats_output` (推論完成後)**：
-```
-✅ 預測完成！
-開始時間: 0.0 秒
-時間長度: 30.0 秒 (0.0 - 30.0)
-震央位置: (121.5700, 23.8800)
-使用測站數: 25 / 25
-預測目標點數: 50
-預測最大震度: 6-
-```
-
----
-
-### 2.2 警告訊息
-
-**少於 25 站**：
-```
-✅ 已載入波形資料
-...
-選擇了 15 個最近的測站 ⚠️（目標 25 個，實際 15 個）
-```
-
-**缺分量**：
-```
-✅ 預測完成！
-...
-⚠️ 缺少 N/E 分量測站數: 3 (已以 Z 分量代替)
-```
-
----
-
-### 2.3 錯誤訊息
-
-**MSEED 不存在**：
-```
-❌ 錯誤：找不到波形檔案 waveform/20240403.mseed
-```
-
-**無可用測站**：
-```
-❌ 錯誤：找不到有效的測站資料
-```
-
-**推論失敗**：
-```
-❌ 錯誤: [RuntimeError] CUDA out of memory
-```
-
----
-
-## 三、日誌等級與關鍵字速查
-
-| 等級 | 關鍵字 | 行為 | 例子 |
-|-----|--------|------|------|
-| **INFO** | 啟動、完成、進度 | 記錄主流程 | "Vs30 資料載入完成" |
-| **WARNING** | 降級、不足、缺失 | 記錄決策改變 | "缺少 N 分量，以 Z 代替" |
-| **ERROR** | 失敗、異常、中止 | 記錄單點或致命失敗 | "測站資訊查詢失敗" |
-
----
-
-## 四、可恢復 vs 致命故障
-
-### 可恢復故障（不中止）
-- Vs30 查詢失敗 → 預設值
-- 缺分量 → 以 Z 替代
-- 測站 < 25 → Padding + WARNING
-- 實際圖缺失 → 空白占位
-- PGA 異常值 → 記錄 + 繼續顯示
-
-### 致命故障（中止）
-- 模型載入失敗 → 應用無法啟動
-- 測站表缺失 → 應用無法啟動
-- MSEED 檔案缺失 → 該事件無法推論
-- OOM / Tensor 形狀錯誤 → 該批推論失敗
-- 必填欄位缺失 → 應用無法啟動
-
-

spec/04-extensions.md

@@ -1,360 +0,0 @@
-# 擴充空間與向後相容 (04-Extensions)
-
-## 概述
-本檔案定義新增功能（新資料來源、新欄位、新模型等）時的擴充點與向後相容性策略。
-
-## 一、數據來源擴充
-
-### 1.1 新增波形資料來源
-
-**當前方案**：本地 MSEED 檔案（`waveform/YYYYMMDD.mseed`）
-
-**擴充點**：
-```python
-class WaveformSource(ABC):
-    @abstractmethod
-    def load(self, event_id: str) -> obspy.Stream:
-        """載入指定事件的完整波形"""
-        pass
-
-class LocalMSEEDSource(WaveformSource):
-    def __init__(self, directory="waveform"):
-        self.directory = directory
-    
-    def load(self, event_id: str) -> obspy.Stream:
-        filepath = f"{self.directory}/{event_id}.mseed"
-        return obspy.read(filepath)
-
-class RemoteSource(WaveformSource):
-    """未來支援：FDSN WebService、IRIS DMC 等"""
-    def load(self, event_id: str) -> obspy.Stream:
-        # 實作遠端查詢邏輯
-        pass
-```
-
-**遷移步驟**：
-1. 在 `app.py` 中定義 `WaveformSource` 抽象基類
-2. 實現 `LocalMSEEDSource` 並替換原有 `load_waveform()` 呼叫
-3. 新增 `RemoteSource` 實現（FDSN、DMC 等）
-4. 在初始化時選擇數據來源
-
-**向後相容性**：
-- 現有 MSEED 檔案結構不變
-- 新舊數據來源需透過工廠函式（Factory Pattern）選擇
-- spec 更新：`04-extensions.md` → 新增 "Waveform Source" 小節
-
----
-
-### 1.2 新增測站資料來源
-
-**當前方案**：本地 CSV 檔案（`site_info.csv`, `eew_target.csv`）
-
-**擴充點**：
-```python
-class StationSource(ABC):
-    @abstractmethod
-    def load_input_stations(self) -> pd.DataFrame:
-        """載入輸入測站表"""
-        pass
-    
-    @abstractmethod
-    def load_target_stations(self) -> pd.DataFrame:
-        """載入目標測站表"""
-        pass
-
-class LocalCSVStationSource(StationSource):
-    def __init__(self, input_csv="station/site_info.csv", 
-                 target_csv="station/eew_target.csv"):
-        self.input_csv = input_csv
-        self.target_csv = target_csv
-    
-    def load_input_stations(self) -> pd.DataFrame:
-        return pd.read_csv(self.input_csv)
-    
-    def load_target_stations(self) -> pd.DataFrame:
-        return pd.read_csv(self.target_csv)
-
-class DatabaseStationSource(StationSource):
-    """未來支援：從資料庫（PostgreSQL、MongoDB 等）讀取"""
-    pass
-```
-
-**遷移步驟**：
-1. 定義 `StationSource` 抽象基類
-2. 實現 `LocalCSVStationSource`
-3. 在初始化時使用 `LocalCSVStationSource()`
-4. 新增其他來源實現（資料庫等）
-
-**必填欄位保持不變**：
-- `site_info`: Station, Latitude, Longitude, Elevation
-- `eew_target`: network, county, station, station_zh, longitude, latitude, elevation
-
----
-
-### 1.3 新增外部參數來源（Vs30、site effects 等）
-
-**當前方案**：Hugging Face (`SeisBlue/TaiwanVs30`) + 本地預設值 600
-
-**擴充點**：
-```python
-class SiteParameterSource(ABC):
-    @abstractmethod
-    def query_vs30(self, lat: float, lon: float) -> float:
-        """查詢 Vs30"""
-        pass
-    
-    @abstractmethod
-    def query_site_class(self, lat: float, lon: float) -> str:
-        """查詢場址分類（未來功能）"""
-        pass
-
-class HFVs30Source(SiteParameterSource):
-    def __init__(self, default_vs30=600):
-        self.tree = None
-        self.vs30_table = None
-        self.default_vs30 = default_vs30
-        self.initialize()
-    
-    def initialize(self):
-        # 當前邏輯
-        pass
-    
-    def query_vs30(self, lat: float, lon: float) -> float:
-        # 當前邏輯
-        pass
-    
-    def query_site_class(self, lat: float, lon: float) -> str:
-        """未實作，回傳預設值"""
-        return "C"
-```
-
-**向後相容性**：
-- Vs30 預設值保持 600 m/s
-- 新增參數（site class、土壤類型等）需同步更新：
-  - `01-data-contract.md` → station_info_padded 欄位數調整
-  - 模型輸入形狀（若新增欄位，需重訓練或調整 input layer）
-
----
-
-## 二、資料格式擴充
-
-### 2.1 新增波形分量
-
-**當前分量**：Z (豎向), N (南北), E (東西)
-
-**未來擴充**：
-- Radial (R)、Transverse (T) 分量
-- 速度波形（V）、位移波形（D）等
-
-**遷移步驟**：
-1. 擴充 `extract_waveforms_from_stream()` 中的分量對應
-2. 調整 waveform_3c 形狀從 (3000, 3) 至 (3000, N_components)
-3. 更新模型 CNN 的輸入通道數（需重訓練）
-
-**必做**：
-- 更新 `01-data-contract.md` → 新增分量對應表
-- 更新 `02-processing-rules.md` → 新增分量缺失規則
-
----
-
-### 2.2 新增輸入特徵
-
-**當前特徵**：
-- 波形 (3000, 3)
-- 測站位置 (lat, lon, elev, vs30)
-- 目標位置 (lat, lon, elev, vs30)
-
-**未來擴充**：
-- 震源深度、震度規模（M）
-- 頻率內容（PSD、傅立葉頻譜等）
-- 歷史背景應力等
-
-**遷移步驟**：
-1. 擴充 tensor_data 字典新增鍵值對
-2. 調整模型結構（Position Embedding、MLP 輸入維度等）
-3. **需重訓練模型**
-
-**必做**：
-- 更新 `01-data-contract.md` → 模型輸入形狀
-- 更新 `02-processing-rules.md` → 新特徵計算規則
-
----
-
-## 三、模型與推論擴充
-
-### 3.1 新增推論模型
-
-**當前模型**：FullModel (CNN + Position Embedding + Transformer + MLP + MDN)
-
-**擴充方式**（Strategy Pattern）：
-```python
-class PredictionModel(ABC):
-    @abstractmethod
-    def predict(self, tensor_data: dict) -> Tuple[np.ndarray, np.ndarray, np.ndarray]:
-        """
-        輸出 (weight, sigma, mu)
-        """
-        pass
-
-class TransformerMDNModel(PredictionModel):
-    def __init__(self, model_path):
-        self.model = get_full_model(model_path)
-    
-    def predict(self, tensor_data: dict) -> Tuple[np.ndarray, np.ndarray, np.ndarray]:
-        with torch.no_grad():
-            return self.model(tensor_data)
-
-class AlternativeModel(PredictionModel):
-    """未來：LSTM、GRU、Attention-only 等架構"""
-    pass
-
-# Factory
-def get_model_factory(model_type: str = "transformer_mdn") -> PredictionModel:
-    if model_type == "transformer_mdn":
-        return TransformerMDNModel(model_path)
-    elif model_type == "alternative":
-        return AlternativeModel(...)
-    else:
-        raise ValueError(f"Unknown model type: {model_type}")
-```
-
-**向後相容性**：
-- 所有模型必須遵守輸入/輸出形狀約定（見 `01-data-contract.md`）
-- 新模型需提供相同的推論介面
-
----
-
-### 3.2 新增輸出後處理模式
-
-**當前方式**：MDN 加權平均 (Σ weight × μ)
-
-**擴充方式**：
-```python
-class PGAEstimator(ABC):
-    @abstractmethod
-    def estimate(self, weight: np.ndarray, sigma: np.ndarray, mu: np.ndarray) -> np.ndarray:
-        """
-        從 MDN 參數估計 PGA
-        """
-        pass
-
-class WeightedMeanEstimator(PGAEstimator):
-    def estimate(self, weight, sigma, mu):
-        return np.sum(weight * mu, axis=2)  # 當前方式
-
-class MedianEstimator(PGAEstimator):
-    def estimate(self, weight, sigma, mu):
-        # 未來：使用中位數或分位數
-        pass
-```
-
----
-
-## 四、批次策略擴充
-
-### 4.1 動態批次大小調整
-
-**當前方式**：固定 25 測站、25 目標點 / 批
-
-**擴充方式**：
-```python
-class BatchConfig:
-    def __init__(self, n_stations=25, n_targets=25, device="cpu"):
-        self.n_stations = n_stations
-        self.n_targets = n_targets
-        self.device = device
-    
-    @staticmethod
-    def auto_tune(available_memory_mb: float) -> "BatchConfig":
-        """根據可用記憶體自動調整批次大小"""
-        if available_memory_mb < 2000:
-            return BatchConfig(n_stations=25, n_targets=10)
-        elif available_memory_mb < 8000:
-            return BatchConfig(n_stations=25, n_targets=25)
-        else:
-            return BatchConfig(n_stations=25, n_targets=50)
-```
-
----
-
-## 五、UI 擴充
-
-### 5.1 新增推論模式（不影響 spec 契約）
-
-**當前模式**：互動式 GUI（Gradio）
-
-**未來擴充**：
-- 批次命令列介面 (CLI)
-- 後臺排隊系統 (Celery + Redis)
-- 即時串流模式
-
-**關鍵**：所有模式共享相同的核心邏輯，data flow 不變
-
----
-
-### 5.2 新增可視化輸出格式
-
-**當前格式**：Folium 地圖 (HTML) + 波形圖 (matplotlib)
-
-**未來擴充**：
-- 3D 地形圖 (Plotly 3D)
-- 時間動畫（逐秒動態渲染）
-- GeoJSON 匯出
-
----
-
-## 六. 新功能檢查清單
-
-每次新增功能時，必須檢查：
-
-### 資料層面
-- [ ] 新增欄位是否需更新 CSV 結構？若是，更新 `01-data-contract.md`
-- [ ] 新增欄位是否破壞向後相容性？若是，計畫遷移策略
-- [ ] 新資料來源是否需異常處理？若是，更新 `03-error-handling.md`
-
-### 模型層面
-- [ ] 新增輸入特徵是否改變 tensor shape？若是，檢查模型相容性
-- [ ] 是否需重訓練模型？
-- [ ] 新模型的輸出形狀是否與現有契約相同？
-
-### 處理層面
-- [ ] 新增參數是否涉及批次調整？若是，更新 `02-processing-rules.md`
-- [ ] 新增邏輯是否需新的日誌點？若是，更新 `03-error-handling.md`
-- [ ] 新增邏輯是否有失敗情景？若是，定義降級策略
-
-### 規格更新
-- [ ] 是否需更新 `00-overview.md` 不變條件？
-- [ ] 是否需更新 `01-data-contract.md` I/O shape？
-- [ ] 是否需更新 `02-processing-rules.md` 處理規則？
-- [ ] 是否需更新 `03-error-handling.md` 故障場景？
-- [ ] 本次變更是否記錄至 `changelog.md`？
-
----
-
-## 七. 版本相容性表
-
-| 版本 | 變更 | 相容性 |
-|-----|------|--------|
-| v1.0 | 初版（當前） | baseline |
-| v1.1 (未來) | 新增 Radial/Transverse 分量 | 需遷移 waveform shape |
-| v1.2 (未來) | 支援遠端 FDSN 波形 | 向後相容（工廠模式） |
-| v2.0 (未來) | 新模型（重訓練） | 破壞相容，需更新 spec |
-
----
-
-## 八. 決策樹：何時更新 Spec？
-
-```
-新增或改動功能
-├─ 僅改動程式邏輯（無資料契約變更）？
-│  └─ 不必更新 spec（但記錄至 changelog）
-├─ 改動資料結構或 I/O shape？
-│  └─ 更新 01-data-contract.md
-├─ 改動處理規則或限制？
-│  └─ 更新 02-processing-rules.md
-├─ 新增故障場景？
-│  └─ 更新 03-error-handling.md
-└─ 改動核心不變條件？
-   └─ 更新 00-overview.md 快速參考表
-```
-

spec/README.md

@@ -1,192 +0,0 @@
-# 規格快速導航 (Quick Reference)
-
-> 根據不同需求快速定位相應規格檔案。對應 GitHub Copilot 指南中的查詢策略。
-
-## 問題類型 → 規格檔案對應表
-
-### 資料與契約相關
-
-| 問題 | 查閱檔案 | 關鍵章節 |
-|-----|--------|--------|
-| 「模型輸入形狀是什麼？」 | `01-data-contract.md` | 3.1 模型輸入 |
-| 「site_info.csv 必填欄位有哪些？」 | `01-data-contract.md` | 1.2 輸入測站表 |
-| 「缺少 N/E 分量時怎麼辦？」 | `01-data-contract.md` | 1.1 MSEED 波形檔案 |
-| 「波形應該怎樣補零？」 | `02-processing-rules.md` | 3.2 波形補零與對齊 |
-| 「目標測站表的必填欄位？」 | `01-data-contract.md` | 1.3 目標測站表 |
-
-### 處理規則與限制相關
-
-| 問題 | 查閱檔案 | 關鍵章節 |
-|-----|--------|--------|
-| 「最多幾個輸入測站？」 | `02-processing-rules.md` | 2.2 測站選擇規則 |
-| 「時間窗長度的限制？」 | `02-processing-rules.md` | 2.1 時間參數 |
-| 「Vs30 查詢失敗怎麼降級？」 | `02-processing-rules.md` | 5 Vs30 查詢規則 |
-| 「目標批次大小多少？」 | `02-processing-rules.md` | 1.2 目標批次 |
-| 「訊號處理流程？」 | `02-processing-rules.md` | 3.1 訊號處理 |
-
-### 錯誤與故障相關
-
-| 問題 | 查閱檔案 | 關鍵章節 |
-|-----|--------|--------|
-| 「Vs30 下載失敗會怎樣？」 | `03-error-handling.md` | A1 Vs30 資料下載失敗 |
-| 「模型載入失敗怎麼處理？」 | `03-error-handling.md` | A2 模型權重載入失敗 |
-| 「測站 < 25 個怎麼辦？」 | `03-error-handling.md` | C2 可用測站 < 25 個 |
-| 「缺少 N 或 E 分量的 UI 訊息？」 | `03-error-handling.md` | 3.2 警告訊息 |
-| 「波形時間超出範圍？」 | `03-error-handling.md` | B2 波形時間長度超出範圍 |
-
-### 擴充與功能相關
-
-| 問題 | 查閱檔案 | 關鍵章節 |
-|-----|--------|--------|
-| 「怎樣新增遠端波形來源？」 | `04-extensions.md` | 1.1 新增波形資料來源 |
-| 「如何新增測站資料來源？」 | `04-extensions.md` | 1.2 新增測站資料來源 |
-| 「新增功能時要檢查什麼？」 | `04-extensions.md` | 6 新功能檢查清單 |
-| 「何時需要更新規格？」 | `04-extensions.md` | 8 決策樹 |
-
-### 專案概覽相關
-
-| 問題 | 查閱檔案 | 關鍵章節 |
-|-----|--------|--------|
-| 「系統架構是什麼？」 | `00-overview.md` | 系統架構 |
-| 「核心不變條件有哪些？」 | `00-overview.md` | 核心不變條件 |
-| 「各模組的職責？」 | `00-overview.md` | 核心模組清單 |
-| 「快速查詢表（取樣率、補零等）？」 | `00-overview.md` | 快速參考表 |
-
----
-
-## 迭代開發工作流
-
-### 當需求改變時（`/project.spec`）
-
-1. **評估需求**：是什麼類型的改變？
-   - 資料結構變更 → 查 `01-data-contract.md`
-   - 處理流程改變 → 查 `02-processing-rules.md`
-   - 新故障場景 → 查 `03-error-handling.md`
-   - 新功能擴展 → 查 `04-extensions.md`
-
-2. **掃描現有代碼**：該部分在 `app.py` 的哪裡？
-
-3. **更新相應 spec**：修改上述定位到的規格檔案
-
-4. **建立 `spec/plan.md`**：定義本次迭代的任務清單
-
----
-
-### 執行迭代時（`/project.plan`）
-
-1. **根據 `plan.md`** 拆解任務
-
-2. **實作每個任務**：
-   - 檢查相應 spec 的約定（例如 I/O shape）
-   - 在代碼註解中引用 spec（例如 "spec #2：補零邏輯"）
-   - 運行測試
-
-3. **更新 `changelog.md`**：記錄本次變更摘要
-
-4. **完成檢查**：
-   - 所有 spec 已同步？
-   - 所有日誌已記錄？
-   - 無新增 ERROR 日誌？
-
----
-
-## 常見 Spec 修改場景
-
-### 場景 1：新增 CSV 欄位
-
-**步驟**：
-1. 更新 `01-data-contract.md` 的相應表格（欄位型態、範圍）
-2. 更新 `01-data-contract.md` 的驗證邏輯代碼片段
-3. 若涉及模型，更新 `02-processing-rules.md` 的相應處理邏輯
-4. 在 `04-extensions.md` 記錄向後相容性計畫
-
-### 場景 2：新增故障場景
-
-**步驟**：
-1. 在 `03-error-handling.md` 的「故障場景表」新增行
-2. 定義行為、日誌、使用者介面訊息
-3. 在「決策樹」中新增分支
-4. 在 `app.py` 實作捕獲邏輯
-
-### 場景 3：新增外部資源
-
-**步驟**：
-1. 在 `01-data-contract.md` 的「冷啟動流程」新增步驟
-2. 在 `02-processing-rules.md` 定義查詢/降級規則
-3. 在 `03-error-handling.md` 定義故障場景
-4. 在 `04-extensions.md` 記錄工廠模式
-
----
-
-## 日誌級別速查
-
-| 等級 | 何時使用 | 例子 | 關聯 Spec |
-|-----|--------|------|-----------|
-| **INFO** | 主流程進度 | "載入波形完成" | 02-processing-rules 7.1 |
-| **WARNING** | 降級決策 | "使用預設 Vs30 值" | 03-error-handling A1 |
-| **ERROR** | 可恢復單點失敗 | "測站查詢失敗，跳過" | 03-error-handling C3 |
-
----
-
-## 不變條件速查表
-
-| 項目 | 值 | 來源 |
-|-----|-----|------|
-| 取樣率 | 100 Hz | 00-overview 或 02-processing-rules 2.1 |
-| 時間窗 | 30 秒 (3000 samples) | 00-overview 或 02-processing-rules 2.1 |
-| 輸入測站 | 最多 25 | 00-overview 或 02-processing-rules 1.1 |
-| 補零策略 | 尾段補 0 至 3000 | 02-processing-rules 3.2 |
-| Vs30 預設值 | 600 m/s | 02-processing-rules 5 |
-| 低通濾波 | 10 Hz, 4-order Butterworth | 02-processing-rules 3.1 |
-| 地圖高度 | 800 px | 00-overview 快速參考表 |
-| 目標批次大小 | 25 點/批 | 02-processing-rules 1.2 |
-
----
-
-## 常見編輯清單
-
-### 新增功能時
-
-- [ ] 更新 `00-overview.md` 的「模組清單」（若新增模組）
-- [ ] 更新相應的 data contract 或 processing rules
-- [ ] 在 `03-error-handling.md` 新增故障場景
-- [ ] 建立 `spec/plan.md` 的任務清單
-- [ ] 在 `changelog.md` 的 Unreleased 記錄
-
-### 修復 Bug 時
-
-- [ ] 如果涉及規格違反，先確認是 bug 還是規格有誤
-- [ ] 在 `changelog.md` 的 Unreleased 記錄修復內容
-- [ ] 若修改了日誌，更新 `03-error-handling.md` 的日誌等級表
-
-### 重構代碼時
-
-- [ ] 確認不改變 I/O 形狀、模組邊界、日誌原則
-- [ ] 若改變，則按「新增功能」流程走
-
----
-
-## 提交時檢查清單
-
-```bash
-# 1. 確認所有 spec 已更新
-ls -la spec/
-
-# 2. 檢查 changelog.md 已記錄
-grep -A 5 "## \[Unreleased\]" changelog.md
-
-# 3. 檢查代碼中的 spec 引用註解
-grep -n "spec #\|spec/" app.py
-
-# 4. 執行應用、查閱日誌，確認無新增 ERROR
-# (執行後檢查日誌輸出)
-
-# 5. 提交
-git add spec/ changelog.md app.py
-git commit -m "描述本次變更"
-```
-
----
-
-**有問題？** 查看 `.github/copilot-instructions.md` 的「對話時的 Spec 查詢策略」一節。
-

spec/plan.md

@@ -1,167 +0,0 @@
-# 迭代計畫 (plan.md) — 震央資訊 JSON 管理化 [ARCHIVED]
-
-> ⏹️ **本迭代已完成** — Sprint 003 計畫已完成並歸檔
-> 下次迭代時將重新生成 `spec/plan.md`。若需重新執行此迭代，請參考 `changelog.md` 的 Sprint 003 摘要。
-
-## 需求重述
-
-使用者需要將震央（地震震心）位置資訊集中管理於 JSON 檔案，而非透過 UI 輸入框讓使用者編輯。具體要求：
-
-1. **震央資訊 JSON 化**：建立 `waveform/event.json`，儲存每個地震事件的震央經緯度、深度等屬性
-2. **UI 移除編輯框**：移除 Gradio 介面中的「震央經度」、「震央緯度」輸入框（已無法編輯）
-3. **震央顯示唯讀**：地圖上顯示震央位置（紅星標記），但不提供使用者修改介面
-4. **事件綁定自動注入**：選擇事件時，自動從 JSON 讀取對應的震央位置並更新地圖
-
-## 迭代目標
-
-通過資料集中管理原則，簡化 UI、提升使用者體驗，並確保震央資訊的一致性與可維護性。
-
-### 子目標
-- 建立 `waveform/event.json` 資料結構
-- 更新 Gradio 介面：移除經緯度輸入框
-- 重構事件切換邏輯：從 JSON 自動讀取震央資訊
-- 驗證地圖顯示的震央位置正確性
-
-## 範圍
-
-### 新增檔案
-- **`waveform/event.json`**：地震事件元資料中心
-
-### 修改檔案
-- **`app.py`**：
-  - 新增 `load_earthquake_metadata()` 函數（從 JSON 讀取震央資訊）
-  - 移除 Gradio 中的 `epicenter_lon_input` 與 `epicenter_lat_input` 組件
-  - 調整事件綁定邏輯，自動注入震央資訊
-  - 更新 callback 函數簽名（移除經緯度參數）
-
-### 不涉及的檔案
-- 規格模組（`spec/00-04`）：資料結構無變化（仍用經緯度）
-- 測站表、Vs30、波形檔案：無異動
-
-## 驗收標準 (Definition of Done)
-
-1. ✅ `waveform/event.json` 已建立，包含所有事件的震央信息（經度、緯度、深度等）
-2. ✅ Gradio 介面移除經緯度輸入框；介面仍顯示參數但為唯讀或隱藏
-3. ✅ 點擊事件下拉菜單時，自動從 JSON 讀取並更新地圖上的震央標記
-4. ✅ 地圖正確顯示震央位置（紅星，帶有座標提示）
-5. ✅ 所有 callback 函數的簽名已更新（不再接收 `epicenter_lat`、`epicenter_lon` 參數）
-6. ✅ 代碼無編譯/語法錯誤；應用可正常啟動
-7. ✅ 冒煙測試通過：事件切換、波形載入、預測執行正常
-
-## 高層任務列表
-
-| 序號 | 任務 | 說明 |
-|-----|------|------|
-| T-001 | 建立 `waveform/event.json` | 設計資料結構、填入初始事件資料 |
-| T-002 | 新增 `load_earthquake_metadata()` | 從 JSON 讀取震央資訊；缺失時提示 ERROR |
-| T-003 | 修改 Gradio 介面佈局 | 移除經緯度輸入框；在狀態區顯示震央座標（唯讀） |
-| T-004 | 更新 callback 簽名 | 移除所有 callback 中的 `epicenter_lat`、`epicenter_lon` 參數 |
-| T-005 | 事件切換自動注入 | `event_dropdown.change()` 自動從 JSON 注入震央資訊 |
-| T-006 | 測試與驗證 | 冒煙測試、地圖顯示確認 |
-
-## Invariants 對齐
-
-| 不變條件 | 狀態 | 說明 |
-|--------|------|------|
-| 波形輸入 | ✅ Not Impacted | 時間窗、取樣率、補零邏輯維持不變 |
-| 測站選擇 | ✅ Not Impacted | 最多 25 站，距離排序邏輯完全不變 |
-| 推論引擎 | ✅ Not Impacted | 模型輸入/輸出形狀、MDN 轉換邏輯不變 |
-| 資料契約 | ✅ Not Impacted | CSV 欄位、必填項、檔案格式不變 |
-| 地圖高度 | ✅ Not Impacted | 仍固定 800px |
-| 錯誤處理 | ✅ Not Impacted | 降級策略、日誌等級維持不變 |
-| 預設資源 | ✅ Not Impacted | 模型、Vs30、波形預裝策略不變 |
-
-## 風險與回滾
-
-### 主要風險
-
-1. **JSON 檔案缺失或格式錯誤**
-   - **風險**：應用啟動時無法讀取震央資訊，導致初始化失敗
-   - **緩解**：
-     - 在 `load_earthquake_metadata()` 中添加異常捕捉
-     - 若 JSON 缺失，記錄 ERROR log 並使用預設震央座標 (121.57, 23.88)
-     - 允許應用繼續啟動（降級策略）
-   - **回滾**：恢復 UI 輸入框，手動輸入震央座標
-
-2. **事件下拉菜單與 JSON 鍵值不一致**
-   - **風險**：選擇事件時找不到對應的 JSON 記錄
-   - **緩解**：
-     - 事件名稱與 JSON 鍵名保持一致
-     - 在轉換時進行 key mapping 驗證
-     - 提示使用者：未找到該事件的震央資訊，使用預設座標
-   - **回滾**：保留舊邏輯作為備用
-
-3. **Callback 參數不一致導致崩潰**
-   - **風險**：callback 簽名改動後，某些 callback 仍期望接收經緯度參數
-   - **緩解**：
-     - 全局搜尋所有 callback 綁定，確保一致性
-     - 在 callback 內部從 JSON 讀取座標，而非參數傳遞
-   - **回滾**：恢復原始 callback 簽名
-
-### 最小可逆步驟
-
-1. 建立 JSON 檔案
-2. 新增 `load_earthquake_metadata()` 並測試讀取邏輯
-3. 更新第一個 callback���驗證運作
-4. 逐步更新其他 callback
-
-## 冒煙測試
-
-### 測試 1：JSON 檔案與初始化
-**步驟**
-1. 確認 `waveform/event.json` 存在且格式有效
-2. 啟動應用
-3. 檢查日誌：應有「震央資訊載入完成」提示
-
-**預期結果**
-- 應用正常啟動
-- 日誌確認 JSON 讀取成功
-- 無 FileNotFoundError 或 JSONDecodeError
-
-### 測試 2：Gradio 介面佈局
-**步驟**
-1. 開啟應用 UI
-2. 檢查參數輸入區
-
-**預期結果**
-- 經緯度輸入框已移除
-- 狀態區仍顯示震央座標（或在地圖懸停提示中）
-- 介面整潔無破損
-
-### 測試 3：事件切換自動更新
-**步驟**
-1. 應用已啟動
-2. 從事件下拉菜單選擇一個事件
-3. 觀察地圖
-
-**預期結果**
-- 地圖中心自動移動到新震央
-- 紅星標記位置正確
-- 座標提示（hover）顯示正確的經緯度
-
-### 測試 4：完整工作流
-**步驟**
-1. 選擇事件
-2. 調整時間滑桿
-3. 點擊「載入波形」
-4. 點擊「執行預測」
-
-**預期結果**
-- 波形地圖、波形圖、預測結果正常顯示
-- 震央位置在地圖上始終正確
-- 無參數傳遞錯誤日誌
-
----
-
-## ⏸️ 暫停點
-
-**上述計畫已準備完成。請在下方進行審核與調整：**
-
-1. **架構確認**：`waveform/event.json` 的資料結構是否滿足需求？
-2. **命名確認**：函數名稱 `load_earthquake_metadata()` 是否合適？
-3. **降級策略**：JSON 缺失時使用預設座標 (121.57, 23.88)，是否可接受？
-4. **優先級**：任務順序是否需要調整？
-
-完成編輯後，回覆「**確認**」或「**核准**」即可進行下一階段任務拆解（執行 `/project.task`）。
-
-

spec/task.md

@@ -1,676 +0,0 @@
-# 詳細任務拆解 (task.md) — 震央資訊 JSON 管理化 [ARCHIVED]
-
-> ⏹️ **本迭代已完成** — Sprint 003 任務已全數完成並歸檔
-> 下次迭代時將重新生成 `spec/task.md`。若需重新執行此迭代，請參考 `changelog.md` 的 Sprint 003 摘要。
-
-## 📋 完成摘要
-
-| 任務 | 狀態 | 說明 |
-|-----|------|------|
-| T-001 | ✅ 完成 | `waveform/event.json` 已建立，包含 YYYYMMDD 格式的 event_id |
-| T-002 | ✅ 完成 | `load_earthquake_metadata()` 函數已新增，降級策略完整 |
-| T-003 | ✅ 完成 | Gradio 介面已移除經緯度輸入框，新增唯讀座標顯示 |
-| T-004 | ✅ 完成 | 5 個函數簽名已更新（移除 epicenter 參數） |
-| T-005 | ✅ 完成 | Callback 綁定已重構，座標自動注入機制正常運作 |
-| T-006 | ✅ 完成 | 程式碼語法驗證通過，無編譯錯誤 |
-
----
-
-## T-001: 建立 `waveform/event.json`
-
-### 描述
-設計並建立地震事件元資料 JSON 檔案，集中管理所有事件的震央位置、深度、時間等屬性。
-
-### 受影響檔案
-- **新增**：`waveform/event.json`
-
-### 具體變更點
-
-#### `waveform/event.json` (新增檔案)
-- **位置**：專案根目錄下 `waveform/` 資料夾
-- **格式**：JSON，包含以下結構：
-  ```json
-  {
-    "events": [
-      {
-        "event_id": "20240403",
-        "event_name": "0403花蓮地震 (2024)",
-        "epicenter_lat": 23.88,
-        "epicenter_lon": 121.57,
-        "depth_km": 25.0,
-        "magnitude": 7.2,
-        "timestamp": "2024-04-03T07:58:00Z",
-        "mseed_file": "waveform/20240403.mseed",
-        "intensity_map_file": "intensity_map/20240403.png"
-      }
-    ]
-  }
-  ```
-
-### 資料欄位說明
-| 欄位 | 型態 | 說明 |
-|-----|-----|------|
-| `event_id` | 字串 | 事件唯一識別碼，使用 YYYYMMDD 格式（e.g., "20240403"），對應波形檔案與震度圖命名 |
-| `event_name` | 字串 | 事件顯示名稱，與 EARTHQUAKE_EVENTS 的鍵名保持一致 |
-| `epicenter_lat` | 浮點 | 震央緯度（度） |
-| `epicenter_lon` | 浮點 | 震央經度（度） |
-| `depth_km` | 浮點 | 震源深度（公里），選填 |
-| `magnitude` | 浮點 | 地震規模，選填 |
-| `timestamp` | 字串 | ISO 8601 時間戳，選填 |
-| `mseed_file` | 字串 | 對應的 MSEED 波形檔案路徑（e.g., "waveform/20240403.mseed"） |
-| `intensity_map_file` | 字串 | 對應的實際震度圖檔案路徑（e.g., "intensity_map/20240403.png"），選填 |
-
-### 驗收標準
-- [ ] `waveform/event.json` 檔案已建立
-- [ ] JSON 格式有效（可通過 `json.load()` 解析無誤）
-- [ ] 包含至少一個事件記錄（0403花蓮地震）
-- [ ] `event_id` 使用 YYYYMMDD 格式（e.g., "20240403"）且與波形檔案、震度圖檔案命名對應
-- [ ] 事件 `event_name` 與 app.py 中 `EARTHQUAKE_EVENTS` 的鍵名一致
-- [ ] 震央座標範圍正確（緯度 5-30°，經度 110-123°）
-
-### 風險等級
-**低** — 單純新增檔案，不涉及邏輯變更
-
----
-
-## T-002: 新增 `load_earthquake_metadata()` 函數
-
-### 描述
-新增從 JSON 檔案讀取地震事件元資料的函數，應用啟動時調用以初始化震央資訊字典。
-
-### 受影響檔案
-- **修改**：`app.py`
-
-### 具體變更點
-
-#### `app.py` (新增函數，位置：在全域初始化區段，約 L80-90)
-```python
-# 新增位置：在「載入目標測站」區塊之後 (L110 左右)
-def load_earthquake_metadata(event_json_path="waveform/event.json"):
-    """
-    從 JSON 檔案讀取地震事件元資料（震央經緯度、深度等）
-    
-    參數：
-        event_json_path: event.json 的相對或絕對路徑
-    
-    返回：
-        dict: {event_name -> {"epicenter_lat", "epicenter_lon", "depth_km", ...}}
-        若檔案缺失或無效，使用預設座標 (121.57, 23.88) 並記錄警告
-    """
-    earthquake_metadata = {}
-    
-    try:
-        import json
-        with open(event_json_path, 'r', encoding='utf-8') as f:
-            data = json.load(f)
-        
-        if "events" not in data:
-            logger.warning(f"{event_json_path} 缺少 'events' 鍵，使用預設座標")
-            return {}
-        
-        # 將事件列表轉換為以 event_name 為鍵的字典
-        for event in data["events"]:
-            event_name = event.get("event_name")
-            if event_name:
-                earthquake_metadata[event_name] = {
-                    "epicenter_lat": event.get("epicenter_lat", 23.88),
-                    "epicenter_lon": event.get("epicenter_lon", 121.57),
-                    "depth_km": event.get("depth_km", None),
-                    "magnitude": event.get("magnitude", None),
-                }
-                logger.info(f"載入事件: {event_name} | 震央: ({event['epicenter_lon']}, {event['epicenter_lat']})")
-        
-        logger.info(f"地震事件元資料載入完成（共 {len(earthquake_metadata)} 個事件）")
-        return earthquake_metadata
-    
-    except FileNotFoundError:
-        logger.error(f"事件元資料檔案缺失: {event_json_path}")
-        logger.warning("將使用預設震央座標 (121.57, 23.88)")
-        return {}
-    
-    except json.JSONDecodeError as e:
-        logger.error(f"事件元資料 JSON 解析失敗: {e}")
-        logger.warning("將使用預設震央座標 (121.57, 23.88)")
-        return {}
-    
-    except Exception as e:
-        logger.error(f"讀取事件元資料時發生未預期的錯誤: {e}")
-        logger.warning("將使用預設震央座標 (121.57, 23.88)")
-        return {}
-```
-
-#### `app.py` (全域初始化，位置：L110-115，在目標測站載入完成後)
-```python
-# ...existing code...
-
-# 載入地震事件元資料
-earthquake_metadata = load_earthquake_metadata("waveform/event.json")
-if not earthquake_metadata:
-    logger.warning("無法載入事件元資料，應用將使用預設震央座標")
-
-# ...existing code...
-```
-
-### 驗收標準
-- [ ] 函數 `load_earthquake_metadata()` 已定義且無語法錯誤
-- [ ] 應用啟動時自動呼叫該函數
-- [ ] JSON 檔案存在時，正確解析並填充 `earthquake_metadata` 字典
-- [ ] JSON 檔案缺失時，記錄 WARNING log 並返回空字典（不中斷啟動）
-- [ ] JSON 格式錯誤時，記錄 ERROR log 並返回空字典（不中斷啟動）
-- [ ] 日誌中可見「地震事件元資料載入完成」或「無法載入事件元資料」提示
-
-### 風險等級
-**中** — 涉及全域初始化邏輯，但降級策略完整
-
----
-
-## T-003: 修改 Gradio 介面佈局
-
-### 描述
-移除 Gradio 介面中的「震央經度」、「震央緯度」輸入框，改為在狀態區顯示唯讀的震央座標。
-
-### 受影響檔案
-- **修改**：`app.py`
-
-### 具體變更點
-
-#### `app.py` (移除輸入框，位置：L1265-1276)
-**原代碼：**
-```python
-            gr.Markdown("### 震央位置")
-            with gr.Row():
-                epicenter_lon_input = gr.Number(value=121.57, label="震央經度")
-                epicenter_lat_input = gr.Number(value=23.88, label="震央緯度")
-```
-
-**新代碼：**
-```python
-            gr.Markdown("### 震央位置")
-            gr.Markdown("> 震央位置由選定的地震事件自動決定，並在地圖上標示")
-            epicenter_info_display = gr.Textbox(
-                label="震央座標", 
-                value="緯度: 23.88° | 經度: 121.57°",
-                interactive=False,
-                lines=1
-            )
-```
-
-**說明：**
-- 移除 `epicenter_lon_input` 與 `epicenter_lat_input` 組件
-- 新增 `epicenter_info_display` 作為唯讀文本框，顯示當前選定事件的震央座標
-- 使用 Markdown 提示該欄位由事件自動決定
-
-### 驗收標準
-- [ ] Gradio 介面不再顯示經緯度輸入框
-- [ ] 新增的唯讀文本框 `epicenter_info_display` 正常顯示
-- [ ] 應用啟動時，該文本框顯示預設値「緯度: 23.88° | 經度: 121.57°」
-- [ ] 介面佈局整潔，無顯示破損
-
-### 風險等級
-**低** — 單純 UI 元件移除與新增
-
----
-
-## T-004: 更新 callback 簽名
-
-### 描述
-更新所有使用震央座標的 callback 函數簽名，移除 `epicenter_lat` 與 `epicenter_lon` 參數。改由在 callback 內部從 `earthquake_metadata` 字典讀取。
-
-### 受影響檔案
-- **修改**：`app.py`
-
-### 具體變更點
-
-#### 變更 1: `select_nearest_stations()` 函數簽名 (L440)
-**原：**
-```python
-def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25):
-```
-
-**新：**
-```python
-def select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25):
-    # 保持原簽名不變，因為內部邏輯不涉及全域狀態
-    # 此函數由 load_and_display_waveform() 與 predict_intensity() 呼叫
-    # 這兩個函數會先從 earthquake_metadata 取出座標再傳入
-```
-
-#### 變更 2: `load_and_display_waveform()` 函數簽名 (L1001)
-**原：**
-```python
-def load_and_display_waveform(event_name, start_time, duration, epicenter_lon, epicenter_lat):
-    ...
-    selected_stations = select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25)
-    ...
-```
-
-**新：**
-```python
-def load_and_display_waveform(event_name, start_time, duration):
-    """
-    載入並顯示波形
-    
-    參數：
-        event_name: 事件名稱（鍵值）
-        start_time: 開始時間（秒）
-        duration: 時間窗長度（秒）
-    
-    返回值、邏輯不變，但從全域 earthquake_metadata 取得震央座標
-    """
-    # 從全域 earthquake_metadata 讀取震央座標
-    epicenter_lat, epicenter_lon = _get_epicenter_coords(event_name)
-    
-    # 其餘邏輯不變
-    ...
-```
-
-#### 變更 3: `predict_intensity()` 函數簽名 (L1046)
-**原：**
-```python
-def predict_intensity(event_name, start_time, duration, epicenter_lon, epicenter_lat):
-    ...
-    selected_stations = select_nearest_stations(st, epicenter_lat, epicenter_lon, n_stations=25)
-    ...
-```
-
-**新：**
-```python
-def predict_intensity(event_name, start_time, duration):
-    """
-    執行模型推論並產生震度預測圖
-    
-    參數：
-        event_name: 事件名稱（鍵值）
-        start_time: 開始時間（秒）
-        duration: 時間窗長度（秒）
-    
-    返回值、邏輯不變，但從全域 earthquake_metadata 取得震央座標
-    """
-    # 從全域 earthquake_metadata 讀取震央座標
-    epicenter_lat, epicenter_lon = _get_epicenter_coords(event_name)
-    
-    # 其餘邏輯不變
-    ...
-```
-
-#### 變更 4: `on_event_change()` 函數簽名 (L864)
-**原：**
-```python
-def on_event_change(event_name, start_time, duration, epicenter_lon, epicenter_lat):
-    ...
-```
-
-**新：**
-```python
-def on_event_change(event_name, start_time, duration):
-    """
-    事件切換或波形參數變更時的回調
-    
-    參數：
-        event_name: 事件名稱
-        start_time: 開始時間
-        duration: 時間窗長度
-    
-    返回值：(station_map_html, waveform_plot, info_text, observed_img)
-    """
-    ...
-```
-
-#### 變更 5: `on_full_workflow()` 函數簽名 (L1220+)
-**原：**
-```python
-def on_full_workflow(event_name, start_time, duration, epicenter_lon, epicenter_lat):
-    ...
-```
-
-**新：**
-```python
-def on_full_workflow(event_name, start_time, duration):
-    """
-    執行完整的工作流：波形載入 → 測站選擇 → 推論 → 結果展示
-    
-    參數：
-        event_name: 事件名稱
-        start_time: 開始時間
-        duration: 時間窗長度
-    
-    返回值：
-    (station_map_html, waveform_plot, info_text, predicted_map_html, stats_text, observed_img)
-    """
-    ...
-```
-
-#### 新增輔助函數：`_get_epicenter_coords()` (位置：L110+，在 load_earthquake_metadata 之後)
-```python
-def _get_epicenter_coords(event_name):
-    """
-    從全域 earthquake_metadata 獲取指定事件的震央座標
-    
-    參數：
-        event_name: 事件名稱（EARTHQUAKE_EVENTS 的鍵值）
-    
-    返回：
-        tuple: (epicenter_lat, epicenter_lon)
-        若事件不存在或座標缺失，返回預設座標 (23.88, 121.57)
-    """
-    if event_name in earthquake_metadata:
-        metadata = earthquake_metadata[event_name]
-        lat = metadata.get("epicenter_lat", 23.88)
-        lon = metadata.get("epicenter_lon", 121.57)
-        return lat, lon
-    else:
-        logger.warning(f"未找到事件 '{event_name}' 的元資料，使用預設震央座標")
-        return 23.88, 121.57
-```
-
-### 驗收標準
-- [ ] 所有受影響函數的簽名已移除 `epicenter_lat` 與 `epicenter_lon` 參數
-- [ ] 新增 `_get_epicenter_coords()` 輔助函數
-- [ ] 所有函數內部邏輯正確地從全域 `earthquake_metadata` 或 `_get_epicenter_coords()` 取得座標
-- [ ] 應用啟動無語法錯誤
-- [ ] 代碼審查通過：沒有遺漏的函數簽名
-
-### 風險等級
-**高** — 涉及多個函數簽名變更，可能導致 callback 綁定失敗
-
----
-
-## T-005: 事件切換自動注入 + Callback 綁定重構
-
-### 描述
-重構 Gradio callback 綁定邏輯，確保：
-1. `event_dropdown.change()` 事件自動從 JSON 注入震央資訊
-2. 更新 `epicenter_info_display` 文本框顯示新的震央座標
-3. 所有 callback inputs/outputs 綁定正確移除經緯度參數
-
-### 受影響檔案
-- **修改**：`app.py`
-
-### 具體變更點
-
-#### `app.py` (Callback 綁定重構，位置：L1300-1340)
-
-**原代碼：**
-```python
-    # 綁定事件
-    event_dropdown.change(
-        fn=on_full_workflow,
-        inputs=[event_dropdown, start_slider, duration_slider, epicenter_lon_input, epicenter_lat_input],
-        outputs=[input_station_map, waveform_plot, info_output, predicted_intensity_map, stats_output, observed_intensity_image]
-    )
-
-    load_waveform_btn.click(
-        fn=load_and_display_waveform,
-        inputs=[event_dropdown, start_slider, duration_slider, epicenter_lon_input, epicenter_lat_input],
-        outputs=[input_station_map, waveform_plot, info_output, predict_btn]
-    )
-
-    predict_btn.click(
-        fn=predict_intensity,
-        inputs=[event_dropdown, start_slider, duration_slider, epicenter_lon_input, epicenter_lat_input],
-        outputs=[observed_intensity_image, predicted_intensity_map, stats_output]
-    )
-
-    # 應用啟動時自動執行完整工作流
-    demo.load(
-        fn=on_full_workflow,
-        inputs=[event_dropdown, start_slider, duration_slider, epicenter_lon_input, epicenter_lat_input],
-        outputs=[input_station_map, waveform_plot, info_output, predicted_intensity_map, stats_output, observed_intensity_image]
-    )
-```
-
-**新代碼：**
-```python
-    # 新增：事件切換時更新震央座標顯示的內部函數
-    def update_epicenter_display(event_name):
-        """事件切換時，更新震央座標顯示文本框"""
-        lat, lon = _get_epicenter_coords(event_name)
-        return f"緯度: {lat:.2f}° | 經度: {lon:.2f}°"
-
-    # 綁定事件
-    event_dropdown.change(
-        fn=lambda event_name, start_time, duration: (
-            *on_full_workflow(event_name, start_time, duration),
-            update_epicenter_display(event_name)
-        ),
-        inputs=[event_dropdown, start_slider, duration_slider],
-        outputs=[input_station_map, waveform_plot, info_output, predicted_intensity_map, stats_output, observed_intensity_image, epicenter_info_display]
-    )
-
-    load_waveform_btn.click(
-        fn=lambda event_name, start_time, duration: (
-            *load_and_display_waveform(event_name, start_time, duration),
-            predict_btn
-        ),
-        inputs=[event_dropdown, start_slider, duration_slider],
-        outputs=[input_station_map, waveform_plot, info_output, predict_btn]
-    )
-
-    predict_btn.click(
-        fn=predict_intensity,
-        inputs=[event_dropdown, start_slider, duration_slider],
-        outputs=[observed_intensity_image, predicted_intensity_map, stats_output]
-    )
-
-    # 應用啟動時自動執行完整工作流
-    demo.load(
-        fn=lambda event_name, start_time, duration: (
-            *on_full_workflow(event_name, start_time, duration),
-            update_epicenter_display(event_name)
-        ),
-        inputs=[event_dropdown, start_slider, duration_slider],
-        outputs=[input_station_map, waveform_plot, info_output, predicted_intensity_map, stats_output, observed_intensity_image, epicenter_info_display]
-    )
-```
-
-**說明：**
-- 移除所有 `inputs` 中的 `epicenter_lon_input` 與 `epicenter_lat_input`
-- 新增 outputs 中的 `epicenter_info_display` 以同步更新座標顯示
-- 事件切換時自動調用 `update_epicenter_display()` 更新座標文本框
-
-### 驗收標準
-- [ ] 所有 callback 綁定已更新，inputs/outputs 參數列表正確
-- [ ] 應用啟動時執行完整工作流並顯示正確的震央座標
-- [ ] 點擊事件下拉菜單時，座標顯示框自動更新
-- [ ] 點擊「載入波形」按鈕時，正確讀取新的震央座標
-- [ ] 點擊「執行預測」按鈕時，正確讀取新的震央座標
-- [ ] 地圖上的紅星標記始終指向正確的震央位置
-- [ ] 無 callback 參數不匹配的錯誤
-
-### 風險等級
-**高** — Callback 綁定任何錯誤都將導致應用崩潰
-
----
-
-## T-006: 測試與驗證
-
-### 描述
-執行冒煙測試，驗證整個迭代的所有組件運作正常。
-
-### 受影響檔案
-- **測試對象**：`app.py`、`waveform/event.json`
-
-### 測試用例
-
-#### ✅ 測試 1：JSON 檔案與初始化
-**步驟**
-1. 確認 `waveform/event.json` 存在且格式有效
-2. 啟動應用
-3. 檢查日誌輸出：應有「地震事件元資料載入完成」提示
-
-**預期結果**
-- ✅ 應用正常啟動（無 FileNotFoundError）
-- ✅ 日誌確認 JSON 讀取成功
-- ✅ `earthquake_metadata` 全域變數被正確填充
-- ✅ 無 JSONDecodeError
-
-**驗收條件**
-- [ ] 應用啟動完成
-- [ ] 日誌顯示「地震事件元資料載入完成」
-
----
-
-#### ✅ 測試 2：Gradio 介面佈局
-**步驟**
-1. 開啟應用 UI（http://localhost:7860）
-2. 檢查「輸入參數」區域
-
-**預期結果**
-- ✅ 經緯度輸入框（原有的兩個 Number 欄位）已不存在
-- ✅ 新增「震央座標」唯讀文本框，顯示「緯度: 23.88° | 經度: 121.57°」
-- ✅ 有提示文字說「震央位置由選定的地震事件自動決定」
-- ✅ 介面整潔無破損
-
-**驗收條件**
-- [ ] UI 中無經緯度輸入框
-- [ ] 震央座標文本框存在且可讀取
-- [ ] 提示文字清晰可見
-
----
-
-#### ✅ 測試 3：事件切換自動更新
-**步驟**
-1. 應用已啟動
-2. 觀察地圖：紅星標記位置與座標顯示框
-3. 在事件下拉菜單中選擇同一事件（或若有其他事件，嘗試切換）
-4. 觀察座標顯示框與地圖是否同步更新
-
-**預期結果**
-- ✅ 應用啟動時，座標顯示框顯示「緯度: 23.88° | 經度: 121.57°」
-- ✅ 地圖中心位置在 (23.88, 121.57)
-- ✅ 紅星標記位置正確
-- ✅ 若有多個事件，切換時座標與地圖同時更新
-
-**驗收條件**
-- [ ] 座標顯示框初始值正確
-- [ ] 地圖紅星位置正確
-- [ ] 地圖中心正確
-
----
-
-#### ✅ 測試 4：完整工作流
-**步驟**
-1. 應用已啟動
-2. 調整時間滑桿（開始時間、時間長度）
-3. 點擊「載入波形」按鈕
-4. 觀察波形地圖、波形圖、狀態信息
-5. 點擊「執行預測」按鈕
-6. 觀察預測結果、地圖、統計信息
-
-**預期結果**
-- ✅ 點擊「載入波形」後，波形地圖、波形圖正常顯示
-- ✅ 狀態信息中顯示「震央位置: (緯度, 經度)」
-- ✅ 測站分布地圖上的紅星標記位置正確
-- ✅ 點擊「執行預測」後，預測結果正常顯示
-- ✅ 預測地圖上的震央紅星位置正確
-- ✅ 無「參數不匹配」或「缺少參數」錯誤
-
-**驗收條件**
-- [ ] 波形載入成功
-- [ ] 狀態信息顯示正確的震央座標
-- [ ] 預測執行成功
-- [ ] 所有地圖上的紅星位置正確
-- [ ] 日誌無錯誤（僅允許 WARNING）
-
----
-
-#### ✅ 測試 5：日誌驗證
-**步驟**
-1. 啟動應用
-2. 執行測試 1-4
-3. 收集所有日誌輸出
-
-**預期結果**
-- ✅ 應用啟動時有「地震事件元資料載入完成」日誌
-- ✅ 波形載入時有「選擇距離震央最近的測站」日誌（帶有座標）
-- ✅ 預測時有「完成所有測站的預測」日誌
-- ✅ 無 ERROR 日誌（除非預期的異常處理）
-
-**驗收條件**
-- [ ] 日誌中包含完整的初始化流程
-- [ ] 無意外的 ERROR 或 CRITICAL 日誌
-- [ ] 所有座標相關操作都有對應的日誌記錄
-
----
-
-### 驗收標準 (總結)
-- [ ] T-001 ✅ JSON 檔案已建立並包含正確的結構
-- [ ] T-002 ✅ `load_earthquake_metadata()` 函數正常工作
-- [ ] T-003 ✅ 介面移除經緯度輸入框，新增座標顯示框
-- [ ] T-004 ✅ 所有 callback 函數簽名已更新
-- [ ] T-005 ✅ Callback 綁定邏輯正確，震央座標同步更新
-- [ ] T-006 ✅ 所有冒煙測試通過
-
-### 風險等級
-**中** — 綜合測試，涉及整個系統的協調運作
-
----
-
-## 變更摘要 (Impact Analysis)
-
-### 受影響的核心模組
-| 模組 | 變更類型 | 影響範圍 |
-|-----|--------|--------|
-| **初始化** | 新增 | 新增全域 `earthquake_metadata` 字典 + `load_earthquake_metadata()` 函數 |
-| **UI 佈局** | 移除 + 新增 | 移除 2 個輸入框，新增 1 個顯示框 + 1 個輔助函數 `update_epicenter_display()` |
-| **函數簽名** | 修改 | 5 個函數簽名更新（移除經緯度參數） |
-| **Callback 邏輯** | 修改 | 3 個 callback 綁定邏輯調整，新增座標自動注入 |
-| **資料流** | 修改 | 原先透過 UI 參數傳遞的座標，改由全域字典提供 |
-
-### 不變條件檢查
-| 項目 | 影響 | 說明 |
-|-----|------|------|
-| 波形輸入 | ✅ 無 | 訊號處理、補零、取樣率邏輯完全不變 |
-| 測站選擇 | ✅ 無 | 距離排序、去重、25 站上限邏輯不變 |
-| 推論引擎 | ✅ 無 | CNN、Transformer、MDN 模型邏輯完全不變 |
-| 資料契約 | ✅ 無 | CSV 欄位、模型輸入形狀不變 |
-| 錯誤處理 | ✅ 無 | 降級策略、日誌等級維持不變 |
-
-### 新增資料依賴
-- **新增檔案**：`waveform/event.json`（必須存在，缺失時使用預設值）
-- **新增全域變數**：`earthquake_metadata` (dict)
-
-### 向後相容性
-- ✅ **完全向後相容**：
-  - JSON 檔案缺失時，應用可正常啟動（降級至預設座標）
-  - 所有 callback 參數變更是內部實現，使用者介面不變
-  - 模型推論邏輯、資料結構、檔案格式均無變化
-
----
-
-## ⏸️ 暫停點
-
-**上述任務拆解已完成。請進行最終審核：**
-
-### 檢查清單
-
-1. **架構確認**：
-   - [ ] T-001 JSON 檔案結構是否合適？
-   - [ ] T-002 `load_earthquake_metadata()` 函數設計是否可行？
-   - [ ] 新增輔助函數 `_get_epicenter_coords()` 是否必要？
-
-2. **技術確認**：
-   - [ ] 函數簽名變更（T-004）的清單是否完整？
-   - [ ] Callback 綁定邏輯（T-005）是否正確？
-   - [ ] Lambda 封裝在 Callback 中是否適當？
-
-3. **測試確認**：
-   - [ ] 測試用例（T-006）的 4 個測試是否涵蓋所有關鍵路徑？
-   - [ ] 驗收標準是否清晰可測？
-
-4. **風險確認**：
-   - [ ] 三個「高風險」任務是否有足夠的驗收標準？
-   - [ ] 降級策略是否充分（JSON 缺失、事件不存在等）？
-
-### 確認方式
-
-請在本 markdown 中直接編輯，確認後回覆：
-- **「確認」** 或 **「通過」**：進行下一步 `/project.apply` 應用程式碼變更
-- **「調整」** + 具體建議：我會根據反饋進行修改
-
----
-
-## 版本資訊
-- **建立時間**：2025-10-26
-- **迭代**：震央資訊 JSON 管理化
-- **狀態**：等待使用者確認