Telegram Bot Rose 中文使用说明书

@MissRose_bot 是一个Telegram Bot
在 telegram 群组内使用广泛的，群管理功能十分强大，服务状态也相对稳定，不过缺点是：没中文说明书啊，网上已有的中文说明充满了严重的机翻味，所以就自己整理了一版常见命令的中文帮助文档。

---

Admin-管理员

• /promote <reply/username/mention/userid> : 提升一个用户的权限

• /demote <reply/username/mention/userid> : 取消一个用户的权限

• /adminlist：列出当前聊天中的管理员。

• /admincache：更新管理员缓存，以更新新的管理员/管理员权限。一般rose会在你更新群组管理列表后几分钟内更新记录的管理员列表，但偶尔可能会出错或者你想马上更新，就用这个命令吧。

• /anonadmin <yes/no/on/off> : 允许匿名管理员使用所有命令而不检查他们的权限。不建议开启，因为容易出事。

• /adminerror <yes/no/on/off> : 当普通用户使用管理命令时发送错误提示信息。

Antiflood-防刷屏

防止群员恶意刷屏！

Antiflood 允许对连续发送超过 x 条消息的用户采取措施。 动作是：ban/mute/kick/tban/tmute

• /flood：获取当前的防刷屏设置

• /setflood <number/off/no>：设置对用户采取行动的消息数量。 设置为0/off/no给以禁用。

• /setfloodmode <action type>：选择对被刷屏的用户采取措施。 选项：ban/mute/kick/tban/tmute

• /clearflood <yes/no/on/off> : 是否删除刷屏的消息。

AntiRaid-防小号炸群

防止一瞬间成百上千个小号加群！

防炸群模块可让您在此类炸群发生时快速阻止任何人加入。在接下来的几个小时内，所有的加群都将被暂时禁止，等待攻击结束。

• /antiraid <optional time>：在接下来的几个小时内，所有新加入都将被暂时禁止。
  ex:/antiraid 3h启用反炸群 3 小时：

• /raidtime <time>：查看或设置所需的反炸群持续时间。 默认 6 小时。
  反炸群模式将持续到 6 小时，之后会自动关闭。

• /raidactiontime <time>：查看或设置临时禁止用户加入的反炸群时间。 默认 1 小时。
  ex: /raidactiontime 1h w/d/h/m（周/天/时/分）
  反炸群执行期间，任何用户加入都将会被封禁 1 小时。

• /autoantiraid <number/off/no>：设置1分钟内加群账号数量限额，超过设置限额后，自动启用反炸群。 设置0/off/no为禁用。
  ex: /autoantiraid 15如果超过 15 个用户在一分钟内加入，则自动启用反炸群：

• /autoantiraid off
  禁用自动反炸群：

注意：由于TG本身设计问题，Bot必须收到TG推送的服务消息（就是“XXXX 已加入群组”那句话）才能被动的知道有新人加群，才会对新人做出设定的禁言，人机验证等操作，如果短时间大量用户加入某个群，TG可能会在这个群里漏（停止）推送服务消息，导致管理Bot根本不知道有人加群，所以后续的反炸群处理也无从谈起。

Approval 白名单

批准你信任的用户，允许他们发送违禁词而不被处罚

• /approval：检查用户在此聊天中的白名单状态。

• /approve：白名单用户，锁定、阻止列表和刷屏将不再适用于它们。

• /unapprove：移除白名单用户。 他们现在将再次受到锁定、阻止列表和刷屏的约束。

• /approved：列出所有白名单用户。

• /unapproveall：从所有白名单删除所有人，注意这不能被撤消。

Bans 封禁用户

公开禁止，垃圾违规信息发送者

用户命令：

• /kickme：用户自己踢自己。我建议大家在后面禁用命令模块中，把这个禁用了，以防被误触发。

管理员命令：

• /ban：封禁用户。

• /dban：通过回复封禁用户，并删除他们的消息。

• /sban：静默封禁用户，并删除您的消息。

• /tban：暂时封禁用户。时间值示例：4m = 4 分钟，3h = 3 小时，6d = 6 天，5w = 5 周。

