v2.3 发布说明

BotShade 已更新至 v2.3。本次发布是一次围绕 机器人 AI 应答功能（自动回复、工单回复、常驻应答）、包括 Claude 在内的新模型，以及 仪表盘全面重新设计 的 大型更新，同时新增 等级系统的卡片图片、身份组保留（Sticky Roles）、自定义命令的函数（子程序） 等众多功能。

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

本文目录：

• 亮点
• 为机器人新增 AI 应答功能
• 模型刷新与引入 Claude
• 仪表盘全面重新设计
• 等级系统增强
• 身份组保留（Sticky Roles）
• Components V2 构建器改进
• 自定义命令增强
• 其他新功能与改进
• 已修复的缺陷
• 兼容性说明
• 支持与社区

亮点

• 为机器人新增 AI 应答功能。 AI 现在可对关键词自动回复、支持工单、服务器常驻应答 自动回复。
• 刷新了 AI 模型，除标准模型外，现在还可选用 Claude（Haiku 4.5 / Sonnet 4.6 / Opus 4.8） 等高级模型与推理模型。
• 选择模型时可一目了然地看到其 积分消耗程度（少 / 中 / 多 / 特大），并可在仪表盘查看 本月用量。
• 将仪表盘 全面重新设计为暖色洋红风格，并可在 Plum / Editorial 两种设计主题间切换。
• 将机器人详情页重构为 双轴导航（顶部：机器人整体 × 左侧：功能设置），并在最上方醒目显示运行状态。
• 将机器人列表改版为 控制台式 布局（KPI 指标条 + 可排序表格）。
• 为等级系统的 等级卡片 与 排行榜 新增 图片输出，并可设置 升级通知 的发送位置与形式。
• 新增 身份组保留（Sticky Roles），成员重新加入时自动恢复其退出前的身份组。
• 现在可在 Components V2 构建器中 直接编辑按钮，预览也支持 Discord Markdown 渲染。
• 为构建辅助助手 BotShader AI 新增了可选择所用 AI 模型与思考深度（effort）的选择器，以及 用量页面。
• 为自定义命令新增可复用的 函数（子程序），具备作用域、参数与返回值，可将复杂命令拆分为部件来搭建。
• 持久变量（BSVAR_）现已支持 对象 / 数组的嵌套。
• 修复了白名单 / 黑名单不生效的缺陷，以及发言图片化（Make it a Quote）中 Emoji 无法显示 等多项缺陷。

为机器人新增 AI 应答功能

为您自己的机器人新增了 AI 应答功能。在仪表盘的 AI 模块 中启用后，机器人将以 AI 对服务器中的成员进行应答（这是机器人侧的功能，与在仪表盘中协助您构建机器人的「BotShader AI」是两回事）。可在四个场景中使用。

通过命令对话（/ai chat）

使用 /ai chat，成员可在频道中直接与 AI 对话。对话上下文会 按频道保留一段时间，连续提问也能延续话题。同时具备防止刷屏的冷却时间。

自动回复的 AI 化

现在可将 AI 回复与既有的 关键词自动回复 结合使用。将应答规则的形式设为「AI」后，AI 会针对匹配触发条件的消息按上下文进行回复。为避免无谓的积分消耗，系统会自动应用最小冷却时间。

工单自动回复

在支持工单频道中，AI 现在可 对工单创建者的发言自动进行首次响应。当工作人员回复后，AI 会自动停止应答，从而顺畅地移交人工处理。可在工单设置中开启或关闭。

服务器内常驻应答（/ai respond）

通过 /ai respond 面板（Components V2），可对服务器内的常驻应答进行精细设置。

• 应答对象：仅在被提及时（推荐） / 仅指定用户、身份组、权限的发言 / 所有消息
• 目标频道：全部频道，或对特定频道进行允许 / 排除
• 冷却时间：以秒为单位设置，防止过度应答

模型刷新与引入 Claude

我们全面梳理了 AI 可用的模型，让您可按用途与预算进行选择。

可选模型更多了

