ChatGPT 플러그인 1.0.2 (직접 업로드용)

ChatGPT에서 한/글 문서(.hwpx, .hwp)를 다루는 플러그인입니다. 아직 ChatGPT 플러그인 디렉터리에 올라가지 않아서, 지금은 ZIP을 직접 올려 본인 계정에서 쓰는 방식입니다.

설치

1. 아래 python-hwpx-plugin-1.0.2.zip을 내려받습니다(압축을 풀지 않습니다).
2. ChatGPT → Plugins → Upload plugin에서 ZIP을 올립니다.
3. 새 대화를 열고 .hwpx나 .hwp 파일을 첨부한 뒤 부탁합니다.
   • "첨부한 문서를 요약해 줘"
   • "이 문서에서 2025년을 2026년으로 모두 바꿔서 새 파일로 줘"
   • "성명 칸에 홍길동을 넣어 줘"
   • "정보과 협의회 결과 보고서를 새로 만들어 줘"

할 수 있는 일

• 문서 읽기·요약
• 문구 모두 바꾸기(표 칸·머리말·각주 포함)
• 표의 라벨 옆 빈 칸 채우기
• 누름틀("이곳을 클릭하여…") 채우기
• 새 문서 만들기

.hwp는 .hwp로, .hwpx는 .hwpx로 저장합니다. 원본은 덮어쓰지 않고, 저장한 파일을 다시 열어 확인한 뒤 돌려줍니다.

1.0.0에서 바뀐 점

• 스킬 이름이 hwpx가 되었습니다(ChatGPT에서는 python-hwpx:hwpx). 스킬 설명도 짧아졌습니다.
• 목록 정보를 OpenAI 공식 형식에 맞췄습니다(영어 기본 설명 + 한국어 번역).
• 문서를 다루는 기능은 같습니다. 1.0.0을 쓰고 있었다면 1.0.2 ZIP을 다시 올리면 됩니다.

동작 방식

플러그인 안에 python-hwpx 6.6.0, python-hwpx-automation 7.3.1과 의존 패키지 wheel이 PyPI 원본 그대로(sha256 고정) 들어 있습니다. ChatGPT 코드 실행 환경에 인터넷 없이 설치되고, 문서는 외부 서버로 보내지 않습니다. 자세한 내용은 개인정보처리방침과 이용약관을 보세요.

한계

• 줄 바꿈·쪽 넘김·칸 넘침 같은 화면 모양은 ChatGPT 안에서 확인할 수 없습니다. 결과는 한/글에서 열어 확인해 주세요.
• 미리보기 이미지·PDF 만들기, 복잡한 양식 채움·시험지·평가계획은 지원하지 않습니다.
• 같은 라벨이 여러 표에 있으면 표를 골라 채울 수 없습니다.

확인

e88857fb18b132ce07a5ea553c2fd22b61a30edfcb1c8314f24dec0d5554901d  python-hwpx-plugin-1.0.2.zip

main(cd27a16)에서 python3 scripts/build_chatgpt_skill.py로 다시 만들면 같은 파일이 나옵니다.

문제는 #42 또는 새 이슈로 알려 주세요.

ChatGPT 플러그인 1.0.0 (이전 버전 — 1.0.2를 쓰세요)

새 버전이 있습니다: ChatGPT 플러그인 1.0.2를 받으세요. 스킬 이름과 목록 정보가 바뀌었고, 문서를 다루는 기능은 같습니다.

ChatGPT에서 한/글 문서(.hwpx, .hwp)를 다루는 플러그인입니다. 아직 ChatGPT 플러그인 디렉터리에 올라가지 않아서, 지금은 ZIP을 직접 올려 본인 계정에서 쓰는 방식입니다.

설치

