릴리스 이후 수정 사항

빌드번호: 1106

큰 표나 긴 코드 블록이 있는 문서를 OpenAI 임베딩 모델로 임베딩하면 문서 임베딩이 실패하던 문제를 해결했습니다. 한 번에 임베딩할 내용이 임베딩 모델의 입력 한도(8192토큰)를 넘었습니다.

이제 임베딩 API에는 최대 6000자까지만 보냅니다. 잘라 내는 것은 임베딩할 때뿐이고, 챗봇이 답변할 때는 그 부분의 내용을 모두 사용합니다.
입력 한도가 더 작은 임베딩 모델을 쓰면 EMBEDDING_MAX_INPUT_LENGTH 옵션으로 줄입니다. 자세한 사항은 EMBEDDING_MAX_INPUT_LENGTH 옵션으로 임베딩 입력 길이 설정을 참고합니다.
이미 만든 벡터 저장소는 그대로 쓸 수 있으며, 다시 임베딩하지 않습니다.

<AI | 벡터 저장소> 메뉴에서 임베딩용 AI 모델이 없을 때 <문서 추가> 링크를 클릭하면, 빈 모델 목록 대신 AI 제공자에서 임베딩 모델을 먼저 추가하라고 알려 줍니다.

일반 설정의 첫 번째 페이지에 주소가 링크로 보이지 않고 링크 태그가 글자 그대로 보이던 문제를 해결했습니다.

문서 내보내기에 첨부 파일 포함

<도구 | 내보내기> 메뉴에서 문서를 내보낼 때 문서에 연결한 첨부 파일도 함께 내보낼 수 있습니다. 문서 탭의 “1문서에 연결한 첨부 파일도 내보냅니다.” 옵션을 켭니다. 웹 뷰어에서 내려받지 못하게 숨긴 첨부 파일도 함께 내보내고, 가져올 때 숨김 설정을 그대로 되살립니다.

가져올 때는 다음과 같이 처리합니다.

같은 첨부 파일이 이미 있으면 다시 만들지 않습니다. 같은 ZIP 파일을 여러 번 가져와도 첨부 파일은 하나만 있습니다. 다만 이미 있는 첨부 파일을 가져오는 사용자가 파일 메뉴에서 볼 수 없으면 가져온 문서에 연결하지 않습니다.
새로 만드는 첨부 파일은 원래 있던 파일 디렉터리에 넣습니다. 그 디렉터리가 없으면 같은 이름으로 디렉터리를 만들고, 가져온 사용자를 디렉터리 리더로 지정합니다. 이때 상위 디렉터리는 만들지 않고 최상위에 만듭니다. 가져오는 사용자가 리더나 멤버가 아닌 디렉터리에는 넣지 않습니다. 이런 첨부 파일과 원래 디렉터리가 없던 첨부 파일은 최상위 디렉터리에 넣습니다.
가져온 문서의 웹 뷰어에서 원래 문서와 같이 첨부 파일을 내려받을 수 있습니다.

AI 도구로 비주얼 에디터 그림 넣기

AI 도구가 MCP로 비주얼 에디터의 도형 JSON을 만들어 그림 단락으로 넣을 수 있습니다. 이렇게 넣은 그림은 사람이 그린 그림처럼 비주얼 에디터로 다시 열어 고칠 수 있습니다.

