預覽 HWP / HWPX 為圖片
讀取 .hwp 可取得其文字，但無法取得其外觀。此技能利用 rhwp 自有的排版引擎將頁面渲染為
圖片，因此您可以在沒有 Hancom Office 的情況下檢視韓國文件 — 或驗證您剛產生的文件。
使用方式
node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<file.hwp|.hwpx>" "<outdir>" --png
然後使用「讀取」工具讀取產生的 PNG 檔案，以實際檢視它們。
選項：
| 選項 | 意義 |
|---|---|
--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並使用 SVG，這除了 Node 外無需任何東西。 - 此為 rhwp 的渲染器，而非 Hancom 的。字型與分頁雖接近但不完全相同， 且機器上實際可用的字型會被替換。最終的視覺確認仍應由使用者在 한글 中開啟檔案。
- 需要 Node.js（可在 Cowork VM / Claude Code 環境中取得）。