morny-book/command/encrypt.md

80 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# /encrypt
> > `<algorithm> [(uppercase)]` <u><i>reply_to(text)</i></u> | `[l]`
>
> 通过指定算法加密回复的内容 (目前只支持文本)
通过此命令Morny 可以返回一个信息的加密(或解密)后数据。
## usage - 用法
通过使用 `/encrypt <algorithm>` 回复一条消息Morny 即会返回这条消息通过这个算法处理后的结果。
![an example shows how to encrypt a text message](./encrypt-exapmle.png)
<small>一个使用 base64 加密处理一段文字的例子
你可以从[这里](./encrypt-example)找到例子中返回的 base64 文本,来自己尝试解密
</small>
如果是文本消息,则 Morny 会对其中的文本进行处理,然后同样的以文本消息的方式返回通过指定算法加密后的字符串消息。注意**文本消息中的格式会被忽略**
如果是图片或是文件等消息Morny 将会**处理这个消息中的第一个图片/文件**并返回它作为二进制文件通过指定算法后加密的消息字符串。要注意的是Telegram 的一个消息内可能包含多个图片或文件,但 Morny 只能处理第一个!同时,图片或文件消息所附带的文字也会被忽略。
处理文件有两种返回方式:如果是杂凑算法,则会和文本消息一样返回一个文本消息;如果是普通的加密算法,则会返回一个包含加密后信息的文件。
![the /encrypt output the text while using md5, but output a file while using b64](./encrypt-file-out.png)
### algorithms - 支持的算法
<style>
.m {
font-weight: bold;
text-decoration: underline;
}
.a::marker {
color: crimson;
}
.a_u {
color: crimson;
opacity: 0.5;
}
</style>
Morny 目前支持以下算法:
> 每行中的加重显示的名称是算法的全名,其余是这个算法的别称
> 以<span class=a_u>猩红色</span>标识开头的算法是支持使用 [`uppercase`](#uppercase) 参数的杂凑算法
- `base64`{.m}, `b64`
- `base64url`{.m}, `base64u`, `b64u`
- `base64decode`{.m}, `base64d`, `b64d`
- `base64url-decode`{.m}, `base64ud`, `b64ud`
- {.a}`sha1`{.m}
- {.a}`sha256`{.m}
- {.a}`sha512`{.m}
- {.a}`md5`{.m}
你也可以通过对 Morny 使用 `/encrypt l`<small>或者简单是 `/encrypt`</small>来得到这个列表。
### 加密参数
`/encrypt` 命令可以通过加密参数控制如何进行加密过程或是输出加密信息。加密参数应以空格分隔,附加在算法参数的后面,像是 `/encrypt <algo> [param1] [param2]...`
目前仅只持了 [`uppercase`](#uppercase) 加密参数。
#### `uppercase`
> also known as `upper`
> also known as `u`
这个参数使得 Morny 在返回杂凑值的时候使用大写字母书写十六进制数字。
只能用于杂凑算法。
---
## known issue
这个版本虽然在简介里说了 *「目前只支持文本」*,然而它确实的支持了对文件和图片进行处理。
最开始的初版确实是不支持的,不过后来加上了简单的支持后忘记把这句话移掉了。尽管这么说,对于文件的处理(由于 API 复杂性)确实并不能让人满意或是放心。所以如果你遇到了什么问题,还是来积极报告一下以让这个功能更加稳定好用。