1. 아래 python-hwpx-plugin-1.0.0.zip을 내려받습니다(압축을 풀지 않습니다).
2. ChatGPT → Plugins → Upload plugin에서 ZIP을 올립니다.
3. 새 대화를 열고 .hwpx나 .hwp 파일을 첨부한 뒤 부탁합니다.
   • "첨부한 문서를 요약해 줘"
   • "이 문서에서 2025년을 2026년으로 모두 바꿔서 새 파일로 줘"
   • "성명 칸에 홍길동을 넣어 줘"
   • "정보과 협의회 결과 보고서를 새로 만들어 줘"

할 수 있는 일

• 문서 읽기·요약
• 문구 모두 바꾸기(표 칸·머리말·각주 포함)
• 표의 라벨 옆 빈 칸 채우기
• 누름틀("이곳을 클릭하여…") 채우기
• 문서 계획으로 새 문서 만들기

.hwp는 .hwp로, .hwpx는 .hwpx로 저장합니다. 원본은 덮어쓰지 않고, 저장한 파일을 다시 열어 확인한 뒤 돌려줍니다.

동작 방식

플러그인 안에 python-hwpx 6.6.0, python-hwpx-automation 7.3.1과 의존 패키지 wheel이 PyPI 원본 그대로(sha256 고정) 들어 있습니다. ChatGPT 코드 실행 환경에 인터넷 없이 설치되고, 문서는 외부 서버로 보내지 않습니다. 자세한 내용은 개인정보처리방침과 이용약관을 보세요.

한계

• 줄 바꿈·쪽 넘김·칸 넘침 같은 화면 모양은 ChatGPT 안에서 확인할 수 없습니다. 결과는 한/글에서 열어 확인해 주세요.
• 미리보기 이미지·PDF 만들기, 복잡한 양식 채움·시험지·평가계획은 지원하지 않습니다.
• 같은 라벨이 여러 표에 있으면 표를 골라 채울 수 없습니다.

확인

10ffb136e1fd324198d008ad3eeb38cc1986c2bdfa9e8ad89f948bb2b12a2b18  python-hwpx-plugin-1.0.0.zip

main(de34196)에서 python3 scripts/build_chatgpt_skill.py로 다시 만들면 같은 파일이 나옵니다.

문제는 #42 또는 새 이슈로 알려 주세요.

hwpx-plugin 2.4.0

HWPX plugin 2.4.0 accompanies python-hwpx 6.6.0 and python-hwpx-automation 7.3.1.

The verified stack pins python-hwpx[preview]==6.6.0 and python-hwpx-automation[mcp,oracle]==7.3.1; the minimum compatible versions stay at core 6.5.0 and automation 7.2.0. The tool contract is unchanged at 5e5c23651f92785a (128 default, 136 advanced, 29 skill-required).

• Core 6.6.0 adds HWP 5.0 (.hwp) read/write and public APIs for working with templates: cell inner margins, font and border reads with font replacement, paper-anchored floating shapes, blanking a body, and metadata/preview/image cleanup.
• Automation 7.3.1 adds hwpx render-pdf for rendering through Hancom from an isolated environment, and writes builder metadata to the document properties instead of visible paragraphs. The bundled government-report example now puts its title in the body; see python-hwpx-automation#137 for the parse-from-text path.

Render success alone does not establish visual correctness or submission readiness.

hwpx-plugin 2.3.0

HWPX plugin 2.3.0 accompanies python-hwpx 6.5.0 and python-hwpx-automation 7.2.0.

The four host bundles describe bounded existing-document preservation, revision-bound editing, and artifact-specific render and visual-review evidence. The verified tool contract is 5e5c23651f92785a (128 default, 136 advanced, 29 skill-required).

Two historical cell-fill page-flow cases still show text occlusion. Render success alone does not establish visual correctness or submission readiness.

v2.2.0

[2.2.0] - 2026-09-09

• Integrate core 6.4.0 and automation 7.1.0 with an explicit unpublished candidate state and unchanged public coordinates.
• Document bounded existing-document navigation and preservation/visual verification separately; regenerate all four host bundles.

Verified automation release: https://github.com/airmang/python-hwpx-automation/releases/tag/v7.1.0
Verified core release: https://github.com/airmang/python-hwpx/releases/tag/v6.4.0

