kordoc 4.21.12 → 4.21.13

package/README.md

@@ -12,7 +12,7 @@ HWP 3.x·5.x, HWPX, HWPML, PDF, XLS·XLSX, DOCX, PPTX, PNG·JPG·WebP를 Markdow
 [English](README-EN.md) · [상세 사용법](docs/usage.md) · [벤치마크](docs/benchmarks.md) · [변경 이력](CHANGELOG.md)
 
 - 📊 **PDF 공개 벤치 종합 0.963** — opendataloader-bench 200문서. 공개 12개 파서 비교 1위(2026-09-29 기록). [측정 조건](docs/benchmarks.md)
-- 🇰🇷 **한국 공문서 표 구조 100%** — 원본 HWPX 2,424문서의 보이는 표 **10,342개 전부 구조 일치**. [4.21.12 검증](docs/benchmarks.md)
+- 🇰🇷 **한국 공문서 표 구조 100%** — 원본 HWPX 2,424문서의 보이는 표 **10,342개 전부 구조 일치**. [4.21.13 검증](docs/benchmarks.md)
 
 [![Kordoc 활용하기 — 영상 보기](./docs/video-demo.jpg)](https://youtu.be/Q13GmgDcIw0)
 
@@ -98,7 +98,7 @@ await writeFile("보고서.hwpx", Buffer.from(hwpx))
 
 ## 검증 결과
 
-**4.21.12 · 2026-10-10 배포 검증**. 고정 코퍼스와 참조 기준으로 측정한 결과입니다.
+**4.21.13 · 2026-10-10 배포 검증**. 고정 코퍼스와 참조 기준으로 측정한 결과입니다.
 
 | 대상 | 규모 | 결과 |
 | --- | --- | --- |
@@ -111,14 +111,15 @@ await writeFile("보고서.hwpx", Buffer.from(hwpx))
 
 표 구조 점수와 셀 내용·화면 재현은 별도 지표입니다. 채점 범위·제외 기준·전 벤치 문서별 비교는 [벤치마크 상세](docs/benchmarks.md)에 있습니다.
 
-외부 PDF 벤치 **opendataloader-bench 200문서**는 4.21.12 배포 측정에서 기본값 종합 **0.963**, OCR 끔 **0.939**입니다. [옵션별 결과와 재현 방법](docs/benchmarks.md#pdf--markdown--opendataloader-bench)
+외부 PDF 벤치 **opendataloader-bench 200문서**는 4.21.13 배포 측정에서 기본값 종합 **0.963**, OCR 끔 **0.939**입니다. [옵션별 결과와 재현 방법](docs/benchmarks.md#pdf--markdown--opendataloader-bench)
 
 ## 최근 업데이트
 
-최신 배포: **[4.21.12](https://github.com/chrisryugj/kordoc/releases/tag/v4.21.12)** · 2026-10-10
+최신 배포: **[4.21.13](https://github.com/chrisryugj/kordoc/releases/tag/v4.21.13)** · 2026-10-10
 
 | 버전 | 주요 변경 |
 | --- | --- |
+| 4.21.13 | PDF 법령 별표 쪽 넘김 행 — 번호 열이 다음 차례면 새 행, "가)" 항목도 다음 항목 머리로, 쪽을 넘는 긴 칸은 두 행을 덮는 한 칸으로; parse-worker 가 닫힌 stdout 에서 조용히 끝남(#142) (법령 별표 PDF 표 구조 일치 96.82 → 97.40%, 문서별 하락 0) |
 | 4.21.12 | PDF 칸 숫자 줄·걸친 글상자·배분 이름표·첨자 겹침 — 칸을 채운 숫자 줄만 잇기, 서로 걸친 글상자는 글로, 숫자 행 배분 두 음절 붙이기, 붙은 첨자 겹침 허용 0.25em (PDF 어절 F1 98.86 → 98.87%·ODL 표 TEDS 0.9799 → 0.9802, 문서별 하락 0) |
 | 4.21.11 | PDF 목차·라벨탭 상자·칸 첨자 — 목차 리더 걷기, 제목 칩 상자를 글로, 목차 칸 제목·쪽 번호 짝짓기, 서식 칸 붙은 첨자 흡수 (PDF 글 정확도 99.58 → 99.64%·OCR CER 0.0421 → 0.0412, 문서별 하락 0 — 열화 OCR 은 표본 쪽 셋 이동) |
 | 4.21.10 | PDF 흐름도 표·괄호 풀이 — 선 격자 표를 품은 클러스터 후보 거름, 짧은 괄호 풀이 앞 줄 꺾임 이음 (PDF 어절 F1 98.84 → 98.85%·OCR CER 0.0443 → 0.0421, 문서별 하락 0) |
@@ -147,6 +148,20 @@ await writeFile("보고서.hwpx", Buffer.from(hwpx))
 
 4.18.8 셀 편집은 같은 수의 비어 있지 않은 줄에 한정됩니다. 빈 줄·줄 추가/삭제·리터럴 `<br>`·모호한 매핑은 계속 건너뜁니다. [전체 변경 이력](CHANGELOG.md)
 
+## 자주 묻는 질문
+
+**Q. HWP·HWPX 파일을 Markdown으로 바꾸려면?**
+`npx kordoc 문서.hwp -o 문서.md` 한 줄입니다. 한컴오피스 없이 파일을 직접 읽으며, 여러 파일은 `npx kordoc *.hwpx -d ./output`으로 한 번에 바꿉니다.
+
+**Q. Claude·Cursor 같은 AI가 한글 문서를 읽게 하려면?**
+`npx -y kordoc setup`으로 MCP를 등록하면 AI가 파일 경로만 받아 HWP·PDF·엑셀을 읽고, 비교하고, 양식을 채웁니다.
+
+**Q. 인터넷이 막힌 폐쇄망에서도 되나요?**
+됩니다. `KORDOC_OFFLINE=1`이 외부 통신을 모두 막고, OCR도 API 키 없이 로컬 CPU에서 돕니다. [폐쇄망 설치](docs/offline-deployment.md)
+
+**Q. RAG 색인용으로 쓸 수 있나요?**
+`--format chunks`가 제목 경로를 붙인 구조 청크와 독립 표 청크를 냅니다. 표를 HTML 없이 받으려면 `--table-format gfm`(API는 `tableFormat: "gfm"`)을 씁니다. Python·Java에서는 [Python SDK](sdk/python/README.md)·[Java SDK](sdk/java/README.md)로 부릅니다.
+
 ## 문서·보안
 
 - [상세 사용법](docs/usage.md): 전체 CLI·MCP 도구·API·지원 포맷

package/dist/{-RX7XZ3YG.js → -4UPN43UD.js}

@@ -54,17 +54,17 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-7BHPPEWK.js";
+} from "./chunk-DAR2TMBL.js";
 import {
   blocksToPages
-} from "./chunk-UJARPT2G.js";
+} from "./chunk-FFBZG5MK.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-SBHOOTMT.js";
+} from "./chunk-JGAY3BHY.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -72,7 +72,7 @@ import {
 } from "./chunk-3WSNLH4B.js";
 import {
   blocksToChunks
-} from "./chunk-OAU5DO2L.js";
+} from "./chunk-VC2SS3OH.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -97,20 +97,20 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-4PNWGIFX.js";
+} from "./chunk-UAEY6VPV.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-PBNL6TOS.js";
+import "./chunk-YM4AEOS4.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-W5MRFI5K.js";
+import "./chunk-YJ4J6EG5.js";
 import {
   blocksToMarkdown,
   flattenLayoutTables,
   hasStructuredCellContent
-} from "./chunk-QVMQ2NDS.js";
-import "./chunk-Y27V3EBB.js";
+} from "./chunk-QOIZF57S.js";
+import "./chunk-VXNR2JYB.js";
 import {
   VERSION
-} from "./chunk-4BGPR423.js";
+} from "./chunk-LXYM2EST.js";
 export {
   AGENCY_COMMON_NAME,
   BUILTIN_TEMPLATES,
@@ -204,4 +204,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-RX7XZ3YG.js.map
+//# sourceMappingURL=-4UPN43UD.js.map

package/dist/{chunk-73GNY7ZX.js → chunk-3YD3SAQW.js}

@@ -5,11 +5,11 @@ import {
   HEADING_RATIO_H2,
   HEADING_RATIO_H3,
   tidyScriptTags
-} from "./chunk-PBNL6TOS.js";
+} from "./chunk-YM4AEOS4.js";
 import {
   safeMax,
   safeMin
-} from "./chunk-4BGPR423.js";
+} from "./chunk-LXYM2EST.js";
 
 // src/pdf/line-extract.ts
 import { OPS } from "pdfjs-dist/legacy/build/pdf.mjs";
