nomadamas/rhwp-advanced

O que rhwp-advanced faz?

Depure o layout de HWP, despeje o IR do documento, compare versões, extraia miniaturas e desbloqueie HWPs somente leitura usando o CLI rhwp Rust upstream (export-svg/dump/dump-pages/ir-diff/thumbnail/convert).

Instalação

Certifique-se de que o cargo (Rust) está instalado e execute:

cargo install rhwp

Comandos Suportados

Comando	Descrição
rhwp export-svg	Exporta cada página como SVG para depuração de layout.
rhwp dump	Despeja a representação interna (IR) completa do documento como JSON.
rhwp dump-pages	Despeja o IR página por página.
rhwp ir-diff	Compara o IR de duas versões de um HWP.
rhwp thumbnail	Extrai a imagem miniatura do documento.
rhwp convert	Converte HWP para outros formatos (ex.: HTML, texto).

Exemplos de Uso

# Exportar SVG da primeira página
rhwp export-svg documento.hwp -o pagina1.svg --page 1

# Despejar o IR completo
rhwp dump documento.hwp > ir.json

# Comparar dois documentos
rhwp ir-diff documento_v1.hwp documento_v2.hwp

# Extrair miniatura
rhwp thumbnail documento.hwp -o miniatura.png

Desbloqueio de HWP Somente Leitura

Para desbloquear um arquivo HWP protegido contra edição:

rhwp convert --unlock documento_bloqueado.hwp -o documento_desbloqueado.hwp

Observações

• O CLI deve estar disponível no PATH.
• Para documentos grandes, utilize rhwp dump-pages para inspeção incremental em vez do dump completo.
• O comando ir-diff requer dois arquivos HWP como argumentos e exibe as diferenças no IR.

Fontes

• Repositório rhwp
• crates.io: rhwp