VibePackr Enterprise · 설치와 업무 실행 안내

Install&Setup_Guide

v10 상세 참조 · 기반 v09 · 2026-11-03

설치 → 데이터 연결 → 업무 실행 → 감사보고서

GCP 또는 debian-work의 기존 Debian 13 서버에 설치하고, 기존 9종 시험 데이터마켓의 세 업무를 조회·계산해 PDF와 JSON으로 남기는 안내입니다. 설치 묶음과 실행기는 Apple Silicon macOS·Windows x86_64·Linux x86_64 관리자 환경을 지원합니다.

관리자가 사용하는 Antigravity 등 에이전트에 이 문서와 업무 실행 안내를 전달해 같은 순서로 진행할 수 있습니다. 기존 에이전트·Skills·MCP 시작 안내도 포함되어 있습니다.

Before you start · 설치 구성 확인

서버 설치, 관리자 PC의 클라이언트 설치, 계정·인증 연결, 실제 업무 실행을 순서대로 진행합니다. 서버 설치 파일은 Debian VM에서 사용하고 데스크톱 클라이언트는 사용자의 Mac·Windows·Linux에 설치합니다.

구성	역할과 확인
VM 어플라이언스	관리자가 지정한 VPC 또는 debian-work 안의 서버에 Headless와 감사 기록 서비스를 설치합니다. 서버 주소·SSH 사용자·키 경로·알려진 호스트 키와 설치 권한을 준비합니다.
설치·연결 Workflow	OS별 Start-Setup으로 접속 확인·설치, Start-Work로 기존 9종 데이터마켓의 3개 업무를 실행합니다.
데스크톱 클라이언트	PackrGUI·Builder·도구·로컬 매뉴얼·공통 Skills/MCP 자료를 버전별 폴더로 함께 설치합니다. 실제 포함 구성요소와 파일명은 함께 제공하는 릴리스 목록을 확인합니다.

파일을 열기 전에 제공 출처, OS·CPU·릴리스 버전과 SHA-256을 확인합니다. 이전 설치 폴더와 개인 접속 프로필은 새 버전 확인이 끝날 때까지 보존합니다. 검사값이 맞아도 파일 제공자의 신뢰 여부를 따로 확인해야 합니다.

준비할 정보

설치 대상: GCP 프로젝트·VPC·VM 또는 로컬 VM 주소. 이 설치 화면은 이미 준비된 서버를 사용합니다.
관리 접속: SSH 사용자, 키 파일 또는 승인된 인증 방식, 포트, 호스트 키. 외부 IP가 없는 GCP 서버는 관리자가 먼저 IAP/SSH 경로를 준비합니다.
고객 접속: 예상 Appliance·조직 신원, 서버 주소와 TLS 이름, 본인 기기의 인증서·개인 키 파일 참조.
업무 접속: 데이터마켓 API 방식, 로컬 터널 포트, 개인 접근 정보 파일 경로. 실제 암호·토큰은 요청문이나 설치 묶음에 넣지 않습니다.

Desktop installation · OS별 클라이언트 설치

환경	설치와 실행	선행 조건
macOS · Apple Silicon	제공된 DMG에서 VibePackr Client 폴더 전체를 승인된 사용자 앱 위치로 복사합니다. Open Manual.command를 먼저 열고 Apps/PackrGUI/Packr.app을 실행합니다.	Apple Silicon 지원 버전. DMG 자체는 Apple의 서명·공증을 의미하지 않습니다. OS에서 차단하면 오류를 보존하고 조직이 승인한 배포본을 사용합니다.
Windows · x86_64	로그인한 데스크톱 사용자로 제공된 MSI를 설치합니다. 버전별 사용자 폴더와 시작 메뉴의 VibePackr Manual·Packr 바로가기를 확인합니다.	WebView2, OpenSSH Client, Windows tar. 시스템 전체 설치가 필요한 경우에만 조직의 관리자 절차를 사용합니다.
Debian 13 · x86_64	제공된 DEB를 승인된 패키지 관리자로 설치합니다. 앱 메뉴의 VibePackr Manual과 Packr를 열고 버전별 /opt/vibepackr-client 폴더를 확인합니다.	패키지가 선언한 GTK·WebKit 등 네이티브 라이브러리와 그래픽 로그인 세션.

