# 릴리스 노트

> Xisom Edge AI Box & Runtime의 운영자 관련 변경 사항입니다.

각 릴리스에서 변경된 내용을 엣지 박스를 운영하는 운영자에게 중요한 부분으로 추려 정리했습니다. 사용 중인 장치에서 버전이 어떻게 보고되는지는
[버전 및 업데이트](/ko/operate/versioning/)를 참조하세요.

항목은 운영자에게 보이는 동작 — 새로운 기능, 배포 변경 사항, 그리고 눈에 띌 수 있는 수정 사항 — 에 초점을 맞춥니다. 내부 리팩터링 및 테스트 전용 변경 사항은 생략됩니다.

## 최신

### 실시간 파이프라인 뷰 (Preview Flow)

- 새로운 **Preview Flow** 페이지는 Input → Model → Output 파이프라인을 인터랙티브한
  읽기 전용 그래프로 시각화하며, 실행 중인 추론 체인에는 실시간 데이터 흐름 애니메이션이
  표시되고, 엣지는 (추측이 아닌) 실제 활성 모델 연결을 반영합니다.
- 캔버스에서 아무 노드나 클릭하면 모델 페어링, 매핑 편집, 테스트 쓰기, 활성화 등 해당
  설정 대화상자로 바로 이동합니다.

[Preview Flow](/ko/operate/preview-flow/)를 참조하세요.

### 시스템 알림

- 새로운 **NotificationCenter**(헤더의 종 모양 아이콘)는 추론 시작/실패, 모델 활성화,
  로그 경고/오류, 싱크 쓰기 실패를 토스트와 목록으로 표시합니다.
- 추론이 사용자가 직접 요청하지 않은 이유로 중지될 때 — 다른 데이터소스가 전환되었거나,
  실행 중인 활성 데이터소스가 편집 또는 삭제되었을 때 — 이제 알림이 발생합니다.
- 백엔드 재시작 후, 이전에 활성화되어 있던 입력 데이터소스는 자동으로 Ready 상태와
  Start 컨트롤을 회복합니다 — 추론 자체가 자동으로 다시 시작되지는 않습니다 —
  [모니터링](/ko/operate/monitoring/)을 참조하세요.

[알림](/ko/operate/notifications/)을 참조하세요.

### MQTT 신뢰성 강화

- MQTT 입력 어댑터는 이제 와일드카드 기본 토픽 대신 매핑된 태그에만 구독하므로,
  관련 없는 브로커 트래픽이 추론을 멈추게 만들 수 없습니다.
- 매핑된 토픽이 조용해지면 모델에 오래된 마지막 값을 계속 공급하는 대신 추론을
  중지하며, 브로커 연결이 끊어지면 어댑터가 백오프와 함께 재연결합니다.
- `NaN`/`Infinity` 값은 모델에 도달하기 전에 거부되며, Test Connection은 이제
  원시 예외 이름 대신 실제 소켓 수준 실패(거부됨, 연결 불가, DNS)를 보고합니다.

[입력 데이터소스](/ko/configure/input-datasources/) 및
[MQTT 입력 중단 또는 오류](/ko/troubleshooting/mqtt-input-stops/)를 참조하세요.

### 예측 전달 보장

- MQTT 출력 싱크는 이제 **QoS 1**로 게시하므로, 브로커가 거부한 쓰기(예: ACL로
  거부된 토픽)는 성공을 조용히 보고하는 대신 실패로 표시됩니다.

[출력 데이터소스](/ko/configure/output-datasources/)를 참조하세요.

### 데이터소스 설정 UX

- 설정 필드는 이제 선택한 항목에 따라 표시되거나 숨겨집니다 — 예를 들어 TLS 필드는
  TLS가 활성화된 경우에만 나타나므로, 폼은 실제로 적용되는 항목만 요청합니다.
- 태그 매핑 및 연결 오류는 이제 원시 백엔드 코드 대신 일반 문장으로 표시됩니다.
- Test Write는 데이터소스 유형에 맞는 페이로드 템플릿에서 시작하며, 태그가
  매핑되지 않은 출력은 더 이상 활성화할 수 없습니다.

