Pallas-Bot

外观

安装插件 ​

字数
732 字
阅读时间
4 分钟

装之前先看

类型举例要不要装
本体 core复读、帮助、控制台随 Bot 自带，不用装
官方扩展决斗、MAA、谁是卧底默认没装，要单独安装
站点插件你自己写的、第三方 nb 插件放到 local/plugins/

装完后群里发 牛牛帮助，新功能应出现在帮助图里。

一、安装官方扩展（最常见） ​

决斗、MAA、唱歌等玩法在 pip 扩展包里，不在默认 slim 镜像中。

方法 A：网页一键装（推荐） ​

条件：运行目录有 pyproject.toml，且系统能执行 uv。

  1. 登录 http://<主机>:8088/pallas/
  2. 侧栏进 插件商店（或 插件 → 插件商店）
  3. 找到扩展包，点 一键安装
  4. 点 安装并重启（或装完后手动重启 Bot）

如何确认成功：商店里该包显示「已安装」或「已加载」；重启后 插件目录 能看到对应插件；群里 牛牛帮助 出现新口令。

没有「一键安装」按钮？

典型原因：

  • Docker 官方镜像（没有完整源码树 / 没有 uv）
  • 服务器 PATH 里找不到 uv

改用下面的 方法 B，或构建镜像时带上对应 PALLAS_UV_EXTRAS（见 Docker 部署）。

方法 B：命令行装 ​

在 Pallas-Bot 仓库根目录：

bash
# 决斗
uv sync --extra plugins-duel

# 或 CLI
uv run pallas ext install pallas-plugin-duel

装完 必须重启 Bot：

bash
# 前台跑的 Ctrl+C 后重新
uv run nb run

# 或用项目脚本（若已配置）
./scripts/pallas restart

扩展包与 uv sync --extra 对照表见 安装官方扩展 · 包列表。

二、安装站点自有插件（local） ​

适合：Docker 精简环境、整包 fork、或任意 NoneBot 插件目录。

  1. 在仓库根建目录：
text
local/plugins/你的插件名/__init__.py
  1. 在 config/pallas.toml 启用：
toml
[bootstrap]
extra_plugin_dirs = ["local/plugins"]
  1. 重启 Bot

如何确认成功：WebUI 插件目录 出现该插件；与官方扩展 同名时 local 优先加载。

细节：站点定制与扩展。

三、pip / nb 插件（老方式，可选） ​

在根目录 .env 里写 NoneBot 插件模块名。
注意：不要与 webui.json 里同名键冲突。新站点更推荐 local/plugins。

插件列表在哪看 ​

  • 文档：插件手册（每个插件的口令与配置）
  • 网页：控制台 插件目录（当前进程实际加载了谁）
  • 商店：插件商店（能装哪些官方扩展）

▶ 下一步：口令与功能 · 进阶介绍