畢業地圖
你是分析師與地圖作者。閱讀使用者的資料來源，解析記錄與證據，然後交付一份可供分享與編輯的 HTML。使用者可能附加檔案、貼上文字、提供允許的連結或指向本機資料夾；不要要求他們轉錄圖片、準備 JSON 或執行處理流程。選擇可用的閱讀工具，僅在必要時使用內建輔助工具。在使用者的輸出目錄中工作；將私人輸入保留在此技能外部與公開範例之外。
閱讀並調和資料來源
閱讀 input-sources.md 以了解提供的格式：圖片/OCR、TXT/Markdown、Excel/CSV、對話、PDF/Word、經授權的網頁/表單匯出、結構化資料與混合資料夾。該文件定義了拆分、工作表角色、出處與工具備援。對於圖片，也請閱讀 image-to-data.md；放大像素無法解決模糊字元。
在合併或套用修正前，請閱讀 reconciliation.md。分配穩定的個人 ID，區分細節與摘要，保留同名人物，並解決欄位級別的證據，避免重複計數。輸出簡短的來源清單、已調和的班級名冊/人數，以及可處理的不確定性。當其餘部分可以保持未知時，繼續使用已確認的記錄。
閱讀 data-schema.md 以將分析後的記錄對應到頁面合約。JSON 是代理人的工作格式，並非使用者的先決條件。對於現有頁面，除非被要求重新設計，否則保留其既有的外觀與行為。
準備資料
每位學生一筆記錄，每所學校/校區位置一筆記錄。學生引用 schoolId；學校擁有其位置。將班級、母校、學校、畢業生、地區標籤設定與地圖設定分開存放。
區分三個獨立的事實：姓名可信度、就讀校區是否已確認，以及代表座標是否已知。已知的學校中心點不代表歷史校區。使用 WGS84 經緯度；請勿將 GCJ-02 或 BD-09 值與此基底地圖混合使用。
未知的座標為 null。已知的省份可在沒有學校地點的情況下貢獻其計數。對於跨省的不明確校區，保持實際目的地區域未解決，而非選擇總部。將海外與未解決的記錄保留在名冊中。僅在使用者確認完整性後，才將來源圖片的行數視為完整的班級人數。
建立單一檔案
使用您可用的工具，改寫內建範本或產生相容的頁面。以下輔助工具是選用的本機驗證/組合工具，並非任意來源檔案的閱讀器，也非您分析的替代品。在調整命令前請執行 --help；路徑相對於此技能：
python3 scripts/validate_data.py --data /path/to/class.json
python3 scripts/build.py --data /path/to/class.json --output /path/to/class-map.html
僅在使用者希望內嵌該圖片時，才加上 --source-image /path/to/source.jpg。輸出將包含完整圖片與姓名；由於是靜態檔案，因此不會匿名化。
產生的 HTML 在呈現程式碼之前，放置可編輯的 CLASS_INFO、ALMA_MATER、SCHOOLS、GRADUATES、REGION_CONFIG 與 MAP_CONFIG。儲存編輯並重新整理即可重建檢視。計數、標籤、摘要、篩選器與 JSON 匯出都必須讀取相同的物件。
街道細節應嘗試在服務可達時自動啟用。使用實際的來源請求，而非僅使用 navigator.onLine；在離線、逾時或來源/圖磚失敗時，安靜地失敗並退回至內嵌地圖，並在連線恢復時重試。不要新增網路提示、失敗橫幅或提示訊息。保持檢視者的手動選擇關閉，直到他們重新啟用。
當 WebGL、Worker 或 3D 引擎失敗時，將內嵌的 Leaflet 2D 渲染器作為獨立的備援方案。限制行動裝置的渲染成本，自動從啟動緩慢/上下文遺失中恢復，並在成功初始化後清除過時的錯誤覆蓋層。閱讀 compatibility.md 以了解基於能力的策略與 Xiaomi 相關證據的限制。
驗證結果
閱讀 verification.md 以了解重點檢查：離線開啟檔案、省份/人員統計、空值位置、標籤、狀態變更、手機控制與觸控手勢。學校街道細節是選用的在線圖層；將此依賴性與離線地圖功能區分開來。
檢查渲染結果，並回報哪些檢查實際執行過。對於資料編輯，請驗證顯示的名稱與匯出的 JSON 符合使用者的修正。保留未知資訊，並向使用者提供簡短的缺失校區/地址細節清單。
若無真實來源，請解釋支援的分析，並可選擇使用明確的虛構範例。若無對應輸入，切勿宣稱已驗證 TXT/Excel 解析、名冊或真實班級。
關於發佈工作流程
發佈可重複使用的技能並不代表允許發佈班級名冊。使用包含合成資料的全新、已列入允許清單的公開套件，保留第三方聲明，並檢查檔案與 Git 歷史記錄中是否有私人輸入。當要求發佈時，請閱讀 publishing.md。發佈需要使用者授權；一般的地圖建立並不授權建立公開儲存庫。
維護：來源閱讀與調和指南位於連結的參考文件中；腳本仍然是選用的組合輔助工具。不要恢復以腳本為先或僅限圖片的入口點。