面向群管理员/运营，说明需要给 Bot 的权限、日常操作方法、最佳实践。
请确保在目标群把 Bot 设为管理员，并勾选：
- 发送消息
- 删除消息（清理验证消息等，推荐开启）
- 邀请用户/创建邀请链接（若希望机器人自动生成入群按钮）
- 管理话题（如使用话题路由广播）
- 限制成员/解除限制（用于入群验证禁言/解禁）
- 查看管理员列表（用于商城核销时验证身份）
/setup（私聊）：配置群欢迎/验证、积分规则、订阅路由、段位表等。/add_product（私聊）：上架商品。/products（私聊）：管理/下架商品。/use <核销码>（私聊）：核销订单（需在该群拥有管理员权限）。/request_broadcast（群内）：申请成为广播群。/set_topic <news|analysis|marketing|signal>（在目标话题发送）：将当前话题绑定为某类型的广播路由。（仅终极管理员）/report、/revoke <chat_id>（终极管理员）：审计群列表、移除广播权限。/id：查看当前聊天 ID（便于配置）。
- 在
/setup中可开启/关闭验证码、欢迎语，并自定义欢迎文本（支持{name}占位）。 - 确保 Bot 有“限制/解除限制”权限，否则无法禁言/解禁新人。
/setup可设置：- 签到口令与奖励分值。
- 晒单关键词与奖励分值（盈/损），每日上限（-2 表示不限）。
- 段位表 JSON，用于
/my的称号展示。
- 邀请链接：成员在私聊
/invite选择群生成。若 Bot 无法生成入群按钮，说明缺少“邀请用户/创建链接”权限，或可在群公告提供固定入群链接。
- 群管理员在群内
/request_broadcast→ 终极管理员批准后，该群加入广播列表。 - 终极管理员在自己的管理群/话题发消息，Bot 弹出类型选择（早报/分析/战绩/信号/General）→ 按群订阅状态、话题绑定进行分发。
- 话题路由：在目标话题里发
/set_topic <类型>绑定，同类型广播会发到该话题。 - 如群被踢或不存在，Bot 会自动关闭该群的广播标记。
- 上架：私聊
/add_product→ 选群 → 传图（可跳过）→ 输入“价格 商品名”。 - 管理：
/products列出商品并下架。 - 购买：用户在群里
/shop购买，扣积分后生成核销码。 - 核销：管理员在私聊
/use <核销码>，Bot 会校验你是否是该订单所属群的管理员。
- 权限先给全套（见第 1 节），问题减少；如需最小化，至少保留：发送消息、限制成员/解除限制、管理话题（若用话题路由）、查看管理员（核销）、邀请成员（想自动生成入群按钮时）。
- 设定清晰的签到口令、晒单关键词，并在群公告或欢迎语中说明奖励规则和上限。
- 定期用
/report审核广播群状态，停用僵尸群。 - 商城核销建议使用私聊，避免群内刷屏；核销时注意身份验证提醒用户只向管理员提供核销码。
- 更新部署后，若遇到指令失效或菜单未更新，可重启 Bot 或在 BotFather 重新设置命令。
/invite生成的邀请里没有入群按钮：检查 Bot 是否有“邀请成员/创建链接”权限，或提供固定邀请链接字段由 Bot 发送。- 新人验证后不能发图/视频：确保 Bot 能解禁；当前版本已全量开启媒体权限。
/report无响应：确认.env的 ADMIN_GROUP_ID 填写并可被解析，且你使用的是对应的终极管理员账号/聊天。- 购买后用户未收到私聊：用户可能未开启私聊；群消息会提示核销码，提醒用户复制并私发管理员。