add 版本名称一览

book.xml

@@ -1,29 +1,71 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<Book id="morny" name="Morny Cono 使用手册" >
+<Book
-	<Page id="main" name="Morny Cono 使用手册" />
+		xmlns="https://book.sukazyo.cc/"
-	<Chapter name="command - 命令">
+		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-		<Page id="command/overview" name="Overview - 速查表" />
+		xsi:schemaLocation="
-		<Page id="command/on" name="/o" />
+		https://book.sukazyo.cc/ ../../assets/xsd/book.xsd
-		<Page id="command/hello" name="/hello /hi &lt;small&gt;/start&lt;/small&gt;" />
+		"
-		<Page id="command/user" name="/user" />
+		
-		<Page id="command/nbnhhsh" name="/nbnhhsh &lt;small&gt;能不能好好说话？&lt;/small&gt;" />
+		version="2.0"
-		<Page id="command/186-ip-whois" name="&lt;small&gt;/ip /whois&lt;/small&gt;" />
+>
-		<Page id="command/encrypt" name="/encrypt" />
+	
-		<Page id="command/info" name="/info" />
+	<book_name>Morny Cono 使用手册</book_name>
+	
+	<contents>
+		
+		<Page id="main">Morny Cono 使用手册</Page>
+		<Page id="version-tag-histories">版本名称一览</Page>
+		
+		<Separator/>
+		
+		<Title>Morny 功能</Title>
+		<Chapter root="command/">
+			<caption>command - 命令</caption>
+			<Page id="overview">Overview - 速查表</Page>
+			<Page id="on">/o</Page>
+			<Page id="hello"><![CDATA[/hello /hi <small>/start</small>]]></Page>
+			<Page id="user">/user</Page>
+			<Page id="nbnhhsh"><![CDATA[/nbnhhsh <small>能不能好好说话？</small>]]></Page>
+			<Page id="186-ip-whois"><![CDATA[<small>/ip /whois</small>]]></Page>
+			<Page id="encrypt">/encrypt</Page>
+			<Page id="info">/info</Page>
+			<Page id="save">/save</Page>
+			<Page id="exit">/exit</Page>
 		</Chapter>
-	<Chapter name="inline - 内联查询">
+		<Chapter root="inline/">
-		<Page id="inline/overview" name="@inline_query 内联查询简介" />
+			<caption>inline - 内联查询</caption>
-		<Page id="inline/share-twitter" name="Twitter 分享链接格式化" />
+			<Page id="overview">@inline_query 内联查询简介</Page>
-		<Page id="inline/share-bili" name="Bilibili AV/BV 视频分享" />
+			<Page id="raw-text"><![CDATA[RAW TEXT <small>(原始文本)</small>]]></Page>
+			<Page id="share-twitter">Twitter 分享链接格式化</Page>
+			<Page id="share-bili">Bilibili AV/BV 视频分享</Page>
 		</Chapter>
-	<Page id="sp/slash" name="/$slash" />
+		<Page id="sp/slash">/$slash</Page>
-	<Chapter name="特别工具">
+		<Chapter>
-		<Page id="executor/call-me" name="呼叫 Morny 的主人" />
+			<caption>特别工具</caption>
-		<Page id="executor/admin-msg-send" name="controlling: 消息发送器" />
+			<Page id="executor/call-me">呼叫 Morny 的主人</Page>
+			<Page id="executor/admin-msg-send">controlling: 消息发送器</Page>
 		</Chapter>
-	<Page id="trusted" name="可信成员" />
+		<Chapter>
-	<Page id="note-todo" name="note::本说明书进度，以及待修整的部分" />
+			<caption><![CDATA[<small><s>已遭弃用的功能</s></small>]]></caption>
-	<Chapter name="&lt;small&gt;资料库&lt;/small&gt;">
+			<Page id="sp/kuohuanhuan-need-sleep"><![CDATA[<s>KuoHuanHuan 该睡觉了</s>]]></Page>
-		<Page id="command/encrypt-example" name="command/encrypt-example.png" />
+			<Page id="command/jrrp">/jrrp</Page>
 		</Chapter>
+		
+		<Title>Morny 系统概念</Title>
+		<Page id="trusted">可信成员</Page>
+		
+		<Separator/>
+		
+		<Title>杂项</Title>
+		<Page id="note-todo">note::本说明书进度，以及待修整的部分</Page>
+		
+		<!-- <Separator/> -->
+		
+<!--		<Chapter>-->
+<!--			<caption><![CDATA[<small>资料库</small>]]></caption>-->
+<!--			<Page id="command/encrypt-example">command/encrypt-example.png</Page>-->
+<!--		</Chapter>-->
+		
+	</contents>
+	
 </Book>

