Pallas-Bot

外观

安装官方插件 ​

字数
924 字
阅读时间
4 分钟

装、卸、更新官方插件。

4.0 之后，大部分玩法和站点能力都从本体拆成了独立 pip 包。先分清三种东西：

  • core：随主仓启动就有，不用额外装。
  • 官方插件：PyPI 包；日常用 WebUI 插件商店装/卸/更新。
  • local / community plugins：站点私有或社区插件，一般放在 local/plugins/。

什么时候需要 ​

  • 主仓已跑起来，但帮助菜单里没有决斗、MAA、谁是卧底等能力。
  • 新站点按需装插件；从 3.x 升级且玩法已在跑则通常不必重装。
  • Docker 或分片环境需确认是 pip、镜像预装还是 local/plugins/ 副本在生效。

推荐顺序 ​

  1. WebUI 插件商店（装、卸、更新、看加载态）——大多数用户与日常运维。
  2. CLI（pallas ext）——初次部署、SSH 升级 Bot、脚本化、商店不可用时。
  3. 镜像构建期 uv sync --extra ...——精简 Docker 无现场装包条件时。

方式一：WebUI 插件商店（推荐） ​

  1. 打开 http://<主机>:8088/pallas/ 并登录。
  2. 侧栏「插件商店」→「安装」「更新」或「安装并重启」。
状态含义
未安装当前环境里还没有 pip 包
已安装待重启包已装入环境，但当前进程还没加载
已加载当前运行进程已经在使用

插件配置、命令权限、治理页等也应在控制台完成，不必为了改插件状态专门 SSH。

方式二：CLI（备选） ​

bash
uv run pallas ext list
uv run pallas ext install pallas-plugin-duel --restart
uv run pallas ext uninstall pallas-plugin-duel --restart

适合无图形界面、CI/CD 或维护者批量初始化。有控制台时，官方插件的装卸更新仍以商店为主。

先确认运行前提（CLI / 商店共用） ​

商店一键安装需要：完整 Pallas-Bot 工作目录、能执行 uv、能访问 PyPI。

bash
uv --version
uv run pallas --help

精简 Docker 镜像例外

精简镜像往往没有容器内现场装包条件。构建期预装，或部署后通过能访问 PyPI 的控制台商店安装。

常见官方插件对照 ​

包名作用
pallas-plugin-protocol协议端管理、账号上号、relologin 相关能力
pallas-plugin-duel决斗与八角笼玩法
pallas-plugin-who-is-spy谁是卧底
pallas-plugin-maaMAA 远控
pallas-plugin-ai-media唱歌、酒后聊天等媒体类能力
pallas-plugin-draw绘图相关能力
pallas-plugin-dream做梦相关能力
pallas-plugin-bot-status在吗、报数等状态类能力

以下能力已经在 4.0 回归 core，不需要再额外安装：

  • llm_chat
  • pb_stats

安装后怎么确认真的生效 ​

  1. 商店显示「已加载」（或 pallas ext list 为 installed=yes）。
  2. 群里发「牛牛帮助」，能看到新增能力。
  3. 插件有配置页时，WebUI 能打开并读到配置。

分片部署留意最后一步

有些插件只在 worker 侧运行。控制台加载态取决于 hub 聚合到的 worker 元数据。

卸载与回滚 ​

优先在 插件商店 卸载。无 UI 时用 pallas ext uninstall。

同名副本会盖过卸载

  • 卸载 pip 包不会删掉 local/plugins/ 里的同名副本。
  • 装、卸、升级之后都重启一次。

延伸阅读 ​