ZUFE-Thesis-Typesetter (浙江财经大学论文排版)

ZUFE Thesis Typesetter (Bachelorarbeit & Praktikumsbericht Formatierer)

Übersicht

Mit diesem Skill können Sie Ihre Word-Abschlussarbeit oder Ihren Praktikumsbericht automatisch in ein ZUFE-Thesis-konformes LaTeX/PDF-Ergebnis umwandeln. Der Ablauf folgt streng drei Phasen:

• Phase A: Strikte Vorprüfung und intelligente Vorbereitung.
• Phase B: Formelle Extraktion des DOCX, Anlegen eines Inhaltsbuchs, semantische Bestätigung und Befüllen der LaTeX-Vorlage.
• Phase C: Kompilierung, Diagnose, Qualitätskontrolle und Übergabeabschluss.

Die hauptsächliche Rückmeldung an nicht-technische Benutzer muss im Chat erfolgen. Die Skripte übernehmen die stabilen Prüf-, Extraktions-, Datei-Schreib-, Kompilierungs- und maschinenlesbaren Prüfberichtsfunktionen.

Kernvereinbarungen

Das Skript muss aus dem Stammverzeichnis der ZUFE-Thesis-Vorlage ausgeführt werden. Vor dem Ändern einer Datei muss die Signatur der Vorlage überprüft werden.

Falls der Benutzer noch kein Vorlagenprojekt erstellt hat, muss zunächst erklärt werden, dass dieser Skill die originale ZUFE-Thesis-LaTeX-Vorlage benötigt. Die Schritte sind in folgender Reihenfolge abzuarbeiten:

1. Standardmäßig den Benutzer zum GitHub-Repository der Originalvorlage führen: https://github.com/sqsssq/ZUFE-Thesis.
2. Falls GitHub aufgrund von Netzwerkbeschränkungen nicht erreichbar ist, nach Benutzerbestätigung einen nationalen Spiegel-Link verwenden: https://gitee.com/cwf818/ZUFE-Thesis.
3. Sind weder GitHub noch Gitee erreichbar, die Konvertierung abbrechen und den Benutzer auffordern, ein komprimiertes Vorlagenpaket, das vollständig entpackte Vorlagenverzeichnis oder eine andere vertrauenswürdige Bezugsquelle bereitzustellen.

Der KI-Assistent darf nach Benutzerbestätigung beim Herunterladen, Entpacken oder Wechseln in das Vorlagenstammverzeichnis helfen. Er darf die Vorlagenvorbereitung jedoch nicht stillschweigend überspringen und die Konvertierung nicht in einem leeren Verzeichnis, im Repository dieses Skills oder in einem Verzeichnis ohne die Vorlagensignatur fortsetzen.

Standardeingaben:

workspace/input/thesis.docx
workspace/input/metadata.yaml

Standard-Zwischenprodukte:

workspace/intermediate/thesis.json
workspace/intermediate/extracted.md

Standardausgaben:

main.pdf
workspace/output/report.md
workspace/output/qa_report.md

Reihenfolge der Phasen

Die Phasen müssen strikt nacheinander ausgeführt werden. Überspringen Sie keine Phase, nur weil ein späteres Skript den Fehler möglicherweise beheben könnte.

1. Phase A: Prüfung der Vorlage, des workspace, des DOCX, der Metadaten, alter Ausgaben, der Python-DOCX-Umgebung sowie der LaTeX-/Biber-Umgebung.
2. Phase B: Jedes sichtbare oder extrahierbare Textfragment aus Word wird in thesis.json geschrieben. Der KI-Assistent weist die semantischen Kategorien zu und bestätigt unsichere Inhalte mit dem Benutzer. Das Skript rendert nur die bestätigten Zuordnungen.
3. Phase C: Alte Kompilierungsergebnisse archivieren, xelatex -> biber -> xelatex -> xelatex ausführen, Fehlschläge diagnostizieren, begrenzte mechanische Reparaturen durchführen und das neue PDF einer Qualitätskontrolle unterziehen.

Skriptverwendung

