ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

kordoc布局保留渲染:HWPX转SVG·PNG·PDF预览,零韩文Office依赖

kordoc布局保留渲染:HWPX转SVG·PNG·PDF预览,零韩文Office依赖 kordoc布局保留渲染HWPX转SVG·PNG·PDF预览零韩文Office依赖【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordockordoc是一款把 HWP、HWPX、PDF、Office 韩文文档转成 Markdown 的开源工具CLI MCP 服务器其中最受普通用户欢迎的能力之一是布局保留渲染Layout-preserving Rendering把 HWPX / HWP 5.x 文档按原始排版渲染成 SVG、PNG、JPEG、HTML、PDF 预览图全程无需安装韩文版 Hancom Office한컴오피스。为什么你需要布局保留的预览把 HWPX 转成 Markdown 时大部分工具只关心文字内容——段落、表格、图片顺序。但公文、表单、结재문서审批件这类文档排版本身就是信息表格跨了几页、单元格合并方式对不对印章位置、落款对齐、页眉页脚是否完整AI 生成或批量修改后的文档有没有内容溢出、被裁切传统做法只能打开韩文版 Office 肉眼检查而 kordoc 的render命令把打开文档看一眼这件事变成了一条命令。工作原理直接读取韩文Office的排版缓存零依赖kordoc 的渲染器不重新实现一套排版引擎而是分两级工作见 src/render/svg-render.ts 头部注释Tier-1 缓存回放韩文 Office 保存 HWPX 时会把每一行的坐标vertpos / horzsize 等写进linesegarray布局缓存。kordoc 直接按这些坐标绝对定位绘制还原度与韩文 Office 完全一致。Tier-2 reflow 重排程序生成的 HWPX如 Markdown → HWPX 的产物没有布局缓存kordoc 内置的纯 TypeScript 排版引擎 src/render/reflow.ts 会模拟断行与纵向模型合成一份 lineseg 坐标喂给同一渲染管线作为近似预览。这意味着✅ 服务器、容器、CI 环境不需要韩文 Office也不需要 WINE✅ 韩文 Office 保存的原件 精确回放AI 生成的文档 快速近似预览⚠️ 已知限制数式对象暂不支持会收集警告跨页表格在起始页截断一键预览kordoc render 命令速查安装后无需配置任何外部组件常用命令完整列表见 docs/usage.md# 整份 HWPX → 单文件 SVG所有页纵向堆叠最适合贴到网页/工单 npx kordoc render 결재문서.hwpx -o 미리보기.svg # 只渲染第 2–4 页 → 逐页 PNG npx kordoc render 결재문서.hwpx --format png --pages 2-4 -d ./pages # 直接产出可分享的 PDF 预览 npx kordoc render 결재문서.hwpx --format pdf -o 미리보기.pdf # 给关键词打荧光笔快速定位修改处 npx kordoc render 결재문서.hwpx --highlight 예산,기일 -o 미리보기.svg命令实现位于 src/cli/commands-render.ts支持参数参数用途--formatsvg默认/png/jpeg/html/pdf--pages页范围支持3、1-3、1,3,7-9--max-width栅格图最大宽度默认 1400px控制体积--highlight逗号分隔的荧光笔关键词--no-reflow关闭 Tier-2 重排缓存缺失的文档会输出空白页输出为多页时文件自动命名为page_001.png、page_002.png……方便批量归档。库集成三行代码拿到 SVG 与逐页资产TypeScript 项目里渲染 API 从 src/render/index.ts 导出import { renderHwpxToSvg, renderDocument, extractRenderedRegions } from kordoc // ① 整份 HWPX → SVG自动叠加荧光笔 const r await renderHwpxToSvg(buf, { highlights: [예산] }) // r.svg / r.pageCount / r.stats { texts, images, tables } // ② 统一渲染 — HWPX·HWP(5.x)逐页 PNG 渲染场景(RenderScene) const { scene, assets } await renderDocument(결재문서.hwp, { format: png, pages: 1-2 }) // ③ 按类型裁切区域 — 自动抠出所有表格的图片 const crops await extractRenderedRegions(결재문서.hwp, { types: [table] })第 ③ 个 API 特别实用配合 CLI 的kordoc crop命令可以把文档中每张表格单独切成 PNGsrc/mcp/tools-render.ts适合做表格级 diff 或喂给视觉模型。AI 闭环MCP 让 AI用眼睛验证生成结果kordoc 作为 MCP 服务器注册了render_document工具。典型工作流AI 用generate_document/fill_form/patch_document生成或修改 HWPX立即调用render_document把渲染后的 PNG 直接返回到对话中AI 检查裁切、溢出、错位 → 发现问题 → 再次修改形成生成 → 渲染 → 纠错的视觉闭环这正是官方推荐的生成文档质检方式不再让 AI 盲猜排版结果。注册方式一条命令npx -y kordoc setup # 自动注册 MCP 到已安装的 AI 客户端另外还有一个常驻渲染进程kordoc render-worker适合给自建预览应用做后端避免每次预览都冷启动 Node。常见场景与注意事项扫描件 / PDF 不走 renderrender面向 HWPX 与 HWP(5.x) 的版式还原PDF 预览请直接parse成 Markdown 或用--pages选页。生成的文档预览是近似reflow 是纯 TS 排版实测水平断行约 98% 一致仅用于快速目检正式交付仍以韩文 Office 打开为准。想保留原版式做编辑用--keep-layout-tables提取 Markdown → 修改 →kordoc patch回填再render验证形成完整的格式保留工作流。性能SVG 单文件整份堆叠最快栅格 PNG 默认 1400px 宽可用--max-width降采样控制响应体积。小结kordoc 的布局保留渲染把韩文文档 → 可视化预览从必须安装韩文 Office 的重活变成了一条命令的轻量操作韩文 Office 原件直接回放排版缓存像素级还原零依赖AI 生成文档内置 reflow 引擎快速近似预览输出 SVG / PNG / PDF / HTML支持按页、按区域裁切、关键词荧光笔MCPrender_document让 AI 自动看图纠错详细用法与全部参数可查阅 docs/usage.md渲染管线源码在 src/render/ 目录欢迎按模块对照阅读。【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordoc创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表