# 这是什么
Penguin 是 HuHoBot 的新一代主线，取代了原先「每个平台一个仓库」的旧适配器架构。
组织下 6 个 Penguin* 仓库构成一个家族：1 个上游主分支 + 5 个平台 / 功能分支。
双向消息桥接
游戏聊天转发到 QQ 群，QQ 群消息广播到游戏内。支持格式模板与前缀过滤。
QQ 官方 Bot 接口
走 q.qq.com 官方开放平台，不使用第三方协议，无封号风险。
30+ 群指令
查在线、白名单管理、管理员管理、MOTD 查询、命令执行、认证状态，权限分级。
敏感词审核
本地正则 + 词库两级过滤，可选接入 OpenAI 兼容接口做 AI 二审，接口不可用自动回退。
AI Agent 智能管理
群里 @机器人 /agent 任务，AI 自动选工具执行；危险操作需管理员按钮审批。
WebUI 图形化配置
浏览器打开管理面板改配置，实时保存自动重载，无需手改 YAML。
附属插件 / 脚本扩展
AddonAPI 注册扩展与自定义命令；部分分支支持 JS / Lua / Python 脚本插件热重载。
扫码绑定
首次启动在控制台打印二维码，手机 QQ 扫码后自动写回 AppID / Secret 并连接。
# 该选哪个分支
按你的服务端类型直接查表。表中内容来自各仓库 README 与代码结构实测。
| 你的服务端 | 推荐分支 | 说明 |
|---|---|---|
| Spigot / Paper | PenguinAgent | 功能最全、更新最勤，AI Agent + WebUI + 脚本扩展 |
| Velocity / BungeeCord | PenguinClient | 唯一带 Redis 路由的代理层实现 |
| Allay | PenguinClient | 唯一提供 Allay 模块的仓库 |
| Nukkit-MOT（基岩） | PenguinAgent-NukkitPlatform | 唯一活跃选择，含 Bedrock 贴图 / 皮肤适配 |
| BDS / LeviLamina（基岩） | PenguinBDSClient | 唯一实现，MIT 许可，零 npm 依赖 |
| Fabric 1.20.1–1.21.x | PenguinClient-Fabric | 用 mc1.20.1+ 产物（需 Java 21） |
| Fabric 26.x | PenguinClient-Fabric | 用 mc26.x 产物（需 Java 25） |
| NeoForge 1.21.1 | PenguinAgent-NeoForged | 唯一实现，但维护较慢，部署前请评估 |
# 下载
下面列出每个仓库最新 Release 的全部产物。每个文件都提供两条线路，任选其一： 代理加速（默认，国内友好）与 GitHub 直连（官方源）。
# 使用说明
两条下载线路有什么区别？
GitHub 直连直接访问 github.com 的 Release 资源，是官方源，速度取决于你的网络到 GitHub 的连通性。
代理加速通过 v4.gh-proxy.org 中转，格式为
https://v4.gh-proxy.org/<原始GitHub链接>，国内网络通常更稳。
两者下载到的文件完全一致，代理只是转发，不修改内容。
数据是怎么来的？会实时更新吗？
页面通过本站的 Cloudflare Pages Function（/api/releases）调用 GitHub 官方 API
获取各仓库最新 Release，包含该 Release 下的全部产物文件。
服务端缓存 10 分钟，浏览器缓存 5 分钟。点「强制刷新」可跳过缓存立即回源。
为什么有的分支版本号差很多？
各分支独立发版，版本号不可横向比较。例如 PenguinAgent 已到 v1.18.x，
而 PenguinClient 最高只有 v1.4.0 —— 后者是上游主干，功能更薄但平台覆盖更广。
另外注意：部分仓库的 gradle.properties 版本号与 git tag 不一致，
请以 Release 标签为准。
PenguinClient 的群管理功能下载得到吗？
PenguinClient 的「QQ 群管理接口 + 群成员进退群事件」目前只存在于
master 分支，尚未发版（最高 Release 仍是 v1.4.0，不含该功能）。
需要这些能力请从源码构建，或改用 PenguinAgent。
NeoForge 分支可以放心用吗？
PenguinAgent-NeoForged 最后更新于 2026-08-26，功能落后上游约 14 个版本，
且仓库的 gradle.properties 版本号（1.2.2）与 Release 标签（v1.4.0）不一致。
它是 NeoForge 1.21.1 上的唯一实现，但新部署前建议评估。
Fabric 的两个产物怎么选？
mc1.20.1+ 适用于 Minecraft 1.20.1–1.21.x，需要 Java 21；
mc26.x 适用于 Minecraft 26.x，需要 Java 25。
两条分支的附属插件 API 签名一致，同一份插件代码可以原样跑两边。
许可证是什么？
除 PenguinBDSClient 采用 MIT 外，其余 5 个仓库均为 AGPL-3.0。
AGPL 要求：修改后的版本必须以相同许可证发布；若通过网络提供服务，必须向用户提供源代码。