Skip to content

PMCaptcha 指令列表

Jump to bottom
Sam edited this page Aug 3, 2022 · 10 revisions

版本: v2.25

pmcaptcha · 查询当前用户的验证状态

用法：,pmcaptcha

查询当前用户的验证状态

version · 查看 PMCaptcha 当前版本

用法：,pmcaptcha version

查看 PMCaptcha 当前版本

别名/快捷命令: v, ver

help [command] · 显示指令帮助信息，使用 ,{cmd_name} search [搜索内容] 进行文档、指令(和别名)搜索

用法：,pmcaptcha help [command]

显示指令帮助信息，使用 ,pmcaptcha search [搜索内容] 进行文档、指令(和别名)搜索

参数:

(可选 ) command - 命令名称

别名/快捷命令: h

check [id] · 查询指定用户验证状态，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

用法：,pmcaptcha check [id]

查询指定用户验证状态，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

参数:

(可选 ) id - 用户 ID

add [id] · 将 ID 加入已验证，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

用法：,pmcaptcha add [id]

将 ID 加入已验证，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

参数:

(可选 ) id - 用户 ID

delete [id] · 移除 ID 验证记录，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

用法：,pmcaptcha delete [id]

移除 ID 验证记录，对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

参数:

(可选 ) id - 用户 ID

别名/快捷命令: del

unstuck [id] · 解除一个用户的验证状态，通常用于解除卡死的验证状态

用法：,pmcaptcha unstuck [id]

解除一个用户的验证状态，通常用于解除卡死的验证状态

使用：对该信息回复或者输入用户 ID，如未指定为当前私聊用户 ID

参数:

(可选 ) id - 用户 ID

welcome [message] · 查看或设置验证通过时发送的消息

用法：,pmcaptcha welcome [message]

查看或设置验证通过时发送的消息

使用 ,pmcaptcha welcome -c 可恢复默认规则

参数:

(可选 ) message - 消息内容

别名/快捷命令: wel

whitelist [array] · 查看或设置关键词白名单列表（英文逗号分隔）

用法：,pmcaptcha whitelist [array]

查看或设置关键词白名单列表（英文逗号分隔）

使用 ,pmcaptcha whitelist -c 可清空列表

参数:

(可选 ) array - 白名单列表 (英文逗号分隔)

别名/快捷命令: wl, whl

blacklist [array] · 查看或设置关键词黑名单列表 (英文逗号分隔)

用法：,pmcaptcha blacklist [array]

查看或设置关键词黑名单列表 (英文逗号分隔)

使用 ,pmcaptcha blacklist -c 可清空列表

参数:

(可选 ) array - 黑名单列表 (英文逗号分隔)

别名/快捷命令: bl

timeout [seconds] · 查看或设置超时时间，默认为 30 秒、图像模式为 5 分钟

用法：,pmcaptcha timeout [seconds]

查看或设置超时时间，默认为 30 秒、图像模式为 5 分钟

使用 ,pmcaptcha wait off 可关闭验证时间限制

有关验证超时的默认选项：

  • math | 30 秒

  • img | 5 分钟

  • sticker | 30 秒

在图像模式中，此超时时间会于用户最后活跃而重置，

建议数值设置大一点让机器人有一个时间可以处理后端操作

参数:

(可选 ) seconds - 超时时间，单位秒

别名/快捷命令: wait

disable_pm [toggle] · 启用 / 禁止陌生人私聊，默认为 关闭 （允许私聊）

用法：,pmcaptcha disable_pm [toggle]

启用 / 禁止陌生人私聊，默认为 关闭 （允许私聊）

此功能会放行联系人和白名单(已通过验证)用户

您可以使用 ,pmcaptcha add 将用户加入白名单

参数:

(可选 ) toggle - 开关 (y / n)

别名/快捷命令: disablepm, disable

stats [arg] · 查看验证统计

用法：,pmcaptcha stats [arg]

查看验证统计

使用 ,pmcaptcha stats -c 重置数据

参数:

(可选 ) arg - 参数 (reset)

action [action] · 选择验证失败的处理方式，默认为 封禁

用法：,pmcaptcha action [action]

选择验证失败的处理方式，默认为 封禁

处理方式如下：

  • ban | 封禁

  • delete | 封禁并删除对话

  • none | 不执行任何操作

