Pallas-Bot 4.0 启动说明
字数
1177 字
阅读时间
6 分钟
适用分支：
dev（4.0 集成线，尚未全部合入main）。
与 3.x 最大区别：默认只加载 core 插件；玩法 / 协议端 / AI 媒体等走 官方扩展；智能接话依赖 Pallas-Bot-AI 4.0+。
一分钟对照
| 你想用 | 最少要做 |
|---|---|
| 复读 + 牛格（群风格） | core 即可，uv run nb run |
| NapCat 控制台、决斗、MAA… | 装官方扩展（见下文） |
| 随时 @ 闲聊、酒后 LLM、接话 fallback | 起 AI 仓 + 打开 LLM_CHAT_ENABLED（子项默认已开） |
| 方舟干员资料进 LLM | 同上 + 确保 data/ 有干员 JSON（决斗扩展或自动 sync） |
1. 获取代码与依赖
bash
git clone https://github.com/PallasBot/Pallas-Bot.git
cd Pallas-Bot
git checkout dev
uv sync --devPostgreSQL：uv sync --dev --extra pg
分片协调 Redis：uv sync --dev --extra coord-redis
官方扩展（按需）
尽量完整（推荐维护者一次性装齐）：
bash
uv sync --extra deploy-all
# 或
uv run pallas sync --deploy-all常用子集：
| extra | 包含 |
|---|---|
plugins-protocol | NapCat 协议端、重登 |
plugins-game | 决斗 + 谁是卧底 |
plugins-maa | MAA 远控 |
plugins-llm-chat | 随时 @ 闲聊入口 |
plugins-ai-media | 唱歌 + 酒后 chat |
plugins-draw | 画画 |
安装后 重启 Bot。查看状态：
bash
uv run pallas ext list开发联调（不装 pip 包、直接用仓库内 src/plugins/）：
toml
# config/pallas.toml
[bootstrap]
load_bundled_extra_plugins = true生产环境请用 pip 扩展，不要长期依赖 load_bundled_extra_plugins。
2. 主仓配置
2.1 config/pallas.toml（最少）
toml
[bootstrap]
host = "0.0.0.0"
port = 8088
superusers = ["你的QQ号"]
db_backend = "mongodb"
[bootstrap.mongo]
host = "127.0.0.1"
port = 27017
db = "PallasBot"2.2 环境变量 / WebUI（webui.json 优先）
日常在 /pallas/ → 通用配置 保存即可；键名如下。
智能对话（总闸 + 子项）
| 键 | 4.0 默认 | 说明 |
|---|---|---|
LLM_CHAT_ENABLED | false | 唯一总闸。true 后酒后 LLM、随时 @、接话 LLM 才生效 |
AI_SERVER_HOST | 127.0.0.1 | Pallas-Bot-AI 地址 |
AI_SERVER_PORT | 9099 | AI 仓端口 |
LLM_REPEATER_MODE | both | 接话 LLM：off / fallback / polish / both |
LLM_SESSION_ENABLED | true | 多轮会话（需 PG + Redis 时见 AI 仓） |
LLM_GOVERNANCE_ENABLED | true | 闲聊冷却、并发与字数预算 |
LLM_TOOLS_ENABLED | true | LLM 可注入方舟等 tool schema（总闸关时无效） |
减负约定：除
LLM_CHAT_ENABLED需你显式打开外，上表子项 默认全开；关掉总闸时它们不消耗资源。
方舟知识库（结构化查询）
| 键 | 4.0 默认 | 说明 |
|---|---|---|
ARKNIGHTS_KB_ENABLED | true | 干员查询 API / LLM tools |
ARKNIGHTS_KB_AUTO_SYNC | true | 缺 resource/arknights/operators_6star.json 时后台 sync |
数据文件：resource/arknights/operators_6star.json（与决斗同源）。手动刷新：
bash
uv run python scripts/sync_arknights_data.py
# 知识库全量（档案摘录 + 敌人图鉴，不拉头像）
uv run python scripts/sync_arknights_data.py --kb其它 4.0 相关
| 键 | 默认 | 说明 |
|---|---|---|
group_style_enabled | true | 控制台按 Bot 配置；群风格自动生长 |
| message_scrub | 开启 | 4.0 默认审查入站；WebUI「消息审查」可调 |
完整键表见 persona-llm-roadmap、配置存储。
3. Pallas-Bot-AI（智能对话运行时）
与主仓 同级目录 克隆 Pallas-Bot-AI，使用与 Bot 匹配的 4.0 分支。
bash
cd ../Pallas-Bot-AI
cp .env.example .env至少配置：
env
LLM_CHAT_ENABLED=true
REDIS_URL=redis://127.0.0.1:6379/0
LLM_BACKEND_URL=http://127.0.0.1:11434 # 或远端 OpenAI 兼容 API
LLM_MODEL=qwen2.5:7b
LLM_TOOLS_ENABLED=true # 与主仓对齐，默认 true按该仓 README 启动 API（默认 9099）与 Celery worker。
主仓启动日志会探测 AI api_version ≥ 4.0.0；过低会告警。
4. 启动与验收
bash
cd Pallas-Bot
uv run nb run| 步骤 | 验收 |
|---|---|
| 控制台 | http://<host>:8088/pallas/ 可登录 |
| 协议端 | 已装 plugins-protocol 时打开协议页并扫码 |
| 帮助 | 群内 牛牛帮助 列出已装插件 |
| 连通 | 牛牛连通 或日志中 AI 探测为 ok |
| LLM | LLM_CHAT_ENABLED=true 后试随时 @ / 酒后聊天（需对应扩展） |
| 接话 | 复读正常；LLM_REPEATER_MODE 非 off 且总闸开时走 fallback/polish |
联调脚本：
bash
uv run python tools/integration_llm_chat.py --ai-port 9099
uv run python tools/integration_repeater_llm.py --scenario both --ai-port 90995. Docker 与分片
| 场景 | PALLAS_UV_EXTRAS 示例 |
|---|---|
| 仅 core 接话 | perf,pg |
| 常用玩法 | perf,pg,plugins-game,plugins-protocol |
| 全官方扩展 | perf,pg,deploy-all |
| 分片 | 再加 deploy-shard，并配置 REDIS_URL |
见 Docker 部署。
6. 从 3.x 升级
- 备份
config/pallas.toml、data/、webui.json - 切
dev或等待 4.0.0 tag uv sync并安装所需--extra- 将
CHAT_ENABLE/OLLAMA_ENABLE迁移为LLM_CHAT_ENABLED - 确认原内置玩法已装对应扩展包（见 本体瘦身 对照表）
延伸阅读
| 文档 | 内容 |
|---|---|
| 五分钟跑起来 | 最少跑通 |
| 4.0 路线图 | 牛格 + 瘦身总览 |
| 本体瘦身 | core / extra / 安装路径 |
| Bot ↔ AI 仓 | API 契约 |
| 接话 LLM 路线图 | persona / fallback |
| 方舟 KB | 干员查询与 tools |
| 插件 Cookbook | 写扩展插件 |
