From 78b0a70d60d5d414f80579577b6126dd0c797a70 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=86=90=EC=84=B1=EC=A4=80?= Date: Tue, 2 Jun 2026 14:11:33 +0900 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=EB=8F=84=EA=B5=AC=20=EB=AA=A9?= =?UTF-8?q?=EB=A1=9D=EC=9D=84=2012=EA=B0=9C=20=EC=A0=84=EB=B6=80=EB=A1=9C?= =?UTF-8?q?=20=EA=B0=B1=EC=8B=A0=20(=EB=88=84=EB=9D=BD=205=EA=B0=9C=20?= =?UTF-8?q?=EB=B0=98=EC=98=81)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README '노출되는 도구' 표가 7개만 나열하고 get_shapes/set_shape_text(v0.8), get_form_controls/set_form_control(v0.10), diff_documents(v0.11) 5개가 누락돼 있었음. 12개 전부 반영 + render_template on_missing/조건식, inspect duplicate_labels 힌트 등 최신 반환 필드 명시. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a9f522c..e410056 100644 --- a/README.md +++ b/README.md @@ -221,15 +221,20 @@ resp = client.messages.create( ## 노출되는 도구 +총 **12 개** 도구 (DOCX/PPTX/HWPX/XLSX 공통, 확장자로 자동 디스패치): + | 도구 | 설명 | |---|---| -| `inspect_document` | 문서 구조(placeholders, tables + `column_widths_cm`/`row_heights_cm`)를 JSON으로 반환. **항상 첫 호출로 사용** | -| `render_template` | `{{key}}`를 context dict 값으로 치환해 새 파일 저장 | +| `inspect_document` | 문서 구조(placeholders, tables + `column_widths_cm`/`row_heights_cm`)를 JSON으로 반환. 같은 라벨이 여러 곳이면 `duplicate_labels` 힌트도 포함. **항상 첫 호출로 사용** | +| `render_template` | `{{key}}` 치환 + 조건/표현식(`{% if %}`, `{{ a*b }}`). `on_missing`(blank/leave/error)로 누락 키 처리, `rendered_keys`/`missing_keys` 반환 | | `get_cell` | 셀 전체 텍스트 + 병합/중첩 메타 + `width_cm`/`height_cm`/`char_count` 반환 | | `set_cell` | 특정 표의 `(row, col)` 셀 값 교체 (병합 anchor만) | | `append_to_cell` | 기존 텍스트 뒤에 값 덧붙임 (라벨 유지용, 예: `"성 명"` → `"성 명 홍길동"`) | -| `fill_form` (v0.7+) | **라벨 이름**으로 일괄 채우기. 좌표 계산 없이 `{"접수번호": "...", "성명": "..."}` dict. dot-path 섹션 해소 지원 | -| `append_row` | 표 끝에 새 행 추가 (DOCX/PPTX/HWPX 전부 지원, v0.5+) | +| `fill_form` (v0.7+) | **라벨 이름**으로 일괄 채우기. 좌표 계산 없이 `{"접수번호": "...", "성명": "..."}` dict. dot-path 섹션 해소 + `overflow_warnings` | +| `append_row` | 표 끝에 새 행 추가 (전 포맷, v0.5+) | +| `get_shapes` / `set_shape_text` (v0.8, PPTX) | 표 외 shape(textbox/placeholder/도형) 텍스트 조회·편집 | +| `get_form_controls` / `set_form_control` (v0.10, HWPX) | 폼 컨트롤(체크박스·라디오·에디트·콤보) 조회·설정 | +| `diff_documents` (v0.11) | 두 문서(편집 전/후)를 셀 단위 비교 → 변경 셀 before/after + `overflow_risk`. **편집 후 검증용** | ### `inspect_document` 반환 예시 (v0.2+)