빠른 시작: 유료 기능 보호 5단계
신뢰할 수 있는 JavaScript 모듈을 yp CLI로 분석하고, 보호 계획을 확인한 다음 적용·검증하는 예제입니다.
신뢰할 수 있는 코드에서만 실행
yp protect plan과 yp protect verify는 프로젝트 코드를 실행할 수 있습니다. 샌드박스가 아니므로 운영 코드에 적용하기 전에 테스트 프로젝트에서 실행하세요.
1. 초기화
CLI를 설치한 뒤 프로젝트 디렉터리에서:
bash
yp init --yes --target src/paid.mjs
yp doctor1
2
2
src/paid.mjs는 실제 프로젝트의 존재하는 파일 경로로 변경합니다. devpay.json 설정과 .devpay/ 작업 폴더가 생성됩니다.
2. 보호 계획 생성
bash
yp protect plan1
.devpay/plan.json과 .devpay/spec.draft.json을 확인하세요.
| 판정 | 의미 |
|---|---|
AUTO | 지원되는 코드의 자동 분할 후보 |
AGENT | 에이전트·개발자에게 수정 작업 전달 |
MANUAL_REVIEW | 자동 적용 중단, 사람 검토 필요 |
이 단계에서는 소스 코드가 변경되지 않습니다.
3. 검토 및 승인
bash
yp protect review1
서버로 이동할 함수, 의존성, 미확정 위험 및 테스트 벡터를 확인하세요. 자동 적용하려면 REQUIRES_APPROVAL 항목이 없는 승인된 .devpay/spec.json이 필요합니다.
4. 적용
bash
yp protect apply1
승인된 명세나 소스의 해시가 달라지면 적용을 거부합니다. 승인 전 초안의 yp protect apply --approve는 AGENT/MANUAL_REVIEW 작업 전달만 허용하며 AUTO 코드 변경을 승인하지 않습니다.
5. 실제 검증 결과 확인
bash
yp protect verify1
.devpay/verify-report.json과 .devpay/evidence/에서 실제로 실행된 검사를 확인하세요. PARTIALLY_VERIFIED·NOT_VERIFIED는 보안 검증 완료가 아닙니다.
생성 파일
| 경로 | 역할 |
|---|---|
devpay.json | 프로젝트 설정 |
.devpay/spec.draft.json, spec.json | 초안·승인 명세 |
.devpay/plan.json | 해시로 연결된 보호 계획 |
.devpay/apply-report.json | 적용 결과 |
.devpay/verify-report.json, evidence/ | 검증 결과·증적 |
생성된 비밀정보가 포함될 수 있으니 .devpay/는 Git에 올리지 마세요.