参数:

(可选 ) action - 处理方式

别名/快捷命令: act

report [toggle] · 选择验证失败后是否举报该用户，默认为 开启

用法：,pmcaptcha report [toggle]

选择验证失败后是否举报该用户，默认为 开启

参数:

(可选 ) toggle - 开关 (y / n)

premium [action] · 选择对 Premium 用户的操作，默认为 不执行任何操作

用法：,pmcaptcha premium [action]

选择对 Premium 用户的操作，默认为 不执行任何操作

处理方式如下：

  • allow | 白名单

  • ban | 封禁

  • only | 只允许

  • none | 不执行任何操作

参数:

(可选 ) action - 处理方式

别名/快捷命令: vip, prem

groups_in_common [count] · 设置是否对拥有一定数量的共同群的用户添加白名单

用法：,pmcaptcha groups_in_common [count]

设置是否对拥有一定数量的共同群的用户添加白名单

使用 ,pmcaptcha groups -1 重置设置

参数:

(可选 ) count - 共同群数量

别名/快捷命令: group, groups, common

chat_history [count] · 设置对拥有一定数量的聊天记录的用户添加白名单（触发验证的信息不计算在内）

用法：,pmcaptcha chat_history [count]

设置对拥有一定数量的聊天记录的用户添加白名单（触发验证的信息不计算在内）

使用 ,pmcaptcha his -1 重置设置

请注意，由于 Telegram 内部限制，数值过大会导致程序缓慢，请不要设置过大的数值

参数:

(可选 ) count - 聊天记录数量

别名/快捷命令: his, history

initiative [toggle] · 设置对主动进行对话的用户添加白名单，默认为 开启

用法：,pmcaptcha initiative [toggle]

设置对主动进行对话的用户添加白名单，默认为 开启

参数:

(可选 ) toggle - 开关 (y / n)

silent [toggle] · 减少信息发送，默认为 关闭

用法：,pmcaptcha silent [toggle]

减少信息发送，默认为 关闭

开启后，封禁、验证成功提示（包括欢迎信息）信息将不会发送

（并不会影响到 log 发送）

参数:

(可选 ) toggle - 开关 (y / n)

别名/快捷命令: quiet

flood [limit] · 设置一分钟内超过 n 人开启轰炸检测机制，默认为 5 人

用法：,pmcaptcha flood [limit]

设置一分钟内超过 n 人开启轰炸检测机制，默认为 5 人

此机制会在用户被轰炸时启用，持续 5 分钟，假如有用户继续进行私聊计时将会重置

当轰炸开始时，PMCaptcha 将会启动以下一系列机制

  • 强制开启自动归档（无论是否 Telegram Premium 用户都会尝试开启）

  • 不向用户发送 CAPTCHA 挑战

  • 继上面的机制，记录未发送 CAPTCHA 的用户 ID

  • （用户可选）创建临时频道，并把用户名转移到创建的频道上 【默认关闭】

轰炸结束后，如果用户名已转移到频道上，将恢复用户名，并删除频道

并对记录收集机器人发送轰炸的用户数量、轰炸开始时间、轰炸结束时间、轰炸时长

（由于不存在隐私问题，此操作为强制性）

请参阅 ,pmcaptcha h flood_username 了解更多有关创建临时频道的机制

请参阅 ,pmcaptcha h flood_act 查看轰炸结束后的处理方式

参数:

(可选 ) limit - 人数限制

别名/快捷命令: boom

flood_username [toggle] · 设置是否在轰炸时启用“转移用户名到临时频道”机制（如有用户名）

用法：,pmcaptcha flood_username [toggle]

设置是否在轰炸时启用“转移用户名到临时频道”机制（如有用户名）

将此机制分开出来的原因是此功能有可能会被抢注用户名(虽然经测试并不会出现此问题)

但为了以防万一依然分开出来作为一个选项了

启用后，在轰炸机制开启时，会进行以下操作

  • 创建临时频道

  • （如创建成功）清空用户名，设置用户名为临时频道，并在频道简介设置正在受到轰炸提示

  • （如设置失败）恢复用户名，删除频道

注意：请预留足够的公开群用户名设置额度，否则将不会设置成功，但同时用户名也不会被清空

