데이터와 업데이트

~/.ave

맨 위에는 여러 기능이 함께 쓰는 것만 있습니다. 나머지는 기능마다 자기 폴더를 가지므로, 한 기능을 폴더 하나로 백업하거나 지울 수 있습니다.

settings.json

권한 설정(허용 디렉터리 등). 앱 설정은 Electron 사용자 데이터 폴더의 ave-settings.json 에 있습니다.

audit.log

HMAC 체인 감사 로그

secrets/

비밀 값

plugins/

설치한 플러그인과 registry.json

skills/

스킬과 승인 기록

sessions/

대화 세션

위치는 AVE_HOME 환경 변수로 바꿀 수 있습니다.

앱 업데이트

• 낮은 버전으로 내려가는 업데이트는 하지 않습니다.
• 특정 버전은 건너뛸 수 있습니다.
• 플러그인을 설치하는 중에는 적용하지 않고, 설치 전에 확인을 받습니다.

서명 없는 Mac 빌드는 스스로 교체할 수 없습니다. 업데이트를 적용하려 하면 Ave가 이 사이트의 첫 화면을 엽니다. 그곳의 다운로드에서 새 DMG를 받아 앱을 바꾸고 격리 표시를 다시 지우면 됩니다.

서명 없는 빌드

지금 공개 빌드는 코드 서명과 공증을 거치지 않습니다. Windows에서는 ‘알 수 없는 게시자’와 SmartScreen 경고가, macOS에서는 Gatekeeper 차단이 나타납니다. 내려받기는 downloads.agent-connector.ai 에서만 하세요.

앱이 스스로 여는 외부 연결

내가 연결한 제공자, 플러그인, 서버 말고도 앱이 스스로 여는 연결이 몇 가지 있습니다. 업데이트 확인, 이 사이트의 서비스 문서, 그리고 기본으로 켜져 있는 모델 카탈로그 갱신입니다. 이 고정된 출처들은 플러그인에게 추가 접근을 주지 않습니다.

모델 카탈로그 갱신은 컨텍스트 창과 출력 한도 정보를 models.dev 에서 받습니다. 공급자 응답과 사용자 설정도 실제 한도를 정합니다. 사용량의 비용 계산은 기존 단가표와 사용자 단가 설정을 따릅니다.

접속 대상

공개 문서 https://models.dev/api.json 만 요청합니다. 일반 앱은 실행할 때와 매시간 확인하되 하루에 많아야 한 번 요청하고, 실패한 시도도 이 간격에 들어갑니다. 헤드리스 실행은 갱신 요청을 보내지 않습니다.

보내는 것

Accept: application/json 을 담은 GET 요청이며, 이전 ETag가 있으면 If-None-Match 에 넣습니다. 계정, API 키, 세션 인증, 쿠키, 프롬프트, 파일, 대화는 보내지 않습니다. 서버는 IP 주소와 사용자 에이전트, 언어 헤더 같은 일반 전송 헤더를 볼 수 있습니다.

검사 방식

호스트의 공개 주소 보호 경로가 내부 주소를 거부하고, 리다이렉트는 거부합니다. 인증서 오류가 나도 평문 HTTP로 다시 시도하지 않습니다. 헤더와 본문을 합쳐 15초 안에 받아야 하고, 압축을 푼 본문은 16 MB(16,777,216바이트)로 제한합니다. 유효하지 않은 다운로드는 쓰던 카탈로그를 그대로 둡니다. 다음 실행에서는 번들보다 오래되지 않은 검증된 캐시를, 없으면 번들을 씁니다. 명시적으로 고정한 카탈로그가 있으면 그것이 먼저입니다.

캐시

검증한 사본은 내 컴퓨터에 둡니다. 현재 사본과 직전 정상 사본을 포함해 카탈로그 파일을 최대 다섯 개 유지합니다. 오래된 해시 사본은 정리될 수 있으니 오래 재현하려면 별도 파일을 보관하고 절대 경로로 고정하세요. 쓸 수 없는 명시적 고정값은 앱 시작을 막습니다.

끄는 방법

설정 → 모델 → 모델 카탈로그에서 ‘카탈로그 매일 갱신’을 끕니다. 관리자는 시스템 정책 파일에 { "modelCatalog": { "refresh": "off" } } 를 두어 끌 수 있고, 정책 파일이 손상되거나 읽히지 않아도 갱신은 꺼집니다. 실행 스크립트에서 AVE_MODEL_CATALOG 를 bundled, 보관 중인 사본의 sha256, 또는 카탈로그 파일의 절대 경로로 고정해도 꺼집니다.

앱이 이 사이트에서 읽는 것

Ave는 이 사이트의 /.well-known/ave-service.json 을 읽어 공지가 있는지, 서비스 주소가 옮겨졌는지를 확인합니다. 공지는 /announcements/v1.json 에 있습니다.