RetexPDF

RetexPDF は何をしますか？

通常のリクエストは次の通りです：入力PDF → 完全翻訳 → 汎用arXivスタイルLaTeX → コンパイルされたPDF。この作業を、レイアウト分類と翻訳を含めて行ってください。ユーザーが著者のTeXを見つけたり、LaTeXを使ったり、翻訳APIを設定したり、スクリプトを実行したりする必要はありません。エージェントが翻訳し、スクリプトが永続化、アセンブル、コンパイルを行います。提供されたPDFが信頼できる版です。

環境の自動準備

Windows:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill>/scripts/bootstrap.ps1" -WithPdf

macOS:

bash "<skill>/scripts/bootstrap.sh" ensure --with-pdf

返されたJSON内の絶対パスのpython実行可能ファイルを使用してください。status: readyが必要です。Bootstrapはまず動作するプライベート環境と互換性のあるインストール済みPythonを再利用し、互換性のあるPythonがない場合にのみダウンロードします。明示的に指定された-PythonPath/--pythonが優先されます。管理対象のPDF環境は64ビットPython 3.10～3.14をサポートし、プライベート環境に固定バージョンのPyMuPDFをインストールし、Tectonicを検出またはインストールします。システムのPython、PATH、シェルプロファイル、レジストリを変更しないでください。完全なTeXディストリビューションをインストールしないでください。%LOCALAPPDATA%/RetexPDFまたは~/Library/Caches/RetexPDFの既存のキャッシュを使用してください。

初回使用時は、不足している依存関係、パッケージ、フォントのためにネットワークアクセスが必要です。通常の初回使用で-Offline/--offlineを渡さないでください。Doctorは読み取り専用です。オフラインはダウンロードを明示的に禁止します。macOSのエントリポイントは存在しますが、ネイティブMacでの検証が必要です。環境障害時は具体的なログを保持し、可能な限り修復してください。ユーザーに手動でのLaTeXインストールを促さないでください。

入力経路の選択

• PDFが提供された場合：PDFワークフロー、scripts/pdf_translate.py、assets/arxiv-paper.texを使用します。著者のTeXを探したり、再構築した抜粋を凍結したりしないでください。著者ソースは前提条件ではありません。エージェントはレンダリングされたPDFを分類し、完全な翻訳台帳を埋める必要があります。
• 既存のTeXプロジェクトが提供された場合：ソース台帳とscripts/translation_ledger.pyを使用します。元のTeX数式はそのまま保持できます。ユーザーが汎用テンプレートを要求しない限り、提供されたクラスを保持してください。
• **論文リンク/IDが提供された場合：**要求された正確なPDFを入手します。一致するソースは任意です。決して異なる版を無言で代用しないでください。

ユーザーが要求したターゲット言語とロケールを使用します。会話から確立されたターゲットを推測し、本当に未指定の場合のみ尋ねてください。中国語は固定ターゲットではありません。要求された書記体系に適したフォントと言語サポートを選択してください。

譲れないコンテンツルール

1. 論文全体を翻訳します。これにはすべての段落、見出し、キャプション、通常の脚注、謝辞、アルゴリズム、証明、付録が含まれます。効果を見るためのリクエストでも、サンプルが明示的に要求されない限り論文全体を意味します。決して要約したり、導出を短縮したり、省略された内容の説明でセクションを置き換えたりしないでください。
2. 著者ブロック全体を正確に保持します：名前、順序、所属テキスト、上付き文字、貢献/連絡先メモ、メールアドレス。参考文献エントリと番号を保持します。データ、識別子、数式ラベルを保持します。図表のアートワークと値を保持し、キャプションは翻訳します。ユーザーがアートワーク/表内のテキストの翻訳を要求した場合は、無言で翻訳済みとして扱うのではなく、別のマッピングされたテキストレイヤーワークフローを追加します。
3. インライン数式はそれぞれの文中に保持します。すべての表示数式、複数行の導出、記号を保持します。PDF入力の場合は、数式/図/表領域をベクターPDFクリップとしてコピーします。分数、根号、アクセント、式番号を含みます。決して画像生成で数学を再描画しないでください。信頼性の低い抽出文字順序から数式を再構築しないでください。
4. ソースの順序を保持します。ページをまたがって分割された文は翻訳前に結合します。図表キャプションはオブジェクトと一緒に、アルゴリズムはページに収まる場合はまとめて保持します。汎用テンプレートを使用してテキストをリフローします。元の座標やページ数は、明示的に要求されない限り必須ではありません。
5. 論文内に翻訳者の序文、読解手順、省略の注釈、要約、新しいコンテンツを追加しないでください。技術的なレポートはPDFの外部に属します。
6. アセンブル前に、オリジナル、完全な目録、各翻訳を永続化します。各ソース単位には、翻訳または明示的に正当な保持アセットが必要です。未完成の翻訳を隠すために未変更散文フォールバックを使用しないでください。コンテキスト制限があるため、保留中の単位は保存して再開し、省略しないでください。
7. グリフ目録は抽出されたグリフの機械的なカバレッジのみを証明します。レンダリングされたソースページと目録を比較して、図面、スキャンされたテキスト、マルチカラム読み取り順序、破損した抽出を検出します。各翻訳単位を完全なソースと比較します。reviewedフラグは実際の作業を記録します。ビルドを通過させるための近道ではありません。

