패널 관리

패널이란?

Naia의 화면은 크게 왼쪽 고정 영역(아바타 + 채팅)과 오른쪽 확장 영역(패널)으로 나뉩니다.

패널은 오른쪽 영역에 교체 가능한 UI 컴포넌트입니다. 한 번에 하나의 패널만 활성화되며, 오른쪽 사이드바(ModeBar)의 탭을 클릭하여 전환합니다. 다시 클릭하면 패널이 닫힙니다.

아바타, 채팅, 설정, 스킬 등은 패널이 아니라 왼쪽 고정 영역에 항상 존재하는 UI입니다.

기본 패널

앱에 내장된 패널입니다:

브라우저 — Chrome 내장 웹 브라우저 (상세 →)
워크스페이스 — 파일 탐색, 에디터, 터미널, 세션 모니터링 (상세 →)
Sample Note — 패널 개발 참고용 예제 패널 (삭제 가능)

커스텀 패널 설치

기본 패널 외에 커스텀 패널을 설치하여 기능을 확장할 수 있습니다. Git 저장소 또는 Zip 파일에서 설치합니다.

Git에서 설치

채팅에서 AI에게 요청합니다:

"https://github.com/example/my-panel.git 에서 패널 설치해줘"

저장소를 ~/.naia/panels/my-panel/에 클론하고 자동으로 등록합니다.

Zip 파일로 설치

"/tmp/my-panel.zip 패널 설치해줘"

압축을 해제하고 패널을 등록합니다.

패널 매니페스트 (panel.json)

설치되는 패널에는 반드시 panel.json 파일이 있어야 합니다. 없으면 설치가 취소됩니다.

{
  "id": "my-panel",
  "name": "My Panel",
  "description": "패널 설명",
  "icon": "🎨",
  "names": {
    "ko": "내 패널",
    "en": "My Panel"
  },
  "version": "1.0.0"
}

패널 디렉토리에 index.html이 있으면 자동으로 진입점으로 인식됩니다.

설치 위치

커스텀 패널은 ~/.naia/panels/ 디렉토리에 저장됩니다:

~/.naia/panels/
├── my-panel/
│   ├── panel.json
│   └── index.html
└── another-panel/
    ├── panel.json
    └── ...

ModeBar에서 관리

오른쪽 사이드바에서:

탭 클릭으로 패널 전환
설치된 패널의 🗑 버튼으로 삭제
+ 버튼으로 새 패널 설치

AI에게 요청

채팅에서 AI에게 패널 관리를 요청할 수도 있습니다:

"설치된 패널 목록 보여줘"
"my-panel 패널로 전환해줘"
"my-panel 패널 삭제해줘"

참고: 이미 설치된 패널과 동일한 이름이 있으면 설치가 실패합니다. 먼저 기존 패널을 삭제한 후 다시 설치하세요.

15. 패널 관리