yuyu04/hwpkit

Vorschau von HWP/HWPX als Bilder

Das Lesen einer .hwp-Datei liefert den Text, aber nicht das Erscheinungsbild. Dieser Skill rendert Seiten mithilfe des rhwp-eigenen Layout-Engine als Bilder, sodass Sie ein koreanisches Dokument betrachten oder ein gerade erstelltes Dokument überprüfen können – ohne Hancom Office.

Verwendung

node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<datei.hwp|.hwpx>" "<ausgabeverzeichnis>" --png

Lesen Sie dann die erzeugten PNG-Dateien mit dem Read-Tool, um sie tatsächlich anzusehen.

Optionen:

Option	Bedeutung
--png	Schreibt auch PNG (benötigt Chrome/Chromium/Edge als Rasterizer). Ohne diese Option nur SVG.
--scale <n>	PNG-Pixelverhältnis, Standardwert 2. Verwenden Sie 1 für eine schnelle Ansicht, 3 für Details.
--pages <spezifikation>	1-basierte Seiten, z.B. 1, 1,3, 2-4. Standard: alle Seiten.

Die Ausgabe wird benannt als <stamm>-<format>-p<N>.svg bzw. .png, z.B. bericht-hwp-p1.png.

Typische Anwendungen

• Generierte Ausgabe verifizieren. Nach hwp-write.mjs Seite 1 in der Vorschau anzeigen und die Überschriftenhierarchie, Tabellenrahmen und Abstände prüfen, bevor die Datei an den Benutzer übergeben wird.
• Ein vom Benutzer gesendetes Dokument inspizieren, wenn die Frage visueller Natur ist („표가 왜 깨졌지?“, d.h. „Warum ist die Tabelle beschädigt?“) und nicht textuell.
• Dem Benutzer zeigen, was er bekommt, ohne dass er 한글 öffnen muss.

Hinweise

• Wenn --png fehlschlägt, weil kein Browser gefunden wurde, setzen Sie CHROME_PATH auf eine Chrome/Chromium/Edge-Binärdatei – oder lassen Sie --png weg und verwenden Sie SVG, das nur Node.js benötigt.
• Dies ist der Renderer von rhwp, nicht der von Hancom. Schriftarten und Seitenumbrüche sind ähnlich, aber nicht identisch, und tatsächlich auf dem Rechner verfügbare Schriftarten werden ersetzt. Für die endgültige visuelle Freigabe sollte der Benutzer die Datei in 한글 öffnen.
• Erfordert Node.js (verfügbar in der Cowork VM / Claude Code-Umgebung).