社区插件商店
July 26, 2026 · View on GitHub
从策展索引浏览并安装第三方插件到 local/plugins/<id>/。日常总装法见 安装插件 · 社区与本地插件。
与 官方插件（pip）并存；同名时 local/plugins 优先。
开始前准备
| 需要准备 | 说明 |
|---|---|
| 可登录的网页控制台 | 路径 插件商店 → 社区插件 |
运行环境可执行 git | WebUI 安装依赖 git |
（推荐）extra_plugin_dirs | 在 pallas.toml 的 [bootstrap] 写明 ["local/plugins"] |
WebUI 安装（推荐）
- 打开网页控制台 → 插件商店 → 社区插件
- 选条目 → 安装（或 安装并重启）
- 重启 Bot 后，在 插件目录 确认已加载
不走索引：点右上角 从 Git 安装，填插件 ID 与仓库地址即可。安装路径：local/plugins/<插件 ID>/。
建议在 pallas.toml 写明：
[bootstrap]
extra_plugin_dirs = ["local/plugins"]
卡片详情
点商店卡片可看：
- README：仓库根目录
README.md - 更新日志：优先
CHANGELOG.md；没有则按 git 提交标题兜底
官方与社区卡片详情形态相同（示意：官方扩展 MAA）：
作者约定见 写社区插件并上架。
手动投放
把插件目录放到 local/plugins/<名>/，配好 extra_plugin_dirs（或靠自动检测），重启 Bot。
适合：不能访问 git，或不在公共索引里。
收录第三方插件
向 community-plugin-index 提 PR，在 index.json 追加条目。
索引只存元数据，不托管源码。未收录仍可用 从 Git 安装 或手工目录。
已收录插件发版后，请改索引里同 id 条目的 version（勿重复追加），步骤见 写社区插件并上架 · 发版后同步索引。
成功信号
- 插件出现在
local/plugins/<id>/。 - 重启后 插件目录 显示已加载；群里 牛牛帮助 出现对应命令（若该插件提供口令）。
接下来做什么
::: details 索引从哪来（一般不用管）
| 优先级 | 来源 |
|---|---|
| 高 | 环境变量 COMMUNITY_PLUGIN_INDEX_URL |
默认远程：https://raw.githubusercontent.com/PallasBot/community-plugin-index/main/index.json | |
data/pallas_config/community_plugin_index.json | |
| 低 | config/community_plugin_index.json（主仓内置，通常为空） |
远程拉失败会回退本地文件。私有索引可在 [env] 设 COMMUNITY_PLUGIN_INDEX_URL。
:::
::: details 和官方插件谁优先
| 类型 | 安装方式 | 优先级 |
|---|---|---|
| 社区 / 站点 | local/plugins/ | 最高 |
| 官方 pip | 商店 / pallas ext install | 中 |
| 仓库内副本 | 默认 auto：pip 未装时用副本 | 低 |
见 安装插件。 :::