机器人使用方法

这里我会对机器人在 Telegram 中使用的方法进行说明:

也可以直接对机器人发送 /help 指令来查看你能执行的指令(不同权限的用户获得的指令列表会有所差异)

公共指令

这里的指令所有人都能调用:

/help

获取帮助菜单

/id

回复一个用户来查询 TA 的 Telegram 用户信息,包括 id、数据中心、语言信息等等

/version

查询机器人版本信息和编译序列号

/reportall <订阅ID>

获取某个订阅的在线/掉线节点列表。

⚠️ 注意:请先对订阅设置计划任务(/cron)后再使用该指令,因为它会获取最近一次测试的结果。如果不设置计划任务,则 /reportall 的结果将没有参考价值(因为它你上次测试它很可能在几天甚至几个月以前)。

/reportonline <订阅ID>

同上,只是它只会返回在线的节点

/reportoffline <订阅ID>

同上,只是它只会返回掉线的节点

/stats <订阅ID>

它与 /reportall 类似,但是,它不止返回最近一次的测试结果,而是会生成一个节点稳定性的折线图。(它会读取[默认]近 120 此的测试数据并绘制图表,因此,如果没有设置计划任务(/cron),该指令不会被允许调用。)

计划任务类指令

计划任务指令只能由管理、超级管理调用。

/cron <订阅ID> <Cron表达式?>

为某个订阅设置计划任务,例如:每2分钟测试一次 mycloud 并写入历史记录:

/cron mycloud @every 2m

你也可以不加表达式来查询某个订阅的计划任务配置:

/cron mycloud

返回:
✔ 当前配置: @every 2m
下次执行: 2022-03-20T23:57:32Z
...

/register <订阅ID> <私密等级?>

既然设置了计划任务,当节点掉线/恢复时,MiaoKo 就能提醒你。在需要 MiaoKo 提醒的群发送这个指令就能设置掉线提醒。但如果这个群是公开群,你不想泄露掉线提醒中的 ip / 域名信息,就可以单独配置私密等级。默认的等级是 0,意味着隐藏 2 级域名:"www.*.com"。如果没有你设置了 1,则会显示: "*.*.com" 以此类推。如果你设置了 -1,则会取消私密展示:"www.mycloud.com"。

/registered

查询当前群注册的所有消息提示

/notify <订阅ID>

/registered 类似,但是从另一个纬度:这条指令查询的是某个订阅在哪些群被订阅了。

/unregister <订阅ID> <群组ID?>

取消一个群中某个订阅的掉线提醒。如果不加群组 ID,则会取消当前群的掉线提醒。

/mute <订阅ID> <持续时间(秒)>

如果你正在调试节点,导致节点频繁掉线,掉线提醒炸群。但你又不想 /unregister 所有关联的群。你可以用 /mute 把某个订阅的掉线提醒暂时关闭(但需要注意的是,/cron 并没有被暂停,它的掉线历史依然会被记录)。

7大金刚

不过在详细了解每个指令前,需要先约定几个表达方式:

<正则表达式>: 指 Regular Expression,是编程中常用的字符串查询方法。例如:香港|日本 代表所有包含香港或者日本的节点。由于 MiaoKo 的所有输入不识别空格,你可以通过这种方式过滤带有空格的节点:美国\s0[0-6] 代表 美国 01 - 美国 06

</cmd:A=B>: 这是 MiaoKo 特有的附加参数。可以拓展这次测试的信息。例如,你想用在后端ID为 guangzhou 的机器上运行美国节点的测速,你可以这样写:

/speed:slave=guangzhou mycloud 美国

⚠️ 注意,:A=B 指令一定是紧贴着命令的(不能有空格)。

所有金刚都支持 :A=B 指令,目前支持的指令为:

  • :slave=<后端ID> 指定后端进行测试
  • :slavegroup=<后端组别ID> 指定后端组进行负载均衡测试
  • :slavejoint=<后端组别ID> 指定后端组进行多后端联测
  • :sort=name|ping|avgspeed|maxspeed|original

/test<:A=B> <订阅ID> <正则表达式>

测试一个已经被 /new 新增过的订阅的联通性和流媒体。

/testurl<:A=B> <订阅链接?> <正则表达式>

临时测试一个订阅链接的联通性和流媒体。例如:

/testurl https://mycloud.com/clash/ewerioweoi3 美国

当然,如果你配置了 $CONFIG.subconverter,你也可以测试这种单节点链接:

/testurl vmess://aoewioiwaeu02i9i23e== 美国

在 3.0.1 版本以上,你甚至可以回复一条消息 /testurl<:A=B> <正则表达式> 来测试消息中的订阅链接。

/speed<:A=B> <订阅ID> <正则表达式>

测速,用法同 /test

/speedurl<:A=B> <订阅链接?> <正则表达式>

测速,用法同 /testurl

/analyze<:A=B> <订阅ID>

测速,用法同 /test,但不能传正则表达式来过滤节点。

/analyzeurl<:A=B> <订阅链接?>

测速,用法同 /testurl,但不能传正则表达式来过滤节点。

/invite<:A=B>

回复一个用户来邀请他进行一次 /testurl /speedurl/analyzeurl。如果邀请人是超级管理,则还可以邀请对方 /new。所有交互过程都在私聊中,因此不用担心订阅外泄。

最后修改:2022 年 05 月 23 日
如果觉得我的文章对你有用,请随意赞赏