Files
AstrBot/docs/zh/dev/star/plugin-publish.md
AstrBot 224915fbc8 docs: add 16MB size limit note for plugin publishing (#8108)
Add documentation to clarify the 16MB zip size limit for plugin
marketplace submissions, along with practical recommendations:
- Compress static assets like images
- Clean up unnecessary files (.git, __pycache__, etc.)
- Optimize dependency sizes
- Use .gitattributes or release branches

Also mention the option to contact maintainers for manual bypass
when the limit cannot be met.

Co-authored-by: Seio <seio@astrbot.app>
2026-05-09 22:00:15 +08:00

1.7 KiB
Raw Blame History

发布插件到插件市场

在编写完插件后,你可以选择将插件发布到 AstrBot 的插件市场,让更多用户使用你的插件。

AstrBot 使用 GitHub 托管插件,因此你需要先将插件代码推送到之前创建的 GitHub 插件仓库中。

你可以前往 AstrBot 插件市场 提交你的插件。进入该网站后,点击右下角的 + 按钮,填写好基本信息、作者信息、仓库信息等内容后,点击 提交到 GITHUB 按钮,你将会被导航到 AstrBot 仓库的 Issue 提交页面,请确认信息无误后点击 Create 按钮提交,即可完成插件发布。

fill out the form

⚠️ 大小限制发布到插件市场的插件压缩包zip大小不得超过 16MB。如果超过此限制CI/CD 流水线将自动拒绝该发布请求。

为确保你的插件能顺利通过审核和发布,建议采取以下措施:

  • 压缩图片等静态资源:对插件中的图片、音频等资源文件进行压缩,减小体积。
  • 清理不必要的文件:避免将 .git 目录、__pycache__node_modules、开发用配置文件等非必需文件提交到插件仓库中。建议在仓库根目录添加 .gitignore 来排除它们。
  • 优化依赖体积:如果插件包含体积较大的依赖库,可考虑精简或按需引入。
  • 使用 .gitattributes 或发布分支:通过只包含发布所需文件的策略来减小 zip 包体积。

如果插件确实因业务需要无法压缩到 16MB 以内,可以联系维护者手动 bypass 此限制。