v2.5.2 发布说明

BotShade 已更新至 v2.5.2。本次发布带来 置顶消息 与 消息截图 两项新功能、等级系统图片的全面重制、由 BotShader AI 直接修改 Bot 设置，以及 自定义命令错误处理 的正式实现。同时修复了功能开关需重启 Bot 才生效的问题，以及涉及权限与机密信息的多项安全问题。

如您发现任何问题，欢迎通过 支持页面 反馈。

本文目录：

• 亮点
• 置顶消息 —— 让重要通知始终停留在频道最下方
• 消息截图 —— 将对话生成为一张图片
• 等级系统图片全面重制
• BotShader AI 现已可修改 Bot 设置
• 自定义命令的错误处理现已生效
• 功能开关无需重启即可生效
• 日志页面的改进
• Bot 页面加载提速
• 安全相关修复
• 缺陷修复
• 兼容性说明
• 支持与社区

亮点

• 新增 置顶消息。可将规则、报名说明等消息 始终固定在频道最下方，即使有人发言导致其上移，Bot 也会自动重新发布。
• 新增 消息截图。可将所选范围的对话，以 与 Discord 完全一致的外观 生成为一张图片，并支持隐藏昵称与头像的「隐藏信息」模式。
• 等级系统图片 已从渲染底层重制。等级卡、排行榜、升级通知三者的观感均更为顺滑清晰，昵称与标题中的表情符号也能正常显示 了（此前会直接消失）。
• BotShader AI 现已可修改 Bot 设置。您只需说「把每日奖励改成 250」，AI 便会以卡片形式提出变更方案，经您确认后再行应用。
• 自定义命令的 错误处理器现已真正运行，并且可从日志追溯是哪条命令因何失败。
• 修复了在控制面板中启用功能后，必须重启 Bot 才会生效 的问题。
• 修复了包括 DM 权限绕过在内的 安全问题。若您在自定义命令中使用了环境变量，请查阅 安全相关修复。

置顶消息 —— 让重要通知始终停留在频道最下方

规则、报名截止时间、参与方式 —— 这类希望所有人都能看到的消息，往往随着对话推进很快就被顶上去了。Discord 的置顶功能只是把消息收进顶部的列表，正在看频道的成员并不会注意到。

置顶消息 会将您指定的消息 始终保持在频道最下方。当有人发言、置顶消息不再位于最下方时，Bot 会自动重新发布。

使用方法

在 Discord 中执行 /sticky-message [频道] 即可打开设置面板，可进行以下操作：

• 编辑正文 —— 置顶消息的文本内容
• 编辑 Embed —— 与欢迎消息等功能使用同一套通用编辑器
• 暂停 / 启用 —— 保留配置的同时临时停用
• 解除置顶 —— 连同配置一并删除
• 本服务器列表 —— 查看所有已设置置顶的频道，并直接跳转至各自的设置

关于重新发布的机制

重新发布的频率限制为 每 10 秒最多 1 次。

• 在安静的频道中，有人发言后会立即重新发布。
• 在活跃的频道中，会以 10 秒为间隔集中重新发布。若每条消息都重发，频道会被置顶消息刷屏。
• 密集发言平息后还会补发 1 次，因此不会遗漏。

需要说明的是，Discord 并不提供移动消息的接口，因此「固定在最下方」是通过 删除上一条置顶消息并重新发布 来实现的。置顶消息看起来会先消失再出现，原因即在于此。

控制面板的「置顶消息」页面用于设置功能的总开关与命令权限。置顶的内容本身以频道为单位，请从 Discord 的面板进行配置。

消息截图 —— 将对话生成为一张图片

精彩的讨论、达成共识的往来、想日后回看的说明 —— 此前分享这些内容时，您只能贴出链接，或自行在设备上截图再裁切。

消息截图 可将所选范围的对话，以 与 Discord 完全一致的外观 生成为一张图片。

范围的选取方式

由于 Discord 并没有「长按并框选范围」的操作，我们采用了 执行两次上下文菜单命令 的方式。

