DocPilot 은 HWP·HWPX·DOCX·PPTX·XLSX 등 업무 문서를 열어 편집하고, 오른쪽 패널의 AI 에이전트에 수정을 요청하는 Windows 데스크톱 앱입니다. 1.5.0 은 글꼴 바꾸기와 목차 창을 추가하고, 저장 방식을 덮어쓰기 중심으로 개편했으며, Word 문서(DOCX)의 줄 높이와 글자 간격을 Word 출력에 맞춘 판입니다. 출시 전에 실제 앱으로 사용성 평가를 두 차례 진행했고, 1차에서 발견한 문제 10건을 수정한 뒤 2차 평가에서 모두 해결되었음을 확인했습니다. 이 글은 항목별 구현 방식과 확인한 범위, 남은 한계를 정리합니다.

글꼴 바꾸기: 형식마다 다른 글꼴 기록 방식
편집 탭의 글꼴 입력란에서 글꼴을 고르면 선택한 글로 미리 보기를 보여 주고, Enter 나 클릭으로 적용합니다. 목록은 이 PC 에 설치된 글꼴과 1.4.0 에서 추가한 한컴오피스·사용자 지정 폴더의 글꼴을 합친 것이며, 한글 이름이 있는 글꼴은 한글 이름으로 보입니다. 입력 없이 열면 문서에 쓰인 글꼴을 글자 수가 많은 순으로 최대 12개까지 위에 따로 묶고, 이 PC 에 없는 글꼴에는 표시를 붙입니다. 없는 글꼴을 적용하면 화면에는 대체 글꼴로 보인다는 알림을 띄웁니다.
구현에서 가장 까다로운 부분은 저장입니다. 글꼴을 기록하는 방식이 형식마다 달라서, 엔진의 글자 서식 변경(CharPatch.font)을 형식별 기록 규칙으로 변환하도록 구현했습니다. 글꼴 이름은 따옴표, 꺾쇠, &, 제어 문자를 허용하지 않고 64자로 제한합니다.
| 형식 | 기록 방식 |
|---|---|
| HWP | 언어 묶음 7개마다 글꼴 이름 레코드(FACE_NAME)를 묶음 끝에 추가하고 ID_MAPPINGS 의 글꼴 수를 갱신한 뒤, 글자 모양 레코드의 언어별 글꼴 번호를 새 번호로 바꿈 |
| HWPX | hh:fontface 의 언어별 목록 끝에 hh:font 를 추가하고 fontCnt 를 갱신, 글자 모양의 hh:fontRef 7개 속성을 바꿈 |
| DOCX | w:rFonts 를 통째로 교체하고 테마 글꼴 참조를 제거 |
| PPTX | a:latin·a:ea·a:cs 를 교체 |
| XLSX | 글꼴의 name 을 바꾸고 scheme·family·charset 을 제거 |
| ODT·ODS·ODP | fo:font-family 와 아시아·복합 문자용 속성을 함께 교체 |
| MD·TXT·CSV | 글꼴 정보를 담을 곳이 없어 거절 |
HWP 에서는 글꼴 레코드를 먼저 넣고 나서 글자 모양 레코드의 위치를 계산해야 오프셋이 맞습니다. HWPX 구현 중에는 속성을 나눠 읽는 과정에서 앞 공백이 누락되어 글꼴 번호를 읽지 못하고 새 글꼴이 0번으로 중복 기록되는 문제가 발생했습니다. 이에 속성을 찾기 전에 공백을 붙이도록 처리했습니다. 저장한 파일은 한컴오피스(HWP·HWPX), Word, PowerPoint, Excel 로 각각 열어 바꾼 글꼴(궁서)이 그대로 표시되는 것을 확인했습니다.
목차 창: 문서 형식별 개요 수준 읽기
보기 탭의 목차 단추로 왼쪽에 문서의 제목 목록을 열고, 제목을 누르면 그 문단으로 이동합니다. 제목 여부는 해당 형식의 원본 프로그램이 개요(목차)에 쓰는 정보에서 읽습니다. DOCX 는 w:outlineLvl, HWP 는 개요 문단 머리, HWPX 는 heading 의 OUTLINE 형식, ODT 는 text:h, HTML 은 h1~h6, 마크다운은 # 줄입니다. 프레젠테이션은 슬라이드마다 항목 하나를 만들고 슬라이드의 첫 번째 글 문단을 제목으로 씁니다.
1차 사용성 평가에서는 개요 정보가 없는 HWP 와 PPTX 에서 목차 단추 자체가 사라져, 기능이 있는지 알 수 없다는 문제가 제기되었습니다. 1.5.0 은 슬라이드 목록을 목차로 보여 주고, 개요 정보가 없는 쪽 단위 문서에서는 단추를 유지한 채 목차가 비어 있는 이유를 안내합니다.
저장 방식: Ctrl+S 덮어쓰기와 원본 보관
이전 판의 Ctrl+S 는 항상 다른 이름으로 저장 대화상자를 열었고, 기본 이름에 -편집 이 붙어 저장할 때마다 사본 파일이 계속 늘어났습니다. 사용성 평가에서 가장 먼저 지적된 문제여서 1.5.0 에서 다음과 같이 개선했습니다.
| 동작 | 내용 |
|---|---|
| Ctrl+S | 현재 열려 있는 파일에 바로 덮어씁니다. 그 파일을 처음 덮어쓸 때만 원본을 같은 폴더에 .bak 으로 남깁니다. |
| 다른 이름으로 저장(Ctrl+Shift+S) | 대화상자를 열고, 기본 이름은 현재 파일 이름입니다. 다른 파일로 저장하면 에이전트 대화도 새 파일로 이어집니다. |
| 대화상자를 여는 경우 | 형식이 바뀌는 저장(예: DOC 를 DOCX 로)과 복구해서 연 문서는 Ctrl+S 에서도 대화상자를 엽니다. |
| 저장 후 검증 | 저장한 파일을 다시 읽어 열리는지 확인하고, 결과를 알림 한 줄로 보여 줍니다. 저장하거나 다시 불러온 뒤에도 기존 스크롤 위치를 유지합니다. |
| 저장하지 않은 편집 | 다른 문서를 열거나 닫거나 새 문서를 만들 때 취소, 저장하지 않음, 저장 후 열기(닫기·계속) 중에서 선택할 수 있습니다. |
다른 프로그램이나 에이전트가 열린 파일을 바꾸면 다시 불러올지 묻습니다. 실행 취소로 문단을 원래대로 돌리면 그 문단의 수정됨 표시도 해제합니다.
자동 배율과 폭 맞춤
1280x900 창에서 목차 창과 에이전트 사이드바를 함께 열면 A4 쪽의 오른쪽이 잘렸습니다. 배율에 자동(기본값)과 폭 맞춤을 추가했습니다. 자동은 쪽이 문서 화면보다 넓을 때만 폭에 맞춰 100% 이하로 줄이고, 폭 맞춤은 화면이 넓으면 100% 이상으로도 확대합니다. 시트는 자동에서 100% 를 유지합니다. 창 크기나 옆 창 너비가 바뀌면 배율을 다시 맞춥니다. 평가 환경에서는 목차 창을 열면 73%, 닫으면 100% 가 되었고 폭 맞춤은 103% 였습니다.
Claude 로그인 자동 연결
Claude Code CLI 의 로그인은 출력에 코드를 붙여 넣는 수동 주소만 표시하고, 로그인 뒤 자동으로 돌아오는 주소(localhost 콜백)는 BROWSER 환경 변수의 프로그램으로만 엽니다. DocPilot 은 로그인 프로세스에 BROWSER 로 자체 실행 파일을 전달합니다. 그렇게 실행된 DocPilot 은 전달받은 주소를 파일에 기록한 뒤 기본 브라우저로 열고 바로 종료합니다. 6초 안에 주소가 오지 않으면 수동 주소를 엽니다. CLI 2.1.312 에서 콜백 주소를 받는 것까지 확인했고, 로그인 완료까지는 검증하지 않았습니다.
Word 문서(DOCX) 줄 높이와 글자 간격 보정
Word 의 배수 줄 간격에서 한 줄의 높이는 그 줄에 놓인 글 조각의 글꼴 줄 높이 가운데 가장 큰 값으로 정해집니다. 기존 화면 렌더링은 문단의 첫 글꼴 하나로 줄 높이를 정하고 있어, 한 문단에 궁서와 맑은 고딕이 섞이면 저장 뒤 문단 전체의 줄 높이가 줄어드는 문제가 있었습니다(1차 평가의 심각도 높음 문제). 글 조각마다 해당 글꼴의 줄 높이를 적용하도록 수정했습니다.
| 줄 | Word 기준 PDF | 1.5.0 화면 |
|---|---|---|
| 궁서만 있는 줄 | 22.7px | 22.9px |
| 맑은 고딕이 섞인 줄 | 29.3px | 29.2px |
그 밖에 Word 기준 PDF 와 쪽 단위로 비교하며 고친 것은 다음과 같습니다.
한글과 영문·숫자 사이 자동 간격은 w:autoSpaceDE·w:autoSpaceDN(기본 켜짐)을 읽어 한중일 글자와 영문·숫자 사이에 글자 크기의 1/4 을 더합니다. 기준 PDF 에서 11pt 글자의 간격이 2.7pt 였습니다.
호환 모드 14 이하의 문단 간격은 앞 문단의 뒤 간격과 이 문단의 앞 간격 중 큰 쪽만 적용합니다. Word COM 으로 두 값을 바꿔 가며 확인했고, 호환 모드 15 이상은 두 값을 더합니다.
설치된 글꼴 가운데 이름에 Medium·Bold 가 포함된 글꼴은 굵게를 더하지 않습니다.
여는 괄호와 가운뎃점 앞뒤에서 한 글자 단위로 줄을 바꿉니다.
표는 머리 행만 쪽 아래에 남으면 표와 표 제목을 함께 다음 쪽으로 넘깁니다. 아울러 세로 병합 칸의 아래선 두께와 표 칸 글 너비를 바로잡았습니다.
| 시료 | 쪽 수(기준) | 쪽 상관 평균(전 → 후) |
|---|---|---|
| 협의 의견서 | 83 → 82(82) | 0.460 → 0.564 |
| 특허 검토 의견서 | 28(27) | 0.297 → 0.648 |
쪽 상관값은 1.4.0 글과 같은 방식으로, 기준 PDF 를 96dpi 이미지로 바꿔 화면 렌더와 쪽마다 밝기 상관을 구한 값입니다. 협의 의견서는 0.95 이상인 쪽이 0쪽에서 4쪽으로, 0.9 이상인 쪽이 1쪽에서 10쪽으로 늘었습니다. 다른 DOCX 시료와 PPTX·한글 시료의 점수는 바뀌지 않았습니다.
알려진 한계. 두 시료 모두 평균이 0.95 기준에 크게 못 미칩니다. 특허 검토 의견서는 쪽 수가 아직 기준보다 한 쪽 많습니다. 저장하기 전 편집 화면에서는 글꼴을 바꾼 줄도 문단의 원래 줄 높이를 하한으로 유지해, 저장 뒤 화면과 한 줄 정도 차이가 날 수 있습니다.
출시 전 사용성 평가 결과
실제 앱을 격리한 WebView2 프로필로 실행하고 Chrome DevTools Protocol 로 조작하며, 시료 문서의 사본으로 열기, 글꼴 바꾸기, 저장, 목차 이동 같은 과제를 수행했습니다. 평가자는 1명이며, 1차에서 찾은 문제와 2차 결과는 다음과 같습니다.
| 문제 | 심각도 | 1.5.0 처리 |
|---|---|---|
| 글꼴이 섞인 DOCX 문단의 줄 높이가 저장 뒤 줄어듦 | 높음 | 글 조각별 줄 높이 |
| Ctrl+S 가 항상 다른 이름으로 저장, 사본 누적 | 중간 | 덮어쓰기 + 원본 보관 |
| 사본으로 저장한 뒤 에이전트 작업이 새로 갈라짐 | 중간 | 새 파일로 대화 이어짐 |
| 좁은 창에서 쪽 오른쪽이 잘림 | 중간 | 자동 배율 |
| 개요 없는 HWP·PPTX 에서 목차 단추가 사라짐 | 낮음 | 슬라이드 목차·안내 문구 |
| 저장하지 않은 편집이 있을 때 저장 후 열기 없음 | 낮음 | 저장 후 열기·닫기·계속 |
| 실행 취소로 되돌려도 수정됨 표시 유지 | 낮음 | 되돌린 문단 표시 해제 |
| 목록에 없는 글자 크기(13pt 등)는 크기 칸에 숫자 대신 "크기" 로 표시 | 낮음 | 임시 항목으로 표시 |
| 문서에 쓰인 글꼴과 없는 글꼴을 구분하기 어려움 | 낮음 | 문서 글꼴 묶음·표시·알림 |
| 코멘트 단추가 옆 창에 걸침 | 낮음 | 문서 화면 안으로 제한 |
2차 평가에서 10건 모두 해결된 것을 확인했습니다. 2차 도중 저장 알림이 원본 보관 알림을 가리고, 긴 경로가 창 밖으로 잘리고, 저장 뒤 코멘트 단추가 남는 문제가 새로 발견되어 함께 수정했습니다. 영어 화면은 1.4.0 에서 만든 점검 스크립트로 화면에 남은 한글이 0건인 것을 확인했습니다.
남은 관찰 사항. 너비 1280px 창에서 목차 창과 에이전트 사이드바를 함께 열면 슬라이드가 47% 까지 작아집니다. 저장 알림이 에이전트 입력창을 덮고, 슬라이드 목차는 제목 틀이 비어 있으면 날짜 같은 첫 번째 글을 제목으로 보여 줍니다. 링크 열기, Claude 로그인 완료, HWPX 글꼴 바꾸기, 한컴오피스에서 저장한 HWP 열기는 이번 평가에서 검증하지 않았습니다.
남은 과제
좁은 창의 슬라이드 배율과 알림 위치 같은 남은 관찰 사항은 다음 평가에서 다시 확인할 예정입니다.
이 업데이트 소식의 정본은 DocPilot 소개 사이트에 있습니다. 소개 사이트의 업데이트 소식 보기