• /unban：取消封禁用户。

• /mute：禁言。

• /dmute：通过回复禁言用户，并删除他们的消息。

• /smute：禁言用户，并删除您的消息。

• /tmute：暂时禁言用户。时间值示例：4m = 4 分钟，3h = 3 小时，6d = 6 天，5w = 5 周。
  ex: /tmute @username 2h
  将用户禁言两个小时。

• /unmute：取消禁言用户。

• /kick：踢一个用户（不封禁，他还可以再次加群）

• /dkick：通过回复踢用户，并删除他们的消息。

• /skick：悄悄踢出用户，并删除您的消息

Blocklists 违禁词

封禁问愚蠢问题的群员，或禁止说被审查的话

• /addblocklist <blocklist trigger> <reason>：添加一个违禁词列表。您可以通过将整个句子放在“引号”中来阻止说这些话。

ex： /addblocklist “特朗普 123” “键政” 被禁言，禁言时长：2 小时 原因：“键政”

• /rmblocklist <blocklist trigger>：删除这个违禁词

• /unblocklistall：清空违禁词列表 （仅群主可用）

• /blocklist：列出所有列入黑名单的违禁词。

• /blocklistmode <blocklist mode>：设置当有人说一个被列入黑名单的项目时要采取的行动。mode可用:nothing/ban/mute/kick/warn/tban/tmute
  ex: /blocklistmode tmute 2h
  封禁列表操作已更新为 tmute 2h。任何用户发出的触发违禁词的对应消息都将会被删除，且该用户将会被 禁言 2 小时

• /bloistdelete <yes/no/on/off>：设置是否应删除列入违禁词的消息。默认值：（开）

• /setblocklistreason <reason>：设置默认的触发违禁词原因以警告人们。

• /resetblocklistreason：将默认触发违禁词后提示的原因重置为默认值。

Top tip:

阻止列表允许您使用一些修饰符来匹配“未知”字符。
?字符以匹配任何非空白字符的单次出现。
*修饰符，它匹配任意数量的任意字符。
如果您想将网址列入黑名单，这将允许您匹配完整的内容。它匹配除空格以外的所有字符。
ex: /addblocklist "特朗普* “键政”

CAPTCHA 验证码

要启用验证码，您必须启用欢迎消息。如果您禁用欢迎消息，验证码也将停止。

加入的群组新用户将需要完成人机测试以确认他们是真实的人

• /captcha <yes/no/on/off>：所有加入的用户都需要通过验证码。这证明他们不是机器人！

• /captcha on
  启用验证码

• /captchamode <button/math/text/text2>：选择用于聊天的验证码类型。

• /captchamode text
  将验证码模式更改为文本。

• /captcharules <yes/no/on/off>：要求新用户同意群规（管理需要先设置一个rule）才能在聊天中发言。

• /captcharules on
  启用验证码规则，强制用户在被允许发言之前阅读群规。

• /captchatime <Xw/d/h/m>：X 时间后取消禁言新用户。如果用户还没有通过验证码，他们会在这段时间后自动解禁。

• /captchakick <yes/no/on/off>：踢出尚未通过验证码的用户。

• /captchakicktime <Xw/d/h/m>：设置完成 CAPTCHA 验证所需要的的时间。

• /setcaptchatext <text>：自定义验证码按钮上的文字。

• /resetcaptchatext：将 CAPTCHA 按钮重置为默认文本。

要启用验证码，您必须启用欢迎消息。如果您禁用欢迎消息，验证码也将停止。

Clean Service 清理服务消息

清理自动电报服务消息！

• /cleanservice <type/yes/no/on/off> : 选择要删除的服务消息。

• /keepservice <type> : 选择要停止删除的服务消息。

• /cleanservicetypes: 列出所有可用的服务消息，并附有简要说明。

all ：所有服务信息。
join ：当新用户加入或添加时。例如：'X 加入了聊天'
leave ：当用户离开或被删除时。例如：'X 离开了聊天'
other ：杂项；例如成功的电报支付、上线提示、webapp 消息或消息自动删除更改。
photo ：当聊天照片改变时。
pin : 置顶新消息时。例如：“X 置顶了一条消息”
title ：聊天标题更改时。
videochat ：当视频聊天操作发生时 - 例如开始、结束、安排或将成员添加到通话中。