@@ -8746,4 +8746,4 @@ export {
   UNRULED_REGION_TABLES,
   mergeOcrImageRegions
 };
-//# sourceMappingURL=chunk-73GNY7ZX.js.map
+//# sourceMappingURL=chunk-3YD3SAQW.js.map

package/dist/{chunk-JILWW4LO.cjs → chunk-57EOUEB4.cjs}

@@ -10,10 +10,10 @@ var _chunkTK3FDAEEcjs = require('./chunk-TK3FDAEE.cjs');
 
 
 
-var _chunkZUFZNZHOcjs = require('./chunk-ZUFZNZHO.cjs');
+var _chunkDU2HC36Xcjs = require('./chunk-DU2HC36X.cjs');
 
 
-var _chunkW5EQNSO6cjs = require('./chunk-W5EQNSO6.cjs');
+var _chunkWPZOIIM2cjs = require('./chunk-WPZOIIM2.cjs');
 
 // src/ocr/ruling-lines.ts
 var INK_LUMA_MAX = 205;
@@ -1415,7 +1415,7 @@ var OcrEngine = class _OcrEngine {
     ]);
     const sharpAny = sharpModRaw;
     const sharpMod = typeof sharpAny === "function" ? sharpAny : _nullishCoalesce(sharpAny.default, () => ( sharpAny));
