Telegram @DrillsonBot 说明书

欢迎在任何地方使用本 Bot.
Telegram 链接: https://t.me/DrillsonBot

这篇文章最后更新于 2020 年 4 月 30 日.

@DrillsonBot 仍处于开发阶段, 本说明书随时更新, 也有滞后、错误的可能性.
如果出现消息无反应的情况, 请稍后重试.
欢迎任何的意见、建议、新功能提议.

使用者或使用群组的任何言论、内容或行为均与本 Bot 无关。

文档中, 尖括号 <> 代表不可省略的参数, 方括号 [] 代表可省略的参数. 使用时, 不需要加这两种括号.

多数情况下, 机器人将在群组中采用回复的方式响应用户的命令, 而在私聊中采用直接发送消息的方式.

某些指令为私有, 本文未涉及.

平凡指令集

指令一览:

/laolee 与 /doge

该指令不需要任何参数.

/laolee 将以图片的方式发送一张老李的表情包, 而 /doge 则可获取一只 Doge.

/calc

/calc <math expression>

功能还行的计算器. 支持:

• 运算符: +, -, *, /, //(整除), %(模), **(幂)
• 位运算: <<, >>, |, &, ~, ^(异或)
• 常量: pi, e
• 初等函数
  • 绝对值: abs
  • 平方根: sqrt
  • e 的指数: exp
  • 对数: log(a,b) 表示以 b 为底数时 a 的对数. 当不给出 b 时, 默认 b=e.
  • 角函数: sin, cos, tan, asin, acos, atan
  • 双曲函数: sinh, cosh, tanh, asinh, acosh, atanh
• 非初等函数
  • 误差函数: erf
  • 伽玛函数: gamma
• 其它函数
  • 最大公因数: gcd(a,b)
  • 角度转弧度: rad
  • 弧度转角度: deg

其中运算符优先级与 Python 相同, 请参考这里.

如果回复了一条仅含一个数字的消息, 便可以在表达式中使用ans来指示之, 便于一系列的计算.

默认角的单位是弧度, 如需要角度制请用函数来转换.

/iconsticker

/iconsticker <chars>

别名: /is

获得一张以一些著名图标构成的贴纸, 就像下面这个一样:

字母 hjkruz 暂缺.

/smms

该指令不需要任何参数, 但是需要回复一条含图片的消息.

将被回复的消息中的图片上传到 sm.ms 图床, 并返回直链与页面.

使用 sm.ms 的 api, 可能会受其限制.

处理中需要先下载图片到运行 Bot 的服务器上. 我无法保证其存储的安全性.

/shorturl

/shorturl [url]

将链接通过自建的 ibd.ink 短链接服务缩短. 这个链接可以来自命令的参数 (优先), 也可以来自一条被回复的消息.

如果该链接已经被缩短过, 将正常地返回此前已缩短后的链接, 而不会导致重复或错误.

/latex

/latex <latex expression>

以图像的方式返回渲染后的 LaTeX 表达式.

使用了 CodeCogs 的 API.

/getfile (/addfile, /delfile)

/getfile <pattern>

根据 pattern 在文件库中搜索文件. 如果有多个匹配结果, 将给出一个选择键盘. 如果只有一个结果或者全名匹配, 将直接返回此文件.

这个功能利用了 Telegram 永久保存消息的特性, Bot 只记录文件的 id 而无需保存文件.

功能正在开发中. 目前文件库的内容很少且都由我预设, /addfile 和 /delfile 也都仅限开发者使用. 未来可能开放, 每个用户有独立的文件库, 可以自行完成添加和删除.

要求文件名中必须含有后缀名. 所以使用 /getfile . 可以列出所有的文件.

/echo

/echo <expression in HTML format>

Bot 会发送以 HTML 格式解析的内容. 如果内容中没有 HTML 标签, 返回的消息将没有特殊格式.

Bot 对该命令的响应不以回复的形式, 而是直接发送.

/feedback

该指令不需要任何参数, 但需要回复一条消息.

Bot 将转发被回复的消息给开发者.

开发用指令集

/id

该指令不需要任何参数.

获取本条消息, 以及被回复的消息 (如果有) 的 id、聊天 id、用户 id，以及其中包含的图片、文档、音频、动画、贴纸、视频、语音、视频留言 (如果有) 的 id.

可用于 bot 开发. 消息没有隔壁的小霾全面, 但她好像不认图片 (message.photo), 所以才自己写了个.

/getdocumentbyid

/getdocumentbyid <file_id>

通过 file_id 来发送文件. 文件类型必须是 Telegram.Document.

Inline Mode – 行间模式

在任何聊天中, 于消息编辑框中输入

@DrillsonBot

就可以进行搜索, 并直接发送搜索结果.

目前搜索的范围是 /getfile 的文件库. 将来可能会添加如表情包、动画表情等内容.