铃心入门文档

介绍

唔，这里是魔骨，一只没什么用的废物）xd，这份文档主要是大家迫切需要一份铃心入门教程写的，所以基本上不会深入做介绍啦，想了解具体功能制作可以去群851460756询问，虽然说不能保证随时在线，但是大部分问题还是有人会解答的，如果需要深入了解功能的话，指路网址：http://yorunina.cn/（鸟阿姨的博客）

铃心官方群指路：686915812（注：机器人不能进群）

魔骨铃心个人群指路：851460756

废话不多说，事不宜迟马上开始吧！

首先是插件的下载，目前因为酷Q已经崩掉的原因，原本的位置不能再使用了，所以先给大家指路

铃心机器人的搭建

Mirai

首先是Mirai，Mirai的铃心安装需要铃心的dll以及json文件，如果你已经有了Mirai，可以使用插件安装包：点击打开

使用方法：

首先，进入Mirai的目录，如图：

然后，进入箭头图中箭头指向的文件夹，也就是plugins文件夹

下一步：

双击鼠标进入箭头所指的Mirainative文件夹

点击所指的plugins文件夹，进入

最后把铃心的json和dll文件放进去就行了

接下来返回到Mirai目录

如图，点击Miraiok.exe这个文件

之后会弹出一个窗口

直接输入login QQ账号 密码

直接使用键盘输入密码，确认无误之后点击回车键

之后会弹出一个图标，复制上面的链接到浏览器，然后使用手机扫描二维码登陆即可

如果你没有下载到Mirai或者是懒鬼，这里有Mirai懒人包：点击查看

注：Mirai的运行目录为放着Miraiok那个文件夹中的jre文件夹里面的bin文件夹

那个才是Mirai的运行目录

先驱机器人

如果你使用的是先驱框架登陆，也是直接使用先驱的整合包，然后直接到账号管理页面添加账号就好了，铃心自定义我已经放进去了，记得右键然后点击启用即可

铃心基本变量说明

参见铃心变量表：http://myepk.club/variable.html

变量详细说明：https://www.mgxfd.club/42.html

EPK代码编辑器：EPK Editor.exe

基本上什么介绍的变量很详细了，不会的可以使用EPK代码编辑器进行编辑使用，这里就讲一些比较常用或者容易忽视的，又或者比较难懂的点

读/写配置

在变量【读配置[文件路径]>=<[配置节]>=<[配置项]>=<[默认值]】中，文件路径指的是文件放的地方，例如，C:/好感度.txt

这个路径是放在C盘的命名为好感度的文本文档（txt）文件

由于C盘是系统盘，还是少往里面放东西比较好.jpg

配置节是指文件中的项目，这个和配置项默认值一起讲吧

[mushroom]
0=801

例如这样，配置节就是mushroom，配置项就是0，那么默认值又是什么呢？

默认值指的是，若=后面那个数值为空白，就会默认读取一个数值，例如：

【读配置C:好感度.txt>=<fvour>=<1>=<2】

你文件路径中并不存在好感度.txt这个文本文件，那么即为空，读取结果为2

因为你的默认值是显示的2

还不明白去群里问，我帮不了了

接下来是写配置

【写配置[文件路径]>=<[配置节]>=<[配置项]>=<[写入值]】

文件路径配置节配置项什么的已经讲过了，这次说写入值，以刚刚的图举例，写入值就是=后面的值，可以是数值，也可以是文字，和默认值不同的是，如果不存在文件，那么铃心插件将会创建一个文件，并且在里面写入你的写入值，例如：

【写配置C:好感度.txt>=<fvour>=<0>=<1】

得到的结果如下：

[fvour]
0=1

看，是不是很简单，这样就运行了你第一个变量了。

文档操作

插入一行

【插入一行[来源]>=<[插入内容]>=<[行数]】

这是一个我个人比较常用的变量，使用方便

插入一行，顾名思义就是直接插进去，停停停想歪的给我面壁去，咳咳，插入一行的来源，可以是文件路径，也可以是一段文本，关于文件路径之前已经说过了，这里就不必在多叙述，然后是插入内容，插入内容可以是任何东西，一段文字，一些数字，等等等等，这个变量经常搭配【内容】变量使用，关于内容我们之后会讲的，请耐心等待，至于行数，很明显，就是说插入在第几行前面，省略则默认插入最后一行，如果数字为负，可以插入倒数的行数，举个例子：

【插入一行【运行目录】\礼物.txt>=<礼物名】

实际效果如下：

1
2 礼物名

这是为什么呢？因为默认是插入最后一行，而默认有一个第一行，所以会插入第二行，不过在第二次插入的时候，就会正确插入到第一行了，第二行则保持之前插入的结果，所以其实问题不大（大概）

删除一行

【删除一行[来源]>=<[内容]】

这个变量搭配插入一行有奇效，也很好用，内容可以为数字，若为数字，则与插入一行里面的行数的效果基本上是一样的，如果为内容，则删除第一个拥有该内容的行