Connections 连接

通过该功能，你可以在和rose的私聊中，配置群内的设置，这样你对rose的设定过程就可以对群友保密了。（仅群内管理员可用）

• /connect <chatid/username>：连接到指定的聊天，允许您查看/编辑内容。
  ex:/connect @yourname 在 @MissRose_bot 机器人里面发送

• /connect 在需要的群组里面发送即可。

• /disconnect：断开当前聊天。

• /reconnect：重新连接到之前的连接聊天

• /connection：查看有关当前连接聊天的信息。

Disabling 禁用

允许您禁用一些常用的命令，没有人可以使用它们。 它还允许您自动删除群友发送的命令。

• /disable <commandname>：阻止用户在该组中使用“commandname”。
  ex: /disable connect 群员发送 connect会被直接删除

• /enable <item name>：允许用户在该组中使用“commandname”。

• /disableable：列出所有可禁用的命令。

adminlist
approval
connect
fedadmins
fedinfo
fedsubs
filters
flood
id
info
kickme
locks
locktypes
notes
rules
runs
saved
warnings
warns

• /disabledel <yes/no/on/off>：在非管理员使用时删除禁用的命令。
  禁用命令时，该命令仅对非管理员禁用。 所有管理员仍然可以使用这些命令。

• /disabled：列出此聊天中禁用的命令。

• /disableadmin <yes/no/on/off> : 阻止管理员也使用禁用的命令。

禁止命令时，该命令群友和管理员都不可用这些命令。

Federations 反广告联盟

反广告联盟，适用于管理系列群组的情形，一个群内执行触发，则整个规定的联盟内群组都同步执行处分。

• 联盟管理员命令
  • /fban: 在当前反广告联盟中封禁用户

  • /unfban: 从当前反广告联盟中解禁用户

  • /feddemoteme <fedID> : 将自己从反广告联盟中移出。

  • /myfeds: 列出所有你是管理员的反广告联盟。

• 联盟创建者命令

  • /newfed <fedname> : 使用给定的名称创建一个新的反广告联盟。每个用户只能创建一个反广告联盟。

  • /renamefed <fedname> : 重命名你的反广告联盟。

  • /delfed：删除你的联盟，以及与之相关的任何信息。注意这不会解禁任何已经被禁止的用户。

  • /fedtransfer <reply/username/mention/userid> : 将您的反广告联盟所有权转移给另一个用户。

  • /fedpromote：在你的反广告联盟中将用户提升为联盟管理员。为了避免被恶意或无意添加不需要的反广告联盟管理员，被添加的用户将收到一条确认消息。

  • /feddemote：在你的反广告联盟中删除联盟管理员。

  • /fednotif <yes/no/on/off> : 是否接收反广告联盟的日志通知。

  • /fedreason <yes/no/on/off> : fban人时是否需要填写封禁的理由。

  • /subfed <FedId>: 订阅一个反广告联盟。在你所订阅的联盟中被封禁的用户也将在你的联盟中被封禁。

  • /unsubfed <FedId> : 取消订阅一个反广告联盟。

  • /fedexport <csv/minicsv/json/human>: 获取当前被封禁用户的列表。默认输出为 CSV。

  • /fedimport <overwrite/keep> <csv/minicsv/json/human> : 导入封禁用户列表。

  • /setfedlog：将当前聊天设置为联盟日志输出。所有联盟的事件都将记录在此处。

  • /unsetfedlog：取消将当前聊天设置联盟日志。将不再记录事件。