command/encrypt-example.md

@@ -1,4 +1,6 @@
-# command/encrypt-example.png
+---
+title: command/encrypt-example.png
+---
 
 ![an example shows how to encrypt a text message](./encrypt-exapmle.png)  
 <small>an example shows how to encrypt a text message</small>

command/exit.md

@@ -0,0 +1,51 @@
+---
+title: "/exit"
+---
+
+<style>
+@import "../stickers.css"
+</style>
+
+
+> also known as `/quit`  
+> also known as `/stop`
+
+<font color=palevioletred>
+
+**此工具仅限 [可信成员](../trusted) 使用**  
+这是一个管理类工具，它拥有操作 Morny Cono 底层并可以破坏其运行稳定性的能力
+
+</font>
+
+这个命令可以让你关闭正在运行的这个 Morny Cono。
+
+## usage
+
+执行 `/exit`命令，然后你就会看到下面的贴纸：
+
+{.sticker}
+![ID_EXIT](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMoYYYWt8UjvP0N405SAyvg2SQZmokAAkMiAAJ4_MYFw6yZLu06b-MiBA.png)
+
+这样子，Morny Cono 就已收到关闭指令并已退出运行。
+
+### 权限不足
+
+如果权限不足的话，你将会看到下面的贴纸：
+
+{.sticker}
+![ID_403](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMqYYYa_7hpXH6hMOYMX4Nh8AVYd74AAnQnAAJ4_MYFRdmmsQKLDZgiBA.png)
+
+在这种情况下，Morny 将<small>显然是</small>不会遵循你的关闭指令。
+
+## Log 记录
+
+出于退出命令是影响 Morny 运行的重要指令，所以，在设计上，不论是成功退出还是由于权限不足被拒绝，每次执行退出指令都将会产生一行等级为 `INFO` 的 log。log 将会记录下你的 Telegram userid（如果没有的话则是用户姓名全名）和 Telegram 用户内部 uid。<small>所以不要乱玩哦<s>[@Eyre_S] 在看着你</s></small>
+
+[@Eyre_S]: https://t.me/Eyre_S
+
+像是下面这样：
+
+```log
+[INFO] 403 exited tag from user qwq [676559089]
+[INFO] Morny exited by user @Eyre_S[793274677]
+```

command/jrrp.md

@@ -0,0 +1,11 @@
+# /jrrp
+
+> 获取 (假的) jrrp
+
+这是一个对 *某个游戏* 的 *某个爱好者制作的 Launcher* 中的其中一个彩蛋功能的拙劣模仿。
+
+由于 Morny 的主人已经和这个功能的灵感来源断绝联系了，所以这个功能本身也不再维护了。理所当然的，Morny 的主人也不想给这个功能写说明了。
+
+---
+
+不过这个命令本身仍然可以运作。

command/on.md

@@ -3,9 +3,7 @@
 > **检查是否在线**
 
 <style>
-	.sticker {
+@import "../stickers.css"
-		width: 20rem;
-	}
 </style>
 
 ## usage - 用法

command/overview.md

@@ -80,7 +80,7 @@
 </tr>
 
 <tr>
-<td><b><code>/jrrp</code></b></td>
+<td><b><a href="./jrrp"><code>/jrrp</code></a></b></td>
 <td></td>
 <td>获取 (假的) jrrp</td>
 </tr>
@@ -106,13 +106,13 @@
 </thead>
 
 <tr>
-<td><b><code>/save</code></b></td>
+<td><b><a href="./save"><code>/save</code></a></b></td>
 <td></td>
 <td>保存缓存数据到文件（仅<a href="../trusted">可信成员</a>）</td>
 </tr>
 
 <tr>
-<td><b><code>/exit</code></b></td>
+<td><b><a href="./exit"><code>/exit</code></a></b></td>
 <td></td>
 <td>关闭 Bot（仅<a href="../trusted">可信成员</a>）</td>
 </tr>
@@ -192,11 +192,11 @@
 </tr>
 
 <tr>
-<td><b><code>/quit</code></b></td>
+<td><b><a href="./exit"><code>/quit</code></a></b></td>
 <td rowspan=2>仅仅是<s>人性化设计的</s> <code>/exit</code> 的匿名别名。</td>
 </tr>
 <tr>
