- 릴리스 버전: 6.0.14
- 빌드 번호: 0622
- 릴리스 날짜: 2026년 2월 27일 (한국시간 기준)

매뉴얼웍스를 업데이트하려면 <a class="reference" href="#cab7f9b31046730f">소프트웨어 업데이트</a>를 참고합니다. 5.0 버전에서 6.0 버전으로 업데이트하려면 <a class="reference" href="#34350faf7573f79c">매뉴얼웍스 6.0 업데이트 가이드</a>를 참고합니다.

![NotebookLM으로 작성한 오디오 릴리스 노트](https://3rabbitz.com/r/book_image/get/aa5ce841cba064d3)

# 릴리스 이후 수정 사항

## 빌드 번호: 0664

- <a class="reference text" href="#d6f3c047e561315b">API로 사용자를 만들 때</a> 그룹-사용자 매핑 정보를 업데이트하지 않는 문제를 해결했습니다.

## 빌드 번호: 0658

- <a class="reference text" href="#b138db4ff3bfb001">문서의 프로젝트를 반환하는 API</a>를 추가했습니다.

## 빌드 번호: 0640

- 매뉴얼웍스 빌드를 할 때 소스 코드 난독화를 위해 ProGuard를 사용합니다. 해당 버전의 오류로 새로운 사용자를 만들지 못하는 오류가 있었습니다. <strong>ProGuard 7.8.2 버전</strong>으로 업데이트한 후 다시 빌드를 했습니다.

## 빌드 번호: 0628

- URL로 올린 그림 단락이 보이지 않는 문제를 해결했습니다.

# H2 데이터베이스 지원

자세한 사항은 <a class="reference" href="#0d3aea4ed17c7097">매뉴얼웍스, 더 강력해진 H2 데이터베이스로 전환합니다</a>를 참고합니다.

> <strong>H2 데이터베이스를 사용하려면 자바 11 버전 이상</strong>이 필요합니다. 기존 고객은 H2로 마이그레이션을 하기 전까지는 자바 8 버전을 계속 사용할 수 있습니다. 신규 고객도 H2가 아닌 다른 데이터베이스를 사용한다면 자바 8 버전을 사용할 수는 있습니다.  
> 하지만 <a class="reference text" href="#db880539742f4c8a">자바 25 버전을 사용하는 것을 권장</a>합니다.

# UI 설정 메뉴 추가

<관리 | 환경 설정 | UI 설정> 메뉴를 추가했습니다. <a class="reference" href="#6e64c5f531b74f7e">28. 콘솔</a>을 사용하지 않고 UI와 관련한 다양한 설정을 할 수 있습니다.

> <관리 | 환경 설정 | 일반 설정> 메뉴에 있는 로고와 시간 형식 설정을 이 메뉴로 옮겼습니다.

# 색상 시스템 도입

매뉴얼웍스는 오랫동안 <a class="link" href="https://m2.material.io/design/color/the-color-system.html">Material 색상 시스템</a>을 사용하고 있었습니다. 여기에 <a class="link" href="https://tailwindcss.com/docs/colors">Tailwindcss 색상 시스템</a>과 Muted 색상 시스템<small>(쓰리래빗츠가 자체적으로 구성)</small>을 추가했습니다. 기본은 Tailwindcss 색상 시스템입니다.

> <관리 | 환경 설정 | UI 설정> 메뉴에서 설정합니다.

# 긴 로고 지원

정사각형 로고뿐만 아니라 <span class="callout">1</span> 긴 로고를 사용할 수 있습니다. 이때는 <관리 | 환경 설정 | UI 설정> 메뉴에서 로고 위치를 “Top”으로 설정합니다.

![](https://3rabbitz.com/r/book_image/get/cf7ebc64d4509a56)

> <span class="callout">2</span>와 같이 로고가 상단 영역의 처음에서 시작하도록 하려면 <관리 | 환경 설정 | UI 설정> 메뉴에서 로고 배경색을 테마 색으로 채우기를 선택합니다.

# 방문 이력 데이터 파일로 전환

데이터베이스 성능 향상 목적으로 방문 이력 데이터를 파일에 저장합니다. <strong>당일은 실시간 데이터 반영을 위해 기존과 동일하게 데이터베이스에 저장</strong>하고, 그 후에 스케줄러를 통해 파일로 옮깁니다.

> 이를 통해 통계 메뉴의 전반적인 성능을 개선했습니다.

다음 순서로 기존 데이터를 마이그레이션합니다.

1. <통계 | 방문 통계> 메뉴로 이동합니다.
2. <<span class="callout">1</span>데이터 변환> 링크를 클릭합니다.

![](https://3rabbitz.com/r/book_image/get/57e0bcc7e5a26f42)

1. 마이그레이션이 필요한 <span class="callout">2</span> 연도 버튼을 클릭해서 연도별로 데이터 변환을 진행합니다.

![](https://3rabbitz.com/r/book_image/get/bccff301b6bc197f)

> 데이터 공간을 줄이기 위해 아파치 더비를 사용한다면 <관리 | 서버 관리 | 더비> 메뉴로 이동해서 R_VISIT 테이블에 대해 <button>조직</button> 버튼을 클릭합니다. 다른 데이터베이스를 사용한다면 해당 데이터베이스가 제공하는 기능으로 데이터 공간을 절약합니다.

다음을 참고합니다.

- VisitClearScheduler 스케줄러가 당일 제외 최근 5일 동안의 방문 이력을 파일에 저장하고 데이터베이스에서는 삭제합니다.
- 사용자가 <통계 | 방문 통계> 메뉴에서 방문 이력을 조회할 때 해당 날짜<small>(당일 제외)</small>의 방문 이력이 데이터베이스에 존재한다면 방문 이력을 파일에 저장하고 데이터베이스에서는 삭제합니다.
- 방문 이력 보존 기간(<a class="reference text" href="#5e9b2ed915962fb2">VISIT_RETENTION_PERIOD</a>)이 지나도 데이터베이스에서는 삭제하지만 해당 날짜의 파일은 삭제하지 않습니다.

# 웹 뷰어

![](https://3rabbitz.com/r/book_image/get/495ad3e765b89053)

## 장 내용을 마크다운 형식으로 복사하기

ChatGPT와 같은 AI 서비스의 프롬프트에 장 내용을 입력할 수 있도록 <span class="callout">1</span> <마크다운으로 복사> 링크를 클릭해서 장 내용을 마크다운 형식으로 복사합니다. 미리 보기를 할 수도 있습니다.

> 내보내기한 HTML 파일에서는 지원하지 않습니다. 그리고 웹 뷰어 레이아웃에서 <strong><내용 복사를 막습니다> 옵션</strong>을 선택했을 때는 나타나지 않습니다.

## 장 단위 PDF 내려받기

장 단위로 PDF를 내려받는 링크의 이름을 <span class="callout">2</span>장 제목으로 변경했습니다.

## WV_404_FALLBACK 옵션

요청 경로에 해당하는 문서는 존재하지만 장 또는 단락이 존재하지 않으면 404 페이지로 이동합니다. 404 페이지로 이동하지 않고, 문서의 전체 차례를 보여주려면 <a class="reference" href="#6e64c5f531b74f7e">28. 콘솔</a>에서 다음 명령어를 실행합니다.

```
set-preference -name WV_404_FALLBACK -value index
```

# 웹 페이지 객체 단락 지원

에디터에서 웹 페이지를 아래와 같이 객체 단락으로 넣을 수 있습니다.

> PDF와 HTML 등을 포함해 내보낼 때는 지원하지 않습니다.

# 만다라트 문서 공개하기

만다라트 문서를 다른 사람과 함께 편집할 수는 없습니다. 하지만 <span class="callout">1</span>공개는 할 수 있습니다.

![](https://3rabbitz.com/r/book_image/get/30352f7e67188d6a)

> 함께 댓글을 달 수 있도록 설정할 수 있습니다.

# 자바 라이브러리 업데이트

다음과 같이 자바 라이브러리 버전을 업데이트했습니다.

<table class="table column_count_3"><caption></caption><thead><tr><th><div>자바 라이브러리</div></th><th><div>기존 버전</div></th><th><div>신규 버전</div></th></tr></thead><tbody><tr><td><div>Apache Commons IO</div></td><td class="to_right"><div>2.18.0</div></td><td class="to_right"><div>2.21.0</div></td></tr><tr><td><div>Apache Commons Lang</div></td><td class="to_right"><div>3.17.0</div></td><td class="to_right"><div>3.20.0</div></td></tr><tr><td><div>Apache Commons Text</div></td><td class="to_right"><div>1.12.0</div></td><td class="to_right"><div>1.15.0</div></td></tr></tbody></table>

# 수정 사항

- <span class="callout">1</span>라벨 UI를 변경했습니다. 아이콘을 선택하지 않으면 #를 기본으로 붙입니다.

![](https://3rabbitz.com/r/book_image/get/5769d5387b8396e7)

- DateRange에 시작일과 종료일 검증 로직을 추가했습니다.
- 마우스를 올렸을 때 선택한 <span class="callout">2</span> 아이콘 이름을 알 수 있도록 변경했습니다.

![](https://3rabbitz.com/r/book_image/get/f4f389be168be62c)

- <알람> 링크를 포함해 알람을 <span class="callout">3</span>리마인더로 변경했습니다.

![](https://3rabbitz.com/r/book_image/get/c59127481d422e59)

- 아이콘(Material Symbols) 버전을 2.906 버전으로 업데이트했습니다.
    - 이에 따라 더 이상 다음 아이콘을 지원하지 않습니다.
        - book_4_spark
    - 모두 4,160개의 아이콘을 지원합니다.
        - 중복은 모두 제거했습니다.
    - <a class="reference text" href="#75db6bb38a3fdc04">새로 지원하는 아이콘은 다음을 참고</a>합니다.

- 진척 관리에서 열린 것만 보기 토글을 삭제했습니다. <span class="callout">4</span>그리드를 통해 필터할 수 있습니다.

![](https://3rabbitz.com/r/book_image/get/a4b7757401629144)

- <로그> 메뉴에서 로그 파일을 마지막으로 수정한 시간을 보여줍니다.
- 라이브러리 메뉴에 설명을 보여주지 않는 옵션을 추가했습니다. 기본으로는 설명을 보여줍니다.
- 그룹과 권한에 사용자를 할당할 때 이름이 같은 사용자를 구분하기 위해 이름과 함께 사용자 아이디를 보여주도록 변경했습니다.

# 해결한 버그

- 전체 문서에서 내용 검색을 할 때 <span class="callout">1</span>문서를 제목으로 정렬하지 않는 문제를 해결했습니다.

![](https://3rabbitz.com/r/book_image/get/a6ab665c776093ec)

- 링크로 채널을 넣었을 때 "내부 링크가 잘못되었습니다"가 나타나는 문제를 해결했습니다.
- 에디터에서 웹 페이지 링크가 열리지 않는 문제를 해결했습니다.
- PDF 파일을 만들 때 지정한 PDF 테마와 레이아웃이 저장되지 않는 문제를 해결했습니다.
- API로 사용자를 만들 때 사용자 아이디가 같은 사용자가 만들어지는 문제를 해결했습니다.