#封禁规则

小鬼当家当前封禁规则分为自动封禁，昵称、简介、头像广告封禁，执行标准：

• 色情、赌博、博彩、毒品、网赚、引流、推广等广告
• 传播恶意程序
• 涉及他人身份信息的黑产广告
• 诱导他人联系自己
• 诱导他人查看自己的头像或简介

#封禁等级 #黑名单

1、由 WARN模块 执行，该类封禁由群组管理员手动操作， 不会 导致被封禁用户进入黑名单，如需解除请联系群组管理

2、由 CAPTCHA模块 执行，该类封禁根据群组配置、用户CAPTCHA 失败次数决定封禁时长，机器人默认配置为封禁10分钟后自动解除。如群组管理取消该默认配置，请联系群组管理手动解除。该类封禁 不会 导致用户被列入黑名单

3、由 其他模块 执行，遵循封禁执行标准，该类封禁 会 导致用户被列入黑名单，如有误封请联系 @XiaoGuiDangJia_PM_BOT

注1：小鬼当家封禁黑名单均由程序自动产生，任何机器人管理人员无法手动添加任何用户进入黑名单

注2：小鬼当家任何处理都会记录于 @XiaoGuiDangJia_LOGGING 公示

#申请使用方法

说明：

⓵ 本机器人由开源机器人代码 SCP-079 搭建
⓶ 为防滥用，本机器人需申请审核通过才能正常使用
—————————————————
申请步骤：

⓵ 发送贵群入群链接到 本群 或 私聊发送入群邀请链接给 @XiaoGuiDangJia_PM_BOT

⓶ 管理内部将审核您的申请是否满足 机器人使用条件

⓷ 管理将回复您审核结果，若审核成功，请将 @XiaoGuiDangJia_USER_BOT 拉入贵群，并赋予『ban/delete/invite/pin/add admin』5项临时权限

⓸ USER-BOT会自动拉入 @XiaoGuiDangJia_BOT 到贵群，并自动添加『ban/delete/invite/pin』权限

⓹ 保留USER-BOT和小鬼当家『ban/delete/invite/pin』权限即可正常使用

⓺ USER-BOT和小鬼当家 为机器人正常工作所需，如果删除其中一个或者取消关键权限『ban/delete』将会造成机器人因无法服务而自动退出贵群
—————————————————

⓵ 机器人模块功能和配置使用方法
⓶ 机器人封禁规则

#使用手册

⓵ 关于管理原则和隐私问题

⓶ 机器人申请条件

⓷ 机器人申请使用方法

⓸ 机器人功能和配置使用方法

⓹ 封禁规则

⓺ 日常维护命令列表

⓻ 机器人服务器运行状态

机器人正常运行需要『USER-BOT』和『小鬼当家』两个机器人和『ban/delete/invite/pin』4项权限。如果删除其中一个或取消关键权限『ban/delete』将会造成机器人 因无法服务而自动退出贵群

#CAPTCHA 功能模块介绍和设置选项说明

👉🏿 模块功能：

• 提供对新入群用户的验证审核
▸ 群管理可使用「/pass」回复某用户的入群消息，使该待验证用户跳过验证
▸ 群管理可使用「/captcha」命令回复某用户，要求该用户进行一次验证（但机器人判断用户不需重复验证时，不会有反应）
• 支持群组设置自定义问题
• 支持群组设置自定义的入群验证的引导提示
• 支持多种验证码形式
• 支持验证通过后配合「TIP」发送入群欢迎消息
• 根据「NOSPAM」的要求，自动对某个发送疑似广告消息的用户进行再次的验证审核
• 可设置「自动免验证」，用户进入多群无需重复验证
• 自动「叠加入群提示」，显示待验证人数。
• 自动触发「防炸群模式」，炸群终止后自动恢复常规模式
• 非自定义问题的验证流程不在群内呈现
• 通用验证流程完全透明，群组管理员可随时在「CAPTCHA专用验证群」中查看群员验证流程，不存在「黑箱」环节
• 本机器人力求以最简短最不干扰群组内正常交流的方式提醒用户进行验证

