浮子屋商店もよろしく。

仕様の編集

* 外部仕様 [#f67f607c]

** コマンド一覧 [#v1a81baf]

- コマンドと引数の間は半角スペース1文字で区切ってください。

|コマンド|引数|動作|権限|返信SSTPEvent|Ref.0|Ref.1～|備考|h
|close|-|毒電波を終了します。|○|-|-|-|-|
|dokudenpa|キーワード|キーワードに基づいて毒電波文を生成します。|○|OnDokudenpaDokudenpaResult|毒電波文|-|キーワードを省略した場合は適当に単語をみつくろって反応します。|
|dokudenparandom|文章|文章から単語をランダムに選んで、それをキーワードとして毒電波文を生成します。|○|OnDokudenpaDokudenpaResult|毒電波文|-|-|
|mode|モード文字列|毒電波生成時のモード文字列を指定されたものにします。|○|-|-|-|-|
|gakusyu|文章|文章を学習します。|○|-|-|-|-|
|gakusyufromfile|ファイル名|ファイルから学習を行います。|※1|-|-|-|ファイルが指定されない場合ダイアログを開きます。|
|gakusyufromurl|URL|指定したURLの内容を学習します。|※1|-|-|-|URLが指定されない場合ダイアログを開きます。|
|count|-|現在の単語数を数値で返します。|○|OnDokudenpaCommandResult|1|単語数|-|
|option|key=value|オプションを設定します。|○|-|-|-|key=valueを指定しない場合、現在のオプション一覧を表示します。|
|analyze|-|DBにanalyzeをかけます。|○|-|-|-|-|
|compact|-|DBの切り詰めを行います。|※2|-|-|-|-|
|@～|-|@が先頭に付いた場合、それをSQLとして解釈し結果を返します。|※2|OnDokudenpaCommandResult|結果行数|結果（複数行）|結果は100行までしか返しません。|

- ※1…isExternalFileEnable オプションが有効で無いと permission denied を返します。
- ※2…isSQLEnable オプションが有効で無いと permission denied を返します。
- 毒電波生成時に、Ref.0が"busy"になることがあります。その場合は現在毒電波を生成中ですので、生成し終わるまで待って再実行してください。
- マルコフ連鎖がうまくいかない等、毒電波生成に失敗すると、"none"を返します。

** オプション一覧 [#m8241698]

&color(Red){isSQLEnableやisExternalFileEnableをtrueにした状態でIRC-BOTなどで不特定の第三者にコマンド公開するのは大変危険です。&br;例えば、DBをクリアした上で、ローカルファイルを学習させ、それを取り出すことで、パスワード等が盗まれる可能性もあります。&br;trueにする場合はその影響を充分に考えて行ってください。&br;第三者に公開しない場合は特に問題ないと思います。};

** モード [#t3fba07e]

- モードは、IRCのログを読むような場合に利用可能な機能です。
- 文を学習した際のモードをDB内に記録し、modeオプションがその文字列内に含まれるレコードのみを検索対象とします。
- bunsyoRegexpは、グループ mode 、 グループ sentence を持つ必要があります。（sentenceは必須）
- グループ mode にヒットした文字列があると、「学習時の現在のモード」がその文字列に切り替わります。
- グループ sentence にヒットした文字列は、「学習時の現在のモード」とともにDBに書き込まれます。
- 毒電波生成時に、mode オプションが空でなかった場合、マルコフ連鎖の検索対象として、where mode like '%option.mode%' という条件が加わります。
- つまり、modeオプションが、レコードのmodeに含まれるレコードのみが検索対象となります。

** DB構造 [#mf64b9f6]

- テーブルは tangotbl のみです。

- DBの切り詰めを行うと、countの最小値のレコードが削除されます。

* 毒電波生成方式概要 [#x8396d96]

** 入力文のクリーンアップ [#d445db01]

まず入力文を日本語文字列のみに分解します。

- 最初に、 deleteRegexp にマッチするものを入力から削除します。
- 次に、bunsyoRegexpにマッチする文字列を複数取り出します。
- 複数取り出した文字列が、notBunsyoRegexp にマッチした場合は読み捨てます。

（例）

各オプションが初期値の場合；

(wizwiz) hogehoge \s[0]へもへもは「foobar」

これにdeleteRegexpをかけると

(wizwiz) hogehoge へもへもはfoobar

これをbunsyoRegexpで取り出すと
 
 wizwiz←これを読んだ時点で、「学習時のモード」が wizwiz になる
 hogehoge
 へもへもはfoobar

これのうち、hogehogeはnotBunsyoRegexpにマッチするので、最終的に得られるのは

へもへもはfoobar←これは、モード wizwiz としてDBに書き込まれる。

** 形態素解析 [#j7304b78]

-Mecab を使う場合、Mecab で分かち書きをするだけです。
-Mecab を使わない場合、かなりヒューリスティックなルールになります。
--文字種（ひらがな、カタカナ、漢字、その他）の区切りや、「から」といった助詞によって分解します。
--「ー」は何かの単語の後に付くはず、といったルールも適用されます。

** DBへの書き込み [#o905a167]

- 分解された単語の組み合わせを、pre-main-post の形式で（１単語ずつずらして）DBに書き込みます。すでにあればカウントアップします。

** どくでんぱ生成 [#ac8fdd14]

*** マルコフ連鎖 [#jbbec4c3]

方式としては２単語によるマルコフ連鎖？です。

count の大きさが、そのレコードが選ばれる確率の大きさになります。

- 毒電波生成にはキーワードを用います。
- まず、キーワードが main と合致（或いはキーワードを含む）レコードを選びます。
- そのレコードの pre を新しいキーワードとします。
- レコードを選んだら、次は post が最初のキーワード、mainが新しいキーワードになるようなレコードを選びます。
- 同様にずらしながらレコード選択を繰り返し、preが空欄になるまで文字列を合成していきます。
- preを辿っていき、空欄になるまで文字列を合成します。
- 次に最初に選んだキーワードからpostを辿っていき、同じことを行います。

上記に加え、オプションの mode が空でない場合は、mode文字列によってさらに候補が絞り込まれます。

*** その後のヒューリスティックルール [#f89f922a]

- 最後に、オプションのlineendから１文字選んでくっつけます。
- 先頭の「ー」や末尾の「、」と言った、日本語としておかしいゴミを取り除きます。
- 最終的な結果が与えられたキーワードと同じであった場合は何も返しません。

タイムスタンプを変更しない