v2.5.0 版本发布说明

我们已将 BotShade 更新至 v2.5.0。本次更新以 BotShader AI 的刷新（画面读取、3 档模型选择、CmdBuilder 侧边栏整合）为中心，并带来命令分组功能、Bot 状态与活动设置的正式发布、回复开关切换、日志画面全面刷新等日常运营相关的更新。

如有任何反馈，请通过 支持 告知我们。

本文目录：

• 亮点
• BotShader AI 会读取您当前画面并提供帮助
• AI 模型 3 档 + 思考深度切换
• CmdBuilder 侧边栏重构
• 可用分组整理命令
• Bot 状态 / 活动设置 — 正式发布
• 可切换回复开关
• 日志画面全面刷新
• 已修复的问题
• 兼容性
• 支持与社区

亮点

• BotShader AI 会读取您当前画面 — 打开 AI 抽屉时，BotShader 会自动识别您正在查看的仪表盘画面（日志、命令编辑、Bot 设置等），并根据该内容给出建议或回答。您也可通过「＋」按钮的「添加此画面」入口，在任意时机将当前画面加入上下文。
• AI 模型 3 档可选 — 我们将模型整理为「基础」「进阶」「旗舰」3 档，便于根据用途和规模选择。每档均支持 思考深度 切换（快速 / 深入）。同时按提供商分组排序，正在使用的模型以 chip 形式显示。
• CmdBuilder 侧边栏重构 — 制作自定义命令时，可直接在侧边栏与 AI 沟通。使用中模型以 chip 显示，会根据契约方案自动判定可用模型，并新增了历史、新建对话、删除等操作按钮。
• 可用分组整理命令 — Discord 斜杠命令可以按 分组 / 子分组 结构组织，例如 /economy shop buy。相关命令可像文件夹一样归类。
• Bot 状态 / 活动设置 — 正式发布 — v2.4.0 预告的功能，现已作为付费方案功能正式提供。可在仪表盘设置 Bot 的在线状态和「〜正在游戏 / 观看 / 直播 / 收听 / 自定义」5 种活动显示。
• 可切换回复开关 — 自定义命令的发送消息设置中，可明示禁用命令的 隐式回复（reply），改为普通消息发送。
• 日志画面全面刷新 — 大幅改善筛选和扫读体验，同时按契约方案设置了日志的 保留上限。

BotShader AI 会读取您当前画面并提供帮助

在 BotShade 仪表盘上打开 AI 抽屉时，BotShader 会自动获取您当前查看的页面信息。查看日志时读取日志内容，查看命令编辑（CmdBuilder）时读取正在编辑的命令结构，查看 Bot 设置时读取该 Bot 的配置，并将这些作为回答的上下文。

因此，您可以直接询问 「当前日志的故障，原因在哪？」 或 「这条命令，条件分支后为什么发送消息没分开？」，无需重复说明背景即可获得答案。

此外，通过 AI 抽屉底部的 「＋」按钮 选择 「添加此画面」，可在 任意时机将当前画面加入上下文。跨画面比较、后续回到某话题时非常方便。

• 支持的画面：日志 / 命令编辑（CmdBuilder） / Bot 设置 / 模块列表 / 仪表盘首页，后续将陆续扩展。
• 隐私：页面信息仅在您于 AI 抽屉内执行发送操作时首次发送给 BotShader。仅打开抽屉不会发送任何信息。

AI 模型 3 档 + 思考深度切换

我们将原本平铺列出的多个 AI 模型，整理为 「基础」「进阶」「旗舰」3 档，便于按用途和会话规模选择。同时按提供商分组排序，未在您方案中开放的模型以灰色显示区分。

• 基础 — 适用于日常问题、简单命令草案、摘要等。响应快速，消耗较低。
• 进阶 — 适用于中等复杂度的实现咨询、条件分支或函数设计、既有命令的改进建议等。
• 旗舰 — 适用于最需要高阶思维的咨询（跨多个命令的设计、从非规范化说明反推等）。仅在您的方案开放该档时可用。

此外，每个模型均新增 「思考深度」 切换（快速 / 深入）。「深入」为花时间仔细思考的设定，适合复杂问题；「快速」适合需要快速响应的场景。

CmdBuilder 侧边栏顶部会以 chip 显示当前使用的模型，一目了然地看出正在与哪个模型对话。可用模型按契约方案自动判定，未开放的模型无法选择。

CmdBuilder 侧边栏重构

我们对制作自定义命令的 CmdBuilder 画面侧边栏进行了 面向 AI 协作优化的重构。