• 联盟一般用户命令

  • “/fedinfo ` : 关于反广告联盟的信息。

  • /fedadmins <FedID> : 列出反广告联盟中的管理员。

  • /fedsubs <FedID> : 列出您的反广告联盟订阅的所有联盟。

  • /joinfed <FedID> : 将当前聊天加入反广告联盟。一个群只能加入一个联盟。命令只有群主可用。

  • /leavefed：退出当前反广告联盟。命令只有群主可用。

  • /fedstat: 查看被封禁联盟封禁情况。

  • /fedstat <user ID> : 列出该用户被那些联盟封禁了。

  • /fedstat <FedID> ：列出在联盟中的封禁情况

  • /fedstat <user ID> <FedID> : 列出该用户在指定联盟中的封禁情况

  • /chatfed：有关当前聊天所在联盟的信息。

  • /quietfed <yes/no/on/off> : 当被禁止的用户加入群组时是否发送被禁止通知。

Filters 关键词回复

机器人会回复关键词！

• /filter <trigger> <reply>：每次有人说“trigger”时，bot都会回复“reply”。
  ex:
  • /filter hello Hello there! hello 单个单词触发回复Hello there!
  • /filter "hello friend" Hello back! hello friend 2个以上字符组从触发词需要用符号 “”括起来
  • /filter (hi, hey, hello, "hi there") Hello! 一次设置多个自动回复触发词，用括号组合，用逗号隔开
  • /filter "example"a normal {admin}设置一个只能由管理员使用的自动回复
  • /filter "example" forwarded {protect} 设置一个无法转发保存的自动回复
  • /filter *** 要保存文件、图像、gif 或任何其他附件，只需回复文件
• /filters：列出所有自动回复。

• /stop <关键词>：阻止机器人回复“关键词”。

• /stopall：停止当前聊天中的所有自动回复。这不能被撤消。

Formatting 消息格式化

rose支持markdown语法

• code words
  反引号用于等宽字体

• _italic words_
  下划线用于斜体字体

• *粗体字*
  星号用于粗体字体(注意只有一对*号)

• ~strikethrough~
  ~波浪线用于删除线~

• __underline__
  双下划线用于下划线

• ||剧透||
  双竖线用于剧透消息

• [超链接](www.tjsky.net)
  这是用于超链接的格式

• [我的按钮](buttonurl://https://www.google.com)
  这是用于创建按钮的格式。

如果您想在同一行发送按钮，请使用 :same 格式。例如：

[按钮 1](buttonurl://https://www.google.com/)
[按钮 2](buttonurl://https://www.google.com/)
[按钮 3](buttonurl://https://www.google.com/)

• [note button](buttonurl://#notename)
  此语法将允许您创建一个链接到笔记的按钮。单击后，用户将被重定向到 Rose 的 私聊 以查看注释。

Fillings-补充-关键词和入群欢迎的格式

可以使用上下文数据自定义消息的内容。 关键词和欢迎的格式

• {first}：用户的名字。
• {last}：用户的姓氏。
• {fullname}：用户的全名。
• {username}：用户的用户名。 如果他们没有，请改为提及用户。
• {mention}：用他们的名字提及用户。
• {id}：用户的 ID。
• {chatname}：聊天的名称。
• {rules}：为聊天规则创建一个按钮。
• {preview}：启用此消息的链接预览。 在使用即时查看页面的链接时很有用。

Greetings 入群欢迎

• /welcome <yes/no/on/off>：启用/禁用欢迎消息。

• /goodbye <yes/no/on/off>：启用/禁用再见消息。

• /setwelcome <text>：设置新的欢迎信息。 支持markdown、按钮和补充。

• /resetwelcome：重置欢迎信息。

• /setgoodbye <text>：设置新的告别信息。 支持markdown、按钮和补充。

• /resetgoodbye：重置告别信息。

• /cleanservice <yes/no/on/off>：删除所有服务消息。 这些是您在人们加入时看到的烦人的“x 加入群组”通知。

• /cleanwelcome <yes/no/on/off>：删除旧的欢迎消息。 当有新人加入时，或 5 分钟后，上一条消息将被删除。

Random Content 随机内容

• %%%：此分隔符可用于向机器人添加“随机”回复。
  ex:

/setwelcome
hello there {first}!
%%%
Ooooh, {first} is in the house!
%%%
Welcome to the group, {first}!

Import/Export 导入导出配置

Rose 允许您导入/导出在群组中的设置，因此您可以使用预先存在的模板快速的对其他群组进行设置。您可以使用此功能跨组复制常规配置，而不是在不同的聊天中一遍又一遍地设置相同的设置。生成的文件为标准 JSON 格式，因此如果您不想将某些设置导入，只需在导入前打开文件并进行编辑即可。任何管理员都可以导出设置，出于安全原因，导入设置只能由组创建者完成。

以下模块的设置是可以导出的：

admin
antiflood
blocklists
disabled
federations
filters
greetings
locks
notes
pins
raids
reports
rules
translations
warns

• /export：导出配置
  ex:/export notes filters 导出笔记和关键词回复
• /import：导入配置 回复文件即可
  ex: /import rules greetings导出 规则 欢迎

Languages 语言

• /setlang <language>: 设置语言

AR (العربية)
AZ (azərbaycan)
BE (беларуская)
CKB (کوردیی ناوەندی)
DE (Deutsch)
EN-GB (British English)
ES (español)
ES-AR (español)
FA (فارسی)
FR (français)
HE (עברית)
ID (Indonesia)
IT (italiano)
KM (ខ្មែរ)
ML-IN (മലയാളം)
MS (Melayu)
NL (Nederlands)
PA (ਪੰਜਾਬੀ)
PL (polski)
PT (português)
PT-BR (português)
RU (русский)
SH (srpskohrvatski)
TA (தமிழ்)
TR (Türkçe)
UK (українська)
UZ (o‘zbek)
VI (Tiếng Việt)
ZH-CN (中文)
ZH-TW (繁體中文)

Locks 禁用群组内功能

群员禁用 贴纸 链接 图片等功能，这些内容将只允许管理员与白名单用户发送

• /lock <item(s)>：禁用一个或多个项目。现在，只有管理员可以使用这种类型！
  EX:
  • /lock sticker 禁用贴纸
  • /lock sticker photo gif video 禁用贴纸，gif动图，视频
  • /lock sticker ### 不要发送贴纸 {ban}禁用贴图，并发送提示不要发送贴纸，并封禁发送者
• /unlock <item(s)>：解锁一件或多件物品。每个人都可以再次使用这种类型！

• /locks：列出当前禁用的项目。

• /locks list 一次列出所有禁用

• /lockwarns <yes/no/on/off>：启用或禁用在使用禁用项目时是否应警告用户。

• /locktypes：显示所有可禁用项目的列表。

all 全部
album
anonchannel 匿名频道
audio 音频
bot 机器人
button 
command 命令
comment
contact
document
email 邮箱
emojigame
forward
forwardbot
forwardchannel
forwarduser
game 游戏
gif
inline
invitelink
location
phone
photo
poll
rtl
spoiler
sticker
text
url
video
videonote
voice

• /allowlist <url/id/@channelname(s)>：将 URL、组 ID、频道 @ 或机器人 @ 列入白名单，以防止它们被 URL、转发、邀请链接和内联锁删除。用空格分隔以一次添加多个项目。如果没有给出任何参数，则返回当前的允许列表。

ex: /allowlist @RoseSupport 列入白名单
– /rmallowlist <url/id/@channelname(s)>：从允许列表中删除一个

• /rmallowlistall：删除所有列入白名单的项目。

Log Channels 创建日志频道

帮助您记录机器人采取的每一个操作，发送到日志频道。
以下步骤设置日志通道：

以管理员身份将 Rose 添加到您的频道，并添加管理员。
发送 /setlog 到您的频道。
将 /setlog 命令转发到您希望记录的组。

管理员命令：

• /logchannel：获取当前日志通道的名称。

• /setlog：设置当前聊天的日志通道。

• /unsetlog：取消设置当前聊天的日志通道。

• /log <category>：启用日志类别 – 现在将记录该类型的操作。

  • settings 机器人设置 – 例如阻止列表、欢迎、规则等。
  • admin 管理员操作 – 例如禁止、静音、踢和警告。
  • user 用户操作 – 例如 kickme 或加入/离开。
  • automated 在触发锁定、阻止列表或反洪水后采取的自动化管理操作
  • reports 来自用户的报告 – 通过 @admin 或 /report。
  • other 有关额外功能的日志，例如注释和过滤器。
• /nolog <category>：禁用日志类别 – 该类型的操作将不再被记录。

• /logcategories ：列出所有支持类别，以及它们所指的信息。

Misc 杂项

零碎模块

• /runs：以随机生成的“逃跑”字符串响应。

• /id：获取用户的 ID。

• /info：获取用户信息。

• /donate：捐赠给机器人创建者。

• /markdownhelp：有关如何在机器人中使用 markdown 的信息

Notes 笔记

保存数据

• /get <notename> ：获取注释。

• /save <word> <note text>：保存一个名为“word”的新笔记。 回复消息将保存该消息到“word”这个笔记内,支持保存媒体文件。

• /clear <notename>：删除相关的笔记。

• /notes：列出当前聊天中的所有笔记。

• /saved：与 /notes 相同。
  ex:

  • /save test This is a fancy note!
  • /save note This is a note [With a button](buttonurl://#anothernote) 通过notebuttons链接笔记。
  • /save example This note will only be opened by admins {admin}管理员专用注释：
  • /save example This note cant be forwarded {protect}无法转发的“受保护”便笺：
  • /save test This is a note that always goes to PM {private}
  • `/save test This is a note that always goes to groups {noprivate}
