HWP / HWPX を画像でプレビュー
.hwp を読み込むとテキストは取得できますが、見た目 まではわかりません。このスキルは rhwp のレイアウトエンジンを使ってページを画像にレンダリングするため、Hancom Office なしで韓国語の文書を確認したり、生成した文書を検証したりできます。
使い方
node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<file.hwp|.hwpx>" "<outdir>" --png
生成された PNG ファイルを Read ツールで読み込んで実際に確認します。
オプション:
| オプション | 意味 |
|---|---|
--png | PNG も書き出します（ラスタライザとして Chrome/Chromium/Edge が必要）。指定しない場合は SVG のみ。 |
--scale <n> | PNG のピクセル倍率、デフォルト 2。簡易確認には 1、詳細確認には 3。 |
--pages <spec> | 1始まりのページ指定。例: 1, 1,3, 2-4。デフォルト: 全ページ。 |
出力は <stem>-<format>-p<N>.svg / .png の形式で、例: report-hwp-p1.png
代表的な使い方
- 生成した出力を検証する。
hwp-write.mjs実行後、1ページ目をプレビューして見出し階層、表の罫線、余白を確認してからファイルをユーザーに渡します。 - ユーザーから送られてきた文書を視覚的に確認する。 テキストではなく見た目に関する質問（「표가 왜 깨졌지?」）の場合に便利です。
- ユーザーに最終イメージを見せる。 ユーザーに 한글 を開かせることなく、完成イメージを提示できます。
注意事項
- ブラウザが見つからず
--pngが失敗する場合は、CHROME_PATHに Chrome/Chromium/Edge のバイナリを設定するか、--pngを外して Node のみで動作する SVG を使用してください。 - これは rhwp のレンダラーであり、Hancom のものではありません。フォントや改ページは近いですが完全一致ではなく、マシン上で実際に利用可能なフォントで置き換えられます。最終的な見た目の確認は、ユーザーが 한글 でファイルを開いて行う必要があります。
- Node.js が必要です（Cowork VM / Claude Code 環境で利用可能）。