Sanad 설치

Sanad 설치은(는) 무엇을 하나요?

검사부터 검증된 Sanad 설치 또는 업데이트까지 사용자를 안내합니다. 릴리스-사용자와 개발자-소스 워크플로를 분리하여 유지합니다.

안전 규칙

• 변경하기 전에 검사합니다. 설치, 패키지 교체, 서비스 등록, 애플리케이션 실행 및 Git 업데이트를 사용자의 명시적 승인이 필요한 변경으로 취급합니다.
• 체크아웃을 찾기 위해 전체 홈 디렉토리나 디스크를 검색하지 마십시오. 현재 디렉토리, 사용자가 제공한 경로, 표준 설치 명령어 위치만 검사합니다. 안전하게 식별할 수 없는 경우 프로젝트 경로를 묻습니다.
• 사용자가 해당 작업을 명시적으로 승인하지 않는 한, 더티 저장소를 덮어쓰기, 리셋, 정리, 스태시, 커밋 또는 폐기하지 마십시오.
• 액세스 토큰, 갱신 토큰, 제공자 자격 증명, 서명 시크릿 또는 사용자 콘텐츠를 요청, 인용, 기록 또는 재구성하지 마십시오. 명시적으로 승인된 에이전트 작동 원격 설치의 경우에만 사용자의 완전한 디바이스 추가 명령(단기 단일 사용 생성 토큰 포함)을 수락합니다. 공식 부트스트랩을 검증하고, 에코, 추적 또는 프로젝트 아티팩트에 지속시키지 않고 전송하며, 해당 토큰을 추출/재구성하지 마십시오. 이 동의가 채팅/도구 기록에 생성 명령이 노출됨을 포함하며, 생성된 설치 프로그램 명령이 토큰 인수를 사용할 수 있음을 설명하고, 제로 노출을 주장하지 마십시오. SSH 전송 인수는 자격 증명 없이 유지합니다. 사용자가 해당 노출을 수락하지 않으면 직접 실행하거나 대화형 Portal 로그인을 사용하도록 하십시오. 이 예외는 지속적인 자격 증명에는 적용되지 않습니다.
• 공식 Sanad 소스만 사용합니다:
  • 저장소: https://github.com/EastStarAI/sanad-agent
  • 릴리스: https://github.com/EastStarAI/sanad-agent/releases/latest
  • 설치 프로그램: https://sanad.eaststarai.com/install.sh 및 https://sanad.eaststarai.com/install.ps1
• 운영 체제 보안 제어를 비활성화하지 마십시오. 현재 서명 또는 플랫폼 지원을 설명하기 전에 최신 릴리스 노트를 읽습니다.
• 설치 및 업데이트 중 Sanad 홈 및 사용자 작업 공간을 보존합니다.

Google Cloud 빠른 경로

Google Cloud / GCP / 무료 클라우드 서버 요청의 경우 references/google-cloud-free-tier.md를 읽고 아래의 일반적인 로컬/소스 질문 대신 해당 전문화된 릴리스-사용자 경로를 따릅니다. 전제 조건, 최대 두 개의 초기 질문, 리소스 재사용, 적격 프로비저닝, 적시 페어링 및 최소한의 내장 검증을 소유합니다. 위의 안전 규칙을 유지합니다. 무조건적인 제로 청구서를 약속하거나 기존 무료 허용량을 중복하지 마십시오.

1. 대상 검사

명령이 사용자의 현재 시스템에서 실행될지 원격 시스템에서 실행될지 확인합니다. Sanad 클라이언트를 호스팅하는 시스템이 Sanad 에이전트를 호스팅해야 하는 시스템이라고 가정하지 마십시오.

읽기 전용 증거를 수집합니다:

1. 운영 체제 및 아키텍처를 식별합니다.
2. sanad 및 sanad-dev가 PATH에서 확인되는지 확인합니다.
3. 관련된 경우 설치 프로그램 소유 실행 파일을 확인합니다:
   • macOS/Linux: ${SANAD_HOME:-$HOME/.sanad}/bin/sanad
   • Windows: $env:SANAD_HOME\bin\sanad.exe 또는 $HOME\.sanad\bin\sanad.exe ( SANAD_HOME이 설정되지 않은 경우).
4. 현재 또는 제공된 디렉토리가 Git 체크아웃인 경우 다음을 검사합니다: git rev-parse --show-toplevel, git remote -v, git status --short --branch, git worktree list. 저장소 ID가 EastStarAI/sanad-agent와 일치하거나 사용자가 의도적인 포크를 확인한 경우에만 Sanad 소스로 수락합니다.
5. 설치된 버전 및 서비스 상태는 확인된 Sanad 실행 파일을 통해서만 쿼리합니다. sanad가 PATH에 없어서 단순히 실패하지 마십시오.

