pallas-core 4.0.0

Pallas Bot 内核框架 —— 基于 NoneBot2 的社区机器人 SDK

Pallas-Bot

「我是来自米诺斯的祭司帕拉斯，会在罗德岛休息一段时间......虽然这么说，我渴望以美酒和戏剧被招待，更渴望走向战场。」

报告 Bug · 提出新特性

牛牛就是复读机——群友说什么牛牛就说什么。

喜欢牛牛，就给牛牛点个 ⭐ 吧！

✨ 特性

• 学习型复读：记住群友说话，在合适时机复读出来
• 复读优先：可选接入 LLM 辅助，回复仍以群友语料为主
• 插件化：内置插件与本地扩展，按需启用
• WebUI 控制台：浏览器管理配置、插件与权限
• 可选能力：

🚀 快速开始

[!NOTE] 前置：Python 3.12+、PostgreSQL、可用的 OneBot v11 协议端（如 NapCat）。

# 获取代码
git clone https://github.com/PallasBot/Pallas-Bot.git
cd Pallas-Bot

# 安装依赖（推荐 uv）
pip install uv
uv sync

# 主配置（首次部署）
cp config/pallas.example.toml config/pallas.toml
# 编辑 [bootstrap]：监听、superusers、[bootstrap.postgres]

# 开始运行（单进程）
uv run pallas

浏览器打开 http://<主机>:8088/pallas/，使用启动日志中的口令登录。
更完整的上手说明见文档站 快速开始。

📖 文档

部署、配置、插件、迁移与排障见文档站；全网在线牛牛与社区概览见社区中心。

文档站
快速开始
社区中心

🧩 相关仓库

仓库	说明
Pallas-Bot-Docs	文档站源码
Pallas-Bot-WebUI	控制台前端
Pallas-Bot-AI	AI 对话 / 唱歌 / TTS 服务
Pallas-Bot-Community-Stats	社区统计与语料中心服务
community-plugin-index	社区插件商店索引

💭 碎碎念

V3 走到后来，市面上那些 Bot 已经能接话、能记上下文、能把模型用得很顺；牛牛多半还是群里那台搞怪用的复读机，冷不丁冒出一句，把气氛带歪一点点。

群友喜欢她，也是喜欢牛牛的神鬼搞怪。可若只停在记语料、偶尔抛一句，在 LLM 已经走进日常的今天，再假装什么都没发生，其实也有点说不过去。

所以 V4 并不是想给牛牛硬套一张 AI 皮。接上模型，是这个时代绕不开的一步；不接的话，很多「对话」相关的期待，我们自己也接不住。可我仍想把复读放在前面——模型轻轻托一把就好，群友的话才是她真正的声音。这一块也才刚起步，接得还生，偶尔也会闹别扭，还不成熟；但不想让她变成随便哪都能见到的通用聊天壳。

V3 的内核已经有点撑不住了——配置散、约定乱、控制台和运行时也对不太齐，继续堆只会越来越累。于是 V4 把内核与扩展、配置与控制台重新理了一遍；文档站、WebUI、AI、社区统计、插件索引也各自成仓。生态才刚起了个头，后面怎么长，还盼着大家一起养。

一路走来，我更盼的是：维护的人更好配一点，写插件的人更好下手一点；群里那台复读机还在，只是脚下的地，终于更踏实了一些。

💻 开发与贡献

欢迎通过 Issues / PR 参与改进。参与前请阅读 贡献指南 与仓库根目录 AGENTS.md。

公开进展 / 里程碑
贡献指南
Agent 约定

🤝 社区与支持

💬 QQ 群

开发者
拉牛牛
闲聊
社区中心
在线部署 / 牛牛

💝 打赏

请作者喝杯咖啡吧（请备注牛牛项目，感谢你的支持 ✿✿ヽ(°▽°)ノ✿）：

🙏 致谢

• MaiBot：学习与陪伴向聊天机器人项目
• gsuid_core：多 Bot 插件核心框架
• ArknightsGameData：明日方舟游戏数据；决斗干员表与知识库由远端同步其 zh_CN/gamedata
• ArknightsGameResource：干员头像等资源；决斗 / 知识库头像由此拉取
• MaaAssistantArknights：明日方舟长草助手 MAA；本项目的远控能力基于其远程控制协议实现
• NoneBot2：跨平台 Python 异步聊天机器人框架
• jieba_next：基于 Rust 加速的现代中文分词库
• beanie：异步 Python MongoDB ODM
• NapCat：基于 NTQQ 的现代化 Bot 协议端
• zhenxun_bot：QQ 群聊机器人项目
• Amiya-bot：基于 AmiyaBot 框架的 QQ 聊天机器人
• CustomMarkdownImage：基于 Pillow 的可自定义 Markdown 渲染器

📈 数据与贡献者

感谢各位大佬！

📄 许可证

本项目采用 AGPL-3.0（GNU Affero General Public License v3.0）许可证。