설치 세부 정보(기술)
일반적인 사용에는 필요 없습니다. 설치 위치, 백그라운드 서비스의 동작 방식, 데이터 저장 위치를 알고 싶을 때 읽어 보세요.
명령줄판과 같은 백그라운드 서비스 공유
데스크톱판과 명령줄 설치는 같은 자동 시작 노드 서비스를 공유합니다 (macOS launchd com.zqagent.node, Linux systemd zqagent, Windows 로그온 작업). 따라서 한 대의 컴퓨터에는 노드가 항상 하나뿐입니다. 이미 install.sh로 설치했다면 데스크톱판이 그것을 재사용하며 두 번째 노드를 띄우지 않습니다.
첫 실행에서 하는 일
첫 실행 시 내장 엔진을 자동 시작 노드 서비스로 설치하고 연결합니다. 주소나 키를 직접 입력할 필요가 없습니다. 이미 install.sh로 노드를 설치했다면 데스크톱판은 그 서비스를 재사용합니다.
닫기와 종료
- 창 닫기 = 트레이로 숨기기. 작업은 계속 실행됩니다. 트레이 메뉴의 "ZQAgent 열기"로 되돌릴 수 있습니다.
- 종료: 트레이 메뉴의 "종료"는 데스크톱 셸만 닫고, 노드 서비스는 백그라운드에서 계속 실행됩니다 (launchd / systemd / 로그온 작업이 유지).
- 단일 인스턴스: 앱을 다시 실행해도 기존 창을 앞으로 불러올 뿐, 두 번째 노드를 시작하지 않습니다.
데이터 위치
노드 데이터(테넌트, 세션, 모델 설정, admin.json)는 시스템 서비스의 데이터 디렉터리에 저장됩니다:
| 플랫폼 | 데이터 디렉터리 |
|---|---|
| macOS | ~/Library/Application Support/zqagent/ |
| Linux | ~/.zqagent_data/(실행 사용자 소유. 초기 버전은 /var/lib/zqagent/) |
| Windows | %APPDATA%\zqagent\ |
install.sh로 설치한 노드와 같은 디렉터리를 공유하므로 두 설치 방식을 오가도 세션을 언제든 복원할 수 있습니다.
데스크톱 설정(워크스페이스, keep-awake)은 별도로 ~/.config/zqagent-desktop/desktop.json에 저장됩니다.
모델 변경
설정을 열고 모델 이름, Base URL, API Key를 입력한 뒤 저장합니다. 새 세션부터 적용됩니다.
시스템 요구 사항
- Windows 10 / 11(64비트. Windows 7, 8, 8.1은 실행되지 않음)
- macOS 11 이상(Apple 실리콘과 Intel이 같은 패키지)
- Linux: Ubuntu / Debian은 deb, CentOS / Fedora는 rpm