（操作失败虽然会有 log 提醒，但请不要过度依赖 log）

参数:

(可选 ) toggle - 开关 (y / n)

别名/快捷命令: boom_username

flood_act [action] · 设置轰炸结束后进行的处理方式，默认为 删除并举报所有轰炸的用户

用法：,pmcaptcha flood_act [action]

设置轰炸结束后进行的处理方式，默认为 删除并举报所有轰炸的用户

可用的处理方式如下：

  • asis | 与验证失败的处理方式一致，但不会进行验证失败通知以及发送log记录

  • delete | 删除并举报所有轰炸的用户（速度最快）

  • captcha | 对每个用户进行 CAPTCHA 挑战

  • none | 不进行任何操作

参数:

(可选 ) action - 处理方式

别名/快捷命令: boom_act

custom_rule <rule> · 用户自定义过滤规则，规则返回True为白名单，否则继续执行下面的规则

用法：,pmcaptcha custom_rule <rule>

用户自定义过滤规则，规则返回True为白名单，否则继续执行下面的规则

使用 ,pmcaptcha custom_rule -c 可删除规则

注意事项：

  • 返回True并不代表添加到白名单，只是停止继续执行规则

  • 规则发送错误默认返回False（继续执行规则），并透过log输出错误信息

  • 由于此指令能够直接操作账号，因此请在输入他人给与的规则前先亲自确认是否安全

可用参数：

  • msg | 触发验证的信息

  • text | 触发验证的信息的文本，永远不为None

  • user | 用户

  • me | 机器人用户（自己）

  • global 数值 (例如: curr_captcha, the_order 等)

  • 注意，可以调用 await 函数

范例：

text == "BYPASS"

解释：

当对方发送的文字为“BYPASS”时，不继续执行规则

参数:

rule - 规则

collect_logs [toggle] · 查看或设置是否允许 PMCaptcha 收集验证错误相关信息以帮助改进

用法：,pmcaptcha collect_logs [toggle]

查看或设置是否允许 PMCaptcha 收集验证错误相关信息以帮助改进

默认为 开启，收集的信息包括被验证者的信息以及未通过验证的信息记录

参数:

(可选 ) toggle - 开关 (y / n)

别名/快捷命令: collect, log

change_type [type] · 切换验证码类型，默认为 计算验证

用法：,pmcaptcha change_type [type]

切换验证码类型，默认为 计算验证

验证码类型如下：

  • math | 计算验证

  • img | 图像辨识验证

  • sticker | 贴纸验证

注意：如果图像验证不能使用将回退到计算验证

参数:

(可选 ) type - 验证码类型

别名/快捷命令: type, typ

show_settings · 显示目前所有的设置

用法：,pmcaptcha show_settings

显示目前所有的设置

别名/快捷命令: settings, setting

export_settings · 导出目前 PMCaptcha 的设置

用法：,pmcaptcha export_settings

导出目前 PMCaptcha 的设置

请注意，此导出并不包括：

  • 封禁人数缓存

  • 白名单

  • 等待验证缓存

别名/快捷命令: export, export_setting

import_settings · 导入 PMCaptcha 的设置，对着设置文件回复即可

用法：,pmcaptcha import_settings

导入 PMCaptcha 的设置，对着设置文件回复即可

请注意，如果导出和导入的版本不一样可能会因为版本兼容问题

导致有些设置可能会无法导入，届时将会提示

别名/快捷命令: import_setting, import

change_img_type [type] · 切换图像辨识使用接口，默认为 funCaptcha

用法：,pmcaptcha change_img_type [type]

切换图像辨识使用接口，默认为 funCaptcha

目前可用的接口：

  • func (ArkLabs funCaptcha )

  • github (GitHub 螺旋星系 )

  • rec (Google reCAPTCHA )

请注意， reCAPTCHA 难度相比前两个高出不少，

因此验证码系统会在尝试过多后提供 funCaptcha 接口让用户选择

参数:

(可选 ) type - 验证码类型

别名/快捷命令: img_type, img_typ

img_retry_chance [number] · 图形验证码最大可重试次数，默认为 3

用法：,pmcaptcha img_retry_chance [number]

图形验证码最大可重试次数，默认为 3

参数:

(可选 ) number - 重试次数

别名/快捷命令: img_re

Clone this wiki locally