도형 JSON의 형식은 get_visual_editor_spec 도구가 알려 줍니다. 좌표와 공통 규칙, 도형 종류별 속성, 그룹과 연결선, 예제가 들어 있습니다.
create_visual_image 도구로 도형 JSON을 그림으로 그립니다. 도구가 알려 주는 렌더링 페이지 주소를 브라우저로 열면, 비주얼 에디터와 같은 방식으로 그림을 그려 저장합니다. 이 주소는 로그인 없이 열 수 있고 10분 안에 한 번만 쓸 수 있습니다. 그린 그림을 add_image_element로 넣으면 도형 JSON이 함께 들어가므로 비주얼 에디터로 열 수 있습니다.
화면 캡처에 콜아웃을 붙인 그림도 그릴 수 있습니다. create_image_upload로 올린 캡처를 그림 도형으로 놓고 그 위에 콜아웃과 지시선을 얹습니다. 그림 도형에는 직접 올린 PNG, JPEG, GIF 파일만 쓸 수 있고, 위치에 왼쪽 위 좌표만 주면 그림 크기에 맞춰 넣습니다. 모자이크와 스포트라이트는 이 방식으로 그릴 수 없습니다.
그림 도형에 left, top, right, bottom을 주면 비주얼 에디터의 자르기처럼 그림의 가장자리를 잘라 보여 줍니다. 올린 원본 그림은 그대로 둡니다.
직접 만든 그림 파일과 도형 JSON을 add_image_element로 함께 넘길 수도 있습니다. 이때 문서에는 올린 그림 파일을 그대로 보여 주고, 비주얼 에디터에서 저장하면 도형 JSON으로 그림을 새로 그립니다.
이미 넣은 그림 단락의 그림을 바꿀 수 있습니다. 비주얼 에디터로 그린 그림 단락이면 get_element가 도형 JSON과 업로드 아이디를 함께 돌려줍니다. 고친 그림의 업로드 아이디를 update_element에 주면 단락 아이디와 그림 제목은 그대로 두고 그림만 바꾸므로, 이 단락을 가리키는 링크가 끊기지 않습니다.
비주얼 에디터가 열 수 없는 JSON은 거절하고, 어느 도형의 어느 값이 틀렸는지 알려 줍니다. 없는 도형 종류, 겹치는 아이디, 빠진 좌표, 없는 도형을 가리키는 연결선 같은 경우입니다.

MCP로 비주얼 에디터 그림을 넣는 과정

이 그림도 AI 도구가 MCP로 도형 JSON을 만들고 create_visual_image로 그려 넣었습니다. 비주얼 에디터로 열어 고칠 수 있습니다.

AI 도구로 비주얼 문서 편집

AI 도구가 MCP로 비주얼 문서의 페이지를 읽고, 고치고, 만들 수 있습니다. 비주얼 문서의 페이지는 비주얼 에디터가 도형 JSON을 그대로 그리므로, 그림 파일 없이 도형 JSON만 주고받습니다.

get_documents 도구가 비주얼 문서도 돌려줍니다. get_visual_pages로 페이지와 폴더 목록을, get_visual_page로 페이지의 제목, 배경색, 도형 JSON을 읽습니다.
update_visual_page로 페이지의 도형 JSON 전체와 제목, 배경색을 바꾸고, create_visual_page로 새 페이지를 만듭니다. 도형 JSON은 그림 단락과 같은 방식으로 검사합니다.
비주얼 에디터와 같이 페이지는 문서 소유자와 공동 작성자가 고칠 수 있고, 새 페이지는 문서 소유자만 만들 수 있습니다.
화면 캡처 같은 그림도 넣을 수 있습니다. create_image_upload로 PNG, JPEG, GIF 파일을 올리고, 받은 아이디를 그림 도형에 넣습니다. 그림 도형의 위치에 왼쪽 위 좌표만 주면 그림 크기에 맞춰 넣습니다. 페이지에 이미 있던 그림은 그대로 둘 수 있고, 새 그림은 직접 올린 파일만 넣을 수 있습니다. 모자이크와 스포트라이트는 새로 넣을 수 없습니다.

AI 도구가 페이지를 바꾸면 그 문서를 연 비주얼 에디터에 자동으로 반영합니다. 장 에디터와 같이 MCP 권한이 있는 사용자가 연 비주얼 에디터에서 동작합니다.

바뀐 페이지의 내용과 제목을 반영하고, 지금 보고 있는 페이지는 다시 그립니다.
저장하지 않은 수정이 있는 페이지는 덮어쓰지 않고, 다른 곳에서 바뀌었다고 알려 줍니다. 이때 저장하면 AI 도구가 바꾼 내용을 덮어씁니다.
AI 도구가 새로 만든 페이지는 새로 고침하지 않아도 페이지 목록에 나타납니다.

LiteLLM 같은 OpenAI 호환 서버 지원

AI 제공자 유형에 “1OpenAI 호환”을 추가했습니다. LiteLLM, vLLM, LM Studio처럼 OpenAI API와 같은 형식으로 요청을 받는 서버를 AI 제공자로 쓸 수 있습니다. 사내에 둔 프록시를 거쳐 여러 AI 제공자를 쓰는 경우에도 사용합니다.

