v2.4.0 发布说明

今天是 7 月 7 日,七夕。夜空中的心愿都传达到了吗?

BotShade 已更新至 v2.4.0。在本次发布中,我们为您的每个 Bot 提供了可以安全托付 “秘密心愿” 的机制 — Bot 环境变量。同时,我们还带来了让自定义命令 能够呼叫外部 Web 服务的新节点、登录画面的刷新、以及 /nuke 的缺陷修复,进一步拓宽 Bot 运营的可能性。

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

本文目录:

• 亮点
• Bot 环境变量
• 可从自定义命令调用外部 Web API 的 apiReq 节点
• 整合登录·注册画面
• 刷新 Bot 启动·停止·重启周边
• 即将推出 — Bot 状态 / Activity 设置
• 结束 Beta 期间的暂定方案付予
• 修复的缺陷
• 关于兼容性
• 支持·社区

亮点

• Bot 环境变量 — 可为每个 Bot 安全保管 API 密钥、令牌等机密信息,并通过 {env.NAME} 的写法从自定义命令中引用。
• apiReq 节点 — 新增从自定义命令 调用外部 Web API 的节点。可制作与天气、翻译、游戏战绩等外部服务联动的 Bot。
• 整合登录·注册画面 — 将原本各自独立的 /login 与 /register 整合到 /auth,无需在两个画面间往返即可完成。加载中的显示也会根据实际进度更新。
• 刷新 Bot 启动·停止·重启周边 — 状态显示与重启流程已切换至更稳定的新机制。包括对状态一直停留在”获取中”不动的问题的紧急修复。
• 即将推出 — Bot 状态 / Activity 设置 — 可从控制面板设置 Bot 在 Discord 上的”在线状态”(“正在游玩”等)。本功能将作为 即将推出的付费方案所含的功能,后续陆续提供。
• 结束 Beta 期间的暂定方案付予 — Beta 期间作为暂定措施,曾向所有用户提供付费方案相当的功能。伴随本次发布,我们结束该暂定措施,将所有用户设置为”BotShade Free”方案。
• 修复了使用 /nuke 时,频道在服务器中的位置(顺序)可能丢失 的问题。

Bot 环境变量

新增了 可为每个 Bot 安全保管 API 密钥、密码、URL 等机密信息,并可从自定义命令定义中引用 的功能。就像悄悄在控制面板上系上短册那样,可以在 Bot 详情页 → 环境变量 中进行新增·编辑·删除(会妥善收纳在不会被随意看到的位置)。

• 保管的值本身 不会在控制面板上再次以明文显示。编辑仅接受”覆盖为新的值”,作为 secrets(机密值) 处理。
• 在自定义命令的定义与发送消息中,可通过 {env.NAME} 的写法引用环境变量(NAME 为登记的变量名)。
• 预留名 {env.BOT_TOKEN} 用于引用该 Bot 自身的令牌。当您希望从自定义命令中,以该 Bot 本身的身份进行追加的 Discord API 操作时可使用。
• 对环境变量的引用,也可在下一节介绍的 apiReq 节点 的 URL·标头·请求体中使用。无需将 API 密钥直接写入命令定义,即可与外部服务联动。

使用场景示例

• 将天气预报 API 的密钥保存为环境变量,由命令返回 今日天气
• 保管翻译 API 的密钥,构建 /translate 相当的自定义命令
• 保管 Bot 独有的 Web 控制面板或监控服务的认证令牌,通过 apiReq 节点发送通知

可从自定义命令调用外部 Web API 的 apiReq 节点

自定义命令的构建器中,新增了 调用外部 Web API 的 apiReq 节点。原本仅在 Bot 内部完结的命令,如今也可 跨过银河 向外部的服务发送请求。可组装 GET / POST 等请求,将返回的 JSON 送入命令的后续处理。

