我们为何重新设计 /setup：从 50 个斜杠命令到一个菜单

如果你很早之前就把 X Bot 加入过群聊，可能还记得一个完全不同的机器人。那时有 /set_x_filtering、/set_calendar、/set_top_count、/set_colors、/set_points、/set_topic，还有大约 45 个类似的命令。每个功能都对应一个独立的斜杠命令，因为当时看来，这是暴露一个不断增长的功能集最自然的方式。事实证明并非如此。

这篇文章要讲的是：我们为什么拆掉了那套结构，换成了一个单一的 /setup 菜单；改版前后的数据说明了什么；以及我们为喜欢旧方式的人保留了哪些东西。

问题所在：50 个命令不是功能列表，而是一座迷宫#

Telegram 的命令自动补全会在你输入 / 的瞬间弹出一个可滚动的列表。对于五六个命令来说，这没问题。但到了 50 多个命令时，它就不再是一个菜单，而变成了一堵没人会从头读到尾的文字墙。新管理员——比如某个加密项目 Telegram 群里刚被告知”去把追踪机器人设置一下”的那个人——会输入 /setup，看到一堵陌生命令组成的墙，然后要么猜错，要么直接放弃。

在我们建立起真正的 ❓ Help & Support 流程来接住这些问题之前，我们在支持工单里反复听到这些反馈:“我怎么添加 cashtag”、“在哪里设置时间表”、“这个机器人到底能不能生成报告”。答案其实一直都在，只是那个命令他们没找到，被埋在一份他们没时间读完的列表里。机器人本身具备大家想要的所有功能，只是没告诉你东西放在哪里。

斜杠命令的组合性也很差。如果你想同时设置过滤器、时间表和自定义外观，那就需要三次（甚至更多）独立的命令调用，每一次都得记住确切的语法——比如 /set_x_filtering @handle1 @handle2 $TOKEN，格式必须完全正确，不能有拼写错误，也没有容错重试。一个参数格式不对，你就会收到一条简短的报错，然后一切从头再来。从”我刚添加了这个机器人”到”我已经有了一份可用的报告”之间，没有任何引导路径。

解决方案：一个入口，一切皆可发现#

我们把命令入口收拢成了一个单一的 /setup 命令，它会打开一个内联键盘——也就是 Telegram 原生支持的可点击按钮菜单。你不再需要记住 50 个命令名称，而是会看到 8 个带标签的分区，直接点击你想要的那个：

• 🎯 Filters（过滤器）——账号、cashtag、关键词、提及、排除项、忽略列表、命名过滤器
• ⏰ Schedule（时间表）——每日预设、自定义时间、指定星期，或完整的 cron 表达式
• 📊 Reports（报告）——按需触发报告，查看历史报告
• 🎨 Customization（自定义）——项目名称、描述、Logo、URL、排行榜标题与颜色、权重、Top-N 数量
• 👥 Admins（管理员）——谁还能配置这个机器人
• 💳 Buy Credits（购买额度）——ETH 积分包或 PRO 订阅
• 📡 X Posts Auto-relay（X 帖子自动转发）——将选定账号的帖子近乎实时地转发到聊天中
• ❓ Help & Support（帮助与支持）——提交工单，通过 Telegram 私信获得回复

每个按钮都会引导你进入下一层菜单，而不是要求你去回忆某种语法。以前设置 cashtag，意味着要记住 /set_x_filtering 并且把参数顺序写对。现在只需要 /setup → 🎯 Filters → 💵 Cashtags → ➕ Add，机器人会主动提示你接下来需要输入什么。

变化最大的是首次使用体验。新的聊天现在会得到一个 4 步快速入门向导：项目名称，然后是过滤器，接着是时间表，最后是确认屏幕——整个过程不到一分钟，也没有任何命令语法需要记错。

真正发生变化的：激活数据#

