노드 콘솔

노드 콘솔은 zqagent의 그래픽 인터페이스입니다. 노드 관리, 프로젝트 생성, AI와 대화, 작업 승인, 사용량과 비용 확인을 모두 여기서 할 수 있으며 명령을 입력할 필요가 없습니다.

여는 방법

상황	입구	설명
데스크톱	데스크톱 앱	로컬 노드 내장, 바로 사용
브라우저	사용자 센터 → 노드 관리 → 노드 선택	연결된 노드를 원격 관리
스마트폰	모바일 브라우저에서 사용자 센터 열기	반응형 + PWA, '홈 화면에 추가' 가능

원격 관리의 전제는 노드가 사용자 센터에 연결되어 있어야 한다는 것입니다. 노드 시작을 참고하세요.

노드와 프로젝트

• 노드 관리: 사용자 센터에서 만들며, 노드 관리 하나로 여러 기기를 관리할 수 있습니다. 노드 목록에 온라인 상태가 표시되고 클릭하면 노드 콘솔로 들어갑니다.
• 프로젝트 관리: 프로젝트 하나가 노드의 작업 디렉터리 하나에 대응하며 AI가 읽고 쓰는 범위입니다. 새로 만들 때 노드 디렉터리를 탐색해 선택할 수 있어 경로를 직접 입력하다 생기는 오류를 피합니다.
• 모델 선택: 노드 단위로 기본 모델을 설정할 수 있고 세션별로 따로 지정할 수도 있습니다.

상단 바에서 노드와 프로젝트를 빠르게 전환할 수 있고, 프로젝트 관리 창을 열어 한꺼번에 관리할 수 있습니다.

세션 워크벤치

• 세션 목록: 고정과 검색을 지원해 과거 세션을 빠르게 찾습니다.
• 탭: 여러 세션을 동시에 열 수 있고 탭 상태는 영구 저장됩니다(새로고침 후에도 유지). 우클릭 메뉴와 접기도 지원합니다.
• 타임라인: 대화와 도구 호출을 시간순으로 보여 주며 긴 세션도 전체 과정을 되돌아볼 수 있습니다.
• 입력 초안: 보내지 않은 내용은 자동 저장되며 세션 전환이나 새로고침 후 자동 복원됩니다.
• 파일 편집: 내장 편집기는 실행 취소/다시 실행, Markdown 하이라이트, 스크롤 동기화를 지원합니다.

승인과 질문

AI가 부작용이 있는 작업(파일 쓰기, 명령 실행 등)을 요청하거나 보충 정보가 필요할 때 세션에 카드가 표시됩니다:

• 승인은 네 가지 중 선택합니다: 이번만 허용 / 이 도구 항상 허용 / 이 명령 항상 허용 / 거부. '이 명령 항상 허용'은 run_shell에서만 표시되며 명령 단위로 허용하므로 도구 전체를 허용하는 것보다 안전합니다.
• 질문은 내장 선택지와 직접 입력을 지원합니다.

미처리 카드는 계속 남아 있어 나중에 처리할 수 있습니다. CLI의 승인 의미와 같으며 자세히는 CLI 사용을 참고하세요.

사용량과 비용

zqagent는 모델 호출마다 기록하고 노드와 계정 두 층으로 집계합니다:

• 사용량 보기: 프로젝트 홈의 token 카드 또는 노드 상세의 '모니터링 → 사용량 보기'에서 패널을 엽니다. 기간 필터, 일별 막대 그래프, 모델별 통계, 상세 목록을 지원하며 CSV 내보내기도 가능합니다.
• 가격표: 주요 모델(OpenAI / DeepSeek / Qwen / Zhipu / Moonshot 등)의 기본 단가를 내장하고 '가격표'에서 필요에 따라 수정할 수 있으며, 비용은 설정한 가격으로 환산됩니다.
• 계정 단위 사용량: 사용자 센터에 로그인하면 계정 페이지에서 노드 전체 사용량을 확인할 수 있습니다.

실시간성과 안정성

• 세션은 실시간 이벤트 스트림으로 전달되고 끊기면 자동 재연결하며 커서로 증분을 보충합니다. 백그라운드에서 돌아오거나 네트워크가 복구된 뒤에도 내용이 유실되거나 중복되지 않습니다.
• 서버는 주기적으로 하트비트를 보내므로 장시간 조작이 없어도 유휴로 오판해 자주 재연결하지 않습니다.
• 노드 온라인/오프라인, 작업 알림(승인/질문/오류)이 실시간으로 알려집니다.

모바일

• 좁은 화면(≤ 720px)에서는 자동으로 단일 컬럼이 되어 '개요 / 콘솔'을 전환하고 세션 목록과 대화를 오갑니다.
• '홈 화면에 추가'를 지원하며 독립 창으로 실행됩니다.

다음 단계

• 노드 시작: 설치하고 사용자 센터에 연결
• 원격 제어 개요: 스마트폰과 QQ로 원격 작업 요청
• REST 인터페이스: 연동 개발 참고