yuyu04/hwpkit

Previsualizar HWP / HWPX como imágenes

Leer un .hwp te da su texto, pero no su apariencia. Este skill renderiza páginas a imágenes usando el motor de maquetación propio de rhwp, para que puedas ver un documento coreano — o verificar un documento que acabas de generar — sin necesidad de Hancom Office.

Cómo usar

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

Luego lee los archivos PNG generados con la herramienta de lectura para visualizarlos.

Opciones:

Opción	Significado
--png	También escribe PNG (necesita Chrome/Chromium/Edge como rasterizador). Sin ella, solo SVG.
--scale <n>	Relación de píxeles PNG, por defecto 2. Usa 1 para una vista rápida, 3 para detalle.
--pages <especificación>	Páginas basadas en 1, ej. 1, 1,3, 2-4. Por defecto: todas las páginas.

La salida se nombra como <base>-<formato>-p<N>.svg / .png, ej. reporte-hwp-p1.png.

Usos típicos

• Verificar la salida generada. Después de hwp-write.mjs, previsualiza la página 1 y revisa la jerarquía de encabezados, los bordes de las tablas y el espaciado antes de entregar el archivo al usuario.
• Inspeccionar un documento enviado por el usuario cuando la pregunta es visual ("¿por qué se rompió la tabla?") más que textual.
• Mostrar al usuario lo que obtendrá sin pedirle que abra 한글.

Notas

• Si --png falla porque no se encontró un navegador, configura CHROME_PATH con un binario de Chrome/Chromium/Edge — o elimina --png y usa el SVG, que no necesita nada más que Node.
• Este es el renderizador de rhwp, no el de Hancom. Las fuentes y la paginación son cercanas pero no idénticas, y se sustituyen las fuentes realmente disponibles en la máquina. Para la aprobación visual final, el usuario debe abrir el archivo en 한글.
• Requiere Node.js (disponible en el entorno de Cowork VM / Claude Code).