仓库结构
字数
525 字
阅读时间
3 分钟
Pallas-Bot 多仓分工与主仓目录。
仓库
| 仓库 | 责任 |
|---|---|
Pallas-Bot | 运行时、内核、内置插件、WebUI 后端、分片与治理 |
Pallas-Bot-WebUI | 控制台前端源码 |
Pallas-Bot-AI | AI / 媒体任务 runtime |
| 官方插件仓 | 独立能力包（如 duel、draw、maa、who-is-spy） |
| 社区扩展仓 | 第三方与站点定制 |
Pallas-Bot-Docs | VitePress 站点（由主仓 docs/ sync） |
主仓目录
| 路径 | 作用 | 典型修改者 |
|---|---|---|
pallas/ | 内核、平台、产品、console | 平台维护者 |
packages/ | 内置插件 | 内置插件维护者 |
tests/ | 回归 | 所有功能开发者 |
docs/ | maintainer / developer 主线 | 文档维护者 |
config/ | 示例与部署模板 | 运维 / 平台 |
data/ | 运行时数据（不入库） | — |
local/plugins/ | 站点私有插件（不入库） | 运维 / 私有作者 |
进程入口
根目录 bot*.py 是各进程形态的入口，按部署形态选择：
| 文件 | 进程形态 | 启动方式 |
|---|---|---|
bot.py | unified 单进程（消息 + 控制台） | uv run pallas / uv run pallas run unified |
bot_hub.py | 分片 hub（WebUI + 协议端，不接牛牛反向 WS） | scripts/run_sharded_bot.sh / pallas shard |
bot_worker.py | 分片 worker（每进程约 5 个牛牛反向 WS） | 同上 |
bot_work_aux.py | work aux 后台任务消费者 | uv run pallas 自动维护；可手动多启 |
bot_embed_aux.py | 本机 Embedding 辅进程（消费 Redis 队列） | uv run pallas 自动维护（local Embedding + Redis 时） |
bot_work_aux.py 与 bot_worker.py 职责不同：前者是后台任务消费者（work aux），后者是分片消息 worker。
易混边界
| 主题 | 源码 | 运行产物 / 其它 |
|---|---|---|
| WebUI | Pallas-Bot-WebUI | data/pb_webui/public-react/（默认 React） |
| AI 执行 | Pallas-Bot-AI | 主仓定义产品与编排边界 |
| 官方玩法 | 对应扩展仓 | 主仓 packages/ 未必有源码 |
| 文档主线 | docs/maintainer/、docs/developer/ | 架构入口在 docs/developer/architecture/ |
改动落点
- 主仓还是兄弟仓？
- 内核还是插件？
- 源码还是运行产物？
- 运维文档还是开发文档？