-    const dir = _chunkZUFZNZHOcjs.getOcrModelsDir.call(void 0, );
+    const dir = _chunkDU2HC36Xcjs.getOcrModelsDir.call(void 0, );
     const sessionOpts = {
       graphOptimizationLevel: "all",
       executionProviders: ["cpu"],
@@ -1423,11 +1423,11 @@ var OcrEngine = class _OcrEngine {
       // paddle2onnx 변환 잔여물 W 로그 폭주 억제
     };
     const [det, rec, dictYml] = await Promise.all([
-      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkZUFZNZHOcjs.OCR_DET_MODEL.filename), sessionOpts),
-      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkZUFZNZHOcjs.OCR_REC_MODEL.filename), sessionOpts),
-      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkZUFZNZHOcjs.OCR_REC_DICT.filename), "utf-8")
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkDU2HC36Xcjs.OCR_DET_MODEL.filename), sessionOpts),
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkDU2HC36Xcjs.OCR_REC_MODEL.filename), sessionOpts),
+      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkDU2HC36Xcjs.OCR_REC_DICT.filename), "utf-8")
     ]);
-    const dict = _chunkZUFZNZHOcjs.parseCharacterDict.call(void 0, dictYml);
+    const dict = _chunkDU2HC36Xcjs.parseCharacterDict.call(void 0, dictYml);
     if (dict.length === 0) throw new Error("OCR \uC0AC\uC804 \uD30C\uC2F1 \uC2E4\uD328 \u2014 \uBAA8\uB378 \uCE90\uC2DC\uB97C \uC0AD\uC81C \uD6C4 \uC7AC\uB2E4\uC6B4\uB85C\uB4DC\uD558\uC138\uC694");
     return new _OcrEngine({ det, rec, dict, ort: ortMod, sharp: sharpMod });
   }