앱만 따로 복사하지 마세요. Apps·bin·Manuals·agent kit의 상대 경로를 유지합니다. 폐쇄망에서는 OS 실행 라이브러리를 미리 준비합니다. 선택형 Rust/SDK 의존성 묶음은 WebView2나 GTK·WebKit을 대신하지 않습니다.

검증된 설치 파일과 현재 확인 범위는 릴리스 구성과 진행 현황에서 확인합니다. 다른 버전의 설치 확인을 현재 버전의 설치 완료로 간주하지 않습니다.

Server installation · 대상 서버에 설치

묶음을 새 폴더에 풉니다. Mac은 Workflow/Start-Setup.command, Windows는 Workflow/Start-Setup.cmd, Linux는 Workflow/Start-Setup.sh를 실행합니다.
열린 Start-Setup 화면에서 GCP 또는 debian-work를 선택하고, 설치할 서버의 주소·포트·SSH 사용자와 키 파일 또는 암호를 입력합니다. 기존 SSH 별칭은 직접 선택할 수 있는 입력 보조 기능입니다.
알려진 서버 키를 확인하는 접속 설정을 지정합니다. GCP의 외부 IP가 없으면 관리자가 준비한 IAP/SSH 접속을 사용합니다. 설치할 서버는 지정한 VPC에 미리 준비되어 있어야 합니다.
접속 확인 결과의 서버 신원을 확인한 뒤 설치합니다. 완료 화면에서 서비스 상태와 설치 결과를 확인합니다. 설치 위치는 제품의 /opt/vibepackr, /etc/vibepackr, /var/lib/vibepackr입니다.

Windows에는 OpenSSH 클라이언트와 Windows 기본 tar가 필요합니다. 직접 접속할 수 없는 서버는 관리자가 먼저 SSH/IAP 터널을 준비하고 그 로컬 주소와 포트, 원 서버 키의 별칭을 입력합니다. Windows 화면의 경유 서버 직접 실행은 지원하지 않습니다. 모든 운영체제에서 설치 상태는 배포 묶음 밖의 개인 폴더에 보존됩니다.

설치 중 응답이 끊겼다면 같은 작업의 보존된 기록에서 상태 확인·복구를 먼저 진행합니다. 완료 여부가 불명확한 설치를 새 작업으로 반복하지 마세요. 상세 화면은 설치 도우미 사용법을 참고합니다.

Agent setup · 계정·Skills·MCP 연결

설치 서버의 setup.sh와 관리자 안내를 따라 최초 소유자·고객 접속을 준비합니다. 새 레거시 시스템이나 모델을 연결할 때 서버 설치를 반복하지 않습니다.
AI 에이전트가 실제 실행되는 OS에 맞는 릴리스 어댑터와 공통 Skills 자료를 사용합니다. VM에서만 실행하는 에이전트는 VM 어댑터를 사용합니다.
개인 설정 요청으로 생성한 설명자를 Antigravity 등 해당 런타임에 가져옵니다. 기존 등록과 개인 키는 보존합니다.
initialize 후 tools/list가 해당 릴리스의 공개 catalog와 정확히 일치하는지 확인하고, setup.status와 작은 읽기 전용 동작으로 실제 연결을 확인합니다. 현재 서버와 해당 OS 릴리스의 클라이언트 어댑터의 공개 도구는 18개입니다. 클라이언트는 docs/agent-mcp-catalog.json의 릴리스·OS·바이너리 해시가 함께 맞아야 합니다. 호스트에서 도구 허용 목록을 사용하면 실제 노출 도구는 그 목록으로 제한됩니다. 로컬 stdio MCP 어댑터가 원격 VM 터널을 자동으로 만드는 것은 아닙니다.

서버 주소와 인증서는 관리자가 제공한 같은 조직·릴리스의 것을 사용합니다. 실제 모델 실행과 최종 결과 수락은 연결 확인과 별도 단계입니다.

2. 데이터와 감사 기록의 접속을 구분해 준비

연결	입력과 확인
업무 데이터	아래 두 API 방식 중 실제 데이터마켓과 일치하는 것을 선택합니다. 관리자가 만든 SSH/IAP 터널의 로컬 포트를 사용합니다.
감사 기록	이 컴퓨터의 설치된 Headless를 사용하거나, 설치 서버의 개인 mTLS 접속 설정 파일을 지정합니다. 설정 파일에는 서버 주소·이름과 인증서·개인 키의 파일 참조가 들어갑니다.

