Pallas-Bot

外观

CLI 参考 ​

字数
841 字
阅读时间
4 分钟

维护者在 Pallas-Bot 仓库根用的命令行入口：uv run pallas <子命令>（无子命令时默认启动单进程 Bot）。

场景入口
拉代码、同步依赖、启停、升级 Bot / WebUICLI
官方插件装 / 卸 / 更新、运行中配置网页控制台

完整子命令：uv run pallas --help。

升级与维护 ​

版本对齐（3.x → V4 或日常升级） ​

bash
uv run pallas maintenance run \
  --update-bot \
  --update-webui \
  --dev

等价分步：

bash
uv run pallas update bot
uv run pallas update webui
uv run pallas sync --dev
uv run pallas restart

升级完成后，若要补装或更新官方插件，登录控制台 插件商店 操作（不必为插件专门记 CLI）。

依赖同步 ​

bash
uv run pallas sync              # 包装 uv sync（redis 已在主依赖）

启停 ​

默认形态是 unified（单进程）。配置本机 Embedding（local）且 Redis 可用时，启停会自动带上 embed 辅进程，不必另记 worker。

bash
uv run pallas status               # Bot + embed 辅进程折叠展示
uv run pallas logs                 # 默认日志路径与尾部（不强迫记 worker-N）
uv run pallas logs -f              # 实时跟随主日志（终端染色；Ctrl+C 退出）
uv run pallas logs -f --all        # 实时跟随主日志 + work/embed 辅进程等全部目标
uv run pallas restart
uv run pallas stop
uv run pallas run unified          # 推荐默认
uv run pallas run shard            # 可选进阶：已验证瓶颈或强隔离时

分片仅在热路径仍不够、或需要账号级炸点隔离时使用，见 分片部署。

官方插件（CLI 备选） ​

日常装卸更新用 WebUI 插件商店。CLI 仅在无 UI、脚本化或排障时使用：

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

社区插件（git 索引）仍可用 CLI：

bash
uv run pallas plugin install <id>
uv run pallas plugin list

AI Runtime ​

bash
uv run pallas ai path
uv run pallas ai setup                 # 媒体 sidecar 基础安装（不装 torch）
uv run pallas ai setup --check-only
uv run pallas ai setup --remote-only
uv run pallas ai setup --with-media    # 唱歌/TTS（装 torch CPU）
uv run pallas ai setup --with-media --gpu

详见 AI Runtime 安装。普通 LLM 聊天在 WebUI「AI 配置 → 接入」配置 Provider，不依赖本命令。

体检 ​

bash
uv run pallas doctor

什么时候用 CLI vs WebUI ​

场景优先
初次 clone、SSH 升级 Bot / WebUICLI
maintenance run 拉齐本体与 distCLI
装 / 卸 / 更新官方插件WebUI 插件商店；无 UI / 脚本化时 pallas ext update
改插件配置、命令权限、治理WebUI
看运行态、分片聚合WebUI
无 uv、无 SSH，只有浏览器WebUI
批量脚本、CI、Docker 构建期CLI

缺口与现状 ​

缺口现状说明
官方插件更新pallas ext update / 商店「更新」CLI 与商店均可
AI 仓 git 对齐pallas ai setup升级时 AI 仓手动 git pull 或待 pallas update ai
.env 迁移独立脚本待 pallas config migrate
全栈一键升级maintenance + 控制台Bot 侧 CLI，插件侧 WebUI / ext update

维护者清单：升级、V4 迁移指南。

相关阅读 ​