> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/update-note/2026/202609/20260917.md).

# \[2026.09.17] 라이브러리 태그 그룹 관리 추가 및 모듈러 부품 검사·전역 변수 기능

### (신규) 라이브러리 태그 그룹 관리

제품·마감재·텍스처에 쓸 태그를 그룹 단위로 관리할 수 있습니다. 라이브러리 고급 설정의 `태그 관리` 메뉴에서 리소스별 태그 그룹을 만들고 고치고 지울 수 있으며, 그룹마다 태그 목록과 필수 여부, 최대 선택 개수, 노출 여부를 지정합니다.

제품·마감재·텍스처의 태그 그룹은 서로 독립적으로 관리됩니다. 템플릿 태그는 기존 전용 관리 화면을 그대로 씁니다.

![라이브러리 고급 설정 > 태그 관리](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-13ebbd72517f94bbc6cdc53b96ae85670baab808%2F202609_20260917-1.png?alt=media)

![라이브러리 고급 설정 > 태그 관리 상세 페이지](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-6f93a494083d29bf105b5f645995698da59b5cf5%2F202609_20260917-2.png?alt=media)

![라이브러리 고급 설정 > 태그 관리 > 태그 그룹 생성](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-ed7409231c56b59611945015939d6cd13e48b818%2F202609_20260917-3.png?alt=media)

### (개선) 상품·재질 태그 입력 방식

상품과 재질의 태그를 자유 입력 대신 관리자가 등록한 태그 그룹에서 고르는 방식으로 바꿨습니다. 오타나 표현 차이 때문에 같은 뜻의 태그가 여러 개 등록되던 문제가 줄어듭니다.

각 태그 그룹에서 필수 여부와 최대 선택 개수를 확인할 수 있고, 전체 선택·해제를 지원합니다. 등록된 태그 그룹이 없으면 기존 자유 입력 방식을 씁니다.

**이전**

![가구/마감재/텍스쳐 라이브러리 > 상세 페이지](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-31640e2504a99ce42cf3ba1d5799e253b216aae2%2F202609_20260917-4.png?alt=media)

**이후**

![가구/마감재/텍스쳐 라이브러리 > 상세 페이지](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-fcd5ee9d2dabd4570ab962e303e66dc525b67bc8%2F202609_20260917-5.png?alt=media)

### (개선) 라이브러리 폴더 정렬·검색

가구 라이브러리의 하위 폴더도 제품과 똑같이 검색하고 정렬할 수 있습니다. 정렬 방식을 바꿔도 직접 배치한 폴더 순서를 그대로 두는 옵션을 추가했습니다.

**이전**

![](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-ebeb3a635fc8d8a44aa39c3495e8d764e7fcca5a%2F202609_20260917-6.png?alt=media)

**이후**

![](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-32689b0b225b739a6dfad135df70dbe23eac19eb%2F202609_20260917-7.png?alt=media)

### 버그 및 이슈 개선

* Agent AI가 도면을 편집하면 새로고침 없이 Planner 화면에 바로 반영됩니다.
* 공유받은 프로젝트 카드를 눌러도 에디터로 들어가지 않거나 버튼·메뉴가 사라지던 문제를 고쳤습니다.
* 공지사항 작성 화면에서 본문이 좌측에 붙거나 여백이 사라지던 문제를 고쳤습니다. 상세 화면에서 콘텐츠를 누를 때 파란 테두리와 리사이즈 핸들이 보이던 현상도 없앴고, 본문과 캔버스 영역을 카드 형태로 정리했습니다.
* 프로젝트 커버 이미지를 지워도 목록과 상세 화면에 예전 이미지가 남던 문제를 고쳤습니다. 이미지 업데이트 경로의 중복 저장 로직을 정리했습니다.

***

## 2. 에디터

### (신규) 그룹 가구 좌우·상하 반전

그룹으로 묶은 가구를 좌우나 상하로 뒤집을 수 있습니다. 우클릭 메뉴와 `Alt+H` / `Alt+V` 단축키를 지원하며, 그룹 안 가구가 모두 반전 가능할 때만 기능이 나타납니다.

함께 잠긴 가구가 단축키로 반전되던 문제와, 치수가 잠긴 가구에 반전 버튼이 보이던 문제도 고쳤습니다.

![](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-7299466ea2ac5db5b666145f6b013d5c563f3d80%2F202609_20260917-8.png?alt=media)

### 버그 및 이슈 개선