👉🏿 设置选项说明：「/config captcha」

协助删除： 用户验证失败时，令「USER 」协助删除该用户所发所有消息（包括该用户入群消息，同时避免机器人在特殊情况下遗漏在成功禁言前用户所发的其他消息）

禁言模式： 多次验证失败，导致永久惩罚时，选择禁言该用户，而不是封禁该用户（#更新：自定义问题下的禁言模式，用户回答错一次问题，就会被一直禁言。即使重新入群，其加群消息会被自动删除，而不会触发验证。除非群管理员 /pass，或者一个月后再次入群并回答正确问题，限制才会解除）

封禁模式： 首次验证失败，选择直接永久封禁该用户，而不在 600 秒后解禁该用户（不给用户再次尝试的机会）

自动解禁： 当某名用户在其他群组验证成功，选择自动解除该用户在您的群组中受到的永久性封禁惩罚

入群提示： 如关闭，机器人将无法发送新用户入群时的验证提示。群管理可参考「设置自定义提示」部分内容自定义提示的文字内容和显示方式

自动免验证： 开启后，用户在某个群组验证通过一段时间后，将不会再次重复地在其他群组触发验证

自动置顶： 开启后，当群组短时间内进入大量用户「比如炸群」时，机器人将不再重复发送入群验证提示，而是发送一条通用提示，并将此提示置顶，其后保持静默。当群组的入群频率恢复正常并保持一定时间后，机器人将自动取消置顶。如果群组之前已有置顶，则自动恢复群组原有的置顶消息。置顶产生的服务消息将被「USER」自动删除，以期最小化对群组正常对话的影响

自定义问题： 开启后，当群组设定了自定义问题时，机器人将选取指定的问题提问用户。详情请见「设置自定义问题」

