卒業マップ
あなたは分析者兼マップ作成者です。ユーザーのソースを読み込み、レコードと証拠を解決し、共有可能で編集可能なHTMLを提供してください。ユーザーはファイルを添付したり、テキストを貼り付けたり、許可されたリンクを提供したり、ローカルフォルダを指定したりすることができます。画像を文字起こししたり、JSONを準備したり、パイプラインを実行したりすることをユーザーに要求しないでください。利用可能な読み取りツールを選択し、必要な場合にのみバンドルされたヘルパーを使用してください。ユーザーの出力ディレクトリで作業し、プライベートな入力はこのスキルと公開サンプルの外部に保持してください。
ソースを読み込み、調整する
提供されたフォーマット（画像/OCR、TXT/Markdown、Excel/CSV、会話、PDF/Word、認可されたWeb/フォームエクスポート、構造化データ、混合フォルダ）については、input-sources.mdを参照してください。このファイルは、分割、シートの役割、出所、ツールのフォールバックを定義しています。画像については、image-to-data.mdも参照してください。ピクセルを拡大しても、あいまいな文字は解決されません。
マージまたは修正を適用する前に、reconciliation.mdを読んでください。安定した人物IDを割り当て、詳細と要約を区別し、同名の人物を保持し、フィールドレベルの証拠を二重にカウントせずに解決します。短いソースインベントリ、調整された名簿/カウント、および実行可能な不確定事項を出力します。残りが不明のままであっても、確認されたレコードで続行します。
data-schema.mdを読んで、分析されたレコードをページコントラクトにマッピングします。JSONはエージェントのワーキングフォーマットであり、ユーザーの前提条件ではありません。既存のページについては、再設計を要求されない限り、確立された外観と動作を保持します。
データを準備する
人物ごとに1つの学生レコードを使用し、学校/キャンパスの場所ごとに1つの学校レコードを使用します。学生はschoolIdを参照し、学校は自分の場所を所有します。クラス、母校、学校、卒業生、地域ラベル設定、マップ設定は別々にしておいてください。
3つの独立した事実を区別します：名前の信頼性、通学しているキャンパスが確認されているかどうか、代表的な座標が既知かどうか。既知の学校の中心は、歴史的なキャンパスを確立するものではありません。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、ワーカー、3Dエンジンが失敗した場合の独立したフォールバックとして、組み込みのLeaflet 2Dレンダラーを保持します。モバイルレンダリングコストを制限し、スロースタート/コンテキストロスから自動的に回復し、初期化成功後に古いエラーのオーバーレイをクリアします。機能ベースのポリシーとXiaomi関連の証拠の限界については、compatibility.mdを参照してください。
結果を検証する
焦点を絞ったチェックについては、verification.mdを参照してください：ファイルをオフラインで開く、県/人物の計上、nullの場所、ラベル、状態変更、電話コントロール、タッチジェスチャー。学校のストリート詳細はオプションのオンラインレイヤーです。その依存関係をオフラインマップ機能と区別してください。
レンダリングされた結果を検査し、実際に実行されたチェックを報告してください。データ編集については、表示された名前とエクスポートされたJSONがユーザーの修正と一致することを確認してください。未知の情報を保持し、不足しているキャンパス/住所の詳細の短いリストをユーザーに提供してください。
実際のソースがない場合は、サポートされている分析を説明し、必要に応じて明示的に架空の例を使用してください。対応する入力なしに、TXT/Excel解析、名簿、または実際のコホートが検証されたと決して主張しないでください。
ワークフローを公開する場合
再利用可能なスキルの公開は、クラス名簿を公開する許可を意味するものではありません。合成データを使用した新しい許可リスト付きの公開パッケージを使用し、サードパーティの通知を保持し、ファイルとGit履歴にプライベートな入力がないか検査してください。公開が要求された場合は、publishing.mdを参照してください。公開にはユーザーの承認が必要です。通常のマップ作成は公開リポジトリを承認するものではありません。
メンテナンス: ソースの読み取りと調整のガイダンスはリンクされたリファレンスにあります。スクリプトはオプションのアセンブリ支援ツールのままです。スクリプトファーストまたは画像のみのエントリポイントを復元しないでください。