업데이트와 제거

네이티브 상주 설치는 자체 업데이트할 수 있습니다. 체크섬을 검증하고 새 바이너리를 원자 활성화하며 공간이 허용하면 이전 활성을 롤백으로 보존합니다.

릴리스와 데이터 경계

공개 네이티브 구성용 안내입니다. v0.1.107은 안정 릴리스이며 옛 개발 미리 보기 폴더·런처는 설치 경로가 아닙니다. 개발 구성 변경 전 보존할 전체 데이터를 백업하세요. 빈 홈을 기존 데이터 위에 복사하거나 바이너리 롤백이 DB 마이그레이션을 되돌린다고 가정하지 마세요.

업데이트 확인

읽기 전용부터:

anyy update --check

보고 항목:

• 현재·최신 버전.
• 설치 출처.
• 자체 업데이트 지원.
• 상주 설치의 읽기 전용 공간·릴리스 사전 검사.

장시간 비서 변경 전 확인하세요

유지보수 창 전에 --check를 쓰세요. Gateway 중지·파일 변경은 하지 않습니다.

적용

일반 상주 설치:

anyy update

상주 서비스 실행 중이면 중지, 릴리스·서비스 정의 업데이트, 재시작 후 새 버전 준비를 기다립니다. 수동 Gateway는 보고만 하며 자동 서비스 전환하지 않습니다.

업데이트 과정

1. 선택 홈·잠금을 결정합니다.
2. 출처·가능 릴리스를 찾습니다.
3. 임시·홈 공간을 확인합니다.
4. 아카이브·체크섬을 받습니다.
5. SHA-256·아카이브를 검증합니다.
6. 버전 디렉터리에 후보를 설치합니다.
7. 후보 anyy --version 상태 검사를 합니다.
8. 활성 원자 전환과 이전 대상 기록을 합니다.
9. Gateway를 이전 실행·중지 상태로 복구합니다.

완료는 이전·활성 버전, 롤백, 명령 상태, Gateway 결과를 출력합니다.

버전 선택

특정 공개 버전:

anyy update --version v0.1.107

사용 가능한 릴리스로 바꾸세요. --version을 생략하면 구성 출처의 최신을 따릅니다.

Compact 업데이트

공간 부족 시:

anyy update --compact

비활성부터 제거하고 활성은 유지합니다. 공간 검사를 통과하는 데 꼭 필요할 때만 이전 롤백을 제거할 수 있습니다.

롤백 이력이 사라질 수 있습니다

가능하면 수동 공간 확보를 하세요. --compact는 사용자 데이터는 보존하지만 돌아갈 바이너리가 없을 수 있습니다.

보존 항목

릴리스·명령/서비스 진입점만 바꾸며 다음 프로필 데이터는 지우지 않습니다.

• config.yaml·자격 증명.
• state.db·세션·메모리.
• 스킬·MCP.
• 워크스페이스.
• 백업·로그·캐시.

위험 높은 인프라 변경 전 독립 복구 사본이 필요하면:

anyy backup create --output /safe/path/anyy-backup.tar.gz

관리 secrets/·지원 mcp/oauth/는 --include-secrets 전까지 제외됩니다. 구성·워크스페이스는 그대로 캡처하므로 인라인 비밀은 일반 아카이브에도 포함될 수 있습니다. 모든 백업을 비공개로 보호하세요. 플래그가 비밀 없음 보장은 아닙니다.

다른 설치 출처

anyy update 자체 업데이트는 네이티브 상주만입니다. anyy update --check가 다른 출처를 보고하면 정상 절차를 쓰세요.

출처	방법
Homebrew	설치 formula의 brew upgrade ...
npm	설치 때의 패키지 관리자·이름
Docker	새 이미지 pull·컨테이너 재생성
소스	저장소 업데이트·프로젝트 지침대로 빌드

anyy update --check의 정확 안내를 따르고 패키지 파일과 네이티브 구성을 섞지 마세요.

사용자 릴리스 미러

신뢰 호환 미러 운영자는 base를 바꿀 수 있습니다.

anyy update --base-url https://releases.example.com/anyy

미러는 아티팩트와 체크섬을 모두 제어합니다

--base-url은 둘의 출처를 바꾸며 독립 무결성 권위가 아닙니다. 제어·신뢰 출처만 쓰세요.

업데이트 후 검증

실행:

anyy --version
anyy status
anyy doctor

Dashboard를 다시 열고 작은 테스트:

anyy dashboard

실행 서비스 복구 불가면 0 아닌 결과입니다. anyy gateway status로 확인·수정 후 명시 시작·재시작하세요.

Anyy 제거

대화형은 범위를 묻고 확인을 요구합니다.

anyy uninstall

두 모드:

모드	제거	유지
--keep-data	릴리스·명령·서비스	프로필 구성·데이터
--full	릴리스·명령·서비스·범위 내 전체 데이터	선택 홈에는 없음

비대화형은 명시 범위:

anyy uninstall --keep-data --yes
anyy uninstall --full --yes

--keep-data 또는 --full 범위 없는 --yes는 거부합니다.

전체 제거는 개인 데이터를 삭제합니다

anyy uninstall --full은 범위 내 구성, 비밀, 세션, 메모리, 스킬, 워크스페이스 등을 지웁니다. 필요하면 먼저 백업·검증하세요.

네이티브 상주만 지원합니다. 패키지·컨테이너·소스는 설치 시스템으로 제거하세요.

문제 해결

문제	해결
자체 업데이트 불가	anyy update --check 출처 안내
다른 설치·업데이트 실행	홈 잠금 작업 완료 대기
공간 부족	확보 후 롤백 감소 수락 시만 --compact
체크섬 실패	신뢰 출처 재시도. 우회 금지
Gateway 미복구	anyy gateway status 확인·서비스 오류 수정 후 anyy gateway start 또는 restart
제거 거부	네이티브 상주인지와 실제 --home 확인