앙스키 문서

아키텍처

Daemon의 transport 표면과 저장 구조

현재 구성

daemon은 Fastify 기반 서버 하나에서 아래 표면을 함께 제공합니다.

표면역할
Local Eve proxy/eve/v1/* 세션, turn queue, 이벤트 스트림
Utility bridge메모리, 스케줄, 브라우저, 워크스페이스 이벤트
Utility REST상태, 로그, 스킬, 모델, 워크스페이스 조회
Maintenance REST워크스페이스 생성/빌드/정리, 스킬 프로젝트 발행
Helper routes브라우저 쿠키 등록, 모바일 도구 릴레이, 로컬 머신 연동

런타임 흐름

mobile / web client

        ├─ Eve session API + durable stream
        ├─ utility / maintenance REST
        └─ browser / mobile / local helper routes


             angski daemon

                 ├─ loopback Local Eve + Codex subscription
                 ├─ Browser session service
                 ├─ Scheduler / cleanup jobs
                 └─ SQLite + filesystem storage

시작 순서

설정 읽기

~/.angski/config.json과 TLS 파일 위치를 확인합니다.

서버 초기화

Fastify, Local Eve supervisor, utility bridge, browser session service를 준비합니다.

저장소 연결

SQLite와 파일 저장 경로를 열고, 필요한 상태를 복구합니다.

백그라운드 서비스 시작

Local Eve, scheduler, Cloud goal relay, screenshot cleanup 같은 백그라운드 서비스를 시작합니다.

저장 위치

daemon의 기본 저장 루트는 ~/.angski/입니다.

~/.angski/
├── config.json
├── daemon.pid
├── daemon.log
├── angski.db
├── tls/
├── local-eve/
├── agents/
├── sandboxes/
└── skills/

대표 항목:

  • config.json: token, host, port
  • angski.db: 에이전트 설정, 스케줄, 워크스페이스 메타데이터와 호환 데이터
  • local-eve/: Eve workflow 상태, 세션 인덱스, 에이전트 프로필
  • tls/: CA와 서버 인증서
  • agents/<agentId>/: 아바타, 스크린샷, report 산출물
  • sandboxes/: 앱 워크스페이스
  • skills/: 발행된 스킬 마크다운

기본 설정값

{
  "host": "0.0.0.0",
  "port": 7632
}

보안 기준

daemon 관리자 token과 로컬 CA는 모두 ~/.angski 아래에 저장됩니다. 모바일은 일회용 QR 교환으로 발급한 기기별 credential을 사용하며, Eve 내부 workflow 경로와 supervisor secret은 LAN에 노출하지 않습니다.

On this page