時間管理と接続の規律
対局 client は、局面と時計を別々に正しく扱う必要があります。
時計を local timer の予測で上書きしたり、相手の手番に行を送ったりすると、server の裁定とずれます。
時計は server の echo から再構成する
CSA server は、client の行末 LF を受け取った時点までを消費時間として計測し、着手 echo の ,T に付けます。1
bridge は、この確定値を ClockLedger に適用します。
codecはTを通信上の整数値として保持し、bridgeがTime_Unit単位として解釈します。
主な運用対象はTime_Unit:1secと整数Tです。
Time_Unit:1minでsummary値やTを秒として送るStopWatchClockは未対応です。
小数Tも未対応であり、それを送るserverでの対局には使用できません。
Total_Time、Byoyomi、Increment、Delay、Least_Time_Per_Move、Time_Roundup を決め打ちせず、proposal に従って台帳を更新します。
local clock は、今 engine に許す探索時間を決めるためだけに使います。
--margin-ms は、network 往復、server 側の丸め、bestmove から socket write までの遅れを見越して engine の申告時間を短くします。
CSA の increment は着手前に加算されます。
USI へ渡す increment は着手後の規約なので、bridge は表現を変換してから go に載せます。
指定局面や中断再開でBEGIN Positionに着手履歴が含まれる場合も、各手の,Tを
対局中のechoと同じ規則で台帳へ適用します。Tとincrementが同値なら残り時間は変わらず、
incrementを超えるTはその側の残り時間を減らします。電竜戦の持時間ハンデはこの性質を使うため、
着手履歴のTを読み飛ばしてはいけません。2
送ってよい行を限定する
対局中に client が送る行は、自分の手番でだけ許されます。
相手の手番に送信すると、#ILLEGAL_ACTION による反則負けになり得ます。3
bridge は、server から自分の着手 echo が返るまで次の局面を確定しません。
ponder は相手の手番に探索する機能ですが、CSA server へ着手を送る機能ではありません。
予測が外れた ponder の bestmove は捨て、ponderhit を経た探索だけを着手に使います。
keepalive と切断
CSA は対局中、空の行または LF だけを keepalive として送れます。
同じ client からの空行は、前回の送信から 30 秒以上空ける必要があります。4
bridge の既定値は 40 秒で、指定値が 30 秒未満でも protocol の下限へ切り上げます。
keepalive は JSONL の heartbeat とは別物です。
前者は server との TCP 接続を保つための空行であり、後者は外部 reader が bridge の沈黙を読めるようにする記録です。
対局中の TCP 切断は、再接続で対局を続ける経路ではありません。
正常終局後にEOFを受けた場合は、残り局数があれば同一プロセスで再接続します。 終局後も接続を保つ通常CSA serverでは、その接続で次のsummaryを受け取ります。 非x1であることだけから終局時の切断を決めつけません。 明示終了では、接続が残っていればLOGOUTを送信します。
socket、engine I/O、log writer を分け、socket task を log I/O で止めない構成は、この制約から来ています。
大会へ持ち込む前に
世界コンピュータ将棋選手権向けの client 文書は、ログイン、対局通知への応答、着手の送受信、ログアウトを最低限の要件として挙げています。5
同文書は、server が計測した時間を正規の時間として使い、明示的な LOGOUT を優先するよう求めています。
bridge はこの流れに従いますが、特定大会での正式運用は、主催者が提示する接続試験と規程を通して確認してください。