NextBot v1.8.0：角色立绘渲染 / 在线图片模式 / Boss 召唤通知

NextBot v1.8.0 更新日志

对比上一个版本 v1.7.0

本次更新带来 6 大新功能，覆盖角色展示、群通知、运维可靠性。

✨ 新功能

🎨 Terraria 角色立绘渲染

• 现在「我的背包」卡片会渲染你的角色立绘——装备、时装、配饰、护甲/配饰染料、发光装备全部还原。
• 所有染料（含 Vortex / Nebula / Stardust / Solar / 彩虹等动态染料）均按原版客户端的真实着色器逆向渲染，颜色与游戏内高度一致。

🖼️ 「在线」命令图片模式

• 在线 命令新增图片模式（默认开启，可在 Web UI 关闭切回文字）。
• 以榜单图展示各服务器在线玩家：角色立绘 + QQ 头像 + 昵称（QQ）+ 本次在线时长，分区标题带服务器 ID。

🐉 Boss 召唤通知

• 玩家召唤 Boss 时自动推送通知到 QQ 群。
• Web UI 可配通知范围、指定群、消息模板（默认 [服务器]玩家 召唤了 Boss）；服务器配置可单独开关该事件推送。

💬 关键词自动回复

• 新增关键词自动回复，配套 Web UI 管理页增删改查。
• 支持「可重复触发」——一条消息可命中多条规则。

💾 数据库自动备份

• 后台定时自动备份数据库（WAL 安全快照），保留最新若干份。
• Web UI 可配：开关（默认开）、时间间隔、保留数量。

📄 运行日志持久化

• 每次运行的日志现在会写入独立文件（logs/ 目录），方便事后排查。
• 默认保留最新 30 份。

🔧 优化与修复

• 菜单中「查询系统」分类移到更靠前的位置。
• 修复商店删除指令在「全部服务器 + 不要求在线」场景的一处守卫问题。
• 角色立绘绘制层序、可见性、偏移等多项细节修正。

---

完整提交记录见 v1.7.0...v1.8.0。

v1.7.0

🆕 新功能

• 修改密码命令：已注册用户可自助修改 TShock 账号密码（私聊使用：修改密码 <新密码>）
• 签到要求在线：签到命令新增「要求在线」开关，开启后必须在任意服务器在线才能签到（默认关闭）
• WebUI 修改密码 / 修改用户名：用户列表新增两个独立按钮 + 对话框，密码框带 🎲 生成
• WebUI 创建用户带密码：创建用户时可设置初始密码，并自动在所有服务器创建 TShock 账号
• 白名单群临时会话：白名单群成员可从 QQ「临时消息」对话框直接给机器人发命令，无需加好友
• 注册自动建账号：「注册账号」命令现在会一并创建所有服务器的 TShock 账号，随机生成密码并通过临时私聊推送给用户

🛠️ 改进

• 同步机制统一：黑白名单 / 账号 / 改密 / 改名 / 封禁 等所有写操作统一通过插件端 sync API 完成；前端反馈改为 per-server 同步结果列表
• 冷却时间更友好：掷骰子 / 猜数字 / 抢劫的冷却时间显示支持分 / 小时（长冷却不再是「120 分 0 秒」这种难读格式）
• WebUI 用户管理：改名拆为独立按钮 + 对话框；移除 ban / unban / delete 的 owner 保护机制（按需自管理）
• 抽奖结果：奖池 ID 显示真实 DB ID，去掉 # 前缀
• 命令简化：「我的背包」/「用户背包」移除「发送链接」参数

🔌 接口（面向插件开发者）

• 新增 GET /webui/api/sync/snapshot：插件端可定时拉取主库快照（含白名单 / 黑名单 / password_hash），支持 ETag 缓存

v1.6.0

v1.6.0

距上一版本 v1.5.2 累计 278 个提交，主线：新命令、命令可视化、WebUI 体验、命令体系收敛、安全加固。

新命令

• 「我的地图」「用户地图」「查看地图」：分别查看个人 / 他人 / 群体共同探索过的地图
• 「地图探索率排行榜」：群内探索进度排行
• WebUI：商店商品 kind 切换确认 dialog / 退出登入确认 dialog

命令可视化升级（纯文本 → 图片渲染）

• 掷骰子：图片渲染 + 新增 win_rate 概率控制（默认 50%，仅大 / 小）
• 猜数字：图片渲染
• 抢劫：图片渲染，「警察」改为「地牢守卫」，加入参与者 QQ 头像
• 所有命令的成功 / 失败 / 图片回复统一加 @ 调用者 前缀（约 130 处）

命令体系收敛

• 重命名：「全亮地图」→「查看全亮地图」（与「查看地图」对齐）
• 分类合并：「服务器列表」并入「查询系统」分类；原「玩家查询」分类改名为「查询系统」
• 下线命令（功能已被 WebUI 覆盖）：
  • group_manager 整个插件
  • permission_manager 3 条 admin 用户权限命令
  • server_manager 3 条 admin 命令（仅保留「服务器列表」）