1. 右键点击（手机端为长按）范围的 起始 消息，从「应用」中执行 选择截图范围。系统会记录起点，并仅向您本人显示提示。
2. 在范围的 结束 消息上执行同样的操作，即可生成该范围的图片。

起点将在 5 分钟后失效。您也可随时通过提示中的取消按钮撤销。

生成后的操作

图片生成后，可通过按钮进行两项操作：

• 隐藏信息 —— 将昵称替换为「成员 A」「成员 B」等，头像替换为纯色圆形，并一并隐藏身份组颜色、身份组图标、服务器名称、频道名称与频道 ID。同一位成员始终对应同一标签与同一颜色，因此谁在回复谁的对应关系依然清晰可辨。正文内容不作任何改动。
• 切换主题 —— 可在深色 / 浅色之间切换。

可还原的元素

带身份组颜色的昵称、身份组图标、Bot 的「应用」徽章、连续发言时省略的消息头、回复预览、加粗 / 下划线 / 删除线 / 行内代码 / 代码块、提及与链接的着色、表情符号（含服务器自定义表情）、附件图片预览、「（已编辑）」标记 —— Discord 的外观将被原样还原。

限制事项

• 执行者与 Bot 双方都需要 能够查看目标频道（查看频道与读取消息历史权限）。
• 剧透附件不会打开内容，仅以文件名标签的形式呈现。
• 附件图片最多收录 6 张，单张不超过 5 MB。
• 单张图片可包含的消息数量存在上限（可在控制面板中设置为 1〜50，默认值较为保守），超出部分将折叠为「以下省略」。

控制面板的「消息截图」页面可配置 是否仅对执行者可见、初始主题、单张图片的消息数上限 以及上下文菜单的权限。

等级系统图片全面重制

等级卡、排行榜、升级通知三类图片，均已在全新的渲染基础上重新构建。

• 边缘更为顺滑 —— 圆形、进度条与圆角此前边缘呈锯齿状，现已解决，输出分辨率也提升至 2 倍。
• 表情符号可正常显示 —— 昵称或标题中若含表情符号，此前会完全不显示（默认标题中的 🏆 亦是如此）。现已可正常绘制，包括服务器自定义表情。
• 等级卡 —— 移除了与昵称、进度条相互重叠的巨大背景数字，改为带进度圆环的 等级奖章。
• 排行榜 —— 每一行改为独立卡片，前三名附有奖牌与奖牌配色的描边。领奖台的设计也已重新构建。
• 升级通知 —— 新增渐变标题、庆祝粒子效果与等级变化的呈现。
• 修复了 水印与正文重叠 的问题。

生成速度与文件体积也有所改善：等级卡的 生成耗时约为原先的 1/5，文件体积约为原先的 1/3。

BotShader AI 现已可修改 Bot 设置

此前 BotShader AI 只能告知您「该改哪一项、在哪里改」，实际的修改仍需您在界面上手动完成。自 v2.5.2 起，AI 可直接提出设置变更方案，经您确认后当场应用。

操作流程

1. 在打开 Bot 设置页面的状态下打开 AI 面板，如「把每日奖励改成 250」「把升级通知发到 #general」这样告知即可。
2. AI 会以 卡片 形式呈现变更内容，逐项显示「变更前 → 变更后」及其理由。
3. 确认无误后按下 [应用]，变更即写入设置表单。此时尚未保存。 请照常通过页面底部的保存栏保存。
4. 若方案不合心意，可通过 [放弃] 直接撤销。

也就是说，AI 绝不会擅自保存。您将经过「应用方案」与「保存」两道确认。

安全限制

• 权限设置无法由 AI 修改。 命令的允许身份组、权限覆盖等一切与权限相关的项目均不在范围内。
• 可修改的项目仅限于预先列举的白名单，AI 无法凭空创建不存在的设置项。若方案中包含范围外的项目，仅该项目会被驳回并显示原因。
• 若方案中包含 关停功能方向的变更（如关闭功能本身），卡片会显示警告；涉及关键模块时将以红色重点标示。