PDFの実行

コマンドとJSON形式の詳細なリファレンスに従ってください。

1. extract：元のPDF、すべてのページ、グリフ、フォント、位置を正確に保持します。
2. ページレンダリングを検査し、layout.jsonで著者ブロック、図、表、キャプション、表示数式を分類します。インライン数式のセグメンテーションと結合を修正します。表示内容を目録と比較した後にのみ、ページをレビュー済みとマークします。ネイティブテキストのないグラフィカルコンテンツを含めます。
3. prepare --target-language ...：翻訳IDを割り当て、レイアウト、散文、ベクターフラグメントを凍結します。すべてのネイティブグリフは正確に一度だけ計上されなければなりません。
4. pending：コンテキスト付きで完全な単位を読み取ります。バッチで翻訳し、実際のソース比較後にのみput --file ... --reviewedで保存します。数式プレースホルダーは完全で順序付けられたままである必要があります。一貫した用語集を使用してください。
5. build --output <new-project>：新しいmain.texとfragments.pdfをアセンブルし、自動的にコンパイルします。欠落した翻訳、変更されたソース/レイアウト、欠落した数式トークン、未レビューの単位/ページがあるとビルドが停止します。未完了の翻訳に対してこれらのチェックをバイパスするためにコンパイラだけを使用しないでください。
6. 実際にコンパイルされたPDFをレンダリングして検査します。クリッピング、重なり、不良グリフ、切り離されたキャプション、壊れたインライン数式を修復します。すべてのソースページとセクション（最後の付録を含む）に対応する出力コンテンツがあることを確認します。作業が完了した後にのみ納品します。

レイアウトを変更するには、再度prepareが必要です。翻訳IDは変更される可能性があります。凍結されたソースハッシュとページによって古い行を調整し、マッピングを確認してください。決して古いIDキーの行を盲目的にコピーしたり、変更されたコンテンツを承認するためにハッシュを再計算したりしないでください。

スキャンや壊れたテキスト抽出の場合は、翻訳前に永続化された目録にOCR/視覚的文字起こしを追加します。このスクリプトのネイティブ抽出器はOCRエンジンではなく、画像のみのページを空として扱ってはいけません。ブロックがまだ読み取れない場合でも、復旧を続けてください。無言で省略したり、完全な出力と主張したりしないでください。

フォント、コンパイル、納品

バンドルされたテンプレートは、独自の公式arXivテンプレートではなく、arXivスタイルの出力に適した汎用の1カラム学術論文テンプレートです。中国語はデフォルトでFandol付きのctexを使用します。他のスクリプトは正しいフォント/言語パッケージを含む--language-setupを提供できます。代表的な見出し、段落、数式でカバレッジ、シェイピング、方向を確認してください。ターゲット言語パラメータだけではフォントが設定されていることの証明として扱わないでください。

Tectonicは不足しているパッケージ/フォントを自動的にダウンロードします。生成された作業コピーまたはジェネレーターのコンパイラエラーを修復し、決してコンテンツを削除して修復しないでください。failedは納品可能な状態ではありません。review_requiredはPDFが存在するが、警告の解決が必要であることを意味します。compiledはコンパイルのみを確認し、意味的または視覚的な完全性を確認するものではありません。ソースのみのコンパイルリクエストの場合は、retex.ps1 -Action Compileまたはretex.sh compileを直接使用してください。シェルエスケープは無効のままにしてください。

ジョブ/中間ファイルはRetexPDFジョブキャッシュまたはユーザー指定の作業ディレクトリに保持します。完全な翻訳済みPDFと編集可能なアセンブルプロジェクトを納品し、トレーサビリティのために元のスナップショット、レイアウト、翻訳台帳、カバレッジレポートを保持します。論文のデータや翻訳をインストール済みスキルにバンドルしないでください。論文外に具体的な残存制限を開示します。該当する場合は、図/表内の保存された元の言語ラベルを含めます。機械的なチェックが、あらゆるPDFに対して完全な意味翻訳を保証するものではないと決して約束しないでください。