楽譜PDF → 編集可能スコア

ユーザーがPDFのスコアを持っていて、それを編集できる形にしたいと考えています。このPDFを読み取る最良の方法を見つけ、それを実行し、ファイルと確認すべき点についての正直なメモを返してください。ユーザーはPDFやOMR、コマンドラインについて何も知らないものと想定してください。ユーザーははい・いいえの質問に答え、あなたが残りの作業を平易な言葉で行います。各手順を、ユーザーのファイルと選択肢に基づいて説明してください。このスキル、そのルール、ファイル名についての説明は、ホストが要求しない限り行わないでください。

1. まずPDFを確認する

何かを選択する前に、各ファイルに対してバンドルされた識別ツール（このスキルの scripts/ フォルダ内、Node.js 22+）を実行します：

node scripts/identify.mjs <file.pdf> --json

これにより、PDFの種類（音楽フォントを含むベクター、スキャン/画像、アウトライン化、混合、不明、読み取り不可）がページごとの証拠とともに報告され、どの記譜ソフトが作成した可能性が高いか、およびTuttiで読み取れる可能性があるかが示されます。references/routes.md に各結果の説明があります。このツールはフォント、メタデータ、画像のみを調べ、音楽の複雑さは調べません。また、そのルールはTuttiウェブサイトよりも古い可能性があります。Tuttiの判定は参考意見として扱い、拒否条件としては扱わないでください。

2. ルートを選ぶ

カバーページや説明ページではなく、音楽が含まれているページに基づいて判断します。

Tuttiで読み取れる可能性が高い場合（記譜ソフトから出力されたもの）：Tuttiを強く推奨します。Tuttiはピクセルから推測する代わりに、プログラムが書き込んだ記譜をそのまま読み取るため、通常OMRよりもはるかに正確です。「これにはTuttiのプライバシーポリシー（https://tutti-studio.com/privacy）に同意する必要があります。よろしいですか？」と尋ねます。同意する場合は、`references/tutti.md` のTuttiリンクを開いてアップロードしてもらいます。アップロードしたくない場合は、Audiverisを提案し、この種類のPDFでは通常精度が低くなることを伝えます。
音楽ページがベクターだが、Tuttiが「不明」または「可能性が低い」の場合：両方を提案し、まずTuttiウェブサイトで確認することを勧めます。サイトがアップロード時に判断するためです。
音楽ページがスキャンまたは写真の場合（OCRテキストレイヤーがあるスキャンは mixed と表示されます）、またはアウトライン化された音楽の場合：このコンピュータ上のAudiveris（references/audiveris.md）を使用します。
手書きの場合：Audiverisは手書き用には作られておらず、このスキルではテストされていません。手動で入力し直すことを提案します。ソフトウェアを試したい場合は、references/omr-tools.md を参照してください。ただし、保証はできません。
読み取り不可、暗号化、PDFではない場合：何が問題で、何ができるかを説明します。

Audiverisは完成したスコアではなく、修正用のドラフトを出力します。クリーンなスキャン（ソロ、ピアノ、小編成の室内楽、簡単な合唱）で最も効果を発揮します。スマートフォンの写真は多くの場合まったく失敗します。大規模なオーケストラスコアや密度の高いスキャンの場合は、実行する前にその旨を伝え、ユーザーに判断を委ねます。

3. 正直に結果を返す

Audiverisの実行後、結果を確認してから何かを伝え、次に node scripts/review.mjs <result.mxl> <original.pdf> --out-dir <new folder> を実行します（.omr と .log は結果の隣に保持します）。これにより、疑わしい小節を赤色でマークしたMusicXMLのコピー、該当箇所を枠で囲んだ元のPDFのコピー、およびJSONサマリーが出力されます。最初の2つをユーザーに渡します。赤色のマークはAudiveris自身が問題を検出した場所のみです。テストでは、誤った音符を含むほとんどの小節がマーク されていなかった ため、残りも確認が必要であることを明確に伝えます。次に、以下の点を別々に伝えます：

