HuHoBotPenguin v1.0.3 — 标准版 + AI 版（Llama）

🐧 HuHoBotPenguin v1.0.3 — 标准版 + AI 版（Llama）

本仓库现分两个独立插件（plugins/ 下二选一部署）：

• HuHoBotPenguin-LLSE — 标准版（QQ ↔ BDS 双向桥接，20+ 群指令、MOTD、Markdown 卡片）
• HuHoBotPenguin-LLSE-Llama — AI 版（标准版全部功能 + 内置 LLM AI 助理，无需 AstrBot）

两个版本本次统一为 v1.0.3。

---

目录

• ✅ 标准版 HuHoBotPenguin-LLSE (v1.0.3)
• 🤖 AI 版 HuHoBotPenguin-LLSE-Llama (v1.0.3)
• 📦 安装
• 📜 License

---

✅ 标准版 HuHoBotPenguin-LLSE (v1.0.3)

功能特性

• 游戏 ↔ QQ 双向转发：游戏内 #消息 ↔ QQ 群；20+ 群指令（查在线 / 白名单 / 管理员 / 认证等）
• 📋 Markdown 卡片：查在线 / 查白名单 / motd 命令（motd.use-markdown 总开关）
• 🖼️ MOTD 状态图 + 可编辑模板：Markdown/online.md 自定义查在线输出、motd.api/motd.text 模板
• 🎛️ 控制台命令：huhobot reload（热重载）/ huhobot info
• 🛡️ 敏感词审核：正则 + 本地词库 + 可选 OpenAI 兼容二审
• 零 npm 依赖：自实现 WebSocket / HTTP(S)

修复

• 「执行命令」对齐 Java 原版：管理员直接执行任意控制台命令
• 「查白名单」支持 BDS 1.21+ allowlist list JSON 解析
• huhobot 控制台命令注册签名修正

---

🤖 AI 版 HuHoBotPenguin-LLSE-Llama (v1.0.3)

标准版全部功能 + 内置 LLM AI 助理（OpenAI 兼容接口，支持 DeepSeek / Qwen / GPT / 本地 Ollama，无需 AstrBot）。

AI 能力

• 群内 AI 对话：多轮上下文（按群持久化，重启不丢）
• function calling 工具：AI 自动调用 查询在线 / 查询白名单 / 执行命令
• 🧩 自定义 Skill：WebUI 定义 AI 技能 → AI 调用后执行你的控制台命令（{0}/{1} 参数占位、权限分级）；内置 LegacyMoney（查/加/扣/转金币）、踢人、封禁 预设一键添加

WebUI 管理面板（深色侧边栏多页面）

• 总览（状态 + 快捷开关）/ AI 工具 / Skill 管理 / AI 对话 / 配置（分组表单，保存自动热重载）
• 监听地址可配（webui.host：127.0.0.1 仅本机 / 0.0.0.0 外网，需配密码）
• 账号密码登录、移动端自适应

安全

• ai.admin-openids：AI 执行命令 / 管理员 Skill 的白名单（配你的 QQ OpenID）
• WebUI 默认仅绑定 127.0.0.1

要求

• 模型需支持 function calling（OpenAI 兼容接口均可）

---

📦 安装

版本	插件目录	发行文件
标准版	plugins/HuHoBotPenguin-LLSE/	HuHoBotPenguin-LLSE-v1.0.3.zip
AI 版	plugins/HuHoBotPenguin-LLSE-Llama/	HuHoBotPenguin-LLSE-Llama-v1.0.3.zip

1. 安装 LSE Node 引擎：lip install github.com/LiteLDev/LegacyScriptEngine
2. 解压对应 zip 到 plugins/<版本目录>/
3. 填 config.json（bot.app-id / bot.secret；AI 版额外 ai.base-url / ai.api-key / ai.model）——首次启动自动生成
4. 重启服务器 → 控制台 QQ 机器人已连接

📜 License

MIT © 2026 HuHoBot

HuHoBotPenguin v1.0.2

🐧 HuHoBotPenguin v1.0.2

✨ 新功能

• Markdown 总开关：新增 motd.use-markdown（对齐 Java 版），false 时查在线/查白名单/motd 命令全部回退为格式化纯文本（不再是原始命令输出）
• 格式化纯文本回退：
  • 查在线 → 当前在线：2 人 / Alice、Bob
  • 查白名单 → 当前白名单：2 人 / Beeeeeereally、Beeeeeawa
  • motd 命令 → 状态/玩家/版本/延迟分行文本

🔧 调整