Alle Skripte akzeptieren --root und geben JSON aus oder schreiben JSON-Berichte. Der KI-Assistent trifft Entscheidungen auf Basis des JSON und übersetzt das Ergebnis dann für den Benutzer in eine kurze, verständliche Liste.

• scripts/check_template.py: Prüft die Signatur der ZUFE-Thesis-Vorlage.
• scripts/prepare_workspace.py: Erstellt workspace/, legt das DOCX im Standardpfad ab und kann nach Benutzerfreigabe alte Ausgaben archivieren.
• scripts/check_env.py: Prüft Python, python-docx, xelatex, biber und wichtige TeX-Pakete der Vorlage.
• scripts/prescan_docx.py: Leichte Vorabprüfung des DOCX und extrahiert Kandidaten für Metadaten (Phase A). Erzeugt kein formales thesis.json.
• scripts/import_docx.py: Formelle Extraktion in Phase B, erzeugt thesis.json und extracted.md.
• scripts/export_assets.py: Extrahiert Medien aus dem DOCX in Images/word_media/ und erstellt ein Protokoll.
• scripts/render_basicinfo.py: Schreibt Metadaten, Zusammenfassung und Schlüsselwörter in chapters/basicinfo.tex.
• scripts/render_chapters.py: Schreibt die bestätigten Kapitelzuordnungen in chapters/*.tex und chapters/mainbody.tex.
• scripts/render_bib.py: Schreibt die bestätigte BibTeX-Datei als Reference.bib. Keine erfundenen Referenzen.
• scripts/check_flow_b_gate.py: Verhindert den Abschluss von Phase B, falls noch unbearbeitete, unbestätigte oder nicht gerenderte Quellblöcke vorhanden sind.
• scripts/build.py: Archiviert alte main.pdf, bereinigt temporäre Kompilierungsdateien und führt die festgelegte Kompilierungskette aus.
• scripts/diagnose_build.py: Klassifiziert Kompilierungsfehler als handlungsrelevante Probleme.
• scripts/qa.py: Prüft Aktualität des PDF, Text, kritische Signale, unaufgelöste Referenzen, BibTeX-/Zitierungs-Closed-Loop, Vorlagenreste und Platzhalter.

Verantwortlichkeiten des KI-Assistenten

Der KI-Assistent ist für die semantische Beurteilung zuständig; Skripte dürfen diese nicht ersetzen:

• Entscheiden, ob ein Absatz zu einer Kapitelüberschrift, zum Fließtext, zur Zusammenfassung, zu Referenzen, zur Danksagung, zum Anhang, zu einer Abbildungs-/Tabellenbeschriftung oder zu verwerflichem Rauschen gehört.
• Probleme mit niedriger Konfidenz zusammenfassen und mit dem Benutzer klären.
• Im Chat erklären, an welcher Stelle der Prozess stockt und warum, und den nächsten Schritt vorschlagen.
• Inhalte weder stillschweigend verwerfen noch falsch zuordnen.
• Institution, Studienfach, Datum, Betreuer oder Berichtstyp nicht aus dem Dateinamen erraten; Metadaten dürfen nur aus dem Word-Dokument oder der Benutzerbestätigung stammen.
• Run-Level-Formatierungsprobleme (wie hochgestellt, tiefgestellt, abweichende Schriftgröße in Tabellen) nicht als normale Textprobleme ignorieren; diese müssen in Phase B/C offengelegt werden.
• Phase C korrigiert keine Dokumentensemantik; Zuordnungsfehler müssen an Phase B zurückgegeben werden.

Harte Qualitätsauflagen bei der Konvertierung

• DOCX-Absätze dürfen nicht nur auf reinen Text reduziert werden; Run-Level-Informationen wie fett, kursiv, hochgestellt, tiefgestellt und Schriftgrößen müssen erhalten bleiben. Hochgestellte Zahlen müssen als \textsuperscript{...} gerendert werden, nicht als normale Fließtextzahlen.
• Als Referenzmarkierungen identifizierbare hochgestellte Zahlen im Word-Dokument dürfen nicht stillschweigend in normalen Text umgewandelt werden. Sollen sie in formale \cite/\supercite umgewandelt werden, muss zuerst die Referenzzuordnung bestätigt sein; andernfalls muss mindestens der visuelle Hochstellungseffekt erhalten bleiben.
• Handschriftliche Abbildungs-/Tabellennummern wie 图2.1, 图 2.1, 表1.2 im Fließtext von Word dürfen nicht unverändert in den endgültigen Kapitel-Quelltext übernommen werden. Der KI-Assistent muss den zugehörigen Abbildungs-/Tabellenblock identifizieren, einen stabilen label vergeben und die Fließtextstelle in Abbildung~\ref{...} oder Tabelle~\ref{...} umschreiben; kann die Zuordnung nicht bestätigt werden, wird Phase B blockiert.
• ASCII-Doppelpfütchen im normalen Fließtext müssen in LaTeX-Links-/Rechtspfütchen ``...'' umgewandelt werden. Chinesische intelligente Anführungszeichen bleiben standardmäßig erhalten. Diese Umwandlung darf nicht auf raw-LaTeX, Bildpfade, Zitierbefehle und Formeln angewendet werden.
• Fehlen eine englische Zusammenfassung oder englische Schlüsselwörter, muss der Benutzer wählen können: leeres Feld bestätigen, manuell bereitstellen oder das Generieren erlauben. Standardmäßig darf nicht leer gelassen oder automatisch aus dem Chinesischen ergänzt werden. Wird die Generierung erlaubt, muss zuerst erklärt werden, dass es sich um eine inhaltliche Ergänzung handelt, und die Autorisierung in den Metadaten (metadata.yaml) protokolliert werden.
• Beim Schreiben von chapters/basicinfo.tex muss globales \hypersetup{hidelinks,pdfborder={0 0 0},pdfborderstyle={/S/U/W 0}} gesetzt werden, um farbige Rahmen bei Abbildungsreferenzen und URLs im PDF zu vermeiden.
• Tabellen verwenden standardmäßig die Vorlagenschriftgröße \zihao{5}. \resizebox{\textwidth}{!}{...} darf nicht bedingungslos verwendet werden, da es auch schmalere Tabellen vergrößert und die Schriftgröße zerstört. Nur wenn die natürliche Tabellenbreite eindeutig die Satzspiegelbreite überschreitet und es keine stabilere Spaltenbreitenlösung gibt, darf die Tabelle verkleinert werden. Eine Vergrößerung zum Füllen des Satzspiegels ist verboten.
• Fußnoten, Endnoten, Formeln, Hyperlinks, Kommentare, Änderungsverfolgung, Textrahmen, Kopf-/Fußzeilen und andere Inhalte, die vorerst nicht automatisch konvertiert werden, müssen in den Abschnitt unsupported_features aufgenommen werden und dürfen nicht stillschweigend ignoriert werden.

Detaillierte Referenzen

• Vor Phase A: references/flow-a-gatekeeping.md lesen.
• Bei Umgebungsprüfung oder -reparatur: references/environment-sop.md lesen.
• Nur bei Plattformbefehlen, Installationsdetails, PATH-Reparatur oder Nachinstallation von TeX-Paketen: references/environment-setup-and-repair.md lesen.
• Vor Phase-B-Extraktion oder -Rendering: references/flow-b-conversion.md lesen.
• Vor Phase-C-Kompilierung oder QA: references/flow-c-export-and-qa.md lesen.
• Vor manuellem Bearbeiten von thesis.json: references/thesis-json-schema.md lesen.

Benutzerfeedback

Nicht-technische Benutzer müssen nicht erst Berichte öffnen. Zuerst im Chat kommunizieren:

• Woran die Eingangsprüfung scheitert.
• Warum ein Fortfahren unsicher wäre.
• Was der KI-Assistent automatisch reparieren kann.
• Welche Aktionen die Zustimmung oder Dateibereitstellung des Benutzers erfordern.

Wenn ein technischer Benutzer Details benötigt, kann zusätzlich der Berichtspfad mitgeteilt werden.