RetexPDF

Was macht RetexPDF?

Die normale Anfrage lautet: Eingabe-PDF → vollständige Übersetzung → generische arXiv-ähnliche LaTeX-Vorlage → kompiliertes PDF. Führen Sie diese Arbeit durch, einschließlich Layout-Klassifizierung und Übersetzung. Verlangen Sie nicht vom Benutzer, das Autoren-TeX zu finden, LaTeX zu verwenden, eine Übersetzungs-API zu konfigurieren oder Skripte auszuführen. Der Agent übersetzt; die Skripte persistieren, setzen zusammen und kompilieren. Das bereitgestellte PDF ist die maßgebliche Ausgabe.

Umgebung automatisch vorbereiten

Windows:

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

macOS:

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

Verwenden Sie das absolute python-Programm im zurückgegebenen JSON. Fordern Sie status: ready. Bootstrap verwendet zuerst eine funktionierende private Umgebung und eine kompatible installierte Python-Version; lädt Python nur herunter, wenn keine kompatible Version vorhanden ist. Ein explizit angegebener -PythonPath / --python hat Vorrang. Die verwaltete PDF-Umgebung unterstützt 64-Bit Python 3.10–3.14. Sie installiert PyMuPDF in einer privaten Umgebung und erkennt oder installiert Tectonic. Ändern Sie nicht das systemweite Python, PATH, Shell-Profile oder die Registrierung. Installieren Sie keine vollständige TeX-Distribution. Verwenden Sie den vorhandenen Cache unter %LOCALAPPDATA%/RetexPDF oder ~/Library/Caches/RetexPDF.

Die erste Verwendung benötigt Netzwerkzugriff für fehlende Abhängigkeiten, Pakete und Schriftarten. Übergeben Sie nicht -Offline / --offline bei einer normalen ersten Verwendung. Doctor ist schreibgeschützt; offline verbietet ausdrücklich Downloads. macOS-Einstiegspunkte existieren, benötigen aber noch native Mac-Validierung. Bewahren Sie konkrete Logs bei einem Umgebungsfehler auf und reparieren Sie ihn, wo möglich; senden Sie Benutzer nicht zur manuellen LaTeX-Installation.

Eingabe-Route auswählen

• PDF bereitgestellt: Verwenden Sie den PDF-Workflow, scripts/pdf_translate.py und assets/arxiv-paper.tex. Lenken Sie nicht um in die Suche nach Autoren-TeX oder das Einfrieren einer rekonstruierten Teilmenge. Der Quellcode des Autors ist keine Voraussetzung. Der Agent muss das gerenderte PDF klassifizieren und das vollständige Übersetzungsverzeichnis ausfüllen.
• Bestehendes TeX-Projekt bereitgestellt: Verwenden Sie das Quellverzeichnis und scripts/translation_ledger.py. Ursprüngliche TeX-Mathematik kann direkt beibehalten werden. Bewahren Sie die bereitgestellte Klasse, es sei denn, der Benutzer fordert die generische Vorlage an.
• Papier-Link/ID bereitgestellt: Besorgen Sie das exakt angeforderte PDF. Passende Quellen sind optional; ersetzen Sie niemals stillschweigend eine andere Ausgabe.

Verwenden Sie die vom Benutzer angeforderte Zielsprache und das Gebietsschema. Leiten Sie eine etablierte Zielsprache aus dem Gespräch ab; fragen Sie nur, wenn sie wirklich nicht angegeben ist. Chinesisch ist keine festgelegte Zielsprache. Wählen Sie Schriftarten und Sprachunterstützung für das angeforderte Schriftsystem.

Unverhandelbare Inhaltregeln