一并改进的内容

• 在 Bot 页面停留期间，该 Bot 将始终作为 AI 的操作对象。 此前从第二条消息起，每次都需要重新指定 Bot。
• AI 谈及设置时，不再念出 economy.dailyBonus 这类内部键名，而是使用 界面上显示的项目名称（「每日奖励额度」）。
• 变更卡片现在 默认折叠为一行。此前只要有数项变更，对话就会被挤出屏幕。折叠状态下仍会显示警告与 [应用] / [放弃] 按钮，关闭按钮也随时可用。
• 从历史记录打开会话时，现已可在面板内直接继续。 此前每次选择会话，面板都会关闭并跳转至全屏视图。

自定义命令的错误处理现已生效

命令构建器中此前便已提供错误处理器（errorHandler）节点，但 Bot 端尚未实现，因此实际发生错误时只会显示默认文案「命令执行过程中发生了错误。」。v2.5.2 起该节点 已真正生效。

• 命令执行过程中发生的错误将被捕获，并执行接在错误处理器之后的流程。
• 在处理器中可使用 {Error.message}（错误内容）、{Error.detail}（详情）、{Error.block}（发生位置）与 {Error.type}（错误类别）。由此即可搭建「向用户显示友好提示，同时将详情发送至管理频道」这类构成。
• {Error.type} 同样可用于条件分支的比较。将其设为基准值后，编辑器会给出类别键的候选提示。
• 置于函数内部的错误处理器会在该函数内完成处理，并将函数视为正常结束。若函数内没有处理器，错误将向上冒泡至调用方的处理器。
• 错误处理器拥有 独立的执行时长（默认 15 秒），即便命令主体已耗尽自身预算，处理器依然能够运行。
• 仅对执行者可见 的错误处理器显示设置，现已可正确生效。

错误现已可追溯

未被错误处理器捕获的错误，现在也可从日志中追溯原因。

• 日志详情中新增 「自定义命令」卡片，显示错误类别、未被捕获的原因（未设置处理器 / 处理器之后未连接 / 处理器自身失败）、发生的区块以及节点 ID。
• 可从该卡片 直接跳转至命令构建器中的对应节点。
• 当错误类别可判定时，Discord 侧的提示文案也会随之调整（例如「请确认函数是否已被删除」）。
• 日志中可能出现的机密信息（环境变量的值等）将被自动遮蔽。

功能开关无需重启即可生效

修复了在控制面板中启用功能后，必须重启 Bot、否则该功能的命令完全不会出现在 Discord 上 的问题。

此前功能模块仅在 Bot 启动时加载，运行中的设置变更只能作用于已加载模块的命令级开关。自 v2.5.2 起，保存设置时即会完成模块的加载与卸载，无需重启 Bot。

日志页面的改进

• 修复了 正常结束的命令被显示为「执行失败」 的缺陷。自定义命令的执行日志会记录开始 / 完成 / 失败三个阶段，但此前无论处于哪个阶段都套用了失败文案。
• 日志的 显示分类细分为 29 种，此前绝大多数都被归入「功能」。筛选条件中也新增了「分类」。
• 分类标签统一为中性样式，颜色仅用于表示状态（成功 / 失败等）。
• 整理了日志表格的列宽，解决了表头与行错位的问题。

Bot 页面加载提速

• Bot 的信息现在会 在会话期间缓存。此前每次离开 Bot 页面再返回，都会重新获取 4 类信息，期间整个页面处于加载状态；短时间内的往返现已不再触发请求。若存在未保存的编辑，则不会执行后台重新获取，以保护您的输入内容。
• 加载过程中也会显示导航栏。 此前加载时整个页面只剩加载动画，通往其他页面的入口也一并消失。
• 移除了侧边栏的开合动画。 此前每次开合都会让整个页面晃动约 0.3 秒，现已改为即时生效。
• 将「即将推出」的模块从导航中隐藏。 尚不可用的 9 个项目（Webhook / 邀请追踪 / 社交通知 / VALORANT 商店 / APEX 信息 / 堡垒之夜信息 / 搜索 / 翻译 / 天气）占据了列表，使真正可用的功能难以查找。这些项目将在正式提供时重新列出。

