Koishi
Koishi
基本用法
提示
本章介绍的功能都由 koishi-plugin-teach 插件提供。
问答是 Koishi 教学系统中的基本单位。一个问答包含一个问题、其对应的回答以及其他相关的设置。问题用于匹配 Bot 收到的消息，如果匹配成功，则会将回答作为该消息的响应。一个问题可以对应多种回答，每种回答也可能包含多条消息。但无论如何这都可以用一条问答来表示。
问答编号是每个问答特有的编号，你可以用其修改问答本身或是设置前置和后继问题。
添加问答
使用 # 问题 回答 的语法来添加问答。
聊天记录
如果问题或回答中包含空白字符（空格，换行等），应该将对应的部分用引号包裹起来（半角全角均可）：
聊天记录
Koishi
Koishi
如果要添加的问答已经存在，且拥有修改权限，则会使用额外传入的参数对现有的问答进行修改。添加或修改完成后会提示该问答的编号。
搜索问答
使用 ## 问题 回答 的语法来搜索问答的编号。如果只搜索特定问题的所有回答，可以使用 ## 问题。反之，如果只搜索特定回答的所有问题，可以使用 ## ~ 回答。这里的 ~ 充当占位符的作用。
聊天记录
Koishi
Koishi
由于过长的文本容易带来刷屏的不良体验，因此 Koishi 一次只会提供不超过 30 条搜索结果。如果搜索结果超过这个数字则会进行分页，同时只显示第一页的内容。可以通过 / 页码 调整要查看的页码。
查看和修改问答
提示
为了避免刷屏，一次查看的问答数量不能超过 10。批量修改问答则没有这个限制。你可以通过配置 maxPreviews 修改这个行为。
使用 #id 查看一个问答的具体设置。
聊天记录
Koishi
如果传入了额外的选项和参数，则会视为对该问题的修改。例如，#id 问题 用于修改该问答的问题，#id ~ 回答 用于修改该问答的回答，#id -p 0.5 用于设置问答的概率为 0.5（参见 概率机制 一节），#id -e 用于使该问答在本群生效（参见 上下文机制 一节）等等。
聊天记录
Koishi
Koishi
特别地，#id -r 用于彻底删除一个问答，之后无法恢复。
聊天记录
Koishi
——— 无事发生 ———
你也可以将上面的 id 替换成由半角逗号隔开的多个问答编号，这样就可以同时查看或者修改多个问答了，例如 #123,456。更特别地，如果你要查看或修改的多个问答有着连续的编号，你还可以使用 #123..126 表示 #123,124,125,126。
模糊匹配
为了提高教学问答的覆盖面，Koishi 有一套默认的模糊匹配机制。对于每个添加的问题，Koishi 会对其做以下处理：
- 繁体字转简体字，大写转小写，全角转半角
- 去除开头和结尾处的标点符号
- 去除问题中间的空白字符
- 去除问题开头的称呼前缀（这里的机制较为复杂，会在后面专门介绍）
因此，“我喜欢你”和“我 喜 歡 你！”会被认为是相同的问题。但是尽管如此，处理过后的问题往往失去了较高的可读性，因此 Koishi 实际上会保存你教学时使用的原问题，当显示搜索结果和查看问题时显示原问题，而当真正匹配时才使用处理过后的版本。
特殊语法
最后，在回答中可以使用一些特殊语法：
- $：一个普通的 $ 字符
- $0：收到的原文本
- $n：分条发送
- $A：@所有人
- $a：@说话人
- $m：@机器人
- $s：说话人的名字
下面是一个简单的例子：
聊天记录
Koishi
Koishi
管道操作
可以使用 ## 查询内容 | 修改操作 来进行问答的批量修改。它的功能是对查询到的每一个问答执行后面的修改操作。
例如：## 摸摸 | -p 0.5 将会把所有问题为摸摸的问答的概率修改为 0.5。
当然，如果查询到的问答没有足够的修改权限，还是会提示无法修改的。
查询近期操作
可以使用 ## -v 来查询近期的教学操作：
聊天记录
Koishi
或者使用 #id -v 来查看特定问答近期的教学操作（这里会显示修改前的版本）：
聊天记录
Koishi
回退近期操作
可以使用 #id -V 来回退特定问答近期的教学操作：
聊天记录
Koishi
Koishi