• /clearall：删除聊天中的所有笔记。 这不能被撤消。

• /privatenotes：是否在私聊中发送笔记。 将发送带有按钮的消息，用户可以单击该按钮以在私聊中获取笔记。

• /privatenotes on

Pin 置顶

• /pinned：获取当前置顶的消息。

• /pin：置顶您回复的消息。 向群组成员发送通知。

• /permapin <text>：通过机器人置顶自定义消息。 此消息可以包含降价、按钮和所有其他很酷的功能。

• /unpin：取消置顶当前置顶的消息。 如果用作回复，则取消置顶回复的消息。

• /unpinall：取消置顶所有置顶的消息。

• /antichannelpin <yes/no/on/off>：不要让电报自动置顶链接频道的消息。 如果没有给出参数，则显示当前设置。

• /cleanlinked <yes/no/on/off>：删除链接频道发送的消息。

Purges 清除消息

可以删除大量消息

• /purge：删除你所回复的消息 到 你发出这个命令这个时刻，之间的全部消息。

• /purge <X>：在回复消息后删除以下 X 消息。

• /spurge：与清除相同，但不发送最终确认消息。

• /del：删除回复的消息。

• /purgefrom 与 /purgeto ：区间删除，删除两个命令之间的全部消息

  • /purgefrom：标记要清除的第一条消息
  • /purgeto ：标记要清除的最后一条消息

