提交插件

本翻译仅供参考，准确内容请以英文版为准。英文版

可以提交的插件

本平台收录由 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 并发布新版本。