플러그인 등록하기

이 번역은 참고용이므로, 정확한 내용은 영어판에서 확인해 주세요. 영어판

등록할 수 있는 플러그인

이 플랫폼은 GitHub 저장소의 관리자인 작성자가 등록한 오픈 소스 오디오 플러그인을 게재합니다.

지원 규격: VST® 3 CLAP, LV2, Audio Unit

등록하기 전에 저장소와 최신 릴리스가 게재 조건을 충족하는지 확인해 주세요: https://audio-soko-kun.allegromoltov.jp/policy

이 플랫폼은 플러그인의 규격, OS, 아키텍처, 카테고리를 zip 압축 파일 안의 번들로 판정합니다. 작성자가 입력할 필요는 없습니다.

플러그인과 저장소 이름에 VST라는 단어를 넣지 마세요. VST 3 SDK는 제품 이름에 VST를 쓰는 것을 허용하지 않으며, 이 플랫폼의 리뷰도 그런 이름을 권장 사항으로 지적합니다.

릴리스 전에 저장소 확인하기

릴리스를 공개하기 전에 AI 에이전트에게 submit_plugin의 확인 모드를 실행하게 해 주세요. 확인 모드는 최신 릴리스로 게재 조건을 판정하고, 기본 브랜치의 최신 커밋을 리뷰합니다. 확인 모드에서는 등록하지 않습니다. 확인 모드는 24시간에 5번까지 사용할 수 있습니다.

리뷰는 GitHub에 공개된 심사 기준을 따릅니다: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/blob/main/docs/design/review-criteria.md

압축 파일 내용 검사와 macOS 서명 판정은 등록한 뒤 GitHub Actions에서 배포 파일을 내려받아 진행하므로, 확인 모드에서는 하지 않습니다. 에이전트는 이 검사들에서 요구하는 사항을 보여 줍니다.

등록 절차

MCP 클라이언트를 https://audio-soko-kun.allegromoltov.jp/mcp에 연결해 주세요. Claude Code에서는 다음을 실행해 주세요:

claude mcp add --transport http audio-plugin-soko-kun https://audio-soko-kun.allegromoltov.jp/mcp

MCP 클라이언트에서 GitHub 계정으로 로그인해 주세요. Claude Code에서는 /mcp를 실행하고 audio-plugin-soko-kun을 선택해 주세요. Codex에서는 codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp로 연결한 뒤 codex mcp login audio-plugin-soko-kun으로 로그인해 주세요. 이 플랫폼 자체가 GitHub 저장소에 대한 쓰기 권한을 얻는 일은 없습니다.

AI 에이전트에게 저장소 등록을 부탁해 주세요. 예: "https://github.com/<owner>/<repository>의 오디오 플러그인을 등록해 줘"

등록한 뒤의 흐름

이 플랫폼은 플러그인을 검사 대기로 등록합니다. 릴리스가 검사를 통과하기 전까지 플러그인은 검색과 플러그인 페이지에 나타나지 않습니다.

검사는 15분마다 진행되며, 보통 몇 시간 안에 끝납니다.

이 플랫폼은 검사를 통과한 릴리스만 게재합니다. GitHub에서 새 릴리스를 공개하면 이 플랫폼이 자동으로 가져와 검사합니다. 다시 등록할 필요는 없습니다.

검사 결과는 AI 에이전트에게 list_my_plugins로 확인하게 해 주세요. 예: "내 플러그인의 새 릴리스가 게재되었는지 확인해 줘". 에이전트는 릴리스마다의 상태, 릴리스나 배포 파일이 게재되지 않은 이유, 리뷰 지적 사항, 고치는 방법을 보여 줍니다.

관리자의 확인을 기다리는 릴리스도 있습니다. 그런 릴리스의 변경 내용을 설명하려면 이 플랫폼 저장소의 Issue에 적어 주세요: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/issues

등록이 거부되었을 때

AI 에이전트가 이유 코드와 고치는 방법을 표시하므로, 원인을 고친 뒤 다시 등록해 주세요.

