HyperNerd

ハイパーオタク

ツォーデルの 2 回目の反復。 Tsoding ストリーム用のチャット ボット。

クイックスタート

NixOS

nixpkgs の Haskell パッケージは使用していないことに注意してください。すべての依存関係は、ビルド中に cabal または stack によってダウンロードされることになっています。

カバル 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

スタック

ネイティブの依存関係:

• OpenSSL
• ズリブ

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

Secret.ini ファイルの例

secret.iniファイルは 3 つのオプションのセクションで構成されます。

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

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

[github]
apiKey = 

Twitch 設定セクション

名前	説明
nick	ボットのニックネーム。
owner	ボットの所有者。ボットは、MOD やブロードキャスターでなくても、この名前を権威として認識します。
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	ボットがリッスンするギルドの 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 

マルコフ連鎖応答

マルコフ連鎖応答をトリガーするには、チャットでボットについて言及するだけです。

マルコフモデルのトレーニング

マルコフ モデルは、 Markov CLI ユーティリティを使用してボットのデータベース ファイル内のログから生成される csv ファイルです。

$ 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

エイリアスは 1 レベルの深さだけ「リダイレクト」されます。これは、推移的なエイリアスがサポートされていないことを意味します。

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

推移的なエイリアスをサポートしない理由は次のとおりです。

• ほとんどの場合、それらは必要ありません。通常、必要なのはメイン コマンドとそのコマンドに対する多数のエイリアスだけです。
• 推移的なエイリアスをサポートするには、エイリアスの「ツリー」を走査して維持する必要があるため、ロジックが複雑になり、パフォーマンスが低下します。

見積データベース

• !addquote -- 見積データベースに見積を追加します。サブチャンネルとMODのみが利用可能です。
• !delquote -- ID で引用を削除します。ツォディンのみで利用可能。
• !quote [quote-id] -- 見積データベースからの見積をクエリします。

サポート

私の仕事をサポートしていただける方は、

• Twitchチャンネル: https://www.twitch.tv/subs/tsoding
• パトレオン: https://www.patreon.com/tsoding