提交外掛

本翻譯僅供參考，正確內容請以英文版為準。英文版

可以提交的外掛

本平台收錄由 GitHub 儲存庫管理員即作者本人提交的開源音訊外掛。

支援的格式: VST® 3 CLAP, LV2, Audio Unit

提交前，請確認儲存庫及其最新發行滿足收錄條件：https://audio-soko-kun.allegromoltov.jp/policy

本平台根據 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：請以 https://github.com/<owner>/<repository> 的形式指定儲存庫 URL。
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：請使用 Developer ID 憑證簽署 macOS 外掛套件，並通過 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 中宣告顯示名稱、分類，以及每個壓縮檔的作業系統、架構和格式。請將該檔案放在與圖片相同的 .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 組成的陣列。

所有欄位皆為選填。本平台根據檢查的外掛套件決定格式、作業系統和架構，宣告僅用於核對這些資訊以及選擇要引導的壓縮檔。

填寫 assets 後，本平台只引導使用者前往符合 pattern 的壓縮檔。如果檔案無效、沒有壓縮檔符合任何 pattern，或檢查的壓縮檔與宣告不一致，本平台不會收錄該發行。

本平台讀取每個新發行標籤時的該檔案，因此變更檔案後請發布新版本。

更新與撤下

更新收錄內容時，請在 GitHub 上發布新版本。本平台會自動取得新版本，並在通過檢查後收錄。本平台也會根據儲存庫說明更新簡介。

如果新版本未被收錄，請讓 AI 代理以 list_my_plugins 確認。代理會顯示原因和修改方法。

撤下收錄時，請將儲存庫設為私人或刪除儲存庫。您也可以依檢舉頁面的方法申請撤下。

重新命名或轉移儲存庫

本平台透過 GitHub 的儲存庫 ID 追蹤儲存庫，因此重新命名儲存庫時無需任何操作。收錄會在 15 分鐘內轉到新名稱，指向舊名稱的連結會重新導向到新名稱。

請不要以舊名稱建立另一個儲存庫。本平台會為已重新命名的外掛保留舊名稱，不會以該名稱登記其他儲存庫。

如果將儲存庫轉移到其他帳號或組織，已收錄的版本會繼續收錄，下一個版本由管理員確認後再收錄。

要變更顯示名稱，請修改 .audio-soko-kun/config.json 中的 name 並發布新版本。