RELEASE NOTES
UPWISE Chat for QGIS
QGIS 안에서 Claude Code 세션에 붙는 채팅 도크입니다. 아래는 버전마다 무엇이 바뀌었는지, 그리고 어느 기록이 뒤에 정정되었는지를 적은 목록입니다.
내용 정본은 배포물에 들어 있는 CHANGELOG 이고, 이 면은 그것을 한국어로 옮긴 것입니다. 버전 번호와 측정 수치는 원문 표기를 그대로 둡니다.
플러그인 저장소가 제공하는 버전
0.6.2 experimental
버전 색인
0.6.2
현재 배포본도크의 읽기 두 곳이 틀려 있었고, 둘 다 같은 방식으로 틀렸다. 필드를 그것이 아닌 것으로 읽었다. 사용량 카드는 누적값을 더해 왔고, 사용자가 거절한 도구는 실패한 도구로 보고됐다.
- 사용량 카드가 비용을 더는 과대하게 적지 않는다. result.total_cost_usd 는 그 턴의 비용이 아니라 그때까지의 세션 비용이다. 한 세션의 녹화에서 result 세 줄이 0.471981, 0.489733, 0.501717 을 싣고 modelUsage 의 토큰 수도 같이 누적된다. 카드는 그것을 각각 더해 왔으므로 여러 턴의 대화가 높게 읽혔다(측정한 세션에서 실제의 2.92배). 이제 카드는 도는 세션의 최신값을 쥐고, 세션이 바뀔 때만 직전 값을 이월 합계로 접는다. 그래서 '이번 대화 누적' 이라는 문구가 백엔드 재시작을 건너도 뜻을 지킨다. 세션 경계는 세션 id 에서, 그리고 값이 떨어지는 것에서 읽는다. 세션 누적은 내려갈 수 없기 때문이다.
- 사용자가 승인하지 않은 도구는 실패가 아니라 거부로 읽힌다. CLI 는 그 경우를 user 줄 자체의 tool_result_meta[].non_execution_kind 에 표시하는데, 도구가 실제로 돌았을 때는 그 키가 null 이 아니라 아예 없다. 두 결말 모두 is_error 로 도착하므로 카드는 둘 다 '오류' 라고 적어 왔다. 도구 카드가 이제 앞의 것을 '사용자 거부', 뒤의 것을 '도구 오류' 라고 말한다. 표시만 바뀐 것이다. 턴이 쥐는 거부 기록, 승인 바, 세션 녹화는 건드리지 않았다.
- task_started 와 task_notification 이 아는 이벤트가 되었다. 둘 다 system subtype 으로 관측되었고 둘 다 미지 카운터로 떨어지고 있었는데, '미지 이벤트 0' 을 단정하는 어떤 검사든 그것을 회귀로 읽었을 것이다. 이제 아는 목록에 있다. 0.6.1 이 command_lifecycle 과 control_response 에 준 것과 같은 종류의 승격인데, 그 둘은 이 목록의 항목이 아니라 1급 최상위 종류가 되었다.
0.6.1
턴이 도는 동안의 입력. 도크가 턴 중에 보낸 메시지를 Claude Code 대화형 세션과 같은 방식으로 다룬다. 전송키는 큐에 넣고, Esc 는 멈추고, Ctrl+Shift+Enter 는 기다리는 것을 지금 보내며, 첫 줄에서 Up 은 대기 메시지를 되가져온다. 큐는 CLI 자신의 명령 큐이고 플러그인은 따로 큐를 두지 않는다.
- 큐잉을 CLI 에 위임했다. 도크는 턴이 도는 동안 입력을 거부했었다. 이제 사용자 메시지마다 uuid 를 찍어 들어오는 대로 CLI 에 쓴다. CLI 의 명령 큐가 그것을 쥐고, command_lifecycle 이벤트(queued, started, completed, cancelled)와 result.user_message_uuids 가 아직 기다리는 것이 무엇인지 도크에 알려준다. 진행 표시가 대기 건수를 읽고, 그 건수를 단 바는 기다리는 것이 있을 때만 보인다. UI 안의 큐도 검토했지만, 스트림 녹화가 uuid 를 단 메시지는 CLI 가 이미 큐에 넣는다는 것을 보여준 뒤 접었다. 우리 직렬화기가 uuid 를 한 번도 보내지 않았던 것이 큐가 보이지 않았던 이유다.
- 멈추기. Esc 와 취소 버튼. 버튼은 CLI 프로세스 트리를 죽이고 --resume 으로 다시 띄웠었다. 이제 plain interrupt 제어 요청을 보낸다. 턴은 멈추고 프로세스와 세션은 남으며, 초안은 입력창에 남고, 대기 메시지는 CLI 의 큐에 그대로 두는데 우리 녹화에서는 그것이 다음에 돌았다. 대화형 세션이 Esc 에서 하는 것과 같다. CLI 스키마는 interrupt 가 대기 메시지를 대신 떨어뜨릴 수 있는 창 하나를 적어 두고 있다. 세션의 첫 명령이 시작되기 전인데, 그 창은 관측하지 않았다. 입력창의 Esc 는 턴이 도는 동안 같은 일을 하고, 그 밖에는 그대로 통과시킨다. 재시작 경로는 interrupt 능력을 광고하지 않는 CLI 나 요청을 쓸 수 없을 때의 대비책으로 남는다.
- 지금 보내기. Ctrl+Shift+Enter. 초안을 먼저 큐에 넣고, 그다음 가장 오래 기다린 메시지를 지목한 send_now 가 붙은 interrupt 요청이 나간다. 턴을 멈출지, 도는 작업을 백그라운드로 옮겨 같은 턴에서 전달할지는 CLI 가 정하고 영수증에 적는다. stopped 는 글만 쓰는 턴에서 관측됐고, delivering 은 스키마에서 구현했으며 아직 본 적이 없다. send_now 능력이 없으면 도크는 plain interrupt 뒤 영수증이 오면 보내는 방식으로 물러난다.
- 되가져오기. 첫 줄에서 Up, 또는 대기 바의 버튼. 대기 메시지를 uuid 하나씩 cancel_async_message 로 취소하고 그 글을 입력창에 한 줄씩, 초안 앞에 되돌려 놓는다. 기다리는 것이 없으면 Up 은 명령 이력으로 넘어간다. CLI 가 이미 시작한 메시지는 계속 돌고, 그 말풍선은 되돌아오며 공지가 그렇게 말한다.
- 흐린 말풍선. 보낸 메시지는 started 수명 이벤트가 오기 전까지 흐리게 그려져, Claude 가 아직 시작하지 않은 것이 한눈에 보인다. 대비는 두 토큰 집합 모두에서 4.5 이상을 유지하고, 도크의 최소 폭은 바뀌지 않았다.
- claude 2.1.310 에 대해 측정했다. 위 동작은 스트림 녹화에 근거한다. plain interrupt 는 대기 메시지를 다음에 돌도록 남긴다. cancel_queued 는 그것을 취소하고 턴을 멈춘다. send_now 는 글만 쓰는 턴에서 stopped 를 돌려주었다. 도구 호출 중의 interrupt 는 합성된 user-rejected tool_result 와 terminal_reason: aborted_tools 를 내고 세션은 유지됐다. 관측하지 못해 열어 둔 것이 넷이다. 도구가 띄운 자식 프로세스를 CLI 가 죽이는지, 대화형 세션 문서가 말하는 대로 stream-json 모드에서도 대기 메시지가 도구 경계에서 턴 중간에 전달되는지, 영수증 값 delivering 과 nothing_waiting, 그리고 둘 이상이 기다릴 때 send_now 로 지목한 메시지가 실제로 앞당겨지는지. 하나가 기다리는 상황에서는 녹화된 send_now 와 plain interrupt 가 같게 움직였다. 둘 다 턴이 멈추고 기다리던 메시지가 다음에 돌았다.
0.6.0
CLI 세션 아래에 두 번째 백엔드를 위한 이음면, data.go.kr 카탈로그가 끝나는 지점의 포털 검색 링크, 그리고 도크 하단 내비게이션 아래의 차트 두 개. 이 릴리스가 출하되는 저장소는 공개로 다시 시작되었다.
- 백엔드 어댑터 층을 두면서 동작은 같게 유지했다. 도크가 구동하는 세션이 이제 인터페이스 뒤에 앉는다. backend/adapter.py 가 그것을 선언하고, backend/adapter_claude.py 가 이미 있던 Claude Code CLI 경로에 위임하며, backend/adapter_registry.py 가 하나를 고른다. Claude 어댑터는 재구현하지 않고 전달하며, 아무것도 움직이지 않았다는 주장은 이 설명이 아니라 동등성 검사가 떠받친다. argv 조합 48가지, 환경 블록, 시작 게이트 10개, 그리고 와이어 프로토콜과 상태 기계의 재생이 이 층이 없던 코드와 같은 다이제스트를 돌려준다(검사 42건, 실패 0건). 두 번째 백엔드인 Codex CLI 자리는 이번 릴리스에서 비어 있다.
- 벤더링된 코드 실행 핸들러가 exec() 를 부르는 대신 거부한다. execute_code 는 0.3.0 이후 노출된 적이 없다. 차단 명령 목록이 그것을 갖고 있고 디스패처가 핸들러를 돌리기 전에 이름으로 거부하므로, 벤더링된 본문은 닿을 수 없는 코드였다. 그 본문이 이제 디스패처 자신의 문구를 담은 구조화된 거부가 되었다. plugins.qgis.org 의 업로드 검사가 요청이 거기 닿을 수 있는지와 무관하게 exec() 호출을 차단 사유로 취급하기 때문이다. 시그니처와 데코레이터, 그 주변 파일은 그대로 두어 상류 대비 diff 가 기계적으로 남는다. 이것은 벤더링 사본에 대한 열한 번째 기록된 변경이고, VENDOR.md 에 기록된 상류 다이제스트 19개는 움직이지 않는다. 벤더링 트리에 대한 일관성 게이트는 검사 111건과 실패 0건을 보고하며, 이 변경을 되돌린 사본에서는 실패한다.
- 등록 메타데이터. metadata.txt 가 허용 목록 밖의 값을 갖고 있던 category 를 버리고 tags 와 짧은 changelog 블록을 얻는다. about 텍스트는 이것이 어디에서 측정되었는지를 적는다. 개발과 시험은 Windows 10 과 11, QGIS 3.44 에서 돌았고, Linux 와 macOS 는 시험하지 않았으며, 멈춘 CLI 프로세스 트리를 죽이는 한 경로는 Windows 전용으로 작성되었다.
- data.go.kr, 카탈로그가 끝나는 지점의 포털 검색 링크. 행이 하나도 없이 돌아온 데이터셋 목록이 이제 포털 자신의 검색 페이지로 가는 링크 하나를 담은 portal_search 블록을 함께 갖는다. 그 주소의 세 부분인 기본 URL, 고정 파라미터, 질의 파라미터 이름은 함께 배포되는 카탈로그 선언에서 온다. 서버는 링크를 만들고 가져오지는 않으며, 포털의 robots.txt 가 금지한 목록 페이지는 방문하지 않는다. 링크는 빈 결과에만 실린다. 빈 결과가 바로 함께 배포되는 카탈로그에 없다는 것의 모습이기 때문이고, 후보가 있는 호출은 이 고지에 바이트를 쓰지 않는다. 질의 파라미터 이름은 측정한 것이 아니라 선언한 것이다. 브라우저에서 링크를 한 번 열어 보는 것이 그것을 확정하는 방법이고, 카탈로그 주석에 그렇게 적었다. 이와 관련한 수집 검사는 157건에 실패 0건이다.
- 도크 안의 차트 두 개. 사용량 카드는 스트림의 rate limit 이벤트가 담은 5시간·7일 이용률을, result 이벤트에서 합산한 세션 비용 옆에 그린다. 수집 카드는 프로파일 작업 폴더 아래 사이드카 파일에서 provider 별 수집 실행 횟수를 센다. 두 카드 모두 의존성을 더하지 않는다. 막대는 QPainter 채움이고 글자는 QLabel 이며, 두 카드 파일 어느 쪽도 색 값을 하드코딩하지 않으므로 카드는 이미 있던 테마 토큰에서 색을 가져온다. 이번 회차의 대비 쌍 14개는 글자가 6.256 이상, 장식이 3.266 으로 나온다(검사 29건, 실패 0건).
- 하단 내비게이션. 입력 아래의 한 줄이 도크가 무엇을 보여줄지 고른다. 채팅, 키 패널, 또는 차트 두 개를 담은 통계 패널이다. 통계 패널은 기본으로 닫혀 있고, 닫혀 있는 동안이 아니라 열릴 때 수집 사이드카를 다시 읽는다(검사 27건, 실패 0건). 그 줄의 떠 있는 처리는 디자인 참조에 대한 근사이고 일치는 아니다.
- 섹션 제목이 잘리는 대신 줄바꿈한다. 본문 뷰포트보다 넓은 접힌 섹션 제목은 전에는 꼬리를 잃었다. 제목이 이제 여러 줄로 나뉘고, 가장 좁은 도크 폭에서 뷰포트보다 넓게 측정된 자식이 2개에서 0개로 간다.
- 기록된 테스트 fixture 가 더는 로컬 계정 이름을 담지 않는다. 기록된 스트림 fixture 네 개가 개발자 계정 이름을 4가지 표기로 26곳에 갖고 있었다. 그것들을 교체했고, 이 fixture 를 쓰는 생성기 두 개도 이제 같은 치환을 적용하므로 재생성해도 함께 적용된다.
- 저장소 이력이 다시 시작되었다. 이 릴리스는 이력이 단일 루트 커밋에서 시작하는 공개 저장소에서 출하된다. 이전 이력은 비공개 아카이브 저장소와 로컬 번들에 보관한다.
0.5.4
2026-10-19 같은 라이브 세션에서 보고된 UI 수정 1건. 아이콘에 글자를 넣은 것은 좋은데 글자끼리 붙어 보기 안 좋다는 보고였다.
- 헤더의 네 단어가 서로 맞붙고 그중 두 단어는 한 덩어리로 읽혔다. 글자가 겹친 것은 아니다. 각 단어는 자기 칸 안에 있고 칸마다 자기 라벨을 자른다. 없던 것은 단어 사이의 공백이다. 네 칸이 액션 영역에서 0-24, 24-57, 57-94, 94-144 로 경계를 맞대고 있어, 한 단어의 마지막 획과 다음 단어의 첫 획 사이에 배경 픽셀이 들어갈 자리가 아예 없었다. 다크 테마에서 x=44 부터 x=72 까지 이어진 잉크가 x=57 의 칸 경계를 넘었고, 그래서 new 와 save 가 한 모양으로 그려졌다. 나머지 두 간격은 배경 픽셀이 하나씩이었다.
- 간격을 벌릴 수 있는 지점은 세 곳이었다. 네 칸을 담는 레이아웃의 간격, 칸 안쪽의 좌우 여백, 캡션 라벨 자체의 좌우 패딩. 셋 모두 인접 캡션의 텍스트 상자 사이 간격이라는 한 기준으로 측정했고, 세 방식 다 그 간격을 고정 픽셀로 정하므로 글꼴에 따라 달라지지 않았다. 두 글꼴 계열이 같은 값을 돌려주었다.
- 패딩 3px 은 간격 6px 을 주면서 최소 도크 폭을 그대로 둔다. 레이아웃 간격 6px 은 같은 6px 간격에 최소 도크 폭 18px 을, 칸 여백 3px 은 24px 을 쓴다. 패딩만 비용이 없는 이유는 캡션 라벨이 1px 의 최소 폭을 가지고 있어서다. 그 값이 레이아웃이 보장해야 하는 몫을 고정하므로, 패딩은 선호 폭에만 얹히고 최소 폭에는 닿지 않는다. 최소 도크 폭 게이트는 480px 이고, 게이트가 직접 재는 계열에서 도크가 쓰는 값은 341px 이다. 이 수정은 그 여유를 전혀 쓰지 않는다.
- 비용은 폭이 아니라 잘림이다. 패딩이 캡션의 선호 폭을 6px 씩 올리므로, 캡션이 글자의 마지막 열을 잃기 시작하는 도크 폭도 함께 올라간다. 측정한 폭 격자에서 0.5.3 은 480px 에서 깨끗했고 460px 에서 처음 잘렸으며, 0.5.4 는 520px 에서 깨끗하고 480px 에서 처음 잘린다. 480px 에서는 네 단어가 모두 선호 폭보다 2~3px 부족하다. 그 구간의 격자 간격이 20px 과 40px 이라 이 값들은 정확한 시작점이 아니라 구간이다. 잘림이 시작되는 지점이 한 칸 올라갔을 뿐 동작 자체는 바뀌지 않았다. 이 지점을 올리지 않는 선택은 레이아웃 간격뿐이고, 그쪽은 대신 폭 여유 18px 을 쓴다.
- 단어 자체와 순서, 색 토큰, 아이콘 아래라는 위치는 모두 그대로이고 새 색은 넣지 않았다. 버튼은 아이콘만 유지한다. 배치된 geometry 를 읽어 인접 캡션이 6px 보다 가까워지면 실패하는 검사를 추가했으므로, 이번에 고친 상태가 조용히 되돌아오지는 않는다.
0.5.3
2026-10-19 실제 QGIS 세션에서 나온 UI 수정 2건.
- 테마와 모델 드롭다운의 목록을 읽을 수 없었다. 두 드롭다운이 여는 팝업 목록에서 현재 항목을 뺀 모든 항목의 글자가 #f0f0f0 위에 #cbd5e1 로 그려졌고, 대비는 1.30 이었다. WCAG 2.x 가 본문 글자에 요구하는 값은 4.5 다. 다크 테마만의 문제가 아니었다. 라이트 테마와 시스템 테마가 같은 두 색을 냈고(두 모드에서 함께 측정한 모델 드롭다운은 픽셀 수까지 같았다), 다크 테마는 팝업에 아예 닿지 못해 어두운 도크가 밝은 회색 목록을 열었다. 현재 항목만 강조 채움과 네이비 글자로 읽을 수 있었다(9.22).
- 원인은 둘이었다. 도크 스타일시트에는 그 팝업을 지목할 규칙이 없다. 목록은 도크의 위젯 트리가 아니라 콤보박스가 소유한 별도 창이고, 이 프로젝트의 스타일시트는 객체 이름과 속성 선택자만 쓰며 자손 선택자는 쓰지 않는다. 그래서 목록의 표면은 사용자가 쓰는 Qt 스타일에서 왔다. 글자색은 콤보박스 자신의 color 선언에서 왔는데, Qt 는 이 값을 자식 위젯으로 상속시키고 항목을 그릴 때 위젯 팔레트보다 우선한다.
- 글자색은 우리가 고를 수 있는 것이 아니었다. 가능한 모든 재지정 지점을 조건 격자로 훑었다. 목록의 팔레트, 목록 자신의 스타일시트(객체 이름·타입·전체 선택자와 ::item 가상 요소 포함), 팝업 프레임 자신의 스타일시트, 콤보박스에 건 자손 선택자. 어느 경우에도 그려진 글자색이 바뀌지 않았다. 유일한 손잡이는 콤보박스 자신의 color 이고, 그 값은 콤보박스가 네이비 헤더 위에 앉아 있으므로 밝게 두어야 한다.
- 그래서 표면을 산술로 정했다. #cbd5e1 글자의 상대 휘도는 0.6572 이므로, 4.5 를 넘기는 표면은 0.1072 이하여야 한다. 어두워야 한다는 뜻이다. 흰색과 네이비 양쪽에서 4.5 를 넘기는 단일 글자색은 없다(앞쪽은 휘도 0.1833 이하, 뒤쪽은 0.2164 이상을 요구한다). 그래서 목록 표면을 두 테마 모두 헤더 네이비로 두었고, 팔레트와 목록 자신의 스타일시트로 지정했다. 네이비 컨트롤에서 떨어지는 목록이 이제 같은 네이비다. 측정 대비는 나머지 항목이 11.946, 현재 항목이 9.218 이다. 다크 테마에서는 그 네이비가 본문 표면이 이미 쓰는 값이고, 본문과 어긋나게 된 쪽은 라이트 테마다. 새 색은 없다. 표면은 헤더 토큰, 글자는 상태 칩 토큰이고, 현재 항목은 열린 콤보박스가 이미 쓰던 강조색과 네이비 조합을 유지한다.
- 헤더의 네 아이콘이 각각 단어를 하나씩 갖게 되었다. api, new, save, delete. 0.4.2 이후로 아이콘만 두고 뜻이 전해지기를 기대했는데 실제 사용에서는 전해지지 않았다. 아이콘 교체는 0.5.1 에서 이미 배제되었다. 방패 글리프가 널 아이콘으로 해석되어 최소 도크 폭을 495px 로 밀어 올렸기 때문이다.
- 각 단어는 버튼 자신의 텍스트가 아니라 아이콘 아래의 별도 라벨이다. 새 대화 버튼과 비우기 버튼의 텍스트는 두 번 누르기 확인이 걸려 있는 동안 확인 문장으로 바뀌므로, 그 텍스트를 보여주면 한순간의 상태가 헤더 폭을 정하게 된다. 바뀌지 않는 라벨은 그럴 수 없다. 버튼은 아이콘만 유지하고, 접근성 이름과 툴팁에는 한국어 전체 이름을 그대로 둔다.
- 캡션은 압축을 허용했다. 연결 라벨과 상태 라벨이 이미 받는 처리와 같고, 그래서 최소 도크 폭에 아무것도 더하지 않는다. 네 가지 헤더·배지 상태 전부에서 측정값 341px 로 480px 한계 아래에 남는다. 실제 도크 폭에서는 라틴 글리프를 잴 수 있는 등록 글꼴 계열에서 각 캡션이 자기 텍스트 폭으로 배치된다. 화면 밖 기본 글꼴 계열은 모든 글리프를 17px 로 채우고 자르므로 캡션을 판정할 수 없다. 접힌 헤더는 8px 높아진다. 단어를 아이콘 옆에 두는 배치는 측정 후 버렸다. 압축하는 캡션으로도 채택안보다 4px 더 들고(345 대 341), 압축하지 않는 캡션으로는 등록 글꼴 계열에서 한계까지 여유가 4px 뿐인데, 0.5.1 에서 7px 여유도 이미 너무 빡빡하다고 판단했다.
0.5.2
벤더링된 QGIS 측 서버를 상류 qgis_mcp_plugin 0.15.1 에 맞춘다.
- 벤더링된 상류가 0.15.0 에서 0.15.1 로 올라간다. 두 릴리스 사이에 바뀐 파일은 벤더링된 19개 중 하나인 mcpserver/handlers/connections.py 다(16,839 바이트에서 17,504 바이트). 상류의 수정은 add_layer_from_connection 에 있다. OGR 이 아닌 provider 에 대해 테이블의 geometry 컬럼을 읽어 primary key 와 함께 데이터 소스 URI 에 넣는다. tableUri() 가 geometry 컬럼을 적지 않아 postgres provider 가 geometry 없는 테이블로 읽었기 때문이다(상류 이슈 #53). 툴 시그니처·import·툴 스키마는 바뀌지 않아 qgis_tools.json 의 78개 툴 스키마는 그대로다. 나머지 18개 파일은 두 릴리스에서 바이트 단위로 같다. UPWISE 의 수정 지점 10곳은 영향이 없다. 그중 어느 것도 이 파일에 있지 않고, 이 파일은 모든 벤더링 파일이 갖는 출처 헤더만 갖고 있다. mcpserver/VENDOR.md 는 새 상류 다이제스트로 재생성했다.
- 바뀐 핸들러 add_layer_from_connection 은 노출된 78개 툴에 들어 있지 않고 내장 서버가 이름으로 거부한다. 그래서 이 플러그인을 통해 닿을 수 있는 동작은 하나도 바뀌지 않는다. 벤더링 사본이 상류를 따라간 것뿐이다.
정정
- 아래 0.5.1 항목은 키 아이콘이 방패로 바뀐다고 적었다. 그 변경은 적용되었다가 0.5.1 출하 전에 되돌려졌다. 방패(SP_VistaShield)는 기준 장비의 모든 위젯 스타일에서 널 아이콘으로 해석되고, 널 아이콘을 가진 아이콘 전용 버튼은 전체 텍스트 라벨로 되돌아가며, 그 결과 최소 도크 폭이 480px 한계를 넘어 495px 로 올라갔다. 0.5.1 은 0.5.0 과 같은, 네트워크 드라이브에서 빌려온 글리프로 출하되었고 키 아이콘의 가독성은 여전히 미해결이다. 0.5.1 본문은 출하 당시 그대로 둔다.
0.5.1
데이터셋 목록이 모델을 잘못 이끌던 두 방식을 현장에서 찾아 고치고, 화면 두 줄을 돌려준다.
- 목록이 수집할 수 없는 것을 수집할 수 없다고 말한다. 각 행이 supported 를 갖고, 지원되지 않는 행은 카탈로그에서 가져온 이유 한 문장을 함께 갖는다. 0.5.0 목록을 읽은 모델은 지원되지 않는 데이터셋을 평범한 후보로 보고 제안했다. 이제 스킬·툴 설명·서버 힌트가 모두 그런 행은 제안하지도 수집하지도 말라고 말한다. 그 행들은 의도적으로 계속 보인다. 보여주는 것은 제안하는 것이 아니다.
- 데이터셋이 아직 없는 provider 가 목록에서 사라지지 않는다. provider 목록을 질의가 우연히 맞춘 행이 아니라 함께 배포되는 선언에서 가져오므로, data.go.kr 이 등록 전까지 키 상태와 데이터셋 수 0 으로 나타난다. 키가 설정된 provider 의 데이터셋 수가 0 이면 키가 없다는 뜻으로 읽히는 대신 등록 영역을 가리킨다.
- 프리셋 줄과 펼침 영역이 각각 한 줄이 되었고, 펼침 영역 높이는 225px 에서 133px 로 줄었다. 테마와 모델 세그먼트는 드롭다운이 되어, 세그먼트가 담을 수 없던 폭 안에서 라벨·툴팁·값·지속성을 유지한다.
- 더 알아보기 쉬운 키 아이콘. 헤더 아이콘에는 텍스트 라벨을 두지 않는다. 480px 한계를 기준으로 재면 아이콘 옆 한 글자 라벨은 최소 도크 폭 561px, 아이콘 아래 캡션은 481px 을 쓴다. 그 네 버튼이 도크가 얼마나 좁아질 수 있는지 정하는 줄에 앉아 있기 때문이다. 키 아이콘은 방패가 되어, 표준 아이콘 세트에 키가 없어 빌려 쓰던 네트워크 드라이브 글리프보다 잘 읽힌다.
정정
- 위 네 번째 항목(방패 아이콘)은 0.5.1 에 실제로 출하되지 않았다. 0.5.2 의 정정을 참고하라. 본문은 출하 당시 기록으로 남겨 둔 것이다.
0.5.0
공공데이터 수집이 V-World 8개 레이어에서 3개 provider 로 넓어지고, 도크가 채팅 영역에 폭을 돌려준다.
- V-World 158개 데이터셋. 공식 2D 자료 목록을 함께 배포되는 스냅샷으로 옮겼다(WFS capabilities 문서에서 읽은 이름 150개, 실제 GetFeature 호출로 확인한 별칭 이름으로 답하는 4개, 어떤 WFS 레이어도 제공하지 않아 목록에 남기고 이유와 함께 미지원으로 표시한 4개). 모든 항목이 verified 플래그를 갖고, 최소 한 건의 feature 를 돌려준 6개만 참이다. 세 개는 오류 없이 수집을 끝내지만 시도한 영역에서 아무것도 돌려주지 않았고, 빈 응답 한 번으로는 빈 지역과 작동하지 않는 레이어를 구별할 수 없으므로 거짓으로 둔다. 데이터셋 목록은 provider·질의·limit·offset 을 받으므로 긴 카탈로그가 한 덩어리로 도착하지 않는다.
- SGIS. 토큰 인증(수집마다 교환 1회, 재시도 1회, 그다음은 구조화된 오류), 행정 경계와 인구. 측정으로 확인한 두 함정은 데이터셋 주석과 키 패널 툴팁에 적었다. low_search 는 엔드포인트마다 뜻이 다르고, SGIS 의 adm_cd 는 국가 행정구역 코드가 아니므로 V-World 의 sig_cd 에 그대로 조인하면 틀린다.
- data.go.kr 은 등록 방식. 그 포털은 자기 API 의 기계 판독 가능한 카탈로그를 내놓지 않고 API 마다 따로 승인하므로, 도크에서 하나씩 등록한다. 이름·엔드포인트·프리셋(JSON 또는 XML 표준 형태)·호출 파라미터. 기록은 QGIS 설정이 아니라 프로파일에 원자적으로 쓰이고, 서버는 재시작 없이 집어 든다. 저장은 검사하지만 멋대로 바꾸지 않는다. https 만, URL 에 질의 문자열 없음, 경로 템플릿 없음, id 충돌 없음, Encoding key 가 아닌 Decoding key.
- geometry 가 없는 결과도 올라간다. 좌표가 없는 레코드 응답은 CSV 테이블로 쓰이고 테이블 레이어로 올라간다. 모든 필드가 텍스트로 도착하므로 코드 컬럼은 선행 0 을 유지하고, 숫자 컬럼은 통계나 단계구분 스타일 전에 변환이 필요하다. 테이블을 넘길 때 도크가 그렇게 말한다.
- 선언된 응답 봉투와 큰 소리로 나는 실패. 각 데이터셋이 레코드가 어디에 있는지와 어느 필드가 오류 코드를 담는지 선언한다. 선언된 경로가 없는 응답은 성공한 빈 수집이 아니라, 실제로 찾은 최상위 키들을 적은 오류로 끝난다.
- provider 키 하나면 된다. 수집 버튼이 전에는 모든 provider 의 키를 요구했는데 이제 하나면 되고, 설정되지 않은 provider 의 데이터셋은 그 사실을 한 줄로 말한다.
- 키 처리. provider 마다 자기 키가 받는 문자 집합을 선언하므로, +, /, = 가 든 포털 키는 저장되고 오타는 여전히 저장되지 않는다. Encoding key(퍼센트 이스케이프)는 두 형태를 아직 구별할 수 있는 입력 상자에서 거부한다. 마스킹이 키 자체뿐 아니라 url 인코딩된 형태까지 덮는다.
- 헤더가 아이콘 한 줄로 접힌다. 키·새 대화·내보내기·비우기 동작이 메뉴 옆에 아이콘 버튼으로 앉고, 펼침 영역이 한 줄을 줄이며, 권한 배지는 모드 이름을 툴팁에 유지한다. 배지가 더는 도크의 최소 폭을 정하지 않는다. 긴 배지에서 최소 폭이 1085px 에서 341px 로 내려간다. 프리셋 줄도 함께 줄어든다(카드 300px 에서 168px).
- /login 이 맞는 말을 한다. 도크가 CLI 를 비대화형으로 돌리므로 여전히 가로채지만, 메시지가 항상 로그아웃 상태라고 주장하는 대신 자격 증명이 있는지에 따라 달라진다.
- 내보내기 안내문 우상단에 닫기 버튼이 생겼다.
0.4.1
0.4.0 에 대한 첫 현장 불만 한 건을 고친다. 그 릴리스가 더한 헤더 줄들이 채팅 영역을 밀어냈다.
- 헤더가 한 줄로 접힌다. 브랜드·상태 점·권한 배지·메뉴 토글만 남고, 네 개의 동작 버튼과 테마·모델 세그먼트, 연결 줄은 펼침 영역으로 들어간다(헤더 높이 272px 에서 71px). 접힌 상태인지 펼친 상태인지는 세션을 넘어 기억된다.
- 안내문도 접힌다. 상시 안내문은 안내 N건 한 줄로 접히고 누르면 펼쳐진다. 방금 발생한 안내(로그인 가드 같은 것)는 사용자가 접을 때까지 펼친 상태로 열리고, 알릴 것이 없으면 그룹 전체가 사라진다.
0.4.0
현장에서 보고된 막다른 길 하나를 닫고 사용성 네 가지를 개선한다. 모두 두 번째 장비에서의 실제 사용에서 나왔다.
- 로그인하지 않은 상태가 더는 도크를 막다른 길로 만들지 않는다. Claude Code CLI 에서 /login 을 한 번도 돌리지 않은 장비에서는 모든 턴이 Not logged in, Please run /login 으로 돌아왔고, 도크에 /login 을 입력하면 이 환경에서는 /login 을 쓸 수 없다는 답이 왔다(대화형 전용이다). 가드 세 개가 이를 덮는다. 자격 증명 파일도 API 키도 찾지 못하면 도크가 시작 시 경고하고(다른 인증 경로가 있으므로 참고용이다), Not logged in 응답이 도착할 때마다 터미널에서 할 조치를 적은 안내를 덧붙이며(CLI 자신의 문구는 유지한다), 도크에 입력된 /login 과 /logout 은 그것을 처리할 수 없는 CLI 로 보내는 대신 같은 안내로 가로챈다.
- 위아래 화살표로 보낸 메시지를 불러온다. 커서가 첫 줄에 있을 때 위 화살표는 보낸 것을 거슬러 걸어가고(연이은 중복은 접는다), 마지막 줄에서 아래 화살표는 앞으로 걸어가 마지막에는 쓰고 있던 초안을 되돌려 준다. 불러온 텍스트는 보내기 전에 고칠 수 있다.
- 모델 선택. 새 헤더 세그먼트가 사용자 자신의 Claude Code 기본값과 opus·sonnet·haiku 별칭 사이에서 고른다. 선택은 QgsSettings 에 저장되고 다음 기동부터 적용된다. 세션이 돌아가는 중에 바꾸면 바로 그 사실을 알리는 안내가 붙는다.
- 내보내기 확인문이 스스로 사라진다. 저장됨 표시줄은 8초 뒤에 없어지고, 실패 안내는 여전히 닫을 때까지 남는다.
- 처음 쓰는 사용자를 위한 더 분명한 버튼 문구. 내보내기 버튼은 대화를 내보낸다고 적고, 키 버튼은 그것이 관리하는 공공데이터 API 키를 따라 이름을 가지며, 이 키가 Claude 로그인과 무관하다는 툴팁이 붙는다. 도크 최소 폭은 316px 에서 393px 로 커지고 480px 게이트 아래에 남는다.
0.3.1
0.3.0 이 실제 작업을 하는 것을 지켜보며 찾은 결함 세 가지와 사용성 공백 하나를 고친다. 그 밖에는 바뀌지 않는다.
- 자세 W 에서 파일을 쓸 때마다 권한 표시줄이 뜨던 문제. 0.3.0 은 자세 W 에서 내장 Write 와 Edit 툴을 노출하면서 사전 승인하지 않았고, --permission-mode dontAsk 아래에서 노출되었지만 승인되지 않은 툴은 호출마다 거부된다. 실제로는 전처리 로그 하나에 거부 세 번이 났고, 모델이 폴더를 만들려고 우회를 발명했다(빈 메모리 레이어를 분할 알고리즘에 먹였다). Write 와 Edit 가 W 의 허용 목록에 들어갔고, 자세 R 과 C 는 그대로다.
- 시작 게이트가 그 부류의 결함을 잡는다. 내장 툴이 노출되었는데 허용 목록에 없으면 기동을 실패시키는 하드 게이트 항목을 더했다. ToolSearch 와 Skill 은 의도적인 예외 둘이다. 실제 세션 로그를 기준으로 재면 허용 목록 항목 없이도 통과한다(호출 9건, 거부 0건). 없는 이름을 심어 두면 게이트가 실패하므로 이 검사가 조용히 썩지 않는다.
- execute_processing 이 자기 timeout 인자를 지킨다. 브리지가 모든 긴 명령에 60초 고정 소켓 타임아웃을 썼으므로, timeout: 300 을 요청한 호출이 60초에 끊기는 동안 QGIS 는 배경에서 작업을 끝까지 돌렸다. 소켓이 이제 서버 자신의 예산(timeout 인자, 없으면 55초)에 10초 여유를 더해 기다리므로, 맨 소켓 타임아웃 대신 서버의 구조화된 취소 메시지가 도착한다. timeout 파라미터가 없는 명령은 전과 똑같이 동작한다.
- 도크 토글이 자기 툴바를 갖는다. UPWISE Chat 이 보기 > 툴바(와 툴바 우클릭 목록)에 토글 버튼 하나를 가진 전용 툴바로 나타난다. 그 목록에서 관리할 수 없던 공용 플러그인 툴바의 아이콘이던 상태를 대신한다. 플러그인을 내리면 툴바도 완전히 사라진다.
0.3.0
지도 제어가 이 배포물 밖의 어떤 것에도 의존하지 않는다. 0.2.4 까지는 사용자가 두 가지를 직접 갖춰야 했다. 포트 9876 에서 듣는 두 번째 QGIS 플러그인(qgis_mcp_plugin), 그리고 실행 시점에 GitHub 에서 브리지를 가져오는 uvx. 이 제품이 겪은 연결 결함은 전부 그 둘 중 하나에서 나왔다. 0.3.0 은 두 쪽을 모두 직접 담는다.
- 툴 실행의 QGIS 쪽이 이 플러그인 안에서 돌아간다. 소켓 서버가 upwise_chat_for_qgis/mcpserver/ 로 벤더링되어 도크가 올라올 때 시작된다. 9876 이 아니라 임의 포트에 바인딩한다. 9876 은 소켓 하나만 쥘 수 있고 그것을 가져가면 둘 다 설치한 사람의 다른 플러그인 Run MCP 버튼이 망가지기 때문이다. 실제로 받은 포트는 바인딩 뒤에 다시 읽어 브리지에 넘긴다.
- 브리지가 우리 것이고 아무것도 설치할 필요가 없다. qgis_bridge.py 는 Claude Code CLI 가 QGIS 번들 Python 으로 시작하는 표준 라이브러리 전용 단일 파일이다. uvx --from <github zip> qgis-mcp-server 를 대체하므로 실행 시점의 네트워크 가져오기도, 캐시도, mcp·pydantic 요구도 없다. 시작할 때 연결하고 ping 을 보내며 서버에 닿지 못하면 0 이 아닌 코드로 끝난다. 그래서 시작 점검의 지도 제어가 연결되었다는 말이 프로세스가 떴다는 뜻이 아니라 QGIS 가 답했다는 뜻이 되었다.
- 툴을 120개가 아니라 78개 제공한다. 브리지가 tools/list 를 소유하므로 그 자세가 실제로 돌릴 수 있는 툴만 알린다. 전에는 알린 이름 중 42개가 어느 자세의 허용 목록에도 없어서, 그중 하나를 고르면 거부 표시줄을 보려고 턴 하나를 쓰게 되었다.
- 토큰이 필요하고 차단된 이름은 서버가 거부한다. 상류의 기본값은 임의 코드 실행이 닿을 수 있는 열린 소켓이었고, 그 기본값은 여기로 이어받지 않는다. 적재마다 새 토큰을 발급한다. execute_code, execute_sql, execute_connection_sql, import_layer_to_connection, add_web_layer, reload_plugin 은 모델에게 제공되는 목록에서 걸러지는 데 그치지 않고 서버 안에서 이름으로 거부된다. 명령행 플래그는 직접 붙은 소켓 상대에게 아무 일도 하지 못하기 때문이다.
- 연결 점검이 모델 턴을 쓰지 않는다. 전에는 다른 플러그인의 버전을 물어보라고 모델에 요청하는 스킬이었고, 그 플러그인이 없는 곳에서는 알 수 없다고 보고했다. 도크가 이제 내장 서버 자신의 진단을 불러 포트·플러그인 버전·QGIS 버전·레이어 수를 출력한다.
- 256KB 가 넘는 툴 결과는 그 지점에서 잘린다. 잘린 결과는 truncated, dropped, original_bytes 와 요청을 좁히라는 힌트를 함께 갖는다. 소켓 자체는 10MB 까지 통과시키는데, 그것을 담을 수 있는 컨텍스트는 없다.
- 우클릭 복사 경로도 이제 레다크션 게이트를 지난다. 0.2.4 는 모든 클립보드 쓰기가 하나의 레다크터를 지난다고 적었다. 이 제품이 만든 복사 경로 세 개에는 참이었고, Qt 가 대화 기록 행에 스스로 붙이는 컨텍스트 메뉴에는 아니었다. 행 안에서 글자를 선택해 그 메뉴의 복사를 고르면 클립보드에 직접 쓰였고, 그 행이 그려진 뒤에 저장한 키는 레다크션이 소급되지 않으므로 그대로 나갔다. 대화 기록이 이제 우클릭 자체를 받아 자기 복사 동작을 제공하므로 그 메뉴는 나타나지 않고, 쓰기는 내보내기와 같은 레다크터를 지난다. 행 안에서 글자를 골라 복사하는 것은 그대로 된다.
이 릴리스의 제3자 코드
upwise_chat_for_qgis/mcpserver/ 의 코드는 UPWISE 의 것이 아니라 상류의 것이다. 출하 기준 Python 파일 19개, 7,222 줄이며 그중 6,932 줄이 qgis_mcp_plugin 0.15.0(상류 태그 v0.15.0, https://github.com/nkarasiak/qgis-mcp)에서 가져온 것이다. Copyright (c) Nicolas Karasiak, GPL-2.0-or-later. 남은 290 줄은 그 파일들에 더한 UPWISE 자신의 추가분이고 그 저작권 표시의 대상이 아니다. 모든 파일의 출처 헤더, 그리고 바뀐 세 파일의 변경 자체와 함께 붙인 GPLv2 2(a) 변경 고지다. 바뀌지 않은 파일에서 헤더 블록을 떼면 상류와 바이트 단위로 같다. 상류의 GPLv2 전문은 mcpserver/LICENSE.upstream 에 바이트 단위로 들어 있다(18,092 바이트). 변경 지점 10곳은 mcpserver/VENDOR.md 에 기록되어 있고, 파일마다 상류와 출하본의 SHA-256 다이제스트 두 개를 적어 두어 앞으로 상류 릴리스를 기계적으로 비교할 수 있다.
upwise_chat_for_qgis/qgis_tools.json(78개 툴 스키마)은 qgis-mcp 0.15.0 의 stdio 브리지에서 파생되었다. Copyright (c) 2025 Nicolas Karasiak, MIT. MIT 전문은 NOTICE 에 있고 해당 자산은 자기 출처 블록을 갖는다. mcpserver/exposure.py, qgis_bridge.py, backend/embedded.py 는 UPWISE 의 것이고 GPL-2.0-or-later 다.
이 플러그인은 GPLv2 또는 그 이후 버전으로 배포되며, 벤더링된 코드가 이미 그것을 허용한다. 재라이선싱은 없고 UPWISE 는 어떤 재라이선싱도 주장하지 않는다. QGIS 플러그인은 Python 소스로 배포되므로 위 모든 것의 소스가 설치한 배포물 안에 들어 있고, 그것이 GPL 의 소스 제공 의무를 여기서 충족하는 방식이다.
0.2.4
0.2.3 이 했다고 적고 하지 않은 한 가지에 대한 핫픽스. 새 동작도, 새 색도 없고, 백엔드·권한 게이트·자세 단계·키 저장·레다크션 규칙 자체도 바뀌지 않는다.
- 복사가 이제 레다크션을 지난다. 0.2.3 이 이미 그렇다고 말한 것이다. 그렇지 않았다. 아래 0.2.3 항목은 셀 복사가 보이는 것을 복사하며 그것은 레다크션을 이미 지난 텍스트라고 적었고, 0.2.3 커밋 메시지도 같은 말을 했다. 레다크션은 설계상 소급되지 않는다. 키를 저장하기 전에 그려진 행은 그 키를 그대로 두므로, 그런 행을 지키는 유일한 수단은 텍스트가 도크를 떠나기 직전의 통과다. 내보내기에는 그 통과가 있었고 복사 경로 두 개에는 없었으므로, 그런 행을 복사하면 키가 클립보드에 올라갔다. 저장된 시험 키로 0.2.3 에서 측정했을 때 셀 복사 버튼·범위 복사·시스템 클립보드가 각각 키를 한 번씩 담았고, 같은 행을 내보낸 결과에는 없었다. 모든 클립보드 쓰기가 이제 클립보드를 건드리기 직전에 같은 레다크터를 한 곳에서 지나므로, 나중에 추가되는 복사 경로도 기억해 두지 않아도 덮인다.
- 레다크션할 수 없는 복사는 복사하지 않는다. 내보내기가 이미 따르던 규칙이다. 레다크션 통과에서 예외가 나면 클립보드에 아무것도 닿지 않고, 셀 버튼은 복사됨이라고 주장하지 않으며, 도크의 안내 표시줄이 복사가 중단되었다고 말한다. 조용히 실패하면 깨끗해졌다고 믿는 텍스트를 붙여 넣게 된다.
정정
- 아래 0.2.3 항목은 쓰인 그대로 둔다. 복사에 대한 그 주장은 출하된 날에 이미 틀렸고, 그것을 고쳐 쓰면 바로잡는 것이 아니라 감추는 것이 된다.
0.2.3
0.2.2 를 쓴 뒤 사람들이 요청한 네 가지. 대화 기록에서 텍스트를 꺼내는 세 가지 방법과, 모델이 계속 하던 잘못된 추측 하나. 백엔드·권한 게이트·자세 단계·키 저장·레다크션 규칙은 바뀌지 않았다.
- 셀 하나 복사. 대화 기록의 모든 행(내 메시지, 모델 응답, 사고 블록, 툴 카드)이 우상단에 작은 복사 버튼을 갖는다. 그 행만 복사하고, 보이는 것을 복사하며 그것은 레다크션을 이미 지난 텍스트다. 툴 카드는 접혀 있든 펼쳐져 있든 제목과 전체 인자와 결과를 복사한다.
- 끌어서 범위 선택. 대화 기록을 가로질러 끌면 지나간 행들이 범위로 잡히고 Ctrl+C 나 우클릭 메뉴가 그것을 복사한다. 한 행 안에 머무는 끌기는 전과 같이 글자를 선택한다. Qt 의 글자 선택은 위젯 경계를 넘지 못하고, 대화 기록은 의도적으로 행마다 위젯 하나다(툴 카드 접기, 200행 상한, 증분 스트리밍 삽입, 하단 고정 수정). 그래서 행을 넘는 선택 단위는 행이다.
- 대화 전체 내보내기. 헤더의 내보내기 버튼이 대화 기록을 <QGIS 프로파일>/upwise_chat/workspace/exports/transcript_<session>_<time>.md 로 Markdown 으로 쓴다. 세션·시각·작업 폴더·자세를 적은 머리말, 그다음 메시지마다 한 절이고, 툴 카드는 전체 인자와 결과를 담은 접힌 details 블록으로 들어간다. 파일 대화상자는 없다. 경로는 고정이고 도크의 표시줄이 어디로 갔는지 알려 주며 폴더를 여는 버튼이 붙는다. 조립된 파일은 쓰이기 직전에 레다크터를 한 번 더 지난다. 키를 저장하기 전에 그려진 행은 제자리에서 레다크션된 적이 없고, 그러지 않으면 내보내기가 그것을 디스크로 옮기기 때문이다. 그 통과가 실패하면 아무것도 쓰이지 않는다.
- 모델이 더는 MCP 플러그인 이름을 추측하지 않는다. get_plugin_info 를 plugin_name=qgis_mcp 로 계속 불러 Plugin not found 를 받았다. 서버가 QGIS 의 설치된 플러그인 폴더 목록에서 이름을 찾으므로 식별자는 qgis_mcp_plugin 이고, QGIS MCP 는 메타데이터의 표시 이름일 뿐이다. 도크의 시스템 프롬프트가 이제 그렇게 적는다.
- 새 색은 없다. 복사 버튼과 내보내기 버튼은 0.2.2 에서 대비를 이미 측정한 토큰을 재사용하고(창 표면의 muted_fg·caption_fg, 헤더 네이비의 header_accent·chip_fg), 범위 표시는 우리 색이 아니라 플랫폼의 러버밴드다.
정정
- 위 첫 번째 항목(셀 복사가 레다크션을 지난 텍스트를 복사한다)은 출하 당시 틀렸다. 0.2.4 에서 고쳤다.
0.2.2
도크의 시각·사용성 전반을 손본다. 새 동작은 없다. 백엔드·권한 게이트·자세 단계·키 저장·레다크션은 그대로다. 바뀐 것은 도크의 모습과 필요한 공간이다.
- 도크가 다시 좁은 패널에 들어간다. 최소 폭이 694px 이었는데, 그것은 대부분의 사람이 측면 도크를 두는 폭보다 넓다. 세 가지가 그 수치를 강제하고 있었다. 작업 폴더 전체 경로가 줄어들지 않는 버튼에 앉아 있었고, 상태 칩이 브랜드·토글·배지와 한 줄을 썼고, 키 패널이 provider 마다 상태 라벨을 네 번째 그리드 열에 두었다. 경로 버튼은 이제 왼쪽에서 줄임표로 접고 전체 경로를 툴팁에 두며, 칩은 자기 줄로 옮겼고, 키 패널은 provider 마다 세 줄(이름 / 입력 칸과 버튼 / 상태)을 준다. 측정된 최소 폭은 347px 이다.
- 사용자 메시지와 모델 응답이 다르게 보인다. 사용자 메시지는 자기 글자색을 가진 색조 띠로 그려지고, 모델 응답은 QGIS 배경을 유지하며 왼쪽에 레일을 갖는다. 텍스트 블록의 줄 높이는 125% 로, 행 간격은 6px 에서 9px 로 갔고, 턴 구분선은 꺼진 이중 선 대신 1px 선이다.
- 표시줄이 얼마나 심각한지 말한다. 선행 조건·배제·오래됨·스킬 마커·자세 확인·침묵 감시 표시줄이 3px 좌측 강조를 가진 하나의 황색 표면을 공유하고, 거부 표시줄만 빨간색이다. 각 표시줄은 문장을 버튼 위 자기 줄에 두는데, 435px 도크에서는 버튼이 그 줄을 차지해 문장이 한 줄에 한 낱말씩 끊겼기 때문이다.
- 선행 조건 표시줄이 미충족과 확인 중을 구분한다. 각 항목이 자기 행에 미충족 또는 확인 중 태그를 달고, 그 값은 이미 있던 탐지 상태에서 읽는다. 항목이 셋을 넘으면 나머지는 한 줄로 접히고 전체 목록은 툴팁에 들어간다.
- 권한 배지가 색 세 개를 갖는다. 이미 말로 보고하던 세 상태에 맞춘 것이다. 그리고 헤더의 터미널 경고가 다시 보인다. 전체에 걸린 #UpwiseChatHeader QLabel 규칙이 그것을 본문과 같은 흰색으로 칠하고 있어서 강조색이 드러나지 않았다.
- 프리셋 버튼이 한 줄이 아니라 3열 격자에 앉고, 표시줄과 패널의 버튼이 최소 폭을 공유한다.
- 응답 받는 중 표시가 턴이 돌아가는 동안 보내기 버튼 옆에 나타난다. 이미 돌고 있던 1초 감시 틱이 그린다. 턴이 너무 오래 조용할 때만 나타나는 침묵 감시와는 별개다.
- 문구 정정. 수집 모드로 바꿀 때 데이터가 작업 폴더에 저장된다고 적었다. 실제로는 플러그인의 작업 공간, 즉 QGIS 프로파일 아래 upwise_chat/workspace/collected 이고, 백엔드가 도는 프로젝트 폴더가 아니다.
- 여기서 들어온 모든 색은 쓰기 전에 라이트·다크 두 테마에서 WCAG 2.x 를 기준으로 확인했다. 채움 위 글자는 임계 4.5:1, 짝 24개, 최악 측정값 6.649(#f0f0f0 위 #475569). 정보를 전하는 경계는 임계 3:1, 짝 6개, 최악 측정값 3.503(#1e1e1e 위 #64748b). 정보를 전하지 않는 컨테이너 경계는 3:1 을 요구하지 않으며 바꾸지 않았다. 카드 경계는 전과 같이 카드 채움 대비 1.178:1 이다. 디자인 토큰 표 자체는 바뀌지 않았고 새 색은 별도 층에 살기 때문에, 기존 대비 검사는 기대값을 그대로 유지했다.
0.2.1
0.2.0 이 빼놓은 키 설정 패널과 값 기반 레다크션. 그때까지 사용자는 QGIS 를 닫고 QGIS3.ini 를 손으로 고쳐야 했고, 도크는 키가 설정되지 않았다는 신호를 전혀 주지 않았다. 첫 증거가 턴 비용을 치른 뒤 툴 결과 안의 key_configured: false 였다.
- 도크 안의 비모달 키 패널. 헤더에 키 설정 토글이 있다. 함께 배포되는 레지스트리의 provider 마다 마스킹된 입력 칸(QLineEdit.Password), 저장·삭제 버튼, 저장된 길이만 보이고 글자는 보이지 않는 상태 줄을 받는다. 저장이 성공하면 입력 칸을 비운다. 위젯에 남은 값은 주인이 없는 사본이기 때문이다. 모달 대화상자와 QFileDialog 를 쓰지 않으므로 패널이 열려 있어도 QGIS 를 그대로 쓸 수 있다. 한 줄은 키가 어디에 저장되는지와 평문으로 저장된다는 사실을 적고, 다른 한 줄은 채팅 입력창에 키를 붙여 넣으면 우리가 지울 수 없는 곳에 들어간다는 사실을 적는다. 접힌 고급 영역에는 수집 서버가 이미 읽는 엔드포인트 기본 URL 재지정이 들어 있다.
- 쓰기마다 sync() 를 부른다. QgsSettings 는 메모리에 캐시하므로, 그것 없이는 수집 서버가 빈 값을 읽고 키가 설정되지 않았다고 보고한다. 저장과 삭제 모두 backend/keystore.py 를 지나고, 키 값을 만지는 모듈은 그것 하나다.
- 키가 없는 상태가 명시된 선행 조건이 되었다. 선행 조건 표시줄이 키가 설정되지 않았습니다라고 말하고 수집 버튼이 비활성화된다. 첫 턴을 보내기 전에 그렇게 된다. 키 상태는 init 이벤트 없이 읽을 수 있기 때문이다. 채팅과 읽기 전용 툴은 영향이 없다.
- 세 지점에서의 값 기반 레다크션. session_<uuid>.jsonl 에 쓰이는 것, 대화 기록에 그려지는 것(말풍선, 텍스트 블록, 툴 카드 인자와 결과, 전체 보기 임시 파일), 진단 로그에 덧붙는 것은 먼저 레다크터를 지나며 저장된 키 값과 정확히 일치하는 부분이 ***REDACTED*** 로 바뀐다. 키처럼 보이는 것을 찾지는 않는다. 오탐 하나가 대화 기록을 망치기 때문이다. 12자보다 짧은 값은 건너뛴다. 치환은 되돌릴 수 없고, 유일한 감사 흔적은 레다크션 n건 계수 줄인데 그 줄은 값을 담지 않는다. 레다크터는 도크에 살면서 백엔드에 넘겨지므로, 취소·자세 상승·작업 폴더 변경에 쓰이는 재기동을 넘어 살아남는다.
- 재기동한 백엔드가 자기 기록 경로와 진단 경로, 그리고 이어받았는지 여부를 적은 logfiles 줄을 쓴다. 자세를 바꾼 뒤 생긴 새 진단 파일이 로그를 멈춘 백엔드로 오해되지 않게 하기 위함이다.
0.2.0
범용 공공데이터 수집. 수집 프리셋은 전에 지역 실습 패키지와, 자기 수집기를 돌릴 셸에 의존하는 강의 스킬을 불렀다. 도크는 셸을 노출하지 않으므로 수집은 실제로 돌아간 적이 없다(스킬이 셸이 없다고 스스로 보고하고 키 이름만 확인했다). 이 릴리스는 수집을 플러그인 안으로 옮긴다.
- 이것은 2026-10-10 에 제품 책임자가 결정한 명세 변경이고 완화가 아니다. 설계 기록은 모노레포의 docs/2.collect_feature_design_v1.md 이고, 그것이 근거로 삼은 측정은 장부 행 V28-37, V28-38, V28-A51, V28-A52, V28-P17, V28-P18 이다.
- 네트워크 접근을 모델이 아니라 플러그인이 갖는다. 두 번째 MCP 서버 upwise_collect 가 플러그인과 함께 배포된다(collect_server.py, 표준 라이브러리만, 단일 파일, -I 로 시작). 그것이 공공 API 를 부르고 원응답을 디스크에 쓰고 병합하고 요약을 계산하고 저장 경로를 돌려준다. 모델은 함께 배포되는 레지스트리에서 데이터셋 id 와 범위를 고르고 돌아온 경로를 add_vector_layer 에 넘긴다. WebFetch 는 어느 자세에도 노출되지 않고, 모델은 URL 도 출력 경로도 넘길 수 없다. 이것을 가능하게 한 측정 하나는 손으로 쓴 표준 라이브러리 MCP stdio 서버가 이 CLI 버전에 실제로 연결되고, 하나의 --mcp-config 에 둔 두 서버가 모두 connected 로 돌아오며, 허용 목록이 서버마다 적용된다는 것이었다.
- API 키는 모델 컨텍스트에 절대 들어가지 않는다. 이것은 완화책이 아니라 설계 제약이다. 컨텍스트에 들어간 키는 동시에 모델 제공자 쪽, CLI 자신의 세션 저장소, 우리 세션 기록, 대화 기록에 저장되고 앞의 둘은 우리 손이 닿지 않는다. 세 표면 모두 더미 키를 보관하는 것이 측정되었다. 그래서 키는 QGIS3.ini 의 upwise_chat/keys/<provider> 에 살고 수집 서버가 configparser 로 그 파일을 직접 읽는다. 키는 --mcp-config 에 쓰이지 않고, argv 로 넘어가지 않고, 환경에 놓이지 않는다. 서버마다의 env 블록은 설정 경로와 키 접두사만 담는다. 서버는 모든 로그 줄, 메타데이터 사이드카, 모든 툴 결과에서 키를 마스킹한다. 읽을 수 없는 저장 값은 추측하지 않고 키 형식을 읽을 수 없었다고 보고한다.
- 세 번째 자세 C(collect)가 R 과 W 사이에 앉는다. 내장 노출은 R 과 똑같다. Write 도 Edit 도 없다. 허용 목록만 더 넓다. 수집 툴 셋에 적재 툴 셋(add_vector_layer, add_raster_layer, create_layer_group)이 더해진다. 파일 쓰기는 서버가 하므로 모델은 수집에 내장 쓰기 툴이 필요하지 않다. 허용 목록은 R 이 C 안에, C 가 W 안에 드는 전순서를 이루므로 상승 단계와 게이트 기대값이 단조로 남는다. 권한 배지는 이제 값이 셋이다. 읽기 전용 상태에서 수집 버튼을 누르면 비모달 표시줄로 먼저 묻고 --resume 으로 백엔드를 재시작한다. 아무것도 다시 보내지 않는다. 수집에는 사용자가 말해야 하는 지역과 데이터셋이 필요하기 때문이다.
- add_web_layer 가 배제 목록으로 옮겨졌다. 그것은 모델이 원격 WFS 나 WMS 레이어를 붙일 수 있게 했고 그 URL 은 QGIS 프로젝트 파일에 평문으로 저장되므로, 공유한 .qgz 가 키를 함께 실어 갔다. 키 불변식이 그 경로를 이미 닫지만, 가드는 노출 제거여야 한다. 배제 목록은 이제 이름 다섯 개이고 세 자세에서 동일하다.
- 수집 프리셋이 함께 배포되는 스킬을 가리킨다. qgis-data-collect 가 플러그인과 함께 배포되고 --plugin-dir 로 공급되므로 upwise-chat-for-qgis:qgis-data-collect 로 등록된다. 마커 [qgis-data-collect 0.2.0] 은 기존 마커 정규식에 그대로 맞는다. 스킬은 요구 사항이 아니라 편의다. 절차의 대부분이 툴 스키마에 살아 있으므로 스킬이 등록되지 않은 곳에서도 수집은 된다. 강의 과정 qgis-collect 는 입력형 슬래시 명령 경로와 마커 판정을 유지하고, 버튼만 없어졌다.
- 프리셋 상태 결함을 출하 전에 잡았다. 활성화 검사가 눌린 프리셋이 탐지된 스킬 목록에 나타날 것을 요구했고, 그 목록에는 툴킷 스킬만 들어간다. 그래서 우리 스킬을 버튼 줄에 더하면 수집 버튼이 영구히 비활성화되었을 것이고, 툴킷이 올바르게 탐지되는 환경에서 가장 확실히 그렇게 되었을 것이다. 이제 그 검사는 툴킷 프리셋에만 적용된다.
- 게이트 변경 세 가지. 게이트 4 는 심각도를 가진 서버 목록을 받는다. qgis 가 끊긴 것은 여전히 입력을 막는 하드 실패이고, upwise_collect 가 끊긴 것은 소프트다. 수집 버튼을 비활성화하고 선행 조건 표시줄에 한 줄을 더하며 입력창은 열려 있다. 채팅과 읽기는 영향이 없기 때문이다. 게이트 5 는 모든 툴을 한 숫자로 셌으므로, 세션 중간에 죽은 수집 서버가 그 수를 줄여 권한이 바뀌지 않았는데도 입력을 막았다. 드리프트 판정은 이제 세션 id, 권한 모드, 내장 툴 수를 쓰고, MCP 툴 수의 변화는 경고 줄이다. 게이트 문구를 분리해 로그를 읽는 사람이 막는 실패와 경고를 구별할 수 있게 했다.
- 수집 서버의 인터프리터 결정. 명령은 <QGIS 루트>/apps/Python312/python.exe 또는 그 형제 버전의 절대 경로이고, 쓰기 전에 -I 로 실제로 시작해 확인한다. QGIS 의 런처 bin/python3.exe 는 후보가 아니다. -I 아래에서 표준 라이브러리를 찾지 못해 즉시 끝나고, 바로 그 경로가 QGIS 가 물려주는 PYTHONEXECUTABLE 에 들어 있으므로 상속도 믿지 않는다. 어느 후보도 확인을 통과하지 못하면 수집 서버를 MCP 설정에서 아예 빼고 선행 조건 표시줄이 그렇게 말한다. 시작할 수 없는 설정을 쓰면 서버가 죽었다고 보고되기 때문이다.
- 제거한 scaffolding. PRESET_NEEDS_PACKAGE, 실습 패키지 기본 경로, package_present(), 탐지 요약의 package_* 필드 두 개가 없어졌다. 강의 수집 프리셋을 대체한 뒤 그것을 쓰는 프리셋은 없었다.
- 수집한 파일은 <QGIS 프로파일>/upwise_chat/workspace/collected/ 아래에 원본 페이지와 파생 merged.geojson, collect_meta.json 사이드카로 들어간다. 원응답은 바이트 단위로 보관되고 병합이 덮어쓰지 않는다. 쓰기는 .part 파일로 가서 완료 시 이름이 바뀌므로, 백엔드를 죽여도 끝난 것처럼 보이는 반쪽 파일이 남을 수 없다. 부분 결과는 버리지 않고 incomplete 로 표시해 보관한다. 서버는 재투영하지 않고 데이터가 도착한 좌표계를 기록한다. 한도는 50 페이지, 50MB, 120초, 세션당 수집 호출 20회다. 이 값들은 측정이 아니라 보수적인 설계 선택이다.
0.1.4
버그 수정 둘. 그중 첫째는 2026-10-10 에 제품 책임자가 결정한 의도적 명세 변경이고, 가드를 조용히 완화한 것이 아니다.
- 읽기 전용 내장 파일 툴 세 개가 두 자세 모두에서 사전 승인된다(명세 변경). Read, Glob, Grep 은 --tools 로 노출되었으나 자세 R 과 자세 W 의 --allowedTools 목록에 모두 없었다. --allowedTools 는 아무것도 막지 않는다. 사전 승인을 한다. 노출만 된 툴은 여전히 권한 요청을 띄우고, --permission-mode dontAsk 아래에서 그 요청은 decision_reason_type=mode 를 가진 거부로 돌아온다. 실제 사용에서 수집 스킬이 강의 패키지 파일을 읽으려 했고 모든 Read, Glob, Grep 호출이 거부되어 스킬이 거듭 실패했다(한 세션에서 거부된 Glob 호출 13건). 두 자세 모두 이제 그 세 이름을 정확히 --allowedTools 에 담는다. 와일드카드는 쓰지 않는다. 이 프로젝트는 와일드카드가 실제로 실행을 허가하는지 측정한 적이 없다. ToolSearch 와 Skill 은 손대지 않았고, --disallowedTools 목록은 그대로이며, Write·Edit 와 위험한 MCP 툴의 승인 경로도 그대로다. S5 하니스가 예전 기대값과 새 기대값을 나란히 기록하므로, 이 개정은 diff 에 숨지 않고 로그에 보인다.
- 스킬 마커를 응답 첫 줄이 아니라 응답 전체에서 찾는다. 판정기가 프리셋 턴의 첫 assistant 텍스트 블록의 첫 줄만 읽었다. 슬래시 명령에 먼저 무엇을 하려는지 말하면서 답하는 모델은 마커를 뒤쪽 줄에 출력하고, 그러면 도크는 스킬이 호출되었는데도 호출되지 않았다고 사용자에게 말했다. 18:20 세션에서 턴 1 은 ok=False 로 판정되었는데, 같은 턴이 마커 두 개와 툴 호출 열 개, 성공한 결과를 담고 있었다. 마커 정규식 자체는 바뀌지 않았고 re.MULTILINE 을 갖게 되어 ^ 앵커가 모든 줄의 시작에 적용되며, 입력은 턴의 전체 assistant 텍스트다(Turn.assistant_text(), 모든 텍스트 블록을 개행으로 이은 것. 툴 호출이 응답을 여러 블록으로 쪼개기 때문이다). 결과: [qgis-style 2.1.0] 처럼 줄 중간에 인용된 마커는 여전히 거부된다. 판정 범위는 그대로다. result 이벤트로 닫힌 턴만 판정한다. preset_marker 진단 행이 이제 일치한 마커와 응답 안에서의 줄 번호를 기록하므로, 앞으로의 오탐을 마커가 정말 없던 응답과 구별할 수 있다.
0.1.3
버그 수정.
- 응답이 흘러드는 동안 대화 기록이 최신 출력에 고정된 채 머문다. ChatView.sync() 가 위젯을 갱신하기 전에 스크롤 위치를 읽고 같은 호출 끝에서 setValue(maximum()) 를 불렀다. 그 시점의 스크롤 범위는 아직 예전 것이다. QScrollArea 는 내부 위젯의 LayoutRequest 뒤에야 범위를 다시 계산하고, Qt 는 그것을 다음 이벤트 루프로 미룬다. 그래서 뷰는 이전 바닥으로 스크롤했고 틱마다 더 뒤처졌으며, 사용자는 새 블록마다 스크롤바를 손으로 내려야 했다. ChatView 가 이제 _pinned 플래그를 두고 verticalScrollBar().rangeChanged 에서 내용을 따라가는데, 그 신호는 범위가 실제로 다시 계산된 뒤 발생한다. 위로 스크롤하면 고정이 풀리고(valueChanged 로 감지), 그래서 새 출력이 읽고 있는 곳에서 뷰를 끌고 가지 않으며, 바닥으로 돌아가면 고정이 복구된다. 프로그램이 스스로 부르는 setValue 는 재진입 가드로 감싸 플러그인 자신의 스크롤을 사용자 스크롤로 오해하지 않게 했다. 바닥에 있다고 보는 허용 오차는 이제 이름 있는 상수 BOTTOM_EPSILON_PX 다(4px, 이전 코드가 인라인으로 쓰던 값).
0.1.2
버그 수정.
- 물려받은 Python 환경 변수를 CLI 자식 환경에서 걷어낸다. QGIS 는 자기 Python 을 함께 배포하면서 PYTHONEXECUTABLE, PYTHONHOME, PYTHONPATH, PYTHONSTARTUP 을 자기 프로세스 환경으로 내보낸다. Claude Code CLI 는 Node 프로세스라 상관하지 않지만, CLI 가 띄우는 MCP 브리지는 uv 캐시 가상환경 안의 Python 진입점이고 같은 값을 물려받았다. PYTHONEXECUTABLE 이 QGIS 인터프리터를 가리키면 그 가상환경은 자기 pyvenv.cfg 가 아니라 QGIS 인터프리터에서 경로를 계산해 자기 site-packages 를 끝까지 더하지 않았고, 그래서 0.1.1 이 uvx 를 올바르게 찾고 캐시 항목이 온전했음에도 브리지가 import 시점에 ModuleNotFoundError: No module named 'qgis_mcp' 로 죽었다. A/B 측정이 PYTHONEXECUTABLE 을 단일 원인으로 분리했다. QGIS 환경의 132개 변수를 전부 주입하면 브리지가 죽고, PYTHON* 일곱 개를 빼면 살고, PYTHONEXECUTABLE 하나만 빼도 살고, PYTHONHOME 하나나 PYTHONPATH 하나만 빼면 살지 않았으며, 깨끗한 환경에 PYTHONEXECUTABLE 하나만 주입하면 죽었다. backend/process.py 가 이제 INHERITED_PYTHON_KEYS 상수를 통해 child_env() 에서 네 변수를 제거한다. PYTHONUTF8 과 PYTHONIOENCODING 은 파이프가 UTF-8 텍스트 모드로 돌기 때문에 의도적으로 남긴다. 실제로 제거된 키는 세션 진단 로그의 기존 env_stripped 줄에 적히며, 그 줄은 전에 (none) 이었다.
0.1.1
버그 수정.
- MCP 브리지를 위해 uvx 를 절대 경로로 결정한다. 생성된 <프로파일>/upwise_chat/qgis_mcp.json 이 command 로 맨 이름 uvx 를 담고 있었다. QGIS 프로세스의 PATH 에 uvx 가 없는 곳에서는(예를 들어 레지스트리 PATH 에 없는 Anaconda Scripts 폴더에만 uvx.exe 가 있는 설치) Claude Code CLI 가 브리지를 띄우지 못했고, system/init 이벤트가 {"name": "qgis", "status": "failed"} 를 보고했고, 시작 게이트 mcp_server_connected 가 실패했고, 도크가 입력을 막았다. backend/detect.py 가 이제 고정된 후보 순서로 런처를 찾아(QgsSettings 키 upwise_chat/uvx_path, shutil.which('uvx'), %USERPROFILE%\.local\bin\uvx.exe, %USERPROFILE%\anaconda3\Scripts\uvx.exe, %USERPROFILE%\miniconda3\Scripts\uvx.exe) 처음으로 존재하는 파일을 절대 경로로 쓴다. 탐지는 파일이 있는지만 확인하고 uvx 를 실행하지 않는다. 후보가 하나도 없으면 설정은 맨 이름을 유지하고 선행 조건 표시줄이 uvx 를 찾지 못했다고 보고한다. 결정된 경로는 세션 진단 로그(prereq_detect)에 기록된다.
0.1.0
첫 MVP 빌드. metadata.txt 에 experimental=True 로 표시했다. CHANGELOG 에는 미공개(unreleased)로 적혀 있다. metadata.txt 가 아직 email=TODO_SET_BEFORE_RELEASE 를 담고 있고, QGIS 플러그인 저장소는 공개 배포 전에 그것을 요구한다.
- 여덟 단계(S1 부터 S8)로 만들었고, 단계마다 UPWISE 모노레포에 둔 검증 하니스(scripts/06 부터 scripts/17)로 닫았다.
- S1, 플러그인 뼈대. 체크 가능한 툴바·메뉴 토글을 가진 도크 위젯, metadata.txt, 임시 아이콘. 플러그인 본체 import 는 classFactory 로 미뤘다.
- S2, 백엔드 프로세스 층. 오래 사는 Claude Code CLI 하위 프로세스(stream-json 입출력), 읽기·쓰기 작업 스레드, JSONL 세션 기록.
- S3, 프로토콜. stream-json 파서와 턴 상태 기계. 기록된 fixture 로 재생한다(하니스에서 유료 CLI 호출 없음).
- S4, 채팅 UI. 도크 배선, 스트리밍 대화 기록, 접히는 툴 카드, 거부 표시줄.
- S5, 자세 집행. 시작 게이트(CLI, 툴킷, MCP, cwd), 자세 불일치 처리, 승인 가드.
- S6, 스킬 프리셋. 툴킷 스킬 다섯 개의 프리셋 버튼, 선행 조건 표시줄, 탐지 배선.
- S7, 브랜딩. UPWISE 로고 타일과 워드마크 링크, 브랜드 팔레트 테마(라이트·다크), 플러그인 아이콘.
- S8, 패키징. packaging/build_zip.py(최상위 패키지 폴더 하나를 가진 QGIS 설치 가능 ZIP), 사용자 지정 플러그인 저장소 feed 를 위한 packaging/plugins.xml.tmpl, LICENSE(GPL v2 또는 그 이후), NOTICE(상표 고지), 이 변경 기록.
이 빌드의 알려진 한계
Qt5 만. supportsQt6 은 의도적으로 선언하지 않았다. 플러그인을 Qt 5.15 빌드에서만 적재해 보았다.
plugins.xml 이 icon 을 metadata.txt 의 패키지 상대 경로로 담는다. QGIS 플러그인 관리자는 거기에 URL 을 기대하므로, 절대 URL 이 호스팅되기 전까지 저장소 목록에서 아이콘이 그려지지 않을 수 있다.
실제 QGIS 플러그인 관리자(사용자 지정 저장소 항목)에서의 설치는 아직 해 보지 않았다. S8 하니스는 헤드리스 등가물만 확인한다(압축 해제, import, classFactory).