이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

레지스트리 규칙과 검사

커뮤니티 패키지 레지스트리: 이름 규칙, 제한, 자동 검사, 서명된 인덱스, 퍼블리셔 패널, API, 에이전트용 Markdown.

2026년 11월 19일 업데이트 Markdown으로 보기

AI Game Dev 커뮤니티 레지스트리에 업로드된 모든 버전은 누구나 설치할 수 있기 전에 자동으로 검사되며, 수동 검토 대기열은 없습니다. 이 페이지는 패키지가 따라야 하는 규칙, 각 검사가 무엇을 어떤 이유로 거부하는지, 게시된 버전이 서명된 인덱스를 통해 사용자에게 도달하는 방식, 퍼블리셔 패널, 레지스트리의 API, 그리고 AI 에이전트가 읽는 Markdown 페이지를 설명합니다.

이름

  • 퍼블리셔 id는 2~40자의 소문자, 숫자, 단일 하이픈으로 구성되며 선착순입니다. 예약됨: aigd, 엔진 이름 unity, godot, unreal, brutal, bevy, threejs, 상표와 역할 단어(anthropic, claude, openai, official, admin, samples …), 숫자를 글자로 접었을 때 비슷하게 보이는 id(un1ty), 예약된 이름을 단어나 접두사로 사용하는 모든 id(unity-tools, my-godot). 예약된 이름은 AI Game Dev가 실제 소유자에게 할당할 수 있습니다.
  • 패키지 id는 <publisher>.<name> 형식이며 매니페스트와 일치해야 합니다. aigd.image처럼 앱이 예약한 id는 거부됩니다.
  • 우선순위: 앱은 aigd.* id에 대한 커뮤니티 항목이나 AI Game Dev 자체 인덱스에 나열된 id에 대한 커뮤니티 항목을 무시하므로, 누구도 공식 패키지를 가릴 수 없습니다.

제한

제한값
아카이브(gzip)압축 50 MiB, 압축 해제 200 MiB
파일아카이브당 5,000개, 파일당 64 MiB
계정당 퍼블리셔3
업로드시간당 20회(계정 기준, 토큰 업로드의 경우 퍼블리셔 기준)
검사 대기 중인 버전퍼블리셔당 5
활성 퍼블리셔 토큰퍼블리셔당 10개, 각각 최대 365일 유효
신뢰된 퍼블리셔패키지당 10
릴리스 노트버전당 20 KB의 Markdown
채널패키지당 5

자동 검사

아카이브는 신뢰할 수 없는 데이터로 취급됩니다. 크기 제한 아래에서 메모리에서 압축이 풀리고 바이트로 읽히며, 절대 실행되지 않습니다. 검사는 다음 순서로 실행되며, 보고서에는 각 검사의 결과가 나열됩니다:

검사거부 대상
archivegzip이 아닌 모든 것; 제한을 초과한 아카이브; 심볼릭 링크, 하드 링크, 장치, 절대 경로, .., 제어 문자, Windows에서 유효하지 않은 이름, 대소문자만 다른 중복 이름, .git/
manifest앱이 로드하지 않을 매니페스트. 앱 자체 검증기로 검사: 스키마, 소유 id, 게임 엔진 규칙
registry-rules보유하지 않은 퍼블리셔; 예약된 id; 모든 enabledApiProposals 항목; 아카이브에 없는 main; 실제 PNG, JPEG, GIF, WebP, ICO가 아니거나 스크립트, 스타일, 외부 참조, 이벤트 핸들러가 있는 SVG인 아이콘
secrets개인 키와 자격 증명(클라우드, GitHub, GitLab, Slack, Stripe, Google, Anthropic, OpenAI, npm, PyPI, Hugging Face, ai-game.dev 키), JWT, .env, .npmrc, id_rsa 같은 파일. 보고서에는 값이 아니라 파일과 줄만 표시됩니다
prompt-injection에이전트에게 지시하려는 텍스트(아래 참조)
native-code없음: 네이티브 바이너리는 허용되고 표시되며, 사용자에게 패키지에 "native code"가 표시됩니다
virus-scan바이러스 스캐너가 표시하는 모든 것, 스캔하기에 너무 깊이 중첩된 아카이브 포함

실패한 버전은 모든 사유와 함께 rejected 상태가 됩니다. 문제를 고친 뒤 같은 버전을 다시 업로드하세요. 스캐너에 잠시 접속할 수 없으면 버전은 대기하고 다시 시도되며, 스캔되지 않은 채로 통과하는 일은 없습니다.

프롬프트 인젝션

패키지의 텍스트는 에이전트에게 도달합니다: 도구 설명, 스킬, README, 릴리스 노트. 레지스트리는 모든 매니페스트 문자열, README*, Markdown 및 텍스트 파일, SKILL.md, CLAUDE.md, AGENTS.md, 그리고 skills/, agents/, commands/, prompts/ 아래 파일을 모든 규칙으로 검사하고, 코드 파일은 신뢰도가 높은 규칙으로 검사합니다. 텍스트는 먼저 정규화되므로(HTML 엔티티, 유니코드 유사 문자, 보이지 않는 문자, Markdown 강조) 위장은 통하지 않습니다. 다음을 거부합니다:

  • 이전 지시를 무시하거나 덮어쓰라는 지시, 또는 시스템 프롬프트를 공개하라는 지시;
  • 채팅 역할 마커(<|im_start|>, [INST], <system> …);
  • 숨겨진 문자: 제로 폭 및 양방향 제어 문자, 유니코드 태그 문자;
  • 읽을 수 있는 텍스트로 디코딩되는 긴 base64 문자열;
  • AI에게 말을 거는 HTML 주석이나 숨겨진 요소;
  • 키, 토큰, 자격 증명 또는 대화 내용을 어디론가 보내라는 요청;
  • 탈옥 문구, 사용자에게서 동작을 숨기라는 요청, 도구를 자동 승인하거나 권한 검사를 우회하라는 요청.