体验改进

• 「允许登入」/「拒绝登入」多服务器场景文案简化：至少一台成功 → 简洁成功；全失败 → 「没有待处理的登入请求」
• 命令别名 + @用户 解析失败修复
• 命令格式错误提示也加 @ 调用者
• 抽奖概率精度：0.1 → 0.01
• 玩家背包页面新增「地图探索率」字段

WebUI

• 统一 dialog：用自写 dialog 替换 window.alert / window.confirm，外观一致并支持自定义文案
• CRUD 反馈：商店 / 抽奖增删改成功后 toast 提示
• 导入流程：商店 / 抽奖导入确认文案统一为「全量替换」
• 表头与 ID 列：商店 / 抽奖 ID 显示真实 ID
• 设置页：保存重启后正确探活（401 视为已恢复）+「正在重启」状态提示
• 仪表盘：命令计数过滤已下线命令（与命令页面对齐）
• 认证中间件：API 请求返回 401 JSON、HTML 请求 302 跳转登录页
• 9 个模块累计 200+ 项审计加固：输入校验、文案一致性、性能、可访问性、错误处理

底层

• SQLite WAL 模式 / 检查点 / 迁移安全
• 服务器 Token：日志 mask + 新增 reveal 端点（敏感操作 audit log）
• 速率限制 / 安全头（CSP / X-Frame-Options 等）/ 防自死锁
• 多轮基础设施审计（round 3 → round 9）

升级提示

• 之前如果有调用 group_manager / permission_manager admin / server_manager admin 命令的用户，请改用 WebUI

v1.5.2

本次为 bug 修复版本，专门解决 v1.5.0 多主题清理时遗留的回归问题。

🐛 修复

• 修复所有排行榜命令调用即崩溃：金币 / 连续签到 / 抢劫收益 / 抢劫损失 / 抢劫成功率 等 16 个排行榜命令均受影响（v1.5.0 删除多主题支持时漏改了一处内部 helper 函数签名）

🧹 内部

• 彻底清理截图渲染链路残留的 theme= 死代码（17 个路由 + 16 个 page 模块），消除同类回归隐患

v1.5.1

本次更新主要围绕 截图稳定性 / 性能提升 和 新增「抢劫保护」机制。

✨ 新功能

• 切换抢劫保护：付金币开启后既不能抢劫他人也不会被他人抢劫，默认 200 金币 / 次（可在 WebUI 命令配置中调整）
• 菜单截图显示命令别名：每条命令配置的自定义别名会以小标签形式展示在卡片上

⚡ 性能

• 截图速度大幅提升：浏览器实例复用，连续截图稳态约快 5–8 倍；并发截图不再为每次请求启动新进程

🎨 视觉

• 侧栏 logo 改为矢量 SVG，跟随浅 / 暗主题自动变色，去除了原 PNG 周围的方块背景
• 命令配置 / 抽奖管理 / 身份组管理 三个侧栏图标语义更清晰

🐛 修复

• 解决截图偶发 15 秒 Timeout 失败的问题

v1.5.0

本次版本对 截图渲染 和 WebUI 管理后台 进行了整体视觉重构，统一升级到全新的 warm-canvas 编辑风格设计系统。

✨ 新功能

• 赠送仓库物品：新增玩家间互赠仓库物品的命令
• 同步访客权限：新增管理员命令，自动同步访客身份组权限（带二次确认）
• 商店 / 奖池 JSON 导入导出：WebUI 商店管理与抽奖管理新增数据备份与迁移能力

🎨 视觉与体验

• 17 个截图模板 全部按全新 warm-canvas 设计语言重做：菜单 / 用户信息 / 红包 / 仓库 / 商店 / 抽奖 / 排行榜 / 背包 / 进度 / 封禁列表 / 管理员列表 / 关于 / 教程
  • 统一的 cream 米白色背景、Cormorant Garamond 衬线标题、Inter 数字字体
  • 4 阶语义色板（普通 / teal / amber / coral）替代旧的多色渐变
  • 截图自适应内容高度，告别底部空白
• WebUI 管理后台 全量重构：
  • 仪表盘 / 登录 / 设置 / 命令配置 / 服务器 / 用户 / 身份组 / 仓库 / 抽奖 / 商店 全部页面统一新风格
  • 保留亮色 / 暗色双主题切换
  • 数据密集页面表格自适应桌面全宽
  • 按钮文案瘦身（如「保存并重启」→「保存」、「确认删除」→「删除」）
  • 删除按钮从编辑对话框移到列表项 / 表格行，操作更直接
  • 浏览器原生 `confirm()` 弹窗替换为统一风格的 modal 对话框

🐛 修复

• 修复菜单截图固定高度导致底部留白的问题

🔧 配置变更（需要注意）

• 移除 `RENDER_THEME` 环境变量：所有截图模板已统一为 light 风格，无需再选主题。升级时可从 `.env` 中删除该项；WebUI 设置页面的"图片主题"选项也已下线（升级时若旧 `.env` 中仍有该字段不会报错）