• 标准模型：包括高速、低成本的默认模型在内的多款标准模型。这些低成本标准模型运行于 美国的 AI 推理提供商（DeepInfra） 之上，数据在美国的基础设施上处理。
• 高级模型（Premium）：在更高精度的高级模型之外，现在还可选用 Claude Haiku 4.5 / Sonnet 4.6 / Opus 4.8。
• 推理模型（Premium）：新增了会深入思考后再作答的推理模型（适用于命令对话）。

可为各功能（对话、工单、自动回复、常驻应答）分别指定所用模型。推理模型会显示「推理」徽章，高级模型会显示「需 Premium」徽章。

显示积分消耗程度

选择模型时，我们会以 少 / 中 / 多 / 特大 四个等级显示每次回复的成本大致估算，让您在质量与成本之间权衡选择。

本月用量

我们在仪表盘新增了 本月 AI 用量。可通过进度条查看已消耗积分、月度上限（按套餐）与剩余额度，并可了解 按模型的明细（调用次数与成本）。也可通过 /ai usage 命令在服务器中查看用量。

仪表盘全面重新设计

我们对仪表盘进行了全面焕新。配色统一为 暖色灰褐底 × 洋红点缀，并在标题、正文、等宽（命令与数值）之间区分使用字体，提升信息的可读性。

两种设计主题

现在可在偏好设置的 设计主题 中选择您喜欢的外观。

• Plum：圆角卡片浮于背景之上的柔和默认设计。
• Editorial：让人联想到纸张与油墨的罫线排版式紧凑设计。

所选内容会被保存，并在之后持续应用。

机器人详情改为双轴导航

我们将机器人详情页重构为 顶部标签栏（机器人整体设置：首页 / 自定义命令 / 事件 / 全部命令管理 / 环境变量 / 数据存储 / 服务器列表 / 日志） 与 左侧边栏（功能模块设置） 的双轴结构。移除了常驻日志栏，日志已整合至标签页中。

顶部的 运行状态主面板 会醒目显示机器人的状态，并汇集启动、停止、重启等操作，服务器数、用户数、延迟等 KPI，以及最近活动。

控制台式的机器人列表

我们将机器人列表改版为控制台式布局，包含顶部的 KPI 指标条（运行中机器人数、命令总数、错误率、API 延迟 P95）与 可排序表格。收藏的机器人会置顶固定，即使运营众多机器人也能轻松掌握。

等级系统增强

我们大幅增强了等级系统（/level）。

等级卡片与排行榜的图片输出

现在可将 /level rank 与 /level leaderboard 在传统的嵌入显示之外，以 图片（卡片） 形式输出。可在机器人设置中选择样式。

• 等级卡片：rich / minimal / neon 共 3 种样式
• 排行榜：rich / minimal / neon / podium（领奖台风格）共 4 种样式

在仪表盘中，可通过套用当前登录用户头像与名称的 动态预览 来选择样式。

升级通知设置

现在可通过 /level setting 或仪表盘设置升级通知。

• 发送位置：触发所在频道 / 指定频道 / 私信
• 形式：消息 / 嵌入 / 图片

身份组保留（Sticky Roles）

我们新增了 身份组保留（Sticky Roles），在成员退出服务器后 重新加入时自动恢复其退出前的身份组，无需再为回归的常客重新分配身份组。

通过 /role-retention setting 设置面板（Components V2），可启用或停用该功能，并指定要排除在恢复之外的 排除身份组。高于机器人的身份组、外部集成管理的身份组以及 @everyone 会自动排除。已保存的数据可通过 /role-retention clear 删除（操作需要管理身份组权限）。

Components V2 构建器改进

我们对 v2.2 新增的 Components V2 构建器 进行了改进，使其更易于使用。

• 直接编辑按钮：现在可在构建器中直接编辑按钮的标签、样式（PRIMARY / SECONDARY / SUCCESS / DANGER / LINK）与 Emoji。各样式会以 Discord 官方配色反映在预览中，链接按钮会附带 🔗 标记。
• 预览支持 Discord Markdown：预览现在可忠实再现 Discord Markdown——标题、列表、加粗、代码与子文本（-#）。代码块会应用语法高亮。

