StarLight는 메신저 알림으로 들어온 메시지를 내가 만든 스크립트 봇에 전달하고, 봇이 정한 대로 자동으로 답장하는 안드로이드 앱입니다. 자바스크립트로 명령어 봇, 알림 봇, 정보 조회 봇 등을 직접 만들어 휴대폰에서 실행할 수 있으며, 코드를 몰라도 내장된 AI 에이전트와 대화하며 봇을 만들 수 있습니다.

■ 동작 방식
1. 알림 접근 권한으로 메신저 앱(기본: 카카오톡)의 새 메시지 알림을 읽습니다.
2. 방 이름, 보낸 사람, 메시지 내용을 켜져 있는 봇 프로젝트의 onMessage 함수에 전달합니다.
3. 봇이 답장하면 알림의 답장 기능을 통해 해당 채팅방에 메시지를 보냅니다.
모든 처리는 휴대폰 안에서 이루어지며, 받은 메시지를 개발자 서버로 보내지 않습니다. 어떤 앱의 알림을 받을지는 설정의 패키지 규칙에서 직접 정할 수 있습니다.

■ 봇 프로젝트
• 두 가지 자바스크립트 엔진: Rhino와 NeonJS(ES 모듈, async/await, fetch, WebSocket 지원)
• 단계별 프로젝트 만들기: 이름, 언어, 받을 이벤트, 언어 설정을 차례로 고르면 시작 코드가 만들어집니다.
• 프로젝트별 켜기/끄기, 컴파일, 받을 이벤트 설정, 즐겨찾기, 검색과 정렬
• 프로젝트를 zip 파일로 내보내고 가져와 백업하거나 다른 기기로 옮길 수 있습니다.

■ 코드 에디터
• 터치에 맞춘 에디터: 문법 강조, 자동 완성, 이벤트 함수 스니펫, 문법 검사
• 찾기·바꾸기, 줄 이동, 여러 파일 탭, 파일 트리, 테마와 글자 크기 설정
• 컴파일하기 전에 자동 저장, Rhino 프로젝트는 오류가 난 줄 표시

■ 디버그 룸
메신저 없이 앱 안에서 봇에게 메시지를 보내고 답장을 바로 확인할 수 있는 테스트 채팅방입니다. 보낸 사람, 방 이름, 단체방 여부를 바꿔 가며 시험할 수 있고, 봇이 보낸 사진과 파일도 미리 볼 수 있습니다.

■ StarLight AI (선택 기능)
사용자가 직접 연결한 AI 서비스로 동작하는 코딩 에이전트입니다. "!날씨 명령어에 답하는 봇 만들어 줘"처럼 요청하면 프로젝트를 만들고, 코드를 작성·수정하고, 컴파일한 뒤 디버그 룸에서 직접 시험해 결과를 알려 줍니다.
• 지원 서비스: Anthropic, ChatGPT 계정 로그인, OpenAI, Google Gemini, OpenRouter, OpenAI 호환 서버
• 사진·파일 첨부, 작업 계획 표시, 바꾼 내용 되돌리기, 변경 내용 보기
• 프로젝트 삭제나 켜고 끄기처럼 중요한 작업은 실행 전에 사용자의 승인을 받습니다.
• 앱을 닫아도 진행 상황 알림과 함께 작업을 이어 가며, 알림에서 언제든 중지할 수 있습니다.
AI 기능을 쓰려면 각 서비스의 API 키나 계정이 필요하며, 이용 요금은 해당 서비스에서 청구됩니다. 대화 내용, 첨부 파일, 에이전트가 읽은 프로젝트 파일은 사용자가 고른 AI 서비스로만 전송됩니다. AI가 만든 코드는 실행 전에 확인해 주세요.

■ 사진·파일 보내기
봇 스크립트에서 채팅방으로 사진, 동영상, 파일을 보낼 수 있습니다(MediaSharer.send). 메신저의 공유 기능을 이용하며, 이를 위해 '다른 앱 위에 표시' 권한이 필요합니다.

■ 홈 화면과 기록
• 위치와 크기를 바꿀 수 있는 위젯: 봇 상태, 오류 모니터, 실행 중인 작업, 메시지 활동, 스크립트 값, 로그
• 프로젝트별 로그와 오류 내용 확인, 로그 보관 기간 설정

■ 필요한 권한과 이유
• 알림 접근: 메신저 메시지 알림을 읽고 알림의 답장 기능으로 답장하기 위해 필요합니다.
• 다른 앱 위에 표시: 봇이 백그라운드에서 계속 실행되고, 사진·파일을 채팅방으로 보내기 위해 필요합니다.
• 알림: 봇 실행 상태와 AI 작업 진행 상황을 표시합니다.
• 배터리 최적화 예외(권장): 휴대폰이 대기 상태일 때도 봇이 멈추지 않게 합니다.
• 인터넷: AI 서비스 연결과, 봇 스크립트의 웹 요청에 사용합니다.
봇이 실행되는 동안 "StarLight 실행중" 알림이 표시됩니다.

■ 이용 안내
• Android 8.0 이상에서 동작합니다.
• Google Play 버전은 외부 플러그인과 앱 내 업데이트를 지원하지 않습니다.
• 봇 사용 시 각 메신저 서비스의 이용 약관을 지켜 주세요.
• StarLight는 카카오 및 각 메신저 서비스와 관련이 없는 독립 앱입니다. 카카오톡은 (주)카카오의 상표입니다.
• StarLight는 GPL-3.0 라이선스의 오픈소스 앱입니다.
소스 코드: https://github.com/mooner1022/StarLight
사용 설명서: https://starlight.mooner.dev