# 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와 위의 환경 선택이 필요하다.