Offline HWP v5 and HWPX renderer plugin for File Viewer.
File Viewer 的 HWP v5 / HWPX 离线 renderer。HWPX 解析 ZIP/XML、段落、表格与媒体；HWP v5 解析 CFB、FileHeader、BodyText 和 BinData。解析默认在按需加载的模块 Worker 内执行，并限制解压量、压缩率、ZIP 条目数、HWP 记录数和超时。加密、DRM 与发行文档会被明确拒绝，不会尝试绕过保护。
可通过 options.hangul 覆盖 workerUrl、workerTimeoutMs 和解析安全上限；useWorker: false 只适用于没有 Worker 的兼容环境。可再分发的 Apache-2.0 HWP v5/HWPX fixture 已覆盖页面几何、样式、合并表格、页眉页脚、注释和图片，并通过 Chromium、Firefox、WebKit，公开格式目录标记为 structured / stable。罕见控件与生产者私有版式仍是已知限制。
@file-viewer/renderer-hangul 共发布 15 个版本，首次发布于 2026/08/20；过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。
| 版本 | 发布日期 | 距今 |
|---|---|---|
3.3.3latest | 2026/10/31 | 14 天前 |
3.3.1 | 2026/10/30 | 15 天前 |
3.3.0 | 2026/10/27 | 18 天前 |
3.2.2 | 2026/10/18 | 27 天前 |
3.2.1 | 2026/10/15 | 30 天前 |
3.2.0 | 2026/10/15 | 30 天前 |
Offline HWP v5 and HWPX renderer plugin for File Viewer.
在项目目录运行 npm install @file-viewer/renderer-hangul，或使用 pnpm add / yarn add / bun add。
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@file-viewer/renderer-hangul 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
根据 npm 官方下载统计，@file-viewer/renderer-hangul 在 2026/10/15 – 2026/11/13 这 30 天内被下载 32,077 次，日均约 1,069 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
最新版本 3.3.3 发布于 2026/10/31（14 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/08/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。