Publisher Skill
HTML 프론트엔드 프로젝트를 게시 플랫폼에 업로드하고 선택적으로 Android APK로 패키징합니다.
플랫폼 URL:
https://pushwebly.com
사용자와의 대화에서는 "project"라는 용어를 사용하세요. 표준 API 경로는 /api/projects이며, 표준 도구 이름은 project_*입니다. 더 이상 사용되지 않는 game_* 별칭과 gameId 응답 필드가 나타날 수 있으나, gameId는 프로젝트 ID로 처리하세요.
Codex 실행 규칙
- 현재 환경에 마운트된
project_*MCP 도구가 있다면 우선 사용하세요. - 원격 MCP 도구가 마운트되어 있지 않으면
curl로 HTTP API를 사용하세요. - Python을 요구하지 마세요. 선택적 스크립트는 CLI/CI 사용자 전용입니다.
- 진정으로 누락된 정보(자격 증명, zip 경로, 프로젝트 이름, 공개/비공개 여부, 비공개 액세스 비밀번호 설정)에 대해서만 질문하세요.
- 절대 자격 증명을 프로젝트 zip이나 저장소 파일에 기록하지 마세요. 사용자 동의 후에만
~/.publisher/config.json에 저장하세요. - Windows/PowerShell에서는 인라인 JSON을 셸 이스케이프 처리하는 대신 요청 본문에 임시 JSON 파일을 사용하세요.
의도 매핑
| 사용자 의도 | 동작 | 누락 시 질문할 정보 |
|---|---|---|
| 게시, 배포, 업로드, 온라인에 올리기 | 프로젝트 게시 | zip 경로, 프로젝트 이름 |
| 설치 가능한 휴대폰 앱, APK, Android 패키지 만들기 | 게시 및 APK 빌드 | zip 경로, 프로젝트 이름 |
| 이미 게시된 프로젝트의 APK 빌드 | APK 빌드 | 프로젝트 ID; 필요한 경우 프로젝트 목록 사용 |
| 앱을 비공개/공개로 전환, 액세스 비밀번호 추가/제거 | 가시성 변경 | 앱 URL, 대상 가시성 (비공개 시 선택적 비밀번호) |
| 내 프로젝트 보기, 게시된 프로젝트 목록 보기 | 프로젝트 목록 조회 | 토큰이 있으면 없음 |
| 로그인, 등록, 계정 설정 | 로그인/등록 | 사용자 이름 및 비밀번호 |
의도가 모호한 경우 "그냥 게시만 할까요, 아니면 게시하고 Android APK도 함께 빌드할까요?"와 같이 짧은 질문을 하나만 하세요.
게시 대화 프로세스
사용자가 게시, 배포, 실행, 공유, 액세스 링크 생성 등의 의도를 표현하면 이 프로세스를 따라야 합니다.
<하드-게이트> 게시 프로세스는 차단형 유한 상태 기계입니다. 현재 단계에 사용자 입력이 없는 한, 모델은 진행을 중단하고 현재 단계에 대한 질문을 하나만 한 후 사용자의 응답을 기다려야 합니다. 컨텍스트를 바탕으로 답변을 추측하는 것은 금지됩니다. 공개/비공개를 자동으로 선택하는 것은 금지됩니다. 사용자가 명시적으로 시스템 생성을 선택하지 않는 한, 액세스 비밀번호를 자동으로 생성하는 것은 금지됩니다. 필요한 모든 단계를 완료하기 전에 릴리스 인터페이스를 호출하는 것은 금지됩니다. 각 응답에는 최대 하나의 사용자 대상 질문만 포함될 수 있습니다. </하드-게이트>
유한 상태 기계 일반 원칙
- 플로우 진입 시 먼저
S-1(버전 확인, 비차단)을 실행한 후S0 -> S1 -> S2 -> S3 -> S4순서로 진행합니다. - 단계를 건너뛸 수 없습니다(
S-1제외). - 단일 요청으로 여러 필드를 질의할 수 없습니다. 사용자가 명확히 제공한 정보는 기록할 수 있으며, 반복해서 질문할 필요가 없습니다. 사용자의 응답이 모호한 경우 현재 필드에 대해 한 번만 후속 질문하세요.
- 현재 단계가 완료된 후에만 다음 단계로 진행할 수 있습니다.
- 사용자 입력을 기다려야 하는 경우, 응답 끝에 설명, 제안 또는 다음 단계 미리보기를 추가하지 마세요.
S-1: 버전 확인 (게시 플로우의 첫 번째 노드, 비차단)
게시 플로우 진입 시 S0 전에 버전 자체 점검을 실행하세요. 이 단계는 <하드-게이트> 차단 규칙의 일부가 아닙니다: 결과가 어떻든 — 엔드포인트에 연결할 수 없어도 — 항상 계속 진행하세요. 버전 문제로 게시를 중단하지 마세요.
단계:
-
로컬 스킬 버전 읽기: 이 파일의 프론트매터에 있는
version필드. -
최신 플랫폼 버전 조회(로그인 불필요):
curl -s https://ai-pub.pushwebly.com/api/skill/latest-version응답
data에는version(최신),downloadUrl(크로스 플랫폼 문서 패키지, 압축 풀어서 사용),downloadUrlWindows(Windows 설치 프로그램 .exe),downloadUrlMac(macOS 설치 프로그램 .zip)이 포함됩니다. -
로컬
version과 반환된version을 비교합니다.비교 규칙: 버전은
major.minor.patch형식입니다. 왼쪽에서 오른쪽으로 정수 세그먼트별로 비교합니다 — 먼저 major, 그다음 minor, 그다음 patch; 누락된 세그먼트는 0으로 채웁니다(1.1은1.1.0을 의미). 문자열이 아닌 정수로 비교합니다:1.10.0은1.9.0보다 큽니다(두 번째 세그먼트10 > 9); 문자열 비교는 이를 잘못 판단합니다. 오름차순 예:1.0.0 < 1.0.9 < 1.1.0 < 1.2.0 < 1.10.0 < 2.0.0.-
로컬이 오래된 경우(로컬의 정수 세그먼트 시퀀스가 반환된 것보다 작음): 계속하기 전에 반드시 사용자에게 업데이트 알림을 출력해야 하며, 알림에는 실제 다운로드 URL이 포함되어야 합니다(게시를 차단하지는 않지만 알림을 생략해서는 안 됩니다). 사용자 OS에 따라 다운로드 URL을 선택하세요:
- Windows →
downloadUrlWindows사용 - macOS →
downloadUrlMac사용 - OS를 알 수 없거나 해당 필드가 비어 있는 경우 → 일반
downloadUrl로 폴백
알림 텍스트(사용자가 대화하는 동일한 언어로 출력 — 사용자가 중국어를 쓰면 중국어, 영어를 쓰면 영어; 하나의 언어를 하드코딩하지 마세요; 아래 예제는 템플릿으로서 영어로만 제공됩니다; URL을 실제 선택된 것으로 바꾸세요; 다운로드 URL을 클릭 가능한 Markdown 링크
[URL](URL)로 작성 — 백틱으로 인라인 코드처럼 감싸지 마세요, 그렇지 않으면 사용자가 클릭할 수 없습니다; 플레이스홀더를 남기지 말고, 링크 없이 "새 버전이 있습니다"라고 말하지 마세요):참고: 최신 Publisher 스킬 버전
<version>을 사용할 수 있습니다(현재<local version>사용 중). 다운로드: https://ai-pub.pushwebly.com/downloads/AI_Publisher_skill.exe (업데이트해도 현재 게시에는 영향을 미치지 않습니다). - Windows →
-
로컬이 같거나 더 새로운 경우: 아무 말 없이 계속 진행합니다.
-
요청 실패/시간 초과/파싱 불가: 조용히 건너뛰고, 바로
S0으로 이동하며, 오류를 표시하지 마세요.
-
-
모든 경우에 다음 단계로
S0으로 진행합니다. 이 단계는 알림만 제공할 뿐(입력 없음, 차단 없음) "응답당 최대 하나의 사용자 대상 질문" 규칙이 적용되지 않습니다 — 버전 알림은 첫 번째S0질문과 동일한 응답에 포함될 수 있습니다.
S0: 계정 상태 확인
먼저 이미 사용 가능한 토큰/로컬 자격 증명이 있는지 확인합니다.
- 이미 계정 자격 증명이 있는 경우:
S2로 이동합니다. - 계정 자격 증명이 없는 경우:
S1_USERNAME으로 진입합니다. - 계정 상태를 확인할 수 없는 경우: 사용자에게 게시 계정이 있는지 물어봅니다.
사용자에게 질문을 합니다:
먼저 게시 계정을 확인해야 합니다: 이미 사용 가능한 계정 또는 토큰이 있나요?
사용자 답변:
- 예: 사용자에게 토큰/로그인 자격 증명을 제공하거나 확인하도록 요청한 후
S2로 진행합니다. - 아니요:
S1_USERNAME으로 진입합니다.
S1: 등록 및 로그인 프로세스
S1_USERNAME: 등록할 사용자 이름 수집
사용자 이름이 없으면 다음만 물어봅니다:
등록할 사용자 이름을 입력해주세요.
사용자 이름을 받은 후 username으로 기록하고 S1_PASSWORD로 진입합니다.
S1_PASSWORD: 등록 비밀번호 수집
비밀번호가 없으면 다음만 물어봅니다:
등록 비밀번호를 입력해주세요.
비밀번호를 받은 후 password로 기록하고 S1_VALIDATE로 진입합니다.
S1_VALIDATE: 공동 검증
username과 password를 모두 가진 후에만 백엔드 인터페이스를 호출하여 공동 검증을 수행할 수 있습니다.
검증 통과:
- 계정 생성
- 로그인 완료
등록 및 로그인 성공안내S2로 진입
검증 실패:
- 백엔드에서 반환된 구체적인 오류 이유 표시
- 수정해야 할 항목에 대해서만 질문
- 등록 프로세스를 종료하지 않음
S2: 애플리케이션 가시성 문의
공개 또는 비공개 상태가 명확히 정의되지 않은 경우 다음만 물어봅니다:
이 애플리케이션을 공개로 설정할까요? 공개는 링크만 있으면 누구나 접근할 수 있고, 비공개는 6자리 액세스 비밀번호가 필요합니다.
사용자 답변:
- 공개 / 예 / public:
visibility=public기록,S4로 진입 - 비공개 / 아니요 / private:
visibility=private기록,S3로 진입 - 명확하지 않음: 이 항목에 대해서만 계속 질문
S3: 비공개 액세스 비밀번호
visibility=private인 경우 비밀번호를 직접 설정할지 물어봐야 하며, 다음만 물어봅니다:
6자리 액세스 비밀번호를 직접 설정하시겠습니까? "시스템 생성"이라고 답하셔도 됩니다.
사용자 답변:
- 비밀번호 제공: 검증은 6자리 숫자 또는 문자여야 함; 통과 후
accessPassword=<사용자 비밀번호>기록하고S4로 진입 - 시스템 생성 / 필요 없음 / 랜덤:
accessPassword를 전달하지 않고 백엔드에서 생성하도록 한 후S4로 진입 - 비밀번호 형식 오류: 형식 요구 사항만 안내하고 비밀번호를 다시 요청
S4: 게시 실행
다음 조건 중 하나가 충족되는 경우에만 게시 인터페이스 호출이 허용됩니다:
visibility=publicvisibility=private이고 사용자가 사용자 지정 비밀번호 또는 시스템 생성 비밀번호를 선택한 경우
게시 매개변수:
공개 애플리케이션:
{
"visibility": "public"
}
비공개 애플리케이션, 사용자 지정 비밀번호:
{
"visibility": "private",
"accessPassword": "a1b2c3"
}
사용자가 가시성을 지정하지 않으면 기본값은 public입니다. 비공개 액세스 비밀번호는 ^[A-Za-z0-9]{6}$와 일치해야 합니다. 그렇지 않으면 유효한 비밀번호를 요청하거나 백엔드에서 생성하도록 합니다.
토큰 처리
모든 게시 API에는 Bearer 토큰이 필요합니다.
다음 순서를 사용하세요:
- 사용자가 대화에서 토큰을 제공한 경우 직접 사용합니다.
~/.publisher/config.json이 있으면 저장된 사용자 이름/비밀번호를 읽고 다시 로그인하여 토큰을 갱신합니다.- 그렇지 않으면 사용자 이름과 비밀번호를 요청합니다. 로그인 엔드포인트는 새 계정을 자동으로 등록합니다.
로그인/등록 엔드포인트:
curl -s -X POST https://ai-pub.pushwebly.com/api/auth/login-or-register \
-H "Content-Type: application/json" \
-d @login.json
login.json을 다음과 같이 작성합니다:
{"username":"alice","password":"plain-text-password"}
응답의 data.token을 다음과 같이 사용합니다:
Authorization: Bearer <TOKEN>
사용 후 임시 로그인 파일을 삭제합니다.
선택적 로컬 자격 증명 파일:
{
"baseUrl": "https://ai-pub.pushwebly.com",
"username": "alice",
"password": "plain-text-password",
"authorization": "Bearer <TOKEN>",
"userId": 1
}
Linux/macOS에서는 작성 후 모드를 600으로 설정합니다. 401 오류 발생 시 다시 로그인하여 토큰을 한 번 갱신한 후 실패한 작업을 한 번 재시도합니다.
토큰 확인:
curl -s https://ai-pub.pushwebly.com/api/auth/verify-token \
-H "Authorization: Bearer <TOKEN>"
게시 전 확인
게시 전:
- 파일이 존재하고
.zip확장자인지 확인합니다. - zip에
index.html또는index.htm이 포함되어 있는지 확인합니다. - zip에 중첩된 디렉터리가 있는 경우 항목 파일을 찾을 수 있는지 확인합니다.
- 프로젝트 이름이 비어 있지 않은지 확인합니다.
- 유효한 토큰을 사용할 수 있는지 확인합니다.
HTTP 작업
프로젝트 게시
공개:
curl -s -X POST https://ai-pub.pushwebly.com/api/projects/publish \
-H "Authorization: Bearer <TOKEN>" \
-F "project_name=demo" \
-F "[email protected]"
비공개(선택적 사용자 지정 비밀번호):
curl -s -X POST https://ai-pub.pushwebly.com/api/projects/publish \
-H "Authorization: Bearer <TOKEN>" \
-F "project_name=demo" \
-F "[email protected]" \
-F "visibility=private" \
-F "access_password=a1b2c3"
비공개 앱의 경우 access_password를 생략하여 백엔드에서 비밀번호를 생성하도록 합니다. 응답의 최종 accessPassword는 항상 사용자에게 전달하세요.
프로젝트 목록 조회
curl -s https://ai-pub.pushwebly.com/api/projects/my \
-H "Authorization: Bearer <TOKEN>"
가시성 변경 (공개 <-> 비공개)
이미 게시된 앱을 공개와 비공개 간에 전환합니다. 입력은 앱 URL입니다. 백엔드는 앱 식별자를 파싱하여 앱이 현재 사용자 소유인지 확인합니다 — 자신의 앱만 변경할 수 있고 다른 사람의 앱은 변경할 수 없습니다.
curl -s -X PATCH https://ai-pub.pushwebly.com/api/projects/visibility \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d @visibility.json
visibility.json을 작성합니다(비공개로 전환):
{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"private","accessPassword":"a1b2c3"}
또는 공개로 전환(비밀번호 불필요; 기존 비밀번호는 삭제됨):
{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"public"}
accessPassword는 선택 사항이며 비공개로 전환할 때만 사용됩니다(6자리 숫자 또는 문자; 생략 시 자동 생성). 응답 data에는 최종 visibility, url, 그리고 비공개인 경우 accessPassword가 포함됩니다. 비공개 앱의 URL과 비밀번호는 별도로 전달하고, 절대 ?pwd=와 함께 전달하지 마세요. 앱을 찾을 수 없거나, 이미 삭제되었거나, 다른 사용자 소유인 경우 구체적인 이유와 함께 자신의 앱만 변경할 수 있다는 사실을 알리세요.
기존 프로젝트의 APK 빌드
curl -s -X POST https://ai-pub.pushwebly.com/api/apk/build \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d @build-apk.json
build-apk.json을 다음과 같이 작성합니다:
{"projectId":12}
응답의 data.apkUrl을 APK 다운로드 URL로 사용합니다.
게시 및 APK 빌드
사용자가 설치 가능한 Android 앱을 원할 때 권장되는 작업입니다.
curl -s -X POST https://ai-pub.pushwebly.com/api/apk/publish-and-build \
-H "Authorization: Bearer <TOKEN>" \
-F "project_name=airplane-war" \
-F "[email protected]"
비공개 앱의 경우 다음을 추가합니다:
-F "visibility=private" -F "access_password=a1b2c3"
access_password를 생략하면 자동 생성됩니다.
예상 응답 필드:
{
"gameId": 12,
"projectName": "airplane-war",
"playUrl": "https://ai-pub.pushwebly.com/play/aB3xYz/",
"status": "enabled",
"apkUrl": "https://ai-pub.pushwebly.com/api/apk/download/airplane-war_aB3xYz.apk",
"apkFileName": "airplane-war.apk",
"visibility": "public"
}
data.apkUrl을 사용자가 설치할 수 있는 APK 다운로드 링크로 제공하세요.