서버의 URL을 입력하고, API 키는 서버가 요구할 때만 입력합니다.
사용할 모델은 서버에 설정한 이름으로 사용자 정의 AI 모델에 추가합니다. 챗봇, AI 글쓰기 등의 생성형 모델과 문서 임베딩 모델을 모두 쓸 수 있습니다.
모든 AI 제공자 화면에서 요청마다 함께 보낼 추가 헤더와 추가 요청 본문 값을 설정할 수 있습니다. 값에 ${userIp}와 ${userId}를 쓰면 요청한 사용자의 IP 주소와 아이디로 바꿔 보냅니다. 사내 프록시에서 사용자별 사용량을 집계하거나 AI 제공자의 옵션을 정할 때 씁니다.

자세한 사항은 OpenAI 호환 제공자와 추가 헤더와 추가 요청 본문 값을 참고합니다.

수정 사항

태스크 화면의 머리글에 “새로 고침” 링크를 추가했습니다. 다른 사용자가 답변이나 댓글을 달았을 때 브라우저 전체를 다시 읽지 않고 지금 보는 태스크만 다시 불러옵니다.
비주얼 에디터의 페이지 목록에서 페이지나 폴더를 오른쪽 클릭하면 아이디를 복사할 수 있습니다. AI 도구에 고칠 페이지나 새 페이지를 만들 폴더를 알려 줄 때 씁니다. 문서 소유자가 아니어도 이 메뉴는 보입니다.
웹 테마에서도 비순서 목록 기호로 대시(-)를 고를 수 있습니다. 전에는 PDF 테마에서만 고를 수 있었습니다.
업데이트할 때 예전 형식으로 남아 있던 데이터를 지금 형식으로 바꿉니다. 스타일 값을 URL 인코딩해 저장한 테마는 새 형식으로 다시 저장하고, 예전 버그로 장의 제목, 부제, 저자, 주제에 남은 ${ref}는 원본 장의 값으로 바꿉니다. 3.0.38 이전에 문서 태그로 저장한 값은 레이블로 옮기고, 유형이 비어 있는 예전 답변은 답변으로 채웁니다.

해결한 버그

