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

Windows 알림 환경 준비 가이드

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

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

준비할 항목

항목	준비 내용
Windows runner	로컬 PC, VM, 원격 장비 중 하나를 정하거나 visible smoke 보류 여부를 정한다.
Toolchain	Windows 버전과 Visual Studio/C++ desktop workload/Windows SDK 사용 가능 여부를 정한다.
Packaging mode	unpackaged, MSIX, sparse package, debug injection 전용 중 하나를 선택한다.
Notification API	Windows App SDK, WinRT toast, desktop AppUserModelID fallback, debug injection 전용 중 하나를 선택한다.
Identity	visible toast activation이 범위에 있으면 package identity 또는 AppUserModelID를 정한다.
Signing	test certificate, organization cert, Store association, signing 없음 중 하나를 선택한다.
증거 위치	민감값을 제거한 로그, 스크린샷, 실행 메모를 어디에 남길지 정한다.

tracked 파일에 넣지 말아야 할 값

• Microsoft 계정 값, 비공개 package identity, signing certificate 내용/password, Store association file
• push credential, device token, private endpoint, auth token, channel name, user name, server URL

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

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

현재 저장소 상태

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