HyperNerd

超级书呆子

Tsoder 的第二次迭代。 Tsoding 流的聊天机器人。

快速入门

尼克斯操作系统

请记住，我们没有使用 nixpkgs 的任何 Haskell 软件包。所有依赖项都应该在构建过程中由 cabal 或 stack 下载。

Cabal v1-构建

$ nix-shell
$ cabal sandbox init
$ cabal install happy-1.19.9
$ cabal install --only-dependencies --enable-tests
$ cabal build
$ cabal test
$ cabal run HyperNerd secret.ini database.db 

Cabal v2-构建

有关详细信息，请参阅 Nix 风格的本地构建

$ nix-shell
$ cabal v2-build
$ cabal v2-test
$ cabal v2-run exe:HyperNerd secret.ini database.db

堆

本机依赖项：

• 开放式SSL
• 兹库

$ stack build
$ stack exec hlint .
$ stack exec HyperNerd secret.ini database.db

Secret.ini 文件示例

secret.ini文件由三个可选部分组成。

 [twitch]
nick = HyperNerd
channel = Tsoding
password = 
clientId = 
owner = 

[discord]
authToken = 
guild = 
channels = [, , ... ]

[github]
apiKey = 

Twitch 配置部分

姓名	描述
nick	机器人的昵称。
owner	机器人的所有者。无论不是模组或广播公司，机器人都会将此名称识别为权威。
password	密码由 https://twitchapps.com/tmi/ 生成。 oauth:前缀是密码的一部分。
channel	机器人在启动时将加入的频道。
clientId	Twitch API 调用的客户端 ID。

Discord 配置部分

姓名	描述
authToken	机器人的身份验证令牌：https://github.com/reactiflux/discord-irc/wiki/Creating-a-discord-bot-&-getting-a-token
guild	bot监听的公会id
channels	机器人监听的频道 id 列表（该列表被解析为 Haskell 列表： [, , ... ] ）

GitHub 配置部分

姓名	描述
apiToken	https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line

Docker-Compose

对于docker-compose.yaml中定义的卷中存在的秘密，

$ docker-compose up --build 

码头工人

$ docker build --target app -t hypernerd .
$ mkdir hypernerd-state
$ cp secret.ini hypernerd-state
$ docker create -v /absolute/path/to/hypernerd-state/:/tmp/hypernerd/ 
                --name hypernerd-bot hypernerd
$ docker start -a hypernerd-bot
$ docker stop hypernerd-bot
$ docker exec -it hypernerd-bot sh 

马尔可夫链响应

要触发马尔可夫链响应，只需在聊天中提及机器人即可。

训练马尔可夫模型

马尔可夫模型是一个 csv 文件，是使用Markov CLI 实用程序根据机器人数据库文件中的日志生成的：

$ cabal exec Markov train database.db markov.csv

此命令将生成markov.csv文件。

将经过训练的马尔可夫模型与机器人一起使用

$ cabal exec HyperNerd secret.ini database.db markov.csv

markov.csv文件不会自动更新。要使用新日志更新文件，您必须再次运行Markov CLI 实用程序。

命令别名

您可以为任何命令分配命令别名：

  !test
 test
 !addalias foo test
 !foo
 test

别名仅“重定向”一层深度，这意味着不支持传递别名：

  !addalias bar foo
 !bar
*nothing, because !bar is redirected to !foo, but further redirect from !foo to !test does not happen*

不支持传递别名的动机如下：

• 大多数情况下不需要它们。一般来说，你只有一个主命令和一堆别名。
• 对传递别名的支持需要遍历并维护别名“树”，这使逻辑复杂化并降低了性能。

报价数据库

• !addquote -- 将报价添加到报价数据库。仅适用于 sub 和 mod。
• !delquote -- 按 id 删除引用。仅适用于措丁。
• !quote [quote-id] -- 从报价数据库查询报价。

支持

您可以通过以下方式支持我的工作

• Twitch 频道：https://www.twitch.tv/subs/tsoding
• 帕特隆：https://www.patreon.com/tsoding