-<td><b><code>/stop</code></b></td>
+<td><b><a href="./exit"><code>/stop</code></a></b></td>
 </tr>
 
 <tr>
@@ -205,7 +205,7 @@
 </tr>
 
 <tr>
-<td><b><code>/test</code></b></td>
+<td><b><a href="./test"><code>/test</code></a></b></td>
 <td>为了测试时候方便的一个占位命令。发行版本中并不会实现任何功能，目前来说它的效果就只是会回复一句：<br/><b>Just</b> a TEST command.</td>
 </tr>
 

command/save.md

@@ -0,0 +1,33 @@
+# /save 
+
+> 保存缓存数据到文件（仅[可信成员](../trusted)）
+
+<style>
+@import "../stickers.css";
+</style>
+
+<font color=palevioletred>
+
+**此工具仅限 [可信成员](../trusted) 使用**  
+这是一个管理类工具，它拥有操作 Morny Cono 的内部 API 的功能并导致服务器资源过载的可能
+
+</font>
+
+这个命令可以让所有的 *需要使用数据持久化的服务功能* 立即和磁盘同步数据。
+
+当保存任务执行成功后，它将会返回贴纸 `ID_SAVED`：
+
+{.sticker}
+![morny sticker ID_SAVED](https://stickers.sukazyo.cc/sticker/CAACAgEAAx0CSQh32gABBExuYdB_G0srfhQldRWkBYxWzCOv4-IAApooAAJ4_MYFcjuNZszfQcQjBA.png)
+
+当失败时命令将会不反回任何东西。
+
+不过目前 Morny 并没有任何的服务使用到了数据持久化功能。所以，这个命令可以被认为是除了返回一个贴纸以外没有用途的。
+
+## Log 记录
+
+作为一个管理类命令，它也拥有和 [`/exit`](./exit) 差不多的 Log 记录。不过不同的是 **`/save`** 只会在当用户没有权限时记录一条 log，当用户有权限执行时将不会特定的对这个操作记录 log：
+
+```log
+[INFO] 403 call save tag from user qwq [676559089]
+```

command/test.md

@@ -0,0 +1,10 @@
+# /test
+
+> 为了测试时候方便的一个占位命令。发行版本中并不会实现任何功能，目前来说它的效果就只是会回复一句：  
+> <pre><code><b>Just</b> a TEST command.</code></pre>
+
+一个用于进行本地开发的占位符命令。
+
+这个命令相当于一个槽位，可以在开发调试的时候通过变更这个命令的代码，来方便的监视/测试 Coeur 的内部状态。这样的功能仅在本地开发生效，理论上不会（不应该）被提交到发行版本当中。
+
+为了让这个命令不只是一个空函数<small>以及弄点奇怪的东西比较有趣</small>，在发行版本中，回复一条 <code><b>Just</b> a TEST command.</code> 被设置为了这个命令的缺省行为。

executor/call-me.md

@@ -3,9 +3,7 @@
 [主人]: ../main#morny-的主人
 
 <style>
-	.sticker {
+@import "../stickers.css"
-		width: 20rem;
-	}
 </style>
 
 简单来说，借助这个工具，你可以通过 **Morny** 来向[主人]发送消息::

inline/raw-text.md

@@ -0,0 +1,49 @@
+# RAW TEXT
+
+一个内联查询，你输入什么，它就输出什么。
+
+你输入`什么`。
+
+它就输出
+
+![“什么” sent by @morny](./raw-text-example.png)
+
+## 一些已知的限制
+
+**RAW TEXT 无法通过 morny 发送图片或者文件等媒体。**
+
+因为 Telegram Bot API 的限制，在发送媒体文件的情况下无法进行内联查询。其实 Bot API 的内联查询字段也没有设计有媒体输入的字段。内联查询只能输入纯文本。
+
+**RAW TEXT 无法通过 morny 发送贴纸。**
+
+和上面的同理。
+
+你甚至不能为一个贴纸消息附加任何文本。
+
+不过我们预计会解决这个问题。这可能通过一个其它的内联查询来实现：可以通过向内联查询输入一个 sticker id 来发送贴纸。
+
+**RAW TEXT 无法发送富文本。**
+
+**RAW TEXT 输入任何的富文本格式都会丢失格式信息。**
+
+因为 Telegram Bot API 的限制。
+
+> 内联查询只能输入纯文本。
+
+Telegram Bot API 中的内联查询只能得到用户输入的纯文本格式的输入信息。任何格式信息在 Telegram 的服务器已经被丢弃。显然无论如何，我们也无法获取得到上游已经丢弃掉的信息。
+
+由于另外一些 API 问题，由用户以纯文本格式输入一些 markdown 文本或是 HTML 文本也十分不稳定。<small>这个在 [*msg 工具](../executor/admin-msg-send) 上面确实[有实现](../executor/admin-msg-send#使用富文本)。在那个情况下实现这个功能十分的简单稳定。但是在内联查询的情况下却变得大不一样。</small>
+
+因此，RAW TEXT 无法实现富文本发送。
+
+---
+
+## technic infomation
+
+<table>
+<thead><tr><th colspan=2>inline query node info</th></tr></thead>
+<tr><td align=right><b>title</b></td><td>Raw Text</td></tr>
+<tr><td align=right><b>id</b></td><td><code>[morny/r/text]</code></td></tr>
+<tr><td align=right><b>cache</b></td><td><u>default<small><code>300</code></small></u></td></tr>
+<tr><td align=right><b>is_personal</b></td><td><u>default<small><code>false</code></small></u></td></tr>
+</table>

main.json

@@ -0,0 +1,4 @@
+{
+	"target_version": "1.0.0-RC3.4*BEIPING+git.031a7990",
+	"target_branch": "dev"
+}

main.md

@@ -1,5 +1,9 @@
 # ~~给所有喜欢morny的大家的~~ Morny Coeur 使用手册
 
+<style>
+@import "./stickers.css"
+</style>
+
 
 <div align="center" markdown="1">
 
@@ -32,13 +36,6 @@
 
 ---
 
-<style>
-	.sticker {
-		width: 20rem;
-	}
-</style>
-
-
 这是 **[Morny Coeur] / [Morny Cono]** 的**使用手册**。
 
 **Monry** Cono 是一个使用 Morny **Coeur** 作为其核心的 **Telegram 机器人**。

morny-backnote.md

@@ -0,0 +1,5 @@
+# 后记 - 纪念碑 - 谷
+
+Morny 到现在<small>（到本文撰写的时间，大概已经是2023年2月13日）</small>，已经走过了一的年份。已经走过了 100 多个 commit，甚至可能以此架构出了自己的设计理念。
+
+大概早已经没有人知道 Morny 最开始是专门为了记录某个人的上线活跃时间而写的 bot，这个功能甚至直到安妮已经不再需要它的时候，它都还没有写完。它留在了代码里，作为 `@Deprecated` 的形式。

note-todo.md

@@ -10,9 +10,9 @@
 
 <div style="font-family: system-emoji">
 
-🟪🟪🟪⬜🟪🟪🟪🟪⬜⬜ ⬜⬜ ⬜⬜  
+🟪🟪🟪⬜🟪🟪🟪🟪🟪⬛️ ⬜🟪 🟪🟪  
-⬜⬜🟩🟩  
+⬜🟩🟩🟩  
-🟧⬜⬜🟧🟧⬜⬜⬜  
+🟧⬜⬜🟧🟧⬜🟧⬜  
 🟦⬜⬜  
 <small>⬜⬜</small>
 
@@ -29,19 +29,19 @@
   - [x] ~~`/ip` `/whois`~~
   - [x] ~~`/encrypt`~~
   - [x] ~~`/info` <small><code>/version</code> <code>/runtime</code></small>~~
-  - [ ] `/jrrp`
+  - [x] ~~`/jrrp`~~
-  - [ ] `/install`
+  - ~~`/install`~~
 - 管理员命令
-  - [ ] `/save`
+  - [x] ~~`/save`~~
-  - [ ] `/exit` <small><code>/stop</code> <code>/quit</code></small>
+  - [x] ~~`/exit` <small><code>/stop</code> <code>/quit</code></small>~~
 - 单独功能的额外命令
   - [ ] `/r`
-  - [ ] `/test`
+  - [x] ~~`/test`~~
 
 **内联查询功能**
 
 - [ ] My Information
-- [ ] Raw Text
+- [x] ~~Raw Text~~
 - [x] ~~ShareTool: Bilibili~~
 - [x] ~~ShareTool: Twitter~~
 
@@ -53,7 +53,7 @@
 - [x] ~~call tool~~
 - [x] ~~(给管理员用的)消息发送器~~
 - [ ] *tracker*
-- [ ] *KuoHuanHuan 需要睡觉了*
+- [x] ~~*KuoHuanHuan 需要睡觉了*~~
 - [ ] *Meow~*
 
 **系统功能**
@@ -85,6 +85,10 @@
 
 整个页面可能需要重新考虑，一部分写的很简陋，有机会的话考虑重新思考如何排版说明。
 
+### [kuohuanhuan-need-sleep/future-plan](./sp/kuohuanhuan-need-sleep) "睡觉提醒的未来计划"
+
+**KuoHuanHuan 需要睡觉了** 这个功能有一个未来的更新优化的计划，这个计划应该写在页面的未来计划章节，但现在还没有。
+
 ---
 
 ### [slash username?](./sp/slash#todo-1) "或许以后会搬到新页面去?"

sp/kuohuanhuan-need-sleep.md

@@ -0,0 +1,24 @@
+# ~~[KuoHuanHuan] 该睡觉了~~
+
+[KuoHuanHuan]: https://nekohuan.cyou/
+[Lapis Apple]: https://laple.me/
+
+> 这是一个由 [KuoHuanHuan] (以及 [Lapis Apple]) 请求的外包功能。
+
+> **这个功能已经被废弃了。它的功能代码仍然存在但已被标记为 `@Deprecated` 同时已经不发挥任何作用。**
+>
+<!-- > 这个功能或许未来会发挥一些别的作用——你可以看一看 [future plan](#future-plan) 章节。 -->
+
+功能 **「KuoHuanHuan 该睡觉了」** 被用于让 KuoHuanHuan 和 Lapis Apple 不要再水群，转而去好好睡觉。
+
+这个功能仅仅发挥了这样的作用——在某个特定的时间段<small>在实际使用时是 UTF-8 时区的某些夜间时间。</small>，只要检测到目标对象<small>也就是 KuoHuanHuan 和 Lapis Apple</small>还在发送消息，就将这条消息删除。
+
+---
+
+当然，这都还是 Morny 的主人（以及 Lapis Apple）还在某个叫做 *DP7* 的群聊当中，他们也还需要这样的功能的时候了。
+
+现在，这个功能的需求和这个功能承载的群聊都已经人走屋空，这一部分代码也转而被废弃了。
+
+<!-- --- -->
+
+<!-- ## future plan -->

stickers.css

@@ -0,0 +1,3 @@
+.sticker {
+	width: 20rem;
+}

version-tag-histories.md

@@ -0,0 +1,17 @@
+# 各大版本代号
+
+| 版本 | 名称 | 名称释义 | 主要内容 |
+|-----|-----|---------|--------|
+| 2.0<sup>EAP</sup> | xinzheng | 新郑 | sbt 以及分项目结构，事件系统和更多 dsl，HTTP 前端，【待定】数据库支援，以及更多新功能 |
+| 1.4<sup>EAP</sup> | pocheng | 莆田<small>莆田话<small> | 【待定】更加智能的社交媒体链接解析和分享，小红书支援 |
+| 1.3 | guanggu | 光谷[^4] | 从社交媒体链接获取内容本身并分享，微博支援，bot 用量的统计报告 |
+| 1.2 | xiongan | 雄安 | bilibili 分享助手，urlencode 支持，以及 log 优化 |
+| 1.1 | nanchang | 南昌[^3] | `/chuang` 以及 `O.o` |
+| 1.0 | beiping | 北平[^2] | 主要语言转为 scala，Morny Report，以及基础的 morny `/info` |
+| 0.8 | putian | 莆田<small>普通话</small> | 社交媒体分享助手初见以及 `encrypt` 命令 |
+| 0.7 | fuzhou | 福州[^1] | 吃药提醒，`*msg` 消息发送等 |
+
+[^1]: 此处使用了普通话发音，相对的，在福州话（闽拼）中应为 hukziu。
+[^2]: 北京的旧名。此处使用了普通话发音，一种更加广泛使用的英文叫法是 peiping（和北京的 peking 是相对应的，都为邮政式拼音）。
+[^3]: 此处使用了普通话发音，相对的，在南昌话（赣语）中应为 lan chɔŋ，其转译到英文字母表或许是 lanchon
+[^4]: 此处使用了普通话发音。光谷的正式命名为*武汉东湖新技术开发区*，其官方英文名称为 *Opitcs Valley of China*。

version-tag-not-used.md

@@ -0,0 +1,5 @@
+# 未被使用的名称
+
+**coungnang**，仓山，本准备作为 1.4 的名称使用，不过后来还是决定使用 pocheng 更为合适。
+
+**hinghwa/hinghua**，兴化，莆田的古称。被莆田人所提及，不过目前还没有可以用到的地方。