변경을 제안하기 전에 존재하는 내용을 요약합니다.

2. 워크플로 선택

사용자의 요청이 이미 워크플로를 명시적으로 지정한 경우 대상을 확인하고 계속합니다. 그렇지 않으면 다음 선택 사항을 제시하고 원하는 것을 묻습니다:

경로	최적 대상	결과	트레이드오프
릴리스 / 사용자	일반 일상 사용	패키지된 클라이언트 및 검증된 에이전트 릴리스	안정적이고 간단함; 소스를 편집할 수 없음
소스 / 개발자	Sanad 기여, 디버깅 또는 변경	sanad-dev를 통해 실행되는 저장소 체크아웃	편집 및 테스트 가능; 개발 도구와 더 많은 디스크 공간 필요

릴리스 경로의 경우 토폴로지를 결정합니다:

• 이 데스크탑: Sanad 클라이언트 설치; 로컬 실행은 일치하는 에이전트를 동일한 컴퓨터에 설치하고 시작합니다.
• 다른 컴퓨터 또는 서버: 클라이언트를 데스크탑, 모바일 또는 웹에 유지하고 대상 시스템에 Sanad 에이전트만 설치합니다.
• 클라이언트만: 데스크탑/모바일 클라이언트를 설치하거나 해당 장치에 에이전트를 설치하지 않고 웹 클라이언트를 사용합니다.

정확한 작업, 대상 및 서비스 영향을 명시합니다. 다운로드, 설치, 교체, 등록, 시작 또는 재시작 전에 승인을 받습니다.

3. 릴리스 / 사용자 경로

클라이언트 및 로컬 에이전트 설치

1. 최신 공식 릴리스와 해당 매니페스트를 읽습니다. 확인된 플랫폼 및 아키텍처와 일치하는 클라이언트 패키지만 선택합니다.
2. 해당 릴리스에서 게시된 체크섬, 서명 및 플랫폼 지침을 사용하여 아티팩트를 검증합니다. 이전 릴리스의 서명 상태를 현재 릴리스로 일반화하지 마십시오.
3. 일반 운영 체제 흐름을 사용하여 클라이언트를 설치합니다. 애플리케이션 검토 또는 보안 프롬프트를 자동으로 우회하지 마십시오.
4. 사용자에게 Sanad 클라이언트를 시작하고 로컬 실행을 선택하도록 요청합니다. 클라이언트가 일치하는 로컬 에이전트를 다운로드, 검증, 등록, 시작 및 연결한다고 설명합니다. Sanad 계정 및 페어링 토큰이 필요하지 않습니다.
5. 성공을 선언하기 전에 클라이언트가 로컬 에이전트에 연결할 수 있는지 확인합니다.

Android, iOS 및 Web의 경우 현재 릴리스 노트에 명시된 가용성을 따릅니다. 이러한 플랫폼은 인터페이스를 제공하지만 기본 에이전트 서비스를 호스팅하지 않습니다.

다른 컴퓨터 또는 서버에 에이전트 설치

두 가지 동등한 선택을 제공합니다:

1. Sanad 클라이언트를 통해 페어링: 설정을 열고 설정 사이드바에서 장치 옆에 있는 **+**를 클릭하여 디바이스 추가를 엽니다. 사용자가 대상 시스템에서 생성된 전체 명령을 실행하도록 하거나, 단일 사용 생성 토큰 예외 하에 승인된 원격 설치를 위해 사용자의 전체 생성 명령을 수락합니다. 자격 증명을 별도로 요청하거나 명령을 보고서에 에코하지 마십시오.
2. 에이전트 직접 설치: Portal 로그인 또는 로컬 전용 모드를 선택하고 승인 후 일치하는 공식 설치 프로그램을 실행합니다.

에이전트 작동 macOS/Linux 터미널의 경우 모호한 프롬프트를 피합니다:

curl -fsSL https://sanad.eaststarai.com/install.sh | bash -s -- --login

사용자가 명시적으로 로컬 전용 모드를 선택한 경우 대신 --no-login을 사용합니다.

에이전트 작동 Windows PowerShell 터미널의 경우:

& ([scriptblock]::Create((irm https://sanad.eaststarai.com/install.ps1))) -Login

사용자가 명시적으로 로컬 전용 모드를 선택한 경우 대신 -NoLogin을 사용합니다. 대화식으로 설치 프로그램을 실행하는 사람은 명시적 로그인 옵션을 생략하고 프롬프트에 응답할 수 있습니다.

Portal 로그인은 사용자가 URL을 열거나 코드를 입력해야 할 수 있습니다. 반환된 자격 증명을 노출하지 않고 해당 사람의 작업을 위해 일시 중지합니다. 설치 후 확인된 실행 파일의 버전과 service status를 확인합니다. 클라우드 연결이 선택된 경우 Sanad 클라이언트에서 장치를 확인합니다.

패키지 설치 업데이트

1. 변경 전에 설치된 클라이언트 및 에이전트 버전을 검사하고 최신 릴리스 노트를 읽습니다.

2. 플랫폼 소유 업데이트 흐름을 통해 Sanad 클라이언트를 업데이트합니다. 패키지된 클라이언트를 소스 출력으로 교체하지 마십시오.

3. 확인된 실행 파일을 통해 독립 실행형 에이전트를 업데이트합니다:

   sanad update
   

   sanad가 PATH에 없는 경우 전체 실행 파일 경로를 사용합니다. 업데이트 프로그램이 restart_required를 보고하면 승인을 받고 sanad service restart를 실행합니다.

4. 최종 버전, 서비스 상태, 클라이언트-에이전트 연결 및 Sanad 홈 보존을 확인합니다. 수동으로 남아 있는 플랫폼 단계를 보고합니다.

4. 소스 / 개발자 경로

체크아웃 준비

일치하는 체크아웃이 이미 존재하는 경우 해당 경로, 분기, 작업 트리, 원격 저장소 및 더티 상태를 보고한 후에만 사용합니다. 자동으로 중복 복제하지 마십시오.

체크아웃이 없는 경우 대상을 제안하고 승인을 받은 후 다음을 실행합니다:

git clone https://github.com/EastStarAI/sanad-agent.git sanad-agent
cd sanad-agent

추가 작업 전에 저장소 AGENTS.md, docs/llms.txt 및 가장 가까운 중첩 계약을 읽습니다. 모든 Dart 또는 Flutter 작업에 FVM을 사용합니다.

사용자 범위 개발 명령을 한 번 설치합니다.

macOS/Linux:

scripts/sanad-dev install

Windows PowerShell:

.\scripts\sanad-dev.ps1 install

그런 다음 모든 플랫폼에서 일치하는 에이전트 및 클라이언트 쌍을 실행합니다:

sanad-dev run

사용자가 명시적으로 로컬 전용 개발을 원하는 경우에만 sanad-dev run --no-cloud를 사용합니다. 검증을 위해 sanad-dev status 및 제한된 sanad-dev logs agent -n 50 및 sanad-dev logs client -n 50 호출을 사용합니다. AI 도구 호출에서 로그 추적 모드를 사용하지 마십시오.

개발자 체크아웃 업데이트

1. 활성 분기, 업스트림, 작업 트리 및 더티 파일을 검사합니다.
2. 의도된 원격 저장소를 확인한 후에만 git fetch를 실행합니다. 통합 전에 들어오는 커밋을 설명합니다.
3. 의도된 추적 분기의 클린 체크아웃에 대해 git pull --ff-only를 제안합니다. 암시적으로 병합 커밋을 생성하지 마십시오.
4. 더티 체크아웃의 경우 중지하고 보존 옵션을 제시합니다. 명시적 승인 없이 스태시, 커밋, 리베이스, 전환, 리셋 또는 폐기하지 마십시오.
5. 성공적인 소스 업데이트 후 플랫폼별 sanad-dev install을 다시 실행합니다. 그런 다음 sanad-dev run 또는 사용자가 요청한 제한된 검증 명령을 사용합니다.
6. 소스/FVM 런타임에 sanad update를 사용하지 마십시오. 소스 업데이트는 Git과 sanad-dev에 속합니다.

5. 결과 보고

다음을 보고합니다:

• 선택한 워크플로 및 대상 시스템;
• 감지 및 최종 버전;
• 클라이언트, 에이전트, 저장소 및 서비스 상태;
• 검증 명령 및 결과;
• 여전히 필요한 수동 사용자 작업;
• 변경된 파일, 서비스 또는 Git 상태.

다운로드 또는 명령 종료 자체만으로 성공을 주장하지 마십시오. 관련 서비스 또는 클라이언트-에이전트 상태 증거를 요구합니다. 사용자가 별도로 명시적으로 요청하지 않는 한 사용자 데이터를 커밋, 푸시, 게시 또는 제거하지 마십시오.