内部

• Trellis workflow toolkit 升级至 0.5.0-rc.3

v1.4.1

Docker 部署支持

• 新增官方 Docker 镜像 ghcr.io/arispex/nextbot:latest，提供 linux/amd64 与 linux/arm64 两种架构，每次打 tag 自动构建并发布到 GitHub Container Registry
• 提供 docker-compose.yml 一键部署 NextBot + NapCat 完整栈：QQ 登录态、NapCat 配置、NapCat 插件、NextBot 数据库与配置全部自动持久化到宿主机目录，重启 / 升级容器无需重新扫码或配置
• 新增 Linux / macOS Docker 安装教程，按步骤覆盖 Docker 安装（含国内清华镜像源）、容器启动、NapCat 扫码登录、NextBot WebUI 配置、TShock 服务器接入全流程

内部改动

• 持久化状态文件（.env / app.db / .webui_auth.json）统一通过 NEXTBOT_DATA_DIR 环境变量定位。裸机部署默认存放在项目根目录，行为完全无变化；容器内则统一挂到 /app/data 卷

v1.4.0

三大金币消费系统

📦 仓库系统

每位玩家专属 100 格仓库，承接抽奖和商店物品。支持单格 / 区间 / 列表 / 全部等格子表达式，可一键领取到游戏、回收换金币或丢弃释放格子。物品带「最低进度」门槛，只能投递到已达成对应 boss 的服务器。

🛒 商店系统

管理员在 WebUI 配置上架商品，玩家用金币购买。两类商品：

• 物品类 — 进入仓库，支持进度门槛、神秘盲盒、估价覆盖等
• 指令类 — 立即在服务器执行，支持单服 / 全服、需要在线等

发送 商店列表 / 查看商店 <ID> / 购买商品 <商店 ID> <商品 ID> 使用。

🎰 抽奖系统

管理员配置奖池和奖品，玩家花金币随机抽。三类奖品：物品 / 指令 / 金币（金币奖品可正可负 = 惩罚）。结果以 gacha 风格图片展示，按概率自动分稀有度配色。

发送 奖池列表 / 查看奖池 <ID> / 抽奖 <ID> [次数] 使用。

使用教程扩展

使用教程 新增 5 个图文条目：

• 📦 仓库系统
• 🛒 商店系统
• 🎰 抽奖系统
• 🧧 红包系统
• 🎲 小游戏系统

并修复了上一版 使用教程 命令默认 guest 用户无权限访问的问题。

菜单调整

猜数字 / 掷骰子 / 抢劫从原分类拆出，独立为「小游戏系统」类目。

改进

• 命令参数占位符标准化，提示文案更自描述
• 管理类命令成功回复改为字段化多行结构，更易阅读

v1.3.0

继 v1.2.0 之后，本版本带来了 红包系统、新手教程、群进出提醒 三大全新功能，并对全项目命令回复进行了视觉统一。

🆕 新功能

🧧 红包系统

• 新增 5 个命令：发红包 / 抢红包 / 收回红包 / 我的红包 / 红包列表
• 支持「平分」和「拼手气」两种发放方式
• 我的红包 / 红包列表 为网页渲染图片，支持分页（默认每页 10 条，可在命令配置调整）

📚 使用教程（新命令）

• 新增 使用教程 命令（两级菜单，与 菜单 用法一致）
• 首发「新手教程」：从注册账号一步步引导到成功加入服务器，覆盖白名单同步、二次验证等关键步骤
• 教程图内嵌模拟 QQ 群聊，所见即所得地展示「你发什么 → 机器人回什么」

👥 群进出提醒

• 新成员入群 / 老成员退群时，机器人可在群内自动发送欢迎 / 道别消息（模板可在 WebUI 配置）
• 退群成员可选择自动加入封禁列表，并在群内同步发出公告

✨ 体验优化

• 菜单重构：原本一长串的命令列表改为两级分类菜单——菜单 看分类、菜单 <分类> 看具体命令
• 回复排版统一：全项目命令回复改用统一的 emoji 视觉规范（✅ / ❌ / ⚠️ / ℹ️ / 💡），多行命令的 @用户 单独占一行，不再挤在标题前
• 注册账号 成功反馈：从单行改为多行展示「用户名称 / QQ」
• 在线玩家 排版：多服务器之间空行分隔；玩家计数括号统一全角
• 中英文标点统一：全项目中文文案统一使用全角标点

v1.2.0

新功能

• 新增 QQ 群命令 发送 <服务器ID> <内容>：把 QQ 消息发到游戏内
• 新增 上下线通知 和 消息同步 功能：玩家上下线、游戏内聊天可推送到 QQ 群（需搭配 TShock 插件）
• WebUI 设置页可单独配置两类通知的目标群和消息模板
• WebUI 插件配置 dialog 新增「服务器标识」和「玩家事件推送」开关

修复

• 修复了抢劫金币为 0 的用户只能空抢的问题
• 修复了自己金币为 0 时抢劫失败后金币变负数的问题