• 可与其他节点相同的流程指定 URL / 方法 / 标头 / 请求体。各输入栏中,可插入 Bot 环境变量({env.NAME})以及命令的输入·变量。
• 响应的 JSON 可 在后续节点中按字段直接取出。取出的值可嵌入消息或 Embed 中,因此可以构建例如”调用天气 API → 将气温嵌入 Embed → 加上雨伞图标”等复合命令。
• 对外通信出于稳定性的考虑,通过 BotShade 侧的网络路径 进行(用户侧无需特别设置)。若响应长时间未返回,会自动中止并安全地结束处理。

这是一次将自定义命令与外部服务组合时表现力大幅拓宽的更新。

整合登录·注册画面

此前,控制面板采用 /login(登录) 与 /register(新注册) 两个画面互相往返的构成。本次将两者整合为 /auth 的单一画面。牛郎织女的相会一年仅一次,而登录与新注册,从今天起在同一个地方随时相见。

• 可 不切换画面地切换登录与新注册。通行密钥(Passkey)与社交登录均可从同一画面选择。
• 登录过程中显示的 进度(Progress) 现已 根据实际进行状态更新,消除了”认证中…”显示长时间静止的不适感。

原有的链接(/login / /register)仍可访问,会自动引导至 /auth。

刷新 Bot 启动·停止·重启周边

从控制面板 启动·停止·重启 Bot 周边的显示与动作,已切换至更加稳定的新基础。

• 紧急修复了在生产环境中,Bot 的状态显示可能 停留在”获取中”不再更新 的问题。
• Bot 的状态显示,现在能更快、更准确地反映 当前的状态。
• 在启动·停止·重启请求处理耗时较长时的 显示 已改善,进行状况更易于判断。
• 重启发生错误时,现将按 原因分别提供说明 予以引导。

即将推出 — Bot 状态 / Activity 设置

Bot 在 Discord 上的呈现 — 在线状态(在线 / 离开 / 请勿打扰 / 离线)以及显示在名称下方的 活动(“正在游玩”、“正在观看”、“正在直播”、“正在收听”、“自定义状态”),可从控制面板设置的新功能已加入。

• 支持 5 种活动显示类型,可自由设置各自的文本。
• 活动的文本中可插入 服务器名等变量({Guild.name} 等)。可按服务器显示动态信息。
• 设置的变更 无需 Bot 重启 即可生效。

本功能将作为 即将推出的付费方案所含的功能,后续陆续提供。付费方案的提供开始时期,将另行告知。

结束 Beta 期间的暂定方案付予

此前作为 Beta 期间的暂定措施,曾向所有用户免费提供付费方案相当的功能。伴随本次发布(v2.4.0),我们 结束该暂定的方案付予,将所有用户设置为”BotShade Free”方案。

• 您所创建的 Bot 设置、命令、回复模板等数据,仍将保持不变。
• 若您此前使用了付费方案相当的功能,自本次发布起,将以 Free 方案可用的范围继续使用。
• 付费方案的提供开始时期,将另行告知。

对于在 Beta 期间给予 BotShade 支持并提供宝贵反馈的所有用户,我们由衷致以感谢。

修复的缺陷

修复 /nuke 使用时频道位置丢失的问题

修复了执行 /nuke(删除频道并原地重建)时,频道在服务器内的位置(顺序)未能保持,可能被移至列表末尾的问题。今后,重建后的频道将回到 原本相同的位置。

控制面板侧的细节调整

• 修复了新增·删除 Bot 环境变量后,命令定义侧的 变量选择器(候选列表) 未能立即更新的情况。新增后可立即在命令编辑中引用。
• 调整了部分按钮的 等待中转轮 与背景颜色过于接近、难以辨识的配色。

关于兼容性

此前使用的 Bot 及自定义命令定义,在 v2.4.0 中均可继续正常运作。用户侧无需进行迁移或设置变更。

{env.NAME} 的写法、{env.BOT_TOKEN} 的预留名、apiReq 节点均为 v2.4.0 中新增可用 的功能,不影响既有的定义。

支持·社区

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

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

短册上的心愿成真了吗?越过夜空的七夕虽一年一度,但 BotShade 今日与明日,都将在您的服务器中持续运作。今后也请多多关照 BotShade。