1. Übersetzen Sie das gesamte Papier, einschließlich aller Absätze, Überschriften, Bildunterschriften, gewöhnlicher Fußnoten, Danksagungen, Algorithmen, Beweise und Anhänge. Eine Anfrage, den Effekt zu sehen, bedeutet dennoch das gesamte Papier, es sei denn, ein Beispiel wird ausdrücklich angefordert. Fassen Sie niemals zusammen, kürzen Sie eine Herleitung oder ersetzen Sie einen Abschnitt durch eine Erklärung dessen, was weggelassen wurde.
2. Bewahren Sie den gesamten Autorenblock genau so: Namen, Reihenfolge, Zugehörigkeitstext, hochgestellte Zeichen, Beitrags-/Korrespondenzhinweise und E-Mails. Bewahren Sie Bibliographie-Einträge und Nummerierung. Bewahren Sie Daten, Identifikatoren und Formelbezeichnungen. Bewahren Sie Abbildungs-/Tabellen-Kunstwerke und Werte; übersetzen Sie Bildunterschriften. Wenn der Benutzer die Übersetzung von Text in Kunstwerken/Tabellen anfordert, fügen Sie einen separaten, zugeordneten Text-Layer-Workflow hinzu, anstatt ihn stillschweigend als übersetzt zu behandeln.
3. Belassen Sie jede Inline-Formel in ihrem Satz. Bewahren Sie jede dargestellte Formel, mehrzeilige Herleitung und jedes Symbol. Für PDF-Eingabe kopieren Sie Formel-/Abbildungs-/Tabellenbereiche als Vektor-PDF-Clips, einschließlich Brüchen, Wurzeln, Akzenten und Gleichungsnummern. Zeichnen Sie Mathematik niemals mit Bildgenerierung neu. Rekonstruieren Sie keine Formel aus einer unzuverlässigen extrahierten Zeichenreihenfolge.
4. Behalten Sie die Quellreihenfolge bei. Fügen Sie Sätze, die über Seiten verteilt sind, vor dem Übersetzen zusammen. Halten Sie Bildunterschriften von Abbildungen/Tabellen bei ihren Objekten und Algorithmen zusammen, wenn sie auf eine Seite passen. Verwenden Sie die generische Vorlage, um Text umzubrechen; ursprüngliche Koordinaten und ursprüngliche Seitenzahl sind keine Anforderung, es sei denn, sie werden ausdrücklich angefordert.
5. Fügen Sie keine Übersetzervorrede, Lesehinweise, Auslassungshinweise, Zusammenfassungen oder neuen Inhalt innerhalb des Papiers hinzu. Technische Berichte gehören außerhalb des PDFs.
6. Persistieren Sie das Original, das vollständige Inventar und jede Übersetzung vor der Zusammenstellung. Jede Quell-Einheit muss eine Übersetzung oder einen explizit legitimierten bewahrten Vermögenswert haben. Verwenden Sie niemals einen unveränderten-Prosa-Fallback, um unvollständige Übersetzungen zu verbergen. Kontextbeschränkungen bedeuten, dass ausstehende Einheiten gespeichert und fortgesetzt werden, nicht ausgelassen.
7. Ein Glyphen-Inventar beweist nur die mechanische Abdeckung extrahierter Glyphen. Vergleichen Sie die gerenderten Quellseiten mit dem Inventar, um Zeichnungen, gescannten Text, mehrspaltige Lesereihenfolge und beschädigte Extraktion zu erkennen. Vergleichen Sie jede übersetzte Einheit mit ihrer vollständigen Quelle. Ein reviewed-Flag dokumentiert tatsächliche Arbeit; es ist keine Abkürzung, um einen Build zu passieren.

PDF-Ausführung

Folgen Sie der detaillierten Referenz für Befehls- und JSON-Formate:

1. extract: Bewahren Sie das exakte Original-PDF, alle Seiten, Glyphen, Schriftarten und Positionen.
2. Untersuchen Sie Seiten-Renderings; klassifizieren Sie Autorenblöcke, Abbildungen, Tabellen, Bildunterschriften und dargestellte Mathematik in layout.json. Korrigieren Sie Inline-Mathematik-Segmentierung und -Zusammenführungen. Markieren Sie Seiten als überprüft, erst nachdem Sie ihre sichtbaren Inhalte mit dem Inventar verglichen haben. Fügen Sie alle grafischen Inhalte ohne nativen Text ein.
3. prepare --target-language ...: Weisen Sie Übersetzungs-IDs zu und frieren Sie das Layout, die Prosa und Vektorfragmente ein. Jedes native Glyph muss genau einmal berücksichtigt werden.
4. pending: Lesen Sie vollständige Einheiten mit ihrem Kontext. Übersetzen Sie in Chargen und speichern Sie mit put --file ... --reviewed erst nach tatsächlichem Quellvergleich. Mathematik-Platzhalter müssen vollständig und geordnet bleiben. Verwenden Sie ein konsistentes Glossar.
5. build --output <new-project>: Setzen Sie eine neue main.tex und fragments.pdf zusammen und kompilieren Sie dann automatisch. Fehlende Übersetzungen, geänderte Quelle/Layout, fehlende Formel-Token oder nicht überprüfte Einheiten/Seiten stoppen den Build. Verwenden Sie niemals den Compiler allein, um diese Prüfungen für eine unvollständige Übersetzung zu umgehen.
6. Rendern und überprüfen Sie das tatsächliche kompilierte PDF. Reparieren Sie Clipping, Überlappungen, schlechte Glyphen, losgelöste Bildunterschriften und beschädigte Inline-Formeln. Verifizieren Sie, dass jede Quellseite und jeder Abschnitt, einschließlich des letzten Anhangs, entsprechende Ausgabeinhalte hat. Liefern Sie nur aus, nachdem die Arbeit abgeschlossen ist.

Eine Layout-Änderung erfordert erneut prepare. Übersetzungs-IDs können sich ändern: Gleichen Sie alte Zeilen durch den eingefrorenen Quell-Hash und die Seite ab und überprüfen Sie die Zuordnung. Kopieren Sie niemals blind alte ID-basierte Zeilen oder berechnen Sie Hashes neu, um geänderte Inhalte zu genehmigen.

Fügen Sie für Scans oder beschädigte Textextraktion OCR/visuelle Transkription zum persistierten Inventar hinzu, bevor Sie übersetzen. Der native Extraktor dieses Skripts ist keine OCR-Engine und darf bildbasierte Seiten nicht als leer behandeln. Wenn ein Block noch nicht gelesen werden kann, fahren Sie mit der Wiederherstellung fort; lassen Sie ihn nicht stillschweigend aus oder behaupten eine vollständige Ausgabe.

Schriftarten, Kompilierung und Auslieferung

Die gebündelte Vorlage ist ein generischer einspaltiger wissenschaftlicher Artikel, der für die arXiv-ähnliche Ausgabe geeignet ist, nicht eine einzigartige offizielle arXiv-Vorlage. Chinesisch verwendet standardmäßig ctex mit Fandol. Andere Schriftsysteme können --language-setup mit den korrekten Schrift-/Sprachpaketen bereitstellen; bestätigen Sie Abdeckung, Formgebung und Ausrichtung mit einer repräsentativen Überschrift, einem Absatz und einer Formel. Behandeln Sie den Zielsprachenparameter nicht allein als Nachweis dafür, dass Schriftarten konfiguriert sind.

Tectonic lädt fehlende Pakete/Schriftarten automatisch herunter. Reparieren Sie Compiler-Fehler in der generierten Arbeitskopie oder im Generator, niemals durch Löschen von Inhalten. failed ist kein auslieferbares Ergebnis; review_required bedeutet, dass ein PDF existiert, aber seine Warnungen müssen gelöst werden. compiled bestätigt nur die Kompilierung, nicht die semantische oder visuelle Vollständigkeit. Verwenden Sie für reine Quell-Kompilierungsanfragen direkt retex.ps1 -Action Compile oder retex.sh compile. Shell-Escape bleibt deaktiviert.

Behalten Sie Job-/Zwischendateien im RetexPDF-Job-Cache oder einem benutzerdesignierten Arbeitsverzeichnis. Liefern Sie das vollständige übersetzte PDF und das editierbare zusammengestellte Projekt; bewahren Sie die ursprüngliche Momentaufnahme, das Layout, das Übersetzungsverzeichnis und den Abdeckungsbericht zur Nachverfolgung auf. Bündeln Sie die Papierdaten oder die Übersetzung nicht in den installierten Skill. Offenlegen Sie konkrete verbleibende Einschränkungen außerhalb des Papiers, einschließlich erhaltener originalsprachlicher Bezeichnungen in Abbildungen/Tabellen, wo zutreffend. Versprechen Sie niemals, dass mechanische Prüfungen eine perfekte semantische Übersetzung für jedes mögliche PDF garantieren.