* 면·서피스·시공·타일 에디터의 마감재 라이브러리를 도면 에디터와 같은 3단 구조로 맞추고 `즐겨찾기`·`배치된 항목` 탭을 추가했습니다. 도면 로드 전에 `마감재`를 선택하면 에디터가 종료되던 문제와, 닫힌 방이 없을 때 벽 마감재가 목록에 안 나오던 문제도 함께 고쳤습니다.
* Render Studio의 1인칭 카메라 높이를 직접 입력할 때 2000~~9999mm까지 설정할 수 있습니다. 슬라이더·`R`키·드래그는 기존 0~~2800mm 범위 그대로입니다.
* 렌더링의 자동 초점(`autoFocus`)과 자동 가구 라이팅(`autoFurnitureLighting`)을 각각 켜고 끌 수 있는 토글을 추가했습니다. 기본값은 꺼짐이며, 렌더샷 에디터를 켜면 두 기능도 같이 꺼집니다.

***

## 3. 파라메트릭 에디터

### (신규) 모듈러 부품 검사(Inspect)

파라메트릭 부품을 저장하거나 제작하기 전에 변수·수식·패널·부품의 최종 상태를 한 번에 검사합니다. 값 이상, 변수 설정, 패널 형상, 부품 구성, 치수 일치, 부품 겹침까지 6종을 검사합니다.

검사 결과는 우측 사이드 패널에서 오류와 경고로 나뉘어 보입니다. 문제 항목을 고르면 해당 부품이 3D 화면에서 강조되고, 구성 요소 목록과 변수 영역에도 상태가 표시됩니다. 자동 검사는 기본으로 켜져 있으며, 저장할 때는 문제를 안내하고 제작용 데이터를 내보내기 전에 오류가 있으면 진행을 막습니다.

변수 순환 참조로 앱이 종료되던 문제, 재단 두께 계산 실패, 수식 기반 범위 계산 오류, 비정형 패널을 직사각형으로 잘못 판단하던 문제도 함께 고쳤습니다. 헤더에는 `오류 있음 / 경고 있음 / 이상 없음 / 검사 필요` 상태가 표시되고, 검사 실행 구조를 정리해 같은 부품 기준 검사 시간이 약 63% 줄었습니다.

![모듈러 > 검사 기능](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-54bd2ac55a3e86093a9bf0b8702c47b36962cd4e%2F202609_20260917-9.png?alt=media)

### (신규) 모듈러 전역 변수

여러 가구에서 함께 쓰는 판재 두께, 도어 간격, 오버레이, 걸레받이 위치 같은 값을 전역 변수로 모아 관리합니다. 파라메트릭 에디터에 전역 변수 23개를 추가했고, 수식에서 변수명을 직접 참조해 여러 부품에 같은 기준을 재사용할 수 있습니다. 판재 두께처럼 다른 값에 영향을 주는 항목은 연관된 도어 Overlay 등도 함께 계산됩니다.

기존 부품에 같은 이름의 내부 변수가 있으면 기존 부품 값을 먼저 적용해 형상이나 동작이 갑자기 바뀌지 않게 했습니다. 필요하면 `전역 값 쓰기`로 해당 부품을 전역 변수 기준으로 바꿀 수 있고, 값이 다를 때는 치수가 변할 수 있다고 먼저 안내합니다.

![](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-941417a8121861528b7f613ad708dd2286da73bf%2F202609_20260917-10.png?alt=media)

### (신규) 파라메트릭 변수 그룹 관리

파라메트릭 변수를 업무 목적과 상품 속성에 따라 사용자 정의 그룹으로 묶을 수 있습니다. 공개 변수와 내부 변수를 각각 여러 그룹으로 나눌 수 있고, 그룹마다 이름·설명·접힘 상태·순서·잠금·숨김을 설정합니다.

각 그룹에서 변수 추가, 복제, 이동, 내보내기·불러오기를 같은 방식으로 쓸 수 있으며, 변수 순서는 저장한 뒤에도 유지됩니다. 기존 콘텐츠의 변수는 마이그레이션 없이 기본 그룹에 자동으로 들어가 기존 수식과 참조 관계를 그대로 유지합니다.

![](https://2510524506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMWuDtKHjyUXqBIf7Q6Zw%2Fuploads%2Fgit-blob-948a2c7fa564a7de3d585ff37101053015687e9b%2F202609_20260917-11.png?alt=media)

### 버그 및 이슈 개선

* `변수 관리`·`부품 라이브러리` 탭을 아이콘 위·라벨 아래 세로 형태로 바꿔 헤더 툴바 버튼과 모양을 맞췄습니다. 좌측 사이더의 접이식 섹션 헤더에서 펼침 표시를 오른쪽 끝으로 옮기고 제목을 키웠습니다. 기능과 항목 변경은 없습니다.
* 모듈 모드에서 15개 이상 배치하면 모듈을 추가하거나 선택할 때 메인스레드가 3\~4초씩 멈추던 문제를 해결했습니다. 캐시에 한 번도 맞지 않던 GLTF 씬 재복제와, 선택만 바꿔도 무관한 셀 20개가 전부 다시 렌더되던 문제를 잡았습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.archisketch.com/update-note/2026/202609/20260917.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.