仅手动： 开启后，新用户入群将不再触发验证流程 (#更新：该功能已从配置按钮中隐藏，如果需要开启，仅可通过手动命令执行，并将保留命令执行证据：/config_captcha manual on或off：关闭或开启入群验证)

👉🏿 更多CAPTCHA配置

👉🏿 所有模块功能介绍

#USER 功能模块介绍和设置选项说明

👉🏿 模块功能：

• 集中控制群组如何处理全局黑名单用户：是将黑名单用户无条件忽略放行，还是删除消息、禁言、或直接封禁
• 帮助机器人获取消息链接的预览（链接中的文字、图片、视频、文件）
• 帮助机器人删除用户全部消息、删除超过2天的历史消息（是否采取操作可由群组自定义）
• 帮助群成员自助删除（功能命令：/dafm y）所有历史消息（需管理打开CLEAN模块中的此功能）
• 审核并邀请小鬼当家机器人入群，并同时赋予其所需的特定权限（仅首次入群需要此权限）

👉🏿 设置选项说明：「/config user」

协助删除：开启后，USER 将接受机器人协助删除历史消息的请求。请谨慎关闭

全局封禁、全局禁言、全局删除：设定 USER 接收到一名黑名单用户时，您的群组是否参与全局的封禁、禁言、或删除。此三个选项代表不同等级的参与等级，故是互相矛盾的。选中一项，另外两项将自动取消选中

订阅封禁、订阅禁言、订阅删除：设定 USER 如何对待群内黑名单用户的入群或发言。黑名单用户入群或发言时，将按照此订阅等级操作。此三个选项代表不同等级的订阅等级，故是互相矛盾的。选中一项，另外两项将自动取消选中

👉🏿 问与答

Q：为什么要使用一个 user-bot？
A：使用一个 user-bot 是为了：

⓵ USER 会分享消息链接预览给机器人进行分析，避免spammers使用消息预览规避常规机器人的检查
⓶ 群组可集中自定义控制所有功能模块对黑名单用户的行为
⓷ 保证只允许经过授权的群组使用服务
⓸ 无需记录数据即可实现全局删除、全局封禁、删除全部消息等功能
⓹ 在某些情况下协助机器人其他模块清理移除用户而产生的服务消息
⓺ 协助CLEAN模块实现群成员自助删除所有历史消息的功能（需管理打开CLEAN模块中的此功能）

Q：USER 除了删除消息、封禁用户外，为何还需要邀请用户、提升管理员的临时权限？
A：由于小鬼当家机器人需要 USER 拉入才认为是经过授权的使用，所以 USER 需要具有邀请用户的权限。而提升管理员的权限，是为了在 USER 拉入小鬼当家机器人的同时为小鬼当家设定所必要的权限。USER 的「add admin」权限仅首次配置的时候需要，配置完成后即可取消该权限

👉🏿 更多USER配置

👉🏿 所有模块功能介绍

#TIP 功能模块介绍和设置选项说明

👉🏿 模块功能：

• 发送入群欢迎消息，可带按钮
• 可自定义关键词回复、删除消息，禁言、踢出、封禁用户
• 可固定群置顶（/hold）
• 可设置私有群组绑定公开入群频道

👉🏿 设置选项说明：

过审欢迎： 开启后，只有用户通过入群验证后才发送欢迎消息。默认开启

非回复欢迎： 开启后，机器人将不会以回复入群消息的形式来欢迎新入群用户。默认关闭

无痕模式： 开启后，机器人所发送的提示都会定时销毁。默认开启

OT 警告： 开启后，如果群组设置了 OT 警告内容（机器人内置了默认 OT 警告内容），将会响应 /ot 命令。按钮关闭后，将关闭 OT 警告功能。默认开启

RM 警告： rm 笑话警告。如果群组设置了 RM 警告内容（机器人内置了默认 RM 警容），则会对 rm 类笑话响应。按钮关闭后，将关闭 RM 警告功能。默认关闭

欢迎消息： 开启后，如果群组设置了欢迎内容，将会在新成员入群后立即发送入群欢迎。按钮关闭后，将关闭入群欢迎功能。默认开启

关键词提示： 开启后，如果群组设置了关键词提示内容，则会针对关键词回复内容。按钮关闭后，将关闭关键词提示功能。默认开启

放行白名单： 开启后，如果群组设置的关键词触发行为包括删除、移除、禁言、封禁等任意一个影响用户消息和权限的功能，将不对项目中全局白名单的用户触发此关键词。默认关闭

平等模式： 机器人默认对管理员的关键词触发是区别对待且有触发条件的：要求全匹配，而且是管理员用全匹配关键词回复某个人才会触发——管理员的关键词会被自动删除，被回复的人会被回复预设的消息。而开启「平等模式」后，机器人对管理员的关键触发没有特殊条件，并且会尝试执行所有设置的关键词触发行为

取消置顶： 开启后，将取消频道在群组中的置顶。按钮关闭后，将不再取消

保持置顶： 单纯使用按钮开启无效果，需在群内使用命令（/hold）保持某条消息为置顶，避免被频道置顶替代。按钮关闭后，将不再保持

入群频道： 单纯使用按钮开启无效果，需在群内使用命令（/channel）绑定某频道。按钮关闭后，将取消绑定

每日重发入群链接： 注意：即使不重发入群链接，机器人也会在原消息中定时更换、刷新入群链接。重发链接模式开启后，如果绑定了入群频道，将在每日都在该频道中回收入群链接消息，并发送一条新的消息。默认关闭

👉🏿 绑定入群频道方法设置：

介绍：机器人可以绑定一个入群频道，它将在入群频道中发送一条带按钮的消息，按钮将指向定时刷新的私有群组邀请入群链接

设置：首先将 TIP 机器人拉入一个频道中，赋予『发送消息』权限，然后将该频道的任意一条消息，转发到所需绑定的私有群组中。接着，管理员使用 /channel 命令在群内回复刚刚转发的频道消息。即可成功绑定入群频道

👉🏿 更多TIP配置

👉🏿 所有模块功能介绍

#公告 #更新 #TIP

TIP 模块更新：

👉🏿 本次更新优化了设置TIP关键字自定义内容的方法，并新加入匹配关键词后 回复、删除消息，禁言、移除、封禁用户等功能

⓵ 针对自定义关键词回复，可以指定销毁时间、能够触发的用户（管理员还是普通群员）、匹配模式、附加的按钮链接

⓶ 新增触发关键词后机器人可执行的操作：仅回复 / 删除 / 禁言（n 秒） / 封禁（n 秒）

⚠注意：基于「操作可查原则」的保证，若群组开启了自定义关键词（开启方法：/config_tip keyword on），则机器人将对 /keywords、/keyword、/kws 命令转发至 @XiaoGuiDangJia_COMPROMISE 频道中做证据留存

一个例子：

/add 电报拉人
+++
$mention_name 已被禁言 180 秒，请文明发言。<a href="$evidence_link">点击查看证据存档</a>。
+++
include
+++
reply delete restrict-180
+++
all
+++
180

👉🏿 更多配置说明参考：scp-079.org/bots/tip

#公告 #TIP

非常抱歉，由于本次同步更新TIP模块到0.2.2时，所有群组的 入群欢迎、ot、rm、关键字提醒、入群频道关联 旧版数据格式升级转换失败，需要自行重新配置，比如：

➽ 欢迎信息的设置：

/welcome 欢迎 $mention_name 加入<b>本群</b>，你的ID是: $code_id
++++++
按钮文字1 || https://www.anniuduiyinglianjie1.com
按钮文字2 || https://www.anniuduiyinglianjie2.com

➽ 关键字提醒的设置：

1，首先启用自定义关键词功能：

/config_tip keyword on

2，管理员在群组中发送：/kws 进入机器人对话设置

👉🏿 更多配置说明参考：scp-079.org/bots/tip

介绍如何实现 『点击确认』 即可入群

#使用介绍

👉🏿 英文用户群组或者对入群验证要求不高的群组，可以用自定义验证问题的方式来模拟『点击确认』即可入群 :

(这种验证方式会显著降低SPAM封禁效果)

一、首先开启自定义问题功能：

先 /config captcha，选中☑️自定义问题，再 /qns

二、添加自定义问题内容：

/add 如果您确认并自愿遵守，请点击按钮「确认入群」
+++
确认入群
+++
再考虑一下

三、设置自定义问题验证的提示：

1，自定义单用户入群时的提示

/custom single
欢迎 $mention_name，入群前请先阅读群规，你有 <b>120</b> 秒的时间来考虑是否接受，超出时间后你将被移出本群

(验证等待时间目前不支持自定义)

群规balabala

2，自定义多个用户入群时的提示

/custom multi
待验证用户：$code_count 名
说明：欢迎加入本群，入群前请先阅读群规，你有 <b>120</b> 秒的时间来考虑和完成验证，超出时间后你将被移出本群

群规balabala

四、修改自定义回答正确后的弹窗提示：

/custom correct 欢迎加入！
/custom wrong 慢走不送！

五、自定义过审欢迎信息内容：

/welcome 欢迎消息的文字内容
++++++
按钮文字1 || 按钮链接1
按钮文字2 || 按钮链接2

#公告 #更新 #TIP

同步更新TIP模块至：0.2.5

本次更新强化了 TIP自定义关键词 功能：

1. regex部分支持使用「正则匹配」模式，每个以 || 分隔的关键词都被当做一条独立的正则表达式，正则表达式的语法请参照 Google RE2 的 Wiki

2. caption 部分支持「仅匹配媒体消息」

3. 新增「平等模式」处理群组管理员、白名单用户的关键词触发，开启「平等模式」后，机器人对管理员的关键触发没有特殊条件，并且会尝试执行所有设置的关键词触发行为

👉🏿 更多配置说明参考：scp-079.org/bots/tip

#公告

小鬼当家日常维护命令：

/admin：回复式命令，群员提醒管理使用
/ban：回复式命令，用于封禁用户
/captcha：回复式命令，要求用户重新入群验证
/clean：立即删除4小时内群组内的贴纸和 GIF 动图
/config：配置命令，后跟模块名称
/config_captcha manual on或off：关闭或开启入群验证（该功能仅可通过此命令执行）
/dafm y：群员自助删除所有历史消息(需开启)
/flood off：手动关闭炸群模式，并同时关闭入群验证功能
/hold：回复式命令，用于固定群置顶
/kick：回复式命令，用于踢出用户
/kws：用于设置关键词规则
/long：回复式命令，用于字数统计
/ot：用于群聊离题提醒
/pass：回复式命令，手动通过用户入群验证
/pb：purge 的进阶用法，指定删除消息的起始位置
/pe：purge 的进阶用法，指定删除消息的终止位置
/purge：以此命令回复某条消息，将删除最新一条消息至该条消息之间的所有消息，大于 1000 条将不作出应答
/report：回复式命令，群员举报用户使用
/rm：用于群聊玩笑提醒
/show：后跟 welcome/ot/rm，用于查看配置信息
/warn：回复式命令，用于警告用户
/welcome：回复式命令，手动欢迎用户

关于管理原则和隐私问题

本机器人由 开源代码SCP-079 创建，致力于为Telegram群组封锁spammer，仅小范围开放给符合申请条件的公共群组申请使用

📜机器人基于数据最少原则，存储以下数据：

• 群组对于本机器人的设置
• 群组管理员ID列表*
• 白名单用户ID列表**
• 黑名单用户ID列表***
• spam过滤正则表达式库

*群组管理员ID列表用于识别哪些ID有权限对群组中的机器人进行功能设置
**白名单ID列表由机器人内置规则自动产生，白名单ID仅为受spam规则影响较小的ID
***黑名单ID列表仅由 自动封禁规则 产生，群组管理员和机器人管理员都无法手动加入

📜机器人基于操作可查询原则，保留操作证据：

• 公告频道：@XiaoGuiDangJia_INFO
• 操作记录：@XiaoGuiDangJia_DEBUG
• 设置记录：@XiaoGuiDangJia_CONFIG
• 错误记录：@XiaoGuiDangJia_ERROR
• 证据存放*：@XiaoGuiDangJia_LOGGING
• 群组自定义规则设置记录：
@XiaoGuiDangJia_COMPROMISE
• 群组自定义规则证据存放：
@XiaoGuiDangJia_TIP

*证据存放中规则为「群管自行操作」的记录由群组管理员手动执行

📜机器人基于双向选择原则，设置了需要经过审核才能使用的模式：

• 使用本机器人的群组，应了解 机器人申请条件
• 群组可随时停用/删除本机器人，同时注意，群组删除本机器人后，机器人也将自动清空保存的群组设置记录和管理员ID列表
• 我们将拒绝无法满足机器人申请条件的群组或申请者过往有违反机器人封禁规则的申请

📈机器人服务器 在线状态查询

#公告 #更新 #NOSPAM

同步更新NOSPAM模块至：0.2.3.patch

更新内容：

针对近期出现的使用联系人卡片发布广告的情况，已对 NOSPAM 进行相应调整。NOSPAM 将检查该卡片联系人的昵称，如符合封禁规则，则发送卡片的用户会被封禁。

如果群组同时开启了 CLEAN 的「自动删除联系人卡片」的功能，CLEAN 仍将以 NOSPAM 的判断为准。即 NOSPAM 对卡片封禁的优先级大于 CLEAN 对该类型消息过滤的优先级。

#公告 #CAPTCHA

为防再次出现因群管理误关闭入群验证功能，而在遭遇炸群后机器人无法进入炸群保护模式的问题，我们已执行以下更新：

CAPTCHA模块中的 关闭/打开入群验证功能 将从 /config captcha 配置按钮中隐藏，如果确实需要关闭入群验证，只能通过以下手动命令完成，并将保留命令执行证据：

/config_captcha manual on或off：关闭或开启入群验证功能

#更新 #NOPORN

上线新模块 NOPORN，功能：

• 自动删除包含 NSFW（Not Safe for Work）画面的媒体消息
• 自动删除来自受到 Telegram 官方限制的频道的消息

#更新 #ID

ID机器人 @XiaoGuiDangJia_ID_BOT 上线新功能：可以查询账号所在DC服务器的物理位置：

Q：使用方法？
A：和 ID 机器人「私聊」使用/id 命令查询 ID 的同时，会显示相应的 DC（如果可以显示）

Q：介绍一下DC？
A：Telegram 拥有DC1~DC5服务器。 DC 是Data Centers 的缩写，也就是”数据中心”。 Telegram 的服务器在世界不同地区有多个数据中心：

DC1/3 美东迈阿密【美洲地区】
DC2/4 荷兰【欧洲地区】
DC5 新加坡【亚洲地区】

账号 DC 由注册账号时所使用的手机号码决定
群/频道/机器人 DC 由创建者账号所属DC决定

Q：为什么上线这个功能？
A：因为DC5经常拉垮

Q：为什么我查询不了？
A：因需要设置头像并且头像任何人可见

关于小鬼当家机器人项目的后续更新

#公告

小鬼当家机器人基于开源代码「SCP-079」

SCP-079 是非常不错的telegram管理机器人，并且一直保持开源和免费使用，非常感谢 SCP-079 的开发者们能设计出这么好的机器人

SCP-079 将每个机器人功能独立，并且做到所有操作、证据、数据、规则可查可控的保存于telegram中，这是非常好的想法。但也同样源于此，需要投入非常多的时间和精力去搭建和维护，甚至由于telegram本身的原因，很容易出现一些不可控的问题。所以激情过后，就剩下了佛系

SCP-079 开发者发布了『关于 SCP-079 项目的变化』的公告，如果重构后的新项目继续保持开源，小鬼当家也会视情况和搭建的难易程度跟进更新，重构想法：

- 废除目前的双BOT模式，仅保留一个BOT
- 保留 CAPTCHA、CLEAN、NOFLOOD、NOSPAM、TIP、WARN模块
- 取消 LANG 模块，可能取消 NOPORN 模块
- 采用简化的向导型配置模式
- 依然保留目前的证据留存功能
- 重构后的新项目预计会在 2022 年 2 月上线，首批上线的模块包括 CAPTCHA、TIP、WARN

#更新 #NOSPAM

NOSPAM 模块更新，添加删除来自频道消息的功能：

/config_nospam sender_chat on

请注意，如果您的评论群组在之后绑定了新的频道，请在群内重新执行此命令

#公告 #TIP

由于 Telegram 仅显示最近 100 万条消息的机制（超过 100 万条的历史消息，机器人、新入群用户、当前设备没有缓存过旧消息的老用户都无法读取）

因此会出现 TIP 模块 hold 失效的问题，只需重新发送一次置顶消息，而后再 /hold 这条新消息即可

#说明

关于「协助删除」，其基础功能为：令 USER 协助其他模块删除该用户所有消息

▎USER 中的「协助删除」

• 开启后，USER 将接受其他模块协助删除历史消息的请求。这是总开关，请谨慎关闭

▎CAPTCHA 中的「协助删除」

• 用户验证失败时，令USER 协助删除该用户所发所有消息（包括该用户入群消息，同时避免机器人在特殊情况下遗漏在成功禁言前用户所发的其他消息）。

▎NOPORN、LONG 中的「协助删除」

• 开启此选项后，机器人将在有必要时，令 USER 协助删除用户所发的所有消息。

▎NOSPAM 中的「协助删除」

• 开启后，用户触发SPAM自动封禁时，令 USER 协助删除该用户所发的所有消息。

▎WARN 中的「协助删除」

• 开启后，群组管理员使用 /ban 或 /kick 或 /warn 命令导致用户被移出群组时，将令 USER 协助删除该用户所发的所有消息。