원격 고객 접속을 처음 준비할 때는 설치 서버의 고객 접속 안내에 따라 기존 관리자 권한으로 인증 세트를 등록하고 상태를 확인합니다. 인증 파일과 개인 키는 묶음·보고서에 넣지 않습니다. 원격 접속 설정이 없다면 서버 관리자는 배포된 Linux 실행기를 설치 서버에서 해당 Headless 서비스 계정으로 실행하는 로컬 접속 방식도 사용할 수 있습니다. 실제 서비스 계정과 소켓 경로를 확인한 뒤 지정하세요.

API 방식	실제 연결과 입력	업무 범위
`SPLIT_NINE_R0` 9개 개별 인증 API	ERP·CRM·SCM·SRM·PIM·PLM·DAM·OMS·WMS의 원격 9081~9089를 관리자의 연속 로컬 포트에 연결합니다. 소유자 전용 접근 정보 파일 경로를 지정합니다.	기존 상품 출시·주문/재고·신용/미수금 세 시나리오의 관측 결과를 PackrGUI 양식의 최종 감사보고서에 담습니다.
`UNIFIED_TEST_MARKETS_V1` 기존 GCP 단일 조회 API	원격 9081 한 포트만 연결합니다. 상품 ID를 입력하며 접근 정보 파일은 `null`입니다. 9종 목록과 읽기 전용·공개/합성 자료 표시를 확인합니다.	상품·주문/재고 관측을 계산합니다. 원본에 신용·미수금 필드가 없으면 해당 시나리오는 `BLOCKED_DATA_MISSING`, 전체 업무 결과는 `STOP_WITH_FINDING`으로 기록합니다.

이 연결기는 기존 공개 관측·합성 시험 자료의 정해진 API 형식을 지원합니다. 실제 ERP를 연결할 때는 해당 자료의 의미·단위·접근 범위를 맞춘 승인된 연결을 사용해야 합니다. 네트워크에서 조회한 시각과 원 업무 데이터의 갱신 시각은 다를 수 있습니다.

3. 세 업무를 한 번에 실행

Mac은 Workflow/Start-Work.command, Windows는 Workflow/Start-Work.cmd, Linux는 Workflow/Start-Work.sh를 실행하면 업무 요청과 출력 언어(auto/en/ko), 감사 기록 대상, 데이터 연결 방식, 포트, 개인 파일 참조, 결과 폴더와 새 실행 이름을 차례로 입력합니다. 같은 실행 이름의 기존 폴더가 있으면 다시 실행하지 않습니다.

에이전트나 자동화에서는 개별 API 요청 예 또는 단일 API 요청 예의 개인 경로와 접속 값을 실제 환경에 맞춰 바꿉니다. 공개 입력 형식도 제공합니다.

./bin/macos-arm64/packr-enterprise-guide   --bundle "$GUIDE_DIRECTORY"   --remote-config "$PRIVATE_ACCESS_PROFILE" < "$REQUEST_FILE"

# 이 컴퓨터의 Headless를 사용할 경우
./bin/macos-arm64/packr-enterprise-guide   --bundle "$GUIDE_DIRECTORY"   --socket "$LOCAL_CONTROL_PLANE_SOCKET" < "$REQUEST_FILE"

Windows 자동화에서는 PowerShell의 입력 인코딩 대신 개인 UTF-8 JSON 파일을 직접 지정할 수 있습니다.

& "$GuideDirectory\bin\windows-x86_64\packr-enterprise-guide.exe" --bundle "$GuideDirectory" --remote-config "$PrivateAccessProfile" --request-file "$PrivateRequestFile"

Windows에서는 개인 파일과 결과 폴더에 현재 사용자·SYSTEM만 접근하는 개인 권한을 사용합니다. 기존에 등록된 Headless와 로컬 세션의 인증 조건을 충족할 때만 로컬 방식을 사용하고, 설치 서버에 등록된 인증 접속이 준비돼 있으면 원격 프로필을 선택합니다. Windows 서비스의 등록·인증 정책은 이 실행기가 바꾸지 않습니다.

Linux 관리자 환경에서는 실행 파일 경로의 macos-arm64를 linux-x86_64로 바꿉니다. 위 변수는 관리자가 지정한 실제 절대 경로입니다. 요청 파일에는 암호나 토큰 본문을 쓰지 않습니다.

