chrisryugj/kordoc：README に基づく導入ガイド

chrisryugj/kordoc の README はプロジェクトを「모두 파싱해버리겠다 , 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」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「kordoc」には次の説明があります。HWP 3.x/5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, 이미지(PNG/JPG/WebP) , 관공서에서 쏟아지는 모든 문서를 파싱하고, 비교하고, 분석하고, 생성합니다.。これは範囲の説明であり、本番検証の結果ではありません。

README の「💡 kordoc으로 무엇을 할 수 있나요?」にある内容から、用途が合うかを先に判断できます。📊 복잡한 표(Table) 복원 , 숫자로 잠금: 병합·중첩 표를 구조 그대로 살립니다. HWPX 코퍼스 291문서 표 1,673/1,673·셀 27,714/27,714 무손실(독립 추출기 대조 게이트 1.0), 동일문서 hwpx↔pdf 대조(6쌍 69표)는 매칭 98.6%·완전일치 65.2%. 선 없는 PDF 표도 감지해 복원하고, 법령 개정안 PDF의 신구조문대비표도 통째로 살립니다 (v3.16.2).。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。📄 어떤 문서든 마크다운으로: HWP3 (구버전), HWP(5.x), HWPX, HWPML, PDF, XLS, XLSX, DOCX 파일은 물론 PNG/JPG/WebP 이미지(자동 OCR)까지 즉시 Markdown으로 변환합니다. AI(LLM)가 문서를 읽고 분석하기 가장 좋은 상태로 만들어줍니다.。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「⚡ 30초 설치 (AI 에이전트 연동)」など複数の箇所に分かれています。確認できる情報は次の通りです。대화형 마법사가: 1. 사용 중인 AI 클라이언트 번호 선택 (Claude Desktop / Cursor / Claude Code / Windsurf / VS Code / Gemini CLI / Zed / Antigravity / Codex , 설치된 건 [감지됨] 표시) 2. 설정 파일 자동 패치 → 클라이언트 재시작。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 npm install kordoc 実行可能なコマンドがない場合は手順を作らず、「⚡ 30초 설치 (AI 에이전트 연동)」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「⚡ 30초 설치 (AI 에이전트 연동)」にはWindows 도 자동으로 cmd /c npx 래핑. 수동 JSON 편집 불필요. 재시작하면 15개 문서 도구 (parsedocument, parsetable, fillform, patchdocument, generatedocument 등) 활성화.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料には🔍 신구대조표 자동 생성: 두 문서의 차이점을 분석하여 무엇이 바뀌었는지 한눈에 보여줍니다. (HWP와 HWPX 간의 비교도 가능!)ともあります。