mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-16 17:47:06 +08:00
224915fbc8
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>
21 lines
1.7 KiB
Markdown
21 lines
1.7 KiB
Markdown
# 发布插件到插件市场
|
||
|
||
在编写完插件后，你可以选择将插件发布到 AstrBot 的插件市场，让更多用户使用你的插件。
|
||
|
||
AstrBot 使用 GitHub 托管插件，因此你需要先将插件代码推送到之前创建的 GitHub 插件仓库中。
|
||
|
||
你可以前往 [AstrBot 插件市场](https://plugins.astrbot.app) 提交你的插件。进入该网站后，点击右下角的 `+` 按钮，填写好基本信息、作者信息、仓库信息等内容后，点击 `提交到 GITHUB` 按钮，你将会被导航到 AstrBot 仓库的 Issue 提交页面，请确认信息无误后点击 `Create` 按钮提交，即可完成插件发布。
|
||
|
||
|
||
|
||
> ⚠️ **大小限制**：发布到插件市场的插件压缩包（zip）大小**不得超过 16MB**。如果超过此限制，CI/CD 流水线将自动拒绝该发布请求。
|
||
>
|
||
> 为确保你的插件能顺利通过审核和发布，建议采取以下措施：
|
||
>
|
||
> - **压缩图片等静态资源**：对插件中的图片、音频等资源文件进行压缩，减小体积。
|
||
> - **清理不必要的文件**：避免将 `.git` 目录、`__pycache__`、`node_modules`、开发用配置文件等非必需文件提交到插件仓库中。建议在仓库根目录添加 `.gitignore` 来排除它们。
|
||
> - **优化依赖体积**：如果插件包含体积较大的依赖库，可考虑精简或按需引入。
|
||
> - **使用 `.gitattributes` 或发布分支**：通过只包含发布所需文件的策略来减小 zip 包体积。
|
||
>
|
||
> 如果插件确实因业务需要无法压缩到 16MB 以内，可以联系维护者手动 bypass 此限制。
|