将 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 环境中可用）。