我们追踪了新聊天在添加机器人后 24 小时内触发首份报告的比例——这是判断”这个人是否真的完成了设置，还是中途放弃了”最清晰的信号。在菜单改版之前，很大一部分新安装从未完成配置：管理员会试着输入一两个斜杠命令，因为参数格式错误收到报错，然后就没了下文。改版之后，大多数启动了快速入门向导的新聊天都完成了向导流程，并在当天就安排好了报告。这个向导最大的成效，并不是教会了大家新功能，而是消除了输错东西的可能性。

菜单上线后，“我该怎么配置 X”这类支持工单也大幅减少，取而代之的是更具体的调优问题（例如最佳推文选取器的工作原理），而不再是”这个功能的按钮在哪里”。

我们保留为直接命令的部分#

我们并没有把所有东西都删掉。有一小部分命令使用频率足够高，或者作为快捷方式足够有用，因此我们把它们保留在了菜单之外：

• /setup —— 打开菜单（入口本身）
• /report —— 立即触发报告，无需在菜单中导航
• /buy —— 直接跳转到购买额度
• /subscription —— 查看或管理 PRO 订阅
• /add_admin —— 无需深入 👥 Admins 即可添加机器人管理员
• /set_topic —— 在论坛模式群组中设置目标话题
• /status —— 快速健康检查（过滤器是否启用、时间表、套餐）
• /get_chatid —— 支持工单和 API 调试中偶尔需要用到

这些是高级用户凭肌肉记忆输入的命令，也是脚本或自动化更可能直接调用的命令。保留它们意味着我们没有破坏任何人已有的工作流，同时依然为其他所有人修复了”东西在哪”的发现问题。其余 40 多个旧命令出于向后兼容仍然在技术上可以解析，但它们不再被记录或在任何地方被推荐——菜单才是现在受支持的路径。

这次迁移的成本值得吗？#

值得，但并不是没有代价。每一个菜单界面都必须处理这样的情况：用户点了一个按钮，然后关掉 Telegram，三天后又回来，期望停留在同样的状态——内联键盘不会无限期地保留对话上下文，所以我们必须让每一步都可以重新进入，而不是假设用户会走一条线性流程。我们也不得不更认真地思考权限问题：相比一个用户需要先查阅、再手动输入的命令，菜单会诱使用户更随意地到处点击，因此我们同时收紧了 👥 Admins 和角色检查。

如果你正在构建一个配置项超过寥寥数个的 Telegram 机器人，我们的建议是：不要等到累积了 50 个命令才做这个决定。命令列表变得不再好用的那个临界点，比你在一次次添加新功能时的感觉要低得多。如果用户配置的是他们不会每天都做的事情——比如时间表语法、过滤器组合、命名过滤器——引导式菜单永远比需要记住的命令更好用。但如果是一个用户每天要运行几十次的命令，就应该把它保留成一个快速、直接的命令。

想更深入了解 /setup 中过滤功能在实际中的运作方式，可以参阅追踪代币发行的 X 活动和加密项目的 cashtag 追踪——这两篇都逐步演示了当前的 🎯 Filters 菜单。如需完整的菜单参考，setup 菜单文档涵盖了每一个界面；如果你完全是这个机器人的新手，x-bot-overview 是最好的起点。

准备好在 X 上追踪你的社区了吗？ 将 @BWS_X_Bot 添加到你的 Telegram 群组，运行 /setup，你的第一份报告就会按照配置好的时间表自动触发。FREE 套餐每月覆盖 100 条帖子——无需信用卡。

关于本文：本文由 X Bot 的内容工作流借助 AI 协助起草，并在发布前由 Blockchain Web Services（BWS）创始人兼负责人 Nacho Coll 审核。每一项产品声明都对照真实运行中的机器人核实过。了解我们如何在内容创作中使用 AI。发现错误？可通过 /setup → ❓ Help & Support 联系我们。

“这只是我们持续更新的众多产品动态之一——欢迎访问 X Bot 博客，获取发布说明、案例研究和深度解析。”