@@ -1755,7 +1755,7 @@ async function tryImport(name, loader) {
     return await loader();
   } catch (e) {
     throw new Error(
-      `\uB0B4\uC7A5 OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkW5EQNSO6cjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
+      `\uB0B4\uC7A5 OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkWPZOIIM2cjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
     );
   }
 }
@@ -1869,7 +1869,7 @@ async function runPdfOcr(buffer, targets, mode, warnings, onProgress, detectTabl
     () => Promise.resolve().then(() => _interopRequireWildcard(require("@hyzyla/pdfium")))
   );
   if (mode === "builtin") {
-    await _chunkZUFZNZHOcjs.ensureOcrModels.call(void 0, (p) => {
+    await _chunkDU2HC36Xcjs.ensureOcrModels.call(void 0, (p) => {
       if (p.phase === "download" && p.downloaded === 0) {
         process.stderr.write(`[kordoc-ocr] ${p.spec.name} \uB2E4\uC6B4\uB85C\uB4DC \uC911 (~${p.spec.sizeMb}MB)...
 `);
@@ -1950,7 +1950,7 @@ async function ocrOnePage(page, pageNo, mode, engine, warnings, detectTables, ve
         const x1 = r.x1 * scale - 2, x2 = r.x2 * scale + 2, y1 = (pdfH - r.y2) * scale - 2, y2 = (pdfH - r.y1) * scale + 2;
         const columnRules = _nullishCoalesce(_optionalChain([ruling, 'optionalAccess', _21 => _21.verticals, 'access', _22 => _22.filter, 'call', _23 => _23((s) => Math.min(s.x1, s.x2) >= x1 && Math.max(s.x1, s.x2) <= x2 && Math.min(s.y1, s.y2) >= y1 && Math.max(s.y1, s.y2) <= y2), 'access', _24 => _24.length]), () => ( 0));
         if (columnRules < 2) {
-          for (const b of blocks) if (b.type === "table") _chunkZUFZNZHOcjs.UNRULED_REGION_TABLES.add(b);
+          for (const b of blocks) if (b.type === "table") _chunkDU2HC36Xcjs.UNRULED_REGION_TABLES.add(b);
         }
         return blocks;
       });
@@ -2083,14 +2083,14 @@ function ocrItemsToBlocks(items, pageNumber, pdfW, pdfH, scale, extraLines, dete
       ...xs[i].space ? { hasSpaceBefore: true } : {}
     };
   });
-  return _chunkZUFZNZHOcjs.extractPageBlocksWithLines.call(void 0, norm, pageNumber, opList, pdfW, pdfH, extraLines, detectTables);
+  return _chunkDU2HC36Xcjs.extractPageBlocksWithLines.call(void 0, norm, pageNumber, opList, pdfW, pdfH, extraLines, detectTables);
 }
 async function tryImport2(name, loader) {
   try {
     return await loader();
   } catch (e) {
     throw new Error(
-      `OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkW5EQNSO6cjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
+      `OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkWPZOIIM2cjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
     );
   }
 }
@@ -2130,4 +2130,4 @@ function bgraToRgba(bgra) {
 
 
 exports.getOcrEngine = getOcrEngine; exports.detectRulingLines = detectRulingLines; exports.rulingToPdfLines = rulingToPdfLines; exports.deskewPage = deskewPage; exports.MAX_OCR_PIXELS = MAX_OCR_PIXELS; exports.runPdfOcr = runPdfOcr; exports.groupOcrLines = groupOcrLines; exports.ocrItemsToBlocks = ocrItemsToBlocks;
-//# sourceMappingURL=chunk-JILWW4LO.cjs.map
+//# sourceMappingURL=chunk-57EOUEB4.cjs.map