PackrGUI의 기존 요청 → 기존 데이터마트 Workflow에서도 같은 네이티브 실행기를 사용합니다. 감사 기록 대상과 데이터 연결 방식을 선택하고 입력 후 3개 Workflow 모두 실행을 누릅니다. 위 클라이언트 설치에서 이 기능이 포함된 PackrGUI를 설치한 뒤 사용합니다. 업무 실행 묶음의 경로는 설치된 버전을 지정합니다.

화면 언어와 출력 언어

PackrGUI와 대화식 실행기의 기본 UI는 영어입니다. 업무 결과와 감사보고서는 실제 user_input의 언어를 따르며 화면·OS 언어나 데이터마켓 자료 언어로 바뀌지 않습니다. 현재 지원 언어는 영어와 한국어입니다.

결과·보고서 언어에서 English 또는 Korean을 지정하면 해당 선택이 우선합니다. Auto는 요청에서 언어를 판단합니다. 요청의 명시 지시는 Output language: en, 출력 언어: 한국어, “Please write the report in Korean”, “영어로 작성해 주세요” 형식도 지원합니다. 충돌·불명확·미지원 언어는 실행 전에 선택을 요청합니다. 숫자·실행 이름·상품 ID만으로 언어를 추정하지 않습니다.

자동 판단은 추가 모델 호출 없이 영어·한국어 요청에 한정해 수행합니다. 짧거나 혼합된 문장이 불명확하면 출력 언어를 직접 선택하세요. 원자료·인용문·고유명사·상태 코드·책임 고지 원문은 번역하지 않습니다. 한국어 보고서는 책임 고지의 한국어 안내와 정식 영어 원문을 함께 제공합니다. 기존에 발행한 보고서는 바뀌지 않습니다.

4. 결과와 감사보고서 확인

개인 결과 폴더 아래 새 실행 폴더에 다음 기록이 생성됩니다.

파일	확인할 내용
`business-observations.json`	세 업무의 실제 관측·계산값, 출처 분류, 업무 완료 또는 누락 상태
`source-responses.json`	조회한 원 응답과 해시. 업무 요약과 함께 정식 입력 자료로 연결됩니다.
업무별 관측 결과	상품 출시·주문/재고·신용/미수금의 결과는 최종 감사보고서의 Business Results에 포함됩니다. 별도 상품 폼이나 업무별 PDF는 새로 생성하지 않습니다.
`prepared-audit.json`	실행 전에 보존한 정확한 요청. 원격 결과가 불명확할 때 기존 결과를 조회하는 데 사용합니다.
`canonical-result.json` · `canonical-report-reference.json`	정식 Work·영수증·완료 기록·보고서 참조
`final-report.pdf` · `final-report.json`	원격 방식에서 검증해 내려받은 정식 보고서. 로컬 방식은 참조 파일에 표시된 원래 보고서 경로를 사용합니다.
`result.json` 또는 `failure.json`	확인된 결과 또는 최초 실패. 결과가 불명확하면 새 실행 전에 이 기록을 확인합니다.

감사보고서 첫 장의 업무 결과, Work 식별자, 원자료 연결, 영수증·완료 기록과 책임 고지를 확인합니다. 업무 데이터 변경과 사람의 최종 수락은 자동으로 수행하지 않습니다.

표시	의미
`OBSERVATIONS_COMPLETED`	요청한 세 업무의 관측·계산이 끝났습니다. 최종 수락과 구분합니다.
`STOP_WITH_FINDING`	누락 자료 등 확인 사항이 있습니다. 해당 업무를 전체 성공으로 보지 않습니다.
`AWAITING_HUMAN_ACCEPTANCE`	정식 실행·보고서가 기록됐으며 사람의 최종 수락은 대기 중입니다.

CLI 종료값은 0 관측 완료, 2 확인 사항이 기록된 부분 결과, 1 실패·불명확 결과입니다. 종료값과 함께 구조화된 결과를 확인하세요.

5. 응답이 끊겼을 때

원격 실행의 prepared-audit.json이 남아 있으면 아래 조회 명령으로 원래 실행의 결과만 확인합니다. 이 명령은 업무를 다시 실행하지 않습니다.

./bin/macos-arm64/packr-enterprise-guide   --bundle "$GUIDE_DIRECTORY"   --remote-config "$PRIVATE_ACCESS_PROFILE"   --recover-prepared "$RUN_DIRECTORY/prepared-audit.json"