• 配置版本升级：config-version 2 → 3（新增 serverName、features.markdown-*、motd.* 配置，老用户配置自动补齐）

⚙️ 配置

配置	默认	说明
motd.use-markdown	true	Markdown 消息总开关；false 时所有卡片消息回退格式化纯文本

📦 安装 / 更新

替换 plugins/HuHoBotPenguin-LLSE/ 下全部文件（保留你的 config.json），执行 huhobot reload 或重启服务器。首次启动自动将配置升级到 v3。

📜 License

MIT © 2026 HuHoBot

HuHoBotPenguin v1.0.1

🐧 HuHoBotPenguin v1.0.1

v1.0.1 发布：MOTD 服务器状态图 + motd 命令（查询任意服务器） + 多项修复，追平 Java 版功能。

✨ 新功能

• 🖼️ MOTD 状态图："查在线"卡片顶部显示服务器状态图（motd.minebbs.com 生成，含状态/在线人数/延迟/版本/MOTD）。配置 motd.ip / motd.port 即可启用，留空不显示
• motd <地址[:端口]> 命令：群里直接查询任意 Minecraft 服务器（基岩/Java 都支持），在线时输出 Markdown 卡片 + 状态图，离线给出提示
• 📋 Markdown 卡片："查在线" / "查白名单"以 Markdown 卡片展示（msg_type=2，官方已向所有机器人开放，无需申请模板）

🔧 修复

• 执行命令：对齐 Java 原版语义——管理员可直接执行任意服务器控制台命令（此前误与"执行"相同）
• 查白名单：支持 BDS 1.21+ allowlist list 的 JSON 输出解析
• huhobot 控制台命令：修复 mc.regConsoleCmd 注册（LLSE 需 3 参数签名）

⚙️ 配置新增

配置	默认	说明
motd.ip	空	服务器公网地址，填写后"查在线"显示 MOTD 状态图；留空不显示
motd.port	19132	服务器端口（BDS 默认 19132）

📦 安装 / 更新

替换 plugins/HuHoBotPenguin-LLSE/ 下全部文件（保留你的 config.json），执行 huhobot reload 或重启服务器。

📜 License

MIT © 2026 HuHoBot

HuHoBotPenguin v1.0.0

🐧 HuHoBotPenguin v1.0.0

QQ 开放平台官方机器人 ↔ Minecraft 基岩版 BDS 服务器聊天/命令桥接插件（LeviLamina / LLSE Node.js 后端），由 HuHoBot/PenguinClient（Java 版）移植而来。

✨ 功能特性

• 游戏 ↔ QQ 双向转发：游戏内 #消息 → QQ 群；群内 @机器人 命令/消息 → 游戏
• 20 个群指令：查在线、查白名单、白名单增删、管理员管理、认证、发信息、全量转发等，可逐个开关
• 📋 Markdown 卡片：查在线 / 查白名单 以 Markdown 卡片展示（msg_type=2，官方已向所有机器人开放，无需申请模板）
• 敏感词审核：正则 + 本地词库 + 可选 OpenAI 兼容 AI 二审，接口不可用时自动回退本地屏蔽
• 自定义命令：占位符替换（{params} / {group} / {user} / {0}…）+ 权限分级
• 多群独立：每群独立的管理员名单、认证状态与全量转发开关
• 进服/退服通知：🟢/🔴 事件推送，模板可配
• 控制台命令：huhobot reload（热重载配置，无需重启服务器）/ huhobot info
• LuckyClover 联动：导出 ll.imports("HuHoBotPenguin", "send") 接口
• 零 npm 依赖：自实现最小 RFC6455 WebSocket 客户端 + TLS，REST 走内置 https

📦 安装

1. 安装 LSE Node 引擎：lip install github.com/LiteLDev/LegacyScriptEngine
2. 将插件目录放入 plugins/HuHoBotPenguin-LLSE/
3. 编辑 config.json 填入 bot.app-id / bot.secret（QQ 开放平台 WebSocket 接入）与目标群 OpenID
4. 重启服务器，控制台出现 QQ 机器人已连接 即成功

首次启动会自动生成 config.json（含默认值）。BDS 1.21+ 使用 allowlist 命令体系，旧版 BDS 请将白名单相关命令模板改回 whitelist。

⚠️ 注意事项

• 正式环境：本版本固定连接正式网关（api.bot.qq.com），机器人需提审上线后才收得到群事件
• 机器人在群里需被群主"添加到群聊"，且开启"机器人主动在群聊内发言"

📜 License

MIT © 2026 Mell