일반적인 게임 단어("god mode"), 이모지, 배지, API 문서는 통과합니다. 무해한 텍스트가 표시되면 표현을 바꾸거나 AI Game Dev에 오탐을 신고하세요.

서명된 인덱스

게시된 버전은 자체 스토리지(community-packages.ai-game.dev)에 기록되고, 레지스트리가 Ed25519로 서명하는 커뮤니티 인덱스에 나열됩니다. 모든 앱은 앱에 내장된 키로 서명을 검증하고, 만료되었거나 이미 수락한 인덱스보다 오래된 인덱스는 거부하며, 압축을 풀기 전에 각 아카이브의 sha512 무결성을, 푼 뒤에는 트리 해시를 검증합니다. 각 버전의 아카이브 외에도 인덱스는 패키지별로 게시자, 평점, README, 아이콘, 채널, 지원 중단 정보를 담고, 버전별로 릴리스 노트(처음 4KB), 지원 중단, 출처, 네이티브 코드 플래그를 담습니다.

AI Game Dev가 폐기한 버전은 인덱스의 revoked 목록에 나열됩니다. 모든 앱은 다음 번 인덱스를 읽을 때 해당 버전을 끄고(실행 중인 앱은 약 30분마다 인덱스를 읽습니다) 다시는 설치하지 않습니다.

게시자 패널

ai-game.dev/publisher의 게시자 패널은 로그인한 소유자와 유지관리자가 자신이 게시하는 것을 관리하는 곳입니다:

  • 내 게시자, 각 게시자에서의 내 역할, 그리고 그 구성원;
  • 각 패키지의 버전과 그 상태 및 전체 검사 보고서;
  • 릴리스 노트, 채널, 지원 중단, 양키(yank);
  • 게시자 토큰(생성, 목록, 폐기);
  • GitHub 및 GitLab용 신뢰할 수 있는 게시자와 복사 가능한 워크플로 스니펫;
  • 아직 검사 중인 업로드의 상태.

레지스트리 API의 라우트

CLI와 패널이 하는 모든 작업은 https://ai-game.dev/api/registry/v1을 거칩니다. 오류는 하나의 봉투 형식 {"error": {"code", "message", "fields"}}를 사용합니다.

라우트권한설명
POST /publishers, GET /publishers, GET /publishers/{slug}로그인 필요, 구성원게시자 등록; 내 게시자 목록; 패키지와 버전을 포함한 게시자 하나 조회
GET /me/publishers로그인 필요내 역할과 함께 내 게시자 목록
GET /publishers/{slug}/members구성원구성원 목록(이메일은 소유자에게만)
POST /publishers/{slug}/members, DELETE …/members/{userId}소유자유지관리자 추가 또는 제거
POST /publishers/{slug}/tokens, GET …/tokens, DELETE …/tokens/{id}구성원게시자 토큰
POST /uploads (multipart tarball, 선택적 notes)구성원 또는 토큰버전 업로드
GET /packages/{id}/versions/{version}구성원 또는 토큰상태, 검사 보고서, 릴리스 노트
PATCH /packages/{id}/versions/{version}구성원릴리스 노트 편집
POST /packages/{id}/versions/{version}/yank구성원 또는 토큰양키 또는 복원
POST, DELETE /packages/{id}/deprecate 및 …/versions/{version}/deprecate구성원지원 중단 또는 지원 중단 해제
GET /packages/{id}/dist-tags공개채널
PUT, DELETE /packages/{id}/dist-tags/{tag}구성원채널 설정 또는 제거
GET, POST /packages/{id}/trusted-publishers, DELETE …/{tpId}읽기는 구성원, 변경은 소유자신뢰할 수 있는 게시자
POST /oidc/tokenCICI 신원 토큰을 업로드 자격 증명으로 교환
GET /packages/{id}/ratings, PUT 및 DELETE …/rating공개, 로그인 필요평점(패키지 게시자의 구성원은 평가할 수 없음)

에이전트를 위한 Markdown 페이지

AI 에이전트는 사이트를 Markdown으로 읽으므로, 패키지에 관한 모든 것에는 Markdown 쌍둥이가 있습니다:

  • 카탈로그. ai-game.dev/packages의 패키지 카탈로그(순차 공개 중)는 모든 공식 및 커뮤니티 패키지를 나열하며, 각 패키지는 /packages/<id>에 자체 페이지가 있습니다. 두 경로 중 하나에 .md를 붙이거나 Accept: text/markdown으로 요청하면 동일한 내용을 Markdown으로 얻을 수 있습니다: 이름, ID, 버전, 게시자, 설명, 설치 명령.
  • 이 문서들. 이 위키의 모든 페이지에는 /docs-md/ 아래에 Markdown 미러가 있으며(이 페이지는 /docs-md/wiki-app-package-registry.md), 페이지 상단의 View as Markdown에서 링크됩니다. 미러는 모든 스크린샷을 이미지 링크로 유지합니다.
  • LLM을 위한 사이트 인덱스. https://ai-game.dev/llms.txt에 이 페이지들이 나열되어 있어, 패키지 작성을 요청받은 에이전트가 매니페스트 레퍼런스와 패키지 API를 바로 찾을 수 있습니다.