v2.5.4 发布说明

BotShade 已更新至 v2.5.4。本次发布有两个重点。

其一是 全面重做 Discord 上的设置面板。所有带设置界面的功能，现在都采用相同的卡片划分、相同的状态配色和相同的按钮位置。

其二是解决 「保存了却没有生效」 的问题。此前在多个功能中，修改设置后重新绘制的面板会显示修改 之前 的内容，看起来就像按钮没有起作用。这不只是显示问题，部分情况下 编辑的内容会直接丢失。对由此带来的不便，我们深表歉意。

本文目录：

• 亮点
• 全面重做了设置面板
• 保存的内容会立即生效
• 小游戏的修复
• 经济功能现在可以真正关闭
• 控制台的改进
• 稳定性改进
• 兼容性说明
• 支持与社区

亮点

• 重做了所有带设置界面的功能面板。 设置按卡片划分，卡片颜色直接表示该功能是否启用，「刷新」「返回」「关闭」始终位于最下方。
• 分页列表新增 ⏮ / ⏭ 以及直接跳转到指定页 的功能。
• 修复了多个功能中 面板显示修改前内容 的问题，其中包括会导致嵌入消息编辑丢失、已发布的身份组面板回退到旧内容等实际损失。
• 修复了 小游戏赔率与倍率显示和实际不符 的问题，同时修复了通过按钮操作使游戏结果以非预期方式结算的问题。
• 修复了 将经济功能设为关闭后，其全部命令仍可使用 的缺陷。
• 重做了 构建器的日志面板：可仅筛选当前正在编辑的命令或事件，并将一次执行汇总为一张卡片。
• 我方正在更新中的 Bot 现在会显示专用的 「更新中」 状态。

全面重做了设置面板

通过 /protection settings、/ticket settings 等命令打开的设置面板，此前是各自独立编写的，因此 同样是「返回」按钮，所在位置也会因功能而异。设置的分隔也不够清晰，难以判断一项设置从哪里开始、到哪里结束。

在 v2.5.4 中，这些面板全部改为同一种组织方式。

• 设置按卡片划分。 内容不同的设置分属不同卡片，无法撤销的操作（如删除）使用红色卡片明确标示。
• 卡片颜色表示状态。 功能启用为绿色，关闭为灰色，打开面板即可一眼看出哪些功能正在运行。
• 「刷新」「返回」「关闭」始终位于最下方。 这些是针对整条消息的操作，已从原先嵌在卡片内的位置移出。
• 条目较多的列表带有筛选标签。 抽奖管理和提醒列表的顶部会显示「进行中 / 已结束 / 全部」这类切换。
• 分页更好用了。 原先只有「上一页 / 下一页」的位置新增了 ⏮ / ⏭，按下中间的页码还可以 直接跳转到指定页。适用于 Fortnite 联动的商店与外观搜索、自动回复的规则列表以及提醒列表。

涉及的功能包括：验证、服务器保护、工单、欢迎消息、进出日志、置顶消息、等级系统、身份组保留、自动回复、AI 自动回复、AI 使用情况、身份组面板、看板、嵌入消息、投票、备份、抽奖、提醒以及 Fortnite 联动。

设置内容与行为均不会改变。 已保存的设置会原样保留，使用方式与此前相同，变化的只是外观和按钮位置。

此次重做还把面板的组织方式本身抽离成了独立组件。关于这一过程，以及该组件之后的去向，已整理在 重做设置面板的经过 一文中，欢迎感兴趣的朋友阅读。

保存的内容会立即生效

修改设置后面板重新绘制时，可能会 显示修改之前的内容。修改其实已经保存，但界面没有变化，因此看起来像是 按钮没有生效。过一会儿再点「刷新」又能正常显示，这使得问题难以定位。

面板回退虽然影响体验，但尚可重试。不过在若干路径上，它会造成实际损失。

• 嵌入消息的编辑内容可能丢失。 先修改标题、再修改说明，标题的修改会消失。编辑器每次保存都会重新读取当前内容，若读取到的是旧内容，就会覆盖掉您的修改。涉及欢迎消息、进出日志、置顶消息和嵌入消息的编辑界面。
• 身份组面板的「同步到已发布面板」可能把公开消息回退到旧内容，导致刚添加的身份组缺失。/rolepanel send 也会因同样原因发布缺少这些身份组的面板。
• 编辑自动回复规则后，Bot 可能仍按旧规则响应。 不只是面板显示，实际的匹配判断也运行在修改前的版本上。
• 解除保护功能的锁定后，部分频道可能仍处于锁定状态。
• 置顶消息可能出现两条并存的情况。
• 在控制台保存的设置，可能要到下次重新加载后才会传达到 Bot。 自定义命令、自定义事件和变量列表同样如此。

在 v2.5.4 中，写入之后紧接着发生的读取，一定会读到最新的内容。涉及欢迎消息、身份组面板、工单、提醒、自动回复、服务器保护、抽奖、备份、游戏联动、身份组保留、投票、置顶消息、等级系统、嵌入编辑器，以及控制台保存的全部内容。