自定义命令增强

我们在自定义命令构建器中新增了可复用的 函数（子程序），以及持久变量的 嵌套支持。

函数（子程序）

现在可以在命令中将 可复用的一段逻辑 定义为「函数」，并多次调用。函数由三种节点构成：functionDef（定义）、functionCall（调用）、returnFunction（返回值）。仪表盘侧边栏新增了 「函数」区块（{ } 图标），编辑函数时画布顶部会显示当前作用域的面包屑。

变量的可见性按 四个作用域 进行组织：

• 全局（BSVAR_、服务器变量）：在函数内可读可写。
• 命令作用域（option_ 等）：在函数内不可见。
• 函数参数（{param_*}）：只读，按 值传递（对象与数组为深拷贝）。
• 函数局部：函数返回后即销毁。

返回值通过 returnFunction 汇聚为单个对象返回。出于安全考虑，函数嵌套上限为 32，总调用次数上限为 1000。

持久变量的嵌套支持

持久变量（BSVAR_）现可处理 嵌套结构。array<object>（对象的数组）、array<array>（数组的数组）以及对象中的对象等，均可从声明到保存、读取一致地处理（嵌套最多 5 层）。与此前的扁平变量保持向后兼容。

其他新功能与改进

焕新的通知（Toast）与菜单

我们将 Toast、菜单、工具提示等弹出层统一为浅色图标芯片与克制的阴影，使其更易于查看。

模块停用时的显示

在模块停用期间，其设置画面现在会被遮罩覆盖，并明确标示 正处于停用状态。

小游戏与计算器模块的调整

现在可通过步进器与滑块直观设置小游戏的下注额与赔率（倍率、返还率、概率）。计算器（/calc）模块的启动 Emoji 选择 UI 也已焕新。

BotShader AI（构建辅助助手）增强

我们增强了在仪表盘中协助您构建机器人的 BotShader AI。新增了可选择其所用 AI 模型 以及（在支持的模型上）思考深度（effort） 的选择器，并提供了可从左侧边栏打开的 用量页面（以百分比显示消耗量）。同时提升了流式传输的稳定性，使回答不再中途卡住，并改进了操作体验，例如 Cmd / Ctrl + Enter 发送 以及保留侧边栏的展开 / 收起状态。

设置面板（Components V2）的操作统一

我们重新梳理了 Discord 上的各类设置面板（工单、欢迎、进出日志、等级系统、AI 常驻应答、验证、保护等）的显示，统一为将 「当前值 + 编辑按钮」置于同一行 的形式。编辑在同一条消息内完成，各子设置均配有「◀️ 返回」。操作的配色（不可撤销＝红 / 可恢复的警告＝琥珀 / 中立＝灰）也已统一，更加清晰易懂。

已修复的缺陷

修复发言图片（Make it a Quote）中的 Emoji

修复了发言图片化功能（Make it a Quote）中 Emoji 无法显示、出现缺失 的缺陷。Emoji 现在在生产环境中也能正确渲染。

修复白名单 / 黑名单不生效的缺陷

我们修复了一个缺陷：在自动回复（AutoResponder）、AI 常驻应答、保护（反垃圾）中，设置白名单 / 黑名单后，即使对象匹配也会静默地不再触发。我们重新梳理了内部对 ID 的处理，现在可按设置正常工作。

稳定执行平台

我们重新审视了执行平台所用的数据库连接，解决了 间歇性断开与重连 的问题，日志处理的稳定性得到提升。

兼容性说明

您之前所使用的机器人和流程定义，在 v2.3 上将照常运行。重新设计与模块结构调整所涉及的设置会自动继承，无需在您一侧进行任何迁移操作。

另外，旧的 ChatGPT 模块 与 自动身份组分配（autoRole），已分别整合 / 替换为全新的 AI 模块 与 身份组保留模块。

支持与社区

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

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

感谢您一如既往地支持 BotShade。