[입력 데이터소스](/ko/configure/input-datasources/) 및
[출력 데이터소스](/ko/configure/output-datasources/)를 참조하세요.

### 오프라인 번들의 데이터소스 TLS 인증서

- MQTT 및 OPC UA 데이터소스 TLS 인증서가 이제 로컬 개발 환경뿐 아니라 오프라인/
  에어갭 설치 및 번들 업데이트 경로에서도 지원됩니다.

[오프라인 번들 설치](/ko/install-deploy/offline-bundle-install/)를 참조하세요.

## 2026-06 — 실행 공급자, CSV 출력 및 컨테이너 강화

### 엣지 하드웨어를 위한 실행 공급자 모드

- 런타임은 이제 실행 공급자를 명시적으로 분류합니다: **TensorRT**, **CUDA**,
  또는 **CPU**. GPU 박스는 기본적으로 GPU 가속을 우선하며, GPU 라이브러리를 사용할 수 없는 경우 정상적으로 폴백합니다.
- 엄격 모드를 사용하면 자동으로 이루어지는 CPU 폴백을 시작 실패로 전환할 수 있으므로, GPU 박스가
  알아차리지 못한 채 CPU에서 동작하는 일이 없습니다.
- 대시보드는 이제 **활성 실행 공급자**를 표시하므로 사용자의 박스가 실제로 무엇을 사용하고 있는지 확인할 수
  있습니다. [모니터링](/ko/operate/monitoring/)을 참조하세요.

### CSV 출력 데이터소스

- 새로운 **CSV 출력**은 예측값 결과를 순환되는 CSV 파일에 기록하며, 파일 크기, 순환, 플러시 동작을
  구성할 수 있습니다. [출력 데이터소스](/ko/configure/output-datasources/)를 참조하세요.

### 신뢰성 및 관측 가능성

- **정직한 CPU 온도.** 박스에 읽을 수 있는 CPU 열 센서가 없는 경우, 대시보드는 이제 오해를 일으키는
  `0 °C` 대신 **N/A**를 표시합니다.
- **디스크 공간 회수.** 메트릭 데이터베이스는 이제 보존 정리 후 확보된 공간을 운영 체제에 반환하며,
  전체 행 수에 상한을 두어 트래픽 급증이 디스크를 가득 채우지 못하도록 합니다.
- **정확한 런타임 상태.** Model Manager 런타임 카드는 유휴 상태이거나 워밍업 중일 때 더 이상 잘못된
  "Desync"를 표시하지 않습니다.

### 강화된 컨테이너

- 모든 서비스는 이제 **비루트** 사용자로 실행됩니다.
- 웹 프론트엔드는 내부적으로 비특권 포트에서 수신 대기합니다 (호스트 포트는
  변경되지 않습니다).

**업그레이드 시 일회성 단계**

이전의 루트 기반 배포에서 업그레이드하는 경우, 첫 재배포 시 스토리지 볼륨에 일회성 소유권 수정이 필요합니다. 새로 설치하는 경우에는 영향을 받지 않습니다.
[오프라인 번들 설치](/ko/install-deploy/offline-bundle-install/) 업데이트 흐름을 참조하세요.

## v0.5 — 추론 관측 가능성 대시보드

- 지연 시간 분해 (큐 / 전처리 / 모델 실행 / 후처리)
- 시간 집계를 위한 윈도우 및 버킷 컨트롤
- 모델별 지연 시간 임계값

## v0.4 — 데이터소스 플랫폼

- OPC-UA, MQTT 어댑터
- 속도 제한 및 백프레셔 보고

## v0.3 — 모델 수명 주기

- 모델 버전 관리 및 단계적 승격

## v0.2 — 웹 대시보드

- 실시간 푸시 기반 대시보드 업데이트
- 역할 기반 접근 제어(RBAC) 및 감사 로그