首次打开面板的方式保持不变，因此不会变慢。

小游戏的修复

部分小游戏的显示与实际行为存在出入。

• Hi-Lo 的胜率显示与实际不符。 此前会显示「High 84.6% / Low 23.1%」这类合计超过 100% 的数值，看起来像是算错了。实际原因是平局的情况被同时计入两侧。v2.5.4 会 明确标出获胜范围——「3 及以上」/「3 及以下」，并附上倍率和说明。A 和 K 由于平局判负，会显示为「大于 A」/「小于 K」。
• 21 点的「黑杰克赔付」设置此前从未被使用。 该项可以配置也有文档说明，但前两张牌凑成 21 点时仍按普通获胜赔付。现在会按您配置的数值赔付。
• Ultimate Luck 的确认界面在修改设置后仍显示旧的倍率与胜率。 现已改为显示实际设置值。
• 二分之一的命令说明与实际倍率不符。 说明写的是「2 倍或 0」，而默认值实际为 1.9 倍。现在会在牌面显示 真实的倍率与命中率。
• 老虎机与扫雷的倍率可能显示为 x2.5000000000000004。

我们还修复了 通过按钮操作使游戏结果以非预期方式结算 的问题，涉及 Hi-Lo、21 点、Ultimate Luck、老虎机、二分之一以及全下确认界面。只扣除了下注金额却不显示结果 的相关情况也已修复。

此外，扫雷在余额系统临时不可用时会 扣除下注却直接作废，现已改为先行确认。

经济功能现在可以真正关闭

将经济功能设为关闭后，其全部 11 个命令仍可正常使用。设置界面上虽然可以切换，但实际上并不存在停用该功能的有效手段。

在 v2.5.4 中，balance、work、deposit、withdraw、send、daily、ranking、status、borrow、repay、bankruptcy 全部会遵循该设置。历史消息中残留的「继续工作」按钮在关闭状态下也不再响应。

控制台的改进

重做了构建器的日志面板

命令与事件构建器中的日志面板此前会显示 整个 Bot 的全部日志，难以判断当前正在编辑的内容是否真的执行过。

• 默认仅显示当前正在编辑的命令 / 事件的日志，不会被其他功能的日志淹没。
• 一次执行汇总为一张卡片，标题栏显示结果、耗时和处理步数。执行失败的记录默认展开。
• 日志会实时推送，打开面板期间自动接收，关闭后停止。
• 失败位置会在画布上标出。 发生失败的模块会带有角标，点击即可仅筛选该模块的日志；也可以从日志跳转到对应模块。
• 失败原因与处理建议可就地查看，无需打开其他界面。
• 即使未打开面板，日志图标上也会以角标显示失败次数。

新增 Bot 的「更新中」状态

在我方对 Bot 执行更新作业期间，此前会显示为「失败」或「启动中」，二者都不准确。v2.5.4 新增了 专用状态与说明横幅，更新完成后会自动恢复为常规显示。

更新期间不接受启动、停止、重启操作（因为这些操作不会被执行）。更新耗时较长时的提示也已改为「尚未确认完成」，而非报告失败。

现在可以通过日志确认保存是否生效

现在会记录 在控制台保存的内容真正被 Bot 应用的时刻。此前应用成功时不会留下任何日志，因此无法回答「保存了，到底生效了没有」这类问题。应用失败时同样会记录。

稳定性改进

• 部分 Bot 可能启动失败。 内部连接断开却未被察觉，处理仍在该连接上继续，这一情况主要出现在更新作业前后。受影响的 Bot 均已自动恢复，但在那一轮中确实没有启动。现在会检查连接状态，失败时自动重试。
• 同样的原因可能导致黑洞功能未经判定即放行消息。 黑洞是 v2.5.3 新增的功能，该失效不会有任何提示，因此难以察觉。现已修复。
• 删除 Bot 时的数据清理更加可靠。 v2.5.3 中提到的「删除 Bot 时一并删除其数据」，现已改为不可能遗漏的形式。

需要说明的是，上述前两项修复 在 v2.5.3 发布后不久即已部署。当时的发布说明中没有记载，因此在本次一并向各位报告。

兼容性说明

您此前使用的 Bot 与命令定义在 v2.5.4 中依旧正常工作。无需进行迁移。

• 面板外观与按钮位置会发生变化。 「返回」「刷新」「关闭」已移至消息最下方。设置的项目、数值与权限均未改动。
• 小游戏的倍率与胜率显示会发生变化。 这是为使显示与实际配置一致所做的修正，并未改动游戏本身的概率或倍率。唯一的例外是 21 点的「黑杰克赔付」设置 此前未被使用，若您曾配置过该项，本次起会实际生效。
• 若您已将经济功能设为关闭，其命令本次起会真正停用。 由于此前开关并未生效，可能会停用您仍在使用的功能，如需继续使用请检查该设置。

支持与社区

如有疑问、缺陷报告或功能建议，欢迎通过以下方式与我们联系：

• 支持页面 —— 咨询表单
• status.botshade.com —— 服务运行状态

今后也请多多关照 BotShade。