COMPLETED는 원래 Work 결과가 확인됐다는 뜻입니다. 원래 Work의 수락 상태와 업무의 누락 상태는 그대로 유지됩니다. UNKNOWN 또는 RESERVED_INCOMPLETE면 기존 기록과 연결을 확인하고, 실행 이름·키를 바꿔 같은 업무를 임의 재전송하지 마세요.

로컬 방식에서는 기존 Headless의 Work 목록·상세에서 결과를 확인합니다. PackrGUI 원격 결과의 보고서 버튼은 내려받은 파일의 해시를 확인해 엽니다.

묶음 확인

./bin/macos-arm64/packr-enterprise-guide   --bundle "$GUIDE_DIRECTORY" --verify-bundle

확인된 묶음은 GUIDE_BUNDLE_VERIFIED를 반환합니다. 파일·버전·체크섬 확인이며 운영 배포 승인이나 업무의 최종 수락을 대신하지 않습니다.

이 패키지는 서명·외부 배포 심사와 구분되는 로컬 검증 후보입니다. 개인 인증·고객 업무 자료·개발 증거는 배포 묶음에 포함하지 않습니다.

v09 · 세 OS GUI와 실제 Codex 연결 확인

Mac·Windows·Linux에서 PackrGUI의 기본 영어 화면, Request의 기존 데이터마켓 업무, 같은 Work의 15쪽 A4 v3 감사보고서 PDF 열기를 확인했습니다. Mac의 한국어 입력은 한국어 결과, Windows·Linux의 영어 입력은 영어 결과로 출력됐습니다. 자동 판단은 현재 EN/KO 기준이며 언어를 직접 선택할 수 있습니다.

이번 업무 시험은 임시 서버의 9종 합성 데이터와 승인된 3개 시나리오를 사용했습니다. 상품 마진 58,000원·판매 가능 재고 30개·신용 사용률 95%를 대조했습니다. 업무 원자료 변경·모델 호출·최종 사람 수락은 수행하지 않았습니다.

통합 안내는 v09입니다. Mac/Linux 설치물은 검증된 v07을 보존하고 Windows는 시작 경로와 보고서 열기 상태 표시를 고친 v09입니다. Linux GUI·Codex 검증은 debian-work에 동일 릴리스 파일을 배치한 실제 데스크톱에서 수행했고, DEB 설치 자체는 별도 시험 VM에서 검증한 근거를 재사용합니다.

설치물 내부의 v07 안내서는 당시 상태의 보존본입니다. 최신 How-to와 결과는 이 최상위 안내서와 기존 초보자 매뉴얼을 사용하세요.

세 OS의 실제 Codex에서 읽기 전용 setup.status와 공개 catalog18개·허용 도구1개·스킬 목록11개를 확인했습니다. Antigravity의 실제 연결, 모델의 Skill 본문 사용, 고객 Appliance/소유자/runtime binding과 초보자 무도움 재현은 아직 확인하지 않았습니다.

접속·보고서 문제 해결

Windows에서 HOME을 따로 지정하지 않았다면 사용자 프로필 경로를 사용합니다. 수정판 설치 후 시작 메뉴의 해당 버전 Packr를 엽니다.
개인 접속 파일은 현재 사용자와 SYSTEM만 접근하도록 소유자와 상속 차단까지 준비합니다. 권한 오류가 나면 원래 파일을 보호한 뒤 새 실행 여부를 기존 기록으로 판단합니다.
PDF 열기는 OS의 연결 프로그램을 사용합니다. 파일이 실제로 열리는지 확인하며, 보고서 조회·열기는 업무 재실행이나 최종 수락이 아닙니다.
기존 실행 결과가 불확실하면 동일 실행을 다시 제출하지 말고 아래 복구 절차로 조회합니다.

OS별 Work·보고서 해시·검증 범위

완료 확인

서버 신원·설치 파일·서비스 상태·정상 작동 여부 확인가 제공된 릴리스와 일치합니다.
각 OS의 실제 설치된 PackrGUI를 열고 기본 영어 화면과 접속 상태를 확인합니다.
Request에서 실제 요청을 입력해 9종·3개 업무를 실행하고 같은 Work의 정식 감사보고서를 엽니다.
PackrGUI A4 양식의 PDF·JSON, 원자료 연결과 출력 언어를 확인합니다. 누락 데이터와 최종 수락 대기는 숨기지 않습니다.
시험 후 소유한 임시 접속·프로세스를 정리합니다. 시험 VM은 정상 종료하고 원 디스크와 결과를 보존합니다.