kordoc 4.21.11 → 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.11 검증](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,27 +98,29 @@ await writeFile("보고서.hwpx", Buffer.from(hwpx))
 
 ## 검증 결과
 
-**4.21.11 · 2026-10-10 배포 검증**. 고정 코퍼스와 참조 기준으로 측정한 결과입니다.
+**4.21.13 · 2026-10-10 배포 검증**. 고정 코퍼스와 참조 기준으로 측정한 결과입니다.
 
 | 대상 | 규모 | 결과 |
 | --- | --- | --- |
 | HWPX | 2,424문서 · 10,342표 | 표 구조 일치 **10,342/10,342 · 100%** |
 | HWP 5.x ↔ HWPX | 1,130쌍 · 4,315표 | 짝 문서의 표 구조 일치 **100%** |
-| PDF 글 | 744쌍 | 글자 재현율 **99.83%** · 정확도 **99.64%** · 읽기 순서 **99.16%** · 어절 F1 **98.86%** |
+| PDF 글 | 744쌍 | 글자 재현율 **99.83%** · 정확도 **99.64%** · 읽기 순서 **99.16%** · 어절 F1 **98.87%** |
 | PDF 표 | 708쌍 · 2,331표 | 표 탐지 **99.83%** · 구조 일치 **97.98%** · 칸 F1 **0.991** |
 | PDF 전체 | 1,911문서 중 1,729건 채점 | 글 커버리지 **99.80%** |
 | OCR | 53문서 · 102쪽 | CER **0.0412** · 글자 재현율 **99.03%** |
 
 표 구조 점수와 셀 내용·화면 재현은 별도 지표입니다. 채점 범위·제외 기준·전 벤치 문서별 비교는 [벤치마크 상세](docs/benchmarks.md)에 있습니다.
 
-외부 PDF 벤치 **opendataloader-bench 200문서**는 4.21.11 배포 측정에서 기본값 종합 **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.11](https://github.com/chrisryugj/kordoc/releases/tag/v4.21.11)** · 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) |
 | 4.21.9 | PDF 줄 꺾임 이음 — 낱말 가운데 꺾임·겹조사·계사·접미사·명사+하다, 본문 위 첨자 행 흡수 (PDF 어절 F1 98.81 → 98.84%·글 커버리지 99.79 → 99.80%, 문서별 하락 0) |
@@ -146,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/{-VONBNRVD.js → -4UPN43UD.js}

@@ -54,17 +54,17 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-S7J7VI4R.js";
+} from "./chunk-DAR2TMBL.js";
 import {
   blocksToPages
-} from "./chunk-2LFYBDX2.js";
+} from "./chunk-FFBZG5MK.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-OEF4V654.js";
+} from "./chunk-JGAY3BHY.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -72,7 +72,7 @@ import {
 } from "./chunk-3WSNLH4B.js";
 import {
   blocksToChunks
-} from "./chunk-GLZ4XPKX.js";
+} from "./chunk-VC2SS3OH.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -97,20 +97,20 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-NI3RMQTS.js";
+} from "./chunk-UAEY6VPV.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-SWV27B56.js";
+import "./chunk-YM4AEOS4.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-NMXMBYRP.js";
+import "./chunk-YJ4J6EG5.js";
 import {
   blocksToMarkdown,
   flattenLayoutTables,
   hasStructuredCellContent
-} from "./chunk-ZTNZ4UZM.js";
-import "./chunk-JDEWFE46.js";
+} from "./chunk-QOIZF57S.js";
+import "./chunk-VXNR2JYB.js";
 import {
   VERSION
-} from "./chunk-L652BNX6.js";
+} from "./chunk-LXYM2EST.js";
 export {
   AGENCY_COMMON_NAME,
   BUILTIN_TEMPLATES,
@@ -204,4 +204,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-VONBNRVD.js.map
+//# sourceMappingURL=-4UPN43UD.js.map