not_admin: 저장소의 관리 권한이 없습니다. 저장소 관리자에게 등록을 부탁해 주세요.
private_repository, archived_repository: 저장소를 공개하거나 보관을 해제해 주세요.
no_license: 오픈 소스 라이선스의 LICENSE 파일을 저장소 최상위에 두고 새 릴리스를 공개해 주세요.
license_unrecognized: GitHub가 라이선스를 식별할 수 없습니다. LICENSE에는 표준 라이선스 본문만 두고, 그 밖의 고지는 NOTICE나 README로 옮긴 뒤 새 릴리스를 공개해 주세요.
license_not_open: OSI 승인 또는 FSF 자유 라이선스 인정을 받은 라이선스로 바꾼 뒤 새 릴리스를 공개해 주세요.
no_release, no_verifiable_asset: 플러그인 배포 파일을 첨부한 릴리스를 공개해 주세요(최대 30개).
no_archive: 플러그인 번들을 zip 압축 파일로 만들어 릴리스에 첨부해 주세요.
not_immutable: 저장소 설정에서 불변 릴리스를 켠 뒤 새 릴리스를 공개해 주세요.
no_attestation: 릴리스 워크플로에 actions/attest-build-provenance를 추가해 설치 프로그램을 포함한 모든 배포 파일에 증명을 붙인 뒤 새 릴리스를 공개해 주세요.
duplicate: 저장소가 이미 등록되어 있습니다. 검색에서 플러그인 페이지를 열어 주세요.
name_reserved: 게재 중인 플러그인이 이름을 바꾸기 전에 이 저장소 이름을 사용했습니다. 게재된 플러그인이 사용한 적 없는 이름으로 저장소 이름을 바꿔 주세요.
rate_limited: 등록은 24시간에 10번까지입니다. 시간을 두고 다시 등록해 주세요.
invalid_url: 저장소 URL을 https://github.com/<owner>/<repository> 형식으로 지정해 주세요.
not_found: 저장소를 찾을 수 없습니다. URL과 저장소가 공개되어 있는지 확인해 주세요.
unsupported_tag: 릴리스 태그는 영문자, 숫자, ".", "-", "_"만 사용해 100자 이내로 해 주세요.
github_unavailable: GitHub가 정상적으로 응답하지 않았습니다. 시간을 두고 다시 등록해 주세요.

릴리스나 배포 파일이 게재되지 않을 때

list_my_plugins로 릴리스나 배포 파일이 게재되지 않은 이유를 확인할 수 있습니다. 작성자가 고쳐야 하는 주요 이유는 다음과 같습니다.

vst2_detected: 압축 파일에 VST 2 번들이나 엔트리 포인트가 있습니다. 모든 압축 파일에서 VST 2를 빼고 새 릴리스를 공개해 주세요.
no_plugin_detected, no_plugin_in_archive: 압축 파일에서 지원 규격의 플러그인 번들을 찾지 못했습니다. 빌드한 번들을 zip 압축 파일에 넣어 주세요. 소스 코드 압축 파일은 고칠 필요가 없습니다.
content_undetermined: 설치 프로그램이나 중첩된 압축 파일처럼 내용을 검사할 수 없는 파일이 압축 파일에 있습니다. 플러그인 번들을 zip 압축 파일에 직접 넣어 주세요.
macos_not_signed, macos_adhoc, macos_not_developer_id, macos_not_notarized: macOS용 번들을 Developer ID 인증서로 서명하고 Apple의 공증을 받아 주세요.
declaration_mismatch, not_declared: .audio-soko-kun/config.json의 선언과 검사한 압축 파일의 내용이 일치하지 않습니다. 선언을 고친 뒤 새 릴리스를 공개해 주세요.
installer_not_guided: 설치 프로그램은 안내하지 않습니다. 이용자는 zip 압축 파일로 플러그인을 설치합니다.

로고와 설명 이미지

작성자는 로고와 설명 이미지를 한 장씩 게재할 수 있습니다. 저장소의 .audio-soko-kun 폴더에 이미지를 넣어 주세요.

.audio-soko-kun/logo.png
.audio-soko-kun/image.gif