Release state at this tag: release-approved. currentPublic stays 6.3.0 / 7.0.4 / 2.1.0 until a real marketplace install of this stack is observed; the follow-up source commit promotes it. The tag remains immutable.

hwpx-plugin 2.1.0

[2.1.0] - 2026-09-07

• Codex 런처 보강: Codex도 공통 관리 런처를 실행하고 verified·후보 검증·상태 파일을 공유합니다. advanced/렌더 설정 전달, 릴리스 상태 기록, 실행 중 버전과 준비된 세대 구분을 보강했습니다.

automation 7.0.4를 검증 좌표·설치 하한으로 지정합니다.

3스택 자동 갱신 트레인(검증된 플로어 핀). 스킬 계약·도구 표면·계약 해시 8c278ebd5becba08은 그대로입니다.

• 핀 정책 변경: exact-candidate → verified-floor. 번들 런처는 검증 좌표
  이상, 같은 메이저 안의 최신 조합(python-hwpx[preview]>=6.3.0,<7 ·
  python-hwpx-automation[mcp,oracle]>=7.0.4,<8)을 설치하고, 기동 시 점검 간격(기본 24시간)이 지나면 백그라운드에서
  새 세대를 빌드·자기검증한 뒤 원자적으로 교체합니다. 이미 준비된 런타임의 기동은 네트워크를 기다리지
  않고, 검증에 실패한 후보는 절대 활성화되지 않으며, 기존 세대는 실행 중 프로세스를 보호하기 위해 자동 삭제하지 않습니다.
  HWPX_STACK_AUTO_UPDATE=0(끄기), HWPX_STACK_UPDATE_INTERVAL_HOURS(기본 24),
  HWPX_STACK_CHANNEL=verified(검증 좌표 고정).
• 런타임 상태 update-state.json을 HWPX_STACK_UPDATE_STATE로 서버에 전달합니다.
  automation 7.0.4는 mcp_server_health().stackUpdate로 보고하고, SKILL.md는 새
  플러그인 번들이 있으면 호스트별 갱신 명령을 한 번 안내합니다.
• 런처 런타임 레이아웃이 envs/<fingerprint>/gen-<core>-<automation>/ + current
  포인터로 바뀝니다. 기존 envs/<fingerprint>/ 단일 venv는 그대로 두어도 무해하며
  첫 기동에서 새 레이아웃이 빌드됩니다(.hwpx-mcp-runtime를 지우면 공간이 회수됨).
• OpenClaw·Hermes 배선은 설치 창으로 이동했고, uvx가 스스로 갱신하지 않는다는 점과
  수동 갱신 명령을 문서화했습니다.

Verified automation release: https://github.com/airmang/python-hwpx-automation/releases/tag/v7.0.4

Public marketplace installation and native Codex tool calls were observed on 2026-09-07: core6.3.0 / automation7.0.4 / plugin2.1.0, 128 default and 136 advanced tools, unchanged contract, zero protocol errors. The follow-up source commit promotes currentPublic; the tag remains immutable.

Installation verification receipt.

hwpx-plugin 2.0.3 — 런처 자기검증 수리 패치

Claude Code 번들 런처 수리 패치입니다. 코어·automation 핀(python-hwpx[preview]==6.3.0 · python-hwpx-automation[mcp,oracle]==7.0.3), 스킬 내용, 도구 표면, 계약 해시 8c278ebd5becba08은 그대로입니다.

