- 追加された行はこの色です。
- 削除された行はこの色です。
里々ログビューア「[[れしば>http://ukgk.s34.xrea.com/poskoma/]]」の使用方法解説。~
バグへの対処や、動作を実験するのに便利なツールです。
----
#contents
----
~
*れしばとは？ [#u045cf1c]
[ポストと狛犬]にも同梱されている、里々用の補助ツールです。~
ゴーストがよく分からない動作をした場合に、里々はどんな処理をしたのかが見ることが出来ます。~
必要に応じて使うことで、ゴースト作成が楽になるでしょう。
*れしばは何をするもの？ [#x0fb2892]
-一言で言うとログビューアです。
-つまり、「里々がどんなタイミングで」「辞書に書いてあることをどう解釈して」「結果どういうスクリプトをベースウェアに返してバルーンやシェルを操作するか」といった過程を覗くための道具です。
-バグが発生したときに、ジャンプや条件式での分岐がどこでおかしくなっているのか、変数がどのタイミングでおかしくなっているのか、関数がどのタイミングで思ったように動いていないのか、そういったことを判断するための重要な材料になります。
*基本的な使い方 [#p08f4fd8]
-ゴーストより前にれしばを起動してから、ゴーストを起動。切替でもＯＫ。
-複数ゴーストを起動すると全部のログを拾うため、なるべくデバッグしたいゴーストのみ起動するようにします。
-そのままだとログが流れっぱなしなので、設定から自動的な更新を止めて、必要なタイミングでリロードすると使いやすい。readme参照。
-ログ内容をテキストエディタに貼り付けるなどして、検索機能をあわせて使うとなおよい。
-使い時に悩まずに、バグが出たらとりあえずれしばを起動してログを取る習慣をつけるくらいでいいはずです。ログにどんな情報が書いてあるかだけ分かれば、疑わしい箇所のログを眺めているだけで異常を見つけられることも少なくありません。
*ログには何が書かれてるの？ [#ic17953d]
SHIORI Eventごとに記録される以下三つの情報のセットが基本です。~
※SHIORI Eventについては以下を参照してください。簡単にいえばゴーストがしゃべるタイミングの事です。~
参照：[[栞としての里々>栞としての里々#gc01536d]]、[[ukadoc>http://ssp.shillest.net/ukadoc/manual/index.html]]
-Request……ベースウェアから通知されるSHIORI Eventの情報
-Operation……里々の処理内容
-Response……ベースウェアに返す内容
--- Request ---
GET SHIORI/3.0
BaseID: OnMouseDown
ID: OnMouseDoubleClick
Reference0: 100
Reference1: 206
Reference2: 0
Reference3: 0
Reference4: Face
Reference5: 0
Reference6: mouse
--- Operation ---
＊OnMouseDoubleClick
（Ｒ３）→0
（Ｒ４）→Face
＊0Faceつつかれ
return: \1\0メニューです。\n\n\q[喋り頻度,喋り頻度]\n
\q[話して,話して]\n\n\q[なんでもありません,なんでもありません]\n\e
status code : 200
--- Response ---
Value=\0\s[0]\1\s[10]\0メニューです。\n\n\q[喋り頻度,喋り頻度喋り頻度4]\n
\q[話して,話して話して6]\n\q[なんでもありません,なんでもありませんなんでもありません8]\e
その他、里々のload、unload時（≒ゴースト起動時・終了時）の処理もログに記載されます。
**Request [#d845455d]
--- Request ---
GET SHIORI/3.0
BaseID: OnMouseDown
ID: OnMouseDoubleClick
Reference0: 100
Reference1: 206
Reference2: 0
Reference3: 0
Reference4: Face
Reference5: 0
Reference6: mouse
ベースウェアからのイベントの通知内容。~
ゴースト作者にとって特に大事なのはIDとReference。~
Event IDとReferenceの中身については[[ukadoc/SHIORI Event>http://ssp.shillest.net/ukadoc/manual/list_shiori_event.html]]を参考にしてください。~
案外Referenceを見るだけでバグの原因となる異常に気づくことも。~
例：当り判定名誤字ってるじゃねーか！
**Operation [#xc72ca9c]
--- Operation ---
＊OnMouseDoubleClick
（Ｒ３）→0
（Ｒ４）→Face
＊0Faceつつかれ
return: \1\0メニューです。\n\n\q[喋り頻度,喋り頻度]\n\q[話して,話して]\n
\q[なんでもありません,なんでもありません]\n\e
status code : 200
ベースウェアからのイベント通知を受けて、里々が行った処理の痕跡です。~
たぶん一番よく見る事になる箇所。ログビューアの本領発揮。~
書いてある詳しい内容は以下のほか、「[[実例>#d2554afb]]」も参考に。
***（○○）→ [#y0c8e65b]
（変数や関数）→中身
[[（）>特殊記号一覧#na7d3d63]]によって対象（変数・トーク・単語群）が展開・実行され、結果が得られたことを意味します。~
''ヒント''
-変数の中身や関数の戻り値が妥当であるかどうか確認することは、デバッグの基本中の基本ともいえます。~
例えば特定の変数がバグに関与している可能性がある時に、「（調べたい変数）→」でログを検索し、推移を追うことで、異常な箇所の特定に結びつくことがあります。
***＊トーク名 [#rc5de223]
里々のシステムからの直接の呼び出しや、[[＞>特殊記号一覧#q19f7fda]]によるジャンプなどで、あるトークの処理が始まった事を意味します。
***＊計算結果が０だったため、続行します。 [#w666740d]
[[＞>特殊記号一覧#q19f7fda]]によるジャンプで、ジャンプ側の条件式が偽（０）になったので、ジャンプせず次の行の評価に移った事を意味します。~
条件を満たすジャンプ先のトークが存在しない場合は、次のnot matchedになります。
***not matched. [#a8d1628c]
＊トーク名 not matched.
[[＞>特殊記号一覧#q19f7fda]]によるジャンプなどで、条件を満たすトークが存在しないことを意味します。~
採用条件問わずジャンプ先自体が存在しない場合も含みます。~
＞によるジャンプ先以外では、里々の起動・終了時などに自動的に検索されるトーク名などについても、発見できない場合こう書かれます。
***not found. [#uad8fe18]
（変数） not found.
＞ジャンプ先 not found.
[[（）>特殊記号一覧#na7d3d63]]による展開・実行や、[[＞>特殊記号一覧#q19f7fda]]によるジャンプの対象（変数・トーク・単語群）が見つからなかったことを意味します。~
（）の場合はφ（○○φ）という文字列に置き換えられて表示されたり、＞の場合は次の行が読まれたりします。~
''ヒント''
-ある処理の時点で存在しているべき変数が存在しないことは、よくあるバグの原因（または症状）の一つです。~
処理のログを眺めていて、不審な位置で「not found.」の文字を見かけたら、よく調べた方がいいかもしれません。~
-[[＞>特殊記号一覧#q19f7fda]]によるジャンプ先についてのnot found.は、採用条件を満たすジャンプ先がなかった場合ではなく、ジャンプ先の指定に一致する名前のトークがまったく存在しなかった場合に表示されます。~
ジャンプ先を書き忘れている･ジャンプ先の指定部分やジャンプ先側でトーク名を間違えているなどのミスの可能性がわかります。~
※ジャンプ先の指定に変数や関数を含む（例 ＞（現在月）月（現在日）日起動）など、意図しないバグではなくてもnot found.になる場合は考えられます。
***written. [#lb0abd7e]
＄変数＝１／written.
新たに変数が作成され、初期値が書きこまれたことを意味します。~
【タブ】、＝、あるいはset関数いずれによるものでも区別されません。
***overwritten. [#pc1b2f65]
＄変数＝０／overwritten.
既存の変数に、新たな値が上書きされたことを意味します。~
【タブ】、＝、あるいはset関数いずれによるものでも区別されません。
***cleared. [#j6c72d20]
＄変数／cleared.
変数が削除された（変数に「空」が代入された）ことを意味します。~
【タブ】、＝、あるいはset関数いずれによるものでも区別されません。~
''ヒント''
-ある変数が必要な場面で存在しないといったバグの原因を調べたい場合、「＄変数／cleared.」という文字列でログを検索してみると、特定につながるかもしれません。
***return: [#o9bbbe61]
return: \1\0メニューです。\n\n\q[喋り頻度,喋り頻度]\n\q[話して,話して]
\n\q[なんでもありません,なんでもありません]\n
Operationのブロックの最後あたりに一度だけあらわれる。~
里々が辞書の内容に基づいて得た、今回のSHIORI Eventに返信するさくらスクリプト。~
いうなれば、里々記法で書かれたトークを、ベースウェアが理解できる形に翻訳した姿。~
この後さらに里々が色々と内部的な処理を行ってから、ベースウェアに返信される。
**Response [#m9cd561b]
--- Response ---
Value=\0\s[0]\1\s[10]\0メニューです。\n\n\q[喋り頻度,喋り頻度喋り頻度4]\n
\q[話して,話して話して6]\n\q[なんでもありません,なんでもありませんなんでもありません8]\e
ベースウェアに対して里々が返す「今回のイベントでは、こういうスクリプトでしゃべって（動いて）くれ」という返事の内容です。~
限られたケースでバグの原因特定に繋がることがあります。~
里々の辞書の記述がベースウェアに送られる時にはこんなわけの分からない記号の集まりになっているんだなあと感慨を深くするだけでも意味はあるかもしれません。
***Value [#ya30f7f2]
ベースウェアに返信される直前のスクリプト。~
Operationのreturnから、さらに里々が内部的な処理を行ったあとの状態のもの。~
※なお、Operationのreturnから、Valueの間に行われる処理は例えば以下のようなもの。
-[[replace_after.txtの置換処理>ファイル構成#e2122c25]]
-[[選択肢タグ\q[]に対する置換>栞としての里々#w90cbf55]]
-[[スクリプト先頭へのデフォルトサーフェスの挿入>特殊変数#j901292e]]
-スクリプト末尾への\eの付与
-先頭で連続するサーフェス変更や末尾の改行などの不要なタグの除去
***Reference [#a8b993d7]
Reference0=さくら
Reference1=JPRadish
[[＄Value*>特殊変数#c272196b]]によるコミュニケート送信時にその内容が表示される。~
Value0はReference0、Value1はReference1、以後それぞれ対応。
*実例 [#d2554afb]
ここでは、れしばを用いたデバッグの簡単な例をあげていきます。
**なんか計算がうまく動いてないっぽい [#o04c8742]
いきなりバグの症状設定があいまいですが、''れしばが真価を発揮するのは''、むしろこういった''ぱっと見で原因が（または症状さえも）はっきりわからない''というようなバグの解析においてです。~
以下のようなトークを書いたとしましょう。（ユーザ年齢）は
＊日本酒入手
＄ユーザ年齢【タブ】（現在年）－（ユーザ誕生年）
：いい日本酒が手に入ったんだけど……
＞ユーザお酒飲めない【タブ】（ユーザ年齢）<２０
＞ユーザお酒飲める
＊ユーザお酒飲めない
：（ユーザ名）もウーロンで乾杯しよう！
：あと（calc,２０-（ユーザ年齢））年たったら一緒に飲めるな。
＊ユーザお酒飲める
：（ユーザ名）も一緒に飲まない？
：俺の分は？
：ないよ。
：……。
というように、ユーザの年齢をその場で計算してトークを分岐します。~
この時ユーザが未成年なら、calc関数を使ってあと何年で二十歳になるのかも計算したいと考えたとします。~
しかし実は上例の場合、calcの結果は思ったようになりません（満年齢じゃなくて数え年になる点は考えないとしても）。ユーザが何歳だろうと常に「ユーザお酒飲めない」が選ばれますし、「あと○○年たったら」の部分も滅茶苦茶な数字になるでしょう。~
一見するとその理由は分かりにくいですが（※）、こういう時こそれしばの出番です。~
早速ログを覗いて見ます。~
※ある程度里々に慣れていると一目で分かるかもしれませんが、疲れているかなんかで注意力散漫だったと思ってください。実際そんな時はよくあります。
//もしくは誰かもっといい例を考えてください。
--- Operation ---
＊日本酒入手
（現在年）→２０１４
（ユーザ誕生年）→１９９０
＄ユーザ年齢＝２０１４－１９９０／written.
（ユーザ年齢）→２０１４－１９９０
＊ユーザお酒飲めない
（ユーザ名）→ユーザ
（ユーザ年齢テスト）→２０１４－１９９０
（calc,２０-２０１４－１９９０）→-3984
return: \0いい日本酒が手に入ったんだけど……\n\1\n[half]
\0ユーザもウーロンで乾杯しよう！\n\n[half]\1あと-3984年たったら
一緒に飲めるな。\n
ログを一行一行、（現在年）は想定通り、（ユーザ誕生年）にも妥当な値が入っている、と確認していくと、次の行がおかしな事に気づくはずです。
＄ユーザ年齢＝２０１４－１９９０／written.
本当はここで、２０１４－１９９０が計算されて、~
＄ユーザ年齢＝２４／written.
となっていてほしいはずです。そのことで、結局~
（calc,２０-２０１４－１９９０）→-3984
と、本来は「２０－１４」を計算してほしい場面でとんでもない事になっています。~
そう思って辞書を見返すと、どうやら
＄ユーザ年齢【タブ】（現在年）－（ユーザ誕生年）
と言う行が思った通りに動いていないようです。~
そこで[[里々wikiで変数の代入について見直して見る>変数#z979c961]]と、どうやらこの場合は
＄ユーザ年齢＝（現在年）－（ユーザ誕生年）
と書かなければならないと分かります。~
ちなみに上例の＝と【タブ】を間違える誤りの他に、例えば、
-そもそも「ユーザ誕生年」の値がおかしい
-「現在年」という名前の変数を自分で作ってしまった
-変数名が正しくない
-calcがsatori_conf.txtで定義されていない（古い里々の場合）
などの場合も、上例のトークは思い通りに動かなくなるでしょう。~
いずれの場合でも、れしばでログを覗けば、どこがどうおかしくなっているかが分かるので、その異常の原因を推測する材料にできます。
**実際に表示がおかしいのにれしばのログでは正常に見える [#g2040f77]
＊
：僕っ子とボクっ子とぼくっ子は別属性っていってるだろ！！！
：おちつけ！
といったトークで、れしばで見ると[[最終的なスクリプト>#ya30f7f2]]も
Value=\0僕っ子とボクっ子とぼくっ子は別属性っていってるだろ！！！\n\n[half]\1おちつけ！\e
と、別段おかしい様子がないのに、実際のバルーンへの表示がなぜか「僕っ子」ではなく「私っ子」になっている！~
と言うような場面に出くわすかもしれません。~
この場合、れしばのログから''異常が読み取れないことが、かえってヒント''になります。~
何故なら、SHIORI（ここでは里々）による処理の後で、スクリプトの内容に干渉できる仕組みは多くないからです。~
結局先の例の場合、辞書を探すとこんな事を書いていました。
＊OnTranslate
＄引数区切りの追加【タブ】（バイト値、２）
＄一時変数【タブ】（Ｒ０）
＄一時変数【タブ】（replace（バイト値、２）（一時変数）（バイト値、２）僕（バイト値、２）私）
（一時変数）
＄一時変数【タブ】
SHIORI Eventの[[OnTranslate]]または[[MAKOTO>http://ssp.shillest.net/ukadoc/manual/manual_translator.html]]によるスクリプトへの置換処理は、通常のSHIORIの処理のあとに行われます。~
そのため、れしばのログに記録されないスクリプトの変化を引き起こす理由となりえます。~
里々wikiにもOnTranslateを使った処理がいくつか書かれていますが、そうした物を使っている事をうっかり忘れていたりすると、混乱を引き起こします。~
そうした時でもれしばに異常が''記録されていない''ことが手がかりになるので、OnTranslateやMAKOTOを使う場合は頭の片隅に入れておきましょう。~
こんな記事も参考に~
⇒[[関数使ってない場所で「引数の個数が～」って言われるしれしばでも異常がみつからない >困ったときの対処法#dd5adca0]]
*れしばの注意点 [#n3a8bdec]
**OnSecondChangeやOnMouseMoveなどは記録されない [#l7f8933d]
おそらく非常に高い頻度で発生するのでログがスゴイ事になるための措置。~
このため、通常のランダムトーク及びなで反応といった、かなりメジャーな種類のトークについてログを確認できません。~
そうしたトークでバグが出ている場合は、そのトークをどこか別の場所にコピペして、ログが見られる方法（たとえばメニューからの選択、ショートカットキー）で動作を確認するなどの工夫が必要です。
**OnTranslateも記録されない [#f0341596]
[[先述の実例>#g2040f77]]にもある通り、OnTranslateはれしばのログに残らないSHIORI Eventです。~
というのもOnTranslateは少々特殊なSHIORI Eventであるためです。~
何らかのSHIORI Eventに対して、SHIORIがスクリプトをベースウェアに返却したあと、ベースウェアはそのスクリプトをReference0として、再度SHIORIに送り直します。~
その時のイベントIDがOnTranslateです。~
これによって、すべてのスクリプトが必ずOnTranslateによる処理を通過することになり、このことをさまざまな用途に応用できます。~
つまりOnTranslateは、他のすべてのSHIORI Eventについて付属的に発生するので、それが一々ログに残ると、やはりログがすごい勢いで流れる事になります。~
おそらくはそういった経緯から、OnTranslateもれしばには記録されません。
*れしばを「後出し」する方法 [#r293c5e1]
れしばは里々のログをリアルタイムに表示するものなので、基本的には問題が発生した時に起動していないと原因を追えません。
しかし、バージョンMc158-5から「＄れしばログ一時保存件数」という特殊変数が追加されており、この変数に数値を設定しておくと、最新のログからその件数分だけのログを一時的に保存して、れしばを起動したときに送信してもらうことができます。
例えば、
＄れしばログ一時保存件数＝１００
このように設定しておけば、「れしば」を起動した時に最新の１００イベントぶんまでのログを一気に送ってくれます。
問題が起きた時に急いで起動すれば、原因がわかるかも？
*れしば互換／代替ツール [#z305f6a1]
**れしば.NET [#u45d82a9]
http://nikolat.herokuapp.com/works/~
動作に.NET Framework2.0以上が必要（Windows Vista以降標準搭載）。~
本家と違って表示行数の上限がないので、複雑な処理をやって何万行もログが流れるようなゴースト向き。~
その他は使い方など基本的に本家と同じ。
**れしばいぬ [#p056f25c]
http://nikolat.herokuapp.com/works/~
かわいいわんこのゴーストに同梱のれしば.NET。~
基本的にれしば.NETと同じはずだが、環境によってはなぜかどっちかだけ動いたりするらしく謎。
**さとりすと [#yf5eaa35]
http://nanachi.sakura.ne.jp/satolist.html~
「デバッグ⇒れしばイベントログ」でウィンドウ展開。~
左上の起動ボタンを押してから、ゴーストを起動。~
受信したリクエストIDのリストがまず表示され、それをダブルクリックで各イベントのログが表示されるなど、一般的なれしばと扱い方は少し違うが、確認できる情報は同じ。~
無視するイベントリストなども設定可能で、本家より柔軟な部分も。~
ただし里々のログ送信機能の仕様上OnSecondChangeやOnMouseMoveが受信不能なのはそのまま。
**コンソールれしば [#r2bee28f]
//配布終了しているため、不要なら削除
配布元消失~
http://faerie.sakura.ne.jp/npw/others/~
たくさんのログが流れるゴースト向け。.NET Frameworkを使わないので動作安定。~
コンソールからコマンドを叩く必要があり少々癖があるが、パイプを書いておけば結果をファイル出力出来るため、起動時や終了時に大量の処理をするゴースト向け。
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