例：【删除一行【运行目录】\礼物.txt>=<礼物名】

实际效果如下：

//运行前
1 礼物名
2 礼物名 
//运行后
1
2 礼物名 

可以看见，第一行的礼物名被删除了，怎么样，是不是很好用？

取出一行/行数

这个比较少，我们一起讲，首先是取出一行【取出一行[来源]>=<[行数]】，简单来说就是把这一行的内容取出来，直接输出，例：

接下来是取出行数

【取出行数[来源]>=<[指定文本]】

取出行数可以搭配其他变量使用，等下讲完【内容】变量就讲变量的组合使用，取出行数也很简单，直接放实例吧，如图

可以看见，取出来得到的行数是5，和我们刚刚输入的行数结果一致，好了，这就是文档操作的简单讲解了，接下来讲一下重点，也是比较难懂的，【内容】变量

内容变量

     什么是内容？用来干什么？这个应该是最开始的疑问，内容是子关键词，所谓子关键词就是……用集合来说明吧，

关键词包含子关键词，就是说，关键词的范围比子关键词大，那么此时我们需要知道什么是关键词，什么是子关键词

所谓关键词，又可以叫做“触发词”，就是触发骰娘回复的词语，而子关键词呢？子关键词就是关键词的一部分，这个就要说到铃心关于子关键词的匹配问题了，如果匹配方式是完全匹配，那么该关键词没有子关键词若为前缀匹配，则你设置的前缀以外，全部是子关键词，例：我喜欢

匹配到的关键词是：我喜欢魔骨

那么这个魔骨，就是子关键词了，而在正则匹配中，用英文的括号：()括起来的就是子关键词，关于正则的用法，因为关系不是很大，所以大家自己百度吧，或者看我群里的正则教程，这里就不多说了，剩下的是模糊匹配，模糊匹配的关键词就是子关键词，例：

关键词：(.+喜欢.+)

匹配结果：我喜欢魔骨

子关键词：我喜欢魔骨

之后内容就可以引用这些子关键词了，利用这些，我们可以写一个简单的礼物系统，接下来开始最后的阶段，使用变量。

变量的使用

      之前我们说过，用文档操作可以做很多事，接下来就让我们写一个简单的礼物系统，首先，收到礼物肯定要收下，此时我们可以使用插入一行变量，例：

关键词＝给

匹配方式＝前缀匹配

回复＝我已经收到了你给的【插入一行【运行目录】\礼物.txt>=<【内容】】了！

输出结果：

发送者：给魔骨

机器人：我已经收到了你给的魔骨了！

这样一个简单的送礼就完成了，不过这还没完，既然说礼物，有赠肯定也有还啊，这个时候我们可以这样写：

关键词＝我想要

匹配方式＝前缀匹配

回复＝你是想要【删除一行【运行目录】\礼物.txt>=<【内容】】吗？好，好的。

输出结果如下：

发送者：我想要魔骨

机器人：你是想要魔骨吗？好，好的

但是这不行，如果礼物库没有这个东西怎么办？我们可以进一步继续写

例：

关键词＝我想要

匹配方式＝前缀匹配

回复＝【判断【取出行数【运行目录】\礼物.txt>=<【内容】】>=<-1>=<你是想要【删除一行【运行目录】\礼物.txt>=<【内容】】吗？好，好的。>=<抱歉……【机器人名字】没有这个礼物……】

输出结果：

发送者：我想要魔骨的胖次

机器人：抱歉……我没有这个礼物……

接下来我们来解析一下这段代码：

首先使用了判断变量，判断了取出行数变量是否等于-1，取出行数变量若没有成功取出，则会输出结果-1，输出了-1之后，此时判断变量内的取出行数变量则变成了常数-1，这个时候-1与被判断的结果-1一致，所以输出了判断为是的结果，也就是那个回复，我大概画个流程图你们理解一下

看，是不是很简单？你可以理解的话，那么，恭喜你，你已经成功入门了铃心自定义插件，你已经可以自己写一些简单的小功能了，那么，在此由衷的祝贺你

你虽然完成了入门，但是距离大佬还差得远，慢慢熟练，争取学会熟练使用，真真正正成为一名大佬吧！切记不可骄傲自满哦？

                                                                ————魔骨

附页

铃心编译器——epk编译器的使用

在这个压缩包里，还有一个名为EPK Editor.exe的文件，那是铃心专用的编译器，使用epk可以快速地查找括号的对称错误，以及铃心语法错误，并且拥有高亮，十分实用，建议编写铃心的代码时使用，左侧可以直接查找变量表使用方法是直接在里面输入就行了，例：

如果有错误，括号会显示红色，例：

通过这种样式，可以快速对齐括号，怎么样？是不是很方便？

通过epk编写的代码，默认都会保存在Windows的文档文件夹的EPK Editor文件夹中，需要直接复制粘贴里面的内容到铃心的输入框内部就可以啦~

注：第一次使用需要设置路径，路径设置为酷Q运行目录即可，就是放着CQP.exe文件的文件夹即可