安全相关修复

以下为内部排查中发现的问题，均已修复，您无需进行额外操作 —— 但 若您在自定义命令中使用了环境变量，请务必查阅第 1 条。

• 修复了可通过自定义命令读取环境变量的问题。 构建消息文本的处理中存在将使用者输入重新解释为变量引用的路径，因此只要在命令选项中直接输入变量写法，即可输出该命令所引用的环境变量的值。为稳妥起见，若您在自定义命令的环境变量中保存了 API 密钥等机密信息，建议考虑重新签发。
• 修复了 DM 中权限设置被绕过的问题。 即便已设置命令的允许身份组或所需权限，通过向 Bot 发送私信执行时也未被评估。现已将 DM 中的执行者视为「既无身份组也无服务器权限的使用者」，按与服务器内相同的规则进行判定。未设置任何限制的命令，仍可照常在 DM 中使用。
• API 请求的重定向目标现已逐跳重新校验。「API 请求」节点的目标地址限制此前仅适用于首个 URL，存在被重定向引导至内部网络的可能。同时，当重定向目标为其他主机时将不再发送认证信息（此前置于请求头中的 API 密钥会被原样转发至重定向目标）。
• 中断中的命令，其保存数据将剔除机密信息。 等待输入等场景下临时保存的数据中，可能以明文残留环境变量的值或 API 响应内容。
• 封堵了 @everyone 提及的路径，以及认证信息可能输出至日志的情况。
• 修复了同一 Bot 可能在两处同时运行的问题。内部的互斥控制中，存在误将其他运行实例所持有的状态解除的情况。

缺陷修复

自定义命令 / 命令构建器

• 修复了 在存在同名命令组的情况下保存命令，会导致该命令组被替换、其下属命令随之丢失 的缺陷。原因是重复性校验未将命令组纳入检查范围。
• 命令的移动、命令组重命名与命令重命名 现已合并为单次原子操作。此前采用「变更后再删除」的方式，中途失败可能造成命令重复或丢失。
• 从 URL 打开不存在的命令时不再显示空白页面。获取失败的情况现已与「命令不存在」相区分，并提供重试入口。

项目

• 仍包含 Bot 的项目将无法删除。删除按钮会被禁用，并显示相关的 Bot 及处理方式。

Bot

• 修复了 提醒有时不会被送达 的缺陷。数据库连接在特定时机断开时，待送达的提醒可能被遗漏，重复提醒的链条也会就此中断。
• /metrics 现已输出按 Bot 划分的指标，修复了内部计量未能正确归属到对应 Bot 的问题。API 响应时间也改为记录实测值。

UI

• 修复了启动、停止等确认弹窗 在屏幕上偏上显示 的缺陷，并补充了防止复发的测试。
• 模块卡片此前比其上方的「启用功能」开关窄 8px，现已对齐。
• 修复了模块标题中图标与标题未垂直居中的问题。
• 危险操作区（删除等操作）的样式已调整为与站点整体风格一致。
• 将消息截图从「娱乐」分类移至「消息」分类。

兼容性说明

您现有的 Bot 与命令定义在 v2.5.2 中均可照常运行，无需进行任何迁移操作。

新增的 置顶消息 与 消息截图 模块，在既有 Bot 中将以 关闭 状态添加。如需使用，请从控制面板的对应页面启用。

关于 DM 中的命令执行：如 安全相关修复 所述，已设置允许身份组或所需权限的命令将无法从 DM 执行。若您此前依赖 DM 执行，请注意这一变化。未设置任何限制的命令不受影响。

支持与社区

如有疑问、缺陷反馈或功能建议，欢迎通过以下任一渠道联系我们：

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

感谢您一直以来对 BotShade 的支持。