• 수리 — Claude Code 번들 런처가 런타임 venv를 새로 만들 때마다 installed HWPX stack version mismatch … 'python-hwpx': '6.3.0' != … '6.0.2'로 종료해 MCP 서버가 뜨지 않던 결함 (#26). 2.0.1·2.0.2의 모든 신규 설치와 플러그인 업데이트가 이 지점에서 실패했습니다. 기대 버전을 손으로 전진시키는 리터럴 대신 설치 핀에서 파생하고, 릴리스 게이트가 결함을 가리던 env 주입을 제거했습니다. 리터럴이 다시 들어오면 validator와 테스트가 실패합니다.
• Codex 번들 .mcp.json·OpenClaw·Hermes 배선·런처 uvx 폴백에서 기동마다 붙던 --refresh-package 제거 (#23). 핀이 정확 고정이라 동작은 같고, 세션 시작마다의 PyPI 왕복과 오프라인 하드 실패만 사라집니다.
• Codex 번들 .mcp.json에 env_vars 전달 목록 추가 — 셸에 export한 HWPX_AUTOMATION_CHROME_PATH가 서버까지 전달됩니다 (#19, 기여 @Jaempark).

2.0.1 / 2.0.2 사용자: 플러그인을 갱신하면 런타임이 자동으로 다시 빌드됩니다.

# Claude Code
claude plugin marketplace update hwpx
claude plugin update hwpx-plugin@hwpx
# Codex CLI
codex plugin marketplace upgrade
codex plugin add hwpx-plugin@hwpx

새 에이전트 세션을 시작해야 갱신된 런처가 사용됩니다.

hwpx-plugin 2.0.2 — 왕복 충실도 트레인

core 6.3.0·automation 7.0.3을 따라가는 핀 범프 릴리스입니다. 계약 해시는 8c278ebd5becba08로 이동하지만 floor-only 델타입니다(minPythonHwpx 6.0.2 → 6.3.0, 도구 표면 136 불변).

• 번들 설치 핀이 python-hwpx[preview]==6.3.0 · python-hwpx-automation[mcp,oracle]==7.0.3으로 전진합니다:
  • instid 속성명 수리 — 실한컴 파일의 각주/미주 식별과 복제 시 인스턴스 ID 재발급 (core #88, automation #101)
  • hp:audio 분류 정직화 — 실한컴 소리 삽입은 hp:ole (core #89)
  • 표 정렬 프리미티브 reorder_rows (편집기 [표>정렬…] 대응)
• 공개 왕복 충실도 지표 신설: 실한컴 저장본 76건 무편집 왕복 실질 변화 0 · 실한컴 재개봉 판정 가능 73/73 무손상 — corpus-metrics
• 스킬 최소 호환 코어 python-hwpx >= 6.3.0.

hwpx-plugin 2.0.1 — Windows 저장 수리 패치 트레인

automation 7.0.2 패치를 따라가는 핀 범프 릴리스입니다. 스킬 내용·도구 표면·계약 해시(34a91560759dc47a)·플로어는 그대로입니다.

• 번들 설치 핀이 python-hwpx-automation[mcp,oracle]==7.0.2로 전진합니다 — Windows에서 모든 저장이 WORKSPACE_PATH_CHANGED로 실패하던 결함 수정(automation #98, 진단 @rainforest80)과 클라이언트 업로드 경로(/mnt/user-data/...) 안내 에러(automation #75, 기여 @adity982)가 플러그인 설치 경로에도 전달됩니다.
• 코어 핀은 python-hwpx[preview]==6.1.0 그대로입니다.

상류 릴리스: python-hwpx-automation v7.0.2 · CONTRIBUTORS

hwpx-plugin 2.0.0 — 엔진 완전성 트레인

스킬 계약의 도구 어휘는 그대로(128/136/29 불변), 스택이 major로 이동합니다 — 핀 python-hwpx[preview]==6.0.2 · python-hwpx-automation[mcp,oracle]==7.0.1, 계약 해시 34a91560759dc47a(플로어 전진만으로 이동).

상류: python-hwpx 6.0.2(루트 표면 102→34 도메인 네임스페이스·스타일 이름 해석·add_heading·단일 반환 규약·typed error 100%·5.x shim은 7.0까지 유지) · python-hwpx-automation 7.0.1(전 콜사이트 6.0 표면 이주, DeprecationWarning=테스트 실패 게이트).

주의: 1.8.0은 발행되지 않았습니다(release-approved 후보로 이 트레인에 흡수). 직전 공개 트레인은 5.7.0 / 6.7.1 / 1.7.0입니다.