로고: 파일 이름을 logo로 해 주세요. 크기는 256 KB 이내, 가로와 세로는 1,024 px 이내로 해 주세요.
설명 이미지: 파일 이름을 image로 해 주세요. 크기는 1.5 MB 이내, 가로와 세로는 4,096 px 이내로 해 주세요. GIF는 애니메이션으로 재생됩니다.

이 플랫폼은 스크립트를 포함할 수 있는 SVG를 받지 않으므로, 확장자는 png, jpg, jpeg, gif, webp 중 하나로 해 주세요.

이 플랫폼은 최신 릴리스 태그 시점의 이미지를 가져오므로, 이미지를 바꾼 뒤에는 새 릴리스를 공개해 주세요.

이 플랫폼은 조건에 맞지 않는 이미지를 게재하지 않으므로, 이미지가 표시되지 않으면 조건을 확인해 주세요.

.audio-soko-kun/config.json

작성자는 .audio-soko-kun/config.json에서 표시 이름과 카테고리, 압축 파일별 OS, 아키텍처, 규격을 선언할 수 있습니다. 이미지와 같은 .audio-soko-kun 폴더에 파일을 넣어 주세요.

{
  "name": "Simple Pitch Shift",
  "category": "effect",
  "assets": [
    {
      "pattern": "simple-pitchshift-*-windows-x64.zip",
      "os": "windows",
      "arch": ["x86_64"],
      "formats": ["vst3", "clap"]
    }
  ]
}

name: 표시 이름입니다. 1~60자로 적어 주세요. 적지 않으면 저장소 이름을 표시합니다.
category: instrument, effect, analyzer, midi, utility 중 하나입니다. 이 플랫폼은 번들에서 카테고리를 추정할 수 없을 때만 이 값을 사용합니다.
assets: 압축 파일 선언을 20개까지 적을 수 있습니다. pattern은 압축 파일 이름과 대조하며, *는 임의의 문자열과 일치합니다. os는 windows, macos, linux 중 하나, arch는 x86_64, x86, arm64의 배열, formats는 vst3, clap, lv2, au의 배열입니다.

모든 항목은 선택 사항입니다. 이 플랫폼은 규격, OS, 아키텍처를 검사한 번들에서 결정하며, 선언은 대조와 안내할 압축 파일 선택에만 사용합니다.

assets를 적으면 pattern과 일치하는 압축 파일만 안내합니다. 파일 내용이 올바르지 않은 릴리스, 어떤 압축 파일도 pattern과 일치하지 않는 릴리스, 검사한 압축 파일의 내용이 선언과 일치하지 않는 릴리스는 게재하지 않습니다.

이 플랫폼은 새 릴리스 태그 시점의 파일을 읽으므로, 파일을 바꾼 뒤에는 새 릴리스를 공개해 주세요.

업데이트와 게재 철회

게재 내용을 업데이트하려면 GitHub에서 새 릴리스를 공개해 주세요. 이 플랫폼은 새 릴리스를 자동으로 가져와 검사를 통과하면 게재합니다. 저장소 설명에서 개요도 업데이트합니다.

새 릴리스가 게재되지 않으면 AI 에이전트에게 list_my_plugins로 확인하게 해 주세요. 에이전트는 이유와 고치는 방법을 보여 줍니다.

게재를 철회하려면 저장소를 비공개로 하거나 삭제해 주세요. 신고 페이지의 방법으로 철회를 요청할 수도 있습니다.

저장소 이름 변경과 이전

이 플랫폼은 GitHub의 저장소 ID로 저장소를 추적하므로, 저장소 이름을 바꿔도 따로 할 일은 없습니다. 게재는 15분 안에 새 이름으로 옮겨지고, 이전 이름으로 된 링크는 새 이름으로 전송됩니다.

이전 이름으로 다른 저장소를 만들지 마세요. 이전 이름은 이 플랫폼이 이름을 바꾼 플러그인을 위해 남겨 두며, 그 이름으로는 다른 저장소를 등록하지 않습니다.

저장소를 다른 계정이나 조직으로 이전하면, 게재 중인 릴리스는 그대로 게재하고 다음 릴리스는 관리자가 확인한 뒤 게재합니다.

표시 이름을 바꾸려면 .audio-soko-kun/config.json의 name을 바꾸고 새 릴리스를 공개해 주세요.