快速上手

    以下是使 bot 能够使用的最小步骤，请看完这部分后再根据需要选择性配置其他功能

    1. 把 Bot 邀请进群

    1. 在群信息面板把 Bot 加为管理员。
    2. 给 Bot 至少授予 Delete Message Ban Users Invite Users 权限。 没有这些权限，相关命令会静默失败。
    3. 把群组改为「加入需审核」（Edit → Group Type → Approve New Members）。

    这一步非常重要‼️如果不改成「加入需审核」，入群验证流程无法启动

    图文步骤如下:

    1. 打开群信息面板
    1. 点击 Group Type
    1. 选择 Approve New Members

    2. 配置入群验证方式

    在群里发送：

    /questions

    Bot 会私信你「入群验证设置」面板。从三种验证方式中选一个：

    • 入群问卷——用户在 Web App 填问卷，由管理员或自动判分审核。
    • 无验证——所有申请直接放行，等同关闭审核。
    • 视觉验证码 (默认)——用户在 Web App 看视频并输入其中显示的验证码。 视频借助视觉暂留呈现验证码，单帧截图读不出，能挡住单帧 OCR 机器人。

      此验证码不适合有视觉障碍的用户，开启前请判断面向的用户。

    切完验证方式后，同一个 /questions 面板可继续编辑问卷题目（增删改、排序、设 正确答案、设置最大答错题数）。

    3. 追加 bot 管理员

    群 owner 在群里发：

    /grant 123456789       # 用 user_id
/grant                 # 或直接回复目标用户的消息后发 /grant

    撤销同理：/revoke <user_id> 或回复后发 /revoke。

    这里授予的是 Bot 的 admin 角色，与 Telegram 群管理员是两套权限。Telegram 原生 owner / admin 会自动被识别为 Bot admin，不需要额外 /grant。

    4. 测试入群流程

    1. 用另一个测试账号申请加入这个群。
    2. Bot 收到 ChatJoinRequest，会私信测试账号一个 Web App 按钮。
    3. 测试账号点按钮 → 在 Telegram 内打开问卷 / 验证码页面，提交后等待审核。
    4. 管理员在群里：
      • 发 /pending 查看待审列表
      • 发 /review 得到 bot 私聊审核入口，想要获得 bot 私聊请先对 bot 发起消息
      • 或直接 /approve <申请id> / /reject <申请id> [原因] 处理

    5. 可选：开启广告检测

    在群里发：

    /adml on

    新成员入群后会先被限制为「仅文本」，前 N 条消息（默认值由全局设置决定）进入 广告检测窗口；检测结果按分数仅删除 / 警告 / 封禁。详见 ML 广告检测。

    6+. 可选：开启 Bio 黑名单

    /bioblock 加我微信
/bioblock 私聊
/biorules

    入群申请的简介命中黑名单时会被自动拒绝，理由固定为「bio 包含黑名单内容」。

    接下来