diff --git a/book.xml b/book.xml index 4dfc0ee..5af37ed 100644 --- a/book.xml +++ b/book.xml @@ -8,5 +8,9 @@ + + + + diff --git a/executor/admin-msg-send.md b/executor/admin-msg-send.md new file mode 100644 index 0000000..706db0e --- /dev/null +++ b/executor/admin-msg-send.md @@ -0,0 +1,65 @@ +# morny 操作工具: 消息发送器 + + + +**此工具仅限 [可信成员](../trusted) 使用** +这是一个管理类工具,同时它可能会对其它 morny 使用者产生骚扰 +这个工具的产生是为了测试使用和内部的特殊用途 +因此,这个工具并不开放对所有使用者使用 + + + +通过在私聊中使用 __`*msg` 工具__,可以控制 coeur 向任意(morny 有权限发送消息的)对象发送消息。 + +目前还仅支持文本消息的发送(但是也是支持富文本的)。 + +其通过以下的步骤使用: + +## 定义消息发送资讯 + +**在私聊中**,使用一条以 `*msg` 开头的消息来**定义**一个要发送的消息和相关咨询,这条以 `*msg` 开头的消息称之为一条 *定义*。 + +在定义中,第一行是消息发送资讯的元数据,包含它要发送的对象也可以添加一些特殊选项。从第二行开始,则是要发送的消息体,这一部分将会最终被 coeur 以 morny 身份发送给定义的对象。 + +发送出这条消息并**不会实际执行发送**,而是 morny 会输出这条定义的相关资讯可以让操作者进行检查。所以,你也可以反复使用定义来检查与调整自己想要发送的信息。 + +### 定义发送目标 + +在定义行使用 \*msgtarget_id 格式,target_id 可以是群组,用户,或者频道的 id——但是需要遵循 telegram bot api 规范,同时,依据 api 规范也只能使用 morny 有权限访问的对象。 + +发送目标是必须的,如果一条定义消息不填入发送目标,那么它将会解析失败,最终返回 404。 + +### 使用富文本 + +对于富文本,**morny 原生支援消息内容中的原生富文本格式**。在定义中的消息体部分的原生富文本格式将能够被保留以及按照原样被发送出去。 + +不过 \*msg 工具也支援使用纯文本+文本格式的方式来使用富文本:第一行 \*msgtarget_id 后面可以添加参数来使用受 telegram api 支援的解析格式,例如 \*msgtarget_id\*html:这将会把要发送的消息*文本*使用 telegram 的 HTML 解析器解析为富文本格式。 + +目前支持的解析器有详情还请参阅 [telegram ParseMode 文档][tg-parse]: + +- markdown md m↓ [telegram MarkdownV2][tg-md2]: 更加接近于真实的 markdown 使用,同时也有相当多的转义需要 +- md1 [telegram markdown v1/classic][tg-md]: 一种相当简单的 markdown 格式,虽然功能欠缺很多,不过相比 v2 使用会简单很多 +- html [telegram html][tg-html]: 基于 html 语法,除了语句繁琐之外,只需要注意很少的转义就能写出很复杂的格式 + +[tg-parse]: https://core.telegram.org/bots/api#formatting-options +[tg-md2]: https://core.telegram.org/bots/api#markdownv2-style +[tg-md]: https://core.telegram.org/bots/api#html-style +[tg-html]: https://core.telegram.org/bots/api#markdownv-style + +解析器和原生富文本格式能够同时作用。虽然最好还是只使用其中一种,两种不同的富文本格式加和在一起或许会产生难以猜测的行为——无论如何,这会在 telegram api 内部决定。 + +### bot 的回执 + +**// TODO** + +### 重新检查一个已有的消息发送资讯 + +在和 morny 的私聊中,如果已经有了一个消息发送资讯,直接对那条定义消息回复单字 `*msg`,即可让 morny 重新进行一遍定义检查并返回回执。 + +## 执行发送 + +**向刚刚定义好了的 `*msg` 消息发送资讯定义回复 `*msgsend`**(不是向 bot 的回执发送而是向你自己的以 `*msg` 开头的那条消息发送),即可正式让 coeur 发送这个定义所定义的消息。 + +如果成功,将会回复一个发送成功的信号。 + +如果失败,将会返回在 telegram api 中发送失败的相关信息。 diff --git a/note-todo.md b/note-todo.md new file mode 100644 index 0000000..3621f09 --- /dev/null +++ b/note-todo.md @@ -0,0 +1,19 @@ +# Todo - 这本书中还没有写完的众多部分 + +出于这本书确实还在起步阶段尽力的更新 —— morny 发展到现在虽然谈不上很厉害不过也确实不能说是几个页面就能应付的程度了。 + +所以,目前这里只列举出了,建立好了文件但还没写 / 一个文件或是一个章节里大部分都写了但是还差了的那一点 / 写着写着出了什么问题但还没来得及完善,的这些部分。 + +~~朝着 Congratulations 努力吧!~~ + +## [inline/overview](./inline/overview) "关于内联查询" + +整个页面都还没写。 + +应该要写一些关于“内联查询”这个东西的特性的说明,以及 morny 如何将很多很多的内联查询功能糅合在一起的简单介绍之类。 + +## [executor/admin-msg-send](./executor/admin-msg-send) "消息发送器" + +**"bot 的回执"** 那一部分还没写。 + +整个页面可能需要重新考虑,一部分写的很简陋,有机会的话考虑重新思考如何排版说明。