• 侧边栏内的 BotShader AI 聊天 — 在传递正在编辑命令结构的状态下，可直接在侧边栏中提问、接收建议、请求改写。
• 侧边栏顶部 — 显示使用中模型 chip、思考深度、契约方案的状态。在窄画面宽度下，限制徽章会切换为紧凑的图标。
• 操作按钮群 — 「新建对话」「返回历史」「删除消息」等，提供 AI 对话所需的操作按钮。
• 命令选择支持分组 — 引用其他命令时的选择下拉菜单，现已支持包含本次追加的命令分组的 层级视图。
• BotShader（设置画面）与 CmdBuilder（侧边栏）共用模型 / 思考选择器 — 无论从哪一侧访问，都能获得相同的体验。

可用分组整理命令

此前自定义命令 以平铺列表 呈现，本次更新后可 像文件夹一样分组。完全支持 Discord 斜杠命令的标准结构（分组 / 子分组）。

例如，经济类 Bot 可这样整理：

• /economy shop buy （经济 → 商店 → 购买）
• /economy shop sell （经济 → 商店 → 出售）
• /economy bank deposit （经济 → 银行 → 存款）
• /economy bank withdraw （经济 → 银行 → 取款）

命名冲突（同名命令的误检测）已改进，会看到分组 / 子分组的层级进行正确判定。CommandSelector（引用其他命令的节点）也支持分组视图。

• 命名规则：遵循 Discord 规范，分组名和子分组名可使用与命令名相同的字母数字和下划线。
• 迁移：既有的平铺命令仍可原样使用。将既有命令移入分组，可随时通过 CmdBuilder 的命令列表编辑。

Bot 状态 / 活动设置 — 正式发布

在 v2.4.0 中预告 即将推出 的「Bot 状态 / 活动设置」，本次以 付费方案功能 正式提供。

• 在线状态：在线 / 空闲 / 请勿打扰 / 离线（显示状态）
• 活动类型：「正在游戏 / 正在观看 / 正在直播 / 正在收听 / 自定义状态」5 种
• Escaper 变量 — 活动显示文本中可包含 {server_count} 或 {user_count} 等 Escaper 变量，可实时更新。
• 应用时机 — 在仪表盘保存后，Bot 会重新加载该设置并反映到 Discord 上的显示。

可用于管理 Bot 在 Discord 上的在线显示和活动文本，用于公告等展示目的。

可切换回复开关

在自定义命令的 发送消息节点 中，新增了 「启用回复 (reply)」 复选框。

此前，命令调用产生的发送消息 必定作为隐式回复 发送（自动附带对调用消息的回复链接）。本次更新后可 明示禁用 该行为。

• 勾选（默认） — 与之前一样，作为对调用消息的回复发送。
• 未勾选 — 作为普通消息发送，不附带回复链接。

在需要通知整个频道或希望避免嵌套回复结构时非常适用。

日志画面全面刷新

Bot 详情页的 日志画面 进行了大幅重构。

• 筛选 UI 改善 — 按级别、类别、时间范围的筛选变得更快、更直观。
• 显示密度改善 — 单条日志更易读，一次可扫读较多条目。
• 按方案保留上限 — 日志的保留条数和保留期限，将按您的契约方案设置。达到上限时，将从旧记录开始整理。
• 更丰富的信息 — 日志中新增性能相关信息及与相关自定义命令的关联标签，便于后续排查。

请在日常中用于问题定位或确认 Bot 是否按预期运行。

已修复的问题

• CmdBuilder — 修复重复命令名误检测的问题。
• CmdBuilder — 修复窄画面宽度下头部操作按钮未右对齐而错位的问题。
• CmdBuilder — 修复部分面板未居中而显示为左对齐的问题。
• CmdBuilder — 追加当 sendModal 连续放置 2 次时的警告显示。按 Discord 规范，模态框在 1 条命令内只能使用 1 次。
• 经济模块（Economy） — 修复财务子分组权限判定总是被拒绝的回归问题。
• 认证 — 整理了登录后重定向在某些条件下跳转至意料之外画面的问题。

兼容性

• 既有的自定义命令 可继续原样使用。分组功能可在任意时机采用。
• Bot 环境变量和 apiReq 节点的行为无变更。
• 随日志画面刷新，v2.4 之前记录的部分日志字段可能以新显示格式呈现。内容不会缺失。
• BotShader AI 的画面读取功能，在您于 AI 抽屉内执行发送操作时启用。仅打开抽屉不会发送任何信息。

支持与社区

如有任何疑问、异常行为或需求，请通过以下方式联系我们：

• 支持 — 仪表盘内的支持画面，或联系表单
• BotShade 官方 Discord — 支持频道

今后也请多多关照 BotShade。