Awesome

scripter for sendo erika on NoneBot

<hr />

某天突发奇想，然后就写出了这个插件的雏形。这个插件可以在聊天窗口控制 Nonebot 群聊机器人来发送消息。目前还仅支持延时发送。您可以通过本文档快速学习它的用法（这个插件相当于一个远程 eval）：

样例

    script
    speak "开始计时"
    wait 10
    speak "十秒钟到！"

[00:00:01]开始计时
[00:00:11]十秒钟到！

安装

只需要把文件夹复制粘贴到 plugin 中就可以了。

使用

群成员可以在群聊中直接发送

    script
    [代码]

来操作机器人，在此情况下会有消息数目，持续时间和冷却的限制。此时机器人直接将消息发送到当前的群。超级用户可以在私聊窗口里发送

    scriptto 12345678
    [代码]

来把消息发送到特定的群 12345678 里。

还不支持...

条件，表达式，等等……如果要实现可能要推翻现在已有的进展……目前的主要目的是延时发送消息。

数据类型

和宿主机 Python 的整形和 字符串 相同。

关键字

插件会顺序解释脚本的关键字并且把行为推入事件队列，最后按照这个顺序发送消息。

speak "a string literal" 机器人会发送消息到目前的 session，其中字符串必须由一对双引号包围。例子：
```
    script
    speak "hello world"

[00:00:01]hello world
```
wait some_int 机器人会在此暂停 some_int 秒再执行下一步操作。例子：
```
    script
    wait 5
    speak "hello world"

[00:00:05]hello world
```

setv var_name = some_value 定义一个变量（大多数是字符串）将 some_value 的内容赋予 var_name 中。例子：

    script
    setv msg = "hello"
    setv delay = 5
    speak msg
    wait delay
    speak msg

[00:00:01]hello
[00:00:05]hello

例子（覆盖变量）：

    script
    setv x = "hello"
    setv x = "henlo"
    speak x

[00:00:01]henlo

unsetv var_name 虽然这可能不是必要的，但是这样会删除一个变量并且使之不可引用。（如果遇到了 bug 删除变量会可能有用？）例子：
```
    script
    setv x = "a"
    unsetv x
    speak x

[00:00:01]ERROR: x is not defined. --TERMINAING
```
... 处理相关关键字的函数都颇为相似，在类定义里复制你的命令，再把实现函数传入到 EvalGrammar 对象的字典就好，可参考 speak。

That's almost it! 这就是本插件的大多数功能了。以后就可以延时控制机器人说话了。

关键字（自增）

setv var_name + amt 也支持 - 和 *。可以把 var_name 的值增加 amt。例子（没有表达式的妥协）：
```
    script
    setv a = 10
    setv a + 5
    setv a * 2
    setv a - 2
    speak a

[00:00:01]28
```

setv var_name \+ amt 在普通算符前面加上斜杠表示交换两个值之间的运算顺序例子：

    script
    setv a = "|||"
    setv a + "]]]"
    setv a \+ "[[["
    speak a

[00:00:01][[[|||]]]

例子（减法没有交换律）：

    script
    setv x = 3
    setv y = x
    setv x - 10
    setv y \- 10
    speak x; speak y

[00:00:01]-7
[00:00:01]7

关键字（控制）

loop 可以重复地执行某段代码片段。在开始时会创建覆写一个变量，需要注意。例子（每隔 10 秒发送一条消息，发送 3 次）：

    script
    loop setv i = 1 to 4 that
        setv temp = "hi"
        setv temp * i
        speak temp
        wait 10
    endloop

[00:00:01]hi
[00:00:11]hihi
[00:00:21]hihihi

例子（可选步长）：

    script
    setv r = ""
    loop setv i = 0 to 100 step 5 that
        setv r + i
        setv r + " "
    endloop
    speak r

[00:00:01]0 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95

默认设置只允许嵌套两层循环。例子（笨办法打印一个乘法表）：

    script:
    setv sum = ""
    loop setv i = 0 to 10 that 
        loop setv j = 0 to i that
            setv jj = j 
            setv jj + 1
            setv v = i
            setv v * jj

            setv sum + jj
            setv sum + "*"
            setv sum + i
            setv sum + "="
            setv sum + v
            setv sum + "   "
        endloop
        setv sum + "\n"
    endloop 
    speak sum


[00:00:01]1*1=1   
1*2=2   2*2=4   
1*3=3   2*3=6   3*3=9   
1*4=4   2*4=8   3*4=12   4*4=16   
1*5=5   2*5=10   3*5=15   4*5=20   5*5=25   
1*6=6   2*6=12   3*6=18   4*6=24   5*6=30   6*6=36   
1*7=7   2*7=14   3*7=21   4*7=28   5*7=35   6*7=42   7*7=49   
1*8=8   2*8=16   3*8=24   4*8=32   5*8=40   6*8=48   7*8=56   8*8=64   
1*9=9   2*9=18   3*9=27   4*9=36   5*9=45   6*9=54   7*9=63   8*9=72  9*9=81

features coming in their way

License

MIT