콘솔의 set-default-i18n 명령어가 사용하도록 설정하지 않은 중국어(zh)도 기본 언어로 받던 문제를 수정했습니다. 이제 사용하도록 설정한 언어만 기본 언어로 정할 수 있습니다. 사용하지 않는 언어가 이미 기본 언어로 저장되어 있으면 그 설정을 무시하고 브라우저 언어를 따릅니다. 기본 언어로 정한 언어는 disable-i18n 명령어로 끌 수 없으므로, 먼저 set-default-i18n 명령어로 기본 언어를 바꿉니다.
비주얼 에디터에서 도형을 옮기거나 크기를 바꿀 때 자동 맞춤 안내선이 보이는데도 손을 떼면 도형이 안내선에 붙지 않던 문제를 수정했습니다. 페이지에 도형이 많을 때 자주 생겼습니다. 이제 가까이 맞는 도형이 여럿이면 가장 가까운 위치에 붙고, 안내선은 실제로 붙는 위치에만 표시합니다.
비주얼 에디터에서 선(직선, 꺾인 선, 곡선)에 넣은 글자의 위쪽 절반을 누르면 선이 선택되지 않던 문제를 수정했습니다. 선을 옮길 때 글자 윗부분이 화면에 남을 수 있던 문제도 함께 수정했습니다.
비주얼 에디터에서 모자이크(블러)의 크기를 바꿔도 저장했다가 다시 열면 기본값 5로 돌아가던 문제를 수정했습니다.
비주얼 에디터에서 흐름도 도형의 배지와 콜아웃 번호에 두 글자 이상을 넣으면 글자가 원 밖으로 넘치던 문제를 수정했습니다. 이제 글자가 원보다 넓으면 양 끝이 둥근 모양으로 넓어지고, 그림으로 저장할 때도 넓어진 배지가 잘리지 않습니다.
비주얼 에디터가 알 수 없는 유형의 도형이 하나라도 있으면 그림 전체를 열지 못하던 문제를 수정했습니다. 이제 그 도형만 빼고 열고, 저장하면 그 도형이 사라진다고 알려 줍니다.
비주얼 에디터가 잘못된 값이 든 도형을 그리거나 저장하다 멈추던 문제를 수정했습니다. 없는 색 이름, 지원하지 않는 차트 유형, 테두리 색이 없는 안내선, 테두리 두께가 없는 선 콜아웃이 해당합니다. 이제 이런 값은 기본값으로 그립니다.
비주얼 에디터에서 사용자 옵션의 기본 불투명도를 1보다 작게 정해 두면, 불투명도 1로 저장한 사각형과 타원을 다시 열 때 흐리게 그려지던 문제를 수정했습니다. MCP로 불투명도 없이 그린 사각형도 같은 이유로 흐리게 그려졌습니다.
에디터에서 주석이 달린 단락이 장의 마지막 단락일 때 PageDown 키를 누르면 오류가 나고 선택이 움직이지 않던 문제를 수정했습니다. 이 경우 End 키를 눌러도 마지막 단락으로 가지 않던 문제와, PageDown·PageUp 키를 누르면 단락 대신 주석 영역이 선택되던 문제도 함께 수정했습니다.
에디터에서 단락을 끌어 옮긴 뒤 같은 단락에 이동 애니메이션이 다시 일어나면 단락 이동과 저장이 한 번 더 실행될 수 있던 문제를 수정했습니다.
문서의 이력 보기에서 태그끼리 비교할 때, 그 뒤에 삭제한 장의 내용을 보려고 하면 장을 찾을 수 없다는 오류가 나던 문제를 수정했습니다. 이제 삭제한 장은 태그를 만든 시점의 내용으로 보여 줍니다. 삭제한 장은 이력이 남아 있지 않으므로 변경 내용 비교 없이 내용만 보여 줍니다. 이전 태그에 이미 있던 장을 새로 만들어진 장으로 표시하던 문제도 함께 수정했습니다.
문서의 이력 보기에서 현재 내용을 볼 때 제목이 "현재 시점의 이력" 대신 "1970-01-01 오전 08:59 시점의 이력"으로 표시되던 문제를 수정했습니다.
챗봇의 벡터 저장소를 만든 뒤 웹에서 뺀 장이나 지운 장의 내용이 챗봇 답변의 근거로 계속 쓰이던 문제를 수정했습니다. 다시 동기화해도 그 장의 임베딩 파일이 남았습니다. 이제 동기화할 때 그 장의 파일을 지우고, 질문할 때마다 웹 뷰어에 보이는 장의 내용만 찾으므로 동기화하기 전에도 답변에 쓰지 않습니다.
웹에서 뺀 장이 웹 뷰어의 역링크와 문서 그래프에 제목과 링크로 나오던 문제를 수정했습니다. 역링크에는 공개한 문서로만 보는 독자와 리뷰어에게, 문서 그래프에는 리뷰어에게 보였습니다. 이제 웹 뷰어와 같이 소유자와 공동 작성자, 숨긴 장 보기를 허용한 리뷰어(ALLOW_REVIEWER_TO_ACCESS_HIDDEN_CHAPTER)에게만 웹에서 뺀 장을 보여 줍니다.
쓰리래빗츠 북 3.0.38 이전에 내보낸 문서를 가져올 때 같은 태그가 두 번 들어 있으면 그 라벨이 붙지 않던 문제를 수정했습니다.
웹 테마의 번호 매기기 설정에서 글꼴 굵기 항목 이름이 label.numbering_font_weight로 보이던 문제를 수정했습니다.
PDF 테마나 PDF 페이지 레이아웃을 고치거나 다른 것으로 바꿔도, 웹 뷰어에서 장 PDF를 내려받으면 예전 모양의 PDF가 나오던 문제를 수정했습니다. 그 장의 내용을 고치기 전까지 전에 만든 PDF를 그대로 돌려줬습니다.
PDF에서 표 칸이나 노트·팁·주의 같은 상자 안 목록 항목에 쓴 강조, 굵게 같은 인라인 글자가 칸의 글자 크기보다 크게 나오던 문제를 수정했습니다. 배경색을 넣어 글자색이 바뀐 표 칸과 블록 인용구 안 목록의 인라인 글자도 이제 그 글자 크기와 색을 따릅니다.
에디터에서 블록 인용구 안에 넣은 순서 목록에 번호가 보이지 않던 문제를 수정했습니다. 비순서 목록 기호는 보였습니다.