どのページまたは楽章がエクスポートされ、どれがされなかったか；
疑わしい場所（PDFページごと、およびレビューがページと小節をマッチングできた場合は小節ごと）；
音符がPDFと照合 されていない こと、および確認を開始すべき場所：赤色の小節、次に調号と拍子記号、その他すべて（特に臨時記号と歌詞）。

OMRの結果を「正しい」または「完成した」と呼んではいけません。その後、ファイルの開き方（references/open-in-editor.md）を伝えます。

避けるべきこと

以下は一見妥当に見えますが、ユーザーに最も大きな損害を与える間違いです：

自分で音楽を読み取ること。 ページ画像を見てMusicXMLを書いたり、見た音符を説明したりしないでください。モデルによる記譜の書き起こしは、ピッチとリズムを自信満々にでっち上げます。これはOMRよりも劣り、ユーザーが問題を発見するのがはるかに困難です。
エクスポートされたPDFをOMRに送ること。 ユーザーはしばしばあらゆるPDFを「スキャン」と呼びます。識別ツールが音楽フォントを検出した場合、OMRは正確なデータを捨ててしまいます。Tuttiにルーティングしてください。
IMSLPのスキャンをベクターとして扱うこと。 IMSLPのスキャンには多くの場合OCRテキストレイヤーが含まれています。ページ全体の画像とテキストフォントがあり、音楽フォントがない場合はスキャンです。
OCR言語データなしでAudiverisを実行すること、またはレガシーファイルの代わりに tessdata_fast / tessdata_best を使用すること。実行自体は「成功」しますが、すべての歌詞、テンポ表記、楽器名が黙って消えます。
音楽のないページを渡すこと。 カバー、タイトル、テキストページが1枚でもあると、実行全体が失敗してエクスポートされない可能性があります。音楽ページのみを渡してください。
終了コード0または「エクスポート完了」のログ行を信頼すること。 ファイルは、一部から小節が欠落したり、五線が余分なパートに分割されたり、単一の断片（*.mvtnull.mxl）だけが残ったりすることがあります。何かが機能したと言う前に、パートごとの小節数を数えてください。
Audiverisのログラベルを小節番号と誤認すること。 Measure{#11P2} は内部ラベルであり、「2番目の楽器の11小節目」ではありません。ページに対して位置を特定するか、「Nページ付近」と言ってください。
ひどい写真を救おうとすること。 画像ツールをインストールしたり、拡大したり、オンラインサービスにアップロードしたりしないでください。1回実行し、失敗した場合は、再撮影のアドバイス（平らなページ、均一な照明、真上からの撮影、またはスキャナーの使用）をするか、references/omr-tools.md の写真ツールを紹介してください。
出力を上書きまたは混在させること。 入力ごとに1つの出力フォルダを使用し、ユーザーの元のファイルの隣や上に書き込まないでください。
Tuttiが何をするか約束すること。 あなたは代わりにアップロードできません。無料ページ数と制限はサイトに表示されています。数値を引用しないでください。

複数ファイル

すべてのファイルを最初に識別し、ルートごとにグループ化し、1つの計画を確認します（「3つはTuttiへ、2つはあなたのコンピュータで読み取ります」）。

例

「これをMuseScoreに変換して」 （Sibeliusから出力された四重奏）→ ベクター、Sibelius、可能性が高い → Tuttiを推奨し、プライバシーポリシーについて尋ね、サイトを開く；ローカルオプションにも言及。
「これを編集可能にできますか？」 （IMSLPからのスキャンされた曲、mixed：画像＋OCRテキストと表示）→ スキャンとして扱う → ドイツ語と英語の言語データでAudiverisを実行、タイトルページをスキップ → レビューマーク → エクスポートされたページ、赤色の小節、確認すべき点を報告。
合唱パートのぼやけた曲がったスマートフォン写真 → 1回Audiverisを実行 → ほとんどが読み取れない場合、追加のツールではなく再撮影のアドバイスをする。

楽譜PDF→編集可能スコア