Visualizar HWP / HWPX como imagens
Ler um .hwp fornece o texto, mas não a aparência. Esta skill renderiza páginas em imagens usando o motor de layout do rhwp, para que você possa visualizar um documento coreano — ou verificar um documento que acabou de gerar — sem o Hancom Office.
Como usar
node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<arquivo.hwp|.hwpx>" "<diretório_de_saída>" --png
Em seguida, leia os arquivos PNG gerados com a ferramenta Read para realmente visualizá-los.
Opções:
| Opção | Significado |
|---|---|
--png | Também escreve PNG (precisa de Chrome/Chromium/Edge como rasterizador). Sem ele, apenas SVG. |
--scale <n> | Proporção de pixels do PNG, padrão 2. Use 1 para uma olhada rápida, 3 para detalhes. |
--pages <spec> | Páginas baseadas em 1, ex.: 1, 1,3, 2-4. Padrão: todas as páginas. |
A saída é nomeada como <base>-<formato>-p<N>.svg / .png, ex.: relatorio-hwp-p1.png.
Usos típicos
- Verificar a saída gerada. Após
hwp-write.mjs, visualize a página 1 e confira a hierarquia de cabeçalhos, bordas de tabela e espaçamento antes de entregar o arquivo ao usuário. - Inspecionar um documento enviado pelo usuário quando a pergunta é visual ("표가 왜 깨졌지?") em vez de textual.
- Mostrar ao usuário o que ele vai receber sem pedir que ele abra o 한글.
Notas
- Se
--pngfalhar porque nenhum navegador foi encontrado, definaCHROME_PATHcom um binário do Chrome/Chromium/Edge — ou remova--pnge use o SVG, que não precisa de nada além do Node. - Este é o renderizador do rhwp, não o do Hancom. Fontes e paginação são próximas, mas não idênticas, e as fontes realmente disponíveis na máquina são substituídas. Para aprovação visual final, o usuário deve abrir o arquivo no 한글.
- Requer Node.js (disponível no ambiente Cowork VM / Claude Code).