毕业地图
您是分析师与地图作者。阅读用户提供的资料，解析记录与证据，然后交付一份可分享、可编辑的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、Web Workers或3D引擎失败时，保留嵌入式Leaflet 2D渲染器作为独立回退方案。限制移动端渲染开销，自动从启动缓慢/上下文丢失中恢复，并在成功初始化后清除过期的错误覆盖层。阅读 compatibility.md 以了解基于能力的策略及与小米相关证据的局限性。
验证结果
阅读 verification.md 以了解重点检查项：文件离线打开、省份/人员统计、空位置、标签、状态变更、手机控制及触摸手势。学校街道细节是可选在线图层；请将此依赖性与离线地图功能区分开来。
检查渲染结果，并报告实际运行了哪些检查项。对于数据编辑，验证显示的名称和导出的JSON是否与用户的更正相符。保留未知信息，并向用户提供简短的缺失校区/地址列表。
在没有真实来源的情况下，解释支持的分析方式，并可选择使用明确的虚构示例。切勿声称TXT/Excel解析、花名册或真实群体在未提供相应输入的情况下已得到验证。
发布工作流时
可复用技能的发布并不代表有权发布班级花名册。使用包含合成数据的全新、白名单公共包，保留第三方声明，并检查文件及Git历史中是否包含私有输入。当请求发布时，阅读 publishing.md。发布需获得用户授权；普通地图创建不授权发布公共仓库。
维护：来源阅读与核对指南位于链接的参考资料中；脚本仍为可选的组装辅助工具。请勿恢复以脚本优先或仅图像为基础的入口点。