nexo/docs/linux-notification-test-guide.md

Linux 알림 환경 준비 가이드

마지막 확인일: 2026-06-02

에이전트가 Linux 알림 구현과 smoke 검증을 마무리하려면 Linux runner와 데스크톱 알림 환경 선택이 필요하다. 이 문서는 사용자가 무엇을 준비해야 하는지 정리한 가이드이며, 사용자가 직접 이 문서만 보고 테스트를 실행할 필요는 없다.

준비할 항목

항목	준비 내용
Linux runner	로컬 장비, VM, remote desktop, headless 전용 runner 중 하나를 정하거나 visible smoke 보류 여부를 정한다.
배포판	Ubuntu, Debian, Fedora 등 배포판과 버전을 정한다.
데스크톱 세션	GNOME/KDE/XFCE/기타 환경과 X11/Wayland/headless 여부를 정한다.
알림 경로	D-Bus notifications, XDG Desktop Portal, libnotify, debug injection 전용 중 하나를 선택한다.
의존성	에이전트가 필요한 system package를 설치해도 되는지 정한다.
조작 책임	runner가 원격이면 UI prompt/click을 누가 처리할지 정한다.
증거 위치	민감값을 제거한 로그, 스크린샷, 실행 메모를 어디에 남길지 정한다.

tracked 파일에 넣지 말아야 할 값

• 비공개 host name, user name, private endpoint, auth token, channel name, server URL
• 장비를 식별할 수 있는 session detail, private package repository credential, device token, signing key

준비 후 에이전트가 할 수 있는 일

• 선택된 범위에 따라 Linux platform registration과 host scaffold를 추가한다.
• native notification/action bridge를 구현한다.
• 선택된 desktop notification path를 설정한다.
• routing check를 실행하고, 허용된 경우 visible notification smoke를 수행한다.
• 민감값을 제거한 증거를 task 기록 또는 비공개 실행 메모에 남긴다.

현재 저장소 상태

Linux는 아직 등록되지 않았고 plugin 또는 test-host scaffold도 없다. Smoke 작업을 시작하려면 먼저 platform scaffold와 위의 환경 선택이 필요하다.