Reports 群员举报

• /reports <yes/no/on/off>：启用/禁用用户报告。

• /report：回复消息以报告它以供管理员查看。

Rules 设置群规

• 群友命令

  • /rules：查看当前的聊天规则。
• 管理员命令：
  • /setrules <文本>：设置此聊天的规则。 支持markdown、按钮、填充等。

  • /privaterules <yes/no/on/off>：启用/禁用规则是否应私下发送。

  • /resetrules：将聊天规则重置为默认值。

  • /setrulesbutton：使用 {rules} 时设置规则按钮名称。

  • /resetrulesbutton：将规则按钮名称从 {rules} 重置为默认值。

Warnings 警告

• /warn原因：警告用户。

• /dwarn 原因：通过回复警告用户，并删除他们的消息。

• /swarn 原因：悄悄警告用户，并删除您的消息。

• /warns：查看用户的警告。

• /rmwarn：删除用户的最新警告。

• /resetwarn：将用户的所有警告重置为 0。

• /resetallwarns：删除聊天中的所有警告。 所有用户返回 0 警告。

• /warnings：获取聊天的警告设置。

• /warnmode <ban/mute/kick/tban/tmute>：查看或设置聊天的警告模式。

• /warnlimit <number>：查看或设置用户受到惩罚前的警告次数。

• /warntime <时间>：查看或设置警告应该持续多长时间。 时间值示例：4m = 4 分钟，3h = 3 小时，6d = 6 天